创建framework静态库和.a静态库

在APP项目中使用的静态库有两种，一是.a静态库，另一种是framework静态库。下面分布介绍这2中静态库的创建过程，以及通过脚本工具做自动化打包的2种方式。

 

Framework静态库生成

如果APP项目和SDK项目都使用了pod第三方库,那么podfile文件设置如下：

# App项目的Podfile文件
target 'StaticFramework' do
# Comment the next line if you don't want to use dynamic frameworks
    use_frameworks!
    # Pods for StaticFramework
    pod 'FMDB'
end

# SDK项目的Podfile文件
target 'StaticFramework' do
# Comment the next line if you don't want to use dynamic frameworks
    use_frameworks!
    # Pods for StaticFramework
    pod 'FMDB'
end

post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
            config.build_settings['ENABLE_BITCODE'] = 'NO'
        end
    end
end

1.创建一个Static Framework工程，将Build Setting中的MachO Type设置成Static静态库形式

2.将项目文件和资源文件(切图，xib等)导入到Framework制作工程中，并添加依赖的第三方库库frameworks, libararies项下选择嵌入。注意在添加第三方库时不用选择添加到Target。

3.Build Phases阶段 修改

移动Header阶段内添加静态库里的.h头文件，把需要暴露外面的放到public下面(包括：SDK的集成h文件和包含的内部h文件)。

检查Copy Bundle Resources 阶段，查看png,xib等资源文件是否在里面，

查看Compile Sources中编译.m文件是否都在里面，

查看Link Binary With Libaray下需要链接的其他静态库库是否都在里面。

4.Build Settings 修改, 搜索linking进行链接过程设置

Dead Code Stripping 设置为NO，完全包含framework里的代码，拒绝剪裁，修改。
Link With Standard Libraries 设置为关闭，避免重复链接
#Build Active Architecture only 设置为Yes, 使其编译时只生成当前机器的架构。
Other Linker Flags选项设置为-ObjC

另外，Other Linker Flags选项的其他常用设置

-ObjC: 强制加载所有用Objective-C类和分类实现的目标文件
-all_load: 强制加载所有的目标文件
-force_load[path]: 强制加载[path]指定路径的静态库中的所有目标文件
-l[xxx]: 告诉链接器，在搜索路径下查找lib[xxx].dylib 或 lib[xxx].a
-framework [xxx]: 告诉链接器在framework搜索路径下，查找`xxx.framework/xxx'
-F[dir]: 在frameworks搜索路径下追加一个目录[dir]
-Xlinker: 传递给链接器的其他选项，例如-Xlinker -rpath @executable_path/Frameworks/。

Dead Code Stripping是一种编译优化技术。当设置成NO时，编译器不会进行这种优化，但默认仍然只会链接使用到的分类文件。

所以即使设置为NO，仍然需要将Other Linker Flags选项设置为“-ObjC ”才能将所有的分类文件链接进去。

5.framework合并

lipo -create xxxx/ProjectName.framework/ProjcetName xxxx/ProjectName.framework/ProjcetName -output xxxx/ProjectName.framework
lipo -create \
~/Library/Developer/Xcode/DerivedData/StaticFramework-cjzeucukluzhhscxruhakzuohbtp/Build/Products/Debug-iphoneos/StaticFramework.framework/StaticFramework \
~/Library/Developer/Xcode/DerivedData/StaticFramework-cjzeucukluzhhscxruhakzuohbtp/Build/Products/Debug-iphonesimulator/StaticFramework.framework/StaticFramework \
~/Library/Developer/Xcode/DerivedData/StaticFramework-cjzeucukluzhhscxruhakzuohbtp/Build/Products/Release-iphoneos/StaticFramework.framework/StaticFramework \
~/Library/Developer/Xcode/DerivedData/StaticFramework-cjzeucukluzhhscxruhakzuohbtp/Build/Products/Release-iphonesimulator/StaticFramework.framework/StaticFramework \
-output ~/Desktop/app/StaticFramework.framework

.a静态库生成

.a文件

1.创建一个Static Libaray工程

2.将项目文件和资源文件(切图，xib等)导入到SDK制作工程中

3.在Build Phases项目下，添加New Header Phases, 在Header阶段内添加静态库里的.h头文件，把需要暴露外面的放到public下面(包括：SDK的集成h文件和包含的内部h文件)。

bundle文件

4.静态库打包bundle文件，这里把静态库中需要的png，xib打包进去。在Targets下点击“+”，增加新的bundle target。从macOS下现在Bundle工程。因为iOS下没有这个项目

5.选中bundle target项目下的Build Phases Tab项 ,然后选择Copy Bundle Resources， 把SDK项目里的xib, png放到其中。

6.选中bundle target项目下的Build Settings Tab项, 

设置Base SDK 为 iOS,
设置COMBINE_HIDPI_IMAGES为NO，否则Bundle中的图片会变成tiff格式,
设置Skip install为YES，
删除Installation Directory对应的值

7.运行xcode项目，生成产物bundle文件和.a文件, 默认在目录~/Library/Developer/Xcode/DerivedData下

8.从中复制出libStaticLib.a文件，StaticLibResource.bundle，和所有暴露的.h头文件导入到项目中使用（在移动到APP项目时，.a和.bundle文件会自动添加到General->Frameworks,Libraries,and Embedded Content）。

9.合并静态库真机和模拟器文件

lipo -create XXX/模拟器.a路径 XXX/真机.a路径 -output 合并后的文件名称.a
lipo -create \
~/Library/Developer/Xcode/DerivedData/StaticLib-hhthxcjblbfkvzcguwyduhlkkvei/Build/Products/Debug-iphoneos/libStaticLib.a \
~/Library/Developer/Xcode/DerivedData/StaticLib-hhthxcjblbfkvzcguwyduhlkkvei/Build/Products/Debug-iphonesimulator/libStaticLib.a \
-output ~/Desktop/app/libStaticLib.a

10.APP中对资源文件的读取要指定对应的bundle，写名bundle的名称。

 

 

在SDK项目的target中加脚本做framework半自动打包

由于每次合并都要打开终端，执行lipo命令是很麻烦的，这里使用xcode提供的工具，编译阶段执行脚本，自动进行合并。

在SDK项目的target中加脚本做framework自动合并，不同架构的framework要自己手动运行项目生成。

在SDK项目下，依次进行点击Project -> Targets -> Build Phases + -> New Run Script Phases

# Type a script or drag a script file from your workspace to insert its path.
if [ "${ACTION}" = "build" ]
then
    INSTALL_DIR=${SRCROOT}/Products/${PROJECT_NAME}.framework

    DEVICE_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphoneos/${PROJECT_NAME}.framework

    SIMULATOR_DIR=${BUILD_ROOT}/${CONFIGURATION}-iphonesimulator/${PROJECT_NAME}.framework

    # 如果真机包或模拟包不存在，则退出合并
    if [ ! -d "${DEVICE_DIR}" ] || [ ! -d "${SIMULATOR_DIR}" ]
    then
        exit 0
    fi

    # 如果合并包已经存在，则替换
    if [ -d "${INSTALL_DIR}" ]
    then
        rm -rf "${INSTALL_DIR}"
    fi

    mkdir -p "${INSTALL_DIR}"

    cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"

    # 使用lipo命令将其合并成一个通用framework
    # 最后将生成的通用framework放置在工程根目录下新建的Products目录下
    lipo -create "${DEVICE_DIR}/${PROJECT_NAME}" "${SIMULATOR_DIR}/${PROJECT_NAME}" -output "${INSTALL_DIR}/${PROJECT_NAME}"

    #合并完成后打开目录
    open "${SRCROOT}/Products"

fi

 

通过新建aggregate合计工程做framework脚本完全自动合并

1.创建aggregate项目，添加Targets下面的“+”， 选择other -> aggregate项目,进行创建。

2.在aggregate项目下，依次进行点击Project -> Targets -> Build Phases + -> New Run Script Phases， 在里面添加执行脚本

3.运行项目，生成framework

# 取得项目名字（get project name）
FMK_NAME=${PROJECT_NAME}
# 取得生成的静态库文件路径 （get framework path）
INSTALL_DIR=${SRCROOT}/Products/${FMK_NAME}.framework
# 设置真机和模拟器生成的静态库路径 （set devcie framework and simulator framework path）
WRK_DIR=${BUILD_ROOT}
DEVICE_DIR=${WRK_DIR}/Release-iphoneos/${FMK_NAME}.framework
SIMULATOR_DIR=${WRK_DIR}/Release-iphonesimulator/${FMK_NAME}.framework
# 模拟器和真机编译 （device and simulator build）
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphoneos clean build
xcodebuild -configuration "Release" -target "${FMK_NAME}" -sdk iphonesimulator clean build
# 删除临时文件 （delete temp file）
if [ -d "${INSTALL_DIR}" ]
then
rm -rf "${INSTALL_DIR}"
fi
mkdir -p "${INSTALL_DIR}"
# 拷贝真机framework文件到生成路径下 （copy device file to product path）
cp -R "${DEVICE_DIR}/" "${INSTALL_DIR}/"
# 合并生成，替换真机framework里面的二进制文件，并且打开 （merger and open）
lipo -create "${DEVICE_DIR}/${FMK_NAME}" "${SIMULATOR_DIR}/${FMK_NAME}" -output "${INSTALL_DIR}/${FMK_NAME}"
echo "${DEVICE_DIR}/${FMK_NAME}"
echo "${SIMULATOR_DIR}/${FMK_NAME}"
rm -rf "${WRK_DIR}"
echo "${INSTALL_DIR}"

Xcode13打包.a静态库报错问题

真机和模拟器静态库都包含了 (arm64)架构，导致无法合并成胖子库。

/usr/bin/lipo: Release-iphoneos/libGPUImage.a and Release-iphonesimulator/libGPUImage.a have the same architectures (arm64) and can't be in the same fat output file

原因为：

Xcode12之前

Xcode编译出来的模拟器静态库只包含i386, x86_64架构

xcode编译出来的真机静态库只包含armv7, arm64架构

所以，当这两种用途的库打包出来后，通过lipo create -output xxx 就可以顺利的生成同时包含i386, x86_64, armv7, arm64这四种架构，同时支持模拟器和真机的静态库了。

Xcode12之后

模拟器也支持了arm64架构，导致打出来的模拟器静态库中也包含了arm64架构，导致合并胖子库时架构冲突，报错。

解决方法为：

在Xcode的Build Settings - Architectures - Excluded Architectures - Release - Any iOS Simlator SDK 设置 arm64

这样在模拟器静态库中就不包含arm64架构了。

然后又可以快乐的打包了。

另外: 如果没有Xcode工程，可以用命令行工具手动去除重复的架构: 

lipo XXX.a -remove arm64 -output XXX.a

如何选择嵌入静态库或动态库的策略

项目依赖的第三方库有2种，动态库和静态库。动态库的形式有.framework和.dylib。静态库的形式有：.a和.framework

静态库的使用方式

1.通过直接拖到项目中，以嵌入的方式引入项目（选择非嵌入，非签名时，只保存framwork的使用信息和路径），这样静态库会被copy到ipa文件中，等APP运行时，再加载到内存使用。

2.通过Other Linker Flags的方式集成到项目中，这种方式在编译，链接时会和其他.o文件一起链接到可执行文件中，与源文件变成一个整体。

 

当项目以Linker的方式使用静态库时：在链接阶段，APP会将使用到的静态库和其他.o文件链接在一起，成为一个整体。

项目对动态库的使用方式：在运行阶段，APP在启动是，会根据mach-o文件中使用的动态库，按里面包含的动态库地址去加载，如果内存有了，就使用内存中的缓存。因为APP启动要加载这个动态库，所以ipa包中要包含用到的动态库（通常是使用iOS系统自带的动态库如：UIKit, Foundation, 用户在APP中包含自己的动态库通常没有多大意义）。

在项目中添加第三方库时会有三种嵌入方式：

Do Not Embed：不嵌入，选择linker链接到IPA中

Embed & Sign：嵌入并签名，签名是使用苹果公钥对第三方库加加密，在iOS系统运行时，使用iOS系统证书进行验证，是否是安全的第三方库。

Embed Without Signing：嵌入但不签名。

验证动态库和静态库的方式是使用file命令

file GPUImage.framework/GPUImage

打印结果

current ar archive:说明是静态库，选择Do not embed
Mach-0 dynamically：说明是动态库，选择Embed

是否对动态库进行Sign

通过查询当前动态库是否已经做了签名，如果做了就不能再做签名了

codesign -dv GPUImage.framwork

code object is not signed at all 或者 adhoc 。则选择Embed and sign

其它：表示已经正确签名，选择Embed Without Signing

 

 

 

参考文章：

https://www.jianshu.com/p/bf1cc6ac7d17

https://www.jianshu.com/p/583ca50ee5b3

https://www.jianshu.com/p/e05b965672c7