L'API Google Play Developer ti consente di caricare nuovi APK per le tue app e pubblicali in diversi canali di lancio. Questo consente di il deployment delle versioni alpha e beta dell'app, che vengono rese disponibili per gli utenti approvati. In questo modo puoi anche eseguire il deployment di un'implementazione graduale che viene resa automaticamente disponibile a un numero ridotto di agli utenti dell'app. Una volta rilasciata la versione dell'implementazione graduale, puoi aumentare gradualmente il numero di utenti che ricevono quella versione l'app, finché non esegui il deployment di quella versione come "produzione" completamente gestita.
Aggiunta e modifica di APK
Carica uno o più APK richiamando il metodo Edits.apks: caricamento.
Questo metodo carica l'APK in un "bucket" di archiviazione, dove può essere assegnato a una "traccia" per eseguirne il deployment agli utenti. (Se la modifica è eliminati o eliminati, vengono inclusi anche gli eventuali APK caricati nella modifica lost.)
Pubblicare APK per "tracks" chiamando Edits.tracks: aggiornamento. Puoi rilasciare APK nei seguenti canali:
canali di test come
"alpha"e"beta"Viene eseguito il deployment delle versioni alpha e beta dell'app per gli utenti che assegni ai gruppi di alpha e beta test. Tu assegni a questi gruppi utilizzando Google Play Console.
Il canale di test interno:
"qa"Per il test interno viene eseguito il deployment delle versioni interne dell'app canale come configurato in Google Play Console.
Canale di produzione:
"production"Pubblicazioni nella sezione "produzione" viene eseguito il deployment per tutti gli utenti. Tu possono utilizzare le release graduali in "produzione" monitorare in modo sicuro esegui prima il deployment della release a una piccola percentuale di utenti di produzione per poi aumentare gradualmente questa percentuale man mano che l'uscita cresce.
Gli utenti che utilizzano la modalità semplice non devono inserire più di un APK per ogni traccia. Utenti in modalità avanzata che utilizzano più APK assistenza puoi caricare zero, uno o più APK per ogni canale.
Nome del canale per i canali dei fattori di forma
Il nome del canale per una traccia di fattore di forma è preceduto da un prefisso specifico identificativo dell'utente.
| Fattore di forma | Prefisso |
|---|---|
| Android Automotive OS | auto e motori |
| Wear OS | abbigliamento |
| Android TV | tv |
Come si calcola il nome della traccia per una determinata traccia di fattore di forma?
Tipi di canali comuni, come produzione, test aperti e interni canale di test con un nome noto.
| Tipo di monitoraggio | Nome traccia predefinito |
|---|---|
| Produzione | produzione |
| Test aperti | beta |
| Test interni | qa |
Il nome della traccia per una determinata traccia di fattore di forma può essere calcolato come:
"[prefix]:defaultTrackName".
Ad esempio, il fattore di forma Wear OS avrà canali con nome:
"wear:production", "wear:beta" e "wear:qa".
I canali di test chiusi vengono creati manualmente e dispongono di
i nomi degli utenti. Quindi un canale di test chiuso per un fattore di forma denominato $name
avrà il nome della traccia "[prefix]:$name".
Esempio di flusso di lavoro APK
Questa sezione descrive un modo tipico di utilizzo dell'API Track. In questo caso, presupponiamo che tu voglia caricare nuove versioni dell'APK per ogni traccia e assegniamo diversi utenti a ricevere una versione con implementazione graduale. (In pratica, uno sviluppatore è improbabile che tu esegua tutte queste azioni nella stessa operazione; invece, aggiornare la versione beta un giorno, creare una release graduale "produzione" un altro giorno e così via.)
- Apri una nuova modifica, come descritto in Flusso di lavoro delle modifiche
- Chiama il metodo Edits.apks: upload per ogni APK che vuoi caricare. Trasmetti l'APK nella richiesta del metodo del testo. L'APK viene inserito in un'area di archiviazione, ma non viene rilasciato o eseguirne il deployment.) Il metodo restituisce un codice di versione per ogni APK caricato; utilizzerai questo codice di versione per fare riferimento all'APK quando lo rilasci in un canale.
Chiama il metodo Edits.tracks: update. per ogni canale per cui vuoi pubblicare APK. Nel corpo della richiesta, passare una risorsa Edits.tracks. contenente la release che vuoi implementare. Ad esempio, per rilasciare un APK con codice di versione 88:
{ "releases": [{ "versionCodes": ["88"], "status": "completed" }] }Al momento gli APK non sono ancora disponibili per gli utenti. Come con altre modifiche, queste non vengono pubblicate finché non ne esegui il commit.
Chiama il metodo Edits: commit per eseguire il commit delle modifiche. Dopodiché, gli utenti di ogni canale data la versione aggiornata dell'APK. (come per tutte le modifiche, può l'applicazione delle modifiche potrebbe richiedere diverse ore.
Implementazioni graduali
Quando vuoi implementare gradualmente una nuova versione dell'APK, puoi: rilasciarlo come "implementazione graduale" completamente gestita. In questo caso, Google Play lo distribuisce automaticamente nella frazione desiderata del gli utenti da te specificati. Se l'implementazione L'APK non presenta problemi (ad esempio arresti anomali e così via), potresti aumentare il numero di utenti che ricevono questo versione; quando è tutto pronto, puoi eseguire il deployment dell'APK come nuova versione di produzione completamente gestita.
Questa sezione descrive i passaggi da seguire per eseguire una implementazione graduale di un APK, quindi promuovilo alla versione di produzione:
Crea una modifica, come descritto in Flusso di lavoro delle modifiche.
Carica un nuovo APK per la modifica utilizzando il Edits.apks: caricamento.
Avvia una release graduale di
"inProgress"nel canale di produzione utilizzando: Metodo Edits.tracks: update. Scegli il tipo frazione di utenti che dovrebbero ricevere il nuovo APK. A questo punto, l'APK non sono ancora disponibili per nessun utente finale.{ "releases": [{ "versionCodes": ["99"], "userFraction": 0.05, "status": "inProgress" }] }Esegui il commit delle modifiche nella modifica attiva chiamando Modifiche: esegui il commit. Nei prossimi ore, il nuovo APK verrà implementato per gli utenti. La frazione degli utenti selezionati riceverà il nuovo APK.
A seconda del successo dell'implementazione graduale, puoi decidere di aumentare la percentuale di utenti idonei per quella release o interromperla.
Aumento del numero di utenti per un'implementazione graduale
Supponendo che tu abbia un'implementazione graduale in corso al 5%, come descritto nella questa sezione descrive come aumentare la percentuale nel caso in cui in cui la release sta andando bene:
Crea una modifica, come descritto in Flusso di lavoro delle modifiche.
Modifica la release graduale di
"inProgress"nel canale di produzione utilizzando il Metodo Edits.tracks: update. Aumenta frazione di utenti che dovrebbero ricevere il nuovo APK:{ "releases": [{ "versionCodes": ["99"], "userFraction": 0.1, "status": "inProgress" }] }Esegui il commit delle modifiche nella modifica attiva chiamando Modifiche: esegui il commit. Nei prossimi ore, il nuovo APK verrà implementato per gli utenti. La frazione degli utenti selezionati riceverà il nuovo APK.
Interruzione di un'implementazione graduale
Supponendo che tu abbia un'implementazione graduale in corso al 5%, come descritto nella questa sezione descrive come interrompere l'implementazione graduale nel caso in cui scopri un problema:
Crea una modifica, come descritto in Flusso di lavoro delle modifiche.
Modifica la release graduale di
"inProgress"nel canale di produzione utilizzando il Metodo Edits.tracks: update. Imposta il parametro su"halted".{ "releases": [{ "versionCodes": ["99"], "status": "halted" }] }Esegui il commit delle modifiche nella modifica attiva chiamando Modifiche: esegui il commit. La tua release non sarà più essere disponibili per i nuovi utenti.
Se in un secondo momento decidi di riprendere una release interrotta, puoi farlo impostando
torna a "inProgress".
Completamento di un'implementazione graduale
Se l'implementazione graduale ti soddisfa e vuoi implementare la release per
Per il 100% degli utenti puoi impostare lo stato della release su "completed":
Crea una modifica, come descritto in Flusso di lavoro delle modifiche.
Modifica la release graduale di
"inProgress"nel canale di produzione utilizzando il Metodo Edits.tracks: update. Imposta il parametro su"completed".{ "releases": [{ "versionCodes": ["99"], "status": "completed" }] }Esegui il commit delle modifiche nella modifica attiva chiamando Modifiche: esegui il commit. Nei prossimi ore, il nuovo APK verrà implementato per gli utenti. La frazione degli utenti selezionati riceverà il nuovo APK.
Release bozza
Le versioni bozza ti consentono di caricare automaticamente gli APK e di creare una release tramite l'API il cui deployment può essere eseguito in un secondo momento tramite Google Play Console. A crea una versione bozza in un canale:
- Apri una nuova modifica, come descritto in Flusso di lavoro delle modifiche
- Chiama il metodo Edits.apks: upload per ogni APK che vuoi caricare. Trasmetti l'APK nel corpo della richiesta del metodo. La restituisce un codice di versione per ogni APK caricato; lo utilizzerai per fare riferimento all'APK quando lo assegni a una release.
Chiama il metodo Edits.tracks: update. per ogni traccia in cui vuoi pubblicare. Nel corpo della richiesta, passare una risorsa Edits.tracks. contenente la versione bozza che vuoi creare. Ad esempio:
{ "releases": [{ "name": "My draft release", "versionCodes": ["88"], "status": "draft" }] }.Chiama il metodo Edits: commit per eseguire il commit delle modifiche. Ora la versione bozza può essere ispezionata e implementata tramite Google Play Console o l'API.
Specificare le note di rilascio
Quando rilasci una nuova versione della tua applicazione puoi evidenziare per gli utenti specificando le note di rilascio relative alla release.
Per farlo, utilizza il campo "releaseNotes" quando fornisci una
Edits.tracks della risorsa
Metodo Edits.tracks: update.
{
"releases": [{
"name": "Release with notes",
"versionCodes": ["88"],
"status": "completed",
"releaseNotes": [
{"language": "en-US", "text": "Describe what's new in this release."}
]
}]
}