Empezar

Comience con Capgo Cloud Build y cree su primera compilación nativa de iOS o Android en minutos.

Lo que Necesitarás

Antes de comenzar, asegúrese de tener:

• Una aplicación Capacitor que se compila correctamente localmente
• Node.js 20 o superior instalado
• Una cuenta Capgo (un período de prueba gratuito es suficiente para comenzar)
• Su aplicación ya está registrada en Capgo (ejecute bunx @capgo/cli@latest app add si no)
• (No es necesario preparar credenciales de firma con anticipación — las configuraremos en el próximo paso.)

Configure sus credenciales de firma

Capgo necesita credenciales de firma para compilar y enviar su aplicación — pero no tiene que manejarlas manualmente. Responda a un par de preguntas y le indicaremos el comando exacto a ejecutar:

Ejecutar su primera compilación

Necesita estar autenticado con Capgo para compilar. Si no lo ha hecho ya:

bunx @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ás listo — la onboarding te ofrece iniciar una compilación para ti al final, por lo que tu primera compilación puede estar en camino ya. 🎉

De lo contrario, inicia una compilación tú mismo con build request — establecer --platform a lo que estás construyendo:

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

El CLI sube tu proyecto, transmite los registros de compilación en vivo en tu terminal y — una vez que estén configuradas tus credenciales — envía el resultado a la tienda automáticamente.

Entendiendo el Proceso de Compilación

Cuando ejecutes el comando de compilación, aquí es lo que sucede:

flowchart LR
    A[Your Machine] -->|1. Zip Project| B[Local Temp]
    B -->|2. Upload| C[Capgo Cloud]
    C -->|3. Build| D[Mac Mini Silicon M4 Build Server]
    D -->|4. Logs Stream| A
    D -->|5. Cleanup| E[Auto Delete]

1. Preparación Local - Su proyecto está comprimido (excluyendo node_modules y archivos ocultos)
2. Subir - El zip se sube a un almacenamiento en la nube seguro (Cloudflare R2)
3. Ejecución de Construcción - Su aplicación se construye en infraestructura dedicada
4. Streaming de Registro - Los registros en tiempo real se streamean a su terminal a través de eventos enviados por el servidor
5. Eliminación Automática - Los artefactos de construcción se eliminan (Android: instantáneo, iOS: 24 horas)

¿Qué Se Construye?

Capgo Construye solo sube los archivos mínimos necesarios para compilar tu aplicación nativa. Tu fuente completa code nunca sale de tu máquina.

¿Qué se sube

Incluido	Descripción
ios/ o android/	La carpeta de 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 el 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 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	Nunca subido

Nota

Sus activos web compilados (JS, CSS, HTML) están subidos - pero como parte de la carpeta nativa. Cuando ejecutes bunx cap sync, su compilación web se copia en ios/App/App/public/ o android/app/src/main/assets/public/. Por eso es necesario ejecutar cap sync antes de construir.

Sus Responsabilidades

Antes de ejecutar bunx @capgo/cli@latest build:

1. Construya sus activos web - Ejecute bun run build (o el comando de construcción de su marco de trabajo)
2. Sincronice con nativo - Ejecute bunx cap sync para copiar los activos web en el proyecto nativo
3. Comite sus dependencias - Asegúrese de que todos los plugins nativos estén en package.json

¿Qué Capgo Build Maneja?

• Compilación nativa de iOS (Xcode, Fastlane)
• Compilación nativa de Android (Gradle)
• Code firma con sus credenciales
• Presentación en la tienda de aplicaciones (si está configurada)

Pasos siguientes

Ahora que has creado tu primer build:

• Configuración de compilaciones de iOS - Establezca certificados y perfiles
• Configura compilaciones de Android - Configura claves y Play Store
• Resolución de problemas - Problemas comunes y soluciones
• CLI Referencia - Documentación completa de comandos

Necesita ayuda?

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