早在2015年苹果推出了Xcode7的时候,.tbd文件也随之产生,它的出现取代了我们熟悉的 .dylib。
那么.tbd文件到底是什么呢?有什么用?怎么用?接下来我们一点一点来揭开它的面纱。
1. tbd介绍
tbd全称是text-based stub libraries,本质上就是一个YAML描述的文本文件。YAML是一个可读性高,用来表达数据序列化的格式。
tbd用于记录链接动态库的必要信息,包括动态库导出符号、动态库的架构信息、动态库的依赖信息、动态库的链接路径等。如下图:
2. tbd生成原理
tbd格式文件,本身是通过Xcode内置工具tapi-installapi专门来生成的,具体路径为:
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/tapi installapi
3. tbd文件生成
创建一个名为JQTestTdb.framework这样一个动态库framework,如何生成tbd格式文件?
首先来到Build Setting,找到Text-Based API,将Supports Text-Based InstallAPI设置为Yes:
然后,通过Other Text-Based InstallAPI Flags给tapi-installapi工具传递参数,常用的参数有:
-ObjC:将输入文件视为Objective-C文件(默认) -ObjC++:将输入文件视为Objective-C++文件 -x<语言>:值为c、c++、Objective-c和Objective-c++ -Xparser <arg>:传递参数给clang parser。常用参数有:-Wno-deprecated-declarations、-Wno-unavailable-declarations -exclude-public-header <path>:引入的需要解析的public头文件路径
4. tbd文件的使用
第一步,新建一个LoginApp的项目,将JQTestTdb文件夹拷贝到项目根目录下,我们可以看到JQTestTdb文件夹下只有Headers和JQTestTdb.tbd文件,这个也就是要暴露给外部的文件,类似于系统提供的tbd文件
第二步,在ViewController中引入头文件,在viewDidLoad中打印一下JQTestTdbPerson的实例对象,如下图
第三步,这时候编译会报错 Undefined symbol:OBJC_CLASS$_JQTestTdbPerson
我们将JQTestTdb.tbd直接拖到Framework目录下,如下图,再编译,通过!
第四步,运行项目,会在运行时报
dyld: Library not loaded: @rpath/JQTestTdb.framework/JQTestTdb
Reason: image not found
如下图:
第五步,我们将之前生成好的JQTestTdb.framework手动copy到/Users/{userName}/Library/Developer/Xcode/DerivedData/LoginApp-ejzarlssezrclpgjnslulafmqgpb/Build/Products/Debug-iphonesimulator/LoginApp.app/Frameworks目录下,这个目录怎么找?找到项目的Products,右键选中.app文件在Finder中显示,然后选中.app文件,显示包内容,就可以看到Frameworks文件夹了。(ps:当然这个也可以用脚本来copy,只要指定好相应的路径就可以了)
第六步,再次运行项目,通过!打印出JQTestTdbPerson的实例对象,结束!