Bangun Android

Membangun dan mengirimkan aplikasi Android ke Google Play Store menggunakan infrastruktur Capgo yang terintegrasi.

Apa yang Anda akan pelajari

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

Prerequisites

• Anda perlu memiliki akun pengembang Google yang aktif
• Perlu terlebih dahulu menginstal Android Studio
• 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-aplikasi

Dianjurkan: onboarding otomatis

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

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

Walkthrough manual di bawah ini hanya untuk mereka yang lebih suka mengatur kunci tanda tangan sendiri, atau ingin memahami secara spesifik apa yang dilakukan Capgo di bawah permukaan.

Pembangunan Manual Pertama

Sebelum kita bisa memulai berpikir tentang pembangunan aplikasi dengan Capgo, kita harus terlebih dahulu mengatur dan melakukan pembangunan Android pertama secara manual. Ada beberapa kelebihan melakukan pembangunan manual pertama:

• Kamu akan menyiapkan kredential untuk pembangunan Capgo yang akan datang
• Kamu akan membuat catatan di Console Toko Permainan

Membangun Aplikasi Secara Manual dengan Android Studio

Sebelum kita bisa memulai pembangunan 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 Kunci Rahasia

Saat ini, Anda kehilangan file kunci rahasia. 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 Studio Android. Ada juga cara untuk melakukan ini dengan menggunakan baris perintah, tetapi kami tidak akan menutupinya dalam tutorial ini.

1. Klik pada Create new

2. Isi Jalur Toko Kunci

   Peringatan

   Ini HARUS DI SIMPAN - akan digunakan kemudian

3. Atur Kata Sandi Key Store

   Catatan

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

   Peringatan

   Ini UNTUK DISIMPAN - akan digunakan kemudian

4. Penuhi bagian formulir lainnya

   1. Tetapkan Alias Kunci sebagai apa adanya (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 keystore telah diisi dengan benar dan klik pada Next

2. Pilih release Pilih varian pembangunan dan klik Create

3. Setelah pembangunan berhasil, Anda harus melihat layar berikut

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

4. Pastikan Anda dapat melihat hasil build di eksplor file

Membuat Aplikasi di Console Toko Play

1. Pergi ke Google Play Console

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 Toko Play, saya perlu membuat kelompok pengujian internal.

Catatan

Pengujian internal masih merupakan cara tercepat untuk menguji asap (menguji) aplikasi Anda yang didistribusikan melalui Play sebelum peluncuran nyata.

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

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

   

2. Klik pada Testers

3. Klik pada Create email list

4. Berikan Nama pada Daftar Email

5. Tambahkan alamat email pengujung

6. Tombol Enter dan klik pada Save

7. Tombol Klik Create group

8. Pastikan bahwa daftar baru dipilih dan klik pada Save

Mengunggah aplikasi ke grup pengujian internal

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

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

2. Klik pada tombol 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

   Pribadi, pada tahap ini saya melihat kesalahan ini

   

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

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

10. Konfirmasikan publikasi

11. Pastikan Aplikasi Anda Sudah Diterbitkan

12. Dapatkan Nama Aplikasi Sementara Anda

Terima Undangan untuk Grup Uji Internal

Sekarang Anda sudah mengunggah aplikasi ke grup uji internal, Anda bisa menerima undangan untuk grup uji internal.

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

2. Klik pada Testers

3. Klik pada Copy link

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

5. Pastikan undangan telah diterima dan klik pada “download di Play Store”

6. Instal aplikasi

   1. Jika Anda telah menginstal aplikasi sebelumnya menggunakan Android Studio, klik pada tombol uninstall button
   2. Klik pada 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 siap untuk memulai pengaturan Capgo Pembangunan Asli. Selamat 🎉!

Persyaratan	Bendera	Deskripsi	Diperlukan
File keamanan	--keystore <path>	Jalur ke file .jks/.keystore file yang digunakan untuk menandatangani APK/AAB.	Ya
Nama alias keamanan	--keystore-alias <alias>	Nama alias kunci di dalam file keamanan.	Ya
Kata sandi kunci keamanan	--keystore-key-password <password>	Kata sandi untuk kunci. Jika kata sandi kunci dan keamanan sama, Anda hanya perlu memberikan satu.	Lihat catatan di bawah
Kunci simpan keystore	--keystore-store-password <password>	Kata sandi keystore. Jika kata sandi kunci dan toko sama, Anda hanya perlu memberikan satu.	Lihat catatan di bawah
Akun layanan Google Play	--play-config <path>	File akun layanan JSON untuk unggah 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 kunci dan toko sama, Anda hanya perlu memberikan 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 Instruksi Pembangunan Manualanda seharusnya sudah memiliki keystore yang sudah dibuat. Jika Anda belum mengikuti instruksi, silakan mengikuti instruksi untuk membuat keystore.

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 context perlu menjadi pemilik Akun PengembangJika 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 Google Cloud Console

2. Pilih selector 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. Pilih New project
   2. Berikan nama proyek Anda dan klik Create
   3. Pastikan Anda berada di proyek yang tepat

4. Kliklah di bar pencarian dan cari service accounts dan klik di dalamnya

5. Klik di sini Create service account

6. Isi formulir untuk akun layanan dan klik di 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. 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 baru yang telah dibuat Anda seharusnya dapat melihat akun layanan baru yang telah dibuat dalam daftar. Klik pada akun tersebut.

   Penting

   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

    Mengklik Create akan membuat kunci baru dan akan mengunduh file JSON ke mesin lokal Anda.

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

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

Mengizinkan Akses Toko Play API ke akun layanan

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

1. Kunjungi Console Google Play
2. Pilih akun pengembang yang benar
3. Mengklik pada Users and permissions
4. Klik pada Invite new users
5. Copy the email address of the service account
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 tanda tangan terkait.
   • Jika Anda tidak yakin, gunakan Admin selama proses pengaturan, kemudian kurangi izin setelahnya.
7. Klik pada Invite user
8. Konfirmasi Undangan
9. Konfirmasi bahwa pengguna telah diundang

Menyimpan Kredensial

Anda siap menyimpan kredit dan menjalankan build pertama Anda. Anda dapat menyimpan kredit 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 Anda 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 GitHub Actions 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 satu baris. tr -d '\n' menghilangkan baris-baris bawah dari output base64.

2) Buat rahasia repository

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

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

Catatan

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

3) Gunakan variabel lingkungan di dalam GitHub Actions workflow Anda

.github/kerjaan/kerjaan-android.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 }}

Tip

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

Menggunakan proses build

Selamat! Anda siap untuk menjalankan build pertama Anda.

Jalankan:

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

Dan ini akan memulai proses build 🍾🥂

Kirimkan rilis Play untuk tinjauan

Dengan default, rilis Android akan mengunggah ke Google Play dan dapat tetap tidak aktif hingga Anda menyelesaikan rilis di Console Play. Jika rilis CI Anda harus mengirimkan rilis Play secara otomatis, tambahkan --submit-to-store-review di rilis dengan build:

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

Pada Android, --submit-to-store-review berlaku pada track produksi mengikuti release_status: completed ketika Anda tidak menetapkan track. Itu bisa langsung tayang ke 100% pengguna. Pass --android-track internal (atau alpha / betacontext PLAY_STORE_TRACK gunakan CI — untuk mempertahankan rilis yang sudah selesai pada jalur non-produksi. Gunakan --android-release-status / PLAY_STORE_RELEASE_STATUS ketika Anda membutuhkan status yang berbeda dari completed.

Perlu pengaturan akun layanan Google Play yang sama seperti jalur unggah normal (PLAY_CONFIG_JSON Dalam CI atau menyimpan kredit Android secara lokal). --store-release-name in CI atau kredensial Android yang disimpan secara lokal). version_name. --store-release-notes digunakan sebagai Google Play --store-release-notes-locale "locale=notes" entry menulis riwayat perubahan Play yang terlocalisasi untuk lokasi tersebut. Capgo mengirimkan rilis Play sebagai completed kecuali Anda menggantinya --android-release-statusJika publikasi terkelola diaktifkan di Console Play, Google masih dapat menunggu publikasi manual Anda setelah disetujui.

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 Otomatisasi CI/CD, Capgo Pembangunan Native untuk alur kerja produk di Capgo Pembangunan Native, Capgo Integrasi Untuk alur kerja produk di Capgo Integrations, untuk alur kerja produk di __CAPGO_KEEP_0__ Integrasi, untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi.