Diese Seite wurde von der Cloud Translation API übersetzt.

APKs und Tracks

Mit der Google Play Developer API kannst du neue APKs für deine Apps hochladen. und sie in anderen Release-Tracks veröffentlichen. So können Sie Alpha- und Betaversionen Ihrer App bereitstellen, die dann zur Verfügung gestellt werden an genehmigte Nutzer gesendet. So können Sie auch einen gestaffelten Roll-out vornehmen. die einer kleinen Anzahl von Nutzern automatisch zur Verfügung gestellt wird, die Nutzenden der App. Nach der Veröffentlichung der gestaffelten Einführung können Sie die Anzahl der Nutzer, die diese Version der Anwendung, bis Sie diese Version schließlich als Produktionsversion bereitstellen, Version.

APKs hinzufügen und ändern

Laden Sie ein oder mehrere APKs hoch, indem Sie die Methode Edits.apks: upload.

Bei dieser Methode wird das APK in einen Storage-Bucket hochgeladen, wo es einem Titel zugewiesen werden, um sie für Nutzer bereitzustellen. Wenn die Änderung gelöscht oder verworfen wurden, werden alle APKs, die in diese Änderung hochgeladen wurden, ebenfalls lost.)
APKs für „Tracks“ veröffentlichen durch einen Anruf Edits.tracks: update Du kannst die APKs in den folgenden Tracks:
- Test-Tracks wie "alpha" und "beta"
  
  Die Alpha- und Betaversionen der App werden für die Nutzer bereitgestellt. die Sie den Alpha- und Betatestgruppen zuweisen. Sie weisen über die Google Play Console zu diesen Gruppen hinzufügen.
- Der interne Test-Track: "qa"
  
  Interne Versionen Ihrer App werden für Ihren internen Test bereitgestellt wie in der Google Play Console konfiguriert.
- Der Produktions-Track: "production"
  
  Veröffentlichungen für „production“ für alle Nutzer bereitgestellt werden. Ich können gestaffelte Releases für „Produktion“ sicher verfolgen, Stellen Sie Ihren Release zuerst für einen kleinen Prozentsatz der Produktionsnutzer bereit und erhöhen Sie diesen Prozentsatz dann allmählich, wächst die Veröffentlichung.
Nutzer im einfachen Modus sollten in keinem der Dateien mehr als ein APK hochladen. Titel. Nutzer im erweiterten Modus, die das mehrere APK verwenden Support können null, ein oder mehrere APKs in jeden Track hochladen.

Trackname für Formfaktor-Tracks

Dem Titelnamen für einen Track mit Formfaktor ist ein bestimmtes Präfix vorangestellt. Kennung.

Formfaktor	Präfix
Android Automotive OS	Automobil
Wear OS	Wear
Android TV	TV

Wie wird der Trackname für einen Track mit Formfaktor berechnet?

Gängige Track-Typen wie Produktion, offene Tests und interne Tests Test-Tracks einen bekannten Tracknamen haben.

Tracking-Typ	Standard-Track-Name
Produktion	Produktion
Offene Tests	Beta
Interne Tests	qa

Der Trackname für einen Track mit Formfaktor kann wie folgt berechnet werden: "[prefix]:defaultTrackName" Der Wear OS-Formfaktor hat beispielsweise Tracks mit folgendem Namen: "wear:production", "wear:beta" und "wear:qa".

Geschlossene Test-Tracks werden manuell erstellt und haben benutzerdefinierte Namen. Ein geschlossener Test-Track für einen Formfaktor mit dem Namen „$name“ erhält den Tracknamen "[prefix]:$name".

Beispiel für den APK-Workflow

In diesem Abschnitt wird eine typische Verwendungsweise der Tracks API beschrieben. In diesem Fall nehmen wir an, dass Sie für jeden Titel neue Versionen des APK hochladen möchten, und weisen dem Nutzer für eine gestaffelte Einführung. (In der Praxis muss ein Entwickler Es ist unwahrscheinlich, dass alle diese Aktionen im selben Vorgang ausgeführt werden. verwenden Sie stattdessen die Betaversion eines Tages aktualisieren, einen gestaffelten Release "Produktion" und so weiter.

Öffnen Sie eine neue Änderung wie unter Bearbeitungsworkflow
Rufen Sie die Methode Edits.apks: upload für jedes APK, das Sie hochladen möchten. Übergeben Sie das APK in der Anfrage der Methode. Textkörper. Dadurch wird das APK in einem Speicherbereich abgelegt, in einem Track nutzen oder bereitstellen) Die Methode gibt einen Versionscode für für jedes hochgeladene APK verwenden Sie diesen Versionscode, an das APK senden, wenn Sie es in einem Track veröffentlichen.
Rufen Sie die Methode Edits.tracks: update auf. für jeden Track, in dem Sie APKs veröffentlichen möchten. Im Anfragetext Sie übergeben eine Edits.tracks-Ressource. mit der Version, die Sie einführen möchten. Um beispielsweise einen APK mit Versionscode 88:
```
{
"releases": [{
  "versionCodes": ["88"],
  "status": "completed"
}]
}
```
Zu diesem Zeitpunkt stehen die APKs den Nutzern noch nicht zur Verfügung. Wie bei anderen Änderungen werden sie erst wirksam, wenn Sie sie übernehmen.
Rufen Sie die Methode Edits: commit auf, übernehmen Sie für die Änderungen einen Commit. Danach sind die Nutzer der einzelnen Tracks der aktualisierten Version der APK-Datei. Wie bei allen Änderungen kann auch kann es mehrere Stunden dauern, bis die Änderungen wirksam werden.)

Gestaffelte Einführungen

Wenn Sie eine neue Version Ihres APK haben und schrittweise bereitstellen möchten, können Sie es als „gestaffelte Einführung“ veröffentlichen, Version. In diesem Fall Google Play stellt die App automatisch für den gewünschten Anteil der verfügbaren Nutzer, die Sie angeben. Wenn die Einführung Das APK weist keine Probleme auf (z. B. Abstürzen, können Sie den Anteil der Nutzer erhöhen, denen diese Version; Wenn Sie bereit sind, können Sie dieses APK als neue Produktionsversion bereitstellen. Version.

In diesem Abschnitt werden die Schritte beschrieben, mit denen Sie eine gestaffelte Einführung eines APK und stufen Sie es dann zur Produktion hoch:

Erstellen Sie eine Änderung wie unter Workflow für Bearbeitungen beschrieben.
Laden Sie mithilfe der Methode Edits.apks: upload.
Starte einen "inProgress" gestaffelten Release im Produktions-Track mithilfe der Methode Edits.tracks: update. Wählen Sie die Anteil der Nutzer, die das neue APK erhalten sollen Zu diesem Zeitpunkt ist das APK immer noch für keinen Endnutzer zur Verfügung.
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.05,
  "status": "inProgress"
}]
}
```
Übernehmen Sie die Änderungen in der aktiven Änderung, indem Sie folgenden Befehl aufrufen: Bearbeitungen: Commit In den nächsten Stunden abgeschlossen ist, wird das neue APK für Nutzer eingeführt. Der Bruch der ausgewählten Nutzer erhalten das neue APK.

Je nach Erfolg der gestaffelten Einführung können Sie den Prozentsatz der Nutzer, die für diesen Release berechtigt sind, oder den Release anhalten.

Erhöhen des Nutzeranteils für eine gestaffelte Einführung

Angenommen, Sie haben eine laufende gestaffelte Einführung mit 5%, wie oben beschrieben. Abschnitt beschrieben, wie der Prozentsatz im Fall erhöht werden kann. in denen die Veröffentlichung gut läuft:

Erstellen Sie eine Änderung wie unter Workflow für Bearbeitungen beschrieben.
Ändere den bereitgestellten Release "inProgress" im Produktions-Track mithilfe des Methode Edits.tracks: update. Erhöhung Anteil der Nutzer, die das neue APK erhalten sollten:
```
{
"releases": [{
  "versionCodes": ["99"],
  "userFraction": 0.1,
  "status": "inProgress"
}]
}
```
Übernehmen Sie die Änderungen in der aktiven Änderung, indem Sie folgenden Befehl aufrufen: Bearbeitungen: Commit In den nächsten Stunden abgeschlossen ist, wird das neue APK für Nutzer eingeführt. Der Bruch der ausgewählten Nutzer erhalten das neue APK.

Eine gestaffelte Einführung anhalten

Angenommen, Sie haben eine laufende gestaffelte Einführung mit 5%, wie oben beschrieben. Abschnitt beschrieben, wie die gestaffelte Einführung angehalten werden kann, wenn Sie ein Problem entdecken:

Erstellen Sie eine Änderung wie unter Workflow für Bearbeitungen beschrieben.
Ändere den bereitgestellten Release "inProgress" im Produktions-Track mithilfe des Methode Edits.tracks: update. Legen Sie die Status in "halted" ändern.
```
{
"releases": [{
  "versionCodes": ["99"],
  "status": "halted"
}]
}
```
Übernehmen Sie die Änderungen in der aktiven Änderung, indem Sie folgenden Befehl aufrufen: Bearbeitungen: Commit Dein Release wird nicht mehr neuen Nutzenden zur Verfügung stehen.

Wenn Sie einen angehaltenen Release später fortsetzen möchten, können Sie dies tun, indem Sie Status wieder auf "inProgress" zurücksetzen.

Gestaffelten Roll-out durchführen

Wenn Sie mit der gestaffelten Einführung zufrieden sind und die Version 100% der Nutzer können den Release-Status auf "completed" setzen:

Erstellen Sie eine Änderung wie unter Workflow für Bearbeitungen beschrieben.
Ändere den bereitgestellten Release "inProgress" im Produktions-Track mithilfe des Methode Edits.tracks: update. Legen Sie die Status in "completed" ändern.
```
{
"releases": [{
  "versionCodes": ["99"],
  "status": "completed"
}]
}
```
Übernehmen Sie die Änderungen in der aktiven Änderung, indem Sie folgenden Befehl aufrufen: Bearbeitungen: Commit In den nächsten Stunden abgeschlossen ist, wird das neue APK für Nutzer eingeführt. Der Bruch der ausgewählten Nutzer erhalten das neue APK.

Versionsentwürfe

Mit Versionsentwürfen kannst du APKs automatisch hochladen und einen Release über die später über die Google Play Console bereitgestellt werden kann. Bis So erstellen Sie einen Versionsentwurf in einem Track:

Öffnen Sie eine neue Änderung wie unter Bearbeitungsworkflow
Rufen Sie die Methode Edits.apks: upload für jedes APK, das Sie hochladen möchten. Übergib das APK im Anfragetext der Methode. Die -Methode einen Versionscode für jedes hochgeladene APK zurück. werden Sie diese Versionscode, der auf das APK verweist, wenn Sie es einem Release zuweisen.
Rufen Sie die Methode Edits.tracks: update auf. für jeden Titel, den Sie veröffentlichen möchten. Im Anfragetext Sie übergeben eine Edits.tracks-Ressource. mit dem Versionsentwurf, den Sie erstellen möchten. Beispiel:
```
{
"releases": [{
  "name": "My draft release",
  "versionCodes": ["88"],
  "status": "draft"
}]
}
```
.
Rufen Sie die Methode Edits: commit auf, übernehmen Sie für die Änderungen einen Commit. Ihr Versionsentwurf kann jetzt geprüft und eingeführt werden über die Google Play Console oder die API.

Versionshinweise angeben

Wenn Sie eine neue Version Ihrer Anwendung veröffentlichen, können Sie hervorheben, durch Angeben von Versionshinweisen für Ihre Version neu für Nutzer.

Verwenden Sie dazu das Feld "releaseNotes" bei der Angabe eines Edits.tracks-Ressource in den Edits.tracks: update.

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