Pembangunan Otomatis Android dengan Capacitor dan GitHub

Setting up CI/CD untuk aplikasi Capacitor dapat kompleks dan memakan waktu. Berikut ini yang perlu Anda ketahui:

Dianjurkan untuk Pembangunan Baru: Gunakan Capgo Build

Sekarang kami merekomendasikan menggunakan Capgo Build dengan Capgo CLI untuk pembangunan native Capacitor. Petunjuk ini untuk Fastlane ini masih dipertahankan untuk tim yang menjaga pipeline aksi GitHub yang sudah ada, tetapi pembangunan Android baru harus menggunakan Capgo CLI sehingga Anda tidak perlu menjaga Fastlane, runner Gradle, file keystore, dan skrip unggah sendiri.

Prasyarat

Sebelum memulai, Anda perlu mengatur:

• Akun GitHub dengan akses admin
• Aplikasi Anda sudah dipublikasikan di Google Play Store dengan tanda tangan yang tepat
• Kunci tanda tangan Android dan file keystore
• Project Google Cloud Console dengan API Play Store diaktifkan
• Akun layanan dengan izin yang tepat
• Pengertian tentang GitHub Tindakan alur kerja
• Pengetahuan tentang konfigurasi Fastlane
• Waktu untuk memelihara dan mengdebug pipeline

Capgo Bangun untuk CI/CD oleh Capgo

Lebihkan Fastlane, runner Gradle, keystore, dan skrip unggah. Capgo Bangun Menghasilkan bangun native Android yang ditandatangani dari pipeline CI/CD yang ada:

• Kompatibel dengan pipeline Anda: Aktifkan Capgo Bangun dari GitHub Tindakan, GitLab CI, Jenkins, atau skrip lokal setelah bangun web Anda dan npx cap sync.
• Tanda tangan dari rahasia CI: Simpan keystore Android, alias kunci, kata sandi, dan akun layanan Console Play di rahasia CI Anda sendiri.
• Tidak ada pemeliharaan runner asli: Capgo Build menyediakan lingkungan pembangunan Android yang terjaga, sehingga Anda tidak perlu mengelola SDK gambar, masalah cache Gradle, atau jalur Fastlane.
• Artikel dan pengiriman: Unduh artefak yang ditandatangani untuk QA atau kirimkan rilis melalui Capgo CLI.

Pengaturan Harga

• Capgo rencana mulai dari $12/bulan
• Termasuk pembaruan OTA dan sekitar 15 pembangunan asli per bulan
• Menit pembangunan tambahan dikenakan biaya per menit melalui kredit

Atur Capgo Build di CI/CD

Petunjuk Manual Pengaturan

Berikut yang perlu Anda lakukan:

GitHub Aksi Pengaturan Harga

GitHub Aksi menawarkan menit gratis berdasarkan jenis repositori Anda:

• __CAPGO_KEEP_0__ Aksi menawarkan menit gratis berdasarkan jenis repositori Anda:
• Repositori publik: 2.000 menit/bulan

Repositori pribadi: 2.000 menit/bulan (pengguna Linux)

Untuk proyek pribadi, biaya sekitar $0,008/menit. Pembangunan biasanya memakan waktu 3-5 menit.

1. Langkah-Langkah Pengaturan Tangan
2. Buat Keystore Android
3. Atur Akun Layanan Google Play
4. Configure GitHub secrets
5. Konfigurasi rahasia GitHub

Buat alur kerja __CAPGO_KEEP_0__ Aksi

Sebelum Anda dapat menandatangani dan mempublikasikan aplikasi Android Anda, Anda perlu membuat file keystore. Ini adalah pengaturan satu kali.

Buat Keystore dengan keytool

Jalankan perintah ini di terminal Anda:

keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

Anda akan diminta untuk:

• Kata sandi keystore: Pilih kata sandi yang kuat (Anda akan membutuhkannya sebagai KEYSTORE_STORE_PASSWORD)
• Kata sandi kunci: Pilih kata sandi yang kuat (Anda akan membutuhkannya sebagai KEYSTORE_KEY_PASSWORD)
• Nama Anda, organisasi, dll.: Isi detail Anda

Catatan Penting

• Simpan nilai-nilai ini dengan aman:

  • Lokasi file keystore (misalnya, my-release-key.keystore)
  • Alias kunci (misalnya, my-key-alias) - Anda memerlukan ini sebagai KEYSTORE_KEY_ALIAS
  • Kata sandi keystore - Anda memerlukan ini sebagai KEYSTORE_STORE_PASSWORD
  • Kata sandi kunci - Anda memerlukan ini sebagai KEYSTORE_KEY_PASSWORD

• Cetak ulang file keystore : Jika Anda kehilangannya, Anda tidak dapat memperbarui aplikasi Anda yang telah dipublikasikan

• Jaga rahasia : Tidak pernah komit file keystore ke git

• Simpan dengan aman : Simpan beberapa salinan cadangan di lokasi yang aman

Alternatif: Gunakan Keystore yang Sudah Ada

Jika Anda sudah menerbitkan aplikasi, Anda harus menggunakan keystore yang sama yang digunakan awalnya. Anda bisa menemukannya:

• Di mesin lokal Anda di mana Anda pertama kali membangun aplikasi
• Di Console Play Anda → Pengaturan → Tanda tangan aplikasi (jika menggunakan Tanda tangan aplikasi Google Play)

2. Atur Akun Layanan Google Play

Untuk memungkinkan GitHub Aksi mengunggah build ke Google Play, Anda membutuhkan akun layanan.

Langkah 2.1: Buat Project Google Cloud

1. Buka Google Cloud Console
2. Buat proyek baru atau pilih salah satu yang sudah ada
3. Catat ID proyek

Langkah 2.2: Aktifkan Pengembang Google Play API

1. Di Google Cloud Console, buka Jasa API → Perpustakaan
2. Cari “Google Play Android Developer API”
3. Klik Aktifkan

Langkah 2.3: Buat Akun Layanan

1. Lihat IAM & Admin → Akun Layanan
2. Klik Buat Akun Layanan
3. Masukkan detail:
   • Nama: github-actions-uploader
   • Deskripsi: “Akun layanan untuk GitHub Aksi untuk mengunggah build”
4. Klik Buat dan Lanjutkan
5. Lepaskan peran untuk saat ini (klik Lanjutkan, kemudian Selesai)

Langkah 2.4: Buat Kunci Akun Layanan

1. Klik pada akun layanan yang baru dibuat
2. Pergi ke Kunci tab
3. Klik Tambah Kunci → Buat kunci baru
4. Pilih Format JSON Klik
5. Buat File JSON akan diunduh - simpanlah ini dengan aman
6. Anda akan membutuhkannya nanti __CAPGO_KEEP_0____CAPGO_KEEP_1__

Langkah 2.5: Berikan Akses di Play Console

1. Pergi ke Google Play Console
2. Pergi ke Pengaturan → API akses
3. Di bawah Akun layanan, klik Berikan akses untuk akun layanan Anda
4. Pada Izin Aplikasi tab, tambahkan aplikasi Anda
5. Di Izin Akun tab, berikan izin ini:
   • Lihat informasi aplikasi dan download laporan bulk (hanya baca)
   • Buat, edit, dan hapus aplikasi draft
   • Rilis aplikasi ke jalur pengujian
   • Rilis aplikasi ke produksi, kecuali, dan jalur lainnya
6. Klik Undang pengguna
7. Klik Kirim undangan

Langkah 2.6: Verifikasi Kunci JSON

File JSON yang diunduh harus terlihat seperti ini:

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "...",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "github-actions-uploader@your-project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "..."
}

Anda akan mengonversi ini ke base64 di langkah pengaturan rahasia GitHub.

3. Atur Fastlane

Buat sebuah fastlane folder di root proyek Anda dan tambahkan sebuah Fastfile dengan konten ini:

default_platform(:android)

KEYSTORE_KEY_ALIAS = ENV["KEYSTORE_KEY_ALIAS"]
KEYSTORE_KEY_PASSWORD = ENV["KEYSTORE_KEY_PASSWORD"]
KEYSTORE_STORE_PASSWORD = ENV["KEYSTORE_STORE_PASSWORD"]

platform :android do
    desc "Deploy a beta version to the Google Play"
    private_lane :verify_changelog_exists do |version_code: |
      changelog_path = "android/metadata/en-US/changelogs/#{version_code}.txt"
      UI.user_error!("Missing changelog file at #{changelog_path}") unless File.exist?(changelog_path)
      UI.message("Changelog exists for version code #{version_code}")
    end

    private_lane :verify_upload_to_staging do |version_name: |
      UI.message "Skipping staging verification step"
    end
    
    lane :beta do
        keystore_path = "#{Dir.tmpdir}/build_keystore.keystore"
        File.write(keystore_path, Base64.decode64(ENV['ANDROID_KEYSTORE_FILE']))
        json_key_data = Base64.decode64(ENV['PLAY_CONFIG_JSON'])
        
        # Get previous build number and increment
        previous_build_number = google_play_track_version_codes(
            package_name: ENV['DEVELOPER_PACKAGE_NAME'],
            track: "internal",
            json_key_data: json_key_data,
        )[0]
        current_build_number = previous_build_number + 1
        sh("export NEW_BUILD_NUMBER=#{current_build_number}")
        
        # Build the app
        gradle(
          task: "clean bundleRelease",
          project_dir: 'android/',
          print_command: false,
          properties: {
            "android.injected.signing.store.file" => "#{keystore_path}",
            "android.injected.signing.store.password" => "#{KEYSTORE_STORE_PASSWORD}",
            "android.injected.signing.key.alias" => "#{KEYSTORE_KEY_ALIAS}",
            "android.injected.signing.key.password" => "#{KEYSTORE_KEY_PASSWORD}",
            'versionCode' => current_build_number
          })
        
        # Upload to Play Store
        upload_to_play_store(
            package_name: ENV['DEVELOPER_PACKAGE_NAME'],
            json_key_data: json_key_data,
            track: 'internal',
            release_status: 'completed',
            skip_upload_metadata: true,
            skip_upload_changelogs: true,
            skip_upload_images: true,
            skip_upload_screenshots: true,
        )
    end
end

4. Konfigurasi Rahasia GitHub

Sekarang Anda telah memiliki keystore dan JSON akun layanan, Anda perlu menyimpannya secara aman di GitHub.

Langkah 4.1: Akses Rahasia GitHub

1. Buka repository Anda di GitHub
2. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ → __CAPGO_KEEP_2__ → __CAPGO_KEEP_3__
3. __CAPGO_KEEP_4__ __CAPGO_KEEP_5__

Langkah 4.2: Tambahkan Rahasia yang Diperlukan

Tambahkan masing-masing rahasia satu per satu:

PLAY_CONFIG_JSON

1. Ambil file JSON akun layanan yang Anda download pada Langkah 2.4
2. Konversi ke base64:

Pada macOS/Linux:

base64 service_account_key.json | pbcopy

Di Windows (PowerShell):

[Convert]::ToBase64String([IO.File]::ReadAllBytes("service_account_key.json")) | Set-Clipboard

3. Buat rahasia baru bernama PLAY_CONFIG_JSON dan tempelkan string base64

__CAPGO_KEEP_0__

1. Konversi keystore Anda ke base64:

Di macOS/Linux:

base64 my-release-key.keystore | pbcopy

Di Windows (PowerShell):

[Convert]::ToBase64String([IO.File]::ReadAllBytes("my-release-key.keystore")) | Set-Clipboard

2. Buat rahasia baru bernama ANDROID_KEYSTORE_FILE dan tempelkan string base64

__CAPGO_KEEP_1__

Buat rahasia baru dengan alias kunci yang Anda gunakan ketika menghasilkan keystore (misalnya, my-key-alias)

Buat rahasia baru dengan kata sandi kunci yang Anda gunakan ketika menghasilkan keystore (misalnya,

Buat rahasia baru dengan kunci kata sandi yang Anda tetapkan ketika menghasilkan keystore

__CAPGO_KEEP_0__

Buat rahasia baru dengan kata sandi keystore yang Anda tetapkan ketika menghasilkan keystore

__CAPGO_KEEP_1__

Buat rahasia baru dengan nama paket aplikasi Anda (misalnya, com.example.app)

Anda dapat menemukan nama paket Anda di android/app/build.gradle bawah applicationId

Langkah 4.3: Pastikan Semua Rahasia

Pastikan Anda telah mengonfigurasi 6 rahasia ini:

• ✅ PLAY_CONFIG_JSON
• ✅ ANDROID_KEYSTORE_FILE
• ✅ KEYSTORE_KEY_ALIAS
• ✅ KUNCI SANDI KEYSORE
• ✅ KUNCI SANDI TOKO KEYSORE
• ✅ NAMA PAKET PENGEMBANG

5. Buat GitHub Workflow Aksi

Buat .github/workflows/build-upload-android.yml:

name: Build and Deploy Android App

on:
  push:
    tags:
      - '*'

jobs:
  build_android:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 24
          cache: npm
          
      - name: Install dependencies
        run: npm ci
        
      - name: Cache Gradle
        uses: actions/cache@v5
        with:
          path: |
            ~/.gradle/caches
            ~/.gradle/wrapper
          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
          restore-keys: |
            ${{ runner.os }}-gradle-
            
      - name: Build app
        run: npm run build
        
      - name: Sync Capacitor
        run: npx cap sync
        
      - name: Setup Java
        uses: actions/setup-node@v5
        with:
            distribution: 'zulu'
            java-version: '17'
            
      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.0'
          bundler-cache: true
          
      - name: Run Fastlane
        uses: maierj/fastlane-action@v3.1.0
        env:
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          DEVELOPER_PACKAGE_NAME: ${{ secrets.DEVELOPER_PACKAGE_NAME }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
        with:
          lane: android beta
          
      - name: Upload artifact
        uses: actions/upload-artifact@v2
        with:
          name: android-release
          path: ./android/app/build/outputs/bundle/release/app-release.aab
          retention-days: 10

Cara Kerjanya

1. Buat tag Git untuk mengaktifkan workflow
2. GitHub Aksi membangun aplikasi Anda
3. Fastlane mengunggahnya ke saluran beta Google Play
4. Aplikasi Anda secara otomatis diperbarui

Waktu dan Biaya Pembangunan

• Waktu pembangunan: 3-5 menit
• Biaya untuk repositori pribadi: ~$0.04 per build
• Gratis untuk proyek sumber terbuka

Artikel Terkait

Petunjuk Pengaturan CI/CD

• Pembangunan Otomatis Capacitor iOS dengan GitHub Aksi - Pengaturan CI/CD iOS yang lengkap
• Pembangunan dan Rilis Otomatis dengan GitHub Aksi - Tutorial pipa CI/CD yang lengkap
• Kelola Pembangunan Dev dan Prod dengan GitHub Aksi - Pengelolaan lingkungan

Platform CI/CD Alternatif

• Pembangunan dengan GitLab CI - Alternatif GitLab untuk Android
• Bangun dengan CodeMagic - Panduan pengaturan CodeMagic

Pembaruan Langsung & Pengembangan

• Capgo Dokumentasi Pembaruan Langsung - Tambahkan pembaruan OTA ke aplikasi Anda
• Integrasi CI/CD dengan Capgo - Integrasi pembaruan langsung ke dalam pipeline Anda

Sumber Daya

• GitHub Dokumentasi Aksi
• Dokumentasi Fastlane

Teruskan dari Pembangunan Otomatis Capacitor Android dengan GitHub aksi

Jika Anda menggunakan Automatic Capacitor Android build with GitHub actions untuk merencanakan otomatisasi CI/CD, hubungkannya dengan Capgo CI/CD untuk alur kerja produk di Capgo CI/CD, Capgo Pembangunan Asli untuk alur kerja produk di Capgo Pembangunan Asli, Capgo Integrasi untuk alur kerja produk di Capgo Integrasi, Integrasi CI/CD untuk detail implementasi di Integrasi CI/CD, dan GitHub Integrasi Aksi untuk detail implementasi di GitHub Integrasi Aksi.