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

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

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

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


1. tbd介绍


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


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


image.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:


image.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头文件路径


image.png


4. tbd文件的使用

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


image.png


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


image.png


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


image.png


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


image.png


第四步,运行项目,会在运行时报

dyld: Library not loaded: @rpath/JQTestTdb.framework/JQTestTdb

Reason: image not found

如下图:

image.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,只要指定好相应的路径就可以了)


image.png


image.png



image.png

image.png


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


image.png



目录
打赏
0
0
0
0
2
分享
相关文章
kde
|
5天前
|
Docker镜像加速指南:手把手教你配置国内镜像源
配置国内镜像源可大幅提升 Docker 拉取速度,解决访问 Docker Hub 缓慢问题。本文详解 Linux、Docker Desktop 配置方法,并提供测速对比与常见问题解答,附最新可用镜像源列表,助力高效开发部署。
kde
3079 8
国内如何安装和使用 Claude Code镜像教程 - Windows 用户篇
国内如何安装和使用 Claude Code镜像教程 - Windows 用户篇
567 0
Dify MCP 保姆级教程来了!
大语言模型,例如 DeepSeek,如果不能联网、不能操作外部工具,只能是聊天机器人。除了聊天没什么可做的。
833 9
2025年最新版最细致Maven安装与配置指南(任何版本都可以依据本文章配置)
本文详细介绍了Maven的项目管理工具特性、安装步骤和配置方法。主要内容包括: Maven概述:解释Maven作为基于POM的构建工具,具备依赖管理、构建生命周期和仓库管理等功能。 安装步骤: 从官网下载最新版本 解压到指定目录 创建本地仓库文件夹 关键配置: 修改settings.xml文件 配置阿里云和清华大学镜像仓库以加速依赖下载 设置本地仓库路径 附加说明:包含详细的配置示例和截图指导,适用于各种操作系统环境。 本文提供了完整的Maven安装和配置
2025年最新版最细致Maven安装与配置指南(任何版本都可以依据本文章配置)
【保姆级图文详解】大模型、Spring AI编程调用大模型
【保姆级图文详解】大模型、Spring AI编程调用大模型
347 7
【保姆级图文详解】大模型、Spring AI编程调用大模型
Excel数据治理新思路:引入智能体实现自动纠错【Python+Agent】
本文介绍如何利用智能体与Python代码批量处理Excel中的脏数据,解决人工录入导致的格式混乱、逻辑错误等问题。通过构建具备数据校验、异常标记及自动修正功能的系统,将数小时的人工核查任务缩短至分钟级,大幅提升数据一致性和办公效率。
DeepSeek R1+Open WebUI实现本地知识库的搭建和局域网访问
本文介绍了使用 DeepSeek R1 和 Open WebUI 搭建本地知识库的详细步骤与注意事项,涵盖核心组件介绍、硬件与软件准备、模型部署、知识库构建及问答功能实现等内容,适用于本地文档存储、向量化与检索增强生成(RAG)场景的应用开发。
367 0
让AI时代的卓越架构触手可及,阿里云技术解决方案开放免费试用
阿里云推出基于场景的解决方案免费试用活动,新老用户均可领取100点试用点,完成部署还可再领最高100点,相当于一年可获得最高200元云资源。覆盖AI、大数据、互联网应用开发等多个领域,支持热门场景如DeepSeek部署、模型微调等,助力企业和开发者快速验证方案并上云。
304 22
让AI时代的卓越架构触手可及,阿里云技术解决方案开放免费试用
FLUX.1 Kontext 的全生态教程来啦!AIGC专区在线试玩!
Flux.1 Kontext [dev] 开源模型大家都用上了吗?小编汇总了3个使用教程,打包送上!
418 1

热门文章

最新文章

AI助理

你好,我是AI助理

可以解答问题、推荐解决方案等

登录插画

登录以查看您的控制台资源

管理云资源
状态一览
快捷访问