夜雨聆风学习资料网

ARTICLE · 1390089

没有 Mac,也能编译 iOS 插件:WSL 全流程

没有 Mac,也能编译 iOS 插件:WSL 全流程

我手上没有 Mac,只有一台 Windows 台式机和一块显卡。但我确实需要一个能在 iPhone 上跑的插件。

绝大多数教程到这个点就断在「你需要一台 Mac,装 Xcode」——好像没 Mac 就没资格碰 iOS。其实不是。iOS 插件的编译只依赖一个交叉编译工具链和一份 iOS SDK,跟 macOS 系统本身没多大关系。

这篇讲怎么在 WSL 里把环境搭起来,一次配好,之后改代码只要 make 一条命令。


一、先讲清楚原理,不然装完也不知道自己在干什么

Windows 上能编出 iOS 的 .dylib,靠的是三样东西:

  1. clang:编译器本身是跨平台的,只要告诉它「目标平台是 iOS、目标是 arm64」,它就能产出 ARM64 的 Mach-O 文件;
  2. iOS SDK:头文件和系统库,主要来自 Xcode 里的 iPhoneOS.sdk;
  3. Theos:一套 Makefile 模板 + 打包脚本,把「编译 → 链接 → 签名 → 打 deb」串起来。

所以链路是:

WSL(Ubuntu) + clang + iPhoneOS.sdk + Theos  →  .dylib  →  .deb

macOS 的作用只是「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 的几条路,按可行性排序:

  1. 从别人整理好的仓库下载(最省事):搜索 theos/sdks,把 iPhoneOS16.x.sdk 解压进 $THEOS/sdks;
  2. 从 Xcode 里提取:Mac 上 Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/,打包成 tar 拷过来;
  3. 从 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:hello
  • Package Name:com.termplus.hello
  • Author:你的名字
  • 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
SDK 目录版本号与 TARGET 不一致
改 TARGET 或补 SDK
logos: command not found
没 --recursive 拉 submodule
重新 git submodule update --init
编出来的 dylib 一加载就崩
没签名
ldid -S
编译极慢、偶发权限错误
工程在 /mnt/c
挪到 ~/code
undefined symbol _OBJC_CLASS_$_XXX
头文件没引,或私有类没声明
加 @interface XXX : NSObject @end
装上去没反应
Bundle Filter 写错进程
确认目标进程 bundle id

这里展开说第五个。Theos 编译时如果引用了系统私有类(比如 SBHomeScreenViewController),编译器不知道它存在,会报 undefined symbol。解决办法不是去逆向出完整头文件,先写个空声明就够:

@interfaceSBHomeScreenViewController : UIViewController@end

只要方法签名对得上,运行时 objc_msgSend 会自己找到实现。这也是 iOS 插件开发比想象中轻的原因:你不需要整个 SDK 的私有头,只需要你碰的那几个类。


九、为什么值得折腾这一套

有 Mac 的人可能觉得这没必要。但没有 Mac 的时候,这套环境是唯一能让你把想法变成可安装产物的路。

而且它有个额外好处:全命令行。改一行代码,make package,产物直接 scp 到手机。整个循环比在 Xcode 里点来点去快得多,也更容易脚本化——我后来把「编译 + 签名 + 推送安装」写成了一个脚本,一条命令从改代码到手机上生效。

下一篇讲真正的内容:%hook 到底怎么写,才能让一个插件在 SpringBoard 里稳定活着,而不是开了就崩。


免责声明:本文仅用于个人设备上的技术研究与学习。请勿将相关技术用于绕过他人设备的安全机制或侵犯他人权益。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料