小蟹CrabiOS混淆｜Objective‑C项目实战教程，非源码混淆解决4.3拒审问题
文档参考：https://crab‑ios.com/docs/site/新手教程/iOS App confuse(ObjC)/
前言
在iOS开发中，Objective‑C项目经常会遇到两个痛点：
- 业务代码容易被逆向，类名、方法名全部暴露，安全风险高；
- 同源多包上架，被App Store机审判定4.3同质化拒审。
传统的源码级混淆工具（如ios‑class‑guard）修改原始.h/.m源码，混淆之后代码可读性完全破坏，线上崩溃难以定位dSYM，迭代维护成本很高。
小蟹CrabiOS（小蟹iOS混淆）采用编译后二进制混淆 ，不改动你的原始Objective‑C业务源码，直接处理编译产物Mach‑O、资源、第三方静态SDK；同时可以还原dSYM符号表，Bugly等崩溃工具依然正常解析，兼顾混淆加固与线上问题排查，原生OC项目可以快速接入。
一、工具核心原理（区别传统源码混淆）
传统源码混淆：修改.m/.h源代码，替换类名、方法名字符串，一旦混淆出问题，需要阅读一堆乱码源码排错，线上崩溃dSYM失效，迭代需要每次重新跑混淆脚本。
CrabiOS非源码混淆核心逻辑：
- 源码阶段完全不动业务OC代码，保持原始工程可以正常编译调试；
- 在编译完成之后，直接操作中间产物、可执行文件Mach‑O；
- 做代码膨胀、常量加密、OC方法/属性/实例变量符号重命名；
- 修改资源文件名、加密资源，抹掉二进制特征指纹；
- 还原Release包dSYM调试符号文件，线上崩溃日志可还原；
- Debug模式保留调试信息，混淆后的产物依旧可以Xcode断点调试。
支持语言：C / C++ / Objective‑C / Objective‑C++ / Swift / Dart；支持静态
.a、Static Framework、XCFramework第三方SDK混淆处理。支持Xcode版本：Xcode16.x、Xcode26.x（1.8之后版本不再支持Xcode15.x）。
二、下载与环境准备
1、获取安装包
- 官网下载
- 将
CrabiOS.app拖拽到Applications应用目录，不要直接在dmg镜像内直接运行
2、环境依赖检查
运行工具前确认Mac环境：
- Xcode 16.x 及以上版本
- Homebrew、Python3、pip3
- 项目正常可以在Xcode编译出Release IPA
3、授权版本说明
| 功能 | 免费版 | 收费商业版 |
|---|---|---|
| Objective‑C代码混淆 | ✅支持 | ✅支持 |
| dSYM文件还原混淆 | ❌无 | ✅有 |
| AppStore正式上包支持 | ❌无 | ✅有 |
| 马甲对比分析工具 | ❌无 | ✅有 |
| 编译加速 | ❌无 | ✅有 |
| 官方技术支持 | ❌无 | ✅有 |
| 新手引导、产品文档 | ✅有 | ✅有 |
免费版可以做本地测试验证混淆效果；提交App Store审核必须使用商业授权版本。
三、Objective‑C项目接入完整步骤
Step1：创建项目，导入Xcode工程
- 打开
CrabiOS.app，点击【创建项目】，选择你的.xcworkspace或者.xcodeproj（OC原生项目）。 - 工具自动解析Targets、源码文件（
.h/.m/.mm）、Pod依赖、资源文件（xcassets/plist/xib/storyboard/bundle）。 - 在文件树列表，勾选你需要参与混淆的Objective‑C源码文件；不需要混淆的第三方库可以取消勾选，或者使用排除配置。
界面截图参考：工具会列出全部
.swift/.m源码文件，R/C/I标记代表：重命名、代码膨胀、常量加密三类开关，可以单独对文件开启关闭能力。
Step2：配置排除规则（非常关键！避免崩溃）
打开【设置】面板，针对OC项目重点配置排除项：
- 排除文件‑更名 ：系统分类、IB绑定的xib/storyboard关联类、部分第三方SDK头文件，禁止符号重命名，否则会出现
unrecognized selector崩溃。 - 排除文件‑混淆 / 膨胀 ：部分闭源静态SDK（
.a/framework），如果混淆后闪退，加入排除列表。 - 排除对象‑语言 ：可以按文件通配符，例如
*.xcassets、*.plist做资源过滤。
注意：IB（xib/storyboard）绑定的类名、方法，如果直接混淆改名，运行会找不到类，要么加入排除，让工具自动同步修改xib内类名字符串。
Step3：识别常量，开启混淆选项
- 切换【识别常量】Tab，工具扫描OC源码中字符串常量，准备执行字符串加密；
- 对于Objective‑C项目，默认开启三项核心能力：
- 符号重命名：OC Class、Protocol、Property、Ivar、Method方法名混淆
- 代码膨胀：对函数做指令膨胀，改变二进制整体特征，对抗机审指纹
- 常量加密：加密硬编码字符串，降低4.3同源判定概率
Step4：点击【开始混淆】
工具完整流程：
源码解析 → 文件名修改 → 代码膨胀+常量加密 → 符号混淆 → 链接处理 → 还原dSYM → 生成最终IPA包。
混淆结束之后生成两份输出：
- 混淆完成的IPA安装包，可以直接重签名测试；
- 混淆报表：报表页面展示原有符号名、混淆后的符号映射，包含objcmethod、objcproperty、objccategory等Objective‑C全部符号信息，还会统计整体匹配率（内建符号、字符串、元数据匹配率）。
报表可以用来排查问题：如果某个方法崩溃，可以通过原始方法名，查到混淆之后的符号。
Step5：本地验证测试
- 将输出IPA重签名，安装到测试设备，完整跑一遍业务流程；
- 优先检查：页面跳转、按钮点击（selector）、xib加载、第三方SDK回调，确认没有崩溃；
- Release版本商业版输出还原后的dSYM文件，上传Bugly，验证崩溃堆栈可以正常解析。
💡 小技巧：Debug版本混淆产物可以直接Xcode附加进程调试，工具保留调试信息，不用看混淆后的源码，直接看自己原始工程调试，这是对比传统源码混淆巨大优势。
四、Objective‑C项目踩坑清单
-
❗XIB / Storyboard绑定类和方法
工具会自动修改xib、storyboard内部类名字符串；如果出现找不到类崩溃，检查是否把该类加入【排除文件‑更名】，如果不需要混淆该类，保留排除。
-
❗Runtime动态字符串创建类
NSClassFromString(@"XXXClass")代码中硬写字符串动态创建Class，混淆后类名变化，字符串没有同步修改，运行返回nil。
解决方案：
- 要么把这个类加入排除列表，不混淆类名；
- 业务代码不要硬编码字符串写类名，尽量避免
NSClassFromString硬编码。
-
❗第三方.a / Static Framework
部分闭源静态库，混淆之后直接闪退，直接在【依赖文件】配置中加入混淆排除。
-
❗通知名称、硬编码字符串key
常量加密会加密OC的
@"notify_key"这类字符串；业务如果自己硬编码字符串和外部交互，需要加入常量排除，否则服务端交互、通知监听失效。 -
❗Pod管理的第三方库
Pod库默认会扫描进来，如果不需要混淆第三方，批量勾选Pod路径文件取消混淆，或者配置通配符排除。
五、和传统iOS‑class‑guard对比总结
| 对比项 | ios‑class‑guard（源码混淆） | CrabiOS小蟹非源码混淆 |
|---|---|---|
| 修改对象 | 修改.h/.m原始源码 | 编译产物二进制，源码完全不动 |
| dSYM支持 | 破坏dSYM，线上堆栈无法还原 | 商业版还原dSYM，Bugly可用 |
| 调试能力 | 混淆后只能看乱码源码调试 | 原始源码直接调试混淆后程序 |
| OC/Swift混编 | 对Swift支持很差 | 完美支持OC+Swift混编项目 |
| 资源文件处理 | 不处理图片/plist等资源 | 支持全部资源改名加密 |
| 第三方静态库 | 无法处理.a/framework | 可混淆外部静态SDK文件 |
| 马甲包差异化 | 每次改源码，维护成本高 | 一键生成特征不同IPA，适合多包 |
六、适用场景与边界
✅ 适合场景：
- Objective‑C原生项目，想要做代码逆向防护；
- 同源多马甲包，解决App Store4.3同质化拒审；
- 老OC大型项目，不想改动现有业务源码，不想维护复杂混淆脚本；
- 项目混编C/C++、Swift，包含Pod第三方静态库。
⚠️ 注意边界：
工具主打二进制特征差异化，对抗机审、增加逆向难度，主要用于App Store上架场景；不等同专业防dump、反调试加固，如果需要强逆向防护，可以配合IR级定向加固一起使用。
七、获取支持
本文为实战教程，仅供技术学习研究，App上架请遵循Apple开发者协议。
标签：
iOS混淆,Objective‑C,AppStore4.3,CrabiOS,小蟹混淆