Trabajar con capacidades en Xamarin.iOS

Artículo
01/19/2024

Agregar funcionalidades a una aplicación requiere con frecuencia una configuración de aprovisionamiento adicional. En esta guía se describe la configuración necesaria para todas las funcionalidades.

Apple proporciona a los desarrolladores capacidades (a veces denominadas servicios de aplicaciones) como método para extender la funcionalidad y ampliar el alcance de lo que pueden hacer las aplicaciones de iOS. Gracias a las capacidades, los desarrolladores pueden agregar a su aplicación una integración más profunda de las características de las plataformas, como por ejemplo la capacidad de iniciar transacciones monetarias desde la aplicación, servicios de dispositivo adicionales como Siri, etc. Estas capacidades se pueden usar con los proyectos de Xamarin.iOS. A continuación se muestra la lista completa de los servicios:

Grupos de aplicaciones
Dominios asociados
Protección de datos
Centro de juegos
HealthKit
HomeKit
Configuración inalámbrica de accesorios
iCloud
Compra desde la aplicación
Inter-App Audio
Apple Pay
Cartera
Notificación de inserción
VPN personal
Siri
Maps
Modos en segundo plano
Uso compartido de cadenas de claves
Extensiones de red
Configuración de zona activa
Múltiples rutas
Lectura de etiquetas NFC

Las capacidades se pueden habilitar a través de Visual Studio para Mac y Visual Studio 2019, o manualmente en el portal para desarrolladores de Apple. Hay ciertas capacidades, como Wallet, Apple Pay y iCloud, que requieren una configuración adicional de los identificadores de aplicación.

En esta guía se explica cómo habilitar App Services en la aplicación automáticamente en Visual Studio y manualmente a través de Developer Center, incluida cualquier configuración adicional que pueda ser necesaria.

Agregar servicios de aplicaciones

Para usar las capacidades, la aplicación debe tener un perfil de aprovisionamiento válido que contenga un identificador de aplicación con el servicio correcto habilitado. Este perfil de aprovisionamiento se puede crear automáticamente en Visual Studio para Mac y Visual Studio 2019, o manualmente en Apple Developer Center.

En esta sección se explica cómo usar el aprovisionamiento automático de Visual Studio o Developer Center para habilitar la mayoría de las capacidades. Hay algunas capacidades, como Wallet, iCloud, Apple Pay y los grupos de aplicaciones, que requieren una configuración adicional. Se describen en detalle en las guías adyacentes.

Importante

No todas las capacidades se pueden agregar y administrar con aprovisionamiento automático. La lista siguiente contiene las capacidades admitidas:

HealthKit
HomeKit
VPN personal
Configuración inalámbrica de accesorios
Inter-App Audio
SiriKit
Zona activa
Extensiones de red
Lectura de etiquetas NFC
Múltiples rutas

Las notificaciones push, Game Center, la compra desde la aplicación, los mapas, el uso compartido de cadenas de claves, los dominios asociados y las capacidades de protección de datos no se admiten de momento. Para agregar estas capacidades, use el aprovisionamiento manual y siga los pasos de la sección Centro para desarrolladores.

Las capacidades se agregan a Entitlements.plist en Visual Studio para Mac. Para agregar capacidades, siga estos pasos:

Abra el archivo Info.plist de la aplicación iOS y seleccione el esquema Aprovisionamiento automático y el Equipo en el cuadro combinado. Siga los pasos de la guía Aprovisionamiento automático si necesita ayuda:
Abra el archivo Entitlements.plist y seleccione la capacidad que quiere agregar:

Al seleccionar una capacidad suceden dos cosas:
- Esa característica se agrega al Id. de aplicación.
- Se agrega el par de clave/valor de derechos al archivo Entitlements.plist.
Visual Studio para Mac le avisa una vez que se han realizado estas tareas mediante el siguiente mensaje de correcto:

Uso de Developer Center

El uso del Centro para desarrolladores es un proceso de dos pasos en el que se debe crear un identificador de aplicación y se debe usar dicho identificador para crear un perfil de aprovisionamiento. Estos pasos se detallan a continuación.

Crear un identificador de aplicación con un servicio de aplicaciones

Vaya al Centro para desarrolladores de Apple en un equipo Mac (el equipo Mac que hospeda la compilación en el caso de que use un equipo con Windows) e inicie sesión.
Seleccione Certificates, Identifiers & Profiles (Certificados, identificadores y perfiles):
En Identifiers (Identificadores), seleccione App IDs (Identificadores de aplicación):
Presione el botón + situado en la esquina superior derecha para crear un identificador de aplicación.
Escriba una descripción para el identificador de aplicación, seleccione la opción Explicit App ID (Identificador de aplicación explícito) y especifique un identificador de paquete con el formato com.domain.appname. Este identificador de paquete debe coincidir con el identificador de paquete del proyecto:
En App Services (Servicios de aplicaciones), seleccione los servicios necesarios en la aplicación:
Presione Continue (Continuar).
Confirme el identificador de aplicación. Cada servicio tendrá uno de los siguientes estados: Enabled (Habilitado), Disabled (Deshabilitado) o Configurable, como se muestra a continuación. Si tiene el estado Enabled (Habilitado), quiere decir que está listo para usarlo en un perfil de aprovisionamiento. Si tiene el estado Configurable, quiere decir que se debe efectuar una configuración adicional para esta capacidad. Estos pasos adicionales se describen con más detalle en secciones posteriores.
Haga clic en Register (Registrar) y en Done (Listo). El identificador de aplicación que acaba de crear debe aparecer en la lista de identificadores de aplicación de iOS.

Creación de un perfil de aprovisionamiento

Ahora cree un perfil de aprovisionamiento que contenga este identificador de aplicación. Siga los pasos siguientes:

En el Centro para desarrolladores de Apple, vaya a Perfiles de aprovisionamiento > Todos:
Presione el botón + situado en la esquina superior derecha para crear otro perfil de aprovisionamiento.
Seleccione el tipo de perfil de aprovisionamiento que necesita y haga clic en Continue (Continuar):
En la lista desplegable, seleccione el identificador de aplicación que creó en los pasos anteriores y presione Continue (Continuar):
Seleccione los certificados usados para firmar la aplicación y presione Continue (Continuar):
Seleccione los dispositivos que quiere incluir en este perfil y presione Continue (Continuar):
Asigne un nombre al perfil para que se pueda identificar y presione Continue (Continuar) para generar el perfil:
Presione el botón Download (Descargar) para descargarlo y haga doble clic en el archivo que encontrará en Finder para instalar el perfil de aprovisionamiento.
Si usa Visual Studio, asegúrese de que la opción Aprovisionamiento manual esté seleccionada.
En Visual Studio para Mac o Visual Studio, vaya a Opciones de proyecto > Firma de lote y establezca el perfil de aprovisionamiento en el que se acaba de crear:

Importante

Es posible que también deba establecer claves de derechos en el archivo Entitlement.plist y claves de privacidad en el archivo Info.plist. En la guía Trabajar con derechos se proporciona más información sobre estos derechos.

Pasos siguientes

Una vez que se ha habilitado una funcionalidad en el servidor, se deben seguir unos pasos más para que la aplicación pueda usar la funcionalidad. En la siguiente lista se describen los pasos adicionales que se deben seguir:

Use el espacio de nombres del marco en su aplicación.
Agregue los derechos necesarios a la aplicación. En la guía Trabajar con derechos se proporciona información sobre los derechos necesarios y sobre cómo agregarlos.

Solución de problemas relacionados con las capacidades

En la siguiente lista se detallan algunos de los problemas más comunes que pueden crear obstáculos a la hora de desarrollar una aplicación con un servicio de aplicación habilitado.

Asegúrese de que el identificador se creó y registró correctamente en la sección Certificates, Identifiers & Profiles (Certificados, identificadores y perfiles) del Portal para desarrolladores de Apple.
Asegúrese de que el servicio se haya agregado al identificador de la aplicación (o de la extensión) y de que el servicio esté configurado para usar el grupo de aplicaciones/identificador de comerciante/contenedor creado anteriormente en la sección Certificates, Identifiers & Profiles (Certificados, identificadores y perfiles) del Portal para desarrolladores de Apple.
Asegúrese de que se hayan instalado los perfiles de aprovisionamiento y los identificadores de aplicación y que el archivo Info.plist de la aplicación (en el proyecto de Xamarin) use uno de los identificadores de aplicación configurados anteriormente.
Asegúrese de que el archivo Entitlements.plist de la aplicación (del proyecto de Xamarin) tiene habilitado el servicio correcto.
Asegúrese de que en el archivo info.plist estén establecidas las claves de privacidad correspondientes.
En la opción Firma de lote de iOS de la aplicación, asegúrese de que Derechos personalizados esté establecido en Entitlements.plist. Esta no es la configuración predeterminada para las compilaciones de depuración y del simulador de iOS.

Resumen

En esta guía se han explicado las capacidades o los servicios de aplicaciones y se ha descrito cómo habilitarlos en Visual Studio y en el Centro para desarrolladores de Apple. También se describe cómo configurar servicios más complicados, como Wallet, iCloud, Apple Pay y los grupos de aplicaciones. Por último, se detallan los siguientes pasos de configuración y opciones sencillas para la solución de problemas.

Compartir vía