Release版XCFramework分发后外部开发者可见debug级os_log问题

核心原因 #

1. Release构建未过滤Debug级日志：默认情况下os_log的.debug级别日志在Release构建中会被系统过滤，但如果你的Framework构建配置未正确设置日志相关编译选项，或是外部开发者的应用开启了Debug日志采集，就会导致日志泄露。
2. %{private}的局限性：%{private}仅在系统默认日志设置下脱敏，若外部开发者手动开启了日志的“显示私有数据”选项，仍能看到明文内容——但前提是该日志本身被允许输出。

解决方案 #

1. 用编译宏彻底移除Release下的Debug日志 #

在Framework代码中通过预编译宏，仅在Debug构建时保留Debug级os_log调用，Release构建直接跳过：

#if DEBUG
os_log("Network response: %@", log: Self.log, type: .debug, String(describing: response))
os_log("Network response data: %{private}@",
       log: Self.log,
       type: .debug,
       String(data: data, encoding: .utf8)!)
#endif

这种方式能从根源上让Release构建的XCFramework不包含Debug日志代码，杜绝泄露可能。

2. 检查Framework的Release构建配置 #

在Framework的Build Settings中确认：

• Preprocessor Macros的Release配置包含NDEBUG=1（Xcode默认会设置，需确认未被修改）。
• 添加OS_ACTIVITY_MODE环境变量并设为disable，可通过Build Settings的Other C Flags添加-DOS_ACTIVITY_MODE=disable，强制关闭Release下的日志输出。

3. 加固敏感数据的日志处理 #

即使日志被意外输出，也要确保敏感数据不泄露：

• 避免直接打印完整响应数据，对token、隐私字段等敏感内容手动脱敏后再输出。
• 对于必须记录的敏感数据，使用%{private}的同时，可先对数据进行加密再写入日志（OSLog本身会加密存储，但明文传入仍有风险）。

4. 告知外部开发者配置日志过滤 #

提醒集成XCFramework的开发者，在自身应用的Release构建中：

• 将Scheme的Run配置里的OS_ACTIVITY_MODE设为disable，关闭Debug日志采集。
• 通过log config --mode "private_data:off"命令关闭日志的“显示私有数据”选项。

内容的提问来源于stack exchange，提问作者Richard Topchii