Communitygithub.com

exiao/skills

Localiser en masse les noms d'affichage des abonnements et des achats intégrés dans toutes les locales de l'App Store avec `asc`. Utilisez-le pour remplir les noms d'abonnement et d'achat intégré pour chaque langue sans cliquer manuellement dans App Store Connect.

Qu'est-ce que skills ?

Cette compétence permet de créer ou de mettre à jour en masse les noms d'affichage (et descriptions) des abonnements, groupes d'abonnements et achats intégrés dans toutes les locales prises en charge par App Store Connect, via l'outil en ligne de commande `asc`. Elle élimine la tâche fastidieuse de cliquer sur chaque langue dans l'interface web d'App Store Connect pour définir le même nom d'affichage partout. Elle est utile pour les développeurs iOS qui gèrent des applications avec de nombreux abonnements ou IAP et qui doivent localiser rapidement leurs produits sans passer par l'UI. La compétence prend en charge les workflows de localisation pour les abonnements, les groupes d'abonnements et les achats intégrés, avec des commandes dédiées pour créer, lister et mettre à jour les localisations. Elle fonctionne avec l'outil `asc` d'App Store Connect, dont l'authentification est préalablement configurée, et elle guide l'utilisateur à travers les étapes de résolution des IDs, vérification des localisations existantes, création pour les locales manquantes, et vérification finale. Elle inclut des comportements d'agent pour éviter les erreurs de doublons et traiter les échecs par locale.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Localisation des abonnements avec asc

Utilisez cette compétence pour créer ou mettre à jour en masse les noms d'affichage (et descriptions) des abonnements, groupes d'abonnements et achats intégrés dans toutes les locales d'App Store Connect. Cela élimine le processus manuel fastidieux qui consiste à cliquer sur chaque langue dans App Store Connect pour définir le même nom d'affichage.

Prérequis

  • Authentification configurée (asc auth login ou variables d'environnement ASC_*).
  • Connaître votre ID d'application (ASC_APP_ID ou --app).
  • Les groupes d'abonnements et les abonnements doivent déjà exister.

Locales prises en charge par l'App Store

Voici les locales prises en charge par App Store Connect pour la localisation des abonnements et des achats intégrés :

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

Workflow : Localisation en masse d'un abonnement

1. Résoudre les IDs

# Trouver les groupes d'abonnements
asc subscriptions groups list --app "APP_ID" --output table

# Trouver les abonnements dans un groupe
asc subscriptions list --group "GROUP_ID" --output table

2. Vérifier les localisations existantes

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

Cela montre quelles locales ont déjà un nom défini. Créez uniquement des localisations pour les locales manquantes.

3. Créer des localisations pour toutes les locales manquantes

Pour chaque locale qui n'a pas encore de localisation, exécutez :

asc subscriptions localizations create \
  --subscription-id "SUB_ID" \
  --locale "LOCALE" \
  --name "Nom d'affichage"

Par exemple, pour définir « Monthly Pro » dans toutes les locales :

# Une commande par locale (ignorez celles qui existent déjà)
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. Vérifier

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

Workflow : Localisation en masse d'un groupe d'abonnements

Les groupes d'abonnements ont aussi leur propre nom d'affichage par locale (c'est le « nom du groupe » affiché aux utilisateurs dans la feuille de gestion des abonnements).

1. Vérifier les localisations existantes du groupe

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

2. Créer pour les locales manquantes

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Nom d'affichage du groupe"

Optionnel : définir un nom d'application personnalisé pour le groupe :

asc subscriptions groups localizations create \
  --group-id "GROUP_ID" \
  --locale "LOCALE" \
  --name "Nom d'affichage du groupe" \
  --custom-app-name "Mon App"

3. Vérifier

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

Workflow : Localisation en masse d'un achat intégré

Les achats intégrés (IAP) ont leurs propres commandes de localisation avec le même modèle.

1. Résoudre l'ID de l'IAP

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

2. Vérifier les localisations existantes

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

3. Créer pour les locales manquantes

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Nom d'affichage"

Description optionnelle :

asc iap localizations create \
  --iap-id "IAP_ID" \
  --locale "LOCALE" \
  --name "Débloquer toutes les fonctionnalités" \
  --description "Achat unique pour débloquer toutes les fonctionnalités premium"

4. Vérifier

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

Mise à jour des localisations existantes

Pour modifier le nom d'affichage de localisations existantes :

Abonnements

asc subscriptions localizations update --id "LOC_ID" --name "Nouveau nom"

Groupes d'abonnements

asc subscriptions groups localizations update --id "LOC_ID" --name "Nouveau nom du groupe"

Achats intégrés

asc iap localizations update --id "LOC_ID" --name "Nouveau nom"

Pour une mise à jour en masse, listez d'abord les localisations existantes, extrayez les IDs, puis mettez à jour chacun.

Localiser en masse tous les abonnements d'une application

Pour une application complète avec plusieurs groupes d'abonnements et abonnements :

# 1. Lister tous les groupes
asc subscriptions groups list --app "APP_ID" --paginate

# 2. Pour chaque groupe, localiser le groupe lui-même
#    (répéter le workflow de localisation du groupe ci-dessus)

# 3. Pour chaque groupe, lister les abonnements
asc subscriptions list --group "GROUP_ID" --paginate

# 4. Pour chaque abonnement, le localiser
#    (répéter le workflow de localisation de l'abonnement ci-dessus)

Comportement de l'agent

  • Listez toujours les localisations existantes en premier pour éviter les erreurs de création en double.
  • Ignorez les locales qui ont déjà une localisation ; créez uniquement celles qui manquent.
  • Lorsque l'utilisateur fournit un seul nom d'affichage, utilisez-le pour toutes les locales (même nom partout).
  • Lorsque l'utilisateur fournit des noms traduits par locale, utilisez le nom spécifique à chaque locale.
  • Si une description est fournie, transmettez --description lors de la création. Sinon, omettez-la.
  • Utilisez --output table pour les étapes de vérification afin que l'utilisateur puisse confirmer visuellement.
  • Utilisez la sortie JSON par défaut pour les étapes d'automatisation intermédiaires.
  • Après une création en masse, exécutez toujours la commande list pour vérifier l'intégralité.
  • Pour les applications avec de nombreux abonnements, traitez-les séquentiellement par groupe pour garder la sortie lisible.
  • Si un appel de création échoue pour une locale, enregistrez la locale et l'erreur, puis continuez avec les locales restantes. Une fois le lot terminé, signalez tous les échecs ensemble afin que l'utilisateur puisse les traiter.

Remarques

  • Les noms d'affichage des abonnements sont ceux que les utilisateurs voient dans la feuille de gestion des abonnements et dans les boîtes de dialogue d'achat.
  • Créer une localisation pour une locale qui existe déjà échouera ; vérifiez toujours d'abord.
  • Il n'existe pas d'API de traitement par lots ; chaque locale nécessite un appel de création séparé.
  • Utilisez --paginate avec les commandes list pour garantir que toutes les localisations existantes sont renvoyées.
  • Utilisez la compétence asc-id-resolver si vous n'avez que des noms d'applications au lieu d'IDs.

Individual skills in this repo

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

Skills associés