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 con éxito localmente
• Node.js 20 o superior instalado
• Una cuenta Capgo (un período de prueba gratuito es suficiente para comenzar)
• Su aplicación ya 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.)

Configura tus credenciales de firma

Capgo necesita credenciales de firma para construir y enviar tu aplicación — pero no tienes que manejarlas a mano. Responde a una o dos preguntas y te diremos hacia qué comando dirigirte:

Ejecuta tu primera compilación

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

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

Si acabas de ejecutar build init, ya estás listo — la onboarding 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 — configura --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 configuradas tus credenciales — envía el resultado al almacén automáticamente.

Entendiendo el Proceso de Compilación

Cuando ejecutes la orden de compilación, esto 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 - Tu proyecto se comprime (excluyendo node_modules y archivos ocultos)
2. Subir - El zip se sube a almacenamiento en la nube seguro (Cloudflare R2)
3. Ejecución de Construcción - Tu aplicación se construye en infraestructura dedicada
4. Streaming de Registro - Los registros en tiempo real se envían a tu 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 Solo se suben los archivos mínimos necesarios para compilar tu aplicación nativa. Tu código fuente completo __CAPGO_KEEP_0__ nunca sale de tu máquina. to compile your native app. Your full source code never leaves your machine.

¿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 lo 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
.envsecrets	Nunca subidos

Nota

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

Sus Responsabilidades

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

1. Construya sus activos web - Ejecutar bun run build (o el comando de construcción de su marco de trabajo)
2. Sincronizar con nativo - Ejecutar bunx cap sync para copiar activos web en el proyecto nativo
3. Comitar dependencias - Asegúrese de que todas las 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 tus credenciales
• Presentación de la aplicación en la tienda (si está configurada)

Pasos siguientes

Ahora que has creado tu primer build:

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

Necesita ayuda?

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