Creación de compilación Capacitor IOS automática con Codemagic

Entrega continua para iOS utilizando Codemagic

Requisitos previos

Antes de continuar con el tutorial…

• Membresía del programa de desarrolladores de iOS.
• Deseo de leer 😆…

Importante sobre el precio

https://codemagic.io/pricing/

El servicio es ‘gratuito’ hasta 500 minutos de macOS M1 al mes / mes, dependiendo de la máquina elegida.
Vamos a utilizar una máquina macOS M1 , puedes ver en la captura su precio y límites (precios a la creación del tutorial, pueden sufrir cambios en el futuro)

🔴 Una vez advertidos de los requisitos y precios, si te gusta, continuamos…

📣 En el post asumimos que tenemos la aplicación creada en iTunes connect, sí tenemos los certificados del ecosistema Apple, todo estará configurado por Codemagic!

¡Vamos a sumergirnos!

Pasos a seguir en el post

1. Usando App Store Connect API con Codemagic
2. Requisitos
3. Crear una clave de App Store Connect API
4. Usar una clave de App Store Connect API
5. Copiar archivos de Fastlane
6. Configurar Codemagic

1. Usando App Store Connect API con Codemagic

A partir de febrero de 2021, se requiere autenticación en dos factores o verificación en dos pasos para todos los usuarios para iniciar sesión en App Store Connect. Esta capa adicional de seguridad para su ID de Apple ayuda a asegurarse de que solo usted puede acceder a su cuenta.
Desde Soporte de Apple

Comenzar con match requiere que revierta sus certificados existentes. Pero no se preocupe, tendrá el nuevo directamente.

Requisitos

Para poder usar App Store Connect API, Codemagic necesita tres cosas.

1. Identificador de emisor.
2. Identificador de clave.
3. Archivo de clave o contenido de clave.

Crear una clave de App Store Connect API

Para generar claves, debe tener permiso de Administrador en App Store Connect. Si no tiene ese permiso, puede dirigir a la persona relevante a este artículo y seguir las siguientes instrucciones.

1 — Iniciar sesión en App Store Connect.

2 — Seleccionar Usuarios y acceso.

3 — Selecciona la pestaña de API Claves.

4 — Haz clic en Generar API Clave o en el botón (+) de agregar.

5 — Ingresa el nombre de la clave y selecciona un nivel de acceso. Recomendamos elegir App Manager derechos de acceso, lee más sobre las permisos del rol del programa de desarrollador de Apple aquí Crear nombre de claves de App Store Connect __CAPGO_KEEP_0__

El acceso de una clave __CAPGO_KEEP_0__ no puede limitarse a aplicaciones específicas.

An API key’s access cannot be limited to specific apps.

7 — Haz clic en Descargar para obtener el archivo de clave.

Obtén toda la información necesaria aquí: 1. Identificador de problema.
2. Identificador de clave.
3. Haz clic en "Descargar API Clave" para descargar tu API clave privada. El enlace de descarga aparece solo si la clave privada no se ha descargado aún. Apple no almacena una copia de la clave privada. Por lo tanto, solo puedes descargarla una vez.

🔴 Almacena tu clave privada en un lugar seguro. Nunca debes compartir tus claves, almacena claves en un code repositorio o incluye claves en el lado del cliente code.

Agregar la clave de App Store Connect API a Codemagic

1. Abre la configuración de tu equipo de Codemagic Seleccionar identidades de firma code Y subir el certificado

2. Haga clic en Agregar clave botón.

3. Ingrese el App Store Connect API key name. Este es un nombre legible para humanos para la clave que se utilizará para referirse a la clave más tarde en las configuraciones de la aplicación.

4. Ingrese el Issuer ID y Key ID valores.

5. Haga clic en Elige un archivo .p8 o arrastra el archivo para subir la clave App Store Connect API descargada anteriormente.

6. Haga clic Guardar.

Ahora podemos gestionar Codemagic con la clave de App Store Connect API, ¡genial!

2. Crea certificados y perfiles de configuración de provisión

Certificados

Abra XCode y vaya a Configuración > Cuentas > ID de Apple > Equipos y seleccione su equipo.

Haz clic en Gestiona certificados > + y selecciona Distribución de Apple.

Luego puedes crear un nuevo certificado.

Luego debes ir a la llave de cadena para descargar el certificado como un .p12 archivo.

Para hacerlo, debes ir a la llave de cadena, cambiar a la llave de cadena de login y luego la pestaña Certificados míos.

Luego, puedes seleccionar el certificado que deseas descargar. (Busca por la fecha del certificado)

Y luego haz clic derecho en el certificado y selecciona Exportar.

Elige el formato de archivo Intercambio de Información Personal (.p12).

Eso descargará el certificado como un .p12 archivo.

Perfiles de provisión

Abrir Desarrollador de Apple y selecciona el equipo correcto.

Luego crea un nuevo perfil, haciendo clic en +

Y selecciona App Store Connect.

Luego debes seleccionar la aplicación correcta, ten cuidado, no puedes usar comodines de lo contrario la firma fallará.

Selecciona el certificado correcto que creaste antes (busca la fecha de vencimiento, debe ser el mismo día y mes que hoy) y haz clic en Continuar.

Finalmente ingresa el nombre del perfil y haz clic en Generar.

The name will be used to identify the profile in Codemagic.

Puedes descargar el perfil como un .mobileprovision archivo.

Al agregar el certificado de firma Code

Codemagic te permite subir certificados de firma code como archivos PKCS#12 que contienen tanto el certificado como la clave privada necesarios para utilizarlo. Cuando subas, Codemagic te pedirá que proporciones la contraseña del certificado (si el certificado está protegido por contraseña) junto con un nombre de referencia único,que luego se puede utilizar en la codemagic.yaml configuración para obtener el archivo específico.

• Subir certificado
• Generar nuevo certificado
• Obtener desde el Portal de Desarrolladores

1. Abre tus ajustes de equipo de Codemagic, ve a ajustes de codemagic.yaml > identidades de firma Code.
2. Abre certificados de iOS pestaña.
3. Sube el archivo de certificado haciendo clic en Elige un archivo .p12 o .pem o arrastrándolo a la caja indicada.
4. Introduce el Contraseña de certificado y elegir un Nombre de referencia.
5. Hacer clic Agregar certificado

Agregar el perfil de configuración de provisión

Codemagic te permite subir un perfil de configuración de provisión para usarlo en la aplicación o para obtener un perfil desde el Portal del Desarrollador de Apple.

El tipo de perfil, equipo, identificador de paquete y fecha de expiración se muestran para cada perfil agregado a las identidades de firma de Code. Además, Codemagic te permitirá saber si está disponible un certificado de firma de code en las identidades de firma de Code (un signo de verificación verde en el Certificado campo) o no.

3. Configurar Codemagic

Configurar secretos de Codemagic

¿Alguna vez te has preguntado dónde están los valores de los ENV ¿De dónde vienen? Bueno, ya no es un secreto – proviene de tu proyecto secreto. 🤦

4. Configura archivo de flujo de Codemagic

Crear un archivo llamado codemagic.yml en la raíz de tu proyecto y agrega lo siguiente.

workflows:
  ionic-capacitor-ios-workflow:
    name: Capacitor iOS Workflow
    max_build_duration: 120
    instance_type: mac_mini_m1
    integrations:
      app_store_connect: CodeMagic
    environment:
      ios_signing:
        distribution_type: app_store
        bundle_identifier: YOUR_BUNDLE_IDENTIFIER
      vars:
        XCODE_WORKSPACE: ios/App/App.xcworkspace
        XCODE_SCHEME: App
        APP_STORE_APP_ID: YOUR_APP_STORE_APP_ID
      node: v20.14.0
      xcode: 15.4
      cocoapods: default
    triggering:
      events:
        - tag
      tag_patterns:
        - pattern: '*'
          include: true
    scripts:
      - name: Install dependencies
        script: |
          npm install
      - name: Cocoapods installation
        script: |
          cd ios/App && pod install
      - name: Update dependencies and copy web assets to native project
        script: |
          npm run build
          npx cap sync ios
      - name: Set up code signing settings on Xcode project
        script: |
          xcode-project use-profiles
      - name: Increment build number
        script: |
          cd $CM_BUILD_DIR/ios/App
          LATEST_BUILD_NUMBER=$(app-store-connect get-latest-app-store-build-number "$APP_ID")
          agvtool new-version -all $(($LATEST_BUILD_NUMBER + 1))
      - name: Build ipa for distribution
        script: |
          xcode-project build-ipa \
            --workspace "$XCODE_WORKSPACE" \
            --scheme "$XCODE_SCHEME"
    artifacts:
      - build/ios/ipa/*.ipa
      - /tmp/xcodebuild_logs/*.log
      - $HOME/Library/Developer/Xcode/DerivedData/**/Build/**/*.app
      - $HOME/Library/Developer/Xcode/DerivedData/**/Build/**/*.dSYM
    publishing:
      email:
        recipients:
          - YOUR_EMAIL
        notify:
          success: true # To not receive a notification when a build succeeds
          failure: false # To not receive a notification when a build fails
      app_store_connect:
        auth: integration
        # Configuration related to TestFlight (optional)
        # Note: This action is performed during post-processing.
        submit_to_testflight: true
        # Configuration related to App Store (optional)
        # Note: This action is performed during post-processing.
        submit_to_app_store: false

Este flujo debe ser desencadenado manualmente o después de cada GitHub etiqueta, si necesitas automatizar la etiqueta, por favor, consulta Compilación y lanzamiento automático con GitHub acciones primero.

Luego, este flujo extraerá tus dependencias NodeJS, las instalará y construirá tu aplicación de JavaScript.

Cada vez que envíes una nueva etiqueta, se construirá una versión de prueba en TestFlight.

No es necesario que tu aplicación utilice Ionic, solo es necesario la base Capacitor , puede tener módulos de Cordova antiguos, pero se recomienda utilizar el plugin de JavaScript Capacitor

5. Desencadena flujo de trabajo

Desencadena el flujo de trabajo

Envía los nuevos commits a la rama main o development para desencadenar el flujo de trabajo.

Después de unos minutos, el build debería estar disponible en tu panel de control de App Store Connect.

Iniciar manualmente

Puedes iniciar el flujo de trabajo manualmente.

Primero selecciona la aplicación que deseas compilar, luego haz clic en Iniciar nueva compilación.

Selecciona la rama que deseas compilar.

Y haz clic en Iniciar nueva compilación.

Luego ve a la lista de compilaciones

Y haz clic en la compilación para ver el resultado.

Puedes desplegar desde la máquina local

Sí, puedes, y es sencillo.

Puedes utilizar Xcode para compilar y firmar tu aplicación, como siempre.

Gracias

Este blog se basa en los siguientes artículos:

• Entrega continua para IOS utilizando Codemagic y GitHub acciones
• Documentación de Codemagic
• Este GitHub mensaje de @mrogunlana

Keep going from Automatic Capacitor IOS build with Codemagic

Si estás utilizando Automatic Capacitor IOS build with Codemagic 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 Construcciones Nativas para el flujo de trabajo del producto en Capgo Compilaciones Nativas, 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.