🏗️ build

🏗️ Compila aplicaciones móviles nativas en la nube y envíalas automáticamente a App Store y Play Store.

Descripción General

El comando build te permite compilar tu aplicación Capacitor para iOS y Android en la infraestructura en la nube de Capgo, similar a cómo Expo maneja las compilaciones. Tu aplicación se compila en infraestructura dedicada y puede enviarse automáticamente a las tiendas de aplicaciones.

Estado Actual: Beta Pública

¿Por Qué Usar Cloud Build?

Compilar aplicaciones móviles nativas tradicionalmente requiere:

Hardware Mac para compilaciones iOS ($1000+ o costosos minutos de CI)
Configuración compleja de CI/CD con caché y credenciales
Sobrecarga de mantenimiento para Xcode, Android Studio y SDKs

Con Capgo Cloud Build, obtienes:

✅ No se requiere Mac - Compila aplicaciones iOS desde cualquier máquina
✅ Sin configuración - No se necesita configuración de CI/CD
✅ Probado en batalla - Construido sobre 3 años de uso interno en producción
✅ Seguro - Sin almacenamiento de registros, limpieza automática
✅ Solo nativo - Tu JavaScript se mantiene privado

Inicio Rápido

npx @capgo/cli@latest build com.example.app

¡Eso es todo! Tu aplicación se compilará en la nube y verás registros en tiempo real.

Secciones de Documentación

⚠️ Configura las Credenciales PRIMERO

Requerido antes de compilar: Guarda tus credenciales iOS/Android localmente.

Configurar Credenciales →

Comenzar

Crea tu primera compilación nativa en minutos.

Leer guía →

Compilaciones iOS

Configura certificados y compila para App Store.

Configurar iOS →

Compilaciones Android

Configura keystores y compila para Play Store.

Configurar Android →

Solución de Problemas

Soluciones a problemas comunes de compilación.

Obtener ayuda →

Referencia de Comandos

Uso Básico

npx @capgo/cli@latest build [appId] [opciones]

Ejemplos

Compilar para ambas plataformas:

npx @capgo/cli@latest build com.example.app

Compilar solo para iOS:

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

Compilar para Android en modo debug:

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

Compilar desde un directorio específico:

npx @capgo/cli@latest build com.example.app --path ./my-app

Opciones

Opción	Tipo	Por Defecto	Descripción
`appId`	string	capacitor.config	ID de Aplicación (ej., com.example.app)
`--path <ruta>`	string	Directorio actual	Ruta al directorio de tu proyecto
`--platform <plataforma>`	string	both	Plataforma objetivo: `ios`, `android`, o `both`
`--build-mode <modo>`	string	release	Modo de compilación: `debug` o `release`
`--build-config <config>`	string	-	Configuración adicional de compilación como cadena JSON
`-a, --apikey <apikey>`	string	-	Clave API (o usa la variable de entorno `CAPGO_TOKEN`)
`--supa-host <url>`	string	https://api.capgo.app	URL personalizada del host Supabase
`--supa-anon <key>`	string	-	Clave anon personalizada de Supabase

Cómo Funciona

sequenceDiagram
    participant Dev as Desarrollador
    participant CLI as Capgo CLI
    participant Cloud as Capgo Cloud
    participant iOS as Constructor Mac
    participant Android as Constructor Android

    Dev->>CLI: build com.example.app
    CLI->>CLI: Comprimir proyecto localmente
    CLI->>Cloud: Subir a R2
    Cloud->>iOS: Aprovisionar Mac (iOS)
    Cloud->>Android: Iniciar sandbox (Android)
    iOS-->>CLI: Stream de registros (SSE)
    Android-->>CLI: Stream de registros (SSE)
    iOS->>Cloud: Compilación completa
    Android->>Cloud: Compilación completa
    Cloud->>iOS: Limpieza (24h después)
    Cloud->>Android: Limpieza (instantánea)
    CLI->>Dev: Compilación exitosa

Proceso de Compilación

Preparación Local - Tu proyecto se comprime localmente (excluyendo node_modules, archivos ocultos)
Subida - El archivo zip se sube a almacenamiento en la nube seguro (Cloudflare R2)
Ejecución de Compilación:
- iOS: Se aprovisiona máquina Mac dedicada, Fastlane compila y firma
- Android: Se crea sandbox seguro, Gradle compila y firma
Streaming de Registros - Registros en tiempo real vía Server-Sent Events (¡no se almacenan!)
Limpieza Automática:
- iOS: Archivos eliminados después de 24 horas cuando se libera la máquina
- Android: Todo se elimina instantáneamente después de la compilación

Nuestra Experiencia

Capgo Cloud Build no es infraestructura nueva - la hemos estado usando internamente durante 3 años:

✅ Fastlane Personalizado - Construido específicamente para aplicaciones Capacitor
✅ Miles de compilaciones - Probado en batalla en producción
✅ Expertos en Capacitor - Conocimiento profundo de lo que importa
✅ Enfoque solo en nativo - Tu JavaScript nunca toca nuestros servidores

Seguridad y Privacidad

Sin almacenamiento de registros - Los registros solo se transmiten a tu terminal, nunca se guardan
Sin almacenamiento de artefactos - Las aplicaciones se envían directamente a App Store/Play Store, no guardamos nada
Credenciales auto-eliminadas - Solo se usan durante la compilación, eliminadas después (máx. 24h)
Compilaciones aisladas - Cada compilación se ejecuta en aislamiento
Tu código sigue siendo tuyo - Solo compilamos partes nativas, JavaScript permanece local

Integración CI/CD

Funciona en todas partes - GitHub Actions, GitLab CI, o cualquier plataforma CI/CD:

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

No necesitas:

Runners Mac
Instalación de Android SDK
Instalación de Xcode
Caché complejo
Gestión de credenciales

Precios

El tiempo de compilación se factura según el uso real:

Android: Multiplicador 1× (~$0.XX por minuto)
iOS: Multiplicador 2× (~$0.XX por minuto, debido al hardware Mac)

Costos típicos:

Debug Android: 3 min × 1× = ~$X.XX
Release iOS: 7 min × 2× = ~$X.XX

Solo pagas por lo que usas. Sin mínimos, sin sorpresas.

Comparación con Otras Soluciones

Característica	Capgo Cloud Build	GitHub Actions (Mac)	Expo EAS
Mac requerido localmente	❌ No	✅ Sí	❌ No
Complejidad de configuración	⭐ Comando único	⭐⭐⭐ YAML complejo	⭐⭐ Archivos de config
Nativo Capacitor	✅ Optimizado	⚠️ Genérico	❌ Solo Expo
Privacidad de tu código	✅ Nunca almacenado	⚠️ En runners	⚠️ Subido
Costo (iOS)	💰 2× base	💰💰💰 10× costoso	💰💰 Premium

Qué se Compila

Importante: Capgo compila solo partes nativas.

✅ Nosotros compilamos:

Código nativo iOS (Swift, Objective-C, proyectos Xcode)
Código nativo Android (Java, Kotlin, proyectos Gradle)
Firma de código y envío a tiendas de aplicaciones

❌ Tú compilas (localmente):

JavaScript, HTML, CSS (npm run build)
Sincronización Capacitor (npx cap sync)
Tus recursos web

Esta separación asegura:

Mejor seguridad - La lógica de tu aplicación permanece privada
Compilaciones más rápidas - Sin compilaciones web duplicadas
Responsabilidad clara - Tú controlas tu código

Limitaciones

Limitaciones actuales durante la beta pública:

Tiempo de espera de compilación: Máximo 10 minutos
Tiempo de espera de subida: 1 hora para URL de subida
Máquina iOS: Requisito de arrendamiento de 24 horas, la compilación en Mac se pondrá en cola para asegurar un uso óptimo
Acceso: Solo beta pública

Comenzar

¿Listo para compilar sin complicaciones?

Crea Tu Primera Compilación

Guía paso a paso para tu primera compilación en la nube.

Comenzar →

Únete a la Beta Pública

Cloud Build está en beta pública. Únete a nuestra comunidad para obtener acceso.

Únete a Discord →

Aprende Más

Guía de Comenzar - Crea tu primera compilación
Configuración iOS - Configura compilaciones iOS
Configuración Android - Configura compilaciones Android
Solución de Problemas - Problemas comunes y soluciones
Blog: Presentamos Cloud Build - Anuncio de característica

🏗️ build

Descripción General

¿Por Qué Usar Cloud Build?

Inicio Rápido

Secciones de Documentación

Referencia de Comandos

Uso Básico

Ejemplos

Opciones

Cómo Funciona

Proceso de Compilación

Nuestra Experiencia

Seguridad y Privacidad

Integración CI/CD

Precios

Comparación con Otras Soluciones

Qué se Compila

Limitaciones

Comenzar

Aprende Más

¿Necesitas Ayuda?