Buat Android

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

Apa yang Anda Pelajari

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

Persyaratan Sebelumnya

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

Catatan

Aplikasi berikut akan digunakan dalam tutorial ini: https://github.com/Cap-go/capgo-native-build-tutorial-app

Dianjurkan: pendaftaran otomatis

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

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

Langkah manual di bawah ini hanya untuk mereka yang lebih suka mengatur kredit sendiri, atau ingin memahami secara spesifik apa yang Capgo lakukan di balik layar.

Langkah manual pertama

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

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

Membangun aplikasi manual dengan Android Studio

Sebelum kita bisa membangun aplikasi dengan Capgo, kita perlu membangun aplikasi 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

Klik pada

1. Android Studio membuat keystore baru Create new

2. Fill in the Key Store path

   Peringatan

   Ini DIPERLUKAN UNTUK DISIMPAN - 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 IS TO BE SAVED - akan digunakan kemudian

4. Isi sisa formulir

   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 untuk keystore telah diisi dengan benar dan klik pada Next

2. Pilih release Studio Android pilih varian build rilis Create

3. Studio Android setelah build berhasil

   1. Klik pada
   2. tombol ini - ini akan membuka explorer file dan Anda harus melihat build di sana. locate Pastikan Anda dapat melihat build di explorer file

4. Studio Android pastikan Anda dapat melihat build di explorer file

Membuat aplikasi di Console Toko Play

1. Klik 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

Pengujian internal masih merupakan cara tercepat untuk menguji asap bangunan Anda sebelum peluncuran nyata.

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 memerlukan pengujian tertutup dengan setidaknya 12 pengujian yang dipilih untuk 14 hari berturut-turut sebelum produksi. Lihat Klik pada

1. Google Play Console pengujian internal internal testing Klik pada Test and release -> Testing -> Internal testing

   

2. Klik pada Testers

3. Berinama daftar email Create email list

4. Klik pada

5. Tambahkan alamat email dari para tester

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 grup pengujian internal

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

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

2. Klik pada tombol Releases Google Play Console releases button

3. Google Play Console create new release Create new release

4. Google Play Console upload Upload

5. Google Play Console select AAB file

   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 file AAB untuk diunggah

7. Klik pada Next

8. Perbaiki kesalahan

   Secara pribadi, pada 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 Aplikasi ini akan dipublikasikan ke grup pengujian internal.

10. Konfirmasikan publikasi

11. Pastikan aplikasi telah dipublikasikan

12. Dapatkan nama aplikasi sementara Anda

Terima undangan ke grup uji coba internal

Sekarang Anda telah mengunggah aplikasi ke grup uji coba internal, Anda dapat menerima undangan ke grup uji coba 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. Pastikan 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 uninstall Button
   2. Klik pada tombol install tombol
   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 Asli. Selamat 🎉!

Persyaratan	Flag	Deskripsi	Diperlukan
File keamanan keystore	--keystore <path>	Jalur ke file Anda .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/toko sesuai, Anda hanya perlu memberikan satu.	Lihat catatan di bawah
Kata sandi penyimpanan keystore	--keystore-store-password <password>	Kata sandi untuk keystore. Jika kata sandi kunci/toko sesuai, Anda hanya perlu memberikan satu.	Lihat catatan di bawah
Akun layanan Google Play	--play-config <path>	File JSON akun layanan untuk unggahan ke Toko Play.	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 kunci dan kata sandi penyimpanan sama, berikan hanya salah satu --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 menghasilkan keystore. Akun layanan Google PlayBagian berjudul “Akun layanan Google Play”

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

DIPERLUKAN

• Jika kunci dan kata sandi penyimpanan sama, berikan hanya salah satu atau untuk menjadi pemilik Akun Pengembang kecuali Anda tidak akan dapat mengatur akun layanan.Anda perlu membuat proyek Google Cloud baru (terpisah dari akun Google Play Anda)
• Mari kita mulai.

Pergi ke

1. Google Cloud Console Klik pada pemilih proyek

2. Pemilih Proyek Google Console

3. Catatan

   __CAPGO_KEEP_0__

   Gambar-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. Mari kita klik pada bar pencarian dan cari untuk service accounts dan klik pada tombolnya

5. Mari 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. Saat itu deskripsi, Anda tidak perlu mengisi, tapi 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 melihat akun layanan yang baru saja dibuat dalam daftar. Klik pada

   Catatan

   Salin alamat email ini juga, Anda akan membutuhkannya nanti.

8. Klik pada tab Keys Google Console

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.

    Anda perlu menyimpan file JSON di tempat yang aman. akan digunakan kemudian. Unduh file JSON File JSON harus telah diunduh secara otomatis. Anda dapat mengklik pada

11. untuk menutup jendela. close Kunci Download Google Console

Judul Bagian “Mengizinkan Toko Play API untuk mengakses akun layanan”

The newly created service account does not yet have access to the Play Store API. To grant it, head to the Play Store Console.

1. Console Google Play Pilih akun pengembang yang benar
2. Console Google Play pilih akun pengembang yang benar
3. Klik pada Users and permissions
4. Klik pada Invite new users
5. Salin alamat email akun layanan
6. Buka 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 aliran kerja Anda menggunakan Play App Signing, aktifkan izin terkait.
   • Jika Anda tidak yakin, gunakan Admin hanya selama pengaturan, kemudian kurangi izin setelahnya.
7. Klik pada Invite user
8. Konfirmasi undangan
9. Konfirmasi bahwa pengguna telah diundang

Menghemat kredensial

Sekarang Anda sudah siap untuk 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 Play, Anda sudah memiliki semua yang dibutuhkan untuk CI/CD. Pengaturan ini hanya membahas cara mengirim nilai-nilai tersebut sebagai rahasia GitHub Aksi dan variabel lingkungan.

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

Tips

GitHub rahasia harus memiliki nilai satu baris. tr -d '\n' menghilangkan baris-baris dari output base64.

2) Buat rahasia repository

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

Nama rahasia	Nilai rahasia
CAPGO_TOKEN	Token Anda Capgo API
APP_ID	ID aplikasi Anda (contoh: Capgo) 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 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 dari KEYSTORE_KEY_PASSWORD atau KEYSTORE_STORE_PASSWORD.

3) Gunakan variabel lingkungan di alur kerja Anda GitHub

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

Menggunakan build

Selamat! 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 🍾🥂

Kirimkan rilis Play untuk tinjauan

Dengan default, rilis Android upload ke Google Play dan dapat tetap tidak aktif hingga Anda selesai dengan rilis di Console Play. Jika rilis CI Anda harus mengirimkan rilis Play secara otomatis, lakukan --submit-to-store-review Dengan rilis pembangunan:

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --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"

Hal ini memerlukan pengaturan layanan Google Play yang sama seperti jalur upload normal (PLAY_CONFIG_JSON di CI atau kredit Android yang disimpan secara lokal). --store-release-name digunakan sebagai nama rilis Play. --store-release-notes adalah catatan perubahan Play cadangan, dan setiap --store-release-notes-locale "locale=notes" Membuat catatan perubahan Play yang terlocalisasi untuk bahasa tersebut. Capgo mengirimkan rilis Play sebagai completed; 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, hubungkan dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Pembangunan Native untuk alur kerja produk di Capgo Pembangunan Native, Capgo Integrasi untuk alur kerja produk di Integrasi Capgo Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan Integrasi GitHub Aksi untuk detail implementasi di Integrasi GitHub Aksi.