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 a tu app cuando se ejecuta en dispositivos con Android 10.

Para comenzar, te recomendamos que revises los cambios en el comportamiento del sistema, los cambios en la privacidad y las nuevas funciones y APIs, y que luego migres tus apps en estas dos fases:

  1. Garantiza la compatibilidad básica. Asegúrate lo antes posible de que tu app publicada existente esté lista para los usuarios que actualicen sus dispositivos o compren dispositivos nuevos que ejecuten Android 10. Prueba tu app para verificar que sea completamente funcional y, luego, publica la versión compatible para los usuarios.
  2. Compila 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 el targetSdkVersion de tu app y compílala con las nuevas APIs que sean relevantes para ella.

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

Etapa 1: Compatibilidad básica

El objetivo de esta fase es identificar cualquier regresión de funcionalidad o cualquier otro impacto cuando tu app se ejecute en Android 10, para luego abordarlos y publicar una versión actualizada para los usuarios. En muchos casos, no deberías necesitar cambiar el atributo targetSdkVersion de tu app ni usar APIs nuevas, aunque, de manera opcional, puedes cambiar el atributo compileSdkVersion para admitir la compatibilidad.

Es importante que pruebes las funciones de tu app existente en todos los flujos, ya que algunos cambios de 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 brindarles a tus usuarios una transición sin problemas 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 tu app. Este es un buen momento para revisar los lineamientos de calidad de la app principal y las prácticas recomendadas para 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 cambiaste tu targetSdkVersion. Revisar los cambios con anticipación te ayudará a identificar las posibles áreas de impacto y depurar cualquier problema con mayor rapidez.

Android 10 incluye cambios extensos en la privacidad, por lo que también debes revisar los cambios clave en la privacidad y comprender los posibles impactos en tu app.

Etapa 2: Compila con Android 10

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

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

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

Obtén el SDK

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

Realiza pruebas

Una vez que hayas completado los preparativos descritos anteriormente, podrás 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 el 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 Cambios en el comportamiento de Android 10, pueden afectar significativamente el comportamiento de tu app o provocar fallas, incluso si aún no usas las nuevas APIs.