Introducción a Xamarin.Essentials

Xamarin.Essentials brinda una API multiplataforma única que funciona con cualquier aplicación iOS, Android o UWP accesible desde código compartido, independientemente de cómo se creara la interfaz de usuario. Para obtener más información sobre los sistemas operativos compatibles, consulte la guía de compatibilidad con plataformas y características.

Instalación

Xamarin.Essentials está disponible como paquete NuGet y se incluye en todos los proyectos nuevos de Visual Studio. También se puede agregar a cualquier proyecto existente mediante Visual Studio con los pasos siguientes.

  1. Descargue e instale Visual Studio con Visual Studio Tools para Xamarin.

  2. Abra un proyecto existente o cree uno nuevo con la plantilla de aplicación vacía en Visual Studio C# (Android, iPhone e iPad o multiplataforma).

    Importante

    Si se agrega a un proyecto de UWP, asegúrese de que en las propiedades del proyecto esté establecida la compilación 16299 u otra posterior.

  3. Agregue el paquete NuGet Xamarin.Essentials a cada proyecto:

    En el panel del Explorador de soluciones, haga clic con el botón derecho en el nombre de la solución y seleccione Administrar paquetes NuGet. Busque Xamarin.Essentials e instale el paquete en TODOS los proyectos, incluidos Android, iOS, UWP y las bibliotecas de .NET Standard.

  4. Agregue una referencia a Xamarin.Essentials en cualquier clase de C# para hacer referencia a las API.

    using Xamarin.Essentials;
    
  5. Xamarin.Essentials requiere una configuración específica de plataforma:

    La versión mínima de Android compatible con Xamarin.Essentials es la 4.4, que corresponde a un nivel de API 19, pero la versión de destino de Android para compilar debe ser la 9.0 o 10.0, correspondiente al nivel de API 28 y 29. (En Visual Studio, estas dos versiones se establecen en el cuadro de diálogo Propiedades del proyecto correspondiente al proyecto de Android en la pestaña Manifiesto de Android). En Visual Studio para Mac, se establecen en el cuadro de diálogo Opciones del proyecto correspondiente al proyecto de Android, en la pestaña Aplicación de Android).

    Al compilar en Android 9.0, Xamarin.Essentials instala la versión 28.0.0.3 de las bibliotecas de Xamarin.Android.Support que necesita. Las demás bibliotecas de Xamarin.Android.Support que requiere la aplicación también se deben actualizar a la versión 28.0.0.3 con el administrador de paquetes NuGet. Todas las bibliotecas de Xamarin.Android.Support que la aplicación usa deben ser iguales y la versión debe ser al menos 28.0.0.3. Consulte la página de solución de problemas si no puede agregar el paquete NuGet de Xamarin.Essentials ni actualizar los paquetes NuGet de la solución.

    A partir de la versión 1.5.0, al compilar en Android 10.0, Xamarin.Essentials instala las bibliotecas de compatibilidad de AndroidX que necesita. Lea la documentación de AndroidX si aún no ha realizado la transición.

    En el elemento MainLauncher del proyecto de Android o cualquier Activity que se inicie, Xamarin.Essentials se debe inicializar en el método OnCreate:

    protected override void OnCreate(Bundle savedInstanceState) {
        //...
        base.OnCreate(savedInstanceState);
        Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
        //...
    

    Para controlar los permisos en tiempo de ejecución de Android, Xamarin.Essentials debe recibir cualquier OnRequestPermissionsResult. Agregue el código siguiente a todas las clases Activity:

    public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
    {
        Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    
        base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    }
    
  6. Siga las guías de Xamarin.Essentials para poder copiar y pegar fragmentos de código para cada característica.

Xamarin.Essentials: API multiplataforma para aplicaciones móviles (vídeo).

Otros recursos

Es recomendable que los desarrolladores que trabajan por primera vez con Xamarin visiten Introducción al desarrollo de Xamarin.

Visite el repositorio GitHub de Xamarin.Essentials para ver el código fuente actual, descubrir qué viene más adelante, ejecutar ejemplos y clonar el repositorio. Estaremos encantados de recibir cualquier colaboración de la comunidad.

Examine la documentación de la API para conocer cada característica de Xamarin.Essentials.