Empezar

Comience con Capgo Cloud Build y cree su primer build nativo de iOS o Android en minutos.

Lo que Necesitarás

Antes de comenzar, asegúrese de tener:

• A una aplicación Capacitor que se compila correctamente localmente
• Instalado Node.js 20 o superior
• Una cuenta de Capgo (basta con una prueba gratuita para empezar)
• Tu aplicación ya registrada en Capgo (corre npx @capgo/cli@latest app add si no)
• No es necesario preparar credenciales de firma con anticipación — las configuraremos en el próximo paso.

Configura tus credenciales de firma

Capgo necesita credenciales de firma para compilar y enviar tu aplicación — pero no tienes que manejarlas manualmente. Responde a un par de preguntas y te apuntaremos a la exacta orden para ejecutar:

Ejecuta tu primera compilación

Necesitas estar autenticado con Capgo para compilar. Si no lo has hecho ya:

npx @capgo/cli@latest login
# or, in CI, set the token directly:
export CAPGO_TOKEN=your_api_key

Si acaba de ejecutar build initSi no, inicia una compilación tú mismo con

— establece build request a la que estás construyendo: --platform Ventana de terminal

npx @capgo/cli@latest build request com.example.app --platform <android|ios> --build-mode debug

The CLI uploads the prepared native project and streams build logs live in your terminal. Capgo Build can return a signed artifact or submit it to App Store Connect or Google Play when you configure the appropriate release flow.

Sección titulada “Entendiendo el Proceso de Compilación”

When ejecuta la orden de compilación, aquí es lo que sucede:

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Prepárate en tu CI - Compila la capa web, resuelve las dependencias privadas y sincroniza los activos completados en el proyecto nativo.
2. Cargar - El proyecto nativo preparado se carga en almacenamiento en la nube seguro para la compilación.
3. Ejecución de compilación - Capgo compila y firma el proyecto nativo en infraestructura dedicada.
4. Streaming de registros - Los registros en tiempo real se streamean a tu terminal a través de eventos enviados por el servidor.
5. Eliminación - El entorno de compilación y los datos de proyecto temporales se eliminan después de la compilación; la retención de la salida depende de las opciones de artefacto y entrega seleccionadas.

Use Capgo Construya con Bitrise o otro CI

Capgo Build no reemplaza su CI existente. Mantenga los pasos que necesitan su acceso privado en Bitrise o otro sistema de CI: instale de registros privados, resuelva CocoaPods privados sobre SSH, ejecute configuración nativa personalizada, construya la capa web y ejecute npx cap sync.

Luego llame a Capgo Build con el proyecto nativo preparado. Capgo recibe el listo ios/ o android/ proyecto para compilar y firmar, por lo que no necesita sus credenciales de Nexus privado, CocoaPods SSH o de compilación web. Los activos web compilados ya están dentro de ese proyecto nativo preparado; se utilizan para la compilación en lugar de retenerse como repositorio de origen.

¿Qué se Construye

Capgo Build recibe el proyecto nativo preparado necesario para compilar su aplicación. Su fuente web code, instalación de dependencias privadas y Capacitor sincronización permanecen en su CI.

¿Qué se Sube

Incluido	Descripción
ios/ o android/	La carpeta de la plataforma nativa que estás construyendo
package.json, package-lock.json	Manifiesto de dependencias
capacitor.config.*	Capacitor configuración protegida
resources/	Íconos de la aplicación, pantallas de bienvenida
Plugin nativo code	Sólo el ios/ o android/ subcarpeta de cada plugin Capacitor

¿Qué NO se sube?

Excluido	¿Por qué
node_modules/ (la mayoría de ella)	Sólo se incluye el plugin nativo code, no las dependencias de JS
src/	Su fuente web code permanece local
dist/, www/, build/ (nivel raíz)	Ya sincronizado en la carpeta nativa mediante cap sync
.git/	Historial de control de versiones
.gradle/, .idea/, .swiftpm/	Cachés de compilación y ajustes de IDE
.env, secretos	Jamás subido

Nota

Los activos web construidos (JS, CSS y HTML) se suben solo porque npx cap sync ha copiado los mismos en el proyecto nativo. Los pasos de origen web y de instalación de dependencias permanecen en tu CI; el proyecto nativo preparado se utiliza para construir el binario y luego se limpia.

Sus Responsabilidades

Antes de ejecutar npx @capgo/cli@latest build request:

1. Preparación en tu CI - Resuelve registros de paquetes privados, CocoaPods basados en SSH, SDKs de dispositivos, extensiones y cualquier preparación nativa personalizada en Bitrise o tu CI existente.
2. Construye tus activos web - Ejecuta npm run build (o el comando de construcción de tu framework).
3. Sincroniza con nativo - Ejecutar npx cap sync para copiar los activos web compilados en el proyecto nativo preparado.
4. Solicitar la compilación nativa - Enviar el proyecto preparado a __CAPGO_KEEP_0__ Build. ios/ ¿Qué maneja __CAPGO_KEEP_0__ Build? android/ Sección titulada “¿Qué maneja Capgo Build?”

What Capgo Build Handles

• __CAPGO_KEEP_0__ firma con sus credenciales
• Presentación opcional en App Store Connect o Google Play
• Code signing with your credentials
• Envío del proyecto preparado a __CAPGO_KEEP_0__ Build
• Configuración nativa admitida y valores de credenciales pasados como variables de entorno

Capgo La construcción no necesita acceso a su registro Nexus privado ni credenciales SSH una vez que su CI ha preparado el proyecto nativo. Consulte Configuración de la Construcción para variables de entorno admitidas y opciones de almacenamiento.

Para una versión de kiosk distribuida a través de MDM, configure el proyecto Android/construcción para producir un APK. Al solicitar la construcción, utilice ambos flags para saltar Google Play y obtener el resultado firmado:

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload evita la carga en la tienda Play Store incluso si se han guardado credenciales de Play; --output-upload proporciona un enlace temporal al resultado firmado. Distribuya ese APK a través de su MDM.

Pasos siguientes

Ahora que has creado tu primera construcción:

• Configura construcciones de iOS - Configura certificados y perfiles
• Configura construcciones de Android - Configura keystore y Play Store
• Resolución de problemas - Problemas comunes y soluciones
• CLI Referencia - Documentación completa de comandos

Necesita ayuda?

• Verifica el guía de resolución de problemas
• Únete a nuestra comunidad de Discord
• Soporte por correo electrónico en support@capgo.app