文档映射文件
映射文件
预计阅读时间：5 分钟
什么是映射文件？
映射文件记录了混淆前后标识符的对应关系。它是还原崩溃日志、 调试混淆后代码的关键文件，务必妥善保存。
映射文件格式
{
"version": "2.3.2",
"timestamp": "2025-01-03T10:30:00Z",
"project": "MyApp",
"mappings": {
"classes": {
"UserManager": "ZFJObj_8xK9m",
"PaymentService": "ZFJObj_3nM7k",
"LoginViewController": "ZFJObj_9pX4j"
},
"methods": {
"loginWithUsername:password:": "zfj_4nM9k:zfj_3pL7j:",
"processPayment:": "zfj_6kX9m:",
"validateUserInput:": "zfj_5jM3n:"
},
"properties": {
"userName": "zfj_4nM2k",
"isLoggedIn": "zfj_7pX3j",
"balance": "zfj_8kX4m"
}
}
}崩溃日志还原
使用映射文件还原混淆后的崩溃日志：
混淆后的崩溃日志
-[ZFJObj_8xK9m zfj_4nM9k:zfj_3pL7j:] + 123还原后的崩溃日志
-[UserManager loginWithUsername:password:] + 123使用方法
方法一：CodeFog 内置工具
工具 → 崩溃日志还原 → 粘贴日志 → 选择映射文件
方法二：命令行工具
codefog restore -m mapping.json -l crash.log方法三：在线工具
访问 codefog.app/tools/restore 使用在线还原工具
映射文件管理
每次发版后保存映射文件，命名包含版本号
将映射文件存储在安全的位置（不要公开）
建议使用云存储备份映射文件
保留至少最近 5 个版本的映射文件
重要提示
- •映射文件丢失将无法还原崩溃日志
- •不要将映射文件提交到公开仓库
- •建议加密存储映射文件