Zum Hauptinhalt springen
PR-Vorschau

Jeden Pull Request auf einem echten Smartphone prüfen

Deine CI lädt den Web-Build jedes Pull Requests in einen eigenen Capgo Channel hoch. Reviewer scannen einen QR-code oder wechseln in der App den Channel, um ihn auf ihrem Gerät zu testen. Der Channel wird gelöscht, sobald der PR geschlossen wird. Änderungen am nativen code erfordern weiterhin einen neuen Build.

  • Ein Channel pro Pull Request
  • QR-code-Vorschau
  • Aufräumen, wenn der PR geschlossen wird

Das Problem

Eine Web-Änderung sollte für das Review kein neues Binary brauchen

PRs mit Store-Test-Builds prüfen

  1. Entwickler öffnet einen PR

    Die Änderung ist bereit zur Prüfung, aber niemand kann sie noch auf dem Handy testen.

  2. Builden, signieren und hochladen

    Jemand baut ein natives Binary für den Branch, signiert es, lädt es zu TestFlight oder einem Play-Test-Track hoch und wartet auf die Verarbeitung.

  3. Einladen und installieren

    Reviewer müssen als Tester hinzugefügt werden und genau diesen Build installieren.

  4. Für jeden Fix wiederholen

    Jeder Review-Kommentar, der code ändert, bedeutet einen weiteren Build, einen weiteren Upload und eine weitere Installation.

Jede Review-Runde wartet auf einen Native Build, selbst wenn nur JavaScript geändert wurde.

Was das dem Team kostet

Jeder Build

Wartet auf Store-Verarbeitung

Jeder Build, den du zu TestFlight oder einem Play-Testing-Track hochlädst, muss erst verarbeitet werden, bevor Tester ihn installieren können. Das gilt für jeden Build.

Jeder PR

Braucht einen eigenen Native Build zum Testen

Ohne Live Updates können Reviewer einen Branch erst testen, nachdem jemand eine neue Binary gebaut, signiert und hochgeladen hat – selbst bei reinen Web-Änderungen.

Spätes Feedback

Review kommt, wenn der Autor schon weiter ist

Wenn Reviews auf Builds warten müssen, kommt Feedback zu spät, der Autor bereits an etwas anderem arbeitet und der Branch vom main-Branch abweicht.

So funktioniert es

So previewen Teams Pull Requests mit Capgo

Vier CI-Schritte: Einmal einen Scoped Key einrichten, pro Push hochladen, die Preview teilen, beim Schließen aufräumen. Alle Befehle stammen aus der Capgo Doku.

  1. App Preview Key erstellen und Previews aktivieren

    Ein Admin erstellt einen App Preview API Key für die CI. Damit lassen sich Preview-Channels anlegen und Bundles hochladen, aber keine Default- oder Production-Channels ändern. Previews werden pro App einmalig aktiviert.

    # once, run by an admin (not the preview key)
    npx @capgo/cli@latest app set com.example.app --preview
    App Preview API Keys
  2. PR-Build in einen eigenen Channel hochladen

    Bei jedem Push baut die CI die Web-App und lädt sie mit einer eindeutigen Bundle-Version hoch. `bundle upload --channel` erstellt den Channel pr-<number>, falls er noch nicht existiert, und verknüpft das Bundle damit.

    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"
    PR-Previews in der Channel-Doku
  3. Preview im PR posten

    get-qr gibt einen QR code für den Channel aus, oder mit --url die Preview-URLs, damit die CI sie in einen PR-Kommentar einfügen kann.

    npx @capgo/cli@latest get-qr com.example.app \
      --channel "pr-$PR_NUMBER" \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --url
    get-qr-Referenz
  4. Channel löschen, wenn der PR geschlossen wird

    Führe dies beim Event „pull request closed“ aus. Mit einem App Preview Key werden nur der Channel und das verknüpfte Bundle gelöscht, die dieser Key erstellt hat.

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

Andere Wege, wie Reviewer zu einem PR-Channel wechseln

Beide brauchen einen Channel, der Self-Assignment erlaubt. Ein App-Preview-Key erlaubt das nicht, also mit diesem Key die QR-Vorschau teilen oder in der Konsole ein Device-Override für das Gerät setzen.

Shake-Menü

Aktiviere das Shake-Menü in internen Builds. Tester schütteln das Gerät, um das Testmenü von Capgo zu öffnen, und über den Shake-Channel-Selector können sie einen Channel auswählen.

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

In-App-Switcher

Füge ein Channel-Feld zu einem Developer-Settings-Screen hinzu und rufe setChannel() mit dem PR-Channel-Namen auf.

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

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

Wer nutzt PR-Previews

Jeder, der den Pull Request reviewt, kann ihn auf einem Smartphone prüfen – nicht nur der Autor.

QA-Engineers

  • Teste den Web-Build des PRs auf deinem eigenen Gerät
  • Zwischen PR-Channels wechseln, ohne die App neu zu installieren
  • Der Channelname entspricht der PR-Nummer, sodass du weißt, welchen code du gerade ausführst

Project Manager

  • Teste ein Feature auf dem Handy, bevor es gemerged wird
  • Scanne den QR code, der im PR gepostet wurde
  • Gib Feedback direkt im PR ab

Entwickler

  • Hol dir Device-Feedback, solange der PR noch offen ist
  • Jeder Push aktualisiert den PR-Channel
  • Kein Native Build für reine JavaScript-Änderungen

Store-Testing-Builds vs. Capgo PR-Channels

  • Einen PR auf ein Smartphone bringen

    TestFlight / Play-Testing
    Native Build, Signing und Store-Prozess
    Capgo PR-Channel
    Web-Build und Bundle-Upload via CI
  • Zwischen PRs wechseln

    TestFlight / Play-Testing
    Anderen Build installieren
    Capgo PR-Channel
    Anderen QR-code scannen oder den Channel wechseln
  • Reviewer-Setup

    TestFlight / Play-Testing
    Tester einladen, dann jeden Build installieren
    Capgo PR-Channel
    App einmalig installieren
  • Native code und Plugin-Änderungen

    TestFlight / Play-Testing
    Ja
    Capgo PR-Channel
    Nein, erfordert einen Native Build

Mit Capacitor gebaute Apps

Produkt-Apps brauchen überprüfbare mobile Änderungen

Lern-, Event- und Community-Apps können gleichzeitig Änderungen an Onboarding, Übungen, Live-Sessions und Abos im Review haben. PR-Previews lassen Produkt, QA und Support einen mobilen Build vor dem Merge prüfen.

StudySmarter - Schul- & Uni-App-Icon BILDUNG

StudySmarter - Schule & Uni

Bildungs-App, bei der Änderungen an Lektionen, Kursen und Abos ein Review durch Stakeholder erfordern.

Google Play-Installationen
6,5 Mio.
Store-Bewertung
4.8
App-Icon von Poll Everywhere Business

Poll Everywhere

Interaktive Live-App, bei der Event-Flows vor dem Merge getestet werden sollten.

Google Play-Installationen
1,1 Mio.
Store-Bewertung
3.2
lichess • Free Online Chess App-Icon SPIELBRETT

lichess • Kostenloses Online-Schach

Community-App, bei der Turnier- und Analyse-Screens von Device-Previews profitieren.

Google Play-Installationen
11,3 Mio.
Store-Bewertung
4.3

Kundenstimmen

Das sagen Teams, die mit Capgo deployen

5.0/5 von Entwicklerteams bewertet 9,400+ Teams Bewertungen lesen

Nate van Jole

CTO, Privat

„Das Setup war in weniger als einem Tag erledigt. Mit Channel-basierten Rollouts kann ich erst auf meinem eigenen Gerät testen, bevor etwas bei den Production-Usern ankommt.“

Porträt von Michael Haberler

Michael Haberler

nethead emeritors

„Tolle Arbeit am Updater-Plugin. Bei mir läuft es einwandfrei, und Live Updates sind ein echter Beschleuniger für schnelle Testzyklen.“

no-tone @ Webincode

Entwickler, Webincode

„Geräte-IDs zu bestimmten Gruppen hinzuzufügen und Änderungen nur an diese Gruppen zu pushen, ist ein echter Gamechanger.“

FAQ

Häufige Fragen zu PR Previews

Klare Antworten für alle, die CI einrichten, und für die Reviewer.

Brauchen Reviewer für jeden PR einen neuen Build?

Nicht, wenn der PR nur den Web-Layer ändert. Reviewer installieren die App einmal, und die JavaScript-, HTML-, CSS- und Asset-Dateien jedes PRs landen in einem eigenen Channel. Wenn der PR ein Plugin hinzufügt oder nativen code ändert, braucht er einen Native Build. Führe build needed in der CI aus, um das zu erkennen.

Was einen Native Build erfordert

Kann der CI-Key auf unseren Production-Channel zugreifen?

Nicht mit einem App Preview API Key. Er kann Preview-Channels erstellen, Bundles hochladen und nur den Channel und das Bundle löschen, das er selbst erstellt hat. Er kann den Default- oder Main-Channel nicht ändern. Führe in GitHub Actions den Job bei pull_request aus, nicht bei pull_request_target, und beschränke ihn auf PRs aus demselben Repository.

App Preview API Keys

Wie öffnen Reviewer die Preview?

Ein Admin aktiviert die Previews einmalig mit app set --preview. Danach gibt get-qr einen QR-code für den PR-Channel aus, und --url gibt die Web-Preview-URL und den Deep Link aus. Poste sie in einem PR-Kommentar.

get-qr-Referenz

Was passiert mit alten PR-Channels und Bundles?

Füge einen Job für das Event pull request closed hinzu, der channel delete mit --delete-bundle und --success-if-not-found ausführt. Mit einem App Preview Key werden so der Channel und das zugehörige Bundle entfernt. Bundles aus früheren Pushes lassen sich mit bundle cleanup und einem Key entfernen, der Löschrechte hat.

Channel CLI Referenz

Funktioniert das mit GitLab, Bitbucket oder Azure DevOps?

Ja. Die Schritte sind Capgo CLI-Befehle und laufen daher in jeder CI. In der Doku gibt es Integrations-Guides für GitHub Actions, GitLab CI, Bitbucket Pipelines und Azure DevOps.

CI/CD-Integrationen

Vorschau deines nächsten Pull Requests auf dem Handy

Füge die Upload-, QR- und Cleanup-Schritte zu deiner CI hinzu und teste sie während der kostenlosen Testphase mit deiner eigenen App.

14 Tage kostenlos testen, keine Kreditkarte nötig. Native Änderungen erfordern weiterhin einen neuen Build.