iOS Architectures和Enable Bitcode设置

做了一个第三方库，项目打包的时候报错，发现是自定义库没有支持armv7，故而查了一下Architectures相关设置，好记性不如烂笔头，记录一下。

本篇中对Architectures的配置说明copy了其他文章，如iOS Build Settings和iOS--Architectures设置等，留着自查使用。

Architectures配置

1. Additional SDKs

   编译时附加的SDK，这些SDK必须是附加的，不应该是整个框架的SDK，并且多个SDK的时候，第一个SDK有最高优先级。

2. Architectures

   指定/想要工程支持的指令集，默认会由系统生成预定义的指令集，现在Xcode默认是Standard architectures（armv7和arm64的合集），如果想要支持其他指令集，可以手动添加。而支持的指令集越多，就会编译出包含多个指令集代码的数据包，对应生成二进制包就越大，也就是ipa包会越大。

3. Base SDK

   指的是当前编译所用的SDK版本。Base SDK设置会引导编译器使用该版本的SDK编译和构建应用，会直接控制应用使用哪些API。默认情况下，Xcode中创建的新工程总是使用最新版本的SDK，而苹果会处理API的废弃。

4. Build Active Architecture Only

   设置是否只编译当前使用的设备对应的arm指令集。

   设置成YES时，如果连上一个arm64指令集的设备，就算Valid Architectures和Architectures都设置成armv7/armv7s/arm64，依然只会生成一个arm64指令集的二进制包（前提是Xcode必须连接了调试设备，否则还是编译Valid Architectures和Architectures指定的二进制包）。通常情况下，该编译选项在Debug模式设置成Yes，Release模式设置成No，打包静态库除外，下面会解释。

5. Valid Architectures

   有效的指令集集合，通常为所有指令集，表示工程支持的处理器类型，不需要开发者更改，但有时候会因为一些因素，如工程使用了非开源的库，而此库只支持部分处理器类型，导致工程也不是所有的处理器都支持。

   该列表和Architectures列表的交集是Xcode最终生成二进制包所支持的指令集，因此不能为空。

6. 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配置如下：

1. Build Active Architecture Only(Debug) = No，模拟器编译时，OpenSSL中定义的宏BN_ULONG报错，猜测是不适配i386架构模拟器。解决办法：将Build Active Architecture Only(Debug) 设置为 Yes，使用x86_64架构机型模拟器编译，通过。

2. Build Active Architecture Only(Debug) = No，iPhone X真机编译时，报错

网上找到的解决办法是将项目依赖中的libPods-UTXOFramework.a移出，到Build Phases的Link Binary With Libraries中的删除libPods-UTXOFramework.a。

再编译即可通过

具体原因不明，制作静态库时通过cocoapods引入第三方库时要注意！！！

3. 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，后面会详细记录学习笔记。