如何在iOS的Swift框架中导入CommonCrypto？
我知道如何在Swift应用程序中使用CommonCrypto：将#import <CommonCrypto/CommonCrypto.h>添加到桥接头文件中。
然而，Swift框架不支持桥接头文件。 文档中写道：
您可以导入具有纯Objective-C代码库、纯Swift代码库或混合语言代码库的外部框架。导入外部框架的过程与框架是单一语言编写还是包含两种语言文件无关。导入外部框架时，请确保您正在导入的框架的“定义模块”构建设置已设置为“Yes”。
您可以使用以下语法将一个框架导入到不同目标中的任何Swift文件中：
import FrameworkName
很遗憾，导入CommonCrypto失败了。在总头文件中添加#import <CommonCrypto/CommonCrypto.h>也不行。
Run Script阶段应包含以下bash代码：
# This if-statement means we'll only run the main script if the CommonCryptoModuleMap directory doesn't exist
# Because otherwise the rest of the script causes a full recompile for anything where CommonCrypto is a dependency
# Do a "Clean Build Folder" to remove this directory and trigger the rest of the script to run
if [ -d "${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap" ]; then
echo "${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap directory already exists, so skipping the rest of the script."
exit 0
fi
mkdir -p "${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap"
cat <<EOF > "${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap/module.modulemap"
module CommonCrypto [system] {
header "${SDKROOT}/usr/include/CommonCrypto/CommonCrypto.h"
export *
}
EOF
${SDKROOT} 可以避免硬编码 Xcode.app 路径，因为这可能因系统而异，特别是如果您使用 xcode-select 切换到 beta 版本，或者在 CI 服务器上构建时安装了多个版本并放置在非标准位置。您也不需要硬编码 SDK，因此这应该适用于 iOS、macOS 等。您也不需要在项目源目录中放置任何内容。
macOS，则需要将macosx添加到刚创建的新聚合目标的Supported Platforms构建设置中，否则它将无法将模块映射放置在正确的Debug派生数据文件夹中与其余的框架产品一起。
接下来，在Swift部分的“导入路径”构建设置下，添加模块映射的父目录${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap:
$(inherited)行。COMMON_CRYPTO_DIR="${SDKROOT}/usr/include/CommonCrypto"
if [ -f "${COMMON_CRYPTO_DIR}/module.modulemap" ]
then
echo "CommonCrypto already exists, skipping"
else
# generate the module map, using the original code above
fi
您实际上可以构建一个“只需工作”的解决方案（无需像其他解决方案一样复制module.modulemap和SWIFT_INCLUDE_PATHS设置到您的项目中），但需要您创建一个虚拟的框架/模块，将其导入到您的实际框架中。我们还可以确保它适用于不同的平台（iphoneos、iphonesimulator或macosx）。
向您的项目添加一个新的框架目标，并将其命名为系统库，例如“CommonCrypto”。（您可以删除伞头文件CommonCrypto.h。）
添加一个新的配置设置文件，并将其命名为“CommonCrypto.xcconfig”，并填充以下内容。（不要选择任何目标以包含。）
MODULEMAP_FILE[sdk=iphoneos*] = \
$(SRCROOT)/CommonCrypto/iphoneos.modulemap
MODULEMAP_FILE[sdk=iphonesimulator*] = \
$(SRCROOT)/CommonCrypto/iphonesimulator.modulemap
MODULEMAP_FILE[sdk=macosx*] = \
$(SRCROOT)/CommonCrypto/macosx.modulemap
创建上述三个引用的模块映射文件，并使用以下内容填充它们：
iphoneos.modulemap
module CommonCrypto [system] {
header "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/usr/include/CommonCrypto/CommonCrypto.h"
export *
}
iphonesimulator.modulemap
iphonesimulator.modulemapmodule CommonCrypto [system] {
header "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk/usr/include/CommonCrypto/CommonCrypto.h"
export *
}
macosx.modulemap
module CommonCrypto [system] {
header "/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk/usr/include/CommonCrypto/CommonCrypto.h"
export *
}
（如果你正在运行测试版，请将“Xcode.app”替换为“Xcode-beta.app”。如果未运行El Capitan，请将 10.11 替换为您当前的操作系统SDK。）
在项目设置的信息选项卡下，在配置中，将CommonCrypto的调试和发布配置设置为CommonCrypto（引用CommonCrypto.xcconfig）。
在框架目标的构建阶段选项卡中，将CommonCrypto框架添加到目标依赖项。此外，在链接二进制文件构建阶段中还要添加libcommonCrypto.dylib。
在产品中选择CommonCrypto.framework，并确保其目标成员资格为可选。
现在，您应该能够在包装器框架中构建，运行和导入 CommonCrypto 了。
例如，请参见SQLite.swift如何使用虚拟的sqlite3.framework。
ld: cannot link directly with /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator8.2.sdk/usr/lib/system/libcommonCrypto.dylib. Link against the umbrella framework 'System.framework' instead. for architecture x86_64。建议使用系统框架“System.framework”进行链接，而不要直接链接到“/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator8.2.sdk/usr/lib/system/libcommonCrypto.dylib”。 - stannieSystem.framework。值得注意的是，如果你的框架跨平台，你必须为 Mac 和 iOS 分别制作一个独立的封装框架。 - Sam Soffes我发现了一个GitHub项目，成功地在Swift框架中使用了CommonCrypto：SHA256-Swift。此外，这篇文章关于使用sqlite3遇到的同样问题也很有用。
基于上述内容，步骤如下：
1）在项目目录中创建一个名为CommonCrypto的文件夹，在其中创建一个module.map文件，这个文件将允许我们在Swift中将CommonCrypto库作为模块使用。它的内容如下：
module CommonCrypto [system] {
header "/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator8.0.sdk/usr/include/CommonCrypto/CommonCrypto.h"
link "CommonCrypto"
export *
}
2) 在“Build Settings”中的Swift Compiler - Search Paths中，将CommonCrypto目录添加到Import Paths（SWIFT_INCLUDE_PATHS）。
3) 最后，在您的Swift文件中像导入其他模块一样导入CommonCrypto。例如：
import CommonCrypto
extension String {
func hnk_MD5String() -> String {
if let data = self.dataUsingEncoding(NSUTF8StringEncoding)
{
let result = NSMutableData(length: Int(CC_MD5_DIGEST_LENGTH))
let resultBytes = UnsafeMutablePointer<CUnsignedChar>(result.mutableBytes)
CC_MD5(data.bytes, CC_LONG(data.length), resultBytes)
let resultEnumerator = UnsafeBufferPointer<CUnsignedChar>(start: resultBytes, length: result.length)
let MD5 = NSMutableString()
for c in resultEnumerator {
MD5.appendFormat("%02x", c)
}
return MD5
}
return ""
}
}
在另一个项目中使用自定义框架会在编译时失败，出现错误消息missing required module 'CommonCrypto'。这是因为自定义框架中未包含CommonCrypto模块。解决方法是在使用该框架的项目中重复步骤2（设置导入路径）。
模块映射不具备平台独立性（它当前指向特定平台，即iOS 8模拟器）。我不知道如何使头文件路径相对于当前平台。
iOS 8及以下版本的更新：我们应该删除行link "CommonCrypto"，以获得成功的编译结果。
更新/编辑
我一直收到以下构建错误：
ld: library not found for -lCommonCrypto for architecture x86_64 clang: error: linker command failed with exit code 1 (use -v to see invocation)
除非从我创建的module.map文件中删除link "CommonCrypto"这一行，否则会一直出现此错误。一旦我删除了这一行，就成功构建了。
$SDKROOT变量应该允许您使用独立于平台的路径，但我不知道如何在Swift中实现。 - danimal/Applications/Xcode6-Beta5.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator8.0.sdk/usr/include/CommonCrypto/CommonCrypto.h" - Siddharth本答案讨论如何在框架中使用以及使用 Cocoapods 和 Carthage 时的解决方案
模块映射方法
我在我对 CommonCrypto 的包装器 https://github.com/onmyway133/arcane, https://github.com/onmyway133/Reindeer 中使用了 modulemap
对于那些遇到 头文件未找到 的人，请查看 https://github.com/onmyway133/Arcane/issues/4 或运行 xcode-select --install
创建一个名为 CCommonCrypto 的文件夹，其中包含 module.modulemap
module CCommonCrypto {
header "/usr/include/CommonCrypto/CommonCrypto.h"
export *
}
前往“Build Settings” -> “导入路径”
${SRCROOT}/Sources/CCommonCrypto
使用modulemap的Cocoapods
s.source_files = 'Sources/**/*.swift'
s.xcconfig = { 'SWIFT_INCLUDE_PATHS' =>
'$(PODS_ROOT)/CommonCryptoSwift/Sources/CCommonCrypto' }
s.preserve_paths = 'Sources/CCommonCrypto/module.modulemap'
使用 module_map 无法正常工作，查看https://github.com/CocoaPods/CocoaPods/issues/5271
使用带有 path 的本地开发 Pod 无法正常工作，查看https://github.com/CocoaPods/CocoaPods/issues/809
这就是为什么您可以在我的示例 Podfile 中看到 https://github.com/onmyway133/CommonCrypto.swift/blob/master/Example/CommonCryptoSwiftDemo/Podfile 指向 git 存储库的原因。
target 'CommonCryptoSwiftDemo' do
pod 'CommonCryptoSwift', :git => 'https://github.com/onmyway133/CommonCrypto.swift'
end
公共头文件方法
Ji是libxml2的一个包装器，它使用公共头文件方法。
它有一个头文件https://github.com/honghaoz/Ji/blob/master/Source/Ji.h，并将Target Membership设置为Public。
它还有一个libxml2的头文件列表https://github.com/honghaoz/Ji/tree/master/Source/Ji-libxml。
它还有构建设置->头文件搜索路径。
$(SDKROOT)/usr/include/libxml2
-lxml2
采用公共头文件方法的Cocoapods
s.libraries = "xml2"
s.xcconfig = { 'HEADER_SEARCH_PATHS' => '$(SDKROOT)/usr/include/libxml2', 'OTHER_LDFLAGS' => '-lxml2' }
有趣的相关文章
/CommonCrypto/CommonCrypto.h的绝对路径，在Applications/XCode.app/Contents/Developer/Platforms/iPhoneOS....中进行手动修改，这需要对已重命名XCode的人进行手动修改。将该行切换为查看"/usr/include/CommonCrypto/CommonCrypto.h"似乎对于拥有多个XCode版本的团队来说可以正常工作。非常感谢！ - Nataliapod lib lint时，构建失败并显示错误：no such module 'CommonCrypto'。我该怎么处理？ - Klein Mioke$(PODS_ROOT)/CommonCryptoSwift/Sources/CCommonCrypto 替换为 $(PODS_TARGET_SRCROOT)/Sources/CCommonCrypto，那么使用本地开发 pod 就可以了。对于本地 pod，PODS_TARGET_SRCROOT 已经被正确设置。 - Orkhan Alikhanov好消息！Swift 4.2 (Xcode 10) 终于提供了 CommonCrypto！
只需在您的 Swift 文件中添加import CommonCrypto即可。
import CommonCrypto。 - Mohammad Zaid Pathan警告：iTunesConnect可能会拒绝使用此方法的应用程序。
我的团队有一位新成员不小心破坏了一个顶级答案提供的解决方案，因此我决定将其整合到一个名为CommonCryptoModule的小包装项目中。您可以手动安装它或通过Cocoapods安装：
pod 'CommonCryptoModule', '~> 1.0.2'
然后，你只需要在需要使用CommonCrypto的模块中导入该模块，如下所示：
import CommonCryptoModule
希望其他人也会发现这个有用。
如果您正在使用与Xcode 10一起的swift 4.2：
现在系统已经提供了CommonCrypto模块，因此您可以像导入其他系统框架一样直接导入它。
import CommonCrypto
我认为我对Mike Weller的优秀工作有所改进。
在“编译源”阶段之前添加一个运行脚本阶段，其中包含以下Bash脚本:
# This if-statement means we'll only run the main script if the
# CommonCrypto.framework directory doesn't exist because otherwise
# the rest of the script causes a full recompile for anything
# where CommonCrypto is a dependency
# Do a "Clean Build Folder" to remove this directory and trigger
# the rest of the script to run
FRAMEWORK_DIR="${BUILT_PRODUCTS_DIR}/CommonCrypto.framework"
if [ -d "${FRAMEWORK_DIR}" ]; then
echo "${FRAMEWORK_DIR} already exists, so skipping the rest of the script."
exit 0
fi
mkdir -p "${FRAMEWORK_DIR}/Modules"
cat <<EOF > "${FRAMEWORK_DIR}/Modules/module.modulemap"
module CommonCrypto [system] {
header "${SDKROOT}/usr/include/CommonCrypto/CommonCrypto.h"
export *
}
EOF
ln -sf "${SDKROOT}/usr/include/CommonCrypto" "${FRAMEWORK_DIR}/Headers"
这个脚本构建了一个简单的框架，并将module.map放置在正确的位置，然后依赖于Xcode对BUILT_PRODUCTS_DIR的自动搜索来查找框架。
我将原始的CommonCrypto包含文件夹链接为框架的头文件夹，因此结果也适用于Objective C项目。
Security.framework 会自动链接（因为我已经有一段时间没有开始新项目了）。如果您遇到错误，那就是需要链接的框架。 - Rob Napier@mogstad非常友好地将@stephencelis的解决方案封装成了Cocoapod:
pod 'libCommonCrypto'
其他可用的pod对我无效。