iOS Architectures和Enable Bitcode
做了一个第三方库,项目打包的时候报错,发现是自定义库没有支持armv7,故而查了一下Architectures相关设置,好记性不如烂笔头,记录一下。
本篇中对Architectures的配置说明copy了其他文章,如iOS Build Settings和iOS--Architectures设置等,留着自查使用。
Architectures配置
-
Additional SDKs
编译时附加的SDK,这些SDK必须是附加的,不应该是整个框架的SDK,并且多个SDK的时候,第一个SDK有最高优先级。
-
Architectures
指定/想要工程支持的指令集,默认会由系统生成预定义的指令集,现在Xcode默认是Standard architectures(armv7和arm64的合集),如果想要支持其他指令集,可以手动添加。而支持的指令集越多,就会编译出包含多个指令集代码的数据包,对应生成二进制包就越大,也就是ipa包会越大。
-
Base SDK
指的是当前编译所用的SDK版本。Base SDK设置会引导编译器使用该版本的SDK编译和构建应用,会直接控制应用使用哪些API。默认情况下,Xcode中创建的新工程总是使用最新版本的SDK,而苹果会处理API的废弃。
-
Build Active Architecture Only
设置是否只编译当前使用的设备对应的arm指令集。
设置成YES时,如果连上一个arm64指令集的设备,就算Valid Architectures和Architectures都设置成armv7/armv7s/arm64,依然只会生成一个arm64指令集的二进制包(前提是Xcode必须连接了调试设备,否则还是编译Valid Architectures和Architectures指定的二进制包)。通常情况下,该编译选项在Debug模式设置成Yes,Release模式设置成No,打包静态库除外,下面会解释。
-
Valid Architectures
有效的指令集集合,通常为所有指令集,表示工程支持的处理器类型,不需要开发者更改,但有时候会因为一些因素,如工程使用了非开源的库,而此库只支持部分处理器类型,导致工程也不是所有的处理器都支持。
该列表和Architectures列表的交集是Xcode最终生成二进制包所支持的指令集,因此不能为空。
-
Supported Platform
指定支持的设备平台
ARM概念
ARM处理器,体积小、低功耗、高性能,几乎所有手机处理器都基于ARM。
ARM处理器指令集:
armv6 | armv7 | armv7s | arm64都是ARM处理器的指令集,这些指令集是向下兼容的。比如设备是armv7s指令集,那么它也可以兼容运行比armv7s版本低的指令集:armv7/armv6,只是无法体现armv7s的新版本特性。Xcode 4.5起不再支持armv6。真机32位处理器需要armv7或者armv7s架构,真机64位处理器需要arm64架构。
i386 | x86_64是Mac处理器的指令集,i386是针对intel通用微处理器32架构的,x86_64是针对x86架构的64位处理器,所以当使用iOS模拟器的时候会遇到i386 | x86_64,iOS模拟器没有ARM指令集。
设备 | CPU架构 |
---|---|
32位真机 | armv7, armv7s |
64位真机 | arm64 |
32位模拟器 | i386 |
64位模拟器 | x86_64 |
从iPhone5s开始采用的是64位处理器,目前Xcode中Architectures默认Standard architectures指令集是armv7和arm64的合集。如果要支持armv7s需要在Architectures配置中手动添加。
设备 | 指令集 |
---|---|
iPhone 11 | iPhone 11 Pro | iPhone 11 Pro Plus | 2019年 A13芯片arm64e |
iPhone XS | iphone XS Max | iPhone XR | 2018年 A12芯片arm64e |
iPhone 8 | iPhone 8 Plus | iPhone X | 2017年 A11芯片arm64 |
iPhone 7 | iPhone 7 Plus | iPad (2018) | 2016年 A10芯片arm64 |
iPhone 6S | iPhone 6S Plus | 2015年 A9芯片arm64 |
iPhone 6 | iPhone 6 Plus | 2014年 A8芯片arm64 |
iPhone 5S | 2013年 A7芯片arm64 |
iPhone5|iPhone5C|iPad4(iPad with Retina Display) | armv7s |
iPhone3GS|iPhone4|iPhone4S|iPad|iPad2|iPad3(The New iPad)|iPad mini|iPod Touch 3G|iPod Touch4 | armv7 |
iPhone, iPhone2, iPhone3G, 第一代、第二代 iPod Touch(一般不需要去支持) | armv6 |
向下兼容概念:向下兼容常常是相对于向上兼容而言的,两者在兼容的方向性上是相反的,因此这两个概念是不同的。向下兼容(Downward Compatibility),又称作向后兼容(Backward Compatibility)。在计算机中指在一个程序或者类库更新到较新的版本后,用旧的版本程序创建的文档或系统仍能被正常操作或使用,或在旧版本的类库的基础上开发的程序仍能正常编译运行的情况。因此,在制作静态库时,现阶段想要支持所有手机类型,只需要支持armv7和armv64架构,更全的指令集可再添加armv7s和armv64e。但是如果只支持arm64e,那么在iPhone X及以下的机型上会出错。
因为我的静态库不支持armv7,而工程中的Valid Architectures支持armv7,所以发生了文章开头的报错,目前解决办法有两个,一是重新生成一个支持armv7指令集的静态库;二是将工程中的armv7去掉。
如何打包全部指令集的库
静态库的指令集:在APP中,为了减小ipa包的大小,Build Active Architecture Only(Debug)设置成YES,Architectures按照Xcode默认配置就可以,因为arm64向前兼容。但是制作静态库要保证兼容性,在不同iOS设备以及模拟器运行不出错,要做到最大兼容性
Valid Architectures设置为:armv7 | armv7s | arm64 | i386 | x86_64
Architectures设置不变(Standard Architectures)或者:armv7 | arm64,可再添加armv7s | arm64e(如果只适配到iPhone 6以后的手机型号,只需要arm64即可)
注意:Build Active Architecture Only要设置成No,否则会根据连接的设备生成对应的指令集。文章开头的静态库没有支持armv7就是这个原因,连接的iPhone X来build的。
如采用iPhone 5模拟器(32bit)和iPhone X真机(64bit)Build代码,比较下面两种情况,查看生成的库所能支持的指令集。
- Build Active Architecture Only(Debug)= Yes
只支持i386和arm64指令集
- Build Active Architecture Only(Debug)= No
可支持Architectures和Valid Architectures的交集所包含的所有指令集
疑难记录
我在制作UTXOFramework静态库时,使用cocoapods引入了FMDB和OpenSSL两个三方库,碰到两个问题,Architectures配置如下:
- Build Active Architecture Only(Debug) = No,模拟器编译时,OpenSSL中定义的宏BN_ULONG报错,猜测是不适配i386架构模拟器。解决办法:将Build Active Architecture Only(Debug) 设置为 Yes,使用x86_64架构机型模拟器编译,通过。
- Build Active Architecture Only(Debug) = No,iPhone X真机编译时,报错
网上找到的解决办法是将项目依赖中的libPods-UTXOFramework.a移出,到Build Phases的Link Binary With Libraries中的删除libPods-UTXOFramework.a。
再编译即可通过
具体原因不明,制作静态库时通过cocoapods引入第三方库时要注意!!!
- 1和2封装好的framwork引入到工程中,工程在debug编译没错,archive时提示说工程使用的UTXOFramework.framework静态库不支持Bitcode
原因是封装framework时虽然Enable Bitcode设置的是Yes,但没有使用Archive而是用其他Build方式,非Archive时编译器只会检查是否满足开启bitcode的条件,并不会真正生成bitcode。其他工程引入此SDK时必须关闭Enable Bitcode=No。
解决办法1:关闭工程对Bitcode的支持,设置Enable Bitcode=No
解决办法2:修改静态库为支持Bitcode。在静态库工程的Build Setting中添加一个『User-Define Setting』,名称为BITCODE_GENERATION_MODE,内容为bitcode
关于Bitcode的设置,分别查询了博客关于bitcode, 知道这些就够了和配置 xcodebuild 命令打包支持 Bitcode,后面会详细记录学习笔记。