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

静态库 · 浏览次数 : 64

小编点评

**生成内容** **1. Xcode12模拟器静态库排除arm64架构** *在Build Settings - Architectures - Excluded Architectures - Release - Any iOS Simlator SDK设置 arm64* *将Xcode12之后模拟器的i386架构从Release - Any iOS Simlator SDK中移除,并保持其他架构不变* **2. 静态库选择Do Not Embed** *在项目中添加第三方库时,选择Do Not Embed* *将第三方库的.o文件和.a文件加入到项目中,并选择Do Not Embed* **3. 静态库选择Embed Without Signing** *在项目中添加第三方库时,选择Embed Without Signing* *将第三方库的.o文件和.a文件加入到项目中,并选择Embed Without Signing* **4. 静态库选择Embed and Sign** *在项目中添加第三方库时,选择Embed and Sign* *将第三方库的.o文件和.a文件加入到项目中,并选择Embed and Sign* *将第三方库的.framework文件加入到项目中,并选择Embed and Sign* **5. 静态库选择Embed Without Signing** *在项目中添加第三方库时,选择Embed Without Signing* *将第三方库的.o文件和.a文件加入到项目中,并选择Embed Without Signing*

正文

在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/e05b965672c7
 
 
 

与创建framework静态库和.a静态库相似的内容:

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

在APP项目中使用的静态库有两种,一是.a静态库,另一种是framework静态库。下面分布介绍这2中静态库的创建过程,以及通过脚本工具做自动化打包的2种方式。 Framework静态库生成 如果APP项目和SDK项目都使用了pod第三方库,那么podfile文件设置如下: # App项目的Podf

C#的基于.net framework的Dll模块编程(二) - 编程手把手系列文章

今天继续这个系列博文的编写。接上次的篇幅,这次介绍关于C#的Dll类库的创建的内容。因为是手把手系列,所以对于需要入门的朋友来说还是挺好的,下面开始咯: 一、新建Dll类库; 这里直接创建例子的Dll类库项目,至于项目文件目录的存放布局后面的例子中会介绍。 在解决方案资源管理器上鼠标右键,选择“添加

使用EF 连接 数据库 SQLserver、MySql 实现 CodeFirst

1.新建项目,下载Nuget安装包 创建项目需要注意几点,如果是基于 .net framework 的项目 需要选择 相应版本的 EF, 如果是跨平台则选择EF Core版本。 我这里选择的是 .net framework 版本。红框里面是 实现EF Code First 需要的包。 对应的版本:

教你如何用Vue3搭配Spring Framework

摘要:在本文中,我们将介绍如何使用Vue3和Spring Framework进行开发,并创建一个简单的TodoList应用程序。 本文分享自华为云社区《Vue3搭配Spring Framework开发【Vue3应用程序实战】》,作者:黎燃。 一、介绍 Vue3和Spring Framework都是现

Django DRF @action 装饰器

@action 装饰器在Django REST Framework (DRF) 中非常有用,它可以帮助你在ViewSet中创建自定义的动作,而不仅仅是依赖标准的CRUD操作(Create, Read, Update, Delete)。以下是 @action 装饰器的一些常见用法: 1. 创建自定义集

手把手带你开发starter,点对点带你讲解原理

在2012 年 10 月,一个叫 Mike Youngstrom 的人在 Spring Jira 中创建了一个功能请求,要求在 Spring Framework 中支持无容器 Web 应用程序体系结构,提出了在主容器引导 Spring 容器内配置 Web 容器服务;这件事情对 SpringBoot 的诞生应该说是起到了一定的推动作用。 所以SpringBoot 设计的目标就是简化繁琐配置,快速建

使用C#/.NET解析Wiki百科数据实现获取历史上的今天

创建一个webapi项目做测试使用。 创建新控制器,搭建一个基础框架,包括获取当天日期、wiki的请求地址等 创建一个Http请求帮助类以及方法,用于获取指定URL的信息 使用http请求访问指定url,先运行一下,看看返回的内容。内容如图右边所示,实际上是一个Json数据。我们主要解析 大事记 部

求救信:救下园子,保住这块开发者的天地

创建园子,是人生的最大押注,相信只要专心为开发者服务,一定会有出路。 二十年的专注,如今除了园子一无所有,却要在2024年第三季度一掷孤注,尽一切可能让这块伴随众多开发者成长的热土被保住。 时间的脚步一刻不停留,将园子推到命运的关口,如果这个季度再不解决资金的缺口,园子将无路可走。 2023年在多方

SDL3 入门(5):纹理渲染

创建纹理 有三个 API 可以用来创建纹理: SDL_CreateTexture 参数少,使用方便,适用于创建简单的纹理 SDL_CreateTextureFromSurface 适用于从已有图像数据创建纹理 SDL_CreateTextureWithProperties 可以指定各种属性,功能强大

SQLAlchemy - 模块文件以及增删改查(CURD操作)

创建 db.py db.py 文件是我们管理数据库连接和模型基类的地方。它让我们的代码更加模块化和可维护,实际生产中也是类似的,无论是在 FastAPI 或者 Flask 等框架中,当使用到 SqlAlchemy 时,的的确确需要一个单独 db.py,存储着引擎、会话以及模型基类。这个文件请务必建好