文档项目配置
项目配置
预计阅读时间:5 分钟
概述
CodeFog 提供丰富的配置选项,让您可以精确控制混淆行为。 本文档将介绍所有可用的配置项及其用途。
基础配置
混淆前缀
prefix所有混淆后的标识符都会以此前缀开头,便于识别和调试。
默认值:
ZFJObj_示例:
UserManager → ZFJObj_8xK9m随机字符长度
randomLength混淆后标识符中随机部分的字符长度。
默认值:
5范围:
3 - 10自动备份
autoBackup混淆前自动创建项目备份。强烈建议保持开启。
默认值:
true混淆选项
| 选项 | 说明 | 默认 | 推荐 |
|---|---|---|---|
obfuscateClass | 混淆类名 | 开启 | |
obfuscateMethod | 混淆方法名 | 开启 | |
obfuscateProperty | 混淆属性名 | 开启 | |
encryptString | 字符串加密 | 关闭 | 可选 |
obfuscateResource | 资源文件混淆 | 关闭 | 可选 |
generateJunkCode | 生成垃圾代码 | 关闭 | 可选 |
filterSensitive | 敏感词过滤 | 开启 |
配置文件
CodeFog 支持使用 JSON 配置文件保存和加载配置。配置文件通常命名为 codefog.config.json:
{
"prefix": "ZFJObj_",
"randomLength": 5,
"autoBackup": true,
"obfuscation": {
"class": true,
"method": true,
"property": true,
"string": false,
"resource": false
},
"whitelist": {
"classes": ["AppDelegate", "SceneDelegate"],
"methods": ["viewDidLoad", "didReceiveMemoryWarning"],
"prefixes": ["UI", "NS", "CG"]
},
"output": {
"mappingFile": true,
"report": true
}
}导出配置:文件 → 导出配置
导入配置:文件 → 导入配置
白名单配置
白名单用于指定不需要混淆的类、方法或前缀。常见的白名单配置:
系统类前缀(自动排除)
UI*NS*CG*CA*CF*AV*MK*CL*SK*生命周期方法(自动排除)
viewDidLoadviewWillAppearviewDidAppeardeallocinit详细的白名单配置请参考 白名单配置 文档。