Saltar al contenido principal
Vista previa de PR

Revisa cada pull request en un teléfono real

Tu CI sube el build web de cada pull request a su propio canal de Capgo. Los revisores escanean un código QR code o cambian de canal en la app para probarlo en su dispositivo, y el canal se elimina al cerrar el PR. Los cambios en el code nativo aún necesitan un nuevo build.

  • Un canal por cada pull request
  • Vista previa de code con QR
  • Limpieza al cerrar el PR

El problema

Un cambio web no debería necesitar un nuevo binario para revisarse

Revisar un PR con builds de prueba de la tienda

  1. El desarrollador abre un PR

    El cambio está listo para revisión, pero nadie puede probarlo todavía en un móvil.

  2. Compilar, firmar y subir

    Alguien genera un Native Build para la rama, lo firma, lo sube a TestFlight o a una vía de pruebas de Play y espera a que se procese.

  3. Invitar e instalar

    Hay que añadir a los revisores como testers e instalar ese build exacto.

  4. Repetir con cada fix

    Cada comentario de revisión que cambie code implica otro build, otra subida y otra instalación.

Cada ronda de revisión depende de un build nativo, incluso si solo cambió el JavaScript.

Lo que eso le cuesta al equipo

Cada build

Espera el procesamiento de la tienda

Cada build que subes a TestFlight o a un canal de pruebas de Play se procesa antes de que los testers puedan instalarlo. Y pasa con cada build.

Cada PR

Necesita su propio build nativo para probar

Sin Live Update, los revisores solo pueden probar una rama después de que alguien haga el build, firme y suba un nuevo binario, incluso para cambios solo de web.

Feedback tardío

La revisión llega cuando el autor ya avanzó

Cuando la revisión depende de los builds, el feedback llega tarde, el autor ya está en otra tarea y la rama se desvía de main.

Cómo funciona

Cómo los equipos previsualizan pull requests con Capgo

Cuatro pasos de CI: configura una clave con scope una vez, sube en cada push, comparte la preview y limpia al cerrar. Todos los comandos de abajo salen de la documentación de Capgo.

  1. Crea una clave de App Preview y activa las previews

    Un admin crea una clave API de App Preview para CI. Puede crear canales de preview y subir bundles, pero no puede cambiar tu canal por defecto ni el de producción. Las previews se activan una vez por app.

    # once, run by an admin (not the preview key)
    npx @capgo/cli@latest app set com.example.app --preview
    Claves API de App Preview
  2. Sube el build del PR a su propio canal

    En cada push, el CI hace el build de la web app y la sube con una versión de bundle única. bundle upload --channel crea el canal pr-<number> si no existe y vincula el bundle a él.

    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"
    Previews de PR en la documentación de canales
  3. Publica la preview en el PR

    get-qr imprime un QR code para el canal, o las URLs de preview con --url, para que el CI pueda añadirlas a un comentario del PR.

    npx @capgo/cli@latest get-qr com.example.app \
      --channel "pr-$PR_NUMBER" \
      --apikey "$CAPGO_PREVIEW_KEY" \
      --url
    Referencia de get-qr
  4. Elimina el canal cuando se cierre el PR

    Ejecuta esto en el evento de pull request cerrado. Con una clave de App Preview, solo elimina el canal y el bundle vinculado que esa clave creó.

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

Otras formas en que los revisores cambian a un canal de PR

Ambos necesitan un canal que permita la autoasignación. Una App Preview key no lo configura, así que con esa key comparte el QR de preview o define un device override en la consola.

Menú de shake

Activa el menú shake en los builds internos. Los testers agitan el dispositivo para abrir el menú de pruebas de Capgo, y el selector de canal por shake les permite elegir un canal.

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

Selector in-app

Añade un campo de canal a la pantalla de ajustes de desarrollador y llama a setChannel() con el nombre del canal del PR.

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

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

Quiénes usan las PR previews

Cualquiera que revise el pull request puede probarlo en un móvil, no solo el autor.

Ingenieros de QA

  • Prueba el web build del PR en tu propio dispositivo
  • Cambia entre canales de PR sin reinstalar la app
  • El nombre del canal coincide con el número del PR, así sabes qué code estás ejecutando

Gestores de proyecto

  • Prueba una feature en el móvil antes de que se haga el merge
  • Escanea el QR code publicado en el PR
  • Deja feedback en el propio PR

Desarrolladores

  • Recibe feedback del dispositivo mientras el PR sigue abierto
  • Cada push actualiza el canal del PR
  • Sin Native Build para cambios solo en JS

Builds de prueba de stores vs canales de PR Capgo

  • Llevar un PR a un teléfono

    Pruebas en TestFlight / Play
    Native Build, signing y procesamiento de la store
    Canal de PR Capgo
    Web build y upload de bundle desde CI
  • Cambiar entre PRs

    Pruebas en TestFlight / Play
    Instalar otro build
    Canal de PR Capgo
    Escanea otro QR code o cambia de canal
  • Configuración del revisor

    Pruebas en TestFlight / Play
    Invita al tester e instala cada build
    Canal de PR Capgo
    Instala la app una vez
  • Cambios en code nativo y en plugins

    Pruebas en TestFlight / Play
    Sí
    Canal de PR Capgo
    No, requiere un Native Build

Apps creadas con Capacitor

Las apps de producto requieren cambios móviles revisables

Las apps de aprendizaje, eventos y comunidad pueden tener a la vez cambios en onboarding, práctica, sesiones en vivo y suscripciones bajo revisión. Los PR previews permiten que producto, QA y soporte revisen un build listo para móvil antes del merge.

StudySmarter - Icono de la app de escuela y universidad EDUCACIÓN

StudySmarter - Escuela y universidad

App educativa donde los cambios en lecciones, cursos y suscripciones requieren revisión de stakeholders.

Instalaciones en Google Play
6,5M
Calificación en la tienda
4.8
Icono de la app Poll Everywhere NEGOCIOS

Poll Everywhere

App de alto engagement donde los flujos de eventos deben probarse antes del merge.

Instalaciones en Google Play
1,1M
Calificación en la tienda
3.2
lichess • Icono de la app gratuita de ajedrez online TABLERO DE JUEGO

lichess • Ajedrez online gratis

App comunitaria donde las pantallas de torneos y análisis aprovechan las previews en el dispositivo.

Instalaciones en Google Play
11,3M
Calificación en la tienda
4.3

Testimonios de clientes

Lo que dicen los equipos que publican con Capgo

5.0/5 valorado por equipos de desarrollo 9,400+ equipos Leer reseñas

Nate van Jole

CTO, Privado

&ldquo;La configuración tomó menos de un día. Los rollouts por canales me permiten probar en mi propio dispositivo antes de lanzarlo a producción.&rdquo;

Retrato de Michael Haberler

Michael Haberler

nethead emeritors

“Buen trabajo con el plugin de actualizaciones. Me funciona de maravilla y las live updates son un gran acelerador para agilizar las pruebas.”

no-tone @ Webincode

Desarrollador, Webincode

&ldquo;Poder añadir Device IDs a grupos concretos y enviar los cambios solo a esos grupos es un salvavidas.&rdquo;

FAQ

Preguntas de los equipos sobre las PR previews

Respuestas directas para quienes configuran el CI y para quienes revisan.

¿Necesitan los revisores un nuevo build para cada PR?

No si el PR solo cambia la capa web. Los revisores instalan la app una vez, y el JS, HTML, CSS y assets de cada PR van a su propio canal. Si el PR añade un plugin o cambia el code nativo, necesita un Native Build. Ejecuta build needed en el CI para detectarlo.

Qué necesita un build nativo

¿Puede la clave del CI tocar nuestro canal de producción?

No con una clave de App Preview API. Puede crear canales de preview, subir bundles y borrar solo el canal y el bundle que creó. No puede cambiar el canal por defecto ni el principal. En GitHub Actions, ejecuta el job en pull_request, no en pull_request_target, y limítalo a PRs del mismo repositorio.

Claves API de App Preview

¿Cómo abren la preview los revisores?

Un admin habilita las previews una vez con app set --preview. Después, get-qr imprime un QR code para el canal del PR, y --url imprime la URL de la preview web y el deep link. Publícalos en un comentario del PR.

Referencia de get-qr

¿Qué pasa con los canales y bundles de PR antiguos?

Añade un job en el evento pull request closed que ejecute channel delete con --delete-bundle y --success-if-not-found. Con una clave de App Preview, eso elimina el canal y el bundle vinculado. Los bundles de pushes anteriores se pueden eliminar con bundle cleanup, usando una clave con permisos de borrado.

Referencia del canal CLI

¿Funciona con GitLab, Bitbucket o Azure DevOps?

Sí. Los pasos son comandos de Capgo CLI, así que funcionan en cualquier CI. La documentación incluye guías de integración para GitHub Actions, GitLab CI, Bitbucket Pipelines y Azure DevOps.

Integraciones de CI/CD

Previsualiza tu próximo pull request en un móvil

Añade los pasos de upload, QR y cleanup a tu CI y pruébalos en tu propia app durante la prueba gratuita.

Prueba gratis de 14 días, sin tarjeta. Los cambios nativos siguen requiriendo un nuevo build.