苹果.tbd格式的文件介绍、生成和使用

早在2015年苹果推出了Xcode7的时候，.tbd文件也随之产生，它的出现取代了我们熟悉的 .dylib。

那么.tbd文件到底是什么呢？有什么用？怎么用？接下来我们一点一点来揭开它的面纱。

tbd全称是text-based stub libraries，本质上就是一个YAML描述的文本文件。YAML是一个可读性高，用来表达数据序列化的格式。

tbd用于记录链接动态库的必要信息，包括动态库导出符号、动态库的架构信息、动态库的依薯指赖信息、动态库的链接路径等。如下图：

tbd格式文件，本身是通过Xcode内置工具tapi-installapi专门来生成的，具体路径为：

创建一个名为JQTestTdb.framework这样一个动态库framework，如何生成tbd格式文件？

首先来到Build Setting，找到Text-Based API，将Supports Text-Based InstallAPI设置为Yes：

然后，通过Other Text-Based InstallAPI Flags给tapi-installapi工具传递参数，常用的参数有：

第一步，新建一个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的实例对象，结束！

错误：

Building for iOS, but linking in .tbd file (/含弊opt/theos/vendor/祥老胡lib/CydiaSubstrate.framework/CydiaSubstrate.tbd) built for iOS Simulator, file '/谨拦opt/theos/vendor/lib/CydiaSubstrate.framework/CydiaSubstrate.tbd' for architecture arm64

如图

把 /opt/theos/vendor/lib/CydiaSubstrate.framework/CydiaSubstrate.tbd 文件用文本打开，用Sublime Text3，删除archs后面的两项( , i386, x86_64 )，就可以编译成功了。

删除后的CydiaSubstrate.tbd

---