Compilaciones de iOS

Construya y envíe aplicaciones iOS a TestFlight y la Tienda de Mac App utilizando la infraestructura Mac dedicada de Capgo.

Lo que aprenderás

• Aprenderá a subir su aplicación a través de Capgo Native build
• Aprenderá a configurar los certificados para Capgo Native Build

Requisitos previos

• Una cuenta de Capgo (basta con una prueba gratuita para empezar)
• Su aplicación ya registrada en Capgo (ejecute bunx @capgo/cli@latest app add Si no está registrado)
• Un ordenador Mac con Xcode instalado (es posible configurar la compilación en una máquina Linux/Windows, pero aún no está documentado)
• Una cuenta de desarrollador válida de Apple ($99/año) (Debes tener derechos de administrador o propietario en la cuenta del desarrollador de Apple)
• Su aplicación debe poder compilar con éxito a través de Xcode
• Una aplicación de Capacitor
• Un icono configurado para la aplicación. Las aplicaciones sin icono no pueden subirse a la Tienda de Aplicaciones

Nota

Utilizaré la siguiente aplicación para el tutorial: https://github.com/Cap-go/capgo-native-build-tutorial-app

Antes de empezar en los portales de Apple

Antes de configurar certificados o desencadenar tu primer envío de TestFlight, asegúrate de que el cuenta de Apple y el equipo estén listos:

• Activar la autenticación en dos factores para la cuenta de Apple utilizada para la inscripción
• Elegir el tipo de membresía correcto:
  • Individual / Propietario único: tu nombre legal personal se convierte en el nombre del vendedor en la Tienda de Aplicaciones
  • Elegir el tipo de membresía correcto: Individual / Propietario único: requiere una entidad legal, un número D-U-N-S, un sitio web de empresa público, un correo electrónico de trabajo en el dominio de la empresa y una persona con autoridad para vincular a la organización a los acuerdos de Apple.
• Utilice una cuenta que pueda acceder a Apple Developer y App Store Connect para certificados, registros de aplicaciones, API claves y TestFlight.
• Concentre su ID de paquete final temprano. Cambiarlo más tarde suele significar volver a configurar App Store.
• Planifique estos elementos de App Store Connect antes de la revisión de App: URL de soporte, URL de política de privacidad, clasificación de edad, capturas de pantalla, cumplimiento de exportación y detalles de contacto de revisión de App.

Nota

Referencias oficiales útiles:

• Convertirse en miembro del programa de desarrolladores de Apple
• Enviar sus aplicaciones y juegos
• Información de versión de plataforma en App Store Connect

Advertencia

Apple actualiza regularmente su requisito mínimo de SDK. A partir de 28 de abril de 2026Recomendado: automatización de la incorporación iOS & iPadOS 26 SDK or later.

ventana de terminal

You don’t have to do any of this by hand. Capgo’s onboarding creates and configures your iOS signing credentials (distribution certificate + provisioning profile) for you — this is the recommended path:

bunx @capgo/cli@latest build init --platform ios

La guía paso a paso a continuación solo es para aquellos que prefieren configurar las credenciales ellos mismos, o quieren entender exactamente qué Capgo hace debajo de la cubierta.

La primera construcción manual

Antes de que podamos empezar a pensar en construir la aplicación con Capgo, debemos configurarla primero, y hacer una primera construcción de TestFlight a mano. Hay algunas ventajas en hacer una construcción manual primero:

• Configurará el certificado de distribución en su máquina local
• Crearán el registro de la Tienda de Mac si aún no lo han hecho
• Serán capaces de determinar cualquier problema con el proceso de construcción relacionado con su aplicación code

Antes de que podamos empezar, debe tener el certificado de distribución instalado en su máquina local. Esto es bastante complejo, pero lo explicaré a continuación.

Configuración del certificado de distribución

1. Abra Xcode

2. Haz clic en Xcode -> Settings... Alternativamente, puedes utilizar la atajada Cmd + ,

   

3. Ir a Accounts

4. Encuentra la cuenta de Apple que se ha agregado a la cuenta del desarrollador de Apple

5. Encuentra el equipo que utilizarás para desplegar la aplicación

6. Haz clic en el Manage Certificates... botón

7. Asegúrate de que puedas ver el certificado de distribución en la lista

8. Si no es así, debes crear un nuevo certificado

   Nota

   Apple limita el número de certificados de distribución que puedes tener a 3. Si tienes más de 3 certificados, debes eliminar uno para poder crear uno nuevo. No cubriré eso en el tutorial.

   1. Haz clic en el + botón y luego en Apple Distribution
   2. El certificado se creará automáticamente. Puedes verlo en la lista. Mira el paso anterior para confirmar que lo ves.

Ahora que tienes el certificado de distribución instalado, puedes comenzar el proceso de compilación.

Compilación manual para TestFlight

1. Abra la aplicación en Xcode

   Ejecutar bunx cap open ios para abrir la aplicación en Xcode.

2. Encuentre y haga clic en el archive botón

   En la barra de herramientas de Xcode, encuentre y haga clic en el product -> archive botón.

   

3. Esperar a que se complete la compilación

4. Haga clic en el Distribute App botón

   

5. Seleccionar TestFlight Internal Only selecciona como método de distribución y haz clic en Distribute botón

   

6. Configura el registro de la aplicación

   Rellena los siguientes campos:

   1. Nombre: El nombre de tu aplicación - visible en la Tienda de Mac
   2. SKU - el código SKU de tu aplicación - se utiliza para identificar tu aplicación en la Tienda de Mac
   3. Idioma principal - el idioma principal de tu aplicación

   Luego, haz clic en el next botón

   

7. Si la creación del registro de la app falla, intenta cerrar la ventana y intenta archivar la app de nuevo.

8. Espera a que la subida se complete

9. Si todo salió bien, deberías ver la siguiente pantalla

10. Haz clic en el Done botón

Puede que te parezca instintivamente que todo está bien ahora y que podrás ver tu app en TestFlight ahora, pero hay un par de cosas más que aún tienes que terminar:

1. Añade a TestFlight
2. Completa la conformidad de exportación para que la compilación se vuelva testable
3. Rellena los metadatos de App Store Connect obligatorios, como tu URL de soporte, URL de política de privacidad y clasificación de edad
4. Prepara capturas de pantalla que coincidan con los dispositivos que realmente soportas
5. Añada los detalles de contacto de la revisión de la aplicación y cualquier credencial de prueba antes de la presentación de producción

Vamos a empezar con el primero:

Agregarse a TestFlight

1. Ir a la página de Conexión de la Tienda de la App página de inicio de sesión de Conexión de la Tienda de la App

2. Seleccione el equipo que utilizó cuando creó el registro de la aplicación. Si solo tiene una cuenta de desarrollador, puede saltarse este paso.

3. Selección del equipo de Conexión de la Tienda de la App

4. Conexión de la Tienda de la App Apps botón

5. Encuentre la aplicación que creó en el paso anterior y haga clic en ella

6. Haga clic en el TestFlight botón

7. Haga clic en el Internal Testers plus botón de testadores internos más de App Store Connect

8. Me gusta llamar al grupo “internos”. Puede llamarlo lo que desee.

   botón

   

9. Haga clic en Invite testers botón

10. Agregarse a sí mismo al grupo

    Encuentre su nombre en la lista y seleccione la casilla al lado de su nombre. (Puede necesitar refrescar la página para verlo) Luego, haga clic en el Add botón.

    

11. Verificar que se ha agregado a sí mismo al grupo

    Ahora debería ver su nombre en el grupo.

    

¡Felicidades 🎉 Ha agregado a sí mismo a TestFlight. Ahora solo queda una cosa más que necesita hacer antes de configurar Capgo Native Build.

Configurando la información de conformidad

Ahora debes prometer a Apple que tu aplicación no utiliza ninguna criptografía no estándar (como un algoritmo personalizado). Si tu aplicación utiliza alguna criptografía no estándar, te recomiendo leer el documentación de Apple sobre cómo manejar esto. Hay dos formas de hacer esto:

1. Puedes hacer esto manualmente cada vez que construyas tu aplicación.
2. Puedes configurar tu archivo plist para establecer automáticamente este valor en false.

Vamos a empezar con la primera opción:

1. Sigue todos los pasos de la sección anterior para encontrar la sección TestFlight en App Store Connect

2. Haz clic en Builds -> iOS

3. Encuentra la construcción con información de conformidad faltante y haz clic en Manage

4. Seleccione la opción que mejor describa su aplicación

   Para mí, esto es nonepero puede ser diferente para ti. Después, haga clic en guardar

   

5. Su aplicación debería decir ahora ready to test

   

En cuanto al segundo, aquí están los pasos:

1. Abra el Info.plist archivo

2. Agregue la siguiente clave:

   <key>ITSAppUsesNonExemptEncryption</key>
   <false/>

3. Guardar el archivo

Nota

Aquí Aquí está la documentación oficial de Apple sobre cómo informar a Apple sobre su cumplimiento con las regulaciones de exportación de cifrado.

Instalar la aplicación TestFlight y aceptar la invitación

LISTO prácticamente listo para probar su aplicación en TestFlight. Antes, necesita hacer las siguientes cosas:

1. Descargar la aplicación TestFlight desde la Tienda de Aplicaciones en tu dispositivo iOS/iPadOS
2. Aceptar la invitación para probar tu aplicación

Saltaré los detalles de cómo instalar la aplicación TestFlight en tu dispositivo. Si no estás seguro de cómo instalar una aplicación, Google tiene algunas grandes guías sobre cómo hacerlo.

En cuanto a aceptar la invitación, recibirás un correo electrónico de Apple con un enlace para aceptar la invitación.

1. Abre el correo electrónico de Apple con el enlace para aceptar la invitación

2. Hacer clic en View in TestFlight botón

3. Hacer clic en el Install botón

4. Instalar la aplicación en tu dispositivo

   If has instalado la aplicación previamente utilizando Xcode, puede ver la siguiente pantalla. Por favor, haga clic en el install botón.

5. Espera a que se instale la aplicación

6. Haga clic en el Open botón y hágalo clic

Felicidades 🎉 Ha aceptado la invitación para probar su aplicación en TestFlight. Ahora, puede configurar Capgo Compilación Nativa para compilar y enviar su aplicación a TestFlight.

Configurando Capgo Compilación Nativa

Hay algunas cosas que necesita configurar en Capgo Compilación Nativa para poder compilar y enviar su aplicación a TestFlight. Aquí hay una lista de las cosas que pasará a la Capgo CLI:

Parámetro	Descripción
--platform	La plataforma para construir para (ios)
--apple-team-id	Tu ID de equipo de desarrollador de Apple (encontrado en Portal de desarrollador de Apple)
--apple-key	Ruta a tu archivo de clave de App Store Connect API (.p8 archivo)
--apple-key-id	La clave de ID de tu clave de App Store Connect API
--apple-issuer-id	Tu ID de emisor de App Store Connect
--certificate	Ruta a tu certificado de distribución (.p12 archivo)
--ios-provisioning-profile	Mapeo de perfil de provisión (bundleId=path o solo ruta para un perfil único)

Ejemplo de comando:

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

ID de equipo

Comencemos con el ID de equipo. Encontrarlo es bastante fácil.

1. Ir a Cuenta de desarrollador de Apple y desplazarse hacia abajo

2. Encuentre la Team ID

   

Clave de Apple, ID de clave de Apple y ID de emisor de Apple

Ahora, pasemos a la clave de Apple.

macOS: ¡deje que Capgo cree esta clave para usted

En macOS, capgo build init puede crear esta clave de App Store Connect API para usted. Elija “No — créame una” y una ventana guiada se abre en App Store Connect, lo guía a través de cada paso y captura la clave, el ID de clave y el ID de emisor automáticamente — sin copiar y pegar. Los pasos manuales a continuación son la alternativa (y el camino en Windows o Linux).

1. Vaya a página de acceso de usuario y App Store Connect

   Nota

   Para mí, el enlace a veces no funciona. Recargue la página si no funciona para usted.

2. Seleccione la equipo correcto en el menú desplegable

   1. Haga clic en su nombre en la esquina superior derecha
   2. Haga clic en el equipo que desea utilizar

3. Haga clic en el Integrations botón

4. Encuentre el issuer

   Advertencia

   Este DEBE SER GUARDADO - necesitarás para más adelante

   Haz clic en el copy botón para copiar el emisor

5. Haz clic en el botón con el signo más

6. Establece el nombre de la clave y establece el acceso a App manager y haz clic en el Generate botón

7. Guardar el ID de la clave

   Precaución

   Esta __CAPGO_KEEP_0__ - lo necesitarás más tarde

   

8. Descargar la clave

   Precaución

   Esta __CAPGO_KEEP_0__ - lo necesitarás más tarde

   Peligro

   NUNCA COMPARTAS LA LLAVE CON NADIE - ÚSALA SOLO EN EL CAPGO CLI

   

   

¡Felicidades 🎉 Has creado la clave de Apple, el ID de clave de Apple y el ID de emisor de Apple.

Certificado

Ahora, estás listo para exportar el certificado. Como recordarás, uno de los primeros pasos de esta guía fue configurar el certificado de distribución.

Sin embargo, Apple en su infinita sabiduría, decidió que la forma en que exportas el certificado es bastante diferente de la forma en que los creas 🙃 Vamos a entrar en la configuración:

1. Abrir Acceso a la Caja de Llaves

   1. Hacer clic Command + Space para abrir la barra de búsqueda
   2. Buscar Keychain Access
   3. Haz clic en el Keychain Access app

2. Selecciona la login categoría y haz clic en el My Certificates botón

3. Encuentra tu certificado en la lista

   El certificado debería llamarse Apple Distribution: [Your Name/Company] (your team ID)

4. Haz clic con el botón derecho en el certificado y selecciona Export

5. Guardar el certificado como un .p12 archivo

   Advertencia

   Esta __CAPGO_KEEP_0__ DEBE SER GUARDADO - lo necesitarás más tarde

   1. Asegúrate de seleccionar un buen nombre para el archivo de certificado
   2. Asegúrate de que el formato del archivo esté configurado en Personal Information Exchange (.p12)
   3. Haga clic en el Save botón

   

6. Cuando se le pregunte por la contraseña, puede elegir:

   • Saltarse la contraseña (recomendado por simplicidad): Haga clic OK sin ingresar una contraseña
   • Establecer una contraseña: Si prefiere proteger su certificado con una contraseña, puede establecer una aquí. Los archivos protegidos por contraseña están completamente soportados por el __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ - basta con proporcionar la contraseña utilizando la .p12 files are fully supported by the Capgo CLI - just provide the password using the --p12-password Diálogo de acceso a la llave para guardar el certificado de contraseña

   

7. Proporcione la contraseña que utiliza para iniciar sesión en su Mac. Luego, haga clic en el

   botón. Allow Diálogo de acceso a la llave para guardar el certificado de contraseña de la llave de inicio de sesión

   

¡Felicidades 🎉 Has exportado el certificado.

Perfil de configuración

Ahora, estás listo para exportar el perfil de configuración. Te lo prometo, esto es la última cosa que necesitarás obtener de Apple.

1. Ir a Perfiles del desarrollador de Apple

2. Selecciona el equipo correcto en el menú desplegable

   1. Haz clic en tu nombre en la esquina superior derecha
   2. Haz clic en el equipo que deseas utilizar

3. Asegúrate de que estás en la página correcta Debería parecerse a esto, si no, haz clic en profiles en el menú lateral

   

4. Haga clic en el + botón

5. Seleccione el tipo de perfil Seleccione App Store Connect y haga clic en el Continue botón

   

6. Seleccione la aplicación que desea crear

   Encuentre su aplicación en el menú desplegable y haga clic en el Continue botón

   

7. Seleccione el certificado de distribución correcto

   Seleccione el certificado que exportó en el paso anterior y haga clic en el Continue botón

   

   Si no está seguro de qué certificado seleccionar, regrese a Keychain Access y encuentre el certificado que exportó. Luego, mire la fecha de vencimiento.

   

8. Nombre del perfil

   Dale un nombre al perfil y haga clic en el Generate botón

   Consejo

   El nombre del perfil se extrae automáticamente por Capgo CLI — no necesita recordarlo.

   

9. Descargar el perfil

   Haga clic en el Download botón para descargar el perfil

   Cuidado

   Este archivo DEBE SER GUARDADO - lo necesitarás más tarde

   

¡Felicidades 🎉! Ahora tienes todo lo que necesitas para configurar Capgo Native Build.

Cuidado

Nunca comitas las credenciales que acabas de crear en tu repositorio. Manténlas seguras! 🔒

Ejecutar el comando de configuración

¡Lo has logrado! Ahora tienes todo lo que necesitas para configurar Capgo Native Build.

El comando que necesitarás ejecutar es:

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id UVTJ336J2D \
  --apple-key ./capgo-tutorial/AuthKey_66FGQZB566.p8 \
  --apple-key-id 66FGQZB566 \
  --apple-issuer-id 0cd4db4a-5598-45b8-9d32-75cdf127d005 \
  --certificate ./capgo-tutorial/capgo-build-tutorial-certificate.p12 \
  --ios-provisioning-profile ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision

Sustituir valores de reemplazo

Sustituye los valores de reemplazo anteriores con tus credenciales reales recopiladas en los pasos anteriores:

• --apple-team-idTu ID de equipo de Apple
• --apple-key: Ruta a tu archivo descargado .p8 : Tu ID de clave de Apple
• --apple-key-id: Tu ID de emisor de Apple
• --apple-issuer-id: Ruta a tu archivo de certificado exportado
• --certificate: Ruta a tu archivo descargado (ID de bundle autoinferido para perfiles únicos) .p12 : Si todo salió bien, verás la siguiente salida:
• --ios-provisioning-profile: Salida de credenciales guardadas __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ .mobileprovision : Configuración de CI/CD (__CAPGO_KEEP_0__ Actions)

: Sección titulada “Configuración de CI/CD (__CAPGO_KEEP_0__ Actions)”

CI/CD setup (GitHub Actions)

Si ya completaste ID del equipo, Clave de Apple, ID de clave de Apple y ID de emisor de Apple, Certificado, y Perfil de provisión, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

Esta sección solo cubre cómo pasar esos valores como secretos de __CAPGO_KEEP_0__ Actions y variables de entorno.

# Distribution certificate (.p12)
base64 -i ./capgo-tutorial/capgo-build-tutorial-certificate.p12 | tr -d '\n' > certificate_base64.txt

# Provisioning profile (.mobileprovision)
base64 -i ./capgo-tutorial/capgo_native_build_tutorial.mobileprovision | tr -d '\n' > profile_base64.txt

# App Store Connect API key (.p8)
base64 -i ./capgo-tutorial/AuthKey_66FGQZB566.p8 | tr -d '\n' > apple_key_base64.txt

Consejo

Los secretos GitHub deben ser valores de una sola línea. tr -d '\n' elimina saltos de línea del resultado base64.

2) Crea secretos de repositorio

En GitHub > Repository > Settings > Secrets and variables > Actions, agregar:

Nombre del secreto	Valor
CAPGO_TOKEN	Tu token Capgo API
APP_STORE_CONNECT_TEAM_ID	ID del equipo desde ID del equipo
APPLE_KEY_ID	Clave de identificación desde Clave de Apple, identificador de clave de Apple y identificador de emisor de Apple
APPLE_ISSUER_ID	Identificador de emisor desde Clave de Apple, identificador de clave de Apple y identificador de emisor de Apple
BUILD_CERTIFICATE_BASE64	Contenido de certificate_base64.txt
CAPGO_IOS_PROVISIONING_MAP	Generado por CLI — copia desde .capgo-credentials archivo
APPLE_KEY_CONTENT	Contenido de apple_key_base64.txt
P12_PASSWORD (opcional)	Su .p12 contraseña si se estableció durante la exportación

3) Utilice variables de entorno en su flujo de trabajo de GitHub de Actions

github/trabajos/flujo/ios-build.yml

name: iOS Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  ios-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS build with Capgo
        run: bunx @capgo/cli@latest build request --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}

Consejo

Con esta configuración, CI envía credenciales a través de variables de entorno solo. No necesita comprometer archivos de firma ni subirlos como artefactos de flujo de trabajo.

Ejecutando la compilación

Ahora, está listo para ejecutar su primera compilación.

Ejecute el siguiente comando para compilar su aplicación:

bunx @capgo/cli@latest build request --platform ios

¡Felicidades 🎉 En este punto, has construido tu aplicación con éxito y está lista para ser enviada a la Tienda de Aplicaciones.

Modo de Distribución Ad-Hoc

Por defecto, Capgo compila aplicaciones iOS para distribución en la Tienda de Aplicaciones (TestFlight + Tienda de Aplicaciones). Si necesitas builds ad-hoc en su lugar (para pruebas internas o recopilación de artefactos de CI), puedes utilizar el --ios-distribution flag

Nota

La distribución ad-hoc no es lo mismo que la distribución Enterprise (In-House). La distribución Enterprise requiere una cuenta de desarrollador de Apple Enterprise separada y utiliza perfiles de provisión diferentes. __CAPGO_KEEP_0__ actualmente solo admite y the same as Enterprise (In-House) distribution. Enterprise distribution requires a separate Apple Developer Enterprise account and uses different provisioning profiles. Capgo currently supports app_store modos. ad_hoc modos.

When a usar modo ad-hoc

• Quieres distribuir IPAs directamente a dispositivos registrados (sin TestFlight)
• No tienes o no quieres usar una clave de App Store Connect API
• Quieres recopilar artefactos de compilación mediante --output-upload sin someter a la tienda App Store

Requisitos

Los compilados ad-hoc tienen menos requisitos que los compilados de la tienda App Store:

Autenticación	¿Requerido?
Certificado de distribución (.p12)	Sí
Perfil de provisión ad-hoc (.mobileprovision)	Sí
ID de equipo (--apple-team-id)	Sí
Clave de App Store Connect API (.p8)	No
ID de clave de Apple / ID de emisor	No

Nota

En ad_hoc modo, --apple-key, --apple-key-id, y --apple-issuer-id no están soportados y se ignoran. Esto es por qué las dos filas de App Store Connect arriba no muestran banderas de CLI ad-hoc; estas opciones solo se aplican a app_store Cuidado

Sin una clave de App Store Connect __CAPGO_KEEP_0__, el número de compilación auto-incremento utiliza un fallback basado en fecha y hora. Para suprimir la advertencia, pasa

Without an App Store Connect API key, build number auto-increment uses a timestamp-based fallback. To suppress the warning, pass --skip-build-number-bump.

Crear un perfil de provisión ad-hoc

Siga los mismos pasos que Perfil de provisiónpero en el paso 5, seleccione Ad Hoc en lugar de Tienda de aplicaciones:

1. Vaya a Perfiles de desarrollador de Apple
2. Haga clic en + botón
3. Seleccione Ad Hoc y haga clic en Continuar
4. Seleccione su aplicación y certificado de distribución
5. Seleccione los dispositivos que desea registrar
6. Nombre y descarga del perfil

Almacenando credenciales ad-hoc

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --ios-distribution ad_hoc \
  --apple-team-id YOUR_TEAM_ID \
  --certificate './certificate.p12' \
  --ios-provisioning-profile './adhoc_profile.mobileprovision'

No --apple-key, --apple-key-id, o --apple-issuer-id necesario.

Ejecutando una compilación ad-hoc

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc

Para recopilar el IPA como un artefacto de compilación, agrega --output-upload:

bunx @capgo/cli@latest build request \
  --platform ios \
  --ios-distribution ad_hoc \
  --output-upload

Implementación continua con compilaciones ad-hoc

Para GitHub Acciones, necesitas menos secretos que compilaciones de App Store:

.github/flujos de trabajo/ios-adhoc-build.yml

name: iOS Ad-Hoc Build

on:
  workflow_dispatch:

jobs:
  ios-adhoc:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request iOS ad-hoc build
        run: bunx @capgo/cli@latest build request --platform ios --ios-distribution ad_hoc --output-upload
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP_ADHOC }}
          CAPGO_IOS_DISTRIBUTION: ad_hoc

Consejo

Ten en cuenta que APPLE_KEY_ID, APPLE_ISSUER_ID, y APPLE_KEY_CONTENT no se necesitan para compilaciones ad-hoc.

Aplicaciones con Extensiones (Firma de múltiples objetivos)

Si su aplicación incluye extensiones (extensiones de compartición, widgets, extensiones de servicios de notificaciones, etc.), cada objetivo de extensión necesita su propio perfil de provisión. Capgo admite esto mediante la bandera --ios-provisioning-profile repetible.

Ejemplo: Aplicación + Extensión de Compartir

bunx @capgo/cli@latest build credentials save \
  --platform ios \
  --apple-team-id YOUR_TEAM_ID \
  --apple-key '/path/to/AuthKey_XXXXX.p8' \
  --apple-key-id YOUR_KEY_ID \
  --apple-issuer-id YOUR_ISSUER_ID \
  --certificate '/path/to/certificate.p12' \
  --ios-provisioning-profile "com.example.app=./app_profile.mobileprovision" \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

Cada --ios-provisioning-profile mapea una identificación de paquete a su archivo de perfil de provisión. El CLI:

1. Lee cada archivo mobileprovision
2. Extrae automáticamente el nombre del perfil del plist incorporado
3. Codifica en Base64 el archivo
4. Almacena todo como un solo CAPGO_IOS_PROVISIONING_MAP credencial

Consejo

Necesita una certificación de distribución para todos los objetivos — solo los perfiles de provisión difieren por objetivo.

Migración desde un perfil único

Si anteriormente utilizó BUILD_PROVISION_PROFILE_BASE64 (perfil único), ejecuta:

bunx @capgo/cli@latest build credentials migrate --platform ios

Esta convierte sus credenciales de perfil único existentes a la nueva CAPGO_IOS_PROVISIONING_MAP formato y elimina las claves legado (BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Después de la migración, agrega perfiles de extensión con el update comando (mezcla aditiva):

bunx @capgo/cli@latest build credentials update \
  --platform ios \
  --ios-provisioning-profile "com.example.app.share-extension=./share_ext_profile.mobileprovision"

Consejo

Utiliza update (no save) para agregar perfiles a credenciales existentes. El update comando combina nuevos perfiles con los existentes. Utilice save solo cuando esté configurando todas las credenciales desde cero.

Solución de problemas

El perfil de provisión no incluye la capacidad XYZ.

A veces, puede ver el siguiente error:

Provisioning profile "YOUR_PROVISIONING_PROFILE_NAME" doesn't include the XYZ capability. (in target 'App' from project 'App')"

Esto sucede porque ha habilitado una nueva capacidad después de crear el perfil de provisión. El antiguo perfil de provisión no incluye la nueva capacidad todavía.

Para solucionar esto, necesita regenerar el perfil de provisión.

1. Abre Portal del desarrollador de Apple
2. Seleccione el equipo correcto en el menú desplegable
3. Haga clic en el Profiles botón
4. Encuentre el perfil de configuración que desee regenerar
5. Haga clic en el Edit botón
6. Haga clic en el Save botón
7. Haga clic en el Download botón
8. Re-ejecutar el comando de configuración de la instalación nativa de Capgo con el perfil descargado recientemente.

Esto debería solucionar el problema.

Otros problemas

Si por alguna razón estás teniendo problemas con Capgo Native Build, la configuración de las credenciales o la compilación de la aplicación, no dudes en contactarnos a través de nuestra Soporte.

Sigue adelante desde iOS Builds

Si estás utilizando iOS Builds para planificar la automatización de CI/CD, conecta con Capgo CI/CD para el flujo de trabajo del producto en Capgo CI/CD, Capgo Builds nativos para el flujo de trabajo del producto en Capgo Builds nativos, Capgo Integraciones para el flujo de trabajo del producto en Capgo Integraciones Integración CI/CD para los detalles de implementación en la Integración CI/CD, y GitHub Integración de Acciones para los detalles de implementación en GitHub Integración de Acciones.