Creación de aplicaciones Objective-C o Swift para macOS

Para empezar a compilar la primera aplicación de Mac, siga estos pasos:

1. Conéctese a la cuenta de servicio del repositorio (GitHub, Bitbucket, VSTS, Azure DevOps).
2. Seleccione un repositorio y una rama donde reside la aplicación.
3. Configure el proyecto o área de trabajo de la compilación y el esquema que desea compilar.

1. Vinculación del repositorio

Debe conectarse a la cuenta de servicio del repositorio. Una vez conectada la cuenta, seleccione el repositorio donde se encuentra el proyecto de Mac. Para configurar una compilación para un repositorio, necesita permiso de administrador y extracción para él.

2. Selección de una rama

Después de seleccionar un repositorio, seleccione la rama que desea compilar. De forma predeterminada, se mostrarán todas las ramas activas.

3. Configuración de la primera compilación

Antes de la primera compilación, es necesario configurar el proyecto de Mac.

3.1. Proyecto,área de trabajo y esquema

Para una configuración de compilación, se requiere un proyecto de Xcode o un área de trabajo de Xcode y un esquema compartido. App Center detecta automáticamente los proyectos, las áreas de trabajo y los esquemas compartidos de la rama. Seleccione el proyecto o área de trabajo que desea compilar y el esquema correspondiente.

Si no se encuentra ningún esquema, confirme que el esquema con el que desea compilar está compartido y que el contenedor del esquema es el proyecto o el área de trabajo que ha seleccionado. Asegúrese también de que estos cambios están registrados en la rama para la que está configurando la compilación.

3.2. Versión de Xcode

Seleccione la versión de Xcode en la que ejecutar la compilación.

3.3. Desencadenadores de compilación

De forma predeterminada, se desencadena una nueva compilación cada vez que un desarrollador inserta en una rama configurada. Esto se conoce como "Integración continua". Si prefiere desencadenar una nueva compilación manualmente, puede cambiar esta configuración en la configuración de compilación.

3.4. Incrementar el número de compilación

Cuando se habilita, en info.plist de la aplicación se incrementa CFBundleVersion automáticamente para cada compilación. El cambio se produce antes de la compilación y no se confirma en el repositorio.

3.5. Pruebas

Si el esquema seleccionado tiene una acción de prueba con un destino de prueba seleccionado, puede configurar las pruebas para que se ejecuten como parte de cada compilación. App Center puede ejecutar actualmente pruebas unitarias de XCTest. App Center no admite pruebas de inicio para compilaciones de Mac.

3.6. Firma de código

Una compilación correcta producirá un .app archivo. Para instalar la compilación en un dispositivo, debe ser un certificado firmado. Para firmar las compilaciones producidas desde una rama, habilite la firma de código en el panel de configuración y cargue un certificado válido (.p12),junto con la contraseña del certificado. La configuración del proyecto de Xcode debe ser compatible con los archivos que está cargando. Un perfil de aprovisionamiento es opcional para la firma de código.

Actualmente, App Center solo admite estas configuraciones de firma:

• Firma manual mediante el método de exportación de desarrollo solo con un certificado de desarrollo
• Firma manual mediante el método de exportación de id. de desarrollador
• Firma automática mediante el método de exportación desarrollo

Puede leer más sobre el inicio de sesión de código App Center la guía de firma de código de macOS y en la guía oficial para desarrolladores de Apple.

3.7. CocoaPods

App Center examina la rama seleccionada y, si encuentra un podfile, realizará automáticamente un paso al pod install principio de cada compilación. Esto garantiza que todas las dependencias estén instaladas.

Si el repositorio ya contiene una carpeta /Pods, App Center supone que ha activado los pods en el repositorio y ya no ejecutará pod install .

3.8. Distribuir a un grupo de distribución

Puede configurar cada compilación firmada correctamente desde una rama para distribuirla a un grupo de distribución creado anteriormente. Puede agregar un nuevo grupo de distribución desde la sección Distribuir. Siempre hay un grupo de distribución predeterminado denominado "Colaboradores" que incluye todos los usuarios que tienen acceso a la aplicación.

Una vez que guarde la configuración, se iniciará automáticamente una nueva compilación.

4. Resultados de la compilación

Una vez desencadenada una compilación, puede encontrarse en los siguientes estados:

• en cola: la compilación está en cola, esperando a que los recursos sean gratuitos.
• building: la compilación ejecuta las tareas predefinidas.
• succeeded: la compilación se completó correctamente.
• failed: la compilación encontró errores que impedieron que se completara. Para solucionar problemas de la compilación, descargue e inspeccione los registros de compilación.
• canceled: la compilación se canceló mediante una acción del usuario o se ha cancelado el tiempo de espera.

4.1. Registros de compilación

Para una compilación completada (correcta o con errores), descargue los registros para obtener más información sobre cómo ha ido la compilación. App Center proporciona un archivo con los siguientes archivos:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1> (e.g. 2_Get Sources.txt)
    |-- <build-step-2> (e.g. 3_Pod install.txt)
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Los registros específicos del paso de compilación (ubicados en el directorio del archivo) son útiles para solucionar problemas y comprender en qué paso y por qué se ha generado build un error en la compilación.

4.2. La aplicación (.app)

El .app archivo es un archivo de archivo de aplicación Mac, que contiene la aplicación mac.

• Si la compilación está firmada correctamente, el archivo se puede instalar en un dispositivo correspondiente al perfil de aprovisionamiento .app usado al firmar. Puede encontrar más detalles sobre la firma y distribución de código App Center en la documentación de firma de código de App Center macOS dela aplicación .
• Si la compilación no se ha firmado, .app el desarrollador puede firmar el archivo. Por ejemplo, mediante codesign.

4.3. Archivo de símbolos (.dsym)

Los .dsym archivos contienen los símbolos de depuración de la aplicación.

• Si ha agregado el SDK de App Center en la aplicación con el módulo de informes de bloqueo habilitado, el servicio de informes de bloqueo requiere este archivo para que una compilación muestre informes de bloqueo legibles .dsym (simbólicos).
• Si ha agregado otro SDK para informes de bloqueos en la aplicación, como el SDK de HockeyApp, el servicio requiere que el archivo muestre informes de bloqueo .dsym legibles.

Los .dsym archivos no cambian al firmar el código .app . Si decide firmar la compilación más adelante, el .dsym generado antes de la firma de código sigue siendo válido.

Componentes internos de compilación

Para compilar el proyecto, usamos , una herramienta de línea de comandos que le permite compilar, consultar, analizar, probar y archivar los proyectos y áreas de trabajo de xcodebuild Xcode.

Versiones y requisitos admitidos

Los detalles de la versión de la máquina de compilación se actualizan cada vez que se agrega una nueva versión de macOS. Se incluyen las versiones más recientes publicadas por Apple lo antes posible en nuestras máquinas virtuales de compilación.