Empezar

Copie un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

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

Lo que Necesitarás

Antes de empezar, asegúrate de tener:

Una aplicación Capacitor que se compila correctamente localmente
Node.js 20 o superior instalado
Una cuenta de Capgo con una suscripción activa
Tu aplicación ya registrada en Capgo (ejecuta bunx @capgo/cli@latest app add si no)
Configurados los credenciales de construcción (certificados, almacenes de claves) - consulta a continuación

Antes de tu primera construcción

⚠️ Configura Credenciales Primero

Requerido antes de construir: Debes configurar tus credenciales de construcción (certificados para iOS, keystore para Android).

Configura Credenciales →

Inicio Rápido

Configura Credenciales de Construcción

Antes de que puedas construir, debes guardar tus credenciales localmente:

Para iOS:

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --certificate ./cert.p12 \
  --p12-password "password" \
  --provisioning-profile ./profile.mobileprovision \
  --apple-key ./AuthKey.p8 \
  --apple-key-id "KEY123" \
  --apple-issuer-id "issuer-uuid" \
  --apple-team-id "team-id"

Para Android:

bunx @capgo/cli@latest build credentials save \
  --platform android \
  --keystore ./release.keystore \
  --keystore-alias "my-key" \
  --keystore-key-password "key-pass" \
  --keystore-store-password "store-pass"

Ver el guía completa de credenciales para detalles. Verificar construcción local

Primero, asegúrese de que su aplicación se construya localmente sin errores:

Ventana de terminal

# Build your web assets
bun run build

# Sync with Capacitor
bunx cap sync

# Test local build (optional but recommended)
bunx cap open ios    # For iOS
bunx cap open android # For Android

Establezca su clave de Capgo __CAPGO_KEEP_1__ (si no está configurada ya):

Set your Capgo API key (if not already configured):
Copiar a portapapeles
```
bunx @capgo/cli@latest login
```
O establezca la variable de entorno:
Ventana de terminal
```
export CAPGO_TOKEN=your_api_key_here
```

Ejecuta tu primer build

Comienza con un build de depuración de Android (más rápido para probar):

bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

Verás registros en tiempo real mientras tu build avanza:

✔ Creating build job...
✔ Uploading project (15.2 MB)...
✔ Build started

📝 Build logs:
→ Installing dependencies...
→ Running Gradle build...
→ Signing APK...
✔ Build succeeded in 3m 42s

Verifica el estado de la construcción

El CLI se encargará de realizar una solicitud periódica y mostrar el estado de la construcción. Una vez completado, verás:
- Tiempo de compilación
- Estado de éxito/fallo
- Aplicación enviada a la Tienda de App/Play Store (si se han configurado las credenciales)

Entendiendo el Proceso de Compilación

Cuando ejecutes el comando 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]

Preparación Local - Tu proyecto se comprime (excluyendo node_modules Subir
- El zip se sube a un almacenamiento en la nube seguro (__CAPGO_KEEP_0__ R2) - The zip is uploaded to secure cloud storage (Cloudflare R2)
Ejecución de Construcción - Su aplicación se construye en infraestructura dedicada
Streaming de Registros - Los registros en tiempo real se envían a su terminal a través de Server-Sent Events
Eliminación Automática - Los artefactos de construcción se eliminan (Android: instantáneo, iOS: 24 horas)

Infraestructura de Construcción

La ejecución de construcción se ejecuta en máquinas Mac Mini Silicon M4 dedicadas:

10 núcleos M4 de CPU (4 núcleos de rendimiento, 6 núcleos de eficiencia)
10 núcleos de GPU
16 núcleos de Motor de Red Neuronal
16 GB de RAM
macOS Tahoe 26.2

La imagen de construcción admite Xcode 26.2, Android Studio 2025 y .NET 9/.NET 10 SDK cargas de trabajo para pipelines de construcción nativas.

Tu Primer Compilado de Producción

Una vez que hayas verificado que el proceso funciona, crea un compilado de producción:

Android

bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

Primero debes configurar las credenciales de firma. Consulta Configuración de Compilación de Android.

iOS

bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

Los builds de iOS requieren certificados de firma y perfiles de configuración. Consulte Configuración de Build de iOS.

¿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.

__CAPGO_KEEP_0__

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

Excluidos	¿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 subidos

Sus Responsabilidades

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

Construya sus activos web - Ejecute bun run build (o el comando de compilación de su marco de trabajo)
Sincronice con nativo - Ejecute bunx cap sync para copiar activos web en el proyecto nativo
Comite 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 de la tienda de aplicaciones (si está configurada)

Tiempo de compilación y costos

El tiempo de compilación se mide desde el inicio hasta la finalización:

Android: Por lo general, 3-5 minutos
iOS: Por lo general, 5-10 minutos
Infraestructura: Máquinas Mac Mini Silicon M4 que ejecutan macOS Tahoe 26.2

Solo paga por el tiempo de compilación real utilizado. Sin cargos ocultos.

Uso común

Integración CI/CD

Desencadé Capgo Build automáticamente desde tu GitHub flujo de trabajo de Actions — con un clic de botón, al recibir un push o una etiqueta. Consulta la guía dedicada de Capgo Actions GitHub Actions guide Desarrollo local

Sección titulada “Desarrollo local”

Ventana de terminal

# Quick debug build for testing
bun run build && bunx cap sync
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

Compilaciones de múltiples plataformas

Compila para ambas plataformas ejecutando dos comandos:

# iOS build
bunx @capgo/cli@latest build com.example.app \
  --platform ios \
  --build-mode release

# Android build
bunx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode release

En CI/CD, puedes ejecutar estos en trabajos de paralelo para compilaciones más rápidas.

Pasos siguientes

Ahora que has creado tu primera compilación:

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

Necesita ayuda?

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