Empezar

Empezar con Capgo Cloud Build y crear tu primera compilación nativa 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 (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 próximo paso.)

Configura tus credenciales de firma

Capgo necesita credenciales de firma para compilar y enviar tu aplicación — pero no tienes que manejarlas a mano. Responde a un par de preguntas y te diremos qué comando ejecutar:

Ejecuta tu primera compilació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 te 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 el 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 Build 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, aquí 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 transmiten a tu terminal mediante eventos de servidor a servidor.
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 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 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 CTA de alternativas). | Fragmento de texto HTML de una cadena de Capgo UI más larga (clave de padre `appflow_cta_questions`). Página/área: Comparación/migración de marketing 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 CTA de Appflow). | Fragmento de texto HTML de una cadena de Capgo UI más larga (clave de padre `capwesome_cta_questions`). Página/área: 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 CTA de Capwesome). | 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 FAQ de consultoría). | Página/área: Comparación/migración de marketing 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` (O plugins de Appflow).

proyecto para compilar y firmar, por lo que no necesita sus credenciales de Nexus privado, CocoaPods SSH o web-build.

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 de 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 ajustes de IDE
.envSecretos	Nunca subido

Nota

Sus activos web compilados (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. Compilar sus activos web - Ejecutar npm run build o (o su comando de compilación de la plataforma).
3. Sincronizar con nativo - Ejecutar npx cap sync a copiar los activos web compilados en el proyecto nativo preparado.
4. Solicitar la compilación nativa - Enviar el proyecto preparado ios/ o android/ project to Capgo Build.

proyecto a Capgo Build.

• Título de sección: ¿Qué __CAPGO_KEEP_0__ Build Maneja?
• Compilación nativa de iOS (Xcode, Fastlane)
• Code firma con tus credenciales
• __CAPGO_KEEP_0__ (opcional) Envío a App Store Connect o Google Play
• __CAPGO_KEEP_0__ Configuración de compilación nativa 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 el envío a la tienda Play Store 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 la parte inferior. 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