Android 10 con XamarinAndroid 10 with Xamarin

Cómo empezar a desarrollar aplicaciones para Android 10 con Xamarin. Android.How to get started developing apps for Android 10 using Xamarin.Android.

Android 10 ahora está disponible en Google.Android 10 is now available from Google. Una serie de nuevas características y API están disponibles en esta versión, y muchas de ellas son necesarias para aprovechar las nuevas capacidades de hardware de los dispositivos Android más recientes.A number of new features and APIs are being made available in this release, and many of them are necessary to take advantage of new hardware capabilities in the latest Android devices.

Logotipo de Android 10

Este artículo está estructurado para ayudarle a empezar a desarrollar aplicaciones de Xamarin. Android para Android 10.This article is structured to help you get started in developing Xamarin.Android apps for Android 10. Explica cómo instalar las actualizaciones necesarias, configurar el SDK y preparar un emulador o un dispositivo para realizar pruebas.It explains how to install the necessary updates, configure the SDK, and prepare an emulator or device for testing. También proporciona un esquema de las nuevas características de Android 10 y proporciona código fuente de ejemplo que muestra cómo usar algunas de las características clave de Android 10.It also provides an outline of the new features in Android 10 and provides example source code that illustrates how to use some of the key Android 10 features.

Xamarin. Android 10,0 proporciona compatibilidad con Android 10.Xamarin.Android 10.0 provides support for Android 10. Para obtener más información sobre la compatibilidad de Xamarin. Android para Android 10, consulte las notas de la versión de Xamarin. android 10,0.For more information about Xamarin.Android support for Android 10, see the Xamarin.Android 10.0 release notes.

RequisitosRequirements

La lista siguiente es necesaria para usar características de Android 10 en aplicaciones basadas en Xamarin:The following list is required to use Android 10 features in Xamarin-based apps:

  • Visual Studio : se recomienda visual Studio 2019.Visual Studio - Visual Studio 2019 is recommended. En Windows Update a Visual Studio 2019, versión 16,3 o posterior.On Windows update to Visual Studio 2019 version 16.3 or later. En macOS, actualice a Visual Studio 2019 para Mac versión 8,3 o posterior.On macOS, update to Visual Studio 2019 for Mac version 8.3 or later.
  • Xamarin. Android : Xamarin. Android 10,0 o posterior debe instalarse con Visual Studio (Xamarin. Android se instala automáticamente como parte de la carga de trabajo desarrollo para dispositivos móviles con .net en Windows y se instala como parte del instalador de Visual Studio para Mac).Xamarin.Android - Xamarin.Android 10.0 or later must be installed with Visual Studio (Xamarin.Android is automatically installed as part of the Mobile Development With .NET workload on Windows and installed as part of the Visual Studio for Mac Installer)
  • Kit para desarrolladores de Java : el desarrollo de Xamarin. Android 10,0 requiere JDK 8.Java Developer Kit - Xamarin.Android 10.0 development requires JDK 8. La distribución de Microsoft de OpenJDK se instala automáticamente como parte de Visual Studio.Microsoft's distribution of the OpenJDK is automatically installed as part of Visual Studio.
  • Android SDK -Android SDK API 29 debe instalarse a través del administrador de Android SDK.Android SDK - Android SDK API 29 must be installed via the Android SDK Manager.

Primeros pasosGet started

Para empezar a desarrollar aplicaciones de Android 10 con Xamarin. Android, debe descargar e instalar las herramientas y los paquetes de SDK más recientes antes de poder crear su primer proyecto de Android 10:To get started developing Android 10 apps with Xamarin.Android, you must download and install the latest tools and SDK packages before you can create your first Android 10 project:

  1. Se recomienda Visual Studio 2019.Visual Studio 2019 is recommended. Actualice a Visual Studio 2019 versión 16,3 o posterior.Update to Visual Studio 2019 version 16.3 or later. Si usa Visual Studio para Mac 2019, actualice a Visual Studio 2019 para Mac versión 8,3 o posterior.If you are using Visual Studio for Mac 2019, update to Visual Studio 2019 for Mac version 8.3 or later.
  2. Instale paquetes y herramientas de Android 10 (API 29) mediante el administrador de SDK.Install Android 10 (API 29) packages and tools via the SDK Manager.
    • Plataforma del SDK de Android 10 (API 29)Android 10 (API 29) SDK Platform
    • Imagen del sistema Android 10 (API 29)Android 10 (API 29) System Image
    • Android SDK build-tools 29.0.0 +Android SDK Build-Tools 29.0.0+
    • Android SDK Platform-Tools 29.0.0 +Android SDK Platform-Tools 29.0.0+
    • Android Emulator 29.0.0 +Android Emulator 29.0.0+
  3. Cree un nuevo proyecto de Xamarin. Android que tenga como destino Android 10,0.Create a new Xamarin.Android project that targets Android 10.0.
  4. Configurar un emulador o un dispositivo para probar aplicaciones de Android 10.Configure an emulator or device for testing Android 10 apps.

A continuación se explica cada uno de estos pasos:Each of these steps is explained below:

Actualizar Visual StudioUpdate Visual Studio

Se recomienda Visual Studio 2019 para compilar aplicaciones de Android 10 con Xamarin.Visual Studio 2019 is recommended for building Android 10 apps using Xamarin.

Si usa Visual Studio 2019, actualice a Visual Studio 2019 versión 16,3 o posterior (para obtener instrucciones, consulte actualización de Visual studio 2019 a la versión más reciente).If you are using Visual Studio 2019, update to Visual Studio 2019 version 16.3 or later (for instructions, see Update Visual Studio 2019 to the most recent release). En macOS, actualice a Visual Studio 2019 para Mac 8,3 o posterior (para obtener instrucciones, vea Actualizar Visual Studio 2019 para Mac a la versión más reciente).On macOS, update to Visual Studio 2019 for Mac 8.3 or later (for instructions, see Update Visual Studio 2019 for Mac to the most recent release).

Instalar el Android SDKInstall the Android SDK

Para crear un proyecto con Xamarin. Android 10,0, primero debe usar el administrador de Android SDK para instalar la plataforma SDK para Android 10 (nivel de API 29) .To create a project with Xamarin.Android 10.0, you must first use the Android SDK Manager to install the SDK platform for Android 10 (API level 29).

  1. Inicie el administrador de SDK.Start the SDK Manager. En Visual Studio, haga clic en herramientas > Android > Android SDK Manager.In Visual Studio, click Tools > Android > Android SDK Manager. En Visual Studio para Mac, haga clic en herramientas > administrador de SDK.In Visual Studio for Mac, click Tools > SDK Manager.

  2. En la esquina inferior derecha, haga clic en el icono de engranaje y seleccione repositorio > Google (no compatible):In the lower right-hand corner, click the gear icon and select Repository > Google (Unsupported):

    Selección del repositorio de Android SDK Manager

  3. Instale los paquetes de la plataforma del SDK de Android 10 , que se muestran como Android SDK plataforma 29 en la pestaña plataformas (para obtener más información acerca del uso del administrador de SDK, consulte Android SDK Setup):Install the Android 10 SDK Platform packages, which are listed as Android SDK Platform 29 in the Platforms tab (for more information about using the SDK Manager, see Android SDK setup):

    Pestaña plataforma de Android SDK Manager

Creación de un proyecto de Xamarin. AndroidCreate a Xamarin.Android project

Cree un nuevo proyecto de Xamarin. Android.Create a new Xamarin.Android project. Si no está familiarizado con el desarrollo de Android con Xamarin, consulte Hello, Android para obtener información sobre la creación de proyectos de Xamarin. Android.If you are new to Android development with Xamarin, see Hello, Android to learn about creating Xamarin.Android projects.

Al crear un proyecto de Android, debe configurar las opciones de versión para que tengan como destino Android 10,0 o posterior.When you create an Android project, you must configure the version settings to target Android 10.0 or later. Por ejemplo, para tener como destino el proyecto para Android 10, debe configurar el nivel de API de Android de destino de su proyecto en android 10,0 (API 29) .For example, to target your project for Android 10, you must configure the target Android API level of your project to Android 10.0 (API 29). Esto incluye la versión de .NET Framework de destino y la versión de Android SDK de destino a la API 29 o posterior.This includes both your Target Framework Version and Target Android SDK Version to API 29 or later. Para obtener más información sobre la configuración de los niveles de la API de Android, consulte Descripción de los niveles de API de Android.For more information about configuring Android API levels, see Understanding Android API Levels.

Plataforma de destino de Xamarin. Android

Configurar un dispositivo o emuladorConfigure a device or emulator

Si usa un dispositivo físico, como un píxel, puede descargar la actualización de Android 10. para ello, vaya a la System > System update > Check for update en la configuración del teléfono.If you are using a physical device such as a Pixel, you can download the Android 10 update by going to the System > System update > Check for update in your phone's settings. Si prefiere que el dispositivo parpadee, consulte las instrucciones sobre la intermitencia de una imagen de fábrica o una imagen de OTA en el dispositivo.If you'd prefer to flash your device, please see the instructions on flashing a Factory Image or OTA Image to your device.

Si usa un emulador, cree un dispositivo virtual para el nivel de API 29 y seleccione una imagen basada en x86.If you are using an emulator, create a virtual device for API level 29 and select an x86-based image. Para obtener información sobre el uso de la Android Device Manager para crear y administrar dispositivos virtuales, consulte Administración de dispositivos virtuales con la Android Device Manager.For information about using the Android Device Manager to create and manage virtual devices, see Managing Virtual Devices with the Android Device Manager. Para obtener información acerca del uso del Android Emulator para probar y depurar, consulte depuración en el Android Emulator.For information about using the Android Emulator for testing and debugging, see Debugging on the Android Emulator.

Características nuevasNew features

Android 10 presenta una variedad de características nuevas.Android 10 introduces a variety of new features. Algunas de estas nuevas características están pensadas para aprovechar las nuevas capacidades de hardware que ofrecen los dispositivos Android más recientes, mientras que otras están diseñadas para mejorar aún más la experiencia del usuario de Android:Some of these new features are intended to leverage new hardware capabilities offered by the latest Android devices, while others are designed to further enhance the Android user experience:

Mejore su aplicación con características y API de Android 10Enhance your app with Android 10 features and APIs

Después, cuando esté listo, profundice en Android 10 y obtenga información sobre las nuevas características y api que puede usar.Next, when you're ready, dive into Android 10 and learn about the new features and APIs that you can use. Estas son algunas de las características principales para empezar a trabajar con.Here are some of the top features to get started with.

Estas características se recomiendan para todas las aplicaciones:These features are recommend for every app:

  • Tema oscuro:  garantizar una experiencia coherente para los usuarios que habilitan el tema oscuro en todo el sistema agregando un tema oscuro o habilitando Force oscuro.Dark Theme: Ensure a consistent experience for users who enable system-wide dark theme by adding a Dark Theme or enabling Force Dark.

Tema oscuro

  • Admita la navegación mediante gestos  en su aplicación pasando de un lado a perímetro y asegurándose de que los gestos personalizados son complementarios a los movimientos de navegación del sistema.Support gestural navigation in your app by going edge-to-edge and making sure your custom gestures are complementary to the system navigation gestures.

Navegación por gestos

  • Optimize for foldables:  ofrecer experiencias de vanguardia a EDGE en los dispositivos innovadores actuales mediante la optimización de foldables.Optimize for foldables: Deliver seamless, edge-to-edge experiences on today’s innovative devices by optimizing for foldables.

Doblado

Se recomiendan estas características si es pertinente para su aplicación:These features are recommended if relevant for your app:

  • Notificaciones más interactivas:  si las notificaciones incluyen mensajes, habilite las respuestas y acciones sugeridas en las notificaciones para atraer a los usuarios y permitirles tomar medidas al instante.More interactive notifications: If your notifications include messages, enable suggested replies and actions in notifications to engage users and let them take action instantly.
  • Mejor biometría:  si usa la autenticación biométrica, desplácese a BiometricPrompt, la mejor manera de admitir la autenticación mediante huellas digitales en dispositivos modernos.Better biometrics: If you use biometric auth, move to BiometricPrompt, the preferred way to support fingerprint auth on modern devices.
  • Grabación enriquecida:  para admitir la grabación de subtítulos o juegos, habilitar la captura de reproducción de audio.Enriched recording: To support captioning or gameplay recording, enable audio playback capture. Es una excelente manera de llegar a más usuarios y hacer que la aplicación sea más accesible.It’s a great way to reach more users and make your app more accessible.
  • Códecs mejores:  para aplicaciones multimedia, pruebe  AV1 para streaming de vídeo y HDR10 + para obtener un vídeo de alto nivel dinámico.Better codecs: For media apps, try AV1 for video streaming and HDR10+ for high dynamic range video. Para la transmisión por secuencias de voz y música, puede usar la codificación Opus y, para los músicos, hay disponible una API MIDI nativa .For speech and music streaming, you can use Opus encoding, and for musicians, a native MIDI API is available.
  • Mejores API de red:  si la aplicación administra dispositivos IOT a través de Wi-Fi, pruebe las nuevas API de conexión de red para funciones como la configuración, descarga o impresión.Better networking APIs: If your app manages IoT devices over Wi-Fi, try the new network connection APIs for functions like configuring, downloading, or printing.

Estas son solo algunas de las muchas características y API nuevas de Android 10.These are just a few of the many new features and APIs in Android 10. Para verlos todos, visite el sitio de Android 10 para desarrolladores.To see them all, visit the Android 10 site for developers.

Cambios de comportamientoBehavior changes

Cuando la versión de Android de destino se establece en el nivel de API 29, hay varios cambios de plataforma que se ven afectados por el comportamiento de la aplicación, incluso si no está implementando las nuevas características descritas anteriormente.When the Target Android Version is set to API level 29, there are several platform changes that cann affect your app's behavior even if you are not implementing the new features described above. La lista siguiente es un breve resumen de estos cambios:The following list is a brief summary of these changes:

ResumenSummary

En este artículo se presentaron Android 10 y se explicó cómo instalar y configurar las herramientas y los paquetes más recientes para el desarrollo de Xamarin. Android con Android 10.This article introduced Android 10 and explained how to install and configure the latest tools and packages for Xamarin.Android development with Android 10. Proporciona información general sobre las características clave disponibles en Android 10.It provided an overview of the key features available in Android 10. Incluye vínculos a la documentación de la API y temas para desarrolladores de Android que le ayudarán a empezar a crear aplicaciones para Android 10.It included links to API documentation and Android Developer topics to help you get started in creating apps for Android 10. También se resaltan los cambios de comportamiento más importantes de Android 10 que pueden afectar a las aplicaciones existentes.It also highlighted the most important Android 10 behavior changes that could impact existing apps.