Compilaciones automáticas de iOS con GitHub Actions usando certificados
La configuración de CI/CD para aplicaciones Capacitor puede ser compleja y llevar mucho tiempo. Esto es lo que necesitas saber:
Prerrequisitos
Antes de comenzar, necesitarás configurar:
- Una cuenta de GitHub con acceso de administrador
- Membresía del programa de desarrollador de iOS
- Acceso a la API de App Store Connect con los permisos adecuados
- Comprensión de los flujos de trabajo de GitHub Actions
- Conocimiento de la configuración de Fastlane
- Tiempo para mantener y depurar el pipeline
- Certificados y perfiles de aprovisionamiento adecuados
Configuración profesional de CI/CD por Capgo
Evita la complejidad: Capgo configura tu pipeline de CI/CD directamente en tu plataforma preferida:
- Independencia de plataforma: Funciona con GitHub Actions, GitLab CI u otros
- Integración perfecta: No necesitas cambiar de plataforma, funciona con tu proceso actual
- Configuración personalizada: Configuración adaptada a las necesidades de tu proyecto
- Guía experta: Ya hemos configurado CI/CD para más de 50 aplicaciones
Precios
- Tarifa única de configuración: $2,600
- Tus costos operativos: ~$300/año
- Comparado con otras soluciones propietarias: $6,000/año
- Ahorra $26,100 en 5 años
Guía de configuración manual
Si aún deseas configurar todo por ti mismo, esto es lo que necesitas hacer:
Entrega continua para iOS usando Fastlane y GitHub Actions y certificado
Prerrequisitos
Antes de continuar con el tutorial:
- Asegúrate de tener Fastlane instalado en tu máquina de desarrollo
- Asegúrate de ser parte del programa de desarrolladores de iOS
Información importante sobre el precio
https://githubcom/features/actions
El servicio es ‘gratuito’ hasta el límite, dependiendo de la máquina elegida
Vamos a usar una máquina macOS, puedes ver en la captura su precio y límites (precios a la fecha de creación del tutorial, podrían sufrir cambios en el futuro)
Una vez advertidos los requisitos y precios, continuemos
Nota: En esta publicación asumo que tienes la aplicación creada en App Store Connect ¡La información importante será copiada por Fastlane!
Qué aprenderás en el tutorial
Pasos a seguir en la publicación
- Usar la API de App Store Connect con Fastlane
- Requisitos:
- Crear una clave de API de App Store Connect
- Usar una clave de API de App Store Connect
- Requisitos:
- Copiar archivos de Fastlane
- Configurar GitHub Actions
1. Usando la API de App Store Connect con Fastlane
Desde febrero de 2021, se requiere autenticación de dos factores o verificación en dos pasos para que todos los usuarios inicien sesión en App Store Connect. Esta capa adicional de seguridad para tu Apple ID ayuda a asegurar que seas la única persona que pueda acceder a tu cuenta.
De Apple Support
Requisitos
Para que Fastlane pueda utilizar la API de App Store Connect para subir tu aplicación, necesitas proporcionar estas tres cosas:
- ID del emisor
- ID de la clave
- Archivo de clave o contenido de la clave
Obtener una clave de API de App Store Connect
Para generar claves, debes tener permiso de Administrador en App Store Connect. Si no tienes ese permiso, puedes dirigir a la persona relevante a este artículo
-
Inicia sesión en App Store Connect
-
Selecciona Users and Access
- Selecciona la pestaña Integration
- Haz clic en Generate API Key o en el botón Add (+)
- Ingresa un nombre para la clave. El nombre es solo para tu referencia y no es parte de la clave en sí
-
En Access, selecciona el rol para la claveLos roles que se aplican a las claves son los mismos roles que se aplican a los usuarios en tu equipo. Consulta los permisos de roles. Recomendamos seleccionar App manager
-
Click en Generar
El acceso de una clave API no puede limitarse a aplicaciones específicas
El nombre de la nueva clave, ID de clave, enlace de descarga y otra información aparecerán en la página
Puedes obtener las tres informaciones necesarias aquí:
[[HTML_TAG]] ID de Emisor (APPLE_ISSUER_ID secreto)
[[HTML_TAG]] ID de Clave (APPLE_KEY_ID secreto)
[[HTML_TAG]] Click en “Descargar API Key” para descargar tu clave privada API. El enlace de descarga aparece solo si la clave privada aún no se ha descargado. Apple no guarda una copia de la clave privada. Por lo tanto, solo puedes descargarla una vez
🔴 Guarda tu clave privada en un lugar seguro. Nunca debes compartir tus claves, almacenarlas en un repositorio de código o incluirlas en código del lado del cliente
Usando una Clave API de App Store Connect
El archivo de Clave API (archivo p8 que descargas), el ID de clave y el ID de emisor son requeridos para crear el token JWT para autorización. Hay múltiples formas en que esta información puede ser pasada a Fastlane. Elegí usar la nueva acción de Fastlane app_store_connect_api_key. Puedes aprender otras formas en la documentación de Fastlane. Muestro este método porque creo que es la forma más fácil de trabajar con la mayoría de CI, donde puedes establecer variables de entorno
Por favor convierte el archivo p8 que descargaste a Base64 y guárdalo como un secreto (APPLE_KEY_CONTENT)
[[CODE_BLOCK]]
¡Ahora podemos gestionar App Store Connect con Fastlane usando la clave API, excelente!
2. Certificados
Abre XCode y ve a Ajustes > Cuentas > Apple ID > Equipos y selecciona tu equipo
Click en Gestionar certificados
Si aún no has creado un certificado, puedes crear uno nuevo
Click en + y selecciona Apple Distribution
Luego necesitas ir al llavero para descargar el certificado como un archivo p12
Para hacerlo, necesitas ir al llavero, cambiar al llavero inicio y luego a la pestaña Mis Certificados
Entonces puedes seleccionar el certificado que quieres descargar (Busca por la fecha del certificado)
Y luego click derecho en la clave privada del certificado y selecciona Exportar
Elige el formato de archivo Personal Information Exchange (p12)
Eso descargará el certificado como un archivo p12
Por favor abre el archivo en una terminal y usa el siguiente comando para convertirlo a Base64:
[[CODE_BLOCK]]
Esto se convertirá en tu secreto BUILD_CERTIFICATE_BASE64. También, cuando se te solicite, proporciona la contraseña del certificado. Esta contraseña será tu secreto P12_PASSWORD
3. Perfiles de aprovisionamiento
Abre Apple Developer y selecciona el equipo correcto
Luego crea un nuevo perfil, haciendo click en +
Y selecciona App Store Connect
Luego necesitas seleccionar la aplicación correcta, ten cuidado de no usar comodín ya que la firma fallará
Selecciona el certificado correcto que creaste antes (busca por la fecha de vencimiento, debe ser el mismo día y mes que hoy) y click en Continuar
Finalmente ingresa el nombre del perfil y click en Generar
El nombre será usado para identificar el perfil en Fastlane, bajo el valor de
APPLE_PROFILE_NAME
Puedes descargar el perfil como un archivo mobileprovision
