Aprovisionamiento manual de Xamarin.iOS

  • Artículo

Una vez que se ha instalado correctamente Xamarin.iOS, el paso siguiente en el desarrollo de iOS consiste en aprovisionar el dispositivo iOS. En esta guía se analiza el uso del aprovisionamiento manual para establecer certificados de desarrollo y perfiles.

Nota:

Las instrucciones que se muestran en esta página son relevantes para los desarrolladores que han pagado por el acceso al programa de Apple Developer. Si tiene una cuenta gratuita, consulte la guía de aprovisionamiento gratuito para obtener más información acerca de las pruebas en dispositivos.

Creación de un certificado de desarrollo

El primer paso para configurar un dispositivo de desarrollo consiste en crear un certificado de firma. Un certificado de firma consta de dos partes:

  • Un certificado de desarrollo
  • Una clave privada

Los certificados de desarrollo y las claves asociadas son fundamentales para un desarrollador de iOS, ya que establecen su identidad con Apple y lo asocian a un dispositivo determinado y a un perfil de desarrollo, como si incluyeran su firma digital en las aplicaciones. Apple busca certificados para controlar el acceso a los dispositivos en los que se puede implementar.

Los equipos de desarrollo, los certificados y los perfiles pueden administrarse mediante el acceso a la sección Certificados, identificadores y perfiles del Centro de usuarios registrados de Apple (se requiere iniciar sesión). Apple requiere que tenga una identidad de firma para compilar el código para el dispositivo o el simulador.

Importante

Es importante que tenga en cuenta que solo puede tener dos certificados de desarrollo de iOS en todo momento. Si necesita crear otro, deberá revocar uno existente. Si una máquina usa un certificado revocado, no podrá firmar la aplicación.

Antes de iniciar el proceso de aprovisionamiento manual, debe asegurarse de que ha agregado una cuenta de desarrollador de Apple en Visual Studio, tal y como se explica en el artículo Administración de cuentas de Apple. Después de agregar su cuenta de desarrollador de Apple, haga lo siguiente para generar un certificado de firma:

  1. Vaya a la ventana de cuentas de desarrollador de Apple en Visual Studio.

    1. Mac: Preferencias > de Visual Studio > Cuenta de desarrollador de Apple
    2. Windows: Opciones de herramientas > de > cuentas de Apple de Xamarin >

  2. Seleccione un equipo y haga clic en Ver detalles…

  3. Haga clic en Crear certificado y seleccione Apple Development (Desarrollo de Apple) o iOS Development (Desarrollo de iOS). Si tiene los permisos correctos, aparecerá una nueva identidad de firma pasados unos segundos.

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 la cuenta. Cada perfil de desarrollador tiene dos versiones: una se encuentra en el portal para desarrolladores y la otra reside en un equipo Mac local. La diferencia entre ambas es el tipo de claves que contienen: el perfil del portal contiene todas las claves públicas asociadas con los certificados, mientras que la copia del equipo Mac 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 aprovisionar los dispositivos asociados, incluidos los registrados para la implementación ad hoc. Después de configurar correctamente los certificados de desarrollo, exporte una copia de seguridad y almacénelos en un lugar seguro. Para obtener más información sobre cómo hacerlo, consulte la sección sobre la exportación y la importación de certificados y perfiles de la guía Maintaining Certificates (Mantener certificados) en la documentación de Apple.

Aprovisionamiento de un dispositivo iOS para el desarrollo

Ahora que ha establecido su identidad con Apple y tiene un certificado de desarrollo, debe configurar un perfil de aprovisionamiento y las entidades necesarias para poder implementar una aplicación en un dispositivo Apple. El dispositivo debe ejecutar una versión de iOS compatible con Xcode. Por ello, puede ser necesario actualizar el dispositivo, Xcode o ambos.

Agregar un dispositivo

Al crear un perfil de aprovisionamiento para el desarrollo, hay que indicar qué dispositivos pueden ejecutar la aplicación. Para ello, se pueden agregar hasta 100 dispositivos por año natural en el portal para desarrolladores y, desde aquí, se pueden seleccionar los dispositivos que se agregarán a un determinado perfil de aprovisionamiento. Siga estos pasos en su Mac para agregar un dispositivo en el portal para desarrolladores.

  1. Conecte el dispositivo que se va a aprovisionar al equipo Mac con el cable USB suministrado.

  2. Abra Xcode y vaya a Dispositivos y simuladores de ventana>.

  3. En la pestaña Dispositivos, seleccione el dispositivo en el menú del lado izquierdo.

  4. Resalte la cadena Identificador y cópiela en el Portapapeles:

    Xcode devices and simulator window with the iOS identifier string location highlighted.

  5. En un explorador web, vaya a la sección de dispositivos en el portal para desarrolladores y haga clic en el botón +:

    Screenshot of the devices page on the Apple Developer site with the add button highlighted.

  6. Seleccione la plataforma correcta y proporcione un nombre para el nuevo dispositivo. Pegue el identificador que ha copiado anteriormente en el campo Id. del dispositivo:

    Screenshot of the new device registration page with the fields correctly populated.

  7. Haga clic en Continue.

  8. Revise la información y, después, haga clic en Registrar.

Repita los pasos anteriores para todos los dispositivos iOS que se vayan a usar para probar o depurar una aplicación de Xamarin.iOS.

Creación de un perfil de aprovisionamiento de desarrollo

Después de agregar el dispositivo en el portal para desarrolladores, deberá crear un perfil de aprovisionamiento y agregarle el dispositivo.

Antes de crear un perfil de aprovisionamiento, se debe crear un Id. de aplicación. Un identificador de aplicación es una cadena de estilo DNS inversa que identifica una aplicación de forma exclusiva. En los pasos siguientes se muestra cómo crear un identificador de aplicación comodín, que se puede usar para compilar e instalar la mayoría de las aplicaciones. Los identificadores de aplicación explícitos solo permiten la instalación de una aplicación (con el identificador de paquete coincidente) y generalmente se usan para determinadas características de iOS, como Apple Pay y HealthKit. Para más información sobre la creación de Id. de aplicación explícitos, vea la guía Trabajar con capacidades.

Nuevo identificador de aplicación comodín

  1. Vaya a la sección de identificadores en el portal para desarrolladores y haga clic en el botón +.

  2. Seleccione App IDs (Id. de aplicación) y haga clic en Continuar.

  3. Proporcione una Descripción. A continuación, establezca Bundle ID (Id. del lote) en Wildcard (Comodín) y escriba un identificador con el formato com.[DomainName].*:

    Screenshot of new App ID registration page with required fields populated.

  4. Haga clic en Continue.

  5. Revise la información y, después, haga clic en Registrar.

Nuevo perfil de aprovisionamiento

Una vez que se ha creado el identificador de aplicación, se puede crear el perfil de aprovisionamiento. Este contiene información sobre a qué aplicación (o aplicaciones, si es un identificador de aplicación comodín) hace referencia este perfil, quién puede usar el perfil (en función de los certificados de desarrollador que se agreguen) y qué dispositivos pueden instalar la aplicación.

Para crear manualmente un perfil de aprovisionamiento para el desarrollo, haga lo siguiente:

  1. Vaya a la sección de perfiles en el portal para desarrolladores y haga clic en el botón +.

  2. En Development (Desarrollo), seleccione iOS App Development (Desarrollo de aplicaciones iOS) y haga clic en Continuar.

  3. En el menú desplegable, seleccione el identificador de aplicación que se va a usar y haga clic en Continuar.

  4. Seleccione los certificados que se van a incluir en el perfil de aprovisionamiento y haga clic en Continuar.

  5. Seleccione todos los dispositivos en los que se va a instalar la aplicación y, después, haga clic en Continuar.

  6. Proporcione un nombre del perfil de aprovisionamiento y haga clic en Generar.

  7. También puede hacer clic en Descargar en la página siguiente para descargar el perfil de aprovisionamiento en el equipo Mac.

Descarga de perfiles de aprovisionamiento en Visual Studio

Después de crear un nuevo perfil de aprovisionamiento en el portal de Apple Developer, use Visual Studio para descargarlo para que esté disponible para la firma de lotes en la aplicación.

  1. Vaya a la ventana de cuentas de desarrollador de Apple en Visual Studio.

    1. Mac: Preferencias > de Visual Studio > Cuenta de desarrollador de Apple
    2. Windows: Opciones de herramientas > de > cuentas de Apple de Xamarin >

  2. Seleccione su equipo y haga clic en Ver detalles…

  3. Compruebe que el nuevo perfil aparece en la lista Perfiles de aprovisionamiento. Es posible que deba reiniciar Visual Studio para actualizar la lista.

  4. Haga clic en Descargar todos los perfiles.

El nuevo perfil de aprovisionamiento estará disponible en Visual Studio y listo para su uso.

Implementar en un dispositivo

En este momento, el aprovisionamiento se ha completado y la aplicación está lista para su implementación en el dispositivo. Para ello, siga estos pasos:

  1. Conecte el dispositivo al equipo Mac.

  2. Abra el archivo Info.plist y asegúrese de que el identificador de lote coincide con el identificador de la aplicación que ha creado anteriormente (a menos que este sea un carácter comodín):

  3. En la sección Firma, seleccione Aprovisionamiento manual como el esquema:

    Screenshot of Info.plist in Visual Studio for Mac with manual provisioning selected

  4. Haga clic en Bundle Signing Options… (Opciones de firma de lotes…).

  5. Asegúrese de que la configuración de compilación está establecida en Depuración | iPhone. Abra los menús desplegables Identidad de firma y Perfil de aprovisionamiento para comprobar que se muestran los certificados y los perfiles de aprovisionamiento correctos:

    iOS bundle signing property page with the provisioning profile dropdown menu open listing all the available provisioning profiles for the app.

  6. Seleccione una identidad y un perfil específicos para usar o déjelo como Automático. Si está establecido en Automático, Visual Studio para Mac seleccionará la identidad y el perfil en función del identificador de lote de Info.plist.

  7. Haga clic en OK.

  8. Haga clic en Ejecutar para implementar la aplicación en su dispositivo.

Aprovisionamiento de servicios de aplicación

Apple proporciona una selección de servicios de aplicación especiales, también denominados funciones, que pueden activarse para una aplicación de Xamarin.iOS. Estos servicios de aplicación deben configurarse en el portal de aprovisionamiento de iOS al crear el identificador de aplicación y en el archivo Entitlements.plist que forma parte del proyecto de la aplicación de Xamarin.iOS. Para obtener más información sobre cómo agregar servicios de aplicación a la suya propia, consulte las guías Introduction to Capabilities (Introducción a las capacidades) y Working with Entitlements (Trabajar con derechos).

  • Cree un id. de aplicación con los servicios de aplicación necesarios.
  • Cree un nuevo perfil de aprovisionamiento que contenga dicho id. de aplicación.
  • Establecer derechos en el proyecto de Xamarin.iOS