Nivel de API: 18
Android 4.3 (JELLY_BEAN_MR2
)
es una actualización del lanzamiento de Jelly Bean que ofrece nuevas funciones para los usuarios
desarrolladores. En este documento, se brinda una introducción a las APIs nuevas más distinguidas.
Como desarrollador de apps, debes descargar la imagen del sistema de Android 4.3 y la plataforma de SDK desde SDK Manager, como lo antes posible. Si no tienes un dispositivo con Android 4.3 en el cual probar tu app, usa la imagen del sistema de Android 4.3 para probarla en el emulador de Android. Luego, compila tus apps con la plataforma Android 4.3 para comenzar a usar la las APIs más recientes.
Actualiza el nivel de tu API de destino
Para optimizar mejor tu app para dispositivos con Android 4.3, haz lo siguiente:
Debes configurar tu targetSdkVersion
como
"18"
, instálala en una imagen del sistema Android 4.3
probarlo y, luego, publicar
una actualización con este cambio.
Puedes usar APIs en Android 4.3 y, al mismo tiempo, admitir versiones anteriores. Para ello, agrega
condiciones a tu código que comprueben el nivel de API del sistema antes de la ejecución
APIs no compatibles con tu minSdkVersion
.
Para obtener más información sobre cómo mantener la compatibilidad con versiones anteriores, consulta Compatibilidad con versiones de plataforma diferentes.
En la biblioteca de compatibilidad de Android, también hay disponibles varias APIs que permiten implementar en versiones anteriores de la plataforma.
Para obtener más información sobre cómo funcionan los niveles de API, lee Qué es la API nivel?
Importantes cambios en los comportamientos
Si publicaste anteriormente una app para Android, ten en cuenta que esta podría verse afectada por los cambios en Android 4.3.
Si tu app usa intents implícitos, haz lo siguiente:
Es posible que tu app tenga un comportamiento incorrecto en un entorno de perfil restringido.
Es posible que los usuarios en un entorno de perfil restringido no puedan
tener disponibles todas las apps estándar de Android. Por ejemplo, un perfil restringido podría tener inhabilitados el navegador web y la app de la cámara. Por lo tanto, tu app no debe suponer qué apps están disponibles, ya que, si llamas a startActivity()
sin verificar si hay una app disponible para controlar el Intent
, es posible que tu app falle en un perfil restringido.
Cuando se usa un intent implícito, siempre debes verificar que una app esté disponible para controlar el intent llamando a resolveActivity()
o queryIntentActivities()
. Por ejemplo:
Kotlin
val intent = Intent(Intent.ACTION_SEND) ... if (intent.resolveActivity(packageManager) != null) { startActivity(intent) } else { Toast.makeText(context, R.string.app_not_available, Toast.LENGTH_LONG).show() }
Java
Intent intent = new Intent(Intent.ACTION_SEND); ... if (intent.resolveActivity(getPackageManager()) != null) { startActivity(intent); } else { Toast.makeText(context, R.string.app_not_available, Toast.LENGTH_LONG).show(); }
Si tu app depende de cuentas...
Es posible que tu app tenga un comportamiento incorrecto en un entorno de perfil restringido.
Los usuarios que pertenezcan a un entorno de perfil restringido no tienen acceso a las cuentas de usuario de forma predeterminada.
Si tu app depende de un Account
, es posible que falle o se comporte de manera inesperada cuando se use en un perfil restringido.
Si deseas evitar que los perfiles restringidos usen tu app por completo porque esta depende de información de la cuenta que es sensible, especifica el atributo android:requiredAccountType
en el elemento <application>
de tu manifiesto.
Si deseas permitir que los perfiles restringidos sigan usando tu app, aunque no puedan crear sus propias cuentas, puedes inhabilitar las funciones de la app que requieren una cuenta o permitir que los perfiles restringidos accedan a las cuentas que creó el usuario principal. Para obtener más información, consulta la siguiente sección sobre Cómo admitir cuentas en un perfil restringido.
Si tu app usa VideoView…
Es posible que el video parezca más pequeño en Android 4.3.
En versiones anteriores de Android, el widget VideoView
calculaba de forma incorrecta el valor "wrap_content"
para layout_height
y layout_width
como el mismo que "match_parent"
. Por lo tanto, si bien el uso de "wrap_content"
para el alto o el ancho puede haber proporcionado previamente el diseño de video deseado,
Si lo haces, podrías producir un video mucho más pequeño en Android 4.3 y versiones posteriores. Para solucionar el problema, reemplaza
"wrap_content"
con "match_parent"
y verifica que el video se muestre como se espera en
Android 4.3 y versiones anteriores.
Perfiles restringidos
En las tablets Android, los usuarios ahora pueden crear perfiles restringidos en función del usuario principal. Cuando los usuarios crean un perfil restringido, pueden habilitar restricciones, como las apps que están disponibles para el perfil. Un nuevo conjunto de API en Android 4.3 también te permite compilar configuración de restricciones para las apps que desarrollas. Por ejemplo, con las APIs nuevas, puedes les permiten a los usuarios controlar qué tipo de contenido está disponible en tu app cuando se ejecuta en un de perfil restringido.
La interfaz de usuario del sistema
Configuración de la app. Para que el usuario vea la configuración de restricciones de tu app,
Debes declarar las restricciones que proporciona tu app creando un BroadcastReceiver
que reciba el intent ACTION_GET_RESTRICTION_ENTRIES
. El sistema invoca este intent para consultar
todas las apps para conocer las restricciones disponibles y, luego, compila la IU para permitir que el usuario principal
administrar las restricciones de cada perfil restringido
En el método onReceive()
de
tu BroadcastReceiver
, debes crear un RestrictionEntry
para cada restricción que proporcione tu app. Cada RestrictionEntry
define un título de restricción, una descripción y uno de los
los siguientes tipos de datos:
TYPE_BOOLEAN
para una restricción que es verdadera o falsa.TYPE_CHOICE
para una restricción que tiene varias opciones mutuamente excluyentes (opciones de botones de selección).TYPE_MULTI_SELECT
para una restricción que tiene varias opciones que no son mutuamente excluyentes (opciones de casilla de verificación).
Luego, coloca todos los objetos RestrictionEntry
en un ArrayList
y colócalos en el resultado del receptor de emisión como el valor del objeto EXTRA_RESTRICTIONS_LIST
adicional.
El sistema crea la IU para las restricciones de tu app en la app de Configuración y guarda cada restricción con la clave única que proporcionaste para cada objeto RestrictionEntry
. Cuando el usuario abre tu app, puedes llamar a getApplicationRestrictions()
para consultar si hay restricciones actuales.
Esto muestra un Bundle
que contiene los pares clave-valor de cada restricción que definiste con los objetos RestrictionEntry
.
Si deseas proporcionar restricciones más específicas que no se puedan controlar con valores booleanos,
opciones y valores de opción múltiple, puedes crear una actividad en la que el usuario especifique
restricciones y permitir que los usuarios abran esa actividad desde la configuración de restricciones. En tu
receptor de emisión, incluye el EXTRA_RESTRICTIONS_INTENT
adicional
en el resultado Bundle
. Este extra debe especificar un Intent
que indique la clase Activity
que se iniciará (usa el método putParcelable()
para pasar EXTRA_RESTRICTIONS_INTENT
con el intent).
Cuando el usuario principal ingresa a tu actividad para establecer restricciones personalizadas, esta debe mostrar un resultado que contenga los valores de restricción en un elemento adicional con la clave EXTRA_RESTRICTIONS_LIST
o EXTRA_RESTRICTIONS_BUNDLE
, según si especificas objetos RestrictionEntry
o pares clave-valor, respectivamente.
Cuentas compatibles con un perfil restringido
Todas las cuentas que se agreguen al usuario principal estarán disponibles para un perfil restringido, pero no se podrá acceder a ellas desde las APIs de AccountManager
de forma predeterminada.
Si intentas agregar una cuenta con AccountManager
mientras te encuentras en una zona restringida
obtendrás un resultado de error. Debido a estas restricciones, tienes lo siguiente:
tres opciones:
Para acceder a una cuenta desde un perfil restringido, debes agregar el atributo android:restrictedAccountType
a la etiqueta <application>:
<application ... android:restrictedAccountType="com.example.account.type" >
Precaución: Habilitar este atributo proporciona la acceso de la app a las cuentas del usuario principal desde perfiles restringidos. Por lo tanto, debes permitir esto solo si la información que muestra tu app no revela información de identificación personal (PII) que se considere sensible. La configuración del sistema informará al usuario usuario que tu app otorga perfiles restringidos a sus cuentas, por lo que debe quedar claro que el acceso a la cuenta es importante para la funcionalidad de tu app. Si es posible, también debes proporcionar controles de restricción adecuados para el usuario principal que definan cuánto acceso a la cuenta se permite en tu app.
Si quieres usar cuentas, pero en realidad no las necesitas para la cuenta principal de tu app
puedes comprobar la disponibilidad de la cuenta e inhabilitar funciones cuando no estén disponibles.
Primero, debes verificar si hay una cuenta existente disponible. Si no es así, consulta si
Puedes crear una cuenta nueva si llamas a getUserRestrictions()
y verificas el DISALLOW_MODIFY_ACCOUNTS
adicional en el resultado. Si es true
, debes inhabilitar cualquier funcionalidad de tu app que requiera acceso a las cuentas.
Por ejemplo:
Kotlin
val um = context.getSystemService(Context.USER_SERVICE) as UserManager val restrictions: Bundle = um.userRestrictions if (restrictions.getBoolean(UserManager.DISALLOW_MODIFY_ACCOUNTS, false)) { // cannot add accounts, disable some functionality }
Java
UserManager um = (UserManager) context.getSystemService(Context.USER_SERVICE); Bundle restrictions = um.getUserRestrictions(); if (restrictions.getBoolean(UserManager.DISALLOW_MODIFY_ACCOUNTS, false)) { // cannot add accounts, disable some functionality }
Nota: En este caso, no debes declarar cualquier atributo nuevo en tu archivo de manifiesto.
Si, en cambio, es importante que tu app no esté disponible para perfiles restringidos porque depende de información personal sensible en una cuenta (y porque los perfiles restringidos actualmente no pueden agregar cuentas nuevas), agrega el atributo android:requiredAccountType
a la etiqueta <application>:
<application ... android:requiredAccountType="com.example.account.type" >
Por ejemplo, la app de Gmail usa este atributo para inhabilitarse en los perfiles restringidos, porque el correo electrónico personal del propietario no debería estar disponible para perfiles restringidos.
Redes inalámbricas y conectividad
Bluetooth de bajo consumo (listo para dispositivos inteligentes)
Android ahora admite Bluetooth de bajo consumo (LE) con las nuevas APIs en android.bluetooth
.
Con las nuevas API, podrás crear apps para Android que se comuniquen con Bluetooth de bajo consumo
periféricos, como monitores de frecuencia cardíaca y podómetros.
Debido a que Bluetooth LE es una función de hardware que no está disponible en todos los
En los dispositivos con Android, debes declarar en tu archivo de manifiesto un <uses-feature>
elemento para "android.hardware.bluetooth_le"
:
<uses-feature android:name="android.hardware.bluetooth_le" android:required="true" />
Si ya conoces las APIs de Bluetooth clásico de Android, puedes observar que
Las APIs de Bluetooth LE tienen algunas diferencias. Lo más importante es que ahora hay una clase BluetoothManager
que debes usar para algunas operaciones de alto nivel, como adquirir un BluetoothAdapter
, obtener una lista de dispositivos conectados y verificar el estado de un dispositivo. Por ejemplo, así es como deberías obtener la
BluetoothAdapter
Kotlin
val bluetoothManager = getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager bluetoothAdapter = bluetoothManager.adapter
Java
final BluetoothManager bluetoothManager = (BluetoothManager) getSystemService(Context.BLUETOOTH_SERVICE); bluetoothAdapter = bluetoothManager.getAdapter();
Para descubrir periféricos Bluetooth LE, llama a startLeScan()
en el BluetoothAdapter
y pásale una implementación
de la interfaz BluetoothAdapter.LeScanCallback
. Cuando se active el
detecta un periférico Bluetooth LE, tu implementación de BluetoothAdapter.LeScanCallback
recibe una llamada al
onLeScan()
. Este método te proporciona un objeto BluetoothDevice
que representa el dispositivo detectado, el valor de RSSI del dispositivo y un array de bytes que contiene el registro de anuncio del dispositivo.
Si deseas buscar solo tipos específicos de periféricos, puedes llamar a startLeScan()
e incluir un array de objetos UUID
que especifiquen los servicios GATT que admite tu app.
Nota: Solo puedes buscar dispositivos Bluetooth LE o buscar dispositivos Bluetooth clásicos con APIs anteriores No se pueden escanear tanto la versión LE como la clásica dispositivos Bluetooth a la vez.
Luego, para conectarte a un periférico Bluetooth LE, llama a connectGatt()
en el objeto BluetoothDevice
correspondiente y pásale una implementación de BluetoothGattCallback
. Tu implementación de BluetoothGattCallback
recibe devoluciones de llamada sobre el estado de conectividad con el dispositivo y otros eventos. Es durante la devolución de llamada onConnectionStateChange()
que puedes comenzar a comunicarte con el dispositivo si el método pasa STATE_CONNECTED
como el estado nuevo.
Para acceder a las funciones de Bluetooth en un dispositivo, también es necesario que tu app solicite ciertos Permisos del usuario de Bluetooth Para obtener más información, consulta la guía de la API de Bluetooth de bajo consumo.
Modo de solo búsqueda de Wi-Fi
Al intentar identificar la ubicación del usuario, Android puede usar Wi-Fi para ayudar a determinar la ubicación escaneando los puntos de acceso cercanos. Sin embargo, los usuarios suelen mantener el Wi-Fi desactivado para ahorran batería, lo que genera datos de ubicación menos precisos. Android ahora incluye modo de solo búsqueda que permite que el Wi-Fi del dispositivo busque puntos de acceso para ayudar a obtener la ubicación sin conectarse a un punto de acceso, lo que reduce en gran medida el uso de la batería.
Si deseas adquirir la ubicación del usuario, pero la conexión Wi-Fi está desactivada, puedes solicitarle que habilite el modo de solo búsqueda de Wi-Fi llamando a startActivity()
con la acción ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE
.
Configuración de Wi-Fi
Las nuevas APIs de WifiEnterpriseConfig
permiten que los servicios orientados a empresas puedan
automatizar la configuración de Wi-Fi para dispositivos administrados.
Respuesta rápida para llamadas entrantes
Desde Android 4.0, una función llamada "Respuesta rápida" permite a los usuarios responder llamadas entrantes con un mensaje de texto inmediato sin necesidad de contestar la llamada ni desbloquear el dispositivo.
Hasta ahora, la app de Mensajes predeterminada siempre controlaba estos mensajes rápidos. Ahora, cualquier app puede declarar su capacidad para controlar estos mensajes creando un Service
con un filtro de intents para ACTION_RESPOND_VIA_MESSAGE
.
Cuando el usuario responde una llamada entrante con una respuesta rápida, la app de Teléfono envía el intent ACTION_RESPOND_VIA_MESSAGE
con un URI que describe al destinatario (la persona que llama) y el elemento adicional EXTRA_TEXT
con el mensaje que el usuario quiere enviar. Cuando tu servicio recibe el intent, debe entregar
el mensaje y se detiene de inmediato (tu app no debería mostrar una actividad).
Para recibir este intent, debes declarar el permiso SEND_RESPOND_VIA_MESSAGE
.
Multimedia
Mejoras de MediaExtractor y MediaCodec
Android ahora te permite escribir tu propio diseño de Dynamic Adaptive
a través de reproductores HTTP (DASH) de acuerdo con el estándar ISO/IEC 23009-1,
con las APIs existentes en MediaCodec
y MediaExtractor
. El framework subyacente a estas APIs se actualizó para admitir el análisis de archivos MP4 fragmentados, pero tu app sigue siendo responsable de analizar los metadatos de MPD y pasar las transmisiones individuales a MediaExtractor
.
Si deseas usar DASH con contenido encriptado, ten en cuenta que el método getSampleCryptoInfo()
muestra los metadatos MediaCodec.CryptoInfo
que describen la estructura de cada muestra de contenido multimedia encriptado. Además, se agregó el método getPsshInfo()
a MediaExtractor
para que puedas acceder a los metadatos PSSH de tus medios DASH.
Este método muestra un mapa de objetos UUID
a bytes, con el
UUID
, que especifica el esquema criptográfico, y los bytes que corresponden a los datos específicos
a ese esquema.
DRM de contenido multimedia
La nueva clase MediaDrm
proporciona una solución modular para los derechos digitales.
administración de contenido multimedia (DRM) con el contenido multimedia. Para ello, separa las cuestiones de DRM de la reproducción de contenido multimedia. Para
Esta separación de API te permite reproducir contenido encriptado con Widevine sin tener
para usar el formato Widevine. Esta solución de DRM también admite la encriptación común de DASH, por lo que puedes usar una variedad de esquemas de DRM con tu contenido de transmisión.
Puedes usar MediaDrm
para obtener mensajes de solicitud de clave opacos y procesos
mensajes de clave-respuesta del servidor para la adquisición y el aprovisionamiento de licencias. Tu app es
responsable de manejar la comunicación de red con los servidores; La clase MediaDrm
solo proporciona la capacidad de generar y procesar los mensajes.
Las APIs de MediaDrm
están diseñadas para usarse junto con el
Las APIs de MediaCodec
que se introdujeron en Android 4.1 (nivel de API 16)
que incluye MediaCodec
para codificar y decodificar tu contenido, MediaCrypto
para manejar contenido encriptado y MediaExtractor
para extraer y demuxar tu contenido.
Primero, debes construir los objetos MediaExtractor
y MediaCodec
. Luego, puedes acceder al UUID
que identifica el esquema de DRM, por lo general, desde los metadatos del contenido, y usarlo para crear una instancia de un objeto MediaDrm
con su constructor.
Codificación de video desde una superficie
Android 4.1 (nivel de API 16) agregó la clase MediaCodec
para la codificación y decodificación de contenido multimedia de bajo nivel. Al codificar videos, Android 4.1 requería que proporcionaras
el contenido multimedia con un array ByteBuffer
, pero Android 4.3 ahora te permite usar un Surface
como entrada para un codificador. Por ejemplo, esto te permite codificar
a partir de un archivo de video existente o con fotogramas generados a partir de OpenGL ES.
Para usar un Surface
como entrada para tu codificador, primero llama a configure()
para tu MediaCodec
.
Luego, llama a createInputSurface()
para recibir el Surface
sobre el cual puedes transmitir tu contenido multimedia.
Por ejemplo, puedes usar el Surface
determinado como ventana para una ventana de OpenGL.
el contexto pasándolo a eglCreateWindowSurface()
. Luego, mientras renderizas la superficie, llama a eglSwapBuffers()
para pasar el marco a MediaCodec
.
Para comenzar a codificar, llama a start()
en MediaCodec
. Cuando termines, llama a signalEndOfInputStream()
para finalizar la codificación y llama a release()
en el
Surface
Combinación de contenido multimedia
La nueva clase MediaMuxer
permite la multiplexación entre una transmisión de audio y una de video. Estas APIs funcionan como contraparte de la clase MediaExtractor
que se agregó en Android 4.2 para demultiplexar contenido multimedia.
Los formatos de salida admitidos se definen en MediaMuxer.OutputFormat
. Actualmente,
MP4 es el único formato de salida que se admite y MediaMuxer
es compatible actualmente.
solo una reproducción de audio o una transmisión de video a la vez.
MediaMuxer
está diseñado principalmente para funcionar con MediaCodec
, de modo que puedas realizar el procesamiento de video a través de MediaCodec
y, luego, guardar el resultado en un archivo MP4 a través de MediaMuxer
. También puedes usar MediaMuxer
junto con MediaExtractor
para realizar
editar contenido multimedia sin codificar ni decodificar.
Progreso de la reproducción y arrastre de RemoteControlClient
En Android 4.0 (nivel de API 14), se agregó RemoteControlClient
a
Habilita los controles de reproducción multimedia desde clientes de control remoto, como los controles disponibles en la
pantalla de bloqueo. Android 4.3 ahora permite que esos controles muestren la reproducción
y los controles para arrastrar la reproducción. Si habilitaste el control remoto para tu
app de música con las APIs de RemoteControlClient
, puedes permitir la reproducción
depurar mediante la implementación de dos interfaces nuevas.
Primero, debes habilitar la marca FLAG_KEY_MEDIA_POSITION_UPDATE
pasándola a setTransportControlsFlags()
.
Luego, implementa las siguientes dos interfaces nuevas:
RemoteControlClient.OnGetPlaybackPositionListener
- Esto incluye la devolución de llamada
onGetPlaybackPosition()
, que solicita la posición actual. de tu contenido multimedia cuando el control remoto necesita actualizar el progreso en su IU. RemoteControlClient.OnPlaybackPositionUpdateListener
- Esto incluye la devolución de llamada
onPlaybackPositionUpdate()
, que le indica a tu app el nuevo código de tiempo de tu contenido multimedia cuando el usuario omite la reproducción con la IU del control remoto.Una vez que actualices la reproducción con la nueva posición, llama a
setPlaybackState()
para indicar el nuevo estado, la posición y la velocidad de reproducción.
Con estas interfaces definidas, puedes establecerlas para tu RemoteControlClient
llamando a setOnGetPlaybackPositionListener()
y
setPlaybackPositionUpdateListener()
, respectivamente.
Gráficos
Compatibilidad con OpenGL ES 3.0
Android 4.3 agrega interfaces Java y compatibilidad nativa con OpenGL ES 3.0. La nueva funcionalidad clave proporcionada en OpenGL ES 3.0 incluye lo siguiente:
- Aceleración de efectos visuales avanzados
- Compresión de texturas ETC2/EAC de alta calidad como función estándar
- Una nueva versión del lenguaje de sombreado GLSL ES compatible con números enteros y punto flotante de 32 bits.
- Renderización avanzada de texturas
- Estandarización más amplia del tamaño de las texturas y los formatos de búfer de renderización
La interfaz Java para OpenGL ES 3.0 en Android se proporciona con GLES30
.
Cuando uses OpenGL ES 3.0, asegúrate de declararlo en tu archivo de manifiesto con la etiqueta <uses-feature> y el atributo android:glEsVersion
. Por ejemplo:
<manifest> <uses-feature android:glEsVersion="0x00030000" /> ... </manifest>
Además, recuerda especificar el contexto de OpenGL ES llamando a setEGLContextClientVersion()
y pasando 3
como la versión.
Para obtener más información sobre el uso de OpenGL ES, incluida la manera de comprobar la versión de OpenGL ES que admite el dispositivo durante el tiempo de ejecución, consulta la guía de la API de OpenGL ES.
Asignación de mip para elementos de diseño
Usar un mapa de bits como fuente de tu mapa de bits o elemento de diseño es una forma sencilla de proporcionar una imagen de calidad y varias escalas de imagen, lo que puede ser particularmente útil si esperas que tu imagen se escale durante una animación.
Android 4.2 (nivel de API 17) agregó compatibilidad con los mapas de bits de mosaico en la clase Bitmap
. Android intercambia las imágenes de mip en tu Bitmap
cuando proporcionas una fuente de mapa de bits de mosaico y habilitas setHasMipMap()
. Ahora, en Android 4.3, también puedes habilitar los mapas de bits para un objeto BitmapDrawable
. Para ello, proporciona un recurso de mapa de bits y configura el atributo android:mipMap
en un archivo de recursos de mapa de bits o llama a hasMipMap()
.
Interfaz de usuario
Superposición de objetos View
La nueva clase ViewOverlay
proporciona una capa transparente sobre
un elemento View
en el que puedes agregar contenido visual y que no afecta
la jerarquía de diseño. Puedes obtener un ViewOverlay
para cualquier View
llamando a getOverlay()
. La superposición siempre tiene el mismo tamaño y la misma posición que su vista host (la vista desde la que se creó), lo que te permite agregar contenido que aparece frente a la vista host, pero que no puede extender los límites de esa vista.
El uso de un ViewOverlay
es particularmente útil cuando quieres crear animaciones, como deslizar una vista fuera de su contenedor o mover elementos por la pantalla sin afectar la jerarquía de la vista. Sin embargo, como el área utilizable de una superposición se limita al mismo área que su vista host, si deseas animar una vista que se mueve fuera de su posición en el diseño, debes usar una superposición de una vista superior que tenga los límites de diseño deseados.
Cuando creas una superposición para una vista de widget, como un Button
, puedes llamar a add(Drawable)
para agregar objetos Drawable
a la superposición. Si llamas a getOverlay()
para una vista de diseño, como RelativeLayout
, el objeto que se muestra es un ViewGroupOverlay
. La clase ViewGroupOverlay
es una subclase de ViewOverlay
que también te permite agregar objetos View
llamando a add(View)
.
Nota: Todos los elementos de diseño y vistas que agregues a una superposición son solo visuales. No pueden recibir eventos de enfoque ni de entrada.
Por ejemplo, el siguiente código anima una vista que se desliza hacia la derecha colocando la vista en la superposición de la vista principal y, a continuación, realiza una animación de traducción en esa vista:
Kotlin
val view: View? = findViewById(R.id.view_to_remove) val container: ViewGroup? = view?.parent as ViewGroup container?.apply { overlay.add(view) ObjectAnimator.ofFloat(view, "translationX", right.toFloat()) .start() }
Java
View view = findViewById(R.id.view_to_remove); ViewGroup container = (ViewGroup) view.getParent(); container.getOverlay().add(view); ObjectAnimator anim = ObjectAnimator.ofFloat(view, "translationX", container.getRight()); anim.start();
Diseño de límites ópticos
Para las vistas que contienen imágenes de fondo nine-patch, ahora puedes especificar estar alineadas con las vistas vecinas según el modelo “óptico”, límites de la imagen de fondo en lugar que el “clip” límites de la vista.
Por ejemplo, las figuras 1 y 2 muestran el mismo diseño, pero la versión de la figura 1 usa límites de recorte (el comportamiento predeterminado), mientras que la figura 2 usa límites ópticos. Debido a que las imágenes de nueve parches que se usan para el botón y el marco de fotos incluyen padding alrededor de los bordes, no parecen alinearse entre sí ni con el texto cuando se usan límites de recorte.
Nota: La captura de pantalla de las figuras 1 y 2 tiene el mensaje "Mostrar límites de diseño" parámetro de configuración para desarrolladores habilitado. En cada vista, las líneas rojas indican los límites ópticos, las líneas azules indican los límites de recorte y el rosa indica los márgenes.

Figura 1: Diseño con límites de recorte (predeterminado)

Figura 2: El diseño usa límites ópticos.
Para alinear las vistas según sus límites ópticos, establece el atributo android:layoutMode
en "opticalBounds"
en uno de los diseños superiores. Por ejemplo:
<LinearLayout android:layoutMode="opticalBounds" ... >

Figura 3: Vista ampliada del nine-patch del botón Holo con límites ópticos
Para que esto funcione, las imágenes de nueve parches aplicadas al fondo de tus vistas deben especificar los límites ópticos con líneas rojas a lo largo de la parte inferior y derecha del archivo de nueve parches (como se muestra en la figura 3). Las líneas rojas indican la región que se debe restar de los límites de recorte y deja los límites ópticos de la imagen.
Cuando habilitas los límites ópticos para una ViewGroup
en tu diseño, todo
las vistas descendentes heredan el modo de diseño de límites ópticos, a menos que lo anules para un grupo por
estableciendo android:layoutMode
en "clipBounds"
Todos los elementos de diseño también respetan el
límites ópticos de sus vistas secundarias, adaptando sus propios límites en función de los límites ópticos de
las vistas en ellos. Sin embargo, los elementos de diseño (subclases de ViewGroup
)
actualmente no admiten los límites ópticos para imágenes nine-patch aplicados a su propio fondo.
Si creas una vista personalizada creando una subclase de View
, ViewGroup
o cualquiera de sus subclases, tu vista heredará estos comportamientos de límite óptico.
Nota: Se actualizaron todos los widgets compatibles con el tema Holo.
con límites ópticos, incluidos Button
, Spinner
,
EditText
y otras. Por lo tanto, puedes beneficiarte de inmediato configurando el atributo android:layoutMode
en "opticalBounds"
si tu app aplica un tema Holo (Theme.Holo
, Theme.Holo.Light
, etcétera).
Para especificar límites ópticos para tus propias imágenes nine-patch con la herramienta Draw 9-patch, mantén presionado Control cuando haciendo clic en los píxeles del borde.
Animación para valores de Rect
Ahora puedes animar entre dos valores de Rect
con el nuevo RectEvaluator
. Esta nueva clase es una implementación de TypeEvaluator
que puedes pasar a ValueAnimator.setEvaluator()
.
Objeto de escucha de aplicación y enfoque de ventanas
Anteriormente, si querías escuchar cuando tu vista se adjuntaba o desconectaba de la ventana o
cuando cambiaba su enfoque, debías anular la clase View
para
implementar onAttachedToWindow()
y onDetachedFromWindow()
o onWindowFocusChanged()
, respectivamente.
Ahora, para recibir eventos de conexión y desconexión, puedes implementar ViewTreeObserver.OnWindowAttachListener
y configurarlo en una vista con addOnWindowAttachListener()
.
Y para recibir eventos de enfoque, puedes implementar ViewTreeObserver.OnWindowFocusChangeListener
y configurarlo en una vista con
addOnWindowFocusChangeListener()
Compatibilidad con el sobreajuste de TV
Para asegurarte de que tu app ocupe toda la pantalla de todos los televisores, ahora puedes habilitar el sobrebarrido
para el diseño de tu aplicación. El modo de sobrebarrido se determina con la marca FLAG_LAYOUT_IN_OVERSCAN
, que puedes habilitar con temas de plataforma, como
Theme_DeviceDefault_NoActionBar_Overscan
o habilitando
Estilo windowOverscan
en un tema personalizado
Orientación de la pantalla
El atributo screenOrientation
de la etiqueta <activity>
ahora admite valores adicionales para respetar la preferencia del usuario por la rotación automática:
"userLandscape"
- Se comporta igual que
"sensorLandscape"
, excepto que, si el usuario inhabilita la rotación automática, se bloquea en la orientación horizontal normal y no se invierte. "userPortrait"
- Se comporta igual que
"sensorPortrait"
, excepto si el usuario inhabilita la opción de girar automáticamente. se traba en la orientación vertical normal y no se voltea. "fullUser"
- Se comporta de la misma manera que
"fullSensor"
y permite la rotación en las cuatro direcciones, excepto Si el usuario inhabilita la rotación automática, se bloquea en la orientación que prefiera el usuario.
Además, ahora también puedes declarar "locked"
para bloquear la orientación de tu app en la orientación actual de la pantalla.
Animaciones de rotación
El nuevo campo rotationAnimation
en WindowManager
te permite seleccionar una de las tres animaciones que deseas usar cuando el sistema cambia las orientaciones de la pantalla. Las tres animaciones son las siguientes:
Nota: Estas animaciones solo están disponibles si configuraste tu actividad para usar el modo "pantalla completa", que puedes habilitar con temas como Theme.Holo.NoActionBar.Fullscreen
.
Por ejemplo, a continuación se muestra cómo puedes habilitar la animación de "transposición":
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val params: WindowManager.LayoutParams = window.attributes params.rotationAnimation = WindowManager.LayoutParams.ROTATION_ANIMATION_CROSSFADE window.attributes = params ... }
Java
protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); WindowManager.LayoutParams params = getWindow().getAttributes(); params.rotationAnimation = WindowManager.LayoutParams.ROTATION_ANIMATION_CROSSFADE; getWindow().setAttributes(params); ... }
Entrada del usuario
Tipos de sensores nuevos
El nuevo sensor TYPE_GAME_ROTATION_VECTOR
te permite detectar las rotaciones del dispositivo sin preocuparte por las interferencias magnéticas. A diferencia del sensor TYPE_ROTATION_VECTOR
, TYPE_GAME_ROTATION_VECTOR
no se basa en el norte magnético.
Los nuevos sensores TYPE_GYROSCOPE_UNCALIBRATED
y TYPE_MAGNETIC_FIELD_UNCALIBRATED
proporcionan datos de sensores sin procesar
para las estimaciones de sesgo. Es decir, los valores existentes de TYPE_GYROSCOPE
y TYPE_MAGNETIC_FIELD
los sensores proporcionan datos de sensores que tienen en cuenta el sesgo estimado del giro a la deriva y el hierro duro
del dispositivo, respectivamente. Mientras que las nuevas versiones "no calibradas" de estos sensores proporcionan los datos sin procesar del sensor y ofrecen los valores de sesgo estimados por separado. Estos sensores te permiten proporcionar tu propia calibración personalizada para los datos del sensor, ya que mejoran el sesgo estimado con datos externos.
Notificaciones del objeto de escucha
Android 4.3 agrega una nueva clase de servicio, NotificationListenerService
, que permite que tu app reciba información sobre notificaciones nuevas a medida que el sistema las publica.
Si tu app actualmente usa las APIs de servicios de accesibilidad para acceder a las notificaciones del sistema, debes actualizarla para que use estas APIs.
Proveedor de contactos
Consulta sobre “contactos”
La nueva consulta del proveedor de contactos, Contactables.CONTENT_URI
, proporciona una manera eficiente de obtener un Cursor
que contiene todas las direcciones de correo electrónico y los números de teléfono de todos los contactos que coinciden con la búsqueda especificada.
Cómo consultar deltas de contactos
Se agregaron nuevas APIs al proveedor de contactos que te permiten consultar de forma eficiente los cambios recientes en los datos de contactos. Anteriormente, tu app podía recibir una notificación cuando cambiaba algo en los datos de los contactos, pero no sabías exactamente qué había cambiado y debías recuperar todos los contactos y, luego, iterar por ellos para descubrir el cambio.
Para hacer un seguimiento de los cambios en las inserciones y las actualizaciones, ahora puedes incluir el parámetro CONTACT_LAST_UPDATED_TIMESTAMP
con tu selección para consultar solo los contactos que cambiaron desde la última vez que consultaste al proveedor.
Para realizar un seguimiento de los contactos que se eliminaron, la nueva tabla ContactsContract.DeletedContacts
proporciona un registro de los contactos que se eliminaron (pero cada contacto borrado se conserva en esta tabla por un tiempo limitado). Al igual que con CONTACT_LAST_UPDATED_TIMESTAMP
, puedes usar el nuevo parámetro de selección, CONTACT_DELETED_TIMESTAMP
, para verificar qué contactos se borraron desde la última vez que consultaste al proveedor. La tabla también contiene la constante DAYS_KEPT_MILLISECONDS
, que incluye la cantidad de días (en milisegundos) que se conservará el registro.
Además, el proveedor de contactos ahora transmite la acción CONTACTS_DATABASE_CREATED
cuando el usuario
borra el almacenamiento de contactos a través del menú de configuración del sistema, lo que recrea efectivamente la
Base de datos del proveedor de contactos. Su objetivo es indicar a las apps que deben descartar toda la información de contacto que almacenaron y volver a cargarla con una consulta nueva.
Para obtener un código de muestra que use estas APIs para verificar si hay cambios en los contactos, consulta la muestra de ApiDemos disponible en la descarga de Muestras de SDK.
Localización
Se mejoró la compatibilidad con texto bidireccional.
Las versiones anteriores de Android admiten idiomas y diseños de derecha a izquierda (RTL), pero, a veces, no controlan correctamente el texto de dirección mixta. Por lo tanto, Android 4.3 agrega las APIs de BidiFormatter
que te ayudan a formatear correctamente el texto con dirección opuesta.
sin desordenar ninguna parte de él.
Por ejemplo, cuando quieres crear una oración con una variable de cadena, como "¿Quisiste decir...?
15 Bay Street, Laurel, CA?", normalmente, pasas un recurso de cadenas localizado y la variable a
String.format()
Kotlin
val suggestion = String.format(resources.getString(R.string.did_you_mean), address)
Java
Resources res = getResources(); String suggestion = String.format(res.getString(R.string.did_you_mean), address);
Sin embargo, si la configuración regional es hebreo, la cadena con formato se muestra de la siguiente manera:
האם התכוונת ל 15 Bay Street, Laurel, CA?
Eso es incorrecto, ya que el número "15" debería estar a la izquierda de "Bay Street". La solución es usar BidiFormatter
y su método unicodeWrap()
. Por ejemplo, el código anterior se convierte en lo siguiente:
Kotlin
val bidiFormatter = BidiFormatter.getInstance() val suggestion = String.format( resources.getString(R.string.did_you_mean), bidiFormatter.unicodeWrap(address) )
Java
Resources res = getResources(); BidiFormatter bidiFormatter = BidiFormatter.getInstance(); String suggestion = String.format(res.getString(R.string.did_you_mean), bidiFormatter.unicodeWrap(address));
De forma predeterminada, unicodeWrap()
usa la heurística de estimación de direccionalidad de primer orden, que puede generar errores si el primer indicador de dirección del texto no representa la dirección adecuada para el contenido en su totalidad.
Si es necesario, puedes especificar una heurística diferente pasando una de las constantes TextDirectionHeuristic
de TextDirectionHeuristics
.
a unicodeWrap()
.
Nota: Estas nuevas APIs también están disponibles para versiones anteriores de Android a través de la biblioteca de compatibilidad de Android, con la clase BidiFormatter
y las APIs relacionadas.
Servicios de accesibilidad
Cómo controlar eventos clave
Un AccessibilityService
ahora puede recibir una devolución de llamada para
eventos de entrada clave con el método de devolución de llamada onKeyEvent()
. Esto permite que tu servicio de accesibilidad controle la entrada de dispositivos de entrada basados en teclas, como un teclado, y traduzca esos eventos a acciones especiales que antes solo podían realizarse con la entrada táctil o el pad direccional del dispositivo.
Seleccionar texto y copiarlo y pegarlo
AccessibilityNodeInfo
ahora proporciona APIs que permiten
Un AccessibilityService
para seleccionar, cortar, copiar y pegar
texto en un nodo.
Para especificar la selección de texto que se cortará o copiará, tu servicio de accesibilidad puede usar la nueva acción ACTION_SET_SELECTION
y pasar con ella la posición de inicio y finalización de la selección con ACTION_ARGUMENT_SELECTION_START_INT
y ACTION_ARGUMENT_SELECTION_END_INT
.
También puedes seleccionar texto manipulando la posición del cursor con el
acción, ACTION_NEXT_AT_MOVEMENT_GRANULARITY
(anteriormente solo para mover la posición del cursor) y agregar el argumento ACTION_ARGUMENT_EXTEND_SELECTION_BOOLEAN
.
Luego, puedes cortar o copiar con ACTION_CUT
,
ACTION_COPY
y, luego, pegar con
ACTION_PASTE
.
Nota: Estas APIs nuevas también están disponibles para versiones anteriores.
de Android mediante la Asistencia para Android
Biblioteca, con AccessibilityNodeInfoCompat
clase.
Declara las funciones de accesibilidad
A partir de Android 4.3, un servicio de accesibilidad debe declarar capacidades de accesibilidad en su archivo de metadatos para usar ciertas funciones de accesibilidad. Si la función no es
solicitado en el archivo de metadatos, la función no funcionará. Para declarar la política
accesibilidad, debes usar atributos XML que correspondan a los diversos
"capacidad" constantes en AccessibilityServiceInfo
clase.
Por ejemplo, si un servicio no solicita la capacidad flagRequestFilterKeyEvents
,
no recibirá eventos clave.
Pruebas y depuración
Pruebas automatizadas de la IU
La nueva clase UiAutomation
proporciona APIs que te permiten simular la experiencia
para la automatización de pruebas. Mediante las APIs de AccessibilityService
de la plataforma, la función UiAutomation
Las APIs te permiten inspeccionar el contenido de la pantalla y, además, insertar eventos táctiles y de teclado arbitrarios.
Para obtener una instancia de UiAutomation
, llama a Instrumentation.getUiAutomation()
. Para que esto funcione, debes proporcionar la opción -w
con el comando instrument
cuando ejecutes tu InstrumentationTestCase
desde adb shell
.
Con la instancia de UiAutomation
, puedes ejecutar eventos arbitrarios para probar tu app llamando a executeAndWaitForEvent()
, pasándole un Runnable
para realizar, un período de tiempo de espera para la operación y una implementación de la interfaz UiAutomation.AccessibilityEventFilter
. Recibirás una llamada dentro de tu implementación de UiAutomation.AccessibilityEventFilter
que te permite filtrar los eventos que te interesan y determinar si
la falla de un caso de prueba determinado.
Para observar todos los eventos durante una prueba, crea una implementación de UiAutomation.OnAccessibilityEventListener
y pásala a setOnAccessibilityEventListener()
.
Luego, la interfaz del objeto de escucha recibe una llamada a onAccessibilityEvent()
.
cada vez que ocurre un evento, recibir un objeto AccessibilityEvent
que describe el evento.
Existe una variedad de otras operaciones que exponen las APIs de UiAutomation
en un nivel muy bajo para fomentar el desarrollo de herramientas de prueba de IU, como uiautomator. Por ejemplo, UiAutomation
también puede hacer lo siguiente:
- Cómo insertar eventos de entrada
- Cómo cambiar la orientación de la pantalla
- Cómo tomar capturas de pantalla
Y, lo que es más importante para las herramientas de prueba de IU, las APIs de UiAutomation
funcionan en todos los límites de la aplicación, a diferencia de las de Instrumentation
.
Eventos de Systrace para apps
Android 4.3 agrega la clase Trace
con dos métodos estáticos, beginSection()
y endSection()
, que te permiten definir bloques de código para incluirlos en el informe de Systrace. Cuando creas secciones de código rastreable en tu app, los registros de Systrace te proporcionan un análisis mucho más detallado de dónde se produce la ralentización en tu app.
Para obtener información sobre el uso de la herramienta Systrace, consulta Cómo analizar la pantalla y el rendimiento con Systrace.
Seguridad
Almacén de claves de Android para claves privadas de la app
Android ahora ofrece un proveedor de seguridad de Java personalizado en KeyStore
llamado Android Key Store, que te permite generar y guardar claves privadas que
los usuarios solo puedan ver y usar tu app. Para cargar Android Key Store, pasa
"AndroidKeyStore"
a KeyStore.getInstance()
.
Para administrar las credenciales privadas de tu app en el almacén de claves de Android, genera una clave nueva con KeyPairGenerator
con KeyPairGeneratorSpec
. Primero, llama a getInstance()
para obtener una instancia de KeyPairGenerator
. Luego, llama a initialize()
y pásale una instancia de KeyPairGeneratorSpec
, que puedes obtener con KeyPairGeneratorSpec.Builder
.
Por último, llama a generateKeyPair()
para obtener tu KeyPair
.
Almacenamiento de credenciales de hardware
Android ahora también admite almacenamiento con copia de seguridad en hardware para tu KeyChain
credenciales, lo que brinda más seguridad, ya que hace que las claves no estén disponibles para la extracción. Es decir, una vez que las claves se encuentran en un almacén de claves con copia de seguridad en hardware (elemento seguro, TPM o TrustZone), se pueden usar para operaciones criptográficas, pero no se puede exportar el material de la clave privada. Ni siquiera el kernel del SO puede acceder a este material de claves. Si bien no todos los dispositivos con Android admiten el almacenamiento en
puedes comprobar durante el tiempo de ejecución si el almacenamiento con copia de seguridad en hardware está disponible llamando
KeyChain.IsBoundKeyAlgorithm()
Declaraciones de manifiesto
Funciones requeridas declarables
Los siguientes valores ahora son compatibles con el elemento <uses-feature>
, por lo que puedes asegurarte de que tu app solo se instale en dispositivos que proporcionen las funciones que necesita.
FEATURE_APP_WIDGETS
- Declara que tu app proporciona un widget de app y debe instalarse solo en dispositivos que tengan las siguientes características:
incluir una pantalla principal o una ubicación similar donde los usuarios puedan incorporar widgets de apps.
Ejemplo:
<uses-feature android:name="android.software.app_widgets" android:required="true" />
FEATURE_HOME_SCREEN
- Declara que tu app se comporta como un reemplazo de la pantalla principal y solo debe instalarse en
dispositivos compatibles con la pantalla principal de terceros.
Ejemplo:
<uses-feature android:name="android.software.home_screen" android:required="true" />
FEATURE_INPUT_METHODS
- Declara que tu app proporciona un método de entrada personalizado (un teclado compilado con
InputMethodService
) y debe instalarse solo en dispositivos que tengan las siguientes características: admiten métodos de entrada de terceros. Ejemplo:<uses-feature android:name="android.software.input_methods" android:required="true" />
FEATURE_BLUETOOTH_LE
- Declara que tu app usa APIs de Bluetooth de bajo consumo y debe instalarse solo en dispositivos.
que puedan comunicarse con otros dispositivos mediante Bluetooth de bajo consumo.
Ejemplo:
<uses-feature android:name="android.software.bluetooth_le" android:required="true" />
Permisos del usuario
Los siguientes valores ahora son compatibles con <uses-permission>
para declarar los permisos que tu app requiere para acceder a determinadas APIs.
BIND_NOTIFICATION_LISTENER_SERVICE
- Obligatorio para usar las nuevas APIs de
NotificationListenerService
. SEND_RESPOND_VIA_MESSAGE
- Obligatorio para recibir la
ACTION_RESPOND_VIA_MESSAGE
.
Para obtener una vista detallada de todos los cambios de las APIs en Android 4.3, consulta el Informe de diferencias de las APIs.