Comenzar

Comienza con Capgo Cloud Build y crea tu primera compilación nativa iOS o Android en minutos.

Lo Que Necesitarás

Antes de comenzar, asegúrate de tener:

Una aplicación Capacitor que compile exitosamente localmente
Node.js 20 o superior instalado
Una cuenta Capgo con una suscripción activa
Tu aplicación ya registrada en Capgo (ejecuta npx @capgo/cli@latest app add si no lo está)
Credenciales de compilación configuradas (certificados, keystores) - ver abajo

Antes de Tu Primera Compilación

⚠️ Configura las Credenciales Primero

Requerido antes de compilar: Debes configurar tus credenciales de compilación (certificados para iOS, keystores para Android).

Configurar Credenciales →

Inicio Rápido

Configurar Credenciales de Compilación

Antes de poder compilar, necesitas guardar tus credenciales localmente:

Para iOS:

npx @capgo/cli 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:

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

Consulta la guía completa de credenciales para más detalles.

Verificar Compilación Local

Primero, asegúrate de que tu aplicación compile localmente sin errores:

# Compila tus recursos web
npm run build

# Sincroniza con Capacitor
npx cap sync

# Prueba compilación local (opcional pero recomendado)
npx cap open ios    # Para iOS
npx cap open android # Para Android

Autenticarse con Capgo

Configura tu clave API de Capgo (si no está ya configurada):
Terminal window
```
npx @capgo/cli@latest login
```
O configura la variable de entorno:
Terminal window
```
export CAPGO_TOKEN=tu_clave_api_aquí
```

Ejecutar Tu Primera Compilación

Comienza con una compilación de debug de Android (la más rápida para probar):

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

Verás registros en tiempo real a medida que progresa tu compilación:

✔ Creando trabajo de compilación...
✔ Subiendo proyecto (15.2 MB)...
✔ Compilación iniciada

📝 Registros de compilación:
→ Instalando dependencias...
→ Ejecutando compilación Gradle...
→ Firmando APK...
✔ Compilación exitosa en 3m 42s

Verificar Estado de Compilación

El CLI automáticamente encuestará y mostrará el estado de compilación. Una vez completado, verás:
- Tiempo de compilación
- Estado de éxito/fallo
- Aplicación enviada a App Store/Play Store (si las credenciales están configuradas)

Entendiendo el Proceso de Compilación

Cuando ejecutas el comando de compilación, esto es lo que sucede:

graph LR
    A[Tu Máquina] -->|1. Comprimir Proyecto| B[Temp Local]
    B -->|2. Subir| C[Capgo Cloud]
    C -->|3. Compilar| D[Servidor de Compilación]
    D -->|4. Stream de Registros| A
    D -->|5. Limpieza| E[Auto Eliminar]

Preparación Local - Tu proyecto se comprime (excluyendo node_modules y archivos ocultos)
Subida - El zip se sube a almacenamiento en la nube seguro (Cloudflare R2)
Ejecución de Compilación - Tu aplicación se compila en infraestructura dedicada
Streaming de Registros - Los registros en tiempo real se transmiten a tu terminal vía Server-Sent Events
Limpieza Automática - Los artefactos de compilación se eliminan (Android: instantáneo, iOS: 24 horas)

Tu Primera Compilación de Producción

Una vez que hayas verificado que el proceso funciona, crea una compilación de producción:

Android

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

Necesitarás configurar primero las credenciales de firma. Consulta Configuración de Compilación Android.

iOS

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

Las compilaciones iOS requieren certificados de firma y perfiles de aprovisionamiento. Consulta Configuración de Compilación iOS.

Qué se Compila

Importante: Capgo Cloud Build solo compila las partes nativas de tu aplicación (código nativo iOS y Android).

Tú eres responsable de:

Compilar tus recursos web (npm run build)
Ejecutar npx cap sync antes de la compilación
Asegurar que todas las dependencias estén en package.json

Nosotros nos encargamos de:

Compilación nativa iOS (Xcode, Fastlane)
Compilación nativa Android (Gradle)
Firma de código
Envío a tiendas de aplicaciones (si está configurado)

Tiempo y Costos de Compilación

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

Android: Típicamente 3-5 minutos (multiplicador de facturación 1×)
iOS: Típicamente 5-10 minutos (multiplicador de facturación 2× debido a costos de hardware Mac)

Solo pagas por el tiempo de compilación real usado. Sin cargos ocultos.

Casos de Uso Comunes

Integración CI/CD

Agregar a tu flujo de trabajo de GitHub Actions:

- name: Build native app
  env:
    CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
  run: |
    npm run build
    npx cap sync
    npx @capgo/cli@latest build ${{ secrets.APP_ID }} \
      --platform both \
      --build-mode release

Desarrollo Local

Probar compilaciones localmente antes de confirmar:

# Compilación de debug rápida para pruebas
npm run build && npx cap sync
npx @capgo/cli@latest build com.example.app \
  --platform android \
  --build-mode debug

Compilaciones Multi-Plataforma

Compilar para ambas plataformas simultáneamente:

npx @capgo/cli@latest build com.example.app \
  --platform both \
  --build-mode release

Próximos Pasos

Ahora que has creado tu primera compilación:

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

¿Necesitas Ayuda?

Consulta la guía de solución de problemas
Únete a nuestra comunidad Discord
Envía un correo a soporte en support@capgo.app