如何在swift项目中引入CommonCrypto

这是一篇马上过期的文章,xcode10已经解决无法import CommonCrypto问题。(2018.7.20)
Good news! Swift 4.2 (Xcode 10) finally provides CommonCrypto!

1.Bridging-Header中导入

如果项目是混编项目,在Bridging-Header.h中引入即可。

//  xxx-Bridging-Header.h
//  Use this file to import your target's public headers that you would like to expose to Swift.
//

#import <CommonCrypto/CommonCrypto.h>

2.使用modulemap导入

modulemap是什么可以自行谷歌,swift的import系统可以看下这篇文章
简单来说,可以通过modulemap来映射oc/c库,使得swift可以直接import。

思路:
1.创建modulemap,映射swift模块名到oc/c的头文件
2.在项目中配置import path,使得xcode能够找到你的modulemap

第1步:
如图,添加ModuleMaps目录放置modulemap文件,Demo中使用的modulemap来自Arcane,直接拿过来改就好了。

modulemap的语法也不纠结,大致也能看懂,CCommonCrypto是swift模块名,system表示系统环境,header指向oc/c的头文件,export *,导出所有。

第2步:
Targets -> Build Settings -> Import Paths中添加路径
根据不同环境的SDK指向不同的路径,demo中只添加了iOS和iOS Simulator的SDK导入路径。其余同理。

$(SRCROOT)/CryptoDemo/ModuleMaps/iphones
$(SRCROOT)/CryptoDemo/ModuleMaps/iphonesimulator

要注意的是,由于header指向了绝对路径,当xcode位置不对,或者库文件位置变更,会找不到头文件。能不能使用环境变量变成相对路径?xcode的常用变量(${SDKROOT}之类)不能在modulemap文件中使用,有好的方法请留言🙂

如果你好奇那些路径怎么来的,你可以执行命令

xcodebuild -sdk -version

配置好import path就可以正常使用了。

3.包装一层framework

刚才我们使用modulemap导入,有两处不完善的地方:
1.创建modulemap时需要给不同的系统指向不同的库路径
2.路径都是绝对路径
下面的方法优雅的解决了以上问题。

我们知道,编译项目时,会首先编译它依赖的库,而编译后是可以执行脚本的。
所以我们的思路是:
编译项目 -> 编译依赖库 -> 执行依赖库的脚本 -> 生成modulemap
执行脚本时可以使用xcode的环境变量${SDKROOT},这样就轻易解决以上两个问题。

实施步骤:
1.创建Aggregate
2.添加编译脚本
3.项目依赖Aggregate
4.项目指定import path
Done!

  1. 创建Aggregate


2.添加编译脚本
脚本比较易读
创建文件夹${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap
创建文件${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap/module.modulemap

# 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

3.项目依赖Aggregate


4.指定import path${BUILT_PRODUCTS_DIR}/CommonCryptoModuleMap

Done!

4.使用cocoapods

上述方法中我们:
${BUILT_PRODUCTS_DIR}动态指定modulemap文件的位置
${SDKROOT}指定SDK所在位置
当xcode build时会先编译Aggregate来触发脚本,而脚本通过环境变量获取路径。

我尝试在podspec中使用prepare_command来达到类似效果,但并不成功。
prepare_command中使用环境变量,pod install会报错。

[!] Failed to download 'CryptoKit'.

进步一的原因是:没有权限访问环境变量

/Sources/CommonCryptoModuleMap/module.modulemap: Permission denied

官方文档中一段解释:prepare_command在项目创建之前就被执行。
所以猜测执行脚本的环境仅仅是Pods目录下,并不能获取到环境变量。

#This command is executed before the Pod is cleaned and before the Pods project is created. 
#The working directory is the root of the Pod.

目前看来,要使用cocoapods来管理的话,只能使用方法2。

回顾方法2的两个步骤:
1.创建modulemap,映射swift模块名到oc/c的头文件
2.在项目中配置import path,使得xcode能够找到你的modulemap

按上文的步骤配置完后,还需要做以下处理:
由于pod install根据podspec的配置来编译,我们在build setting设置的选项,要在podspec中再设置一遍。

所以要在podspec中设置import path。这里也只考虑2种常用环境,其余自行添加。

s.pod_target_xcconfig = {
    'SWIFT_INCLUDE_PATHS[sdk=iphoneos*]'         => '$(SRCROOT)/CryptoDemo/ModuleMaps/iphones',
    'SWIFT_INCLUDE_PATHS[sdk=iphonesimulator*]'  => '$(SRCROOT)/CryptoDemo/ModuleMaps/iphonesimulator',
}

有些例子还会添加一句:原因是pod打包后只保留源代码和资源文件,如果modulemap所在的目录不被s.source_files包含,那么需要添加preserve_paths来告诉pod要保留文件。

s.preserve_paths = 'CocoaPods/**/*'   // modulemap所在目录

Done~

参考链接

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,839评论 6 482
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,543评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 153,116评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,371评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,384评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,111评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,416评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,053评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,558评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,007评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,117评论 1 334
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,756评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,324评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,315评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,539评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,578评论 2 355
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,877评论 2 345

推荐阅读更多精彩内容

  • 1、通过CocoaPods安装项目名称项目信息 AFNetworking网络请求组件 FMDB本地数据库组件 SD...
    阳明先生_x阅读 15,968评论 3 119
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,029评论 4 62
  • ALTRA—美国专业跑鞋品牌 ZeroDrop(零落差)鞋底:ZeroDrop是Altra的头牌技术,Altra为...
    徐先森KB24阅读 925评论 0 0
  • “我(他)这个人说话比较直(直接),你别介意。”我们常听到这样的话。这其实反应了两点:一是此人修养不高,二是此人比...
    寒塘渡鹤阅读 216评论 4 1
  • 我和石敏相视坐在咖啡桌的两端,玩着儿时的飞行棋,随口抱怨月河的这条河真的是不太清澈。 咖啡馆里空调很足,她脱下大衣...
    衬衫当外套阅读 279评论 0 0