Gestión de nombres de dispositivos Apple

¿Alguna vez has intentado explicarle a un usuario qué significa un identificador como iPad16,6? Es una pérdida de tiempo. Los identificadores técnicos son fundamentales para el código, pero en la interfaz de usuario necesitas nombres reales que las personas entiendan. Mapear estos IDs manualmente es una tarea pesada que suele quedar desactualizada rápido.

La mejor forma de solucionar esto es usar una base de datos de mapeo externa. En la app de macOS, gestionamos esto mediante archivos JSON que convierten identificadores crudos en nombres amigables dentro de la UI de Instances.

Requisitos previos

• Repositorio local de la aplicación.
• Herramienta curl instalada en tu terminal.
• Swift instalado para validar la compilación.
• Acceso al repositorio upstream de identificadores.

Inicio rápido

Para mantener las builds deterministas, los archivos JSON están vinculados a commits específicos del repositorio kyle-seongwoo-jun/apple-device-identifiers. Sigue estos pasos para actualizar la base de datos:

1. Identifica los hashes de los commits que quieres usar (uno para iOS y otro para macOS) en el repositorio upstream.
2. Actualiza los hashes en el archivo apps/macos/Sources/OpenClaw/Resources/DeviceModels/NOTICE.md.
3. Ejecuta los siguientes comandos para descargar los archivos actualizados:

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. Verifica que el archivo apps/macos/Sources/OpenClaw/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt coincida con la licencia del upstream. Si ha cambiado, reemplázalo.

Solución de problemas

Aparecen advertencias al compilar Si después de actualizar los archivos JSON notas comportamientos extraños, verifica que la estructura del paquete sea correcta ejecutando una compilación limpia:

swift build --package-path apps/macos

Cambios en la licencia upstream Si el repositorio original cambia sus términos, debes actualizar el archivo de licencia local inmediatamente para evitar problemas legales en la distribución de la app.

Si necesitas ayuda con la configuración de tu entorno, consulta el AI Setup Assistant.

Próximos pasos

• Documentación de la UI de Instances
• Guía de recursos en macOS