Communitygithub.com

exiao/skills

Localize em massa nomes de exibição de assinaturas e compras no aplicativo para todos os idiomas da App Store usando asc. Use quando quiser preencher nomes de assinatura/IAP para cada idioma sem clicar manualmente no App Store Connect.

O que é skills?

Esta habilidade permite que você localize em massa nomes de exibição (e descrições) de assinaturas, grupos de assinaturas e compras dentro do aplicativo (IAPs) para todos os idiomas suportados pela App Store Connect, tudo pela linha de comando usando a ferramenta `asc`. Em vez de clicar manualmente em cada idioma na interface web do App Store Connect para definir o mesmo nome de exibição, você pode usar comandos simples para criar localizações em lote para todos os idiomas de uma só vez, economizando um tempo significativo e evitando erros manuais. A habilidade suporta fluxos de trabalho completos: primeiro, você verifica quais localizações já existem para evitar duplicatas; depois, cria localizações para os idiomas ausentes; e, por fim, verifica se tudo foi aplicado corretamente. Ela também cobre a atualização de localizações existentes e o processamento de aplicativos com vários grupos e assinaturas de forma sequencial, garantindo que a saída permaneça legível. A habilidade é baseada na ferramenta `asc` (App Store Connect CLI) e requer que a autenticação esteja configurada e que os grupos de assinaturas e assinaturas já existam no seu aplicativo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/exiao/skills/tree/HEAD/app-store/app-store-connect/subscription-localization

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Localização de assinaturas com asc

Use esta habilidade para criar ou atualizar em massa nomes de exibição (e descrições) para assinaturas, grupos de assinaturas e compras dentro do aplicativo em todos os idiomas do App Store Connect. Isso elimina o tedioso processo manual de clicar em cada idioma no App Store Connect para definir o mesmo nome de exibição.

Pré-condições

  • Autenticação configurada (asc auth login ou variáveis de ambiente ASC_*).
  • Saiba o ID do seu aplicativo (ASC_APP_ID ou --app).
  • Grupos de assinaturas e assinaturas já existem.

Idiomas suportados pela App Store

Estes são os idiomas suportados pelo App Store Connect para localizações de assinaturas e IAPs:

ar-SA, ca, cs, da, de-DE, el, en-AU, en-CA, en-GB, en-US,
es-ES, es-MX, fi, fr-CA, fr-FR, he, hi, hr, hu, id, it,
ja, ko, ms, nl-NL, no, pl, pt-BR, pt-PT, ro, ru, sk,
sv, th, tr, uk, vi, zh-Hans, zh-Hant

Fluxo de trabalho: Localizar em massa uma assinatura

1. Resolver IDs

# Encontrar grupos de assinaturas
asc subscriptions groups list --app "APP_ID" --output table

# Encontrar assinaturas dentro de um grupo
asc subscriptions list --group "GROUP_ID" --output table

2. Verificar localizações existentes

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

Isso mostra quais idiomas já possuem um nome definido. Crie localizações apenas para os idiomas ausentes.

3. Criar localizações para todos os idiomas ausentes

Para cada idioma que ainda não possui uma localização, execute:

asc subscriptions localizations create \
  --subscription-id "SUB_ID" \
  --locale "LOCALE" \
  --name "Display Name"

Por exemplo, para definir "Monthly Pro" em todos os idiomas:

# Um comando por idioma (pule qualquer um que já exista)
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ar-SA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ca" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "cs" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "da" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "de-DE" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "el" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-AU" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "en-GB" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-ES" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "es-MX" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-CA" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "fr-FR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "he" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "hu" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "id" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "it" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ja" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ko" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ms" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "nl-NL" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "no" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pl" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-BR" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "pt-PT" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ro" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "ru" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "sv" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "th" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "tr" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "uk" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "vi" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hans" --name "Monthly Pro"
asc subscriptions localizations create --subscription-id "SUB_ID" --locale "zh-Hant" --name "Monthly Pro"

4. Verificar

asc subscriptions localizations list --subscription-id "SUB_ID" --paginate --output table

Fluxo de trabalho: Localizar em massa um grupo de assinaturas

Grupos de assinaturas também têm seu próprio nome de exibição por idioma (este é o "nome do grupo" mostrado aos usuários na folha de gerenciamento de assinaturas).

1. Verificar localizações existentes do grupo

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

2. Criar para idiomas ausentes

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Group Display Name"

Opcional: definir um nome de aplicativo personalizado para o grupo:

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Group Display Name" \
  --custom-app-name "My App"

3. Verificar

asc subscriptions groups localizations list --group-id "GROUP_ID" --paginate --output table

Fluxo de trabalho: Localizar em massa uma compra dentro do aplicativo

Compras dentro do aplicativo (IAPs) têm seus próprios comandos de localização com o mesmo padrão.

1. Resolver ID da IAP

asc iap list --app "APP_ID" --output table

2. Verificar localizações existentes

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

3. Criar para idiomas ausentes

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Display Name"

Descrição opcional:

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Desbloquear Todos os Recursos" \
  --description "Compra única para desbloquear todos os recursos premium"

4. Verificar

asc iap localizations list --iap-id "IAP_ID" --paginate --output table

Atualizando Localizações Existentes

Para alterar o nome de exibição de localizações existentes:

Assinaturas

asc subscriptions localizations update --id "LOC_ID" --name "Novo Nome"

Grupos de Assinaturas

asc subscriptions groups localizations update --id "LOC_ID" --name "Novo Nome do Grupo"

Compras Dentro do Aplicativo

asc iap localizations update --id "LOC_ID" --name "Novo Nome"

Para atualizar em massa, primeiro liste as localizações existentes, extraia os IDs e depois atualize cada um.

Localizar em massa todas as assinaturas em um aplicativo

Para um aplicativo completo com vários grupos de assinaturas e assinaturas:

# 1. Listar todos os grupos
asc subscriptions groups list --app "APP_ID" --paginate

# 2. Para cada grupo, localize o próprio grupo
#    (repita o fluxo de trabalho de localização do grupo acima)

# 3. Para cada grupo, liste as assinaturas
asc subscriptions list --group "GROUP_ID" --paginate

# 4. Para cada assinatura, localize-a
#    (repita o fluxo de trabalho de localização de assinatura acima)

Comportamento do Agente

  • Sempre liste as localizações existentes primeiro para evitar erros de criação duplicada.
  • Pule idiomas que já possuem uma localização; crie apenas os ausentes.
  • Quando o usuário fornecer um único nome de exibição, use-o para todos os idiomas (mesmo nome em todos os lugares).
  • Quando o usuário fornecer nomes traduzidos por idioma, use o nome específico do idioma para cada um.
  • Se uma descrição for fornecida, passe --description na criação. Caso contrário, omita-a.
  • Use --output table nas etapas de verificação para que o usuário possa confirmar visualmente.
  • Use a saída JSON padrão para etapas intermediárias de automação.
  • Após a criação em massa, sempre execute o comando de lista para verificar a completude.
  • Para aplicativos com muitas assinaturas, processe-as sequencialmente por grupo para manter a saída legível.
  • Se uma chamada de criação falhar para um idioma, registre o idioma e o erro e continue com os idiomas restantes. Após o lote ser concluído, relate todas as falhas juntas para que o usuário possa resolvê-las.

Notas

  • Os nomes de exibição das assinaturas são o que os usuários veem na folha de gerenciamento de assinaturas e nos diálogos de compra.
  • Criar uma localização para um idioma que já existe falhará; sempre verifique primeiro.
  • Não há API em lote; cada idioma requer uma chamada de criação separada.
  • Use --paginate nos comandos de lista para garantir que todas as localizações existentes sejam retornadas.
  • Use a habilidade asc-id-resolver se você tiver apenas nomes de aplicativos em vez de IDs.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas