Cette page a été traduite par l'API Cloud Translation.

APK et suivi

L'API Google Play Developer vous permet d'importer de nouveaux APK pour vos applications puis les publier sur différents canaux de sortie. Cela vous permet déployer des versions alpha et bêta de votre application, aux utilisateurs approuvés. Cela vous permet également de déployer un déploiement par étapes qui est automatiquement mise à la disposition d'un petit nombre les utilisateurs de l'application. Une fois que vous avez publié la version déployée par étapes, vous pouvez augmenter progressivement le nombre d'utilisateurs ayant accès à cette version l'application, jusqu'à ce que vous la déployiez enfin en tant que version de "production" version.

Ajouter et modifier des APK

Importez un ou plusieurs APK en appelant la méthode Edits.apks: import.

Cette méthode importe l'APK dans un "bucket" de stockage, où il peut être affectés à un "voie" pour le déployer auprès des utilisateurs. (Si la modification est supprimés ou supprimés, les APK importés pour cette modification le sont aussi lost.)
Publier des APK sur des "voies" en appelant Edits.tracks: mise à jour Vous pouvez libérer APK sur les canaux suivants:
- Canaux de test tels que "alpha" et "beta"
  
  Les versions alpha et bêta de l'application sont déployées auprès des utilisateurs. que vous attribuez aux groupes de test alpha et bêta. Vous attribuez utilisateurs à ces groupes via la Google Play Console.
- Canal de test interne: "qa"
  
  Les versions internes de votre application sont déployées dans votre test interne tel qu'il est configuré dans la Google Play Console.
- Canal de production: "production"
  
  Sorties dans la version de production sont déployées pour tous les utilisateurs. Toi vous pouvez utiliser les versions en préproduction sur "production" suivre en toute sécurité déployer votre version auprès d'un petit pourcentage d'utilisateurs en production puis augmentez progressivement ce pourcentage au fur et à mesure que votre confiance la sortie s'enrichit.
Les utilisateurs en mode simple ne doivent pas utiliser plus d'un fichier APK le titre en question. Utilisateurs en mode avancé utilisant plusieurs APK assistance peuvent importer zéro, un ou plusieurs APK dans chaque canal.

Nom du suivi pour les canaux de facteurs de forme

Le nom d'une piste de facteur de forme est précédé d'un préfixe identifiant.

Facteur de forme	Préfixe
Android Automotive OS	automobile
Wear OS	wear
Android TV	tv

Comment calculer le nom d'une piste pour un facteur de forme donné ?

Types de canaux courants (production, test ouvert et test interne, par exemple) ont un nom de canal bien connu.

Type de suivi	Nom de la piste par défaut
Production	production
Tests ouverts	bêta
Tests internes	qa

Le nom de la piste pour un facteur de forme donné peut être calculé comme suit: "[prefix]:defaultTrackName" Par exemple, le facteur de forme Wear OS aura des pistes portant le nom: "wear:production", "wear:beta" et "wear:qa".

Les canaux de tests fermés sont créés manuellement et disposent noms. Il s'agit d'un canal de test fermé pour un facteur de forme nommé $name. aura pour nom de piste "[prefix]:$name".

Exemple de workflow APK

Cette section décrit une manière typique d'utiliser l'API Tracks. Dans ce cas, nous supposons que vous souhaitez importer de nouvelles versions de l'APK pour chaque canal, et attribuer un certain nombre d'utilisateurs reçoit une version de déploiement par étapes. (En pratique, un développeur il est peu probable que toutes ces actions soient effectuées au cours de la même opération ; à la place, vous pouvez mettre à jour la version bêta un jour, créer une version par étapes "production" un autre jour, etc.)

Ouvrez une nouvelle modification, comme décrit dans la section Modifier le workflow
Appelez la méthode Edits.apks: upload pour chaque APK à importer. Transmettre l'APK dans la requête de la méthode . (L'APK est placé dans une zone de stockage, mais il ne libère pas sur un canal ou le déployer.) La méthode renvoie un code de version pour chaque APK importé ; vous utiliserez ce code de version pour vous référer à l'APK lorsque vous le publiez sur un canal.
Appeler la méthode Edits.tracks: update pour chaque canal pour lequel vous voulez publier des APK. Dans le corps de la requête, transmettez une ressource Edits.tracks. contenant la version que vous souhaitez déployer. Par exemple, pour libérer APK avec le code de version 88:
```
{
"releases": [{
  "versionCodes": ["88"],
  "status": "completed"
}]
}
```
À ce stade, les utilisateurs n'ont toujours pas accès aux fichiers APK. Comme pour d'autres modifications, elles ne sont pas publiées tant que vous ne les avez pas validées.
Appelez la méthode Edits: commit. valider les modifications. Ensuite, les utilisateurs de chaque canal seront en fonction de la version mise à jour de l'APK. (Comme pour toutes les modifications, l'application des modifications peut prendre plusieurs heures.)

Déploiements par étapes

Lorsque vous disposez d'une nouvelle version de votre APK que vous souhaitez déployer progressivement, vous pouvez choisissez de le publier en tant que "déploiement par étapes" version. Dans ce cas, Google Play la déploie automatiquement dans la fraction souhaitée de l'espace de stockage que vous spécifiez. Si le "déploiement" L'APK ne présente aucun problème des plantages, etc.), vous pourriez augmenter la proportion d'utilisateurs qui reçoivent version; Lorsque vous êtes prêt, vous pouvez déployer cet APK en tant que nouvelle application version.

Cette section décrit les étapes à suivre pour effectuer une un fichier APK par étapes, puis de le faire passer en production:

Créez une modification, comme décrit dans la section Workflow de modifications.
Importez un nouveau fichier APK pour effectuer la modification à l'aide de la méthode Edits.apks: import.
Lancez une version en préproduction "inProgress" sur le canal de production à l'aide du Edits.tracks: update. Sélectionnez l'icône nombre d'utilisateurs devant recevoir le nouvel APK. À ce stade, le fichier APK est toujours pas disponibles pour les utilisateurs finaux.
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.05,
  "status": "inProgress"
}]
}
```
Validez les modifications apportées à la modification active en appelant Modifications: commit. Au cours des prochains heures, le nouvel APK sera déployé auprès des utilisateurs. La fraction des utilisateurs sélectionnés recevront le nouveau fichier APK.

En fonction du succès du déploiement par étapes, il peut être judicieux le pourcentage d'utilisateurs éligibles à cette version ou qui interrompent la version.

Augmenter la part d'utilisateurs pour un déploiement par étapes

Supposons que vous effectuiez un déploiement par étapes de 5%, comme décrit , cette section explique comment augmenter le pourcentage dans le cas où la publication se déroule bien:

Créez une modification, comme décrit dans la section Workflow de modifications.
Modifiez la version en préproduction "inProgress" sur le canal de production à l'aide du Edits.tracks: update. Augmenter Nombre d'utilisateurs devant recevoir le nouveau fichier APK:
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.1,
  "status": "inProgress"
}]
}
```
Validez les modifications apportées à la modification active en appelant Modifications: commit. Au cours des prochains heures, le nouvel APK sera déployé auprès des utilisateurs. La fraction des utilisateurs sélectionnés recevront le nouveau fichier APK.

Interrompre un déploiement par étapes

Supposons que vous effectuiez un déploiement par étapes de 5%, comme décrit , cette section explique comment interrompre le déploiement par étapes dans le cas où lorsque vous découvrez un problème:

Créez une modification, comme décrit dans la section Workflow de modifications.
Modifiez la version en préproduction "inProgress" sur le canal de production à l'aide du Edits.tracks: update. Définissez le paramètre l'état sur "halted".
```
{
"releases": [{
  "versionCodes": ["99"],
  "status": "halted"
}]
}
```
Validez les modifications apportées à la modification active en appelant Modifications: commit. Votre version ne sera plus pour les nouveaux utilisateurs.

Si vous décidez ultérieurement de reprendre une version interrompue, vous pouvez le faire en paramétrant son état à "inProgress".

Effectuer un déploiement par étapes

Lorsque vous êtes satisfait de votre déploiement par étapes et que vous souhaitez déployer la version sur 100% des utilisateurs peuvent définir l'état de la version sur "completed":

Créez une modification, comme décrit dans la section Workflow de modifications.
Modifiez la version en préproduction "inProgress" sur le canal de production à l'aide du Edits.tracks: update. Définissez le paramètre l'état sur "completed".
```
{
"releases": [{
  "versionCodes": ["99"],
  "status": "completed"
}]
}
```
Validez les modifications apportées à la modification active en appelant Modifications: commit. Au cours des prochains heures, le nouvel APK sera déployé auprès des utilisateurs. La fraction des utilisateurs sélectionnés recevront le nouveau fichier APK.

Versions brouillons

Les versions brouillon vous permettent d'importer automatiquement des APK et de créer une version via L'API, qui peut être déployée ultérieurement via la Google Play Console. À créer une version brouillon sur un canal:

Ouvrez une nouvelle modification, comme décrit dans la section Modifier le workflow
Appelez la méthode Edits.apks: upload pour chaque APK à importer. Transmettez l'APK dans le corps de la requête de la méthode. La renvoie un code de version pour chaque APK importé. vous utiliserez code de version pour faire référence à l'APK lorsque vous l'attribuez à une version.
Appeler la méthode Edits.tracks: update pour chaque piste que vous voulez publier. Dans le corps de la requête, transmettez une ressource Edits.tracks. contenant la version brouillon que vous souhaitez créer. Exemple :
```
{
"releases": [{
  "name": "My draft release",
  "versionCodes": ["88"],
  "status": "draft"
}]
}
```
Appelez la méthode Edits: commit. valider les modifications. Votre version brouillon peut désormais être inspectée et déployée via la Google Play Console ou l'API.

Spécifier les notes de version

Lorsque vous publiez une nouvelle version de votre application, vous pouvez mettre en avant pour les nouveaux utilisateurs en spécifiant des notes de version sur votre version.

Pour ce faire, utilisez le champ "releaseNotes" lorsque vous indiquez une la ressource Edits.tracks Edits.tracks: update.

{
  "releases": [{
      "name": "Release with notes",
      "versionCodes": ["88"],
      "status": "completed",
      "releaseNotes": [
        {"language": "en-US", "text": "Describe what's new in this release."}
      ]
  }]
}