Cómo migrar tus apps a Android 10

¡Te damos la bienvenida! Android 10 tiene muchas APIs nuevas para crear experiencias nuevas, así como comportamientos del sistema actualizados que pueden afectar tu app cuando se ejecuta en dispositivos con Android 10.

Para comenzar, te recomendamos revisar los cambios de comportamiento del sistema, los cambios de privacidad y las funciones y APIs nuevas, y, luego, migrar las apps en estas dos fases:

  1. Garantiza la compatibilidad básica. Tan pronto como sea posible, asegúrate de que tu app publicada actual esté lista para los usuarios que actualicen o compren dispositivos nuevos con Android 10. Prueba tu app para verificar que funcione correctamente y, luego, publica la versión compatible de la app para los usuarios.
  2. Cómo compilar con las funciones y las APIs de Android 10 A continuación, explora las nuevas funciones y APIs de Android 10. Configura tu entorno de desarrollo, cambia la targetSdkVersion de tu app y compila con las nuevas APIs que sean relevantes para tu app.

En las siguientes secciones, se resalta lo que debes hacer en cada una de estas fases. Antes de comenzar, asegúrate de haber preparado un dispositivo de hardware o emulador para ejecutar y probar tu app.

Etapa 1: Compatibilidad básica

El objetivo de esta fase es identificar regresiones de funcionalidad u otros impactos cuando tu app se ejecute en Android 10 y, luego, abordarlas y publicar una versión actualizada para los usuarios. En muchos casos, no deberías necesitar cambiar el targetSdkVersion de tu app ni usar APIs nuevas, aunque puedes cambiar opcionalmente tu compileSdkVersion para admitir la compatibilidad.

Es importante que pruebes la funcionalidad de tu app existente en todos los flujos, ya que algunos cambios en la plataforma pueden afectar el comportamiento de tu app. Cuando publiques la versión compatible de tu app, te recomendamos que notifiques a los usuarios sobre la compatibilidad con Android 10 en las notas de actualización.

Para que los usuarios tengan una transición fluida a Android 10, te recomendamos que publiques una versión compatible de tu app lo antes posible, idealmente antes de que los dispositivos comiencen a recibir actualizaciones de Android 10.

Realiza pruebas

Las pruebas de compatibilidad implican el mismo tipo de pruebas que realizas cuando te preparas para lanzar la app. Este es un buen momento para revisar los lineamientos de calidad principales de las apps y las prácticas recomendadas para las pruebas.

Asegúrate de familiarizarte con los cambios de comportamiento conocidos que pueden afectar a tu app. Estos cambios de comportamiento se aplicarán a tu app, incluso si no modificaste tu targetSdkVersion. Revisar los cambios con anticipación te ayudará a identificar posibles áreas de impacto y depurar cualquier problema con mayor rapidez.

Android 10 incluye cambios importantes en la privacidad, así que asegúrate de revisar los cambios clave de la privacidad y comprender los posibles impactos en tu app.

Etapa 2: Compila con Android 10

Cuando tengas todo listo, podrás explorar las nuevas funciones y APIs de Android 10, y mejorar tu app con experiencias nuevas. Para comenzar a desarrollar con las nuevas APIs, deberás configurar el SDK de Android 10 (nivel de API 29) en Android Studio y cambiar tu targetSdkVersion y compileSdkVersion a 29.

Cuando cambies tu targetSdkVersion, también deberás tener en cuenta los cambios de comportamiento del sistema que se aplican a tu app cuando te orientas a Android 10 (nivel de API 29) o versiones posteriores.

Algunos cambios de comportamiento pueden causar regresiones o fallas, así que asegúrate de revisarlos y realizar pruebas exhaustivas antes de publicar una actualización de la app que modifique tu targetSdkVersion.

Obtén el SDK

Para obtener los paquetes del SDK y compilar tu app con Android 10, primero asegúrate de estar usando la versión más reciente de Android Studio. Para obtener más información, lee Configura el SDK.

Realiza pruebas

Una vez completadas las preparaciones descritas anteriormente, puedes compilar tu app y, luego, probarla para asegurarte de que funcione correctamente cuando se oriente a Android 10. Este es otro buen momento para revisar los lineamientos de calidad de la app principal y las prácticas recomendadas para pruebas.

Cuando compilas tu app con targetSdkVersion establecido en 29, hay cambios específicos de la plataforma que debes tener en cuenta. Algunos de estos cambios, que se describen en la página de cambios de comportamiento de Android 10, pueden afectar significativamente el comportamiento de tu app o causar fallas, incluso si todavía no usas APIs nuevas.