APK dan Jalur

Google Play Developer API memungkinkan Anda mengupload APK baru untuk aplikasi dan merilisnya ke jalur rilis yang berbeda. Dengan begitu, Anda dapat men-deploy versi alfa dan beta aplikasi, yang tersedia untuk pengguna yang disetujui. Ini juga memungkinkan Anda men-deploy versi peluncuran bertahap, yang secara otomatis tersedia untuk sejumlah kecil pengguna aplikasi. Setelah merilis versi peluncuran bertahap, Anda dapat meningkatkan jumlah pengguna yang mendapatkan versi aplikasi tersebut secara bertahap, sampai akhirnya men-deploy versi tersebut sebagai versi "produksi".

Menambahkan dan Mengubah APK

1. Upload satu atau beberapa APK dengan memanggil metode Edits.apks: upload.

   Metode ini mengupload APK ke dalam "bucket" penyimpanan, yang dapat ditetapkan ke "jalur" untuk didistribusikan ke pengguna. (Jika edit dihapus atau dibuang, semua APK yang diupload ke edit tersebut juga akan hilang.)

2. Rilis APK di "jalur" dengan memanggil Edits.tracks: update. Anda dapat merilis APK pada jalur berikut:

   • Jalur pengujian seperti "alpha" dan "beta"

     Versi alfa dan beta aplikasi didistribusikan ke pengguna yang Anda tetapkan untuk grup pengujian alfa dan beta. Anda menetapkan pengguna ke grup ini menggunakan Konsol Google Play.

   • Jalur pengujian internal: "qa"

     Versi internal aplikasi Anda di-deploy ke jalur pengujian internal seperti yang dikonfigurasikan di Konsol Google Play.

   • Jalur produksi: "production"

     Rilis pada jalur "produksi" didistribusikan ke semua pengguna. Anda dapat menggunakan rilis bertahap di jalur "produksi" untuk mendistribusikan rilis Anda terlebih dahulu kepada sejumlah kecil persentase pengguna produksi dengan aman, lalu secara bertahap meningkatkan persentase ini seiring meningkatnya keyakinan Anda terhadap rilis ini.

   Pengguna mode sederhana sebaiknya tidak menempatkan lebih dari satu APK ke jalur mana pun. Pengguna mode lanjutan yang menggunakan dukungan beberapa APK dapat mengupload nol, satu, atau beberapa APK ke setiap jalur.

Nama jalur untuk jalur faktor bentuk

Nama jalur untuk jalur faktor bentuk diawali dengan ID tertentu.

Faktor Bentuk	Awalan
Android Automotive OS	otomotif
Wear OS	wear
Android TV	tv

Bagaimana cara komputasi nama jalur untuk jalur faktor bentuk tertentu?

Jenis jalur umum seperti produksi, pengujian terbuka, dan jalur pengujian internal memiliki nama jalur yang sudah banyak dikenal.

Jenis Jalur	Nama Jalur Default
Produksi	produksi
Pengujian Terbuka	beta
Pengujian Internal	qa

Nama jalur untuk jalur faktor bentuk tertentu dapat dikomputasi sebagai: "[prefix]:defaultTrackName". Misalnya, faktor bentuk Wear OS akan memiliki jalur dengan nama: "wear:production", "wear:beta", dan "wear:qa".

Jalur pengujian tertutup dibuat secara manual dan memiliki nama khusus. Jadi, jalur pengujian tertutup untuk faktor bentuk dengan nama $name akan memiliki nama jalur "[prefix]:$name".

Contoh Alur Kerja APK

Bagian ini menjelaskan cara umum penggunaan API Jalur. Dalam kasus ini, kami menganggap Anda ingin mengupload versi baru APK untuk setiap jalur, dan menetapkan sejumlah pengguna untuk menerima versi peluncuran bertahap. (Dalam praktiknya, developer mungkin tidak akan melakukan semua tindakan ini dalam operasi yang sama, tetapi mengupdate versi beta di satu hari, membuat rilis bertahap pada "produksi" di hari lainnya, dan seterusnya.)

1. Buka edit baru, seperti yang dijelaskan di Alur Kerja Edit
2. Panggil metode Edits.apks: upload untuk setiap APK yang ingin diupload. Teruskan APK di isi permintaan metode. (Tindakan ini akan menempatkan APK di area penyimpanan, tetapi tidak merilisnya pada jalur atau men-deploy-nya.) Metode tersebut akan menampilkan kode versi untuk setiap APK yang Anda upload; Anda akan menggunakan kode versi ini untuk merujuk ke APK saat Anda merilisnya di jalur.

3. Panggil metode Edits.tracks: update untuk setiap jalur tempat Anda ingin merilis APK. Dalam isi permintaan, teruskan Edits.tracks resource yang berisi rilis yang ingin Anda luncurkan. Misalnya, untuk merilis APK dengan kode versi 88:

   {
   "releases": [{
     "versionCodes": ["88"],
     "status": "completed"
   }]
   }
   

   Pada titik ini, APK masih belum tersedia untuk pengguna. Seperti edit lainnya, perubahan tidak aktif sampai Anda melakukan commit.

4. Panggil metode Edits: commit guna melakukan commit untuk perubahan tersebut. Setelah Anda melakukannya, pengguna di setiap jalur akan diberi versi APK yang diupdate. (Seperti halnya dengan semua edit, diperlukan waktu beberapa jam agar perubahan diterapkan.)

Peluncuran Bertahap

Jika Anda memiliki versi baru APK yang ingin di-deploy secara bertahap, Anda dapat memilih untuk merilisnya sebagai versi "peluncuran bertahap". Jika Anda melakukannya, Google Play akan men-deploy APK secara otomatis ke sejumlah pengguna aplikasi yang Anda tentukan. Jika APK "peluncuran" tidak memiliki masalah (seperti error, dll.), Anda dapat meningkatkan jumlah pengguna yang menerima versi tersebut; jika sudah siap, Anda dapat mendistribusikan APK tersebut sebagai versi produksi baru.

Bagian ini menjelaskan langkah-langkah yang akan Anda lalui untuk melakukan peluncuran bertahap APK, kemudian mempromosikannya ke produksi:

1. Buat edit, seperti yang dijelaskan di Alur Kerja Edit

2. Upload APK baru ke edit, menggunakan metode Edits.apks: upload.

3. Mulai rilis bertahap "inProgress" di jalur produksi menggunakan metode Edits.tracks: update. Pilih fraksi pengguna yang akan menerima APK baru. Pada tahap ini, APK masih tidak tersedia untuk pengguna akhir.

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.05,
     "status": "inProgress"
   }]
   }
   

4. Commit perubahan dalam edit aktif dengan memanggil Edits: commit. Selama beberapa jam ke depan, APK baru akan diluncurkan kepada pengguna. Sejumlah pengguna yang Anda pilih akan menerima APK baru.

Bergantung pada keberhasilan peluncuran bertahap, selanjutnya Anda dapat meningkatkan persentase pengguna yang memenuhi syarat untuk rilis tersebut atau menghentikan rilis.

Meningkatkan jumlah pengguna untuk peluncuran bertahap

Dengan asumsi Anda memiliki peluncuran bertahap 5% yang sedang berjalan, seperti yang dijelaskan di bagian sebelumnya, bagian ini menjelaskan cara meningkatkan persentase apabila rilis berjalan dengan baik:

1. Buat edit, seperti yang dijelaskan di Alur Kerja Edit.

2. Ubah rilis bertahap "inProgress" di jalur produksi menggunakan metode Edits.tracks: update. Tingkatkan fraksi pengguna yang akan menerima APK baru:

   {
   "releases": [{
     "versionCodes": ["99"],
     "userFraction": 0.1,
     "status": "inProgress"
   }]
   }
   

3. Commit perubahan dalam edit aktif dengan memanggil Edits: commit. Selama beberapa jam ke depan, APK baru akan diluncurkan kepada pengguna. Sejumlah pengguna yang Anda pilih akan menerima APK baru.

Menghentikan peluncuran bertahap

Dengan asumsi Anda memiliki peluncuran bertahap 5% yang sedang berjalan, seperti yang dijelaskan di bagian sebelumnya, bagian ini menjelaskan cara menghentikan peluncuran bertahap jika Anda menemukan masalah:

1. Buat edit, seperti yang dijelaskan di Alur Kerja Edit

2. Ubah rilis bertahap "inProgress" di jalur produksi menggunakan metode Edits.tracks: update. Setel status ke "halted".

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "halted"
   }]
   }
   

3. Commit perubahan dalam edit aktif dengan memanggil Edits: commit. Rilis Anda tidak akan tersedia lagi untuk pengguna baru.

Jika nantinya memutuskan untuk melanjutkan rilis yang dihentikan, Anda dapat melakukannya dengan menetapkan statusnya kembali ke "inProgress".

Menyelesaikan peluncuran bertahap

Setelah Anda puas dengan peluncuran bertahap dan ingin meluncurkan rilis ke keseluruhan pengguna, Anda dapat menyetel status rilis ke "completed":

1. Buat edit, seperti yang dijelaskan di Alur Kerja Edit

2. Ubah rilis bertahap "inProgress" di jalur produksi menggunakan metode Edits.tracks: update. Setel status ke "completed".

   {
   "releases": [{
     "versionCodes": ["99"],
     "status": "completed"
   }]
   }
   

3. Commit perubahan dalam edit aktif dengan memanggil Edits: commit. Selama beberapa jam ke depan, APK baru akan diluncurkan kepada pengguna. Sejumlah pengguna yang Anda pilih akan menerima APK baru.

Rilis draf

Rilis draf memungkinkan Anda mengupload APK secara otomatis dan membuat rilis melalui API yang nantinya dapat didistribusikan melalui Konsol Google Play. Untuk membuat rilis draf pada jalur:

1. Buka edit baru, seperti yang dijelaskan di Alur Kerja Edit
2. Panggil metode Edits.apks: upload untuk setiap APK yang ingin diupload. Teruskan APK di isi permintaan metode. Metode ini menampilkan kode versi untuk setiap APK yang Anda upload; Anda akan menggunakan kode versi ini untuk merujuk ke APK saat Anda menetapkannya ke rilis.

3. Panggil metode Edits.tracks: update untuk setiap jalur yang ingin Anda rilis. Dalam isi permintaan, teruskan Edits.tracks resource yang berisi rilis draf yang ingin Anda buat. Contoh:

   {
   "releases": [{
     "name": "My draft release",
     "versionCodes": ["88"],
     "status": "draft"
   }]
   }
   

4. Panggil metode Edits: commit guna melakukan commit untuk perubahan tersebut. Rilis draf Anda kini dapat diperiksa dan diluncurkan melalui Konsol Google Play atau API.

Menentukan catatan rilis

Saat merilis versi baru aplikasi, Anda dapat menyoroti apa yang baru bagi pengguna dengan menentukan catatan rilis pada rilis.

Untuk melakukannya, gunakan kolom "releaseNotes" saat menyediakan resource Edits.tracks ke metode Edits.tracks: update.

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