Apple-Gerätenamen in der macOS App verwalten

Kennst du das? Du schaust in dein UI und siehst kryptische Bezeichner wie iPad16,6 oder Mac16,6. Niemand weiß aus dem Kopf, welches Modell sich dahinter verbirgt. Für eine gute User Experience solltest du diese IDs in menschenlesbare Namen übersetzen.

In der macOS App lösen wir das über ein Mapping, das als JSON-Datei hinterlegt ist. So stellst du sicher, dass Nutzer in der Instances UI immer genau sehen, welches Gerät sie vor sich haben.

Voraussetzungen

• Zugriff auf das Verzeichnis apps/macos/Sources/OpenClaw/Resources/DeviceModels/
• Die installierte Swift Toolchain für den Build-Check
• curl für den Download der aktuellen Daten
• Die Upstream-Quelle: kyle-seongwoo-jun/apple-device-identifiers

Schnellstart

Um die Datenbank aktuell zu halten, nutzen wir deterministische Builds. Das bedeutet, wir pinnen die JSON-Dateien auf spezifische Commits der Upstream-Quelle. Folge diesen Schritten, um die Namen zu aktualisieren:

1. Wähle die Upstream-Commits aus, die du verwenden möchtest (einen für iOS, einen für macOS).
2. Trage die Commit-Hashes in der Datei apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md ein.
3. Lade die JSON-Dateien mit den entsprechenden Commits herunter:

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/OpenClaw/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/OpenClaw/Resources/DeviceModels/mac-device-identifiers.json

4. Prüfe, ob die Datei apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt noch mit dem Upstream übereinstimmt und ersetze sie, falls sich die Lizenz geändert hat.

Fehlerbehebung

Falls nach dem Update Probleme auftreten, überprüfe den Build-Status. Die App sollte ohne Warnungen bauen:

• Problem: Build-Warnungen oder Fehler nach dem Austausch der JSON-Dateien.
• Lösung: Führe den Build-Befehl manuell aus, um die Integrität zu prüfen:

swift build --package-path apps/macos

Stelle sicher, dass die Pfade zu den JSON-Ressourcen korrekt in der Projektstruktur hinterlegt sind, falls die Dateien nicht erkannt werden.

Fragen zum Setup? Nutze den AI Setup Assistant.

Nächste Schritte

• macOS App Architektur
• UI-Komponenten Guide