¿Qué hace asc-metadata-sync?
Sincroniza, valida y aplica metadatos de la App Store con el flujo de trabajo canónico actual de asc. Úsalo al actualizar metadatos, localizaciones, palabras clave o migrar metadatos heredados de fastlane.
Descripción
Este skill automatiza el proceso de sincronización de metadatos de la App Store utilizando la herramienta asc (App Store Connect CLI). Permite:
- Sincronizar metadatos desde un archivo local a App Store Connect.
- Validar que los metadatos cumplan con las reglas de formato y contenido.
- Aplicar cambios de forma segura, evitando sobrescrituras accidentales.
- Migrar configuraciones de fastlane al formato canónico de
asc.
Requisitos
- Tener instalada la herramienta
asc(versión 0.7.0 o superior). - Configurar autenticación con App Store Connect (API Key o App Store Connect API).
- Archivo de metadatos en formato YAML o JSON según el esquema canónico.
Uso
Sincronizar metadatos
asc metadata sync --input metadata.yaml
Validar metadatos
asc metadata validate --input metadata.yaml
Aplicar cambios
asc metadata apply --input metadata.yaml
Migrar desde fastlane
asc metadata migrate --from fastlane --output metadata.yaml
Estructura del archivo de metadatos
El archivo de metadatos debe seguir el esquema canónico:
app:
apple_id: "1234567890"
name:
default: "Mi App"
subtitle:
default: "Subtítulo"
description:
default: "Descripción de la app"
keywords:
default: "palabra1, palabra2"
privacy_url:
default: "https://ejemplo.com/privacidad"
support_url:
default: "https://ejemplo.com/soporte"
marketing_url:
default: "https://ejemplo.com/marketing"
Integración con CI/CD
Puedes integrar este skill en pipelines de GitHub Actions, GitLab CI, o cualquier sistema que ejecute comandos de shell:
- name: Sincronizar metadatos
run: asc metadata sync --input metadata.yaml
Solución de problemas
- Error de autenticación: Verifica que la API Key esté configurada correctamente en las variables de entorno (
ASC_API_KEY,ASC_API_ISSUER_ID). - Validación fallida: Revisa el archivo de metadatos para errores de formato o contenido.
- Conflictos de versión: Asegúrate de usar la misma versión de
ascen todos los entornos.
Recursos adicionales
Licencia
Este skill se distribuye bajo la licencia MIT. Ver el archivo LICENSE para más detalles.