Configuración de inicio

Comienza con Capgo Cloud Build y crea tu primer build nativo de iOS o Android en minutos.

Lo que necesitarás

Antes de empezar, asegúrese 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)
• Su aplicación ya registrada en Capgo (ejecute 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.)

Configure sus credenciales de firma

Capgo necesita credenciales de firma para compilar y enviar su aplicación — pero no tiene que manejarlas a mano. Responda a un par de preguntas y le indicaremos el comando exacto a ejecutar:

Ejecutar su primera compilación

Debes estar autenticado con Capgo para construir. 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 acabas de ejecutar build initya estás listo — la onboarding te ofrece iniciar una construcción para ti al final, por lo que tu primera construcción puede estar en camino ya. 🎉

De lo contrario, inicia una construcción tú mismo con build request — establece --platform a la 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 construcción en vivo en tu terminal. Capgo La construcción 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 Construcció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. Subida - 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 mediante eventos de servidor.
5. Limpieza El entorno de compilación y los datos de proyecto temporales se eliminan después de la compilación; la retención de salida depende de las opciones de artefacto y entrega seleccionadas.

Use Capgo Construye con Bitrise o otro CI

Capgo Construye no reemplaza su CI existente. Mantenga los pasos que necesitan su acceso privado en Bitrise o 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, llama a Capgo Construye con el proyecto nativo preparado. Capgo recibe el proyecto listo ios/ o android/ project to compile and sign, so it does not need your private Nexus, CocoaPods SSH, or web-build credentials. The compiled web assets are already inside that prepared native project; they are used for the build rather than retained as a source repository.

¿Qué se construye

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__ Construye recibe el proyecto nativo requerido para compilar su aplicación. Su fuente web __CAPGO_KEEP_1__, instalación de dependencias privadas y __CAPGO_KEEP_2__ sincronización permanecen en su CI.

Included	Descripción
ios/ o android/	La carpeta de plataforma nativa que estás construyendo
package.json, package-lock.json	Manifesto de dependencias
capacitor.config.*	Capacitor configuración
resources/	Iconos de la aplicación, pantallas de bienvenida
Plugin nativo code	Solo el ios/ o android/ subcarpeta de cada plugin Capacitor

¿Qué NO se sube

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

Nota

Sus activos web compilados (JS, CSS y HTML) se suben solo porque npx cap sync ha copiado ellos 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 Resuelve registros de paquetes privados, CocoaPods basados en SSH, SDKs de dispositivos, extensiones y cualquier preparación nativa personalizada en Bitrise o tu CI existente.
2. Compilar sus activos web - Ejecute npm run build (o el comando de compilación de su framework).
3. Sincronizar con nativo - Ejecuta npx cap sync para copiar los activos web compilados en el proyecto nativo preparado.
4. Solicite la compilación nativa - Envía el proyecto preparado ios/ o android/ proyecto para Capgo Construir.

proyecto a Capgo Build.

• Título de sección “¿Qué __CAPGO_KEEP_0__ Build Maneja?”
• Compilación nativa de iOS (Xcode, Fastlane)
• Code signing with your credentials
• Presentación opcional en App Store Connect o Google Play
• Configuración nativa de compilación admitida y valores de credenciales pasados como variables de entorno

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

Para una versión de kiosk distribuida a través de MDM, configure 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 subida a Play Store incluso si se han guardado las credenciales de Play; --output-upload evita la carga en la tienda de aplicaciones Play incluso si se han guardado credenciales de Play;

Próximos Pasos

Ahora que has creado tu primera compilación:

• Configura edificios de iOS - Establecer certificados y perfiles
• Configura edificios de Android - Establecer claves y Play Store
• Troubleshooting Problemas comunes y soluciones
• Referencia de CLI __CAPGO_KEEP_0__ Referencia

¿Necesitas ayuda?

• Revisa Guía de solución de problemas
• Únete a nuestra comunidad de Discord
• Envía un correo electrónico a soporte@capgo.app