CodePush

  • Article

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

CodePush est un service cloud App Center qui permet aux développeurs React Native de déployer des mises à jour d’applications mobiles directement sur les appareils de leurs utilisateurs. Il agit en tant que référentiel central dans lequel les développeurs peuvent publier certaines mises à jour (par exemple, JS, HTML, CSS et modifications d’image), et les applications peuvent interroger les mises à jour à partir de (à l’aide des kits SDK clients fournis). Cela vous permet d’avoir un modèle d’engagement plus déterministe et direct avec vos utilisateurs finaux tout en corrigeant les bogues, en ajoutant de petites fonctionnalités qui ne vous obligent pas à reconstruire un fichier binaire ou à le redistribuer via les magasins d’applications publics. Toutes les applications React Native créées sur App Center sont activées par défaut . Pour commencer à utiliser CodePush, vous devez effectuer les étapes suivantes :

Notes

Pour les appareils Android, CodePush fonctionne uniquement sur les appareils compatibles TLS 1.2.

Notes

L’utilisation de l’API CodePush a une limitation de débit de 8 requêtes par 5 minutes appliquée. Ceux-ci sont comptés par combinaison des éléments suivants : Point de terminaison demandé, requête IP provenant de, clé de déploiement et ID unique du client. Si la limite est atteinte, la réponse avec un code status 429 est retournée :

{
   "statusCode": 429,
   "message": "Rate limit is exceeded. Try again in X seconds."
}

1. Installer l’interface CLI App Center

Vous gérez la plupart des fonctionnalités de CodePush à l’aide de l’interface CLI App Center. Pour installer l’interface CLI, ouvrez une fenêtre de terminal ou une invite de commandes et exécutez la commande suivante :

npm install -g appcenter-cli

Notes

Si vous rencontrez une EACCES erreur lors de l’exécution de cette commande, vous devrez peut-être corriger les autorisations npm sur votre système. De nombreux sites recommandent d’utiliser la sudo commande pour contourner cette erreur, mais vous ne devez jamais installer de modules npm à l’aide sudode .

Après avoir installé l’interface CLI App Center, exécutez la appcenter login commande pour configurer l’interface CLI pour les détails de votre compte App Center.

2. CodePush-ify votre application

Ajoutez le Kit de développement logiciel (SDK) client CodePush à votre application et configurez-le pour extraire les mises à jour d’application de l’un de vos déploiements dans App Center. Les sections suivantes fournissent des détails sur la procédure à suivre pour les plateformes d’applications prises en charge :

3. Publier une mise à jour d’application

Après avoir apporté des modifications au code ou aux ressources de votre application, publiez la mise à jour dans App Center à l’aide de l’interface CLI App Center, comme décrit dans les sections suivantes.

React Native

Exécutez la commande CLI release-react App Center pour regrouper les fichiers de code et de ressources de votre application, puis publiez-les sur le serveur App Center en tant que nouvelle version. Par exemple :

appcenter codepush release-react -a <ownerName>/MyApp

Cordova

Exécutez la commande CLI release-cordova App Center pour regrouper les fichiers de code et de ressources de votre application, puis publiez-les sur le serveur App Center en tant que nouvelle version. Par exemple :

appcenter codepush release-cordova -a <ownerName>/MyApp

Conseil

Une fonctionnalité importante de l’interface CLI App Center est la possibilité de définir une application en tant qu’application actuelle à l’aide de appcenter apps set-current <ownerName>/<appName>. En définissant une application comme application actuelle, vous n’avez pas besoin d’utiliser l’indicateur -a . Par exemple, la commande appcenter codepush deployment list -a <ownerName>/<appName> peut être tapée comme appcenter codepush deployment list si l’application actuelle était définie. Vous pouvez case activée quelle application est définie comme application actuelle de votre compte à l’aide appcenter apps get-currentde . L’utilisation de cette commande raccourcit la plupart des commandes CLI.

4. Exécuter votre application

Une fois ces étapes terminées, tous les utilisateurs exécutant votre application recevront la mise à jour à l’aide de l’expérience que vous avez configurée à l’étape 2. Pour plus d’informations, consultez la documentation sur l’interface CLI et le Kit de développement logiciel (SDK) client (Apache Cordova, React Native).