Do I need a Mac at any point?

Not to compile, sign, or upload. Builds run on Capgo's Mac mini M4 machines. You still need an Apple Developer account. On Windows or Linux, you create the App Store Connect API key in your browser, then the CLI handles certificates and profiles.

How long does an iOS build take?

A typical native build takes 2–3 minutes. Logs stream to your terminal while it runs, so you see errors as they happen.

Can the build go straight to TestFlight?

Yes. With an App Store Connect API key in your credentials, the signed build uploads to App Store Connect, where you test it in TestFlight and submit it for App Store review. Add --output-upload if you also want a download link for the IPA.

Where are my certificates stored?

On your machine, in ~/.capgo-credentials/credentials.json by default, or in your CI secrets. They are sent to Capgo only for the duration of a build and deleted afterwards.

Para desarrolladores de Windows y Linux

Desarrolla aplicaciones iOS sin necesidad de un Mac

Capgo Build compila y firma tu Capacitor aplicación iOS en máquinas Mac en la nube. Ejecuta un solo comando CLI desde Windows, Linux o CI, y el archivo firmado se sube a App Store Connect para TestFlight.

2–3 min

construcción nativa típica

iOS + Android

desde el mismo CLI

TestFlight

subida directa a App Store Connect

Capgo Construye

npx @capgo/cli@latest build init --platform ios
npx @capgo/cli@latest build request --platform ios
# signed build runs on an ephemeral Mac runner
# logs stream back to your terminal

Máquinas Mac de Cloud

Los builds de iOS se ejecutan en máquinas Mac mini M4 dedicadas. Los inicia desde el ordenador que ya usas.

Firmado y subido

La compilación está firmada con tu certificado y se sube a App Store Connect, lista para TestFlight.

El problema

Xcode solo funciona en macOS

No hay Mac, no hay compilación de iOS

Las herramientas de compilación de Apple necesitan macOS. Un desarrollador en Windows o Linux no puede compilar o firmar una compilación de iOS en su propia máquina.

La firma vive en una sola laptop

Los certificados y perfiles a menudo se encuentran en la Mac de una persona. Cuando esa persona está ausente o un perfil expira, la liberación espera.

La CI macOS autogestionada es su propio proyecto

Un ejecutor macOS alquilado todavía necesita actualizaciones de Xcode, rutas de Fastlane, secretos de firma y depuración cuando Apple cambia algo.

El trabajo oculto

What a release build needs besides a Mac

Comprar un Mac solo resuelve la parte de hardware. Todavía necesitas configurar la cuenta de Apple, firmar archivos y herramientas de compilación que alguien sigue mejorando.

Configuración de cuenta de Apple

Una cuenta de desarrollador de Apple con derechos de administrador, un ID de paquete, un registro de aplicación de App Store Connect y una API clave para subidas.

Crear firmas de archivos y perfiles

Una certificación de distribución exportada como .p12, un perfil de provisión para cada ID de paquete y renovaciones cuando expiran.

Herramientas de compilación

La versión correcta de Xcode, CocoaPods o Swift Package Manager, Fastlane y un lugar para guardar secretos para CI.

Cómo funciona

Cómo los desarrolladores de Windows y Linux envían iOS con Capgo

Necesitas una aplicación Capacitor, una cuenta Capgo y una cuenta de desarrollador de Apple. Cada comando a continuación proviene de los documentos de la Capgo CLI.

Configura la firma de iOS una vez

La onboarding lee tu proyecto Capacitor, crea la certificación de distribución y el perfil de provisión, y los guarda en tu máquina.
```
npx @capgo/cli@latest build init --platform ios
```
Guía de compilación de iOS

O guardar archivos de firma que ya tienes

Si tu equipo ya tiene una certificación y perfil, guarda ellos con tu clave API de App Store Connect. Quedan en un archivo de credenciales local.

npx @capgo/cli@latest build credentials save --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key ./AuthKey_XXXXX.p8 \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate ./certificate.p12 \
  --ios-provisioning-profile ./profile.mobileprovision

Gestión de credenciales

Solicite la compilación

Para sincronizar su compilación web en el proyecto iOS, solicite la compilación. Los registros se muestran en su terminal y la compilación firmada se sube a App Store Connect para TestFlight.
```
npx cap sync ios
npx @capgo/cli@latest build request com.example.app --platform ios
```
Guía de primeros pasos
Ejecute el mismo comando en CI

Exporte sus credenciales guardadas como secretos de CI con la gestión de credenciales de compilación, establezca CAPGO_TOKEN y ejecute la solicitud de compilación en GitHub Actions, GitLab CI o cualquier ejecutor.
```
npx @capgo/cli@latest build credentials manage
# in your CI job
npx @capgo/cli@latest build request com.example.app --platform ios
```
Configuración de GitHub Actions

La Solución

¿Qué Capgo Build gestiona por ti

Los compilados nativos se ejecutan en la nube cuando cambian los code. Los cambios web siguen enviándose como actualizaciones en vivo entre las liberaciones de la tienda.

Cloud Macs only when you build

iOS builds run on dedicated Mac mini M4 machines with Xcode installed. Your Windows or Linux laptop, or a CI runner, sends the request from the terminal.

Capgo Build overview

Firma de iOS guiada

build init creates the distribution certificate and provisioning profile for you. It uses an App Store Connect API key, which you create in your browser when you are on Windows or Linux.

Guía de construcción de iOS

La misma orden de comandos localmente y en CI

Guarda tus credenciales una vez y ejecuta la solicitud de compilación desde una terminal, GitHub Acciones, GitLab CI o cualquier otra pipeline.

referencia de comando de construcción

Construcciones nativas más actualizaciones en vivo

Use Capgo Construye cuando cambien plugins, permisos, iconos o la Capacitor versión. Envíe cambios en JavaScript, CSS y activos como actualizaciones en vivo después de que los usuarios instalen la construcción de la tienda.

Live update o construcción nativa?

Modelo de confianza

Use hardware en la nube sin entregar su code y llaves

Las credenciales permanecen en su máquina o en sus secretos de CI. Capgo solo las almacena mientras una construcción se ejecuta.

Sólo se sube el proyecto nativo

CLI sube el folder de plataforma nativa y dependencias nativas. Su repositorio completo permanece en su máquina.

Registros de logs se transmiten a tu terminal

Build logs stream live while the build runs and are not stored on Capgo servers.

Las credenciales existen solo durante la construcción

Los certificados y perfiles se utilizan en memoria durante la construcción y se eliminan cuando termina. Cada construcción se ejecuta en un entorno aislado que se destruye después.

Aplicaciones construidas con Capacitor

No esperes a que una aplicación local en un Mac se ejecute

Las aplicaciones de transporte, apoyo y educación todavía necesitan versiones móviles firmadas cuando el equipo es principalmente web, apoyo o operaciones. Los flujos de trabajo de construcción hospedados eliminan la botella de un solo equipo mientras mantienen los pasos de firma repetibles.

Educación

IRIS ParentMail

Aplicación de comunicaciones escolares donde los equipos no nativos aún necesitan versiones firmadas confiables.

Instalaciones de Google Play: 1,2M; Instalaciones de Google Play
Calificación de la tienda: 2.8; Calificación de la tienda

TRAVEL AND LOCAL

KAI Access: Reserva de tren

Aplicación de reserva de transporte donde la entrega de la versión no debe depender de una máquina de un desarrollador.

Instalaciones de Google Play: 13,5M; Instalaciones de Google Play
Calificación de la tienda: 3.6; Calificación de la tienda

Herramientas

Técnico Virtual – Soporte Técnico

Utilidad de soporte donde los equipos de operaciones necesitan registros de compilación móvil repetibles.

Instalaciones de Google Play: 10.3M; Instalaciones de Google Play
Calificación de la tienda: 4.3; Calificación de la tienda

Canal de próxima versión

Utiliza los mismos controles de lanzamiento para tu aplicación.

Crear un canal de lanzamiento controlado, publicar una pequeña actualización web y mantener lista la reversión desde la primera versión.

Repetibilidad de firmas de iOS y Android
Lanzamiento de la mano sin hardware local
Registros de construcción propiedad de CI

Pruebas de clientes

Lo que los equipos que envían con Capgo dicen

5.0/5 Calificada por equipos de desarrolladores 9,400+ Equipos Lee reseñas

sikafanka

Diseño, radio 5

“Capgo Build nos ayudó a simplificar nuestro Capacitor proceso de lanzamiento de la aplicación. Podemos construir y enviar aplicaciones de iOS y Android desde un flujo de trabajo claro.”

Mikołaj Wilczek

Ingeniero principal de plataformas móviles, Tellent

“Originalmente descubrimos Capgo a través de sus plugins, y resultó ser un gran punto de entrada a un proceso de lanzamiento más eficiente para nuestro equipo.”

FAQ

Preguntas sobre construir iOS sin Mac

¿Qué desarrolladores de Windows y Linux preguntan antes de su primer build de iOS en la nube.

¿Necesito un Mac en algún momento?

No para compilar, firmar o subir. Las compilaciones se ejecutan en las máquinas Mac mini M4 de Capgo. Todavía necesitas una cuenta de desarrollador de Apple. En Windows o Linux, creas la clave de App Store Connect API en tu navegador, luego los CLI maneja certificados y perfiles.

Guía de compilación de iOS

¿Cuánto tiempo dura una compilación de iOS?

Un build nativo típico tarda entre 2–3 minutos. Los registros se muestran en tu terminal mientras se ejecuta, por lo que ves errores en tiempo real.

Guía de inicio

¿Puede la compilación ir directamente a TestFlight?

Sí. Con una clave de App Store Connect API en tus credenciales, la compilación firmada se sube a App Store Connect, donde la pruebas en TestFlight y la envías para revisión en la Tienda de App. Agrega --output-upload si también deseas un enlace de descarga para el IPA.

Configuración de compilación

¿Dónde están almacenados mis certificados?

En tu máquina, en ~/.capgo-credentials/credentials.json por defecto, o en tus secretos de CI. Se envían a Capgo solo durante la duración de una compilación y se eliminan después.

Administración de credenciales

¿Necesito un nuevo build por cada cambio?

No. Plugin, permission, icon, and Capacitor version changes need a new native build. JavaScript, HTML, CSS, and asset changes can ship as live updates to users who already have the store build.

¿Live update o compilación nativa?

Envíe iOS sin comprar un Mac

Realice su primera compilación firmada de iOS durante la prueba gratuita de 14 días, luego agregue Android, CI y actualizaciones en vivo cuando los necesite.