Lompat ke Konten
Capgo - Pembaruan Langsung untuk Aplikasi Capacitor Capgo

Mulai Bangun Nativ dari UI CI

Sekaligus Anda memerlukan file biner iOS atau Android yang ditandatangani tanpa menggabungkan PR atau memotong tag rilis — bangunan QA, resubmit toko, atau TestFlight satu kali. Setiap host utama code dapat memulai pipeline dari UI webnya. Panduan ini menunjukkan cara menghubungkan UI tersebut ke Capgo Build.

Apa yang Anda Dapatkan

Bab berjudul “Apa yang Anda Dapatkan”

Tidak Ada Upacara Git

Klik Jalankan alur kerja / Jalankan pipeline. Capgo Build mengompilasi dari cabang yang dipilih.

Masukan Aman

Platform dan mode pembangunan menggunakan pilihan yang terbatas di mana host mendukung mereka (GitHub / Bitbucket / Azure). Variabel GitLab tetap dapat diedit per jalur kecuali Anda mendefinisikan Masukan Pipa bersama options.

Sama Rahasia CI

Gunakan kembali kredit pembangunan Capgo yang sudah ada di repositori Anda. Tidak ada yang baru di laptop.

Prasyarat

Bab berjudul “Prasyarat”

GitHub Aksi

Judul bagian “GitHub Aksi”

GitHub’s Aksi tab dapat memulai setiap alur kerja yang mengklaim workflow_dispatch.

1. Tambahkan alur kerja

Judul bagian “1. Tambahkan alur kerja”
.github/alur-kerja/capgo-build-manual.yml
name: Capgo Build (Manual)


on:
  workflow_dispatch:
    inputs:
      platform:
        description: Platform to build
        required: true
        default: both
        type: choice
        options: [ios, android, both]
      mode:
        description: Build mode
        required: true
        default: debug
        type: choice
        options: [debug, release]
      ref_note:
        description: Optional note for the run summary
        required: false
        type: string


jobs:
  build:
    runs-on: ubuntu-latest
    environment: ${{ inputs.mode == 'release' && 'production' || 'build-debug' }}
    strategy:
      fail-fast: false
      matrix:
        platform: ${{ fromJSON(inputs.platform == 'both' && '["ios","android"]' || format('["{0}"]', inputs.platform)) }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v6
        with:
          node-version: '24'
          cache: 'npm'


      - run: npm ci
      - run: npm run build
      - run: npx cap sync ${{ matrix.platform }}


      - name: Capgo Build
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          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 }}
        run: |
          EXTRA=""
          if [ "${{ inputs.mode }}" = "debug" ] && [ "${{ matrix.platform }}" = "android" ]; then
            EXTRA="--no-playstore-upload --output-upload"
          fi
          npx @capgo/cli@latest build request com.example.app \
            --platform ${{ matrix.platform }} \
            --build-mode ${{ inputs.mode }} \
            $EXTRA

2. Jalankan dari UI

Judul bagian “2. Jalankan dari UI”
  1. Terbuka repository GitHub di browser
  2. Pergi ke Aksi
  3. Pilih Capgo Build (Manual)
  4. Klik Jalankan alur kerja
  5. Pilih cabang, platform, dan mode
  6. Konfirmasi Jalankan alur kerja

Siapa saja yang memiliki izin menulis membuka akses dapat memulai sebuah build. Peta contoh release berjalan ke sebuah GitHub Lingkungan bernama production – buat lingkungan tersebut dan tambahkan reviewer yang diperlukan agar build menunggu persetujuan. Tanpa environment: di pekerjaan, aturan perlindungan lingkungan tidak pernah berlaku.

CI GitLab

Judul bagian “CI GitLab”

GitLab dapat menjalankan sebuah pekerjaan dari Build → Pipelines → Jalankan pipeline ketika pekerjaan tersedia untuk cabang tersebut.

# Job fragment for .gitlab-ci.yml
stages:
  - build


variables:
  APP_ID: com.example.app
  PLATFORM: android   # override from Run pipeline UI
  BUILD_MODE: debug


capgo_native_manual:
  stage: build
  when: manual
  script:
    - npm ci
    - npm run build
    - npx cap sync "$PLATFORM"
    - |
      npx @capgo/cli@latest build request "$APP_ID" \
        --platform "$PLATFORM" \
        --build-mode "$BUILD_MODE"
  rules:
    # Actions / Pipelines UI → manual play button
    - if: '$CI_PIPELINE_SOURCE == "web"'
      when: manual
    # Pipeline trigger token / webhook → run automatically
    - if: '$CI_PIPELINE_SOURCE == "trigger"'
      when: on_success
    - when: never
  1. Buka proyek GitLab
  2. Pergi ke Build → Pipelines → Jalankan pipeline
  3. Pilih cabang
  4. Opsional, atur PLATFORM / BUILD_MODE variabel untuk menjalankan ini
  5. Jalankan pipeline, kemudian klik tombol play di capgo_manual native

when: manual menghentikan pekerjaan dari mengeluarkan setiap push; antarmuka web (atau token trigger pipa) token trigger pipa) memulai secara on demand.

Bitbucket Pipelines

Judul bagian “Bitbucket Pipelines”

Gunakan pipa kustom agar antarmuka Bitbucket dapat melewatkan variabel:

bitbucket-pipelines.yml
pipelines:
  custom:
    capgo-native-build:
      - variables:
          - name: PLATFORM
            default: android
            allowed-values:
              - ios
              - android
          - name: BUILD_MODE
            default: debug
            allowed-values:
              - debug
              - release
      - step:
          name: Capgo Build
          image: node:24
          script:
            - npm ci
            - npm run build
            - npx cap sync "$PLATFORM"
            - npx @capgo/cli@latest build request com.example.app --platform "$PLATFORM" --build-mode "$BUILD_MODE"

Jalankan dari Pipelines → Jalankan pipa → Kustom: capgo-native-buildSimpan CAPGO_TOKEN dan bahan tanda tangan di bawah Pengaturan Repositori → Pipelines → Variabel Repositori.

Azure DevOps

Bab berjudul “Azure DevOps”
azure-pipelines-capgo-manual.yml
trigger: none   # disable CI push triggers
pr: none        # also disable PR triggers (GitHub/Bitbucket-backed projects)


parameters:
  - name: platform
    displayName: Platform
    type: string
    default: android
    values:
      - ios
      - android
  - name: buildMode
    displayName: Build mode
    type: string
    default: debug
    values:
      - debug
      - release


pool:
  vmImage: ubuntu-latest


steps:
  - task: NodeTool@0
    inputs:
      versionSpec: '24.x'
  - script: |
      npm ci
      npm run build
      npx cap sync ${{ parameters.platform }}
      npx @capgo/cli@latest build request com.example.app \
        --platform ${{ parameters.platform }} \
        --build-mode ${{ parameters.buildMode }}
    env:
      CAPGO_TOKEN: $(CAPGO_TOKEN)
      # map other signing secrets from Library → Variable groups

trigger: none dan pr: none tetapkan pipelining tidak secara otomatis menjalankan CI/PR sehingga memulai dari Pipelines → Jalankan pipelining (atau sebuah webhook). Jika proyek menggunakan Azure Repos kebijakan cabang yang mengantre pipelining ini, nonaktifkan kebijakan tersebut secara terpisah. Tambahkan CAPGO_TOKEN dan nilai tanda tangan ke dalam kelompok variabel yang ditandai rahasia.

Bab berjudul “Masukan yang Dianjurkan”
MasukanNilai yang disarankanCatatan
Platformios, android, bothMatrix ketika both
Modedebug, releaseDebug + --output-upload untuk tautan QA
iOS distribusiapp_store, ad_hocAd-hoc tidak pernah mengirimkan ke App Store

Untuk artefak QA yang dapat diunduh, kombinasikan debug Android dengan --no-playstore-upload --output-upload dan baca URL dengan build last-output.

Catatan Keamanan

Judul Bagian “Catatan Keamanan”
  • Gunakan aturan perlindungan lingkungan (GitHub) atau variabel yang dilindungi (GitLab) untuk release proses yang mengirimkan ke toko.
  • Tidak masukkan kata sandi tanda tangan ke dalam aliran kerja inputs hanya di rahasia/variabel.
  • Batasi siapa saja yang dapat menjalankan aliran kerja dengan peran repositori dan izin tim (akses tulis diperlukan pada GitHub). Perlindungan cabang sendiri tidak mengontrol Jalankan Aliran Kerja; tambahkan pengecekan otorisasi dalam aliran kerja jika hanya kelompok yang lebih terbatas yang dapat memulai proses.
Judul Bagian “Referensi Lainnya”
Aksi GitHub (pengaturan lengkap) Ekspor kreditel dan push/tag aliran.
Auto OTA atau Native Biarkan CI memilih update hidup vs Capgo Bangun pada setiap push.
Trigger melalui Webhook Panggil aliran yang sama dari dashboard admin melalui HTTP.