Empezar

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

Lo que necesitará

Antes de comenzar, asegúrese de tener:

• Una aplicación Capacitor que se compila con éxito localmente
• Node.js 20 o superior instalado
• A Capgo cuenta (basta con una prueba gratuita para empezar)
• 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 a mano. 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

If usted acaba de ejecutar build init, ya está listo — la configuración de inicio 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 — establezca --platform a lo que esté construyendo:

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

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

Entendiendo el Proceso de Compilación

Cuando ejecuta 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. Carga - El zip se carga en almacenamiento en la nube seguro (Cloudflare R2)
3. Ejecución de Construcción - Su aplicación se construye en infraestructura dedicada
4. Streaming de Registros - Registros en tiempo real se envían a su terminal a través de Server-Sent Events
5. Limpieza Automática - 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.

Sección titulada “¿Qué se sube”

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

¿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 a través de 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 ejecutas bunx cap sync, se copia su compilación web en ios/App/App/public/ o android/app/src/main/assets/public/. Por eso es necesario ejecutar cap sync antes de construir es necesario.

Tus Responsabilidades

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

1. Construye tus activos web - Ejecuta bun run build (o el comando de construcción de tu framework)
2. Sincroniza con nativo - Ejecuta bunx cap sync para copiar activos web en el proyecto nativo
3. Dependencias de commit - 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 con sus credenciales
• Presentación en la tienda de aplicaciones (si está configurado)

Pasos siguientes

Ahora que has creado tu primer build:

• Configura las compilaciones de iOS - Establecer certificados y perfiles
• Configurar compilaciones de Android - Establecer keystore 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 nosotros Comunidad de Discord
• Soporte por correo electrónico en support@capgo.app