Empezar

Comienza con Capgo Cloud Build y crea tu primer build nativo de iOS o Android en minutos.

Lo que necesitarás

Antes de comenzar, asegúrate 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 a mano. Responde a un par de preguntas y te diremos qué comando 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 init, ya está listo — la onboarding ofrece iniciar una compilación para usted al final, por lo que su primera compilación puede estar en camino ya. 🎉

De lo contrario, inicie una compilación usted mismo con build request — establecer --platform a lo que esté construyendo:

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

El CLI sube el proyecto nativo preparado y transmite registros de compilación en vivo en su terminal. Capgo La compilación puede devolver un artefacto firmado o enviarlo a App Store Connect o Google Play cuando configure el flujo de liberación adecuado.

Entendiendo el Proceso de Compilación

Cuando ejecutas 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. Prepara en tu CI - Compila la capa web, resuelve dependencias privadas y sincroniza los activos completados en el proyecto nativo.
2. Subir - El proyecto nativo preparado se sube a un 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 envían a tu terminal a través de Server-Sent Events.
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 web-build. 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
resources/	Iconos de la aplicación, pantallas de bienvenida
Plugin nativo code	Solo los ios/ o android/ subcarpeta de cada plugin Capacitor

¿Qué NO se sube

Excluido	¿Por qué
node_modules/ (la mayoría de ella)	Solo se incluye el plugin nativo code, no las dependencias de JS
src/	Su fuente web code se queda 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 del IDE
.env, secretos	Nunca subido

Nota

Los activos web construidos (JS, CSS y HTML) se suben solo porque npx cap sync ha copiado ellos en el proyecto nativo. Los pasos de la fuente web y la instalación de dependencias se quedan 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. Prepárate en tu CI - Resuelve los 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 ios/ o android/ a Capgo Build.

¿Qué Maneja Capgo Build?

• Compilación nativa de iOS (Xcode, Fastlane)
• Compilación nativa de Android (Gradle)
• Firma de Code con sus credenciales
• Presentación opcional en App Store Connect o Google Play
• Configuración de compilación nativa admitida y valores de credenciales pasados como variables de entorno

Capgo La compilación no necesita acceso a su registro privado de Nexus o credenciales SSH una vez que su CI ha preparado el proyecto nativo. Consulte Configuración de compilació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/compilación para producir un APK. Al solicitar la compilació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 compilació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 Comunidad de Discord
• Obtén soporte por correo electrónico en soporte@capgo.app