Build Android

Build dan submit aplikasi Android ke Google Play Store menggunakan infrastruktur khusus Capgo.

Apa yang akan Anda pelajari

• Anda akan belajar cara upload aplikasi via Capgo Native build
• Anda akan belajar cara mengonfigurasi kredensial untuk Capgo Native Build

Prerequisites

• Anda harus memiliki akun Google Developer yang aktif
• Anda harus sudah menginstal Android Studio
• Aplikasi Anda harus bisa di-build dengan sukses di Android Studio

Catatan

Saya akan menggunakan aplikasi berikut untuk tutorial ini: https://github.com/Cap-go/capgo-tutorial-native-build-app

Direkomendasikan: onboarding otomatis

Anda tidak perlu melakukan semua ini secara manual. Onboarding Capgo membuat dan mengonfigurasi kredensial signing Android Anda (keystore + Google Play service account) untuk Anda — ini cara yang direkomendasikan:

bunx @capgo/cli@latest build init --platform android

Panduan manual di bawah ini hanya untuk Anda yang lebih suka mengatur kredensial sendiri, atau ingin memahami persis apa yang dilakukan Capgo di balik layar.

Build manual pertama

Sebelum mulai memikirkan build aplikasi dengan Capgo, sebaiknya kita atur dulu dan lakukan build Android pertama secara manual. Ada beberapa keuntungan melakukan build manual lebih dulu:

• Anda akan menyiapkan kredensial untuk build Capgo berikutnya
• Anda akan membuat entri di Play Store Console

Build aplikasi secara manual dengan Android Studio

Sebelum kita bisa mulai build aplikasi dengan Capgo, kita perlu build aplikasi secara manual menggunakan Android Studio.

1. Buka Android Studio

   Jalankan bunx cap open android untuk membuka proyek Android Studio.

2. Klik pada Build -> Generate Signed App Bundles / APKs

3. Pilih Android App Bundle dan klik pada Next

Membuat Keystore

Saat ini, Anda belum memiliki file keystore. File ini digunakan untuk menandatangani app Anda, sehingga Google tahu bahwa Andalah yang membuat app tersebut. Untuk membuatnya, kita akan menggunakan metode GUI yang disediakan oleh Android Studio. Ada juga cara melakukannya lewat command line, tetapi tidak akan dibahas dalam tutorial ini.

1. Klik pada Create new

2. Isi jalur Key Store

   Peringatan

   Ini HARUS DISIMPAN - akan digunakan nanti

3. Atur password Key Store

   Catatan

   Saya sarankan pakai password yang sama untuk Key Store dan Key Alias.

   Peringatan

   Ini HARUS DISIMPAN - akan digunakan nanti

4. Lengkapi sisa formulir

   1. Biarkan Key Alias apa adanya (key0)
   2. Isi detail sertifikat. Saya sudah mengisinya dengan detail palsu, tapi Anda harus mengisinya dengan detail Anda sendiri.

   

5. Klik pada OK

Menyelesaikan build manual

1. Pastikan semua detail keystore sudah diisi dengan benar dan klik Next

2. Pilih release build variant dan klik Create

3. Setelah build berhasil, Anda akan melihat layar berikut

   1. Popup ini menunjukkan bahwa build berhasil.
   2. Klik pada locate tombol - ini akan membuka file explorer dan Anda akan melihat build di sana.

4. Pastikan Anda dapat melihat build di file explorer

Membuat aplikasi di Play Store Console

1. Buka Google Play Console

2. Pilih akun developer yang tepat

3. Klik pada Create app

4. Pilih nama aplikasi dan bahasa.

5. Pilih kategori aplikasi dan apakah aplikasi berbayar atau gratis.

6. Setujui syarat dan ketentuan

   Peringatan

   Pastikan Anda membaca syarat dan ketentuan sebelum menyetujuinya.

7. Klik pada Create

Membuat grup internal testing

Setelah aplikasi dibuat, Anda bisa membuat grup internal testing. Karena saya tidak akan benar-benar mempublikasikan aplikasi ini untuk semua orang di Play Store, saya perlu membuat grup internal testing.

Catatan

Pengujian internal tetap cara tercepat untuk smoke test build yang didistribusikan lewat Play sebelum peluncuran resmi.

Jika akun developer Anda adalah akun personal yang dibuat setelah 13 November 2023, pengujian internal memang tidak menggantikan persyaratan closed testing untuk akses produksi. Anda tetap perlu closed test dengan minimal 12 tester yang sudah opt-in selama 14 hari berturut-turut sebelum produksi.

1. Buka internal testing Klik pada Test and release -> Testing -> Internal testing

   

2. Klik pada Testers

3. Klik pada Create email list

4. Beri nama daftar email

5. Tambahkan alamat email tester

6. Tekan Enter dan klik pada Save

7. Klik pada Create group

8. Pastikan daftar baru sudah terpilih, lalu klik pada Save

Mengunggah aplikasi ke grup pengujian internal

Setelah membuat grup pengujian internal, Anda dapat mengunggah aplikasi ke grup tersebut.

1. Buka Test and release -> Testing -> Internal testing

2. Klik pada Releases tombol

3. Klik pada Create new release

4. Klik pada Upload

5. Pilih file AAB

   Peringatan

   Pastikan Anda memilih file AAB yang dibangun secara manual dengan Android Studio. Jika file ini tidak menggunakan keystore yang sama dengan yang akan Anda gunakan untuk build Capgo, maka Capgo Native Build akan gagal.

6. Tunggu hingga file AAB di-upload

7. Klik pada Next

8. Perbaiki error

   Secara pribadi, pada tahap ini saya melihat error ini

   

   Hal ini terjadi karena saya belum memverifikasi nomor telepon saya. Saya akan melakukannya dan melanjutkan tutorial.

9. Klik pada Save and publish Ini akan mempublikasikan aplikasi ke grup pengujian internal.

10. Konfirmasi publikasi

11. Pastikan aplikasi sudah dipublikasikan

12. Dapatkan nama aplikasi sementara Anda

Terima undangan ke grup pengujian internal

Setelah Anda mengunggah aplikasi ke grup pengujian internal, Anda dapat menerima undangan ke grup tersebut.

1. Buka Test and release -> Testing -> Internal testing

2. Klik pada Testers

3. Klik pada Copy link

4. Kirim tautan ke ponsel, buka di browser, lalu klik Accept

5. Pastikan undangan telah diterima, lalu klik “download it on Play Store”

6. Instal aplikasi

   1. Jika Anda sudah menginstal aplikasi sebelum menggunakan Android Studio, klik pada uninstall tombol
   2. Klik pada install tombol
   3. Buka aplikasi dan pastikan sudah berhasil diunduh

   Peringatan

   Jika aplikasi tidak muncul di Play Store, pastikan Anda sudah memilih akun yang benar di Play Store.

Konfigurasi Capgo Native Build (Android)

Sekarang, Anda siap memulai setup Capgo Native Build. Selamat! 🎉

Persyaratan	Flag	Deskripsi	Wajib
File keystore	--keystore <path>	Path ke file .jks/.keystore file yang digunakan untuk menandatangani APK/AAB.	Ya
Alias keystore	--keystore-alias <alias>	Nama alias key di dalam keystore.	Ya
Password key keystore	--keystore-key-password <password>	Password untuk key. Jika password key/store sama, Anda cukup mengisi satu saja.	Lihat catatan di bawah
Password store keystore	--keystore-store-password <password>	Password untuk keystore. Jika password key/store sama, Anda cukup mengisi satu saja.	Lihat catatan di bawah
Akun layanan Google Play	--play-config <path>	File JSON service account untuk upload ke Play Store.	Ya

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

Catatan

Jika kata sandi key dan store identik, cukup berikan salah satu dari --keystore-key-password atau --keystore-store-password.

Keystore, password keystore, password key keystore, alias keystore

Jika Anda telah mengikuti instruksi build manual, Anda seharusnya sudah memiliki keystore yang dibuat. Jika belum mengikuti instruksi, silakan ikuti langkah-langkah tersebut untuk membuat keystore.

Akun layanan Google Play

Membuat service account Google Play adalah proses manual dan kompleks. Namun, ini diperlukan untuk mengunggah aplikasi Anda ke Google Play. Perhatikan hal-hal berikut:

• Anda PERLU menjadi pemilik Developer Account. Jika tidak, Anda tidak akan dapat mengatur service account.
• Anda perlu membuat Google Cloud Project baru (terpisah dari Google Play Account Anda)

Mari kita mulai.

1. Buka Google Cloud Console

2. Klik pada pemilih proyek

3. Jika Anda sudah memiliki proyek, pilih proyek tersebut. Jika belum, buat proyek baru:

   Catatan

   Tangkapan layar di bawah hanya ilustrasi - gunakan nama yang sesuai dengan proyek Anda.

   1. Klik pada New project
   2. Beri nama proyek Anda lalu klik Create
   3. Pastikan Anda berada di proyek yang benar

4. Let’s click on the search bar and search for service accounts dan klik pada item tersebut

5. Let’s click on Create service account

6. Isi formulir untuk service account dan klik Done

   1. Saya sarankan mengatur nama menjadi Capgo Native Build Service Account
   2. Untuk Service Account ID, saya sarankan mengaturnya menjadi capgo-native-build-service-acc
   3. Untuk deskripsi, tidak perlu diisi, tapi saya sarankan mengisi dengan Allows Capgo Native Build to build and submit the app to the Play Store

   

7. Klik service account yang baru dibuat Sekarang Anda akan melihat service account yang baru dibuat di daftar. Klik service account tersebut.

   Catatan

   Salin juga alamat email ini, Anda akan membutuhkannya nanti.

8. Klik pada Keys tab

9. Klik pada Add Key dan Create new key

10. Klik pada JSON dan Create

    Peringatan

    Klik pada Create akan membuat key baru dan mengunduh file JSON ke mesin lokal Anda.

    Anda perlu menyimpan file JSON itu di tempat yang aman. File ini AKAN digunakan nanti.

11. Unduh file JSON File JSON seharusnya sudah terunduh otomatis. Anda bisa klik close untuk menutup jendela.

Memberikan akses API Play Store ke service account

Service account yang baru dibuat belum memiliki akses ke Play Store API. Untuk memberikannya, buka Play Store Console.

1. Buka Google Play Console
2. Pilih akun developer yang tepat
3. Klik pada Users and permissions
4. Klik pada Invite new users
5. Salin alamat email service account
6. Buka Account permissions dan berikan izin minimum yang diperlukan:
   • Di App permissions, berikan akses ke aplikasi Anda.
   • Di Releases, aktifkan Create, edit, and roll out releases.
   • Jika workflow Anda menggunakan Play App Signing, aktifkan izin signing terkait.
   • Jika Anda tidak yakin, gunakan Admin hanya selama setup, lalu kurangi izin setelahnya.
7. Klik pada Invite user
8. Konfirmasi undangan
9. Pastikan bahwa user sudah diundang

Menyimpan kredensial

Sekarang Anda siap menyimpan kredensial dan menjalankan build pertama Anda. Anda dapat menyimpan kredensial menggunakan perintah berikut:

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

Setup CI/CD (GitHub Actions)

Jika Anda sudah menyelesaikan Keystore, password keystore, password key keystore, alias keystore dan Akun layanan Google Play, Anda sudah memiliki semua yang dibutuhkan untuk CI/CD. Bagian ini hanya membahas cara meneruskan nilai-nilai tersebut sebagai GitHub Actions secrets dan environment variables.

1) Konversi file kredensial menjadi base64 satu baris

# Android keystore (.jks or .keystore)
base64 -i ./path/to/keystore.jks | tr -d '\n' > keystore_base64.txt

# Google Play service account JSON
base64 -i ./play-store-service-account.json | tr -d '\n' > play_config_base64.txt

Tips

Secret GitHub harus berupa nilai satu baris. tr -d '\n' menghapus line break dari output base64.

2) Buat repository secrets

Di GitHub > Repository > Settings > Secrets and variables > Actions, tambahkan:

Nama Secret	Nilai
CAPGO_TOKEN	Token Capgo API Anda
APP_ID	App ID Capgo Anda (contoh: com.example.app)
ANDROID_KEYSTORE_FILE	Isi dari keystore_base64.txt
KEYSTORE_KEY_ALIAS	Alias keystore dari Keystore, password keystore, password key keystore, alias keystore
KEYSTORE_KEY_PASSWORD	Password key keystore
KEYSTORE_STORE_PASSWORD	Password store keystore
PLAY_CONFIG_JSON	Isi dari play_config_base64.txt

Catatan

Jika password key dan store sama, Anda cukup mengisi salah satu dari KEYSTORE_KEY_PASSWORD atau KEYSTORE_STORE_PASSWORD.

3) Gunakan env vars di workflow GitHub Actions Anda

.github/workflows/android-build.yml

name: Android Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  android-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request Android build with Capgo
        run: bunx @capgo/cli@latest build request ${{ secrets.APP_ID }} --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

Tips

Dengan setup ini, CI hanya mengirim kredensial melalui environment variable. Anda tidak perlu commit file signing atau mengunggahnya sebagai artifact workflow.

Menjalankan build

Selamat 🎉! Anda siap menjalankan build pertama Anda.

Jalankan:

bunx @capgo/cli@latest build request com.example.app --platform android

Dan ini akan memulai proses build 🍾🥂

Ajukan rilis Play untuk ditinjau

Secara default, build rilis Android akan di-upload ke Google Play dan dapat tetap tidak aktif sampai Anda menyelesaikan rilis di Play Console. Jika rilis CI Anda harus mengajukan rilis Play secara otomatis, gunakan --submit-to-store-review dengan build rilis:

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --android-track production \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales"

Peringatan

Di Android, --submit-to-store-review berlaku sebagai produksi track dengan release_status: completed ketika Anda tidak mengatur track. Hal ini dapat dirilis ke 100% pengguna. Pass --android-track internal (atau alpha / beta) — atau atur PLAY_STORE_TRACK di CI — agar rilis yang selesai tetap di track non-produksi. Gunakan --android-release-status / PLAY_STORE_RELEASE_STATUS saat Anda butuh status yang berbeda dari completed.

Ini memerlukan setup Google Play service account yang sama dengan jalur upload biasa (PLAY_CONFIG_JSON di CI atau kredensial Android yang disimpan secara lokal). --store-release-name digunakan sebagai Google Play version_name. --store-release-notes adalah fallback changelog Play, dan setiap --store-release-notes-locale "locale=notes" entry menulis changelog Play yang dilokalkan untuk locale tersebut. Capgo mengirim rilis Play sebagai completed kecuali Anda menimpa --android-release-status; jika Managed publishing diaktifkan di Play Console, Google masih bisa menunggu publikasi manual Anda setelah persetujuan.

Lanjutkan dari Android Builds

Jika Anda menggunakan Build Android untuk merencanakan otomatisasi CI/CD, hubungkan dengan CI/CD Capgo untuk workflow produk di Capgo CI/CD, Capgo Native Build untuk workflow produk di Capgo Native Builds, Integrasi Capgo untuk alur kerja produk di Integrasi Capgo, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Integrasi GitHub Actions untuk detail implementasi di Integrasi GitHub Actions.