ARTICLE · 1390089
没有 Mac,也能编译 iOS 插件:WSL 全流程
我手上没有 Mac,只有一台 Windows 台式机和一块显卡。但我确实需要一个能在 iPhone 上跑的插件。
绝大多数教程到这个点就断在「你需要一台 Mac,装 Xcode」——好像没 Mac 就没资格碰 iOS。其实不是。iOS 插件的编译只依赖一个交叉编译工具链和一份 iOS SDK,跟 macOS 系统本身没多大关系。
这篇讲怎么在 WSL 里把环境搭起来,一次配好,之后改代码只要 make 一条命令。

一、先讲清楚原理,不然装完也不知道自己在干什么
Windows 上能编出 iOS 的 .dylib,靠的是三样东西:
clang:编译器本身是跨平台的,只要告诉它「目标平台是 iOS、目标是 arm64」,它就能产出 ARM64 的 Mach-O 文件; iOS SDK:头文件和系统库,主要来自 Xcode 里的 iPhoneOS.sdk;Theos:一套 Makefile 模板 + 打包脚本,把「编译 → 链接 → 签名 → 打 deb」串起来。
所以链路是:
WSL(Ubuntu) + clang + iPhoneOS.sdk + Theos → .dylib → .debmacOS 的作用只是「Xcode 自带 SDK」和「能跑 codesign」。前者可以从别处拿,后者用 ldid 替代。整条链上唯一必须的 Apple 产品,是 SDK 里的头文件。
二、WSL2 与基础依赖
Windows 10/11 打开「虚拟机平台」和「适用于 Linux 的 Windows 子系统」,然后:
wsl --install -d Ubuntu-22.04wsl --set-default-version 2
进 WSL 之后先换源(国内环境),再装编译依赖:
sudo apt updatesudo apt install -y \build-essential git curl make \libssl-dev libxml2-dev libplist-dev \fakeroot dpkg-dev file unzip \clang-14 lld-14
fakeroot 和 dpkg-dev 是打 deb 用的,libplist-dev 是 Theos 处理 Info.plist 用的。少一个都会在后面报一个看不出因果的错。
这里有个坑:不要在/mnt/c下面建工程。Windows 文件系统和 Linux 的 inode 行为不同,Theos 在 make 时会有大量小文件操作,放在 /mnt/c 下速度慢十倍,还偶尔触发符号链接错误。工程放在 WSL 自己的 ~/code 里,编完再把产物复制出来。
三、装 Theos
export THEOS=~/theosgit clone --recursive https://github.com/theos/theos.git $THEOS
--recursive 不能省,Theos 依赖几个 submodule(logos、nic)没拉下来,后面 %hook 会直接编译失败。
把环境变量写进 ~/.bashrc:
export THEOS=$HOME/theosexport PATH=$THEOS/bin:$PATH
重新登录 shell,验证:
nic.pl --version四、iOS SDK:整条链最容易翻车的一步
Theos 本身不带 SDK,需要单独放:
mkdir -p $THEOS/sdks获取 SDK 的几条路,按可行性排序:
从别人整理好的仓库下载(最省事):搜索 theos/sdks,把iPhoneOS16.x.sdk解压进$THEOS/sdks;从 Xcode 里提取:Mac 上 Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/,打包成 tar 拷过来;从 Xcode 的 .xip里解:本机没有 Mac 的话,可以用 7-Zip 直接解压 xip,进Xcode.app里找 SDK 目录。
目录结构必须是这样,多一层文件夹就会找不到:
~/theos/sdks/iPhoneOS16.5.sdk/usr/include/...验证:
ls $THEOS/sdksecho 'int main(){return 0;}' > /tmp/t.cclang -isysroot $THEOS/sdks/iPhoneOS16.5.sdk \-arch arm64 -miphoneos-version-min=14.0 \-c /tmp/t.c -o /tmp/t.ofile /tmp/t.o
file 输出里出现 Mach-O 64-bit arm64 object 就说明 SDK 和编译器都对上了。这一步过了,后面 80% 的问题都不会出现。
五、ldid:替代 codesign 的那把钥匙
iOS 加载二进制时会校验签名。没有 Mac 就没法用 codesign,改用 ldid 做「伪签名」:
sudo apt install -y libssl-devgit clone https://github.com/ProcursusTeam/ldid.gitcd ldid && git submodule update --initgcc -o ldid ldid.cpp -I. -x c++ lookup2.c -lcryptosudo cp ldid /usr/local/bin/
用法只有一个参数:
ldid -S MyTweak.dylib-S 表示用内置的 ad-hoc 证书签名。编完不签名,装到设备上会直接被系统拒载,日志里只留一行code signature invalid,很难往签名上想。
六、第一个工程
$THEOS/bin/nic.pl选 iphone/tweak,依次填:
Project Name: helloPackage Name: com.termplus.helloAuthor:你的名字 Bundle Filter: com.apple.springboard
Bundle Filter 是「这个插件注入到哪个进程」,SpringBoard 就是桌面进程,最方便验证。
生成出来的目录结构:
hello/├── Makefile├── Tweak.xm├── control└── hello.plist
Makefile 里只需要改一处:
TARGET := iphone:clang:16.5:14.0ARCHS = arm64 arm64e
16.5 是 SDK 版本,14.0 是最低系统版本。TARGET写错是最常见的编译失败原因,报错通常长这样:
error: SDK "iPhoneOS17.0.sdk" cannot be located意思就是 $THEOS/sdks 里没有这个版本的目录,改成你实际有的版本号即可。
七、跑一次 make
cd hellomake package
成功的话,.theos/obj/debug/ 下有 hello.dylib,packages/ 下有 com.termplus.hello_0.0.1-1+debug_iphoneos-arm.deb。
用 file 和 ldid 各验一遍:
file .theos/obj/debug/hello.dylib# Mach-O 64-bit dynamically linked shared library arm64
八、踩过的六个坑,按出现频率排序
SDK cannot be located | ||
logos: command not found | --recursive 拉 submodule | git submodule update --init |
ldid -S | ||
/mnt/c | ~/code | |
undefined symbol _OBJC_CLASS_$_XXX | @interface XXX : NSObject @end | |
这里展开说第五个。Theos 编译时如果引用了系统私有类(比如 SBHomeScreenViewController),编译器不知道它存在,会报 undefined symbol。解决办法不是去逆向出完整头文件,先写个空声明就够:
@interfaceSBHomeScreenViewController : UIViewController@end
只要方法签名对得上,运行时 objc_msgSend 会自己找到实现。这也是 iOS 插件开发比想象中轻的原因:你不需要整个 SDK 的私有头,只需要你碰的那几个类。
九、为什么值得折腾这一套
有 Mac 的人可能觉得这没必要。但没有 Mac 的时候,这套环境是唯一能让你把想法变成可安装产物的路。
而且它有个额外好处:全命令行。改一行代码,make package,产物直接 scp 到手机。整个循环比在 Xcode 里点来点去快得多,也更容易脚本化——我后来把「编译 + 签名 + 推送安装」写成了一个脚本,一条命令从改代码到手机上生效。
下一篇讲真正的内容:%hook 到底怎么写,才能让一个插件在 SpringBoard 里稳定活着,而不是开了就崩。
免责声明:本文仅用于个人设备上的技术研究与学习。请勿将相关技术用于绕过他人设备的安全机制或侵犯他人权益。















































































