Commandes de migration

Migrez un projet RevenueCat vers Adapty : son catalogue, puis optionnellement ses événements store et son historique de transactions. Adapty exécute chaque migration sous forme d’une séquence d’étapes et vous indique quelles actions vous pouvez effectuer ensuite — lisez status avant chaque action. Pour la procédure complète, consultez Migration depuis RevenueCat.

Toutes les commandes sauf list, create, use, current et unuse acceptent le flag de migration :

FlagRequisDescription
-m, --migrationNonID de migration. Sans ce flag, la CLI utilise la variable d’environnement ADAPTY_MIGRATION, puis la migration enregistrée par create ou use.

adapty migrations list

Listez vos migrations et les flows de migration que vous pouvez démarrer, regroupés par application.

adapty migrations list

adapty migrations create

Démarrer une migration et l’enregistrer comme migration en cours.

adapty migrations create --name <app-name>
adapty migrations create --flow <flow> --app <app-id>
FlagRequisDescription
--nameL’un de --name ou --flowNom de la nouvelle application Adapty. Lance la migration du catalogue. Incompatible avec --flow ou --app.
--flowL’un de --name ou --flowFlow à démarrer dans une application existante, tel qu’affiché par adapty migrations list. Nécessite --app.
--appAvec --flowID de l’application (UUID)
--no-selectNonCrée la migration sans l’enregistrer comme migration courante

Les flows disponibles pour une application existante après la migration de son catalogue :

FlowDescription
transactionsImporter l’historique des transactions depuis un export cloud quotidien RevenueCat
transactions_supportImporter l’historique des transactions via le support RevenueCat et le support Adapty, pour les plans RevenueCat sans export cloud
apple_eventsTransférer les notifications App Store à Adapty pendant que RevenueCat continue de les recevoir
google_eventsAbonner Adapty au sujet Pub/Sub utilisé par RevenueCat pour les notifications Google Play
codeDemander à votre agent de code de remplacer le SDK RevenueCat dans une base de code de l’application
integrationsDemander à votre agent de code de trouver les outils d’analytics, d’attribution et de messagerie dans le code de l’application afin de les configurer dans Adapty
paywall_designDemander à votre agent de code de reconstruire les designs de paywall RevenueCat dans les flows créés par la migration du catalogue

adapty migrations use

Enregistre une migration comme migration courante, pour éviter de passer -m aux autres commandes.

adapty migrations use <migration-id>
ArgumentDescription
migration-idID de migration issu de adapty migrations list

Le CLI vérifie que vous avez accès à la migration avant d’en sauvegarder l’ID. La migration enregistrée est liée au token actuel et s’applique dans tous les terminaux.

adapty migrations current

Affiche la migration en cours et son origine : la variable d’environnement ADAPTY_MIGRATION ou la sélection sauvegardée.

adapty migrations current

adapty migrations unuse

Supprime la migration sauvegardée. Une valeur ADAPTY_MIGRATION définie dans votre shell reste active jusqu’à ce que vous la désactiviez.

adapty migrations unuse

adapty migrations status

Affiche l’état d’une migration, ses problèmes et les actions disponibles.

adapty migrations status
OptionObligatoireDescription
--waitNonInterroge jusqu’à ce que la migration change, puis retourne le dernier état
--timeoutNonDurée d’interrogation pour --wait : 1–600 secondes, 120 par défaut. Accepte 300, 300s ou 5m. Nécessite --wait.

Avec --json, next_actions et available_actions listent pour chaque action son ID, les ressources qu’elle lit, son input_schema et son texte confirm.

Le code de sortie 0 signifie que la requête a réussi, pas que la migration a abouti. Vérifiez migration.state dans la réponse.

Étapes des migrations Adapty

Affiche la liste de contrôle de migration et le statut de chaque étape.

adapty migrations steps

adapty migrations show

Listez les ressources que vous pouvez lire maintenant, ou lisez-en une.

adapty migrations show [resource]
ArgumentDescription
resourceNom de la ressource, par exemple apps, mapping, report ou export-config. Omettez-le pour lister les ressources disponibles à l’étape actuelle.

adapty migrations run

Exécute une action depuis adapty migrations status.

adapty migrations run <action-id>
ArgumentDescription
action-idID de l’action issu de next_actions ou available_actions dans adapty migrations status
OptionObligatoireDescription
--inputNonEntrée de l’action sous forme d’objet JSON correspondant au input_schema de l’action. Sans entrée, le CLI envoie {}.
--input-fileNonChemin vers un fichier contenant l’entrée de l’action, ou - pour la lire depuis stdin. Incompatible avec --input.
-y, --yesPour les actions avec un texte confirmConfirme l’action après lecture de son texte confirm. Aucune invite interactive.
--openNonOuvre le lien de l’action même avec un pipe ou --json
--no-browserNonAffiche le lien de l’action sans ouvrir de navigateur

Les actions se déclinent en trois types :

  • Les actions d’entrée envoient vos données à Adapty, par exemple les applications RevenueCat à migrer ou vos décisions de correspondance.
  • Les actions externes ouvrent une page dans l’Adapty Dashboard, par exemple pour coller la clé API secrète RevenueCat. Complétez la page, puis vérifiez status.
  • Les actions agent, par exemple migrate_code, sont des tâches pour votre agent de code. Exécutez-les depuis le dépôt git de l’application : la CLI enregistre les données de migration sous .git/adapty/<migration-id>/ et affiche les instructions pour l’agent. L’agent signale le résultat en exécutant à nouveau l’action avec --input.

adapty migrations close

Terminer ou annuler une migration. Vous ne pouvez pas la rouvrir ensuite.

adapty migrations close --outcome finish --yes
FlagRequiredDescription
--outcomeYesfinish marque la migration comme terminée ; cancel l’abandonne
-y, --yesYesConfirmer la clôture

Et ensuite