DEBUG_CONFIG_CHECK.md

Debug 配置检查报告

✅ 检查时间

2025-01-XX

📋 当前配置状态

1. 构建状态

• ✅ Debug 配置可以成功构建
• ✅ 编译无错误
• ✅ 代码签名成功

2. 关键配置检查

Bundle Identifier

• 当前 Debug: xyz.keben.EchoFlow
• 当前 Release: xyz.keben.EchoFlow
• 文档要求 Debug: xyz.keben.EchoFlow.debug
• 状态: ⚠️ 不符合文档要求

应用显示名称

• 当前 Debug: 未设置（使用默认名称）
• 文档要求 Debug: EchoFlow (Debug)
• 状态: ⚠️ 不符合文档要求

Entitlements 文件

• Debug: ✅ EchoFlow/EchoFlow.entitlements (正确)
• Release: ✅ EchoFlow/EchoFlowRelease.entitlements (正确)

编译配置

• Debug 编译条件: ✅ DEBUG (正确)
• Swift 优化级别: ✅ -Onone (正确)
• 调试信息格式: ✅ dwarf (正确)

⚠️ 发现的问题

问题 1: Bundle Identifier 未区分

影响:

• Debug 和 Release 版本使用相同的 Bundle ID
• 可能导致权限授权混乱
• 数据可能共享（UserDefaults、SwiftData）
• 无法同时运行两个版本进行对比测试

问题 2: 应用名称未区分

影响:

• 在系统设置中无法区分 Debug 和 Release 版本
• 权限授权时容易混淆

🔧 建议修复

修复步骤

1. 修改 Bundle Identifier

   • 在 Xcode 中打开项目
   • 选择 TARGETS > EchoFlow
   • 切换到 Build Settings
   • 搜索 PRODUCT_BUNDLE_IDENTIFIER
   • 展开配置，设置：
     • Debug: xyz.keben.EchoFlow.debug
     • Release: xyz.keben.EchoFlow (保持不变)

2. 添加应用显示名称

   • 在 Build Settings 中搜索 INFOPLIST_KEY_CFBundleName
   • 在 Debug 配置中添加：EchoFlow (Debug)
   • Release 配置保持为空（使用默认名称）

验证命令

# 检查 Debug 配置
xcodebuild -project EchoFlow.xcodeproj -scheme EchoFlow -configuration Debug -showBuildSettings | grep PRODUCT_BUNDLE_IDENTIFIER

# 检查 Release 配置
xcodebuild -project EchoFlow.xcodeproj -scheme EchoFlow -configuration Release -showBuildSettings | grep PRODUCT_BUNDLE_IDENTIFIER

# 检查应用名称
xcodebuild -project EchoFlow.xcodeproj -scheme EchoFlow -configuration Debug -showBuildSettings | grep INFOPLIST_KEY_CFBundleName

📊 配置对比

配置项	当前 Debug	当前 Release	文档要求 Debug	文档要求 Release	状态
Bundle ID	xyz.keben.EchoFlow	xyz.keben.EchoFlow	xyz.keben.EchoFlow.debug	xyz.keben.EchoFlow	⚠️ 需修复
应用名称	默认	默认	EchoFlow (Debug)	默认	⚠️ 需修复
Entitlements	EchoFlow.entitlements	EchoFlowRelease.entitlements	EchoFlow.entitlements	EchoFlowRelease.entitlements	✅ 正确
编译条件	DEBUG	-	DEBUG	-	✅ 正确
优化级别	-Onone	wholemodule	-Onone	wholemodule	✅ 正确

✅ 可用性评估

当前状态

• ✅ 可以构建: Debug 配置可以成功构建和运行
• ✅ 已修复: Bundle ID 和应用名称已按文档要求配置
• ✅ 配置正确: Debug 和 Release 版本已完全分离

修复完成

配置已按照文档要求修复：

1. ✅ Debug Bundle ID 已改为 xyz.keben.EchoFlow.debug
2. ✅ Debug 应用名称已设置为 EchoFlow (Debug)
3. ✅ Release 配置保持不变

现在 Debug 和 Release 版本完全独立，可以：

• ✅ 避免数据冲突
• ✅ 独立管理权限授权
• ✅ 同时运行两个版本进行测试

📚 相关文档

• DEBUG_RELEASE_DIFF.md - Debug 与 Release 版本差异说明
• XCODE_DEBUG_GUIDE.md - Xcode 调试指南