Empezar

Empecé con Capgo Cloud Build y crea tu primera 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 construye con éxito localmente
• Node.js 20 o superior instalado
• Una cuenta Capgo (un período de prueba gratuito es suficiente para empezar)
• Tu aplicación ya registrada en Capgo (corre npx @capgo/cli@latest app add si no)
• No es necesario preparar credenciales de firma con anticipación — las configuraremos en el siguiente paso.

Configura tus credenciales de firma

Capgo necesita credenciales de firma para construir y enviar tu aplicación — pero no tienes que manejarlas manualmente. Responde a un par de preguntas y te indicaremos el comando exacto a ejecutar:

Ejecuta tu primera construcción

Necesitas estar autenticado con Capgo para compilar. Si aún no lo has hecho:

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

Si acabo 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 — establece --platform en lo que estás construyendo:

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

La CLI sube el proyecto nativo preparado y transmite registros de compilación en vivo en tu terminal. Capgo Compilar puede devolver un artefacto firmado o enviarlo a App Store Connect o Google Play cuando configures el flujo de liberación adecuado.

Entendiendo el Proceso de Compilación

Cuando ejecutes la orden de compilación, esto es lo que sucede:

flowchart LR
    A[Your CI] -->|1. Prepare Native Project| B[Prepared iOS / Android Project]
    B -->|2. Upload| C[Capgo Build]
    C -->|3. Compile and Sign| D[Dedicated Build Infrastructure]
    D -->|4. Stream Logs| E[Your Terminal]
    D -->|Return Signed Artifact or Store Delivery| F[Output]
    D -->|5. Clean Temporary Project Data| G[Cleanup]

1. Preparación en tu CI - Compila la capa web, resuelve las dependencias privadas y sincroniza los activos completados en el proyecto nativo.
2. Subir - El proyecto nativo preparado se sube a un almacenamiento en la nube seguro para la compilación.
3. Ejecución de la Compilación - Capgo compila y firma el proyecto nativo en infraestructura dedicada.
4. Streaming de Registros - Los registros en tiempo real se envían a tu terminal a través de eventos servidor-sentidos.
5. Limpieza - Después de la compilación, se limpian el entorno de compilación y los datos de proyecto temporales; la retención de la salida depende de las opciones de artefacto y entrega seleccionadas.

Usar Capgo Compilar con Bitrise o otro CI

Capgo Compilar no reemplaza su CI existente. Mantenga los pasos que necesitan su acceso privado en Bitrise o en otro sistema de CI: instalar desde registros privados, resolver CocoaPods privados sobre SSH, ejecutar configuración nativa personalizada, compilar la capa web y ejecutar npx cap sync.

Entonces, llame a Capgo Compilar con el proyecto nativo preparado. Capgo recibe el proyecto listo ios/ o android/ Contexto: Fragmento de texto HTML de una cadena de Capgo UI más larga (clave de padre `alternatives_cta_questions`). Página/área: Comparación de alternativas de actualización en vivo de Capacitor. Papel: Párrafo de marketing o legal largo. Visto en: página alternatives.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `alternatives_cta_questions` (Preguntas de llamada a la acción de alternativas). | Fragmento de texto HTML de una cadena de Capgo UI más larga (clave de padre `appflow_cta_questions`). Página/área: Copia de marketing de comparación/migración de Appflow. Papel: Párrafo de marketing o legal largo. Visto en: página ionic-appflow.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `appflow_cta_questions` (Preguntas de llamada a la acción de Appflow). | Fragmento de texto HTML de una cadena de Capgo UI más larga (clave de padre `capwesome_cta_questions`). Página/área: Página de comparación de Capawesome. Papel: Párrafo de marketing o legal largo. Visto en: página capwesome.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `capwesome_cta_questions` (Preguntas de llamada a la acción de Capawesome). | Fragmento de texto HTML de una cadena de Capgo UI más larga (clave de padre `consulting_faq_subtitle`). Página/área: Página de servicios de consultoría. Papel: Título de sección o etiqueta. Visto en: página consulting.astro. Preservar términos de producto y marca de Capgo y términos de desarrollador exactamente. Clave de mensaje `consulting_faq_subtitle` (Título de sección de preguntas frecuentes de consultoría). | Página/área: Copia de marketing de comparación/migración de Appflow. Papel: Etiqueta de UI corta o elemento de navegación. Visto en: página ionic-appflow.astro, página ionic-enterprise-plugins.astro, página soluciones/ionic-enterprise-plugins.astro. Clave de mensaje `appflow_plugins_or` (Appflow Plugins O).

El proyecto se compila y firma, por lo que no necesita sus credenciales de Nexus privado, SSH de CocoaPods o de construcción web. Los activos web compilados ya están dentro del proyecto nativo preparado; se utilizan para la compilación en lugar de retenerse como repositorio de origen.

Capgo Build receives the prepared native project required to compile your app. Your web source code, private dependency installation, and Capacitor sync remain in your CI.

__CAPGO_KEEP_0__ Compilar recibe el proyecto nativo preparado necesario para compilar su aplicación. Su fuente web __CAPGO_KEEP_1__, la instalación de dependencias privadas y __CAPGO_KEEP_2__ sincronización permanecen en su CI.

Incluido	Descripción
ios/ o android/	¿Qué se sube?
package.json, package-lock.json	La carpeta de plataforma nativa que estás construyendo
capacitor.config.*	Capacitor configuration
resources/	__CAPGO_KEEP_0__ configuración
Native plugin code	Plugin nativo __CAPGO_KEEP_0__ ios/ Solo los android/ subfolder of each Capacitor plugin

¿Qué NO se sube

Excluidos	¿Por qué?
node_modules/ (la mayoría de ellas)	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 configuraciones de IDE
.envSecretos	Nunca subido

Nota

Sus activos web construidos (JS, CSS y HTML) se suben solo porque npx cap sync ha copiado en el proyecto nativo. Los pasos de la fuente web y la instalación de dependencias se quedan en su CI; el proyecto nativo preparado se utiliza para construir el binario y luego se limpia.

Sus Responsabilidades

Antes de ejecutar npx @capgo/cli@latest build request:

1. Preparar en su CI - Resuelva registros de paquetes privados, CocoaPods basados en SSH, SDKs de dispositivos, extensiones y cualquier preparación nativa personalizada en Bitrise o su CI existente.
2. Construya sus activos web - Ejecute npm run build (o su comando de compilación de marco de trabajo).
3. Sincronizar con nativo - Ejecutar npx cap sync para copiar los activos web compilados en el proyecto nativo preparado.
4. Solicitar la compilación nativa - Enviar el proyecto preparado ios/ o android/ ¿Qué Capgo Build Gestiona?

¿Qué Capgo Build Maneja?

• Compilación nativa de Android (Gradle)
• ¿Qué __CAPGO_KEEP_0__ Build Maneja? Compilación nativa de iOS (Xcode, Fastlane) y compilación nativa de Android (Gradle)
• Code firma con tus credenciales
• Presentación opcional en App Store Connect o Google Play
• Configuración de compilación nativa admitida y valores de credenciales pasados como variables de entorno

Capgo La compilación no necesita acceso a tu registro privado de Nexus o credenciales SSH una vez que tu CI ha preparado el proyecto nativo. Consulta Configuración de compilación para obtener información sobre variables de entorno admitidas y opciones de almacenamiento.

Para una versión de kiosk distribuida a través de MDM, configura el proyecto Android/compilación para producir un APK. Al solicitar la compilación, utilice ambos flags para saltar Google Play y obtener el resultado firmado:

npx @capgo/cli@latest build request YOUR_APP_ID --platform android --no-playstore-upload --output-upload

--no-playstore-upload evita la carga en la tienda Play incluso si se han guardado credenciales de Play; --output-upload proporciona un enlace temporal al resultado firmado. Distribuye ese APK a través de tu MDM.

Pasos siguientes

Ahora que has creado tu primer build:

• Configura builds de iOS - Configura certificados y perfiles
• Configura builds de Android - Configura keystore y Play Store
• Solución de problemas contexto: Página/área: Soporte / página de soporte premium o sección de soporte en el pie de página. Rol: Título de sección o página. Visto en: página support-policy.astro. Clave de mensaje `support_policy_troubleshooting_title` (Título de solución de problemas de soporte).
• CLI Reference __CAPGO_KEEP_0__ Referencia

- Documentación completa de comandos

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