Build Android

Bangun dan kirimkan aplikasi Android ke Google Play Store menggunakan infrastruktur Capgo yang terintegrasi.

Apa yang akan Anda pelajari

• Anda akan belajar cara mengunggah aplikasi melalui Capgo Native build
• Anda akan belajar cara mengkonfigurasi kredential untuk Capgo Native Build

Persyaratan

• Anda perlu memiliki akun pengembang Google aktif
• Anda perlu memiliki Android Studio terinstal
• Aplikasi Anda harus dapat dibangun dengan sukses menggunakan Android Studio

Catatan

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

Dianjurkan: onboarding otomatis

Anda tidak perlu melakukan semua ini secara manual. Capgo's onboarding akan membuat dan mengkonfigurasi kunci tanda tangan Android Anda (keystore + akun layanan Google) secara otomatis — ini adalah jalur yang dianjurkan:

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

Berikut adalah panduan manual yang hanya untuk mereka yang lebih suka mengatur kredit sendiri, atau ingin memahami secara spesifik apa yang Capgo lakukan di bawah kerangka.

Build manual pertama

Sebelum kita bisa memikirkan tentang membangun aplikasi dengan Capgo, kita harus terlebih dahulu mengatur dan melakukan build Android pertama secara manual. Ada beberapa kelebihan dari melakukan build manual pertama:

• Kamu akan mengatur kredit untuk build Capgo nanti
• Kamu akan membuat catatan di Console Play Store

Membangun aplikasi secara manual dengan Android Studio

Sebelum kita bisa membangun aplikasi dengan Capgo, kita perlu membangun aplikasi secara manual dengan Android Studio.

1. Buka Android Studio

   Run 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 Kunci Keamanan

Saat ini, Anda kekurangan file kunci keamanan. File ini digunakan untuk menandatangani aplikasi Anda, sehingga Google dapat mengetahui bahwa itu Anda yang membuat aplikasi tersebut. Untuk menghasilkannya, kami akan menggunakan metode GUI yang disediakan oleh Android Studio. Ada juga cara untuk melakukan ini dengan menggunakan perintah baris, tetapi kami tidak akan menutupinya dalam tutorial ini.

1. Klik pada Create new

2. Isi jalur Key Store

   Peringatan

   Ini PERLU DI SIMPAN - akan digunakan kemudian

3. Setel kata sandi Key Store

   Catatan

   Saya merekomendasikan menggunakan kata sandi yang sama untuk Key Store dan Key Alias.

   Peringatan

   Ini HARUS DISIMPAN - akan digunakan kemudian

4. Penuhi bagian formulir yang tersisa

   1. Tetapkan Alias Kunci seperti itu (key0)
   2. Penuhi detail sertifikat. Saya telah mengisi dengan detail palsu, tetapi Anda harus mengisi dengan detail Anda sendiri.

   

5. Klik pada OK

Mengakhiri pembangunan manual

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

2. Pilih release varian pembangunan dan klik pada Create

3. Setelah pembangunan berhasil, Anda harus melihat layar berikut

   1. Pesan pop-up ini menunjukkan bahwa pembangunan berhasil.
   2. Klik pada locate tombol - ini akan membuka eksplor file dan Anda harus melihat pembangunan di sana.

4. Pastikan Anda dapat melihat pembangunan di eksplor file

Membuat aplikasi di Console Toko Play

1. Pergi ke Console Google Play

2. Pilih akun pengembang yang tepat

3. Klik pada Create app

4. Pilih nama aplikasi dan bahasa

5. Pilih kategori aplikasi dan apakah aplikasi berbayar atau gratis

6. Terima syarat dan ketentuan

   Peringatan

   Pastikan Anda membaca syarat dan ketentuan sebelum menerima mereka.

7. Klik pada Create

Membuat kelompok pengujian internal

Sekarang bahwa Anda telah membuat aplikasi, Anda dapat membuat kelompok pengujian internal. Karena saya tidak akan mempublikasikan aplikasi untuk semua di Toko Play, saya perlu membuat kelompok pengujian internal.

Catatan

Tes internal masih merupakan cara tercepat untuk menguji asap build Anda yang didistribusikan melalui Play sebelum peluncuran nyata.

Jika akun pengembang Anda adalah akun pribadi yang dibuat setelah 13 November 2023, pengujian internal tidak not replace the closed-testing requirement for production access. You will still need a closed test with at least 12 opted-in testers for 14 consecutive days before production.

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

   

2. Klik di Testers

3. Klik di Create email list

4. Nama daftar email

5. Tambahkan alamat email dari tester

6. Tekan Enter dan klik pada Save

7. Klik pada Create group

8. Pilihlah daftar baru tersebut dan klik Save

Mengunggah aplikasi ke grup pengujian internal

Sekarang bahwa Anda telah membuat kelompok uji internal, Anda dapat mengunggah aplikasi ke kelompok uji internal.

1. Pergi ke Test and release -> Testing -> Internal testing

2. Klik pada tombol Releases button

3. Klik di Create new release

4. Klik di Upload

5. Pilih file AAB

   Pertimbangan

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

6. Tunggu sampai file AAB diunggah

7. Klik pada Next

8. Perbaiki kesalahan

   Pribadi, pada tahap ini saya melihat kesalahan ini

   

   Saya belum memverifikasi nomor telepon saya. Saya akan melakukannya dan melanjutkan tutorial.

9. Klik pada Save and publish ini akan mempublikasikan aplikasi ke kelompok uji internal.

10. Konfirmasikan publikasi

11. Pastikan aplikasi telah dipublikasikan

12. Dapatkan nama aplikasi sementara Anda

Terima undangan ke kelompok uji internal

Sekarang Anda telah mengunggah aplikasi ke kelompok uji internal, Anda dapat menerima undangan ke kelompok uji internal.

1. Pergi ke Test and release -> Testing -> Internal testing

2. Klik pada Testers

3. Klik pada Copy link

4. Kirimkan tautan ke ponsel Anda, buka di browser dan klik pada Accept

5. Pastikan undangan telah diterima dan klik pada ‘download di Toko Play’

6. Instal Aplikasi

   1. Jika Anda telah menginstal aplikasi sebelumnya menggunakan Android Studio, klik pada tombol uninstall tombol
   2. Klik pada tombol install button
   3. Buka aplikasi dan pastikan telah terunduh dengan sukses

   Peringatan

   Jika Anda tidak melihat aplikasi di Play Store, pastikan Anda telah memilih akun yang benar di Play Store.

Mengatur Capgo Pembangunan Asli (Android)

Sekarang, Anda sudah siap untuk memulai pengaturan Capgo Pembangunan Nativ.

Persyaratan	Flag	Deskripsi	Diperlukan
File keystore	--keystore <path>	Jalur ke file .jks/.keystore yang digunakan untuk menandatangani APK/AAB.	Ya
Keystore alias	--keystore-alias <alias>	Nama alias kunci di dalam keystore.	Ya
Kunci sandi Keystore	--keystore-key-password <password>	Sandi untuk kunci. Jika sandi kunci/toko cocok, Anda hanya perlu menyediakan satu.	Lihat catatan di bawah
Sandi toko Keystore	--keystore-store-password <password>	Sandi untuk Keystore. Jika sandi kunci/toko cocok, Anda hanya perlu menyediakan satu.	Lihat catatan di bawah
Nama akun Layanan Google Play	--play-config <path>	File JSON akun Layanan Play Store untuk unggahan.	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 kunci dan penyimpanan sama, berikan hanya satu dari --keystore-key-password atau --keystore-store-password.

Keystore, kata sandi keystore, kata sandi kunci keystore, alias keystore

Jika Anda telah mengikuti Petunjuk Pembangunan ManualAnda sudah harus memiliki keystore yang sudah dibuat. Jika Anda belum mengikuti instruksi, silakan mengikuti instruksi untuk membuat keystore.

Bagian berjudul “Akun layanan Google Play”

Generating the Google Play service account is a manual and complex process. Yet, it is required to upload your app to Google Play. Please keep in mind the following things:

• Anda PERLU untuk menjadi pemilik Akun Pengembang. Jika tidak, Anda tidak akan dapat mengatur akun layanan.
• Anda perlu membuat proyek Google Cloud baru (terpisah dari akun Google Play Anda)

Mari kita mulai.

1. Pergi ke Console Google Cloud

2. Klik pada pemilih proyek

3. Jika Anda sudah memiliki proyek, pilihlah. Jika tidak, buatlah proyek baru:

   Catatan

   Gambar di bawah ini hanya ilustratif - gunakan nama yang sesuai untuk proyek Anda.

   1. Klik pada New project
   2. Berikan nama pada proyek Anda dan klik Create
   3. Pastikan Anda berada di proyek yang tepat

4. Marilah kita klik pada bar pencarian dan cari untuk service accounts dan klik pada tombolnya

5. Marilah kita klik pada Create service account

6. Isi formulir untuk akun layanan dan klik pada Done

   1. Saya merekomendasikan mengatur nama menjadi Capgo Native Build Service Account
   2. Untuk ID Akun Layanan, saya merekomendasikan mengatur menjadi capgo-native-build-service-acc
   3. Isi deskripsi tidak wajib, tetapi saya sarankan Anda mengisi dengan Allows Capgo Native Build to build and submit the app to the Play Store

   

7. Klik pada akun layanan yang baru dibuat Anda seharusnya melihat akun layanan yang baru dibuat dalam daftar. Klik pada akun tersebut.

   Catatan

   Salin alamat email ini juga, 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 kunci baru dan akan mengunduh file JSON ke mesin lokal Anda.

    Perlu menyimpan file JSON di tempat yang aman. Itu Akan digunakan kemudian.

11. Unduh file JSON File JSON seharusnya telah diunduh secara otomatis. Anda dapat mengklik pada close untuk menutup jendela.

Mengizinkan Toko Play API untuk mengakses akun layanan

Akun layanan baru belum memiliki akses ke Toko Play API. Untuk memberikannya, kunjungi Console Toko Play.

1. Pergi ke Console Google Play
2. Pilih akun pengembang yang benar
3. Klik pada Users and permissions
4. Klik pada Invite new users
5. Copy the email address of the service account
6. Lihat Account permissions dan berikan izin yang diperlukan minimal:
   • Dalam App permissions, berikan akses ke aplikasi Anda.
   • Dalam Releases, enable Create, edit, and roll out releases.
   • Jika alur kerja Anda menggunakan Play App Signing, aktifkan izin penandatanganan terkait.
   • saat pengaturan, kemudian kurangi izin setelahnya. Admin Hanya selama pengaturan, kemudian kurangi izin setelahnya.
7. Klik di Invite user
8. Google Play Console konfirmasi undangan
9. Konfirmasi bahwa pengguna telah diundang

Menghematkan kreditensiensi

Sekarang Anda sudah siap untuk menyimpan kreditensial dan menjalankan build pertama Anda. Anda dapat menyimpan kreditensial 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

Pengaturan CI/CD (GitHub Aksi)

Jika kamu sudah menyelesaikan Keystore, kata sandi keystore, kata sandi kunci keystore, alias keystore dan Akun layanan Google PlayAnda sudah memiliki semua yang dibutuhkan untuk CI/CD. Bagian ini hanya menjelaskan cara mengirimkan nilai-nilai tersebut sebagai rahasia aksi GitHub dan variabel lingkungan.

1) Ubah file kredit menjadi kode base64 tunggal

# 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

GitHub rahasia harus memiliki nilai tunggal baris. tr -d '\n' Menghilangkan baris-baris dari hasil base64.

2) Buat rahasia repository

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

Nama rahasia	Nilai
CAPGO_TOKEN	Token Anda Capgo API
APP_ID	ID aplikasi Anda Capgo (contoh:) com.example.app)
ANDROID_KEYSTORE_FILE	Isi dari keystore_base64.txt
KEYSTORE_KEY_ALIAS	Alias kunci keystore dari Keystore, kata sandi keystore, kata sandi kunci keystore, alias keystore
KEYSTORE_KEY_PASSWORD	Kata sandi kunci keystore
KEYSTORE_STORE_PASSWORD	Kata sandi toko keystore
PLAY_CONFIG_JSON	Isi dari play_config_base64.txt

Pertimbangan

Jika kata sandi kunci dan toko sama, Anda dapat memberikan hanya salah satu KEYSTORE_KEY_PASSWORD atau KEYSTORE_STORE_PASSWORD.

3) Gunakan variabel lingkungan di dalam GitHub Actions workflow 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 }}

Trik

Dengan konfigurasi ini, CI mengirimkan kunci melalui variabel lingkungan saja. Anda tidak perlu mengkomit file tanda tangan atau mengunggahnya sebagai artefak workflow.

Menggunakan build

Hore! Anda sudah siap untuk menjalankan build pertama Anda.

Jalankan:

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

Dan ini akan memulai proses pembangunan 🍾🥂

Kirim rilis Play untuk tinjauan

Secara default, rilis Android mengunggah ke Google Play dan dapat tetap tidak aktif hingga Anda menyelesaikan rilis di Console Play. Jika rilis CI Anda harus mengirim rilis Play secara otomatis, tambahkan --submit-to-store-review dengan versi 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"

Pada Android,

Pada Android, --submit-to-store-review berlaku secara default pada produksi mengikuti dengan release_status: completed Jika Anda tidak menetapkan track, maka update dapat dilakukan secara langsung ke 100% pengguna. --android-track internal atau alpha / beta— atau tetapkan PLAY_STORE_TRACK dalam CI — untuk mempertahankan rilis yang selesai pada track non-produksi. Gunakan --android-release-status / PLAY_STORE_RELEASE_STATUS ketika Anda memerlukan status yang berbeda dari completed.

Ini memerlukan pengaturan akun layanan Google Play yang sama seperti jalur unggah normal (PLAY_CONFIG_JSON dalam CI atau kredensial Android yang disimpan secara lokal). --store-release-name digunakan sebagai Google Play version_name. --store-release-notes adalah catatan perubahan Play default, dan setiap --store-release-notes-locale "locale=notes" menulis catatan perubahan Play yang disesuaikan untuk lokasi tersebut. Capgo mengirimkan rilis Play sebagai completed kecuali Anda menggantinya --android-release-status; jika publikasi terkelola diaktifkan di Console Play, Google masih dapat menunggu publikasi manual Anda setelah persetujuan.

Teruskan dari Pembangunan Android

Jika Anda menggunakan Pembangunan Android untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Pembangunan Natives untuk alur kerja produk di Capgo Pembangunan Natives, Integrasi Capgo untuk alur kerja produk di Capgo Integrasi Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Integrasi Aksi GitHub untuk detail implementasi di Integrasi Aksi GitHub.