watchOS端OSSignposter无法启用，iOS端正常，求排查方案

问题背景 #

在watchOS应用中使用OSSignposter标记性能关键点时，实体Apple Watch上signposter.isEnabled始终返回false，Instruments的Points of Interest面板无任何数据。iOS端使用完全相同的代码逻辑可正常工作，Watch应用能正常运行、打印日志可被Instruments捕获，但标记点功能完全不生效。

已尝试的无效操作 #

• 同时测试过新版OSSignposter和旧版os_signpost(...) API，结果一致
• 确认标记点调用方法已执行，对应打印输出正常
• Instruments添加了stdout/stderr工具，可正常捕获Watch应用日志
• 尝试过从Instruments启动应用和附加到运行中的Watch应用
• Watch的Profile方案采用Debug构建配置
• 在Watch应用Info.plist中添加OSLogPreferences，且subsystem与代码中一致
• 在Instruments中配置了subsystem筛选器
• 测试默认无参数OSSignposter()，isEnabled仍返回false

有效排查与解决步骤 #

1. 修正Info.plist的OSLogPreferences配置 #

确保Watch应用Info.plist中的OSLogPreferences格式完全正确，注意PointsOfInterest的大小写（对应代码中的.pointsOfInterest枚举）：

<key>OSLogPreferences</key>
<dict>
    <key>com.myapp.watch</key>
    <dict>
        <key>PointsOfInterest</key>
        <dict>
            <key>Enabled</key>
            <true/>
        </dict>
    </dict>
</dict>

2. 确认Instruments的跟踪目标 #

• 在Instruments中启动Watch应用时，务必选择Apple Watch设备下的应用进程，而非配对iPhone上的配套应用进程。可通过Instruments的设备筛选栏切换到Apple Watch设备，再选择目标应用。
• 若使用附加进程功能，确认附加的是Watch上的应用实例，而非iPhone端进程。

3. 验证版本兼容性 #

确保Apple Watch系统版本、Xcode版本、Instruments版本相互兼容：

• watchOS 9+需要搭配Xcode 14+
• 若使用watchOS 10+，建议使用Xcode 15.1及以上版本（部分早期Xcode 15版本存在Bug）

4. 重置系统日志服务 #

重启Apple Watch和配对的iPhone，重新连接Xcode后再尝试用Instruments启动应用。系统日志服务的缓存可能导致标记点功能失效。

5. 用命令行工具验证OSLog状态 #

通过log命令行工具排查标记点是否真的未输出：

1. 配置日志级别：

   log config --subsystem com.myapp.watch --mode level:debug,persist:debug
   

2. 启动Watch应用并触发标记点，然后查看日志流：

   log stream --device --subsystem com.myapp.watch --category PointsOfInterest
   

   • 若命令行能捕获到标记点，说明Instruments的配置存在问题；
   • 若命令行也无输出，说明应用配置或系统层面存在限制。

已知限制与注意事项 #

• watchOS的Release构建默认禁用OSSignposter，必须使用Debug构建，或在Release构建中手动配置OSLogPreferences开启标记点。
• 旧款Apple Watch（如Series 3及更早）可能存在OSSignpost支持受限的情况，建议在新款设备上测试。
• 部分用户反馈watchOS 10 + Xcode 15早期版本组合中，存在Instruments无法捕获Watch标记点的Bug，可尝试升级Xcode或watchOS到最新正式版。

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