Primeros pasos

Comienza con Capgo Cloud Build y crea tu primera build nativa para iOS o Android en minutos.

Lo que necesitas

Antes de empezar, asegúrate de tener:

• Una app de Capacitor que se compile correctamente en local
• Node.js 20 o superior instalado
• Una cuenta de Capgo (una prueba gratuita es suficiente para empezar)
• Tu app ya registrada en Capgo (ejecuta npx @capgo/cli@latest app add si no)
• (No necesitas preparar credenciales de firma de antemano: las configuraremos en el siguiente paso.)

Configura tus credenciales de firma

Capgo necesita credenciales de firma para compilar y enviar tu app, pero no tienes que gestionarlas manualmente. Responde unas preguntas y te indicaremos el comando exacto a ejecutar:

Ejecuta tu primer build

Debes estar autenticado en Capgo para compilar. Si aún no lo has hecho:

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

Si acabas de ejecutar build init, ya tienes todo listo: el onboarding te ofrece iniciar un build al final, así que es posible que tu primer build ya esté en camino. 🎉

En caso contrario, inicia un build tú mismo con build request — establece --platform según la plataforma que estés 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 los logs del build en vivo en tu terminal. Capgo Build puede devolver un artefacto firmado o enviarlo a App Store Connect o Google Play cuando configuras el flujo de release adecuado.

Comprender el proceso de build

Cuando ejecutas el comando de build, esto 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. Preparar en tu CI - Construye la capa web, resuelve dependencias privadas y sincroniza los assets completados en el proyecto nativo.
2. Subir - El proyecto nativo preparado se sube a un almacenamiento seguro en la nube para el build.
3. Ejecución del build - Capgo compila y firma el proyecto nativo en infraestructura dedicada.
4. Streaming de logs - Los logs se transmiten en tiempo real a tu terminal mediante Server-Sent Events.
5. Limpiar - El entorno de build y los datos temporales del proyecto se limpian tras la compilación; la retención de la salida depende del artifact y las opciones de entrega seleccionadas.

Usa Capgo Build con Bitrise u otro CI

Capgo Build no reemplaza tu CI actual. Mantén en Bitrise u otro sistema de CI los pasos que necesitan tu acceso privado: instalar desde registros privados, resolver CocoaPods privados por SSH, ejecutar configuración nativa personalizada, compilar la capa web y ejecutar npx cap sync.

Luego llama a Capgo Build con el proyecto nativo preparado. Capgo recibe el ios/ o android/ un proyecto para compilar y firmar, por lo que no necesita tus credenciales de Nexus privado, CocoaPods SSH ni web-build. Los assets web compilados ya están dentro de ese proyecto nativo preparado; se usan para el build en vez de conservarse como repositorio de código fuente.

Qué se compila

Capgo Build recibe el proyecto nativo preparado necesario para compilar tu app. Tu código fuente web code, la instalación de dependencias privadas y la sincronización de Capacitor siguen en tu CI.

What Gets Uploaded

Incluido	Descripción
ios/ o android/	La carpeta de la plataforma nativa que estás compilando
package.json, package-lock.json	Manifiesto de dependencias
capacitor.config.*	Configuración de Capacitor
resources/	Iconos de app y splash screens
code de plugins nativos	Solo la ios/ o android/ subcarpeta de cada plugin Capacitor

Qué NO se sube

Excluido	Por qué
node_modules/ (la mayor parte)	Solo se incluye el code de plugins nativos, no las dependencias JS
src/	Tu código 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 build y ajustes de IDE
.env, secretos	Nunca se suben

Nota

Tus assets web compilados (JS, CSS y HTML) se suben solo porque npx cap sync los ha copiado al proyecto nativo. El código fuente web y los pasos de instalación de dependencias se quedan en tu CI; el proyecto nativo preparado se usa para compilar el binario y luego se limpia.

Tus responsabilidades

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

1. Prepara 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. Compila tus assets web - Ejecuta npm run build (o el comando de build de tu framework).
3. Sincroniza con native - Ejecuta npx cap sync para copiar los assets web compilados en el proyecto nativo preparado.
4. Solicita el native build - Envía el preparado ios/ o android/ proyecto a Capgo Build.

Lo que gestiona Capgo Build

• Compilación nativa de iOS (Xcode, Fastlane)
• Compilación nativa de Android (Gradle)
• Firma de Code con tus credenciales
• Envío opcional a App Store Connect o Google Play
• Valores de configuración de build nativo y credenciales admitidos, pasados como variables de entorno

Capgo Build no necesita acceso a tu registro Nexus privado ni a credenciales SSH una vez que tu CI ha preparado el proyecto nativo. Consulta Configuración de build para las variables de entorno y opciones de tienda admitidas.

Para una versión kiosk distribuida a través de MDM, configura el proyecto/build de Android para generar un APK. Al solicitar el build, usa ambas banderas para omitir Google Play y obtener la salida firmada:

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

--no-playstore-upload impide la subida a Play Store aunque las credenciales de Play estén guardadas; --output-upload proporciona un enlace con caducidad para la salida firmada. Distribuye ese APK a través de tu MDM.

Próximos pasos

Ahora que has creado tu primer build:

• Configurar builds de iOS - Configurar certificados y perfiles
• Configurar builds de Android - Configurar keystores y Play Store
• Solución de problemas - Problemas comunes y soluciones
• Referencia de CLI - Documentación completa de comandos

¿Necesitas ayuda?

• Consulta la guía de solución de problemas
• Únete a nuestro Comunidad de Discord
• Escríbenos a support@capgo.app