Android 8.0 (nivel de API 26) presenta cambios de comportamiento, así como nuevas funciones y APIs que puedes aprovechar en tus apps. En este documento, se proporciona una descripción general de los pasos para migrar tus apps a Android 8.0 en dos fases clave:
- Asegúrate de brindar compatibilidad con Android 8.0
Verifica que tu app funcione por completo en la nueva versión de la plataforma. En esta etapa, no usas APIs nuevas ni cambias el
targetSdkVersionde tu app, pero es posible que se requieran cambios menores. - Actualiza tu versión de destino y usa las funciones de Android 8.0
Cuando estés listo para aprovechar las nuevas funciones de la plataforma, actualiza tu
targetSdkVersiona 26, verifica que la app siga funcionando como se espera y, luego, comienza a usar las nuevas APIs.
Asegúrate de brindar compatibilidad con Android 8.0
El objetivo aquí es asegurarte de que tu app existente funcione tal como está en Android 8.0 (nivel de API 26). Debido a que algunos cambios de la plataforma podrían afectar el comportamiento de tu app,
es posible que debas realizar algunos ajustes, pero no es necesario que uses APIs nuevas ni
cambies tu targetSdkVersion.
Prepara un dispositivo con Android 8.0
- Si tienes un dispositivo compatible (Pixel, Pixel XL, Pixel C, Nexus 5X, Nexus 6P o Nexus Player), sigue las instrucciones para instalar la ROM en tu dispositivo.
- También puedes descargar la imagen del sistema de Android 8.0 para Android Emulator. Aparece en el SDK Manager, en Android 8.0, como Google APIs Intel x86 Atom System Image.
Nota: La imagen del sistema de Android 8.0 está disponible para su descarga desde Android Studio 3.0 y versiones posteriores. Para obtener más información, consulta la sección que aparece a continuación para obtener el SDK de Android 8.0.
Cómo realizar pruebas de compatibilidad
En general, las pruebas de compatibilidad con Android 8.0 (nivel de API 26) 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.
Sin embargo, hay otro aspecto que se debe tener en cuenta en las pruebas: Android 8.0 introduce cambios en la plataforma de Android que pueden afectar el comportamiento de tu app o interrumpir su funcionamiento por completo, incluso si no cambias tu targetSdkVersion. Por este motivo, es importante que revises los cambios clave de la tabla 1 y pruebes las correcciones que implementes para adaptarte a los cambios.
Tabla 1: Cambios clave que afectan a todas las apps que se ejecutan en dispositivos con Android 8.0
| Cambiar | Resumen | Más referencias |
|---|---|---|
| Actualizaciones de ubicación en segundo plano menos frecuentes | Si tu app recibe actualizaciones de ubicación de un servicio en segundo plano, las recibirá con menos frecuencia en Android 8.0 (nivel de API 26) en comparación con las versiones anteriores de Android. Específicamente, un servicio en segundo plano no puede recibir actualizaciones de ubicación más de unas pocas veces por hora. Sin embargo, mientras tu app está en primer plano, la frecuencia de las actualizaciones de ubicación no cambia. | Límites de ubicación en segundo plano |
Ya no es compatible un total de net.hostname |
Si se consulta la propiedad del sistema net.hostname, se produce un resultado nulo.
|
Ninguno |
Nueva excepción de send(DatagramPacket) |
El método send(DatagramPacket) arroja un SocketException si el método connect(InetAddress, int) ejecutado anteriormente falló.
|
Cambios de comportamiento: Conectividad de red y HTTP(S) |
NullPointerException adecuado de los métodos AbstractCollection |
AbstractCollection.removeAll(null) y AbstractCollection.retainAll(null) ahora siempre arrojan una NullPointerException. Anteriormente, no se arrojaba la NullPointerException cuando la colección estaba vacía.
Este cambio hace que el comportamiento sea coherente con la documentación.
|
Cambios de comportamiento: Manejo de colecciones |
NullPointerException adecuado de
Currency.getDisplayName(null) |
Si se llama a Currency.getDisplayName(null), se arroja un NullPointerException.
|
Cambios en el comportamiento: Configuración regional e internacionalización |
Para obtener una lista más extensa de los cambios de comportamiento en Android 8.0 (nivel de API 26), consulta también Cambios de comportamiento en Android 8.0.
Actualiza tu versión de destino y usa las funciones de Android 8.0
En esta sección, se explica cómo habilitar la compatibilidad total con Android 8.0 (nivel de API 26) actualizando tu targetSdkVersion a 26 y agregando las nuevas funciones disponibles en Android 8.0.
Además de ofrecerte nuevas APIs, Android 8.0 incluye algunos cambios de comportamiento cuando actualizas tu targetSdkVersion a 26. Debido a que algunos cambios de comportamiento podrían requerir cambios en el código para evitar fallas, primero debes revisar todos los cambios de comportamiento de las apps orientadas a Android 8.0 para comprender cómo podría verse afectada tu app cuando cambies el targetSdkVersion.
Nota: Los pasos descritos anteriormente para garantizar la compatibilidad de la plataforma son requisitos previos para orientar tu app a Android 8.0, así que asegúrate de completarlos primero.
Obtén el SDK de Android 8.0
Puedes obtener los paquetes del SDK para compilar tu app con Android 8.0 (nivel de API 26) usando la versión más reciente de Android Studio (se recomienda Android Studio 3.0 o una versión posterior). Android Studio 3.0 y versiones posteriores incluyen herramientas que te ayudan con las funciones de Android 8.0, como los íconos adaptables y las fuentes descargables. Si aún no necesitas esas funciones, puedes usar la versión estable de Android Studio 2.3.3 para compilar tu app con Android 8.0 y usar las nuevas APIs.
Para configurar cualquiera de las versiones de Android Studio, sigue estos pasos:
- Inicia Android Studio y abre el SDK Manager haciendo clic en Tools > SDK Manager.
- En la pestaña SDK Platforms, marca Show Package Details. En la versión preliminar de Android 8.0, verifica lo siguiente:
- Plataforma del SDK de Android 26
- Imagen del sistema Intel x86 Atom de las APIs de Google (solo se requiere para el emulador)
- Cambia a la pestaña herramientas del SDK y marca todos los elementos que tengan actualizaciones disponibles (haz clic en cada casilla de verificación que muestre un guion
). Esto debería incluir las versiones más recientes de los siguientes elementos obligatorios:
- Herramientas de compilación del SDK de Android 26.0.0
- Herramientas de la plataforma del SDK de Android 26.0.0
- Android Emulator 26.0.0
- Haz clic en OK para instalar todos los paquetes del SDK seleccionados.
Ya tienes todo listo para comenzar a compilar con Android 8.0.
Cómo actualizar la configuración de tu compilación
Actualiza compileSdkVersion, targetSdkVersion y la versión de la biblioteca de compatibilidad a las revisiones más recientes disponibles, por ejemplo:
android {
compileSdkVersion 26
defaultConfig {
targetSdkVersion 26
}
...
}
dependencies {
compile 'com.android.support:appcompat-v7:26.0.0'
}
// REQUIRED: Google's new Maven repo is required for the latest
// support library that is compatible with Android 8.0
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
Quita los receptores de transmisiones de tu archivo de manifiesto
Debido a que Android 8.0 (nivel de API 26) presenta nuevas limitaciones para los receptores de transmisiones, debes quitar los receptores de transmisiones que estén registrados para intents de transmisión implícitos. Si los dejas, no se dañará tu app durante el tiempo de compilación o de ejecución, pero no tendrán ningún efecto cuando la app se ejecute en Android 8.0.
Las transmisiones a las que solo tu app puede responder (los intents de transmisión explícitos y las transmisiones enviadas específicamente al nombre del paquete de tu app) siguen funcionando de la misma manera en Android 8.0.
Existen excepciones a esta nueva restricción. Para obtener una lista de las transmisiones implícitas que aún funcionan en las apps orientadas a Android 8.0, consulta Excepciones de transmisiones implícitas.
Prueba tu app para Android 8.0
Una vez que hayas completado los preparativos anteriores, podrás compilar tu app y, luego, probarla más para asegurarte de que funcione correctamente cuando se oriente a Android 8.0 (nivel de API 26). 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 26, hay cambios específicos en la plataforma que debes tener en cuenta. Algunos de estos cambios pueden afectar significativamente el comportamiento de tu app o incluso dañarla por completo, incluso si no implementas funciones nuevas en Android 8.0.
En la tabla 2, se proporciona una lista de estos cambios con vínculos para obtener más información.
Tabla 2: Son los cambios clave que afectan a las apps cuando targetSdkVersion se establece en 26.
| Cambiar | Resumen | Más referencias |
|---|---|---|
| Privacidad | Android 8.0 (nivel de API 26) no admite el uso de las propiedades del sistema net.dns1, net.dns2, net.dns3 ni net.dns4. | Cambios en el comportamiento: Privacidad |
| Se aplican segmentos de escritura y ejecución | En el caso de las bibliotecas nativas, Android 8.0 (nivel de API 26) aplica la regla de que los datos no deben ser ejecutables y el código no debe ser modificable. | Cambios en el comportamiento: Bibliotecas nativas |
| Validación de encabezados y secciones de ELF | El vinculador dinámico verifica más valores en el encabezado ELF y los encabezados de sección, y falla si no son válidos. | Cambios en el comportamiento: Bibliotecas nativas |
| Notificaciones | Las apps orientadas a la versión del SDK de Android 8.0 (nivel de API 26) deben implementar uno o más canales de notificaciones para publicar notificaciones para los usuarios. | Descripción general de la API: Notificaciones |
El método List.sort()
|
Es posible que las implementaciones de este método ya no llamen a Collections.sort(), o tu app arrojará una excepción debido al desbordamiento de pila.
|
Cambios en el comportamiento: Manejo de colecciones |
El método Collections.sort()
|
En las implementaciones de List, Collections.sort() ahora arroja una ConcurrentModificationException.
|
Cambios en el comportamiento: Manejo de colecciones |
Para obtener una lista más extensa de los cambios de comportamiento en Android 8.0 (nivel de API 26), consulta Cambios de comportamiento en Android 8.0.
Para explorar las nuevas funciones y APIs disponibles con Android 8.0 (nivel de API 26), consulta Funciones y APIs de Android 8.0.