Builds de iOS

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

Lo que aprenderás

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

Requisitos previos

• Una cuenta de Capgo (basta con una prueba gratuita para empezar)
• Tu aplicación ya registrada en Capgo (corre 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)
• Cuenta de desarrollador de Apple válida (99€/año) (Debes tener derechos de administrador o propietario en la cuenta de desarrollador de Apple)
• Tu 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 App.

Nota

Usaré 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 la primera carga de TestFlight, asegúrese de que el cuenta de Apple y el equipo estén listos:

• Habilite la autenticación en dos factores para la cuenta de Apple utilizada para el registro
• Elige el tipo de membresía correcto:
  • Individual / Propietario único: 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.
• Use una cuenta que pueda acceder a Apple Developer y App Store Connect para certificados, registros de aplicaciones, API claves, y TestFlight.
• Concentre tu ID de paquete final temprano. Cambiarlo más tarde suele significar volver a configurar App Store.
• Planifica estos elementos de App Store Connect antes de la revisión de la aplicación: 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 aplicación.

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 2026Se requiere iOS & iPadOS 26 __CAPGO_KEEP_0__ o posterior para que las aplicaciones de iPhone e iPad subidas a App Store Connect estén configuradas iOS & iPadOS 26 SDK or later.

No necesita hacer nada de esto a mano. __CAPGO_KEEP_0__ crea y configura sus credenciales de firma de iOS (certificado de distribución + perfil de configuración) por usted — este es el camino recomendado:

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 manual 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 no lo han hecho aún
• Podrán determinar cualquier problema con el proceso de construcción relacionado con su aplicación code

Antes de que podamos comenzar, 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. Abrir Xcode

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

   

3. Vaya 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 poder 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. Espere a que se complete la compilación

4. Haga clic en el Distribute App botón

   

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

   

6. Configurar el registro de la aplicación

   Rellene los siguientes campos:

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

   Luego, haga clic en el next botón

   

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

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 sientas 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 debes terminar:

1. Añade tu cuenta 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. Agregue 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 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. Click on the 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

8. Crear un nuevo grupo

   Me gusta llamar al grupo “internos”. Puede llamarlo como desee.

   

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. (Es posible que deba 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 🎉 Se ha agregado a sí mismo a TestFlight. Ahora solo queda una cosa más que necesita hacer antes de poder 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 a 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 a la segunda, 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í 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

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

1. Descargar la aplicación TestFlight from the App Store en tu dispositivo iOS/iPadOS
2. Aceptar la invitación para probar tu aplicación

No entraré en detalles sobre 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. Haz clic en View in TestFlight botón

3. Haz clic en el Install botón

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

Configurando Capgo Native Build

Existen un par de cosas que necesita configurar en Capgo Native Build para poder compilar y enviar su aplicación a TestFlight. Aquí está una lista de las cosas que pasará a la Capgo CLI:

Parámetro	Descripción
--platform	The platform to build for (ios)
--apple-team-id	Tu identificador 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 identificador de emisor de App Store Connect
--certificate	Ruta a tu certificado de distribución (.p12 archivo)
--ios-provisioning-profile	Mapa de perfil de configuración (bundleId=path o solo ruta para un perfil)

Comando de ejemplo:

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 del equipo

Empecemos con el ID del 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.

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. Haz clic en el equipo que deseas usar

3. Haz clic en el Integrations botón

4. Encuentra el issuer

   Cuidado

   Esta __CAPGO_KEEP_0__ - lo necesitarás más tarde

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

5. Haz 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á más tarde

   

8. Descargue la clave

   Cuidado

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

   Peligro

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

   

   

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

Certificado

Ahora, está listo para exportar el certificado. Como recordará, 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 exporta el certificado es bastante diferente de la forma en que los crea 😂

1. Vamos a configurarlo:

   1. Abra Keychain Access Command + Space Haga clic
   2. para abrir la barra de búsqueda Keychain Access
   3. Búsqueda por Keychain Access Haga clic en el

2. Demonstración de cómo abrir Keychain Access en macOS login Seleccione la categoría y haga 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 derecho en el certificado y selecciona Export

5. Guarda el certificado como un .p12 archivo

   Cuidado

   Esto ESPERAR A 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:

   • Saltarte la contraseña (recomendado por simplicidad): Haz clic OK sin ingresar una contraseña
   • Establecer una contraseña: Si prefieres proteger tu certificado con una contraseña, puedes configurarla aquí. Los archivos protegidos con contraseña .p12 son plenamente compatibles con el Capgo CLI - solo proporciona la contraseña utilizando el --p12-password When ejecutando la opción de comando de configuración.

   

7. Cuando se le pregunte por la contraseña de la llave de inicio de sesión, ingrese la contraseña que utiliza para iniciar sesión en su Mac

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

   

Felicidades 🎉 Has exportado el certificado.

Perfil de provisión

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

1. Vaya a Perfiles de desarrollador de Apple

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. 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 el + botón

5. Seleccione el tipo de perfil Seleccione App Store Connect y haga 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 de distribución correcto

   Selecciona el certificado que exportaste en el paso anterior y haz clic en el Continue botón

   

   Si no estás seguro de qué certificado seleccionar, vuelve a Keychain Access y encuentra el certificado que exportaste. Luego mira la fecha de vencimiento.

   

8. Denomina el perfil

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

   Consejo

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

   

9. Descarga el perfil

   Haz clic en el botón para descargar el perfil Download Advertencia

   __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

   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 comites las credenciales que acabas de crear en tu repositorio. Mantén su seguridad! 🔒

Ejecutando el comando de configuración

Lo has hecho! 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 : Tu ID de clave de Apple
• --apple-key-id: Tu ID de emisor de Apple
• --apple-issuer-id: Ruta a tu certificado exportado
• --certificate: Path to your exported .p12 certificate
• --ios-provisioning-profile: Ruta a tu archivo descargado .mobileprovision archivo (ID de paquete inferido automáticamente para perfiles únicos)

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

configuración de CI/CD (GitHub Acciones)

Si ya completaste ID de equipo, clave de Apple, ID de clave de Apple y ID de emisor de Apple, Certificado, y perfil de configuración de provisiónYa tienes todo lo necesario para CI/CD. Esta sección solo cubre cómo pasar esos valores como secretos de acciones de GitHub y variables de entorno.

1) Convierte archivos de credenciales a base64 de una sola línea

# 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 de GitHub deben ser valores de una sola línea. tr -d '\n' elimina saltos de línea del resultado de base64.

2) Crea secretos de repositorio

En GitHub > Repository > Settings > Secrets and variables > Actionsadd:

Nombre secreto	Valor
CAPGO_TOKEN	Su token Capgo API
APP_STORE_CONNECT_TEAM_ID	ID del equipo desde ID del 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	ID de emisor desde Clave de Apple, ID de clave de Apple y ID 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 flujo de trabajo de Actions

.github/flujos-de-trabajo/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, la 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 compilado con éxito su aplicación 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 necesita compilaciones 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 provisión diferentes. Capgo actualmente 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 Cuándo usar el modo ad-hoc ad_hoc Sección titulada “Cuándo usar el modo ad-hoc”

Quiere distribuir IPAs directamente a dispositivos registrados (sin TestFlight)

• Quiere recopilar artefactos de compilación mediante
• You don’t have or don’t want to use an App Store Connect API key
• sin enviar a la Tienda de Mac App Store --output-upload sin enviar a la Tienda de Mac App Store

Requisitos

Los builds ad-hoc tienen menos requisitos que los builds de la Tienda de Aplicaciones:

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

Nota

En ad_hoc modo, --apple-key, --apple-key-id, y --apple-issuer-id no están soportados e ignorados. 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.

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.

Creando 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:

1. Vaya a Perfiles de Desarrollador de Apple
2. Haga clic en + botón
3. Seleccionar 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 descargue el 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-ido --apple-issuer-id necesario.

Ejecutar un build ad-hoc

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

Para recopilar el IPA como un artefacto de build, agrega --output-upload:

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

CD/CI con builds ad-hoc

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

github/trabajos/flujo-de-trabajo-ios-adhoc-compilar.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

Observa 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 tu aplicación incluye extensiones (extensiones de compartir, widgets, extensiones de servicios de notificaciones, etc.), cada objetivo de la extensión necesita su propio perfil de provisión. Capgo admite esto a través de la propiedad repetible --ios-provisioning-profile bandera.

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 La bandera mapea un ID de paquete a su archivo de perfil de configuración. El CLI:

1. Lee cada archivo mobileprovision
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

Necesitas un certificado de distribución para todos los objetivos — solo los perfiles de configuración difieren por objetivo.

Migración desde Perfil Único

Si anteriormente utilizaste BUILD_PROVISION_PROFILE_BASE64 (perfil único), ejecuta:

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

Esto convierte tus credenciales de perfil único existentes en el nuevo CAPGO_IOS_PROVISIONING_MAP formato y elimina las llaves legadas (BUILD_PROVISION_PROFILE_BASE64, APPLE_PROFILE_NAME).

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

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

Consejo

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

Solución de problemas

Perfil de provisión no incluye la capacidad XYZ.

A veces, puedes 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 has habilitado una nueva capacidad después de que se creó el perfil de provisión. El antiguo perfil de provisión no incluye la nueva capacidad todavía.

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

1. Abrir Portal del desarrollador de Apple
2. Selecciona el equipo correcto en el menú desplegable
3. Hacer clic en el Profiles __CAPGO_KEEP_0__
4. Encuentre el perfil de provisió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 Capgo Native Build 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 credenciales o la compilación de la aplicación, no dudes en contactarnos a través de nuestro soporte.

Sigue adelante desde iOS Builds

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