Langsung ke konten utama
Pr Preview

Uji setiap pull request di ponsel asli

CI Anda mengunggah web build dari setiap pull request ke channel Capgo-nya sendiri. Reviewer memindai QR code atau beralih channel di aplikasi untuk mencobanya di perangkat mereka, dan channel dihapus saat PR ditutup. Perubahan pada code native tetap membutuhkan build baru.

  • Satu channel per pull request
  • Preview QR code
  • Pembersihan saat PR ditutup

Masalahnya

Perubahan web tidak seharusnya butuh binary baru untuk direview

Meninjau PR dengan build testing store

  1. Developer membuka PR

    Perubahan sudah siap direview, tapi belum ada yang bisa mencobanya di ponsel.

  2. Build, sign, dan upload

    Seseorang build binary native untuk branch, sign, upload ke TestFlight atau track testing Play, lalu menunggu proses.

  3. Undang dan install

    Reviewer harus ditambahkan sebagai tester dan install build yang sama persis.

  4. Ulangi untuk setiap perbaikan

    Setiap komentar review yang mengubah code berarti build lain, upload lain, dan install lain.

Setiap putaran review menunggu native build, bahkan jika hanya JavaScript yang berubah.

Biaya yang ditanggung tim

Setiap build

Menunggu pemrosesan store

Setiap build yang Anda upload ke TestFlight atau Play testing track diproses dulu sebelum tester bisa menginstalnya. Itu terjadi pada setiap build.

Setiap PR

Butuh build native sendiri untuk testing

Tanpa live update, reviewer hanya bisa mencoba branch setelah ada yang build, sign, dan upload binary baru, bahkan untuk perubahan web-only.

Feedback terlambat

Review terjadi setelah author pindah ke tugas lain

Saat review menunggu build, feedback datang terlambat, author sudah mengerjakan tugas lain, dan branch makin jauh dari main.

Cara kerjanya

Cara tim preview pull request dengan Capgo

Empat langkah CI: set up scoped key sekali, upload tiap push, bagikan preview, cleanup saat PR ditutup. Semua command di bawah ini dari dokumentasi Capgo.

  1. Buat kunci App Preview dan aktifkan pratinjau

    Admin membuat kunci App Preview API untuk CI. Kunci ini bisa membuat channel pratinjau dan mengunggah bundle, tetapi tidak bisa mengubah channel default atau produksi Anda. Pratinjau diaktifkan sekali per aplikasi.

    # once, run by an admin (not the preview key)
    npx @capgo/cli@latest app set com.example.app --preview
    Kunci API App Preview
  2. Unggah build PR ke channel-nya sendiri

    Pada setiap push, CI mem-build web app dan mengunggahnya dengan versi bundle unik. bundle upload --channel membuat channel pr-<number> jika belum ada dan mengaitkan bundle ke channel tersebut.

    npx @capgo/cli@latest bundle upload com.example.app \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --path ./dist \
      --channel "pr-$PR_NUMBER" \
      --bundle "1.2.3-pr.$PR_NUMBER.$GITHUB_RUN_NUMBER"
    Pratinjau PR di dokumentasi channel
  3. Posting pratinjau di PR

    get-qr mencetak QR code untuk channel, atau preview URLs dengan --url, sehingga CI bisa menambahkannya ke komentar PR.

    npx @capgo/cli@latest get-qr com.example.app \
      --channel "pr-$PR_NUMBER" \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --url
    referensi get-qr
  4. Hapus channel saat PR ditutup

    Jalankan ini pada event pull request closed. Dengan kunci App Preview, perintah ini hanya menghapus channel dan bundle terkait yang dibuat kunci tersebut.

    npx @capgo/cli@latest channel delete \
      "pr-$PR_NUMBER" com.example.app \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --delete-bundle \
      --success-if-not-found
    referensi channel CLI

Cara lain reviewer beralih ke channel PR

Keduanya membutuhkan channel yang mengizinkan self-assignment. Key App Preview tidak mengatur itu, jadi dengan key tersebut, bagikan QR preview atau atur device override di console.

Menu Shake

Aktifkan menu shake di build internal. Tester menggoyangkan perangkat untuk membuka menu uji Capgo, dan pemilih channel shake memungkinkan mereka memilih channel.

// capacitor.config.ts (internal builds)
CapacitorUpdater: {
  shakeMenu: true,
}

Pengalih in-app

Tambahkan field channel ke layar pengaturan developer dan panggil setChannel() dengan nama channel PR.

import { CapacitorUpdater } from '@capgo/capacitor-updater'

await CapacitorUpdater.setChannel({
  channel: 'pr-123',
  triggerAutoUpdate: true,
})
Referensi setChannel()

Siapa yang menggunakan PR previews

Siapa pun yang meninjau pull request dapat memeriksanya di ponsel, bukan hanya penulisnya.

QA Engineer

  • Uji web build PR di perangkat Anda sendiri
  • Berpindah antar channel PR tanpa menginstal ulang aplikasi
  • Nama channel sesuai dengan nomor PR, sehingga Anda tahu code mana yang sedang dijalankan

Manajer Proyek

  • Coba fitur di ponsel sebelum di-merge
  • Pindai QR code yang diposting di PR
  • Berikan umpan balik langsung di PR

Pengembang

  • Dapatkan umpan balik perangkat saat PR masih terbuka
  • Setiap push memperbarui channel PR
  • Tidak perlu native build untuk perubahan JavaScript saja

Build pengujian Store vs channel PR Capgo

  • Deploy PR ke perangkat

    Pengujian TestFlight / Play
    Native build, signing, dan proses store
    Channel PR Capgo
    Web build dan upload bundle dari CI
  • Beralih antar PR

    Pengujian TestFlight / Play
    Install build lain
    Channel PR Capgo
    Scan code QR lain atau ganti channel
  • Setup reviewer

    Pengujian TestFlight / Play
    Undang tester, lalu install tiap build
    Channel PR Capgo
    Install aplikasi sekali saja
  • Perubahan code native dan plugin

    Pengujian TestFlight / Play
    Ya
    Channel PR Capgo
    Tidak, perlu Native Build

Aplikasi yang dibangun dengan Capacitor

Aplikasi produk butuh perubahan mobile yang bisa direview

Aplikasi learning, event, dan komunitas bisa punya perubahan onboarding, latihan, sesi live, dan langganan yang sedang direview bersamaan. PR previews memungkinkan tim produk, QA, dan support memeriksa build siap mobile sebelum merge.

StudySmarter - ikon aplikasi sekolah & universitas EDUKASI

StudySmarter - sekolah & universitas

Aplikasi edukasi yang perubahan pelajaran, kursus, dan langganannya perlu ditinjau stakeholder.

Instalasi Google Play
6,5 jt
Rating toko
4.8
Ikon aplikasi Poll Everywhere BISNIS

Poll Everywhere

Aplikasi engagement live yang alur event-nya harus diuji sebelum merge.

Instalasi Google Play
1,1 jt
Rating toko
3.2
lichess • Ikon aplikasi Free Online Chess PAPAN GAME

lichess • Catur Online Gratis

Aplikasi komunitas di mana layar turnamen dan analisis diuntungkan oleh pratinjau perangkat.

Instalasi Google Play
11,3jt
Rating toko
4.3

Bukti nyata pelanggan

Apa kata tim yang merilis aplikasi dengan Capgo

5.0/5 Diberi rating oleh tim developer 9,400+ tim Baca ulasan

Nate van Jole

CTO, Privat

&ldquo;Setup-nya selesai kurang dari sehari. Rollout berbasis channel memungkinkan saya menguji di perangkat sendiri sebelum sampai ke pengguna production.&rdquo;

Potret Michael Haberler

Michael Haberler

metrik utama

&ldquo;Plugin updater-nya mantap. Berjalan lancar di tempat saya, dan Live Update sangat mempercepat proses testing.&rdquo;

no-tone @ Webincode

Developer, Webincode

&ldquo;Bisa menambahkan Device ID ke grup tertentu dan push perubahan hanya ke grup itu sangat membantu.&rdquo;

FAQ

Pertanyaan tim seputar PR preview

Jawaban langsung untuk orang yang menyiapkan CI dan orang yang melakukan review.

Apakah reviewer perlu build baru untuk setiap PR?

Tidak perlu, kalau PR hanya mengubah lapisan web. Reviewer menginstal aplikasi sekali, lalu JavaScript, HTML, CSS, dan aset setiap PR masuk ke channel-nya masing-masing. Kalau PR menambahkan plugin atau mengubah code native, native build tetap diperlukan. Jalankan build needed di CI untuk mendeteksinya.

Apa yang butuh native build

Bisakah kunci CI menyentuh channel produksi kami?

Tidak, jika memakai kunci API App Preview. Kunci ini bisa membuat channel preview, mengunggah bundle, dan hanya bisa menghapus channel serta bundle yang dibuatnya. Kunci ini tidak bisa mengubah channel default atau utama. Di GitHub Actions, jalankan job pada pull_request, bukan pull_request_target, dan batasi hanya untuk PR dari repository yang sama.

Kunci API App Preview

Bagaimana cara reviewer membuka preview?

Admin mengaktifkan preview sekali dengan app set --preview. Setelah itu, get-qr mencetak QR code untuk channel PR, dan --url mencetak URL preview web serta deep link. Posting keduanya di komentar PR.

referensi get-qr

Apa yang terjadi pada channel dan bundle PR lama?

Tambahkan job pada event pull request closed yang menjalankan channel delete dengan --delete-bundle dan --success-if-not-found. Dengan kunci App Preview, ini menghapus channel dan bundle yang terkait. Bundle dari push sebelumnya bisa dihapus dengan bundle cleanup, memakai kunci yang punya hak hapus.

referensi channel CLI

Apakah ini bisa dipakai dengan GitLab, Bitbucket, atau Azure DevOps?

Ya. Langkah-langkahnya berupa perintah Capgo CLI, jadi bisa dijalankan di CI mana pun. Dokumentasi punya panduan integrasi untuk GitHub Actions, GitLab CI, Bitbucket Pipelines, dan Azure DevOps.

Integrasi CI/CD

Pratinjau pull request berikutnya di ponsel

Tambahkan langkah upload, QR, dan cleanup ke CI Anda, lalu coba di aplikasi Anda sendiri selama free trial.

Coba gratis 14 hari, tanpa kartu kredit. Perubahan native tetap membutuhkan build baru.