设备型号数据库(友好名称)

设备型号数据库(友好名称)

适用场景

在以下情况下使用本页面:

  • 更新设备型号标识符映射或 NOTICE/许可证文件
  • 更改实例 UI 如何显示设备名称

macOS 伴侣应用通过将 Apple 型号标识符(例如 iPad16,6Mac16,6)映射到人类可读的名称,在实例 UI 中显示友好的 Apple 设备型号名称。

该映射作为 JSON 提供在:

  • apps/macos/Sources/Moltbot/Resources/DeviceModels/

数据来源

我们目前从 MIT 许可的仓库提供映射:

  • kyle-seongwoo-jun/apple-device-identifiers

为了保持构建确定性,JSON 文件被固定到特定的上游提交(记录在 apps/macos/Sources/Moltbot/Resources/DeviceModels/NOTICE.md 中)。

更新数据库

  1. 选择要固定到的上游提交(一个用于 iOS,一个用于 macOS)。
  2. 更新 apps/macos/Sources/Moltbot/Resources/DeviceModels/NOTICE.md 中的提交哈希。
  3. 重新下载 JSON 文件,固定到这些提交:
IOS_COMMIT="<commit sha for ios-device-identifiers.json>"
MAC_COMMIT="<commit sha for mac-device-identifiers.json>"

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${IOS_COMMIT}/ios-device-identifiers.json" \
  -o apps/macos/Sources/Moltbot/Resources/DeviceModels/ios-device-identifiers.json

curl -fsSL "https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers/${MAC_COMMIT}/mac-device-identifiers.json" \
  -o apps/macos/Sources/Moltbot/Resources/DeviceModels/mac-device-identifiers.json
  1. 确保 apps/macos/Sources/Moltbot/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt 仍然与上游匹配(如果上游许可证更改,请替换它)。
  2. 验证 macOS 应用干净地构建(无警告):
swift build --package-path apps/macos