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
El servicio es ‘gratuito’ hasta 500 minutos de macOS M1 al mes, dependiendo de la máquina elegida.
Vamos a utilizar una máquina de macOS M1 puedes ver en la captura de pantalla su precio y límites (precios a la creación de este tutorial, pueden cambiar en el futuro)
🔴 Una vez advertidos de los requisitos y precios, si te gusta, continuamos…
📣 En el post asumimos que ya tenemos la aplicación creada en iTunes connect, tenemos los certificados del ecosistema de Apple, todo estará configurado por Codemagic!
¡Vamos a sumergirnos! 🤿
Pasos a seguir en el post
- Usando App Store Connect API con Codemagic
- Requisitos
- Crear una clave de App Store Connect API
- Usando una clave de App Store Connect API
- Copiar archivos de Fastlane
- 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
Para empezar a trabajar con match, es necesario revocar los certificados existentes. Pero no se preocupe, obtendrá el nuevo directamente.
Requisitos
Para poder utilizar App Store Connect API, Codemagic necesita tres ID. del emisor.
- ID. de la clave.
- Archivo de clave o contenido de la clave.
- Crear una clave de App Store Connect __CAPGO_KEEP_0__
Creating an App Store Connect API Key
1 — Inicie sesión en
App Store Connect three.
2 — Seleccionar Usuarios y Acceso.
3 — Seleccionar la pestaña de API Claves.
4 — Haga clic en Generar API Clave o en el botón Agregar (+).
5 — Ingrese el nombre de la clave y seleccione un nivel de acceso. Recomendamos elegir App Manager derechos de acceso, leer más sobre los permisos del rol del programa de desarrollador de Apple aquí Las claves de App Store Connect __CAPGO_KEEP_0__ crean nombre
7 — The key has been created successfully. You can view the key in the __CAPGO_KEEP_0__ Keys tab.
Una clave API no puede tener acceso limitado a aplicaciones específicas.
El nombre de la nueva clave, el ID de la clave, un enlace de descarga y otra información aparecen en la página.
Obtén aquí las tres informaciones necesarias:
1. ID de la solicitud.
2. ID de la clave.
3. Haz clic en "Descargar clave API" para descargar tu clave privada API. 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 compartas tus claves, almacena claves en un repositorio code o incluye claves en el lado del cliente code.
Agregar la clave de App Store Connect API a Codemagic
-
Abre tus configuraciones de equipo de Codemagic
Selecciona identidades de firma code
Y subir el certificado
-
Haga clic en Agregar clave botón.
-
Ingrese el
App Store Connect API key nameEste 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. -
Ingrese los
Issuer IDyKey IDvalores. -
Haga clic en Elige un archivo .p8 o arrastra el archivo para subir la clave App Store Connect API descargada anteriormente.
-
Haga clic Guardar.
¡Genial! Ahora podemos gestionar Codemagic con la clave App Store Connect API,
2. Crea certificados y perfiles de configuración
Certificados
Abra XCode y vaya a Configuración > Cuentas > ID de Apple > Equipos y selecciona tu equipo.
Haz clic en Administrar 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 sesión de inicio llave y luego la pestaña Mis Certificados.
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.
El nombre se utilizará para identificar el perfil en Codemagic.
Puedes descargar el perfil como un .mobileprovision archivo.
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 necesarias para utilizarlo. Cuando se sube, Codemagic te pedirá que proporciones la contraseña del certificado (si el certificado está protegido con contraseña) junto con un nombre de referencia único,que luego se puede utilizar en la codemagic.yaml configuración para recuperar el archivo específico.
- Subir certificado
- Generar nuevo certificado
- Obtener desde el Portal de Desarrolladores
- Abrir tus ajustes de equipo de Codemagic, ir a ajustes de codemagic.yaml > Code identidades de firma.
- Abrir certificados de iOS pestaña.
- Subir el archivo de certificado haciendo clic en seleccionar un archivo .p12 o .pem o arrastrándolo a la ventana indicada.
- Ingrese el Contraseña de certificado y elija un Nombre de referencia.
- Haga clic Agregar certificado
Agregar el perfil de configuración de provisión
Codemagic le 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.
The profile’s type, team, bundle id, and expiration date are displayed for each profile added to Code signing identities. Furthermore, Codemagic will let you know whether a matching code signing certificate is available in Code signing identities (a green checkmark in the Además, Codemagic le informará si está disponible un certificado de firma de __CAPGO_KEEP_1__ que coincida en las identidades de firma de __CAPGO_KEEP_2__ (un signo de verificación verde en el Certificado
campo) o no.
Configura secretos de Codemagic
¿Alguna vez te has preguntado de dónde provienen los valores de los ENV ¿No es un secreto más? – provienen de tu proyecto secreto. 🤦
4. Configura archivo de flujo de trabajo de Codemagic
Crea 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
This workflow should be triggered manually or after each GitHub etiqueta, si necesitas automatizar la etiqueta, consulta Automatic build and release with GitHub actions primero.
Luego, este flujo de trabajo extraerá tus dependencias NodeJS, las instalará y compilará tu aplicación de JavaScript.
Cada vez que envíes una nueva etiqueta, se construirá una versión en TestFlight.
Tu aplicación no necesita utilizar Ionic, solo es obligatorio el Capacitor base, puede tener el módulo Cordova antiguo, pero el Capacitor plugin de JavaScript se debe preferir.
5. Activar flujo de trabajo
Activar el flujo de trabajo
Pushear los nuevos commits a la rama main o development para activar el flujo de trabajo.
Después de unos minutos, la construcción 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 construir, luego haz clic en Iniciar nueva construcción.
Luego selecciona la rama que deseas construir.
Y haz clic en Iniciar nueva construcción.
Luego ve a la lista de construcciones
Y haz clic en la construcción para ver el resultado.
Puedes desplegar desde la máquina local
Sí, puedes, y es sencillo.
Puedes usar Xcode para compilar y firmar tu aplicación, como siempre.
Gracias
Este blog se basa en los siguientes artículos:
