Cómo migrar tus apps a Android 10

¡Te damos la bienvenida! Android 10 tiene muchas APIs nuevas para compilar experiencias nuevas, además de 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 de comportamiento del sistema, los cambios de privacidad y las funciones y APIs nuevas, y luego migres tus apps en estas dos fases:

  1. Garantiza la compatibilidad básica. En cuanto sea posible, asegúrate de que tu app existente publicada 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. Compila funciones y APIs de Android 10. A continuación, explora las nuevas funciones y APIs en Android 10. Configura tu entorno de desarrollo, cambia el targetSdkVersion de tu app y compila con las nuevas APIs que sean relevantes para ella.

En las siguientes secciones, se destaca lo que debes hacer en cada una de estas fases. Antes de comenzar, asegúrate de preparar 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 regresiones de funcionalidad o algún otro impacto cuando tu app se ejecuta en Android 10. Luego, abordarlas y publicar una versión actualizada para los usuarios. En muchos casos, no deberías necesitar cambiar el targetSdkVersion de tu app o usar nuevas APIs, aunque, de manera opcional, puedes cambiar tu compileSdkVersion para admitir la compatibilidad.

Es importante probar la funcionalidad de la app existente en todos los flujos, ya que algunos cambios en la plataforma pueden afectar el comportamiento de la 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 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 se aplicarán a tu app, incluso si no cambiaste tu targetSdkVersion. Revisar los cambios con anticipación te ayudará a identificar posibles áreas de impacto y a depurar cualquier problema más rápidamente.

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 esté 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 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 orientes a Android 10 (nivel de API 29) o versiones posteriores.

Algunos cambios de comportamiento pueden causar regresiones o fallas, así que asegúrate de revisar los cambios y realizar una prueba exhaustiva 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. Si deseas obtener más información, consulta Cómo configurar el SDK.

Realiza pruebas

Una vez completados los preparativos descritos anteriormente, puedes compilar tu app y, luego, probarla más 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 la targetSdkVersion configurada como 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 aún no usas APIs nuevas).