Publicación de una aplicación de iOS para la distribución ad hoc
La distribución ad hoc se usa principalmente para probar aplicaciones dentro de un amplio grupo de personas y está disponible para el Programa para desarrolladores de Apple y el Programa Apple Developer Enterprise. Otro caso de uso para la distribución ad hoc es la distribución dentro de una empresa cuando App Store Connect no es una opción.
La distribución ad hoc tiene la ventaja de no requerir la aprobación de la App Store, con las aplicaciones que se instalan con Apple Configurator. Sin embargo, se limita a 100 dispositivos por año de pertenencia, tanto para desarrollo como para distribución, y los dispositivos deben agregarse a la cuenta de desarrollador de Apple.
La distribución de una aplicación de iOS requiere que la aplicación se aprovisione mediante un perfil de aprovisionamiento. Los perfiles de aprovisionamiento son archivos que contienen información de firma de código, así como la identidad de la aplicación y el mecanismo de distribución previsto.
Para distribuir una aplicación NET Multi-platform App UI (.NET MAUI) de iOS, deberás crear un perfil de aprovisionamiento de distribución específico. Este perfil permite que la aplicación se firme digitalmente para su publicación de modo que se pueda instalar en un dispositivo iOS. Un perfil de aprovisionamiento de distribución ad hoc contiene un identificador de aplicación, un certificado de distribución y una lista de los dispositivos que pueden instalar la aplicación. Puedes usar el mismo identificador de aplicación que usaste al implementar la aplicación en un dispositivo para realizar pruebas. Sin embargo, tendrás que crear un certificado de distribución para identificarte o a tu organización, si aún no tienes uno.
El proceso para crear un perfil de aprovisionamiento de distribución ad hoc es el siguiente:
- Crear un certificado de distribución. Para obtener más información, consulta Crear un certificado de distribución.
- Agregar dispositivos a la cuenta de desarrollador de Apple. Para obtener más información, consulta Agregar un dispositivo.
- Crear un identificador de aplicación. Para obtener más información, consulta Creación de un identificador de aplicación.
- Crear un perfil de aprovisionamiento. Para obtener más información, consulta Creación de un perfil de aprovisionamiento.
Creación de un certificado de distribución
Un certificado de distribución sirve para confirmar la identidad. Antes de crear un certificado de distribución, asegúrate de que has agregado la cuenta de desarrollador de Apple en Visual Studio. Para obtener más información, consulta Administración de cuentas de Apple.
Solo tiene que crear un certificado de distribución si aún no tiene uno. El certificado de distribución debe crearse con el identificador de Apple de tu cuenta de desarrollador de Apple.
Para crear un certificado de distribución en Visual Studio:
- En Visual Studio, ve a Herramientas > Opciones > Xamarin > Cuentas de Apple.
- En el cuadro de diálogo Cuentas de desarrollador de Apple, selecciona un equipo y haz clic en el botón Ver detalles....
- En el cuadro de diálogo Detalles, haz clic en Crear certificado y selecciona Distribución de iOS. Se creará una nueva identidad de firma y se sincronizará con Apple siempre que tengas los permisos adecuados.
Importante
La clave privada y el certificado que componen la identidad de firma también se exportarán a Keychain Access en el host de compilación de Mac, siempre que el IDE esté emparejado con él. Para obtener más información, consulta Emparejar con Mac para el desarrollo de iOS.
Introducción a los pares de claves de certificado
El perfil de desarrollador contiene certificados, sus claves asociadas y los perfiles de aprovisionamiento asociados con tu cuenta de desarrollador de Apple. Hay dos versiones de un perfil de distribución: existe una en tu cuenta de desarrollador de Apple y la otra reside en un equipo local. La diferencia entre ambas es el tipo de claves que contienen: el perfil de tu cuenta de desarrollador de Apple contiene todas las claves públicas asociadas con los certificados, mientras que la copia del equipo local contiene todas las claves privadas. Para que los certificados sean válidos, los pares de claves deben coincidir.
Advertencia
La pérdida del certificado y de las claves asociadas puede causar muchos problemas, ya que requerirá que se revoquen los certificados existentes y se vuelvan a crear los perfiles de aprovisionamiento.
Crear un perfil de distribución
Un perfil de aprovisionamiento de distribución ad hoc permite que la aplicación .NET MAUI iOS esté firmada digitalmente para su lanzamiento, de modo que se pueda instalar en dispositivos iOS específicos. Un perfil de aprovisionamiento de distribución ad hoc contiene un identificador de aplicación, un certificado de distribución y una lista de los dispositivos que pueden instalar la aplicación. Los dispositivos que deseas admitir deben ejecutar una versión de iOS compatible con Xcode.
Agregar un dispositivo
Al crear un perfil de aprovisionamiento, el perfil debe incluir qué dispositivos pueden ejecutar la aplicación. Antes de seleccionar un dispositivo para agregarlo a un perfil de aprovisionamiento, primero debes agregar el dispositivo a tu cuenta de desarrollador de Apple. Puedes agregar el dispositivo con los pasos siguientes:
Conecta el dispositivo que se va a aprovisionar al equipo local Mac con un cable USB.
Abre Xcode y navega hasta Window > Devices and Simulators.
En Xcode, selecciona la pestaña Devices y selecciona el dispositivo en la lista de dispositivos conectados.
En Xcode, copia el valor Identifier en el portapapeles:
En un explorador web, ve a la sección Devices de tu Cuenta de desarrollador de Apple y haz clic en el botón +.
En la página Register a New Device, establece la plataforma correcta y asigna un nombre al nuevo dispositivo. Después, pega el identificador del portapapeles en el campo Device ID (UDID) y haz clic en Continue:
En la página Register a New Device, revisa la información y, luego, haz clic en Register.
Repite los pasos anteriores para cualquier dispositivo iOS en el que desees implementar una aplicación .NET MAUI para iOS.
Creación de un id. de aplicación
Se requiere un identificador de aplicación para identificar la aplicación que distribuyes. Un identificador de aplicación es similar a una cadena DNS inversa que identifica de forma única una aplicación y debe ser idéntica al identificador del lote de la aplicación. Puedes usar el mismo identificador de aplicación que usaste al implementar la aplicación en un dispositivo para realizar pruebas.
Hay dos tipos de identificadores de aplicación:
- Carácter comodín. Un identificador de aplicación comodín permite usar un identificador de aplicación para que coincida con varias aplicaciones, y normalmente, adopta el formato
com.domainname.*. Puedes usar un identificador de aplicación comodín para distribuir varias aplicaciones y debes usarlo para las aplicaciones que no habilitan las funciones específicas de la aplicación. - Explícita. Un identificador de aplicación explícito es único para una sola aplicación y normalmente adopta el formato
com.domainname.myid. Un identificador de aplicación explícito permite la distribución de una aplicación, con un identificador de la agrupación coincidente. Los identificadores de aplicación explícitos se usan normalmente para las aplicaciones que habilitan funciones específicas de la aplicación, como Apple Pay o Game Center. Para obtener más información, consulta Funcionalidades.
Para crear un nuevo identificador de aplicación:
En tu cuenta de desarrollador de Apple, ve a Certificates, IDs & Profiles.
En la página Certificates, IDs & Profiles, selecciona la pestaña Identifiers.
En la página Identifiers, haz clic en el botón + para crear un nuevo identificador de aplicación.
En la página Register a new identifier, selecciona el botón de radio App IDs antes de hacer clic en el botón Continue:
En la página Register a new identifier, selecciona App antes de hacer clic en el botón Continue:
En la página Registro de un id. de aplicación, introduce una descripción y selecciona el botón de radio Explícito o el id. de paquete de caracteres comodín. Después, introduce el id. de agrupación de tu aplicación en formato DS inverso:
Importante
El identificador de agrupación que escribas debe corresponder al identificador de agrupación del archivo Info.plist del proyecto de aplicación.
El identificador de agrupación de una aplicación .NET MAUI se almacena en el archivo de proyecto como la propiedad Identificador de aplicación. En Visual Studio, en Explorador de soluciones, haz clic con el botón derecho en el proyecto de tu aplicación .NET MAUI y selecciona Propiedades. Después, accede a la pestaña Configuración de MAUI Compartido> General. El identificador de aplicación muestra el identificador de agrupación.
Cuando se actualiza el valor del campo Id. de aplicación, el valor de Identificador de agrupación en el archivo Info.plist se actualizará automáticamente.
En la página Registro de un id. de aplicación, selecciona las capacidades que usa la aplicación. Cualquier capacidad debe configurarse tanto en esta página como en el archivo Entitlements.plist del proyecto de tu aplicación. Para obtener más información, consulta Funcionalidades y Derechos.
En la página Registro de un id. de aplicación, haz clic en el botón Continuar.
En la página de Confirmación de su id. de aplicación, haz clic en el botón Registro.
Creación de un perfil de aprovisionamiento
Una vez creado el identificador de la aplicación, debes crear un perfil de aprovisionamiento de distribución. Este perfil permite que la aplicación se firme digitalmente para su publicación de modo que se pueda instalar en un dispositivo iOS.
Para crear un perfil de aprovisionamiento para la distribución ad hoc:
En la página Certificates, Identifiers & Profiles de la cuenta de desarrollador de Apple, selecciona la pestaña Profiles.
En la pestaña Profiles, haz clic en el botón + para crear un nuevo perfil.
En la página Register a New Provisioning Profile, selecciona el botón de radio Ad Hoc antes de hacer clic en el botón Continue:
En la página Generate a Provisioning Profile, en la lista desplegable App ID, selecciona el identificador de aplicación que creaste anteriormente y elige si deseas crear un perfil sin conexión, antes de hacer clic en el botón Continue:
En la página Generate a Provisioning Profile, selecciona el botón de radio que corresponde con tu certificado de distribución antes de hacer clic en el botón Continuar:
En la página Generate a Provisioning Profile, selecciona los dispositivos en los que se instalará la aplicación y, luego, haz clic en el botón Continue.
En la página Generate a Provisioning Profile, introduce un nombre para el perfil de aprovisionamiento antes de hacer clic en el botón Generate:
Nota:
Anota el nombre del perfil de aprovisionamiento, ya que será necesario cuando firmes tu aplicación.
En la página Generate a Provisioning Profile, haz clic opcionalmente en el botón Download para descargar tu perfil de aprovisionamiento.
Nota:
No es necesario descargar tu perfil de aprovisionamiento ahora. En su lugar, lo harás en Visual Studio.
Descarga de perfiles de aprovisionamiento en Visual Studio
Después de crear un nuevo perfil de aprovisionamiento de distribución en la cuenta de Apple Developer, Visual Studio puede descargarlo para que esté disponible para la firma de la aplicación:
- En Visual Studio, ve a Herramientas > Opciones > Xamarin > Cuentas de Apple.
- En el cuadro de diálogo Cuentas de desarrollador de Apple, selecciona el equipo y haz clic en Ver detalles.
- En el cuadro de diálogo Detalles, comprueba que el nuevo perfil aparece en la lista Perfiles de aprovisionamiento. Es posible que debas reiniciar Visual Studio para actualizar la lista.
- En el cuadro de diálogo Detalles, haz clic en Descargar todos los perfiles.
Los perfiles de aprovisionamiento se descargan en Windows y se exportan al host de compilación de Mac si el IDE está emparejado con él. Para obtener más información, consulta Emparejar con Mac para el desarrollo de iOS.
Publicar la aplicación
Visual Studio puede publicar una aplicación .NET MAUI iOS para la distribución ad hoc:
En Visual Studio, asegúrate de que IDE está emparejado con un host de compilación de Mac. Para obtener más información, consulta Emparejar con Mac para el desarrollo de iOS.
En la barra de herramientas de Visual Studio, usa la lista desplegable Depurar destino para seleccionar iOS Remote Devices y, a continuación, Dispositivo remoto:
En la barra de herramientas de Visual Studio, usa la lista desplegable Configuración de soluciones para cambiar de la configuración de depuración a la configuración de versión:
En Explorador de soluciones, haz clic con el botón derecho en el proyecto de aplicación .NET MAUI y selecciona Propiedades. A continuación, navega a la pestaña Firma de lote de iOS y asegúrate de que Esquema está en Aprovisionamiento manual, Identidad de firma está en Distribución (automática) y Perfil de aprovisionamiento está en Automático:
Esta configuración garantizará que Visual Studio seleccione el perfil de aprovisionamiento correcto en función del identificador de agrupación de Info.plist (que es idéntico al valor de la propiedad Id. de aplicación en el archivo de proyecto). Como alternativa, establece Identidad de firma en el certificado de distribución adecuado y Perfil de aprovisionamiento en el perfil que creaste en la cuenta de desarrollador de Apple.
En el Explorador de soluciones, haz clic con el botón derecho en el proyecto de aplicación .NET MAUI y selecciona Publicar...:
Se abrirá Archive Manager y Visual Studio empezará a archivar el lote de aplicaciones:
El proceso de archivado firma la aplicación con el certificado y los perfiles de aprovisionamiento que especificaste en la pestaña Firma de lote de iOS para la configuración de la solución seleccionada.
En el Administrador de archivos, una vez que el archivado se haya completado correctamente, asegúrate de que el archivo está seleccionado y, a continuación, selecciona el botón Distribuir... para comenzar el proceso de empaquetado de la aplicación para su distribución:
Aparecerá el cuadro de diálogo Distribuir- Seleccionar canal.
En el cuadro de diálogo Distribuir - Seleccionar canal, selecciona el botón Ad Hoc:
En el cuadro de diálogo Distribuir- Identidad de firma, selecciona la identidad de firma y el perfil de aprovisionamiento:
Nota:
Debes usar la identidad de firma y el perfil de aprovisionamiento que se crearon para la aplicación y el canal de distribución seleccionado.
En el cuadro de diálogo Distribuir - Identidad de firma, selecciona el botón Guardar como y escribe un nombre de archivo. La aplicación se volverá a firmar y publicar en un archivo .ipa en el sistema de archivos.
Después, la aplicación se puede distribuir mediante Apple Configurator. Para obtener más información, consulta Apple Configurator user guide en support.apple.com.
Para obtener información sobre cómo publicar una aplicación de iOS mediante la interfaz de línea de comandos (CLI), consulta Publicación de una aplicación de iOS mediante la línea de comandos.
