目录
一、.a与.framework静态库介绍
1、常用库文件格式有以下几种:
-
.a
:静态库 -
.framework
:既有静态库也有动态库 -
.dylib
:传统意义上的动态库 -
.xcframework
:2019年苹果推出的用于解决不同架构的库导致的开发问题
2、Framework
-
Framework
实际上是一种打包方式,将库的二进制文件,头文件和有关的资源文件打包到一起,方便管理和分发。 -
Framework
和系统的UlKit.Framework
还是有很大区别。系统的Framework
不需要拷贝到目标程序中,我们自己做出来的Framework
哪怕是动态的,最后也还是要拷贝到App
中(App
和Extension
的Bundle
是共享的),因此苹果又把这种Framework
称为Embedded Framework
。
3、什么是库(Library) ?
库(Library
)说白了就是一段编译好的二进制代码,加上头文件就可以供别人使用。
4、什么时候会用到库(Library) ?
- 某些代码需要给别人使用,但是我们不希望别人看到源码,就需要以库的形式进行封装,只暴露出头文件。
- 对于某些不会进行大的改动的代码,我们想减少编译的时间,就可以把它打包成库,因为库是已经编译好的二进制了,编译的时候只需要
Link
一下,不会浪费编译时间。
5、链接静态库
准备如下文件:
main.m
文件中的代码如下:
#import <Foundation/Foundation.h>
#import <AFNetworking.h>
int main(int argc, char * argv[]) {
AFHTTPSessionManager *manager = [AFHTTPSessionManager manager];
NSLog(@"test:%@", manager);
return 0;
}
main.m
文件中的代码使用了AFNetworking.h
中的代码,因此需要libAFNetworking.a
静态库链接到main.m
文件。
通过如下命令我们可以看到.a
静态库就是.o
文件的合集:
file libAFNetworking.a//查看当前文件类型
ar -t libAFNetworking.a//查看静态库中的内容
二、静态库的链接
我们知道整个编译过程先是把源文件编译生成目标文件(.o
),再通过链接器生成可执行文件或者动态库。因此接下来的步骤如下:
1、生成目标文件
使用clang
命令编译main.m
代码
cd main.m 文件目录下
clang -x objective-c \
-target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-I./AFNetworking \
-c test.m -o test.o
clang
命令的参数参见文末
- 编译链接三要素:头文件、库文件路径、库名称
- 生成目标文件过程中只用到了
./AFNetworking
目录下的头文件,并将代码中AFHTTPSessionManager
等放到重定位符号表
2、链接静态库生成可执行文件
使用clang
命令链接静态库命令如下:
clang -target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-L./AFNetworking \
-lAFNetworking \
test.o -o test
这里libAFNetworking.a
构建的架构需要和这里的目标架构一致,否者无法生成可执行文件。
生成可执行文件时需要用到静态库中的符号,并和目标文件中的重定位符号表融合成一个符号表
3、编译链接流程
三、静态库的创建与合并
准备如下代码:
//test.m
#import <Foundation/Foundation.h>
#import "TestExample.h"
int main() {
NSLog(@"---main---");
TestExample *test = [TestExample new];
[test testFunc];
return 0;
}
// TestExample.m
#import "TestExample.h"
@implementation TestExample
- (void)testFunc {
NSLog(@"testFunc");
}
@end
现在需要将TestExample.m
文件编译成静态库文件
1、将TestExample.m
文件编译成.o目标文件
代码如下(和将test.m
编译成test.o
的区别就是没有引入其他头文件、-x
: 指定编译文件语言类型):
cd TestExample.m 所在目录
clang -x objective-c \
-target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-c TestExample.m -o TestExample.o
2、将.o目标文件变成静态库
由于静态库就是.o
文件的合集,因此一个.o
文件也能变成静态库,这里直接通过修改TestExample.o
文件的后缀变成静态库(之前的系统直接将TestExample.o
改为TestExample.a
即可),操作如下:
TestExample.o
-->libTestExample.dylib
-->libTestExample
或者使用ar命令: ar -rc libTestExample.a TestExample.o
3、使用test.m
文件链接TestExample
静态库以验证该静态库是否的正确性
- 先将
test.m
编译成test.o
,命令和之前一样,只是路径有变化: -
test.o
链接libTestExample
静态库生成test
可执行文件,注意库的路径和名称(-lTestExample
)
4、在终端执行test
可执行文件
- 终端输入
lldb
进入到lldb
环境中 -
file test
//将可以test可执行文件包装为一个Target -
r
// 运行Target
注意:如果
r
运行Target出现错误:error: process exited with status -1 (attach failed ( (os/kern) invalid a rgument)
需要进行如下操作:
应用程序-->
终端-->
显示简介-->
取消勾选“使用Rosetta打开”
因为test
可执行文件是指定arm64
架构生成的,因此需要直接在M1
的arm64
芯片上运行
5、静态库的合并
准备如下两个静态库
使用如下代码合并两个静态库:
libtool -static \
-o libDiffer.a \
/Users/ztkj/Desktop/静态库合并/libAFNetworking.a \
/Users/ztkj/Desktop/静态库合并/libSDWebImage.a
四、创建Framework
使用上面的文件和生成静态库并创建TestExample.framework文件,结构如下:
删除后缀的libTestExample.a
静态库必须是文稿类型,不能是Archive
否则会报错:ld: framework not found TestExample
M1 MacOS删除.a
后缀后如果还是Archive
后缀就在简介中删除后缀:
将test.m
编译成test.o
clang -target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-I./Frameworks/TestExample.framework/Headers \
-c test.m -o test.o
test.o
链接我们创建的Framework
(-F
和-framework
参数与直接链接静态库有区别)
clang -target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-F./Frameworks \
-framework TestExample \
test.o -o test
最后在lldb
下也能执行test
:
五、shell初探
在前面静态库创建的时候主要涉及到以下几个步骤:
- 将
TestExample.m
文件编译成.o目标文件 - 将
.o
目标文件变成静态库 - 将
test.m
编译成test.o
-
test.o
链接libTestExample.a
静态库生成test
可执行文件
现在将这里面的命令放到Shell文件中,文件结构如下:
build.sh
文件中的代码如下,都是上面的命令,只是定义了一些变量:
#定义变量,等号两边不能有空格
LANGUAGE=objective-c
TAREGT=arm64-apple-macos11.1
SYSROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk
FILE_NAME=test
STATICLIBRARY=TestExample
HEAD_PATH=./StaticLibrary
LIBRARY_PATH=./StaticLibrary
#和cd不同的是pushd是压栈一个目录到目录栈的栈顶,而cd 这是直接修改栈顶目录因此无法回到上次的目录
echo "-------------进入到StaticLibrary目录------------------"
pushd ${HEAD_PATH}
echo "-------------编译TestExample.m to TestExample.o------------------"
clang -x $LANGUAGE \
-target $TAREGT \
-fobjc-arc \
-isysroot $SYSROOT \
-c ${STATICLIBRARY}.m -o ${STATICLIBRARY}.o
echo "-------------创建libTestExample.a静态库------------------"
ar -rc lib${STATICLIBRARY}.a ${STATICLIBRARY}.o
echo "-------------退出StaticLibrary目录------------------"
popd
echo "-------------编译test.m to test.o------------------"
clang -x $LANGUAGE \
-target $TAREGT \
-fobjc-arc \
-isysroot $SYSROOT \
-I${HEAD_PATH} \
-c ${FILE_NAME}.m -o ${FILE_NAME}.o
echo "-------------test.o链接libTestExample.a to test EXEC------------------"
clang -target $TAREGT \
-fobjc-arc \
-isysroot $SYSROOT \
-L${LIBRARY_PATH} \
-l${STATICLIBRARY} \
$FILE_NAME.o -o $FILE_NAME
和cd不同的是pushd是压栈一个目录到目录栈的栈顶,而cd 这是直接修改栈顶目录因此无法回到上次的目录
终端执行以下命令执行build.sh
文件:
// cd build.sh文件所在目录
// 为build.sh添加可执行权限
chmod +x ./build.sh
// 执行build.sh 脚本
./build.sh
六、dead_strip与静态库
准备如下代码,文件结构如下:
修改main.m
中的代码,将TestExample
的代码使用注释掉:
#import <Foundation/Foundation.h>
#import "TestExample.h"
int main() {
NSLog(@"---main---");
// TestExample *test = [TestExample new];
// [test testFunc];
return 0;
}
运行shell.sh
脚本:
查看test
可执行文件Mach-O
中__TEXT Section
的代码:
可以看到虽然
main.m
中的代码引入了TestExample.h
但没有使用TestExample
类,因此ld
默认情况下进行了dead_strip
剥离了TestExample中的代码。这在正常情况下没有问题,但是如果静态库中有使用OC中的分类(分类是在运行过程中动态创建的),dead_strip
默认剥离所有未使用的代码就会出现问题。
解决方法:在xcconfig
文件中添加一下参数,让ld
链接静态库的时候遵循我们指定的规则剥离相应的符号:
// -Xlinker -noall_load:dead strip,默认不加载所有静态库的所有代码
// -Xlinker -all_load:不dead strip,加载所有静态库的全部代码
// -Xlinker -ObjC:加载全部OC相关代码,包括分类
// -force_load: 指定要加载那个静态库的全部代码
STATIC_FRAMEWORK_PATH=${BUILD_DIR}/$(CONFIGURATION)$(EFFECTIVE_PLATFORM_NAME)/StaticFramework.framework/StaticFramework
OTHER_LDFLAGS=-Xlinker -force_load ${STATIC_FRAMEWORK_PATH}
-Xlinker
就是告诉clang
向ld
传递参数,并且以上四个参数只对链接静态库时起作用,Xcode Build Settings
中的dead_strip
是链接器提供的一种优化方式,和这里链接静态库传递的参数不是一回事。
如果dead_strip
不能剥离完不需要的代码,链接器还提供了另一个链接参数LTO
,能够在dead_strip
之后进一步优化代码:
.o文件的合并与.o文件链接静态库的区别
-
.o
文件和.o
文件的合并是先合并成一个大的.o
然后再链接(dead_strip
)生成可执行文件 -
.o
文件链接静态库是先dead_strip
,然后再合并
快捷键
- Tab:补全当前文件夹中未输入完整的文件名
- Ctrl + E: 终端中移动光标到行尾
命令详解
1、ar命令向静态库添加.o文件 / 查看静态库中的目标文件
/**
`ar`压缩目标文件,并对其进行编号和索引,形成静态库。同时也可以解压缩静态库,查看有哪些目标文件:
ar -rc a.a a.o
-r: 向a.a添加or替换.o文件(没有静态库就创建静态库)
-c: 不输出任何信息
-t: 列出包含的目标文件
*/
2、将test.m编译成test.o
/**
clang命令参数:
-x: 指定编译文件语言类型
-g: 生成调试信息
-c: 生成目标文件,只运行preprocess,compile,assemble,不链接
-o: 输出文件
-isysroot: 使用的SDK路径
1. -I<directory> 在指定目录寻找头文件 对应:Header Search Path
2. -L<dir> 指定库文件目录(.a\.dylib库文件) 对应:Library Search Path
3. -l<library_name> 指定链接的库文件名称(.a\.dylib库文件)对应:Other Link Flags -lAFNetworking
-F<directory> 在指定目录寻找framework 对应:Framework Search Path
-framework <framework_name> 指定链接的framework名称 对应:Other Link Flags -framework AFNetworking
*/
/**
将test.m编译成test.o:
1. 使用OC
2. 生成的是x86_64-apple-macos11.1架构的代码、M1:arm64-apple-macos11.1
3. 使用ARC
4. 使用的SDK(Foundation)的路径在:/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk
5. 用到的其他库(AFNetworking)的头文件地址在./Frameworks
*/
clang -x objective-c \
-target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-I./AFNetworking \
-c test.m -o test.o
3、test.o链接libAFNetworking.a生成test可执行文件
/**
test.o链接libAFNetworking.a生成test可执行文件
-L./AFNetworking 在当前目录的子目录AFNetworking查找需要的库文件
-lAFNetworking 链接的名称为libAFNetworking/AFNetworking的动态库或者静态库
查找规则:先找lib+<library_name>的动态库,找不到,再去找lib+<library_name>的静态库,还找不到,就报错
*/
clang -target arm64-apple-macos11.1 \
-fobjc-arc \
-isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX11.1.sdk \
-L./AFNetworking \
-lAFNetworking \
test.o -o test
4、合并静态库
/**
OutputName.a: 合并后输出的静态库名称
Library1.a Library2.a需要合并的静态库
*/
libtool -static -o OutputName.a Library1.a Library2.a