Publicación de una aplicación de iOS para la distribución a través del App Store
El enfoque más común para distribuir aplicaciones iOS a los usuarios es a través de App Store. Las aplicaciones se envían al App Store mediante una herramienta en línea denominada App Store Connect. Solo los desarrolladores que pertenecen al Apple Developer Program tienen acceso a esta herramienta. Los miembros del Programa para desarrolladores empresariales de Apple no tienen acceso. Todas las aplicaciones que se envían al App Store requieren la aprobación 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 contiene un ID de Apple y un certificado de distribución. Puedes usar el mismo identificador de aplicación que usaste al implementar la aplicación en un dispositivo para realizar pruebas. Pero deberás crear un certificado de distribución para identificarte tú mismo o tu organización, si aún no tienes uno.
El proceso para crear un perfil de aprovisionamiento de distribución del App Store es el siguiente:
- Crear un certificado de distribución. Para obtener más información, consulta Crear un certificado de distribución.
- 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.
Importante
Apple tiene una directiva de privacidad para las aplicaciones destinadas a iOS en la App Store. Requiere que la aplicación incluya un archivo de manifiesto de privacidad en la agrupación de aplicaciones, que muestre los tipos de datos de la aplicación .NET MAUI o los SDK y paquetes de terceros que recopilen, y las razones para usar las API por cualquier motivo necesario. Si el uso de las API necesarias o los SDK de terceros no se declara en el manifiesto de privacidad, la aplicación podría ser rechazada por la App Store. Para obtener más información, consulta manifiesto de privacidad de Apple.
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 permite que la aplicación .NET MAUI iOS esté firmada digitalmente para su publicación, de modo que se pueda instalar en un dispositivo iOS. Un perfil de aprovisionamiento de distribución contiene un identificador de aplicación y un certificado de distribución.
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 a través del App Store:
En la página Certificates, Identifiers & Profiles de la cuenta de desarrollador de Apple, selecciona la pestaña Profiles.
En la pestaña Perfiles, haz clic en el botón + para crear un nuevo perfil.
En la página Registro de un nuevo perfil de aprovisionamiento, selecciona el botón de radio tienda de aplicaciones antes de hacer clic en el botón Continuar:
En la página Generate a Provisioning Profile, en el menú desplegable App ID, selecciona el id. de aplicación que has creado previamente 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, 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 de iOS para la distribución de App Store y cargarla en App Store. Sin embargo, para poder cargar una aplicación en App Store debes:
- Crear un registro para la aplicación que quieres cargar en App Store en App Store Connect. Este registro incluye toda la información sobre la aplicación, tal como aparecerá en App Store (en tantos idiomas como sea necesario) y toda la información necesaria para administrar la aplicación a través del proceso de distribución. Para obtener más información, consulta Creación de un registro de aplicación en developer.apple.com.
- Crea una contraseña específica para la aplicación. Para obtener información sobre cómo generar una contraseña específica para la aplicación, consulta Inicio de sesión en aplicaciones con el ID de Apple mediante contraseñas específicas de la aplicación en support.apple.com.
Publicación de una aplicación para iOS de .NET MAUI para su distribución en la tienda de aplicaciones:
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 App Store:
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 tu 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 o el botón Cargar en la tienda . El botón Guardar como te permitirá escribir un nombre de archivo, antes de volver a firmar la aplicación y publicarlo en un archivo .ipa en el sistema de archivos para cargarlo posteriormente en App Store a través de una aplicación como Transporter. El botón Cargar en la tienda volverá a firmar la aplicación y la publicará en un archivo .ipa, antes de cargarla en App Store.
Si seleccionas el botón Cargar en la tienda, aparecerá el cuadro de diálogo Cargar para almacenar credenciales después de que Visual Studio haya creado el archivo .ipa. En el cuadro de diálogo Cargar para almacenar credenciales, escribe el identificador de Apple y la contraseña específica de la aplicación y selecciona el botón Aceptar:
Visual Studio validará el paquete de la aplicación y lo cargará en la App Store, siempre que hayas creado un registro de aplicación en App Store Connect.
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.
Solución de problemas
Se puede utilizar Transporter para ayudar a identificar errores con paquetes de aplicaciones que dejan de enviarse correctamente a App Store.
