Membangun Android

Buat dan kirimkan aplikasi Android ke Google Play Store menggunakan infrastruktur Capgo yang khusus.

Apa yang akan Anda pelajari

• Anda akan belajar cara mengunggah aplikasi melalui Capgo Native build
• Anda akan belajar cara mengonfigurasi kredit untuk Capgo Native Build

Persyaratan

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

Catatan

Aplikasi berikut akan saya gunakan untuk tutorial: https://github.com/Cap-go/capgo-native-build-tutorial-app

Pembangunan manual pertama

Sebelum kita bisa memikirkan tentang membangun aplikasi dengan Capgo, kita harus terlebih dahulu mengatur aplikasi tersebut, dan melakukan pembangunan Android pertama secara manual.

• You will prepare the credentials for the later Capgo build
• Anda akan mempersiapkan kredensial untuk pembangunan __CAPGO_KEEP_0__ nanti ini,

Membangun aplikasi secara manual dengan Android Studio

Sebelum kita bisa memulai membangun aplikasi dengan Capgo, kita perlu membangun aplikasi secara manual dengan 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 kekurangan file kunci simpanan. File ini digunakan untuk menandatangani aplikasi Anda, yang memungkinkan Google mengetahui bahwa itu Anda yang membangun aplikasi tersebut. Untuk menghasilkannya, kami akan menggunakan metode GUI yang disediakan oleh Android Studio. Terdapat juga cara untuk melakukannya dengan menggunakan perintah baris, tetapi kami tidak akan membahas itu dalam tutorial ini.

1. Klik Create new

2. Isi Jalur Kunci Simpanan

   Peringatan

   Hal ini HARUS DISIMPAN - akan digunakan kemudian

3. Atur Kata Sandi Kunci Simpanan

   Catatan

   Saya merekomendasikan menggunakan kata sandi yang sama untuk Keystore dan Alias Kunci.

   Peringatan

   Hal ini IS DIPERLUKAN UNTUK DISIMPAN - akan digunakan kemudian

4. Isi sisa formulir

   1. Tetapkan Alias Kunci seperti itu (key0)
   2. Isi 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 untuk keystore telah diisi dengan benar dan klik pada Next

2. Pilih release Variasi pembangunan dan klik pada Create

3. Setelah pembangunan berhasil, Anda harus melihat layar berikut

   1. Pop-up ini menunjukkan bahwa pembangunan berhasil.
   2. Klik pada tombol locate tombol ini akan membuka eksplorasi file dan Anda harus melihat hasil pembangunan di sana.

4. Pastikan Anda dapat melihat hasil pembangunan di eksplorasi file

Membuat aplikasi di Console Toko Play

1. Lihat di Console Google Play

2. Pilih akun pengembang yang benar

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 Anda telah membuat aplikasi, Anda dapat membuat kelompok pengujian internal. Karena saya tidak akan mempublikasikan aplikasi untuk semua orang di Play Store, saya perlu membuat kelompok pengujian internal.

Catatan

Pengujian internal masih merupakan cara tercepat untuk menguji aplikasi sebelum peluncuran sebenarnya.

Jika akun pengembang Anda adalah akun pribadi yang dibuat setelah 13 November 2023, pengujian internal tidak menggantikan persyaratan pengujian tertutup untuk akses produksi. Anda masih perlu melakukan pengujian tertutup dengan setidaknya 12 pengujian yang telah memilih untuk 14 hari berturut-turut sebelum produksi. Lanjutkan ke Klik pada

1. Google Play Console pengujian internal internal testing Membuat pengujian internal masih merupakan cara tercepat untuk menguji aplikasi sebelum peluncuran sebenarnya. Test and release -> Testing -> Internal testing

   

2. Klik pada Testers

3. Klik pada Create email list

4. Berinama daftar email

5. Tambahkan alamat email pengujian

6. Tekan Enter dan klik pada Save

7. Klik pada Create group

8. Pastikan bahwa daftar baru dipilih dan klik pada Save

Mengunggah aplikasi ke kelompok pengujian internal

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

1. Lihat di 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 dibuat secara manual dengan Android Studio. Jika file ini tidak menggunakan keystore yang sama dengan yang akan digunakan untuk Capgo build, maka Capgo Native Build akan gagal.

6. Tunggu sampai file AAB diunggah

7. Klik pada Next

8. Perbaiki kesalahan

   Saya pribadi, di tahap ini saya melihat kesalahan ini

   

   Hal ini 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 uji internal.

10. Konfirmasikan publikasi

11. Pastikan aplikasi telah dipublikasikan

12. Dapatkan nama aplikasi sementara Anda

Terima undangan ke grup uji internal

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

1. Lanjutkan 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. Konfirmasi bahwa undangan telah diterima dan klik pada “download di Play Store”

6. Pasang aplikasi

   1. Jika Anda telah menginstal aplikasi sebelumnya menggunakan Android Studio, klik pada tombol uninstall tombol
   2. Klik pada tombol install Google Play Console pasang aplikasi
   3. Aplikasi telah terunduh dengan sukses dari Toko Play uji internal

   Peringatan

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

Mengatur Capgo Pembangunan Nativ (Android)

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

Persyaratan	Flag	Deskripsi	Diperlukan
File keamanan	--keystore <path>	Jalur ke file .jks/.keystore file yang digunakan untuk menandatangani APK/AAB.	Ya
Alias keystore	--keystore-alias <alias>	Nama alias kunci di dalam keystore.	Ya
Kata sandi kunci keystore	--keystore-key-password <password>	Kata sandi untuk kunci. Jika kata sandi kunci dan keystore sama, Anda hanya perlu memberikan satu.	Lihat catatan di bawah
Kata sandi keystore	--keystore-store-password <password>	Kata sandi untuk keystore. Jika kata sandi kunci dan keystore sama, Anda hanya perlu memberikan satu.	Lihat catatan di bawah
Akun layanan Google Play	--play-config <path>	File JSON akun layanan untuk unggahan ke Play Store.	Ya

bunx @capgo/cli 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 instruksi pembangunan manual, Anda seharusnya sudah memiliki keystore yang sudah dibuat. Jika Anda belum mengikuti instruksi, silakan mengikuti instruksi untuk mengenerate keystore. Jika kunci dan penyimpanan kata sandi sama, berikan hanya satu dariatau

Akun Layanan Google Play

Membuat akun layanan Google Play adalah proses manual dan kompleks. Namun, hal ini diperlukan untuk mengunggah aplikasi ke Google Play. Silakan perhatikan hal-hal berikut:

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

Mari kita mulai.

1. Buka Google Cloud Console

2. Klik pada pilihan proyek

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

   Catatan

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

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

4. Kliklah pada bar pencarian dan cari service accounts dan klik pada itu

5. Kliklah 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 mengaturnya menjadi capgo-native-build-service-acc
   3. Untuk deskripsi, Anda tidak perlu mengisi, tetapi saya merekomendasikan mengisi dengan Allows Capgo Native Build to build and submit the app to the Play Store

   

7. Klik pada akun layanan yang baru saja dibuat Anda seharusnya dapat melihat akun layanan yang baru saja dibuat dalam daftar. Klik pada itu.

   Catatan

   Salin alamat email ini juga, Anda akan membutuhkannya nanti.

8. Klik pada tab Keys tab

9. Klik pada Add Key dan Create new key

10. Klik pada JSON dan Create

    Peringatan

    Klik pada Create akan menciptakan kunci baru dan akan mengunduh file JSON ke mesin lokal Anda.

    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 Akses Play Store API ke akun layanan

Akun Layanan yang baru saja dibuat belum memiliki akses ke Toko Play API. Untuk mengizinkannya, kunjungi Console Toko Play.

1. Lihat di Console Pengembang Play Store
2. Pilih Akun Pengembang yang Benar
3. Klik pada Users and permissions
4. Klik pada Invite new users
5. Salin alamat email akun layanan
6. Pergi ke Account permissions dan berikan izin yang diperlukan minimal:
   • Dalam App permissions, berikan akses ke aplikasi Anda.
   • Dalam Releases, aktifkan Create, edit, and roll out releases.
   • Jika alur kerja Anda menggunakan Play App Signing, aktifkan izin penandatanganan terkait.
   • Jika Anda tidak yakin, gunakan Admin hanya selama pengaturan, kemudian kurangi izin kemudian.
7. Klik pada Invite user
8. Konfirmasi undangan
9. Konfirmasi bahwa pengguna telah diundang

Menghemat kredit

Anda sudah siap untuk menyimpan kredit dan menjalankan build pertama Anda. Anda dapat menyimpan kredit menggunakan perintah berikut:

bunx @capgo/cli 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

Konfigurasi CI/CD (GitHub Aksi)

Jika Anda sudah menyelesaikan Kunci Simpanan, kata sandi kunci simpanan, kata sandi kunci simpanan, alias kunci simpanan dan akun layanan Google Play, Anda sudah memiliki semua yang dibutuhkan untuk CI/CD. Bagian ini hanya membahas cara mengirimkan nilai-nilai tersebut sebagai rahasia GitHub Actions dan variabel lingkungan.

1) Konversi file kredit ke nilai base64 tunggal 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

Tip

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 keamanan dari Kunci keamanan, kata sandi keamanan, kata sandi kunci keamanan, alias kunci keamanan
KEYSTORE_KEY_PASSWORD	Kata sandi kunci keamanan
KEYSTORE_STORE_PASSWORD	Kata sandi penyimpanan keystore
PLAY_CONFIG_JSON	Isi dari play_config_base64.txt

Catatan

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

3) Gunakan variabel lingkungan di workflow GitHub Anda di Actions

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 ${{ 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 konfigurasi ini, CI mengirimkan kredit melalui variabel lingkungan saja. Anda tidak perlu mengkomit file tanda tangan atau mengunggahnya sebagai artefak alur kerja.

Membangun

Selamat! Anda siap untuk menjalankan build pertama Anda.

Jalankan:

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

Dan ini akan memulai proses build 🍾🥂