Compilaciones de iOS

Construye y envía 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 con una suscripción activa
• Su aplicación ya registrada en Capgo (ejecute bunx @capgo/cli@latest app add si no)
• 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 de Apple válida (99€/año) (Debes tener derechos de administrador o propietario en la cuenta de desarrollador de Apple)
• Su aplicación debe poder compilar con éxito mediante Xcode
• Una aplicación de Capacitor
• Un icono configurado para la aplicación. Las aplicaciones sin icono no pueden subirse a la Tienda de App

Nota

Usaré la siguiente aplicación para el tutorial: https://github.com/Cap-go/capgo-tutorial-de-construcción-nativa-de-aplicaciones

Antes de empezar en los portales de Apple

Antes de configurar certificados o desencadenar la primera carga de TestFlight, asegúrese 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
• Elige el tipo de membresía correcto:
  • Persona física / Propietario individual: su nombre legal personal se convierte en el nombre del vendedor en la Tienda de Aplicaciones
  • Organización: 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 ambos Apple Developer y App Store Connect para certificados, registros de aplicaciones, API claves y TestFlight
• Consolida tu identificador de paquete final temprano. Cambiarlo más tarde suele significar volver a configurar la configuración de la Tienda de Mac App
• Planifica estos elementos de App Store Connect antes de la revisión de la 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 la App

Nota

Referencias oficiales útiles:

• Únete al programa de desarrolladores de Apple
• Envía tus aplicaciones y juegos
• Información de versión de plataforma en App Store Connect

Cuidado

Apple actualiza regularmente su requisito mínimo de SDK. A partir de 28 de abril de 2026, las aplicaciones de iPhone y iPad subidas a App Store Connect deben ser compiladas con el iOS y iPadOS 26 SDK o posterior.

La primera compilación manual

Antes de poder pensar en compilar la aplicación con Capgo, debemos configurarla primero y realizar una primera compilación de TestFlight de forma manual. Hay algunas ventajas en realizar una compilación manual primero:

• Configurará el certificado de distribución en su máquina local
• Crearán el registro de App Store si aún no lo han hecho
• Podrán determinar cualquier problema con el proceso de compilación relacionado con su aplicación code

Antes de comenzar, debe tener instalado el certificado de distribución en su máquina local.

Configuración del certificado de distribución

1. Abrir Xcode

2. Haga clic en Xcode -> Settings... Alternativamente, puede utilizar la atajada Cmd + ,

   

3. Ir a Accounts

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

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

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

7. Asegúrese de que pueda ver el certificado de distribución en la lista

8. Si no lo hace, necesita crear un nuevo certificado

   Nota

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

   1. Haga clic en el + botón y luego en Apple Distribution
   2. El certificado se creará automáticamente. Puede verlo en la lista. Mire el paso anterior para confirmar que lo ve.

Ahora que tiene instalado el certificado de distribución, puede comenzar el proceso de compilación.

Compilar manualmente para TestFlight

1. Abrir 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. Espera a que se complete la compilación

4. Haz clic en el Distribute App botón

   

5. Selecciona TestFlight Internal Only como método de distribución y haz clic en el 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 App
   2. SKU - el código SKU de tu aplicación - este es utilizado para identificar tu aplicación en la Tienda de Aplicaciones
   3. El idioma principal - el idioma principal de tu aplicación

   Luego, haz clic en el next botón

   

7. Si falla la creación de la aplicación de registro, intenta cerrar la ventana y vuelve a archivar la aplicación.

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 pienses que todo está bien ahora y que podrás ver tu aplicación en TestFlight, pero hay un par de cosas más que terminar:

1. Únete a TestFlight
2. Cumple con la exportación para que la construcción se vuelva susceptible de pruebas
3. Rellena los metadatos de App Store Connect obligatorios, como tu URL de soporte, la URL de tu política de privacidad y la clasificación de edad
4. Prepara capturas de pantalla que coincidan con los dispositivos que realmente soportas
5. Agrega los detalles de contacto de revisión de la App y cualquier credencial de prueba antes de la presentación de producción

Comencemos con el primero:

Agregarse a TestFlight

1. Vaya a la página de App Store Connect página de inicio de sesión de App Store Connect

2. Inicia sesión con tu cuenta de desarrollador de Apple

3. Selecciona el equipo que utilizaste cuando creaste el registro de la aplicación. Si solo tienes una cuenta de desarrollador, puedes saltarte este paso.

4. Haz clic en el Apps botón

5. Encuentra la aplicación que creaste en el paso anterior y haz clic en ella

6. Haz clic en el TestFlight botón

7. Haz clic en el Internal Testers plus botón

8. Crear un nuevo grupo

   Me gusta llamar al grupo “internos”. Puedes llamarlo como quieras.

   

9. Haga clic en Invite testers botón

10. Agregar a sí mismo al grupo

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

    

11. Verifica que te has agregado al grupo

    Ahora deberías verte en el grupo.

    

Felicidades 🎉 Has agregado a ti mismo a TestFlight. Ahora solo queda una cosa más que debes hacer antes de que puedas configurar Capgo Native Build.

Configurando la información de cumplimiento

Ahora necesitas 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 en cómo manejar esto. Hay dos formas de hacer esto:

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

Vamos a empezar con la primera opción:

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

2. Haga clic en Builds -> iOS

3. Encuentre la construcción con información de conformidad faltante y haga clic en Manage

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

   Para mí, esto es nonepero puede ser diferente para ti.

   

5. App Store Connect guarde información de conformidad ready to test

   

Listo para probar en App Store Connect

1. Abra el archivo Info.plist archivo

2. Agregar la siguiente clave:

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

3. Guardar el archivo

Nota

Aquí se encuentra 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

Ahora, usted está ALMOST listo para probar su aplicación en TestFlight. Antes, necesita hacer las siguientes cosas:

1. Descargar la aplicación TestFlight de la Tienda de Mac App en su dispositivo iOS/iPadOS
2. Aceptar la invitación para probar su aplicación

Saltaré los detalles de cómo instalar la aplicación TestFlight en su dispositivo. Si no está 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á un correo electrónico de Apple con un enlace para aceptar la invitación.

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

2. Hacer clic en View in TestFlight botón

3. Haga clic en el Install botón

4. Instale la aplicación en su dispositivo

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

5. Espere 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 Native Build para compilar y enviar su aplicación a TestFlight.

Configurando Capgo Native Build

There are a few things you need to configure in Capgo Native Build to be able to build and submit your app to TestFlight. Here is a list of the things you will pass to the Capgo CLI:

Aquí tienes una lista de las cosas que pasarás al __CAPGO_KEEP_1__ __CAPGO_KEEP_2__:	Parámetro
--platform	Descripciónios)
--apple-team-id	La plataforma para la que deseas compilar ( Tu ID de equipo de desarrollador de Apple (encontrado en)
--apple-key	Path to your App Store Connect API Key file (.p8 Ruta a tu archivo de clave __CAPGO_KEEP_0__ de App Store Connect (
--apple-key-id	The Key ID of your App Store Connect API Key
--apple-issuer-id	El ID de clave de tu clave de App Store Connect __CAPGO_KEEP_0__
--certificate	Tu ID de emisor de App Store Connect.p12 archivo)
--ios-provisioning-profile	Mapeo de perfil de configuración (bundleId=path o simplemente 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. Encuentra la ubicación de la ID de equipo en la cuenta de desarrollador Team ID

   

Ubicación de la clave Apple, la clave de ID de Apple y la ID de emisor de Apple

Ahora, pasemos a la clave Apple.

1. Ir a Página de acceso de usuario y App Store Connect

   Nota

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

2. Selecciona el equipo correcto en el menú desplegable

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

3. Haga clic en el Integrations botón

4. Encuentre el issuer

   Cuidado

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

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

5. Haga clic en el botón de más

6. Establezca el nombre de la clave y establezca el acceso a App manager y haga clic en el Generate botón

7. Guardar el ID de la clave

   Cuidado

   Esto DEBE SER GUARDADO - lo necesitarás más tarde

   

8. Descargar la clave

   Advertencia

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

   Peligro

   NUNCA COMPARTAS LA CLAVE 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 ver cómo configurarlo:

1. Abrir Acceso a la Llave

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

2. Seleccione la categoría y haga clic en el botón login Keychain Access categoría de inicio de sesión My Certificates Encuentre su certificado en la lista

3. Buscar certificado de Keychain Access

   Haga clic con el botón derecho en el certificado y seleccione Apple Distribution: [Your Name/Company] (your team ID)

4. Guarde el certificado como un Export

5. __CAPGO_KEEP_1__ .p12 archivo

   Cuidado

   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. Haz clic en el Save botón

   

6. Cuando se te pregunte por la contraseña, puedes elegir:

   • Saltar 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 configurarla aquí. Los archivos protegidos por contraseña están completamente soportados por el __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ - solo proporcione 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 contraseña de certificado de acceso a la llave de Keychain

   

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 contraseña de certificado de llave de acceso de inicio de Keychain

   

Perfil de provisión

Provisioning profile

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

1. Vaya a Perfiles del desarrollador de Apple

2. Seleccione el 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. Asegúrese de estar en la página correcta Debería verse así, si no, haga clic en profiles en el menú lateral

   

4. Haga clic en + botón

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

   

6. Selecciona la aplicación que deseas construir

   Encuentra tu aplicación en el menú desplegable y haz clic en el Continue botón

   

7. Selecciona el certificado que exportaste en el paso anterior y haz clic en el

   __CAPGO_KEEP_0__ Continue botón

   

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

   

8. Nombrar el perfil

   Dale un nombre al perfil y haz 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 botón para descargar el perfil Download botón para descargar el perfil de Apple Developer

   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 a tu repositorio. Mantén su seguridad! 🔒

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-id: Tu ID de equipo de Apple
• --apple-key: Ruta a tu archivo descargado .p8 : Archivo de clave
• --apple-key-id: Su clave de ID de Apple
• --apple-issuer-id: Su ID de emisor de Apple
• --certificate: Ruta a su archivo de certificado exportado .p12 certificate
• --ios-provisioning-profile: Ruta a su archivo descargado .mobileprovision : Ruta a su archivo descargado (ID de bundle autoinferido para perfiles únicos)

Si todo salió bien, verá la siguiente salida:

Configuración de CI/CD (GitHub Acciones)

Si ya completó ID de equipo, llave de Apple, ID de llave de Apple y ID de emisor de Apple, Certificado, y perfil de configuración 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__ de 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

Consejo: GitHub secrets 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, agrega:

Nombre de la clave secreta	Valor
CAPGO_TOKEN	Tu Capgo API token
APP_STORE_CONNECT_TEAM_ID	ID de equipo desde ID de equipo
APPLE_KEY_ID	ID de clave desde Clave de Apple, ID de clave de Apple y ID 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 GitHub Actions workflow

github/workflows/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, ha construido con éxito su aplicación y está lista para ser presentada en 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 necesita builds ad-hoc en su lugar (para pruebas internas o recopilación de artefactos de CI), puede utilizar el --ios-distribution flag.

Nota

La distribución ad-hoc no es lo mismo que la distribución Enterprise (En Casa). La distribución Enterprise requiere una cuenta de desarrollador Apple Enterprise separada y utiliza perfiles de configuración diferentes. __CAPGO_KEEP_0__ admite actualmente 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 Cuándo usar el modo ad-hoc ad_hoc Sección titulada “Cuándo usar el modo ad-hoc”

targetLanguage

• 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 builds Ad-hoc tienen menos requisitos que los builds de la tienda App Store:

Credencial	¿Requerida?
Certificado de distribución (.p12)	Sí
Profil 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 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 ad-hoc CLI; estas opciones se aplican solo al app_store modo solo.

Cuidado

Sin una clave de App Store Connect API; el número de compilación autoincremental utiliza un fallback basado en fecha y hora. Para suprimir la advertencia, pasa --skip-build-number-bump.

Creación de un perfil de provisión ad-hoc

Sigue los mismos pasos que Perfil de provisión, pero en el paso 5, selecciona Ad Hoc en lugar de Tienda de aplicaciones de Apple:

1. Ir a Perfiles de desarrollador de Apple
2. Haz clic en el + botón
3. Seleccionar Ad Hoc y haz clic en Continuar
4. Selecciona tu aplicación y certificado de distribución
5. Selecciona los dispositivos que deseas registrar
6. Nombre y descargar el perfil

Guardar 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.

Ejecutar 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, agregue --output-upload:

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

CI/CD con compilaciones ad-hoc

Para GitHub Acciones, necesita menos secretos que las 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

Tenga 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 compartir, 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"

bandera asigna un ID de paquete a su archivo de perfil de provisión. El __CAPGO_KEEP_0__: --ios-provisioning-profile flag maps a bundle ID to its provisioning profile file. The CLI:

1. Cada
2. Extrae automáticamente el nombre de perfil desde el plist incorporado
3. Codifica en Base64 el archivo
4. Almacena todo como un CAPGO_IOS_PROVISIONING_MAP credencial

Consejo

Necesita un certificado de distribución para todos los objetivos — solo los perfiles de configuración varían por objetivo.

Migración desde Perfil Único

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

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

Esta convierte sus credenciales de perfil único existentes al nuevo formato y elimina las llaves de legado ( CAPGO_IOS_PROVISIONING_MAP Después de la migración, agregue perfiles de extensión con el comando (unión aditiva):BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

Ventana de terminal update Copiar a portapapeles

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

(no

) para agregar perfiles a credenciales existentes. El update targetLanguage saveprotectedTokens update El comando combina nuevos perfiles con los existentes. Utilice save solo cuando esté configurando todos los 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 ocurre 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. Abrir Portal del desarrollador de Apple
2. Seleccione la equipo correcta en el menú desplegable
3. Haga clic en el Profiles botón
4. Encuentre el perfil de provisión que desea 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 Capgo Native Build con el perfil descargado recientemente. Esto debería solucionar el problema.

Otros problemas

Sección titulada “Otros problemas”

If for whatever reason you are having issues either with Capgo Native Build, configuring the credentials or building the app, please don’t hesitate to reach via our Editar página.