rudrankriyam/asc-metadata-sync

O que asc-metadata-sync faz?

Sincronize, valide e aplique metadados da App Store com o fluxo de trabalho atual de metadados canônicos do asc. Use ao atualizar metadados, localizações, palavras-chave ou migrar metadados legados do fastlane.

Visão Geral

Esta habilidade permite que você gerencie metadados da App Store de forma programática, garantindo que estejam em conformidade com o formato canônico mais recente do App Store Connect (asc). Ela agiliza o processo de atualização de informações do aplicativo, como descrições, palavras-chave e URLs de suporte, e facilita a migração de projetos do fastlane.

Funcionalidades

• Sincronização de Metadados: Leia metadados de um arquivo metadata.json e envie para a App Store.
• Validação: Verifique a estrutura e o conteúdo dos metadados contra um esquema canônico.
• Aplicação: Aplique alterações de metadados à App Store via API.
• Suporte a Localizações: Gerencie múltiplas localizações de metadados.
• Migração: Converta metadados legados do fastlane para o formato canônico.

Plataformas Suportadas

• Claude Code
• Cursor
• Codex

Como Usar

1. Prepare um arquivo metadata.json com os metadados do aplicativo no formato canônico.
2. Execute o comando de sincronização para validar e aplicar os metadados.
3. Verifique as alterações na App Store.

Estrutura do metadata.json

{
  "appId": "1234567890",
  "localizations": [
    {
      "locale": "en-US",
      "name": "Meu Aplicativo",
      "subtitle": "A melhor experiência",
      "description": "Descrição do aplicativo em inglês.",
      "keywords": "app, experiência, inovação",
      "supportUrl": "https://exemplo.com/suporte"
    },
    {
      "locale": "pt-BR",
      "name": "Meu Aplicativo",
      "subtitle": "A melhor experiência",
      "description": "Descrição do aplicativo em português.",
      "keywords": "aplicativo, experiência, inovação",
      "supportUrl": "https://exemplo.com/suporte"
    }
  ]
}

Comandos

• asc metadata sync: Sincroniza metadados do arquivo metadata.json para a App Store.
• asc metadata validate: Valida o arquivo metadata.json sem aplicar alterações.
• asc metadata migrate: Converte metadados do fastlane para o formato canônico.

Exemplo de Uso

# Validar metadados antes de sincronizar
asc metadata validate

# Sincronizar metadados para a App Store
asc metadata sync

# Migrar metadados do fastlane
asc metadata migrate --from fastlane

Observações

• Certifique-se de ter as credenciais do App Store Connect configuradas.
• O arquivo metadata.json deve seguir o esquema canônico para evitar erros de validação.
• Para migração, o fastlane deve exportar metadados no formato metadata.json legado.

Contribuição

Contribuições são bem-vindas! Envie pull requests para melhorias ou correções.