Buat Android

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

Apakah yang akan Anda pelajari

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

Prasyarat

• Anda perlu memiliki akun pengembang Google yang 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: pendaftaran otomatis

Anda tidak perlu melakukan semua ini secara manual. Pendaftaran otomatis Capgo menciptakan dan mengonfigurasi kunci tanda tangan Android (keystore + akun layanan Google Play) untuk Anda — 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 kerangka kerja.

Pembangunan manual pertama

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

• Anda akan mempersiapkan kunci tanda tangan untuk pembangunan Capgo yang akan datang
• Anda akan membuat catatan di Console Toko Play

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 masih kekurangan file keystore. File ini digunakan untuk menandatangani aplikasi Anda, sehingga Google tahu bahwa itu Anda yang membuat aplikasi tersebut. Untuk menghasilkannya, kami akan menggunakan metode GUI yang disediakan oleh Android Studio. Terdapat 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 Keystore

   Peringatan

   Ini HARUS DISIMPAN - akan digunakan kemudian

3. Setel Kata Sandi Key Store

   Peringatan

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

   Peringatan

   Ini UNTUK DIPERHATIKAN - akan digunakan kemudian

4. Isi sisa formulir

   1. Tetapkan Key Alias 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 Pilih varian pembangunan dan klik pada Create

3. Setelah pembangunan berhasil, Anda harus melihat layar berikut

   1. Pop-up ini menunjukkan bahwa build berhasil.
   2. Klik pada tombol - ini akan membuka eksplorer file dan Anda harus melihat build di sana. locate Pastikan Anda dapat melihat build di eksplorer file

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

Bab berjudul “Membuat aplikasi di Console Toko Play”

1. Console Play Google Pilih akun pengembang yang benar

2. Console Play Google 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 kebutuhan pengujian tertutup untuk akses produksi. Anda masih perlu membuat pengujian tertutup dengan setidaknya 12 pengujian yang telah memilih untuk 14 hari berturut-turut sebelum produksi.

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

   

2. Klik pada Testers

3. Klik pada Create email list

4. Berinama Daftar Alamat Email

5. Tambahkan Alamat Email Pengujian

6. Tekan Enter dan klik pada Save

7. Klik pada Create group

8. Pastikan daftar baru dipilih dan klik pada Save

Mengunggah aplikasi ke grup pengujian internal

Sekarang Anda telah membuat grup pengujian internal, Anda dapat mengunggah aplikasi ke grup 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 Build Native akan gagal.

6. Tunggu sampai file AAB diunggah

7. Klik pada Next

8. Perbaiki kesalahan

   Secara pribadi, pada tahap ini saya melihat kesalahan ini

   

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

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

10. Konfirmasikan publikasi

11. Pastikan aplikasi telah diterbitkan

12. Ambil 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. Pergi ke Test and release -> Testing -> Internal testing

2. Pilih pada Testers

3. Pilih pada Copy link

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

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

6. Pasang aplikasi

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

   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 aplikasi	--keystore <path>	Jalur ke file .jks/.keystore file yang digunakan untuk menandatangani APK/AAB.	Yes
Alias Keystore	--keystore-alias <alias>	Nama alias kunci di dalam keystore.	Yes
Kata sandi kunci Keystore	--keystore-key-password <password>	Kata sandi untuk kunci. Jika kata sandi kunci dan keystore sama, Anda hanya perlu memberikan satu.	Perhatikan 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.	Perhatikan catatan di bawah.
Akun Layanan Google Play	--play-config <path>	File JSON akun layanan untuk unggahan 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 kata kunci dan kata sandi toko sama, berikan hanya salah 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 harus sudah memiliki keystore yang sudah dibuat. Jika Anda belum mengikuti instruksi, silakan mengikuti instruksi untuk membuat keystore.

Penggunaan Layanan Google Play

Membuat penggunaan Layanan Google Play adalah proses manual dan kompleks. Namun, hal ini diperlukan untuk mengunggah aplikasi ke Google Play. Silakan memperhatikan hal-hal berikut:

• anda context perlu menjadi pemilik Akun Pengembang. Jika tidak, Anda tidak akan dapat mengatur penggunaan Layanan Google Play.
• Anda perlu membuat proyek baru di Google Cloud (terpisah dari Akun Google Play Anda)

Mari kita mulai.

1. Pergi ke Google Cloud Console

2. Pilih Pilih Projek

3. Jika Anda sudah memiliki projek, pilihnya. Jika tidak, buat projek baru:

   Catatan

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

   1. Pilih New project
   2. Berikan nama projek dan pilih Create
   3. Pastikan Anda berada di projek yang benar

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

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 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 yang baru dibuat Anda seharusnya dapat melihat akun layanan yang baru dibuat di daftar. Klik pada akun tersebut.

   Perlu diingat

   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

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

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

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

Mengizinkan Toko Play API untuk mengakses akun layanan

Jika akun layanan baru yang dibuat belum memiliki akses ke Toko Play API, Anda perlu mengizinkannya. Untuk itu, kunjungi Console Toko Play.

1. Perlu dilakukan Toko Play Console
2. Pilih akun pengembang yang tepat
3. Dengan menekan tombol Users and permissions
4. Dengan menekan tombol Invite new users
5. Salin alamat email akun layanan
6. Pergi ke Account permissions dan berikan izin yang diperlukan minimal:
   • Pada App permissions, berikan akses ke aplikasi Anda.
   • Pada Releases, aktifkan Create, edit, and roll out releases.
   • Pada
   • , aktifkan izin tanda tangan terkait jika alur kerja Anda menggunakan Play App Signing. Admin Jika Anda tidak yakin, gunakan
7. Google Play Console berikan izin Invite user
8. Mengonfirmasi undangan
9. Mengonfirmasi bahwa pengguna telah diundang

Menyimpan kredential

Anda sudah siap untuk menyimpan kredential dan menjalankan build pertama Anda. Anda dapat menyimpan kredential 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 PlayUntuk CI/CD, Anda sudah memiliki semua yang dibutuhkan. Bagian ini hanya menjelaskan cara mengirimkan nilai-nilai tersebut sebagai rahasia GitHub dan variabel lingkungan.

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

Rahasia GitHub harus berupa nilai tunggal baris. tr -d '\n' menghilangkan baris-baris dari hasil base64.

Membuat 2) Repository Rahasia

Di 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	Sandi keystore
PLAY_CONFIG_JSON	Isi dari play_config_base64.txt

Pertahankan

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

3) Use env vars in your GitHub Actions workflow

Bab 3) Gunakan variabel lingkungan di dalam github Actions workflow Anda

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 }}

Saran

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

Melakukan pembangunan

Hore! Anda sudah siap untuk menjalankan pembangunan pertama Anda.

Run:

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

Dan ini akan memulai proses pembangunan 🍾🥂

Kirimkan rilis Play untuk tinjauan

Dengan default, pembangunan rilis Android mengunggah ke Google Play dan dapat tetap tidak aktif sampai Anda menyelesaikan rilis di Console Play. Jika rilis CI Anda harus mengirimkan rilis Play secara otomatis, tambahkan --submit-to-store-review bersama pembangunan 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

Pada Android, --submit-to-store-review berlaku secara default pada produksi context: Halaman/area: Halaman produk produk live update. Peran: Label UI singkat atau item navigasi. Kunci pesan `live_update_dynamic_label_production` (Label Dinamis Live Update Produksi). release_status: completed mengikuti dengan --android-track internal ketika Anda tidak menetapkan track. Hal itu dapat langsung tayang ke 100% pengguna. Pass alpha / beta(atau PLAY_STORE_TRACK ) — atau tetapkan --android-release-status / PLAY_STORE_RELEASE_STATUS ketika Anda membutuhkan status yang berbeda dari completed.

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

Teruskan dari Android Builds

Jika Anda menggunakan Android Builds untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo Otomatisasi CI/CD untuk alur kerja produk di Capgo Otomatisasi CI/CD, Capgo Pembangunan Nativ untuk alur kerja produk di Capgo Pembangunan Nativ, Capgo Integrasi for the product workflow in Capgo Integrations, untuk alur kerja produk di __CAPGO_KEEP_0__ Integrasi, Integrasi CI/CD GitHub Actions Integration for the implementation detail in GitHub Actions Integration.