重要声明:iOS 版本和越狱环境
在开始之前,必须明确一点:iOS 越狱插件开发与特定的 iOS 版本和越狱工具紧密相关。

- iOS 版本: 最主流的插件开发环境是 iOS 14 - iOS 16,iOS 17 及以上版本目前(截至 2025 年初)插件生态仍在发展中,资料相对较少,但原理相通。
- 越狱工具: 目前最主流的越狱工具是 Odyssey (基于 Checkm8 漏洞,支持 A5-A11 芯片) 和 Taurine/Chimera (支持 A12-A14 芯片),它们都使用 Sileo 作为默认的包管理器(替代旧时代的 Cydia)。
您在寻找教程时,一定要留意教程对应的 iOS 版本 和 使用的工具。
第一部分:学习路径与核心概念
插件开发不是一蹴而就的,需要按部就班地学习,以下是推荐的学习路径:
第 1 步:准备工作
- 一台已越狱的 iPhone/iPad: 这是前提,确保你的设备已经通过 Odyssey、Taurine 等工具成功越狱,并且安装了 Sileo。
- 安装开发工具:
- Theos: 这是最核心、最传统的 iOS 开发工具链,它是一个构建系统,能帮你将 Objective-C 或 Swift 代码编译成
.dylib(动态库) 或.deb(安装包) 文件。 - 如何安装: 在 Sileo 中搜索 "theos" 并安装,或者通过命令行安装(推荐有一定基础的用户)。
- Sublime Text / VS Code: 代码编辑器,用于编写和管理你的代码,Theos 自带一个基于 Vim 的编辑器,但图形界面编辑器会更友好。
- Frida / Logos Web / class-dump-z: 这些是逆向工程和分析工具,用于查看 App 的内部结构(类、方法、变量),这是编写插件的关键。
- Theos: 这是最核心、最传统的 iOS 开发工具链,它是一个构建系统,能帮你将 Objective-C 或 Swift 代码编译成
第 2 步:核心概念与工具
你需要理解以下几个核心概念:
- Tweak (插件): 本质上是一个
.dylib文件,系统会在特定时机加载它,从而修改或替换 App 的原生行为。 - Logos 语法的插件: 这是最主流、最简单的插件开发方式,它使用一种名为
.x或.xm的文件,里面包含类似宏的指令(如%hook,%end,%log,%orig),Theos 会将这些指令转换成复杂的运行时代码,让你无需关心底层细节就能 Hook App 的方法。 - Hook(钩子): 插件开发的核心技术,通过 Hook,你可以“拦截”一个 App 的某个方法调用,在它执行前、执行后或替换它,从而插入你自己的代码。
- Cydia Substrate / Electra Substrate: 这是越狱的底层框架,提供了 Hook 功能,你的插件依赖于它来工作。
第 3 步:开发流程
- 创建新项目: 使用 Theos 的
nic.pl脚本创建一个新的 Tweak 项目。 - 分析目标 App:
- 使用 class-dump-z 导出 App 的所有类和方法列表。
- 使用 Logos Web 或 Frida 来分析你想要 Hook 的具体方法。
- 编写 Tweak 代码:
- 在
YourTweak.xm文件中,使用 Logos 语法编写 Hook 代码。 %hook ClassName: 开始 Hook 某个类。%orig: 调用原始方法。%log: 打印日志,方便调试。%end: 结束 Hook。
- 在
- 编译与打包: 在终端中运行
make package命令,Theos 会自动编译代码并生成一个.deb安装包。 - 安装与测试:
- 将生成的
.deb文件通过 A-Flex (iOS 14/15) 或 Sileo 的文件共享功能安装到你的设备上。 - 重启 SpringBoard (系统界面) 或相关 App,然后测试插件是否生效。
- 将生成的
- 调试: 使用
logify.pl工具可以快速生成日志代码,方便定位问题,通过设备的日志系统查看输出。
第二部分:视频教程资源推荐
由于官方视频教程很少,大部分优质资源来自社区开发者,以下是寻找和筛选视频教程的渠道:

YouTube (最集中的资源库)
在 YouTube 上搜索以下关键词,可以找到大量视频教程:
-
中文搜索关键词:
ios 越狱插件开发教程theos 教程logos 教程tweak 开发入门iOS 14/15/16 插件开发
-
英文搜索关键词 (通常更高质量和最新):
iOS Tweak Development TutorialTheos Logos TutorialHow to make an iOS jailbreak tweakOdyssey Jailbreak Tweak Development
推荐关注的 YouTuber/频道 (以英文为主,内容质量高):

- Sentry: 他制作了一系列非常棒的、从零开始的 iOS 14/15 Tweak 开发教程,非常适合初学者,他的视频清晰、有条理,是入门的绝佳选择,直接在 YouTube 搜索 "Sentry iOS Tweak Development"。
- iCrackUriDevice: 虽然频道主主要以越狱新闻和评测闻名,但他也经常发布一些开发者访谈和基础教程。
- CoolStar: 他是许多著名越狱工具(如 Electra)的开发者,他的频道或相关视频中有时会包含一些技术分享。
Bilibili (B站)
B站是国内学习技术的好去处,有很多中文 UP主分享教程。
- 搜索关键词: 和 YouTube 类似,搜索
ios 越狱插件、theos等。 - 如何筛选: 优先选择 播放量高、评论多、更新时间较近 的视频,注意视频的 iOS 版本是否与你的设备匹配。
GitHub
GitHub 不仅是代码托管平台,也是学习的重要资源库。
- 查看著名开源插件源码: 去 GitHub 上找一些你喜欢的、功能简单的开源插件(比如一些界面美化、功能增强类插件),直接阅读它们的代码,是最好的学习方式。
- 推荐搜索:
ios-tweaktheos-logossubstrate-tweak
- 著名项目: 像
libcolorpicker(颜色选择器)、Zeppelin(状态栏图标) 等项目的源码都非常有学习价值。
专业论坛与社区
- r/jailbreak (Reddit): 全球最大的越狱社区,在
r/jailbreakdev子版块,你可以找到很多开发者分享的经验、教程和进行技术讨论。 - 国内论坛: 如 威锋网 的越狱版块,也有不少开发者分享教程和源码。
第三部分:图文与文档教程 (视频的补充)
视频教程有时效性,而经典的图文教程和文档是更持久的知识来源。
- Theos 官方文档: Theos 的 GitHub 仓库里有详细的文档和示例,是权威参考资料。
- Logos 语法的官方文档: 在 Theos 的源码中可以找到。
- 经典图文教程:
- 在搜索引擎(Google/Bing)中搜索 "iOS Tweak Development Guide" 或 "Logos Syntax Guide",可以找到很多博客文章,如 Pojntfx、os-cillation 等开发者都写过非常详尽的教程。
总结与建议
- 从视频入手,图文巩固: 先在 YouTube 或 B站上看一套完整的入门视频,快速建立对整个流程的宏观认识,然后遇到具体问题时,再去查阅官方文档或图文教程。
- 实践出真知: 不要只看不练,跟着视频,从创建 "Hello, World!" Tweak 开始,一步步尝试修改你常用的 App,这是最快的学习方式。
- 拥抱社区: 遇到问题多在 GitHub、Reddit 或国内论坛提问,开发者社区通常很友好。
- 保持耐心: 插件开发涉及逆向工程和系统底层,初期会遇到很多挫折,调试一个 Bug 可能需要几个小时,这是正常的。
祝您学习顺利,早日开发出自己的第一个越狱插件!
