Guide de démarrage rapide pour le CLI développeur Adapty

L’Adapty CLI vous permet de configurer entièrement votre application depuis la ligne de commande. Utilisez-le comme alternative au démarrage rapide via le tableau de bord si vous préférez les outils en terminal ou les clients MCP.

À la fin, votre application, votre niveau d’accès, votre produit, votre paywall et votre placement sont tous visibles dans l’Adapty Dashboard.

Si vous exécutez le CLI dans Claude Cowork, autorisez les domaines Adapty avant de commencer — voir Exécuter le CLI dans Cowork.

1. Installer la CLI

Nécessite Node.js 18 ou version ultérieure.

Pour installer la CLI, exécutez la commande :

npm install -g adapty

Ou, directement :

npx adapty auth login

2. S’authentifier

Lancez la commande de connexion pour relier le CLI à votre compte Adapty.

adapty auth login

Le CLI ouvre un onglet dans le navigateur. Vérifiez que le code affiché dans le terminal correspond à celui affiché dans le navigateur, puis cliquez sur Authorize. Le terminal confirme lorsque l’authentification est terminée.

3. Créez votre application

Une application dans Adapty représente votre application mobile. Une seule application Adapty se connecte à la fois à l’App Store et au Google Play — vous n’avez besoin d’en créer qu’une seule, quel que soit le nombre de stores sur lesquels vous publiez.

adapty apps create --title "My App" --platform ios --platform android --apple-bundle-id com.example.app --google-bundle-id com.example.app

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

adapty apps create --title "My App" --platform android --google-bundle-id com.example.app

La commande retourne un <app-id>. Utilisez cet ID dans toutes les commandes suivantes.

4. Créer un niveau d’accès (facultatif)

Les niveaux d’accès contrôlent ce à quoi les utilisateurs peuvent accéder après un achat. Plutôt que de vérifier si un utilisateur a acheté un produit spécifique, votre application vérifie si l’utilisateur dispose d’un niveau d’accès donné. Cela découple la logique de votre application des identifiants de produits spécifiques.

Un niveau d’accès premium est automatiquement créé avec chaque nouvelle application. Pour la plupart des applications, vous pouvez passer cette étape. Utilisez premium comme identifiant de niveau d’accès à l’étape 5.

Only run this command if different products unlock different features for different user groups — for example, if a “Basic” subscriber and a “Pro” subscriber get access to different parts of the app.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

• --sdk-id est l’identifiant que vous utiliserez dans le code de votre app pour vérifier si une fonctionnalité doit être accessible à l’utilisateur (par exemple, if user.hasAccessLevel("pro")). Si vous ignorez cette étape et utilisez le niveau d’accès par défaut, son --sdk-id est premium.
• --title est un libellé d’affichage pour votre propre référence dans l’Adapty Dashboard.

La commande renvoie un <access-level-id>.

5. Créer un produit

Dans Adapty, un produit représente tout ce que votre application vend — un abonnement ou un achat unique. Les articles d’App Store Connect et de Google Play peuvent être regroupés en un seul produit Adapty et gérés depuis un seul endroit.

Vous aurez besoin des identifiants de produit de chaque store : l’identifiant Apple depuis App Store Connect, et l’identifiant de produit Android ainsi que l’identifiant de plan de base depuis Google Play Console. Consultez Produits pour savoir où les trouver.

Si vous avez sauté l’étape 4, utilisez le default_access_level.id retourné par la commande apps create à l’étape 3 comme <access-level-id>.

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id> --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --ios-product-id <your.apple.id>

adapty products create --app <app-id> --title "My Product" --access-level-id <access-level-id> --period monthly --android-product-id <your.google.id> --android-base-plan-id <your.base-plan.id>

La commande retourne un <product-id>.

Si vous vendez également ce produit sur le web via Stripe ou Paddle, ajoutez ces IDs à la même commande. Voir products create dans la référence des commandes.

6. Créer un paywall

Un paywall est le conteneur qui regroupe vos produits. Dans Adapty, les paywalls sont le seul moyen de proposer des produits aux utilisateurs. Chaque produit doit être dans un paywall avant de pouvoir apparaître dans votre application.

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id>

adapty paywalls create --app <app-id> --title "My Paywall" --product-id <product-id-1> --product-id <product-id-2>

La commande retourne un <paywall-id>.

7. Créer un placement

Un placement est l’endroit dans votre application où vous affichez un paywall. La seule chose que vous codez en dur dans votre code est l’identifiant du placement. Tout le reste — quel paywall afficher et à quels utilisateurs — est géré depuis le tableau de bord sans avoir à publier une nouvelle version de l’application.

--developer-id est la chaîne que vous référencerez plus tard dans votre code quand vous demanderez à Adapty quel paywall afficher à cet endroit. Choisissez quelque chose qui décrit l’emplacement, comme "main", "onboarding", ou "settings".

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

Le flag --audiences contrôle quel paywall est affiché à quels utilisateurs. L’exemple ci-dessus définit une audience par défaut unique — tous les utilisateurs à ce placement voient le même paywall.

Exécuter le CLI dans Cowork

Claude Cowork exécute les commandes dans un sandbox qui n’atteint que les domaines autorisés. Tant qu’Adapty n’est pas autorisé, le CLI ne peut pas se connecter ni lire votre compte. Ignorez cette section si vous exécutez le CLI depuis votre propre terminal.

Autorisez adapty.io et *.adapty.io. Un wildcard ne couvre pas le domaine apex dans la plupart des implémentations de liste d’autorisation. Le CLI lui-même atteint api.adapty.io, et un agent qui consulte la documentation Adapty pendant son travail atteint l’apex.

Cowork applique ces paramètres au démarrage d’une tâche. Si vous modifiez le mode d’accès ou ajoutez un domaine en cours de conversation, la conversation conserve les paramètres avec lesquels elle a démarré — commencez une nouvelle tâche.

Comptes personnels

Vous configurez vous-même la liste d’autorisation :

1. Dans Claude, ouvrez Settings → Capabilities.
2. Activez Code execution and file creation. Le bloc Allow network egress reste masqué jusqu’à cette étape.
3. Activez Allow network egress.
4. Dans Domain allowlist, sélectionnez Package managers only.
5. Sous Additional allowed domains, ajoutez adapty.io, puis ajoutez *.adapty.io.

L’autre mode d’accès, All domains, permet au sandbox d’accéder à n’importe quel site. Avec cette option, vous n’avez pas besoin d’ajouter les domaines Adapty.

Espaces de travail d’entreprise

Un administrateur contrôle la liste d’autorisation. Demandez-lui d’ajouter les deux domaines pour l’espace de travail.

Et maintenant ?

Toutes les entités sont désormais visibles dans l’Adapty Dashboard. Prochaines étapes :

• Concevoir votre paywall — utilisez le Paywall Builder sans code pour ajouter des visuels, une mise en page et du contenu au paywall que vous venez de créer.
• Intégrer le SDK Adapty — ajoutez le SDK à votre application pour récupérer et afficher le placement.
• Diriger différents segments d’utilisateurs vers différents paywalls — consultez placements update et segments list dans la référence des commandes.