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

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

作者: 蒲公英少年 | 来源:发表于2021-12-15 18:00 被阅读0次

    早在2015年苹果推出了Xcode7的时候,.tbd文件也随之产生,它的出现取代了我们熟悉的 .dylib。
    那么.tbd文件到底是什么呢?有什么用?怎么用?接下来我们一点一点来揭开它的面纱。

    1. tbd介绍

    tbd全称是text-based stub libraries,本质上就是一个YAML描述的文本文件。YAML是一个可读性高,用来表达数据序列化的格式。
    tbd用于记录链接动态库的必要信息,包括动态库导出符号、动态库的架构信息、动态库的依赖信息、动态库的链接路径等。如下图:


    1.png

    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:


    2.png

    然后,通过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头文件路径
    
    3.png

    4. tbd文件的使用

    第一步,新建一个LoginApp的项目,将JQTestTdb文件夹拷贝到项目根目录下,我们可以看到JQTestTdb文件夹下只有Headers和JQTestTdb.tbd文件,这个也就是要暴露给外部的文件,类似于系统提供的tbd文件

    4.png

    第二步,在ViewController中引入头文件,在viewDidLoad中打印一下JQTestTdbPerson的实例对象,如下图

    5.png

    第三步,这时候编译会报错 Undefined symbol:OBJC_CLASS$_JQTestTdbPerson

    6.png

    我们将JQTestTdb.tbd直接拖到Framework目录下,如下图,再编译,通过!

    7.png

    第四步,运行项目,会在运行时报
    dyld: Library not loaded: @rpath/JQTestTdb.framework/JQTestTdb
    Reason: image not found
    如下图:

    8.png

    第五步,我们将之前生成好的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,只要指定好相应的路径就可以了)

    9.png 10.png 11.png 12.png

    第六步,再次运行项目,通过!打印出JQTestTdbPerson的实例对象,结束!

    13.png

    相关文章

      网友评论

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

          本文链接:https://www.haomeiwen.com/subject/ejepfrtx.html