From 4fd1a573eb0724251b5c0986c7f0ae7b36d52369 Mon Sep 17 00:00:00 2001 From: David Friedman Date: Mon, 29 Jun 2015 16:03:08 -0700 Subject: [PATCH] Docs: Localized M-Preview pages Bug: 21789313 Change-Id: Ifb4a45a65acd7b786e05bdf7b7dd86698093fbdf --- .../html-intl/intl/es/preview/api-overview.jd | 521 ++++++++++++ .../intl/es/preview/behavior-changes.jd | 403 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ docs/html-intl/intl/es/preview/overview.jd | 362 ++++++++ .../html-intl/intl/ja/preview/api-overview.jd | 521 ++++++++++++ .../intl/ja/preview/behavior-changes.jd | 402 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ docs/html-intl/intl/ja/preview/overview.jd | 362 ++++++++ .../html-intl/intl/ko/preview/api-overview.jd | 521 ++++++++++++ .../intl/ko/preview/behavior-changes.jd | 402 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ docs/html-intl/intl/ko/preview/overview.jd | 362 ++++++++ .../intl/pt-br/preview/api-overview.jd | 521 ++++++++++++ .../intl/pt-br/preview/behavior-changes.jd | 402 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ .../preview/images/direct-share-screen.png | Bin 0 -> 57767 bytes .../preview/images/direct-share-screen_2x.png | Bin 0 -> 195946 bytes .../preview/images/fingerprint-screen.png | Bin 0 -> 39082 bytes .../preview/images/fingerprint-screen_2x.png | Bin 0 -> 127518 bytes .../images/m-preview-timeline-crop.png | Bin 0 -> 10205 bytes .../preview/images/m-preview-timeline.png | Bin 0 -> 13002 bytes .../images/perf-test-frame-latency.png | Bin 0 -> 161802 bytes .../preview/images/perf-test-framestats.png | Bin 0 -> 7785 bytes .../pt-br/preview/images/text-selection.gif | Bin 0 -> 212462 bytes .../preview/images/work-profile-screen.png | Bin 0 -> 39183 bytes .../preview/images/work-profile-screen_2x.png | Bin 0 -> 126304 bytes docs/html-intl/intl/pt-br/preview/overview.jd | 362 ++++++++ .../html-intl/intl/ru/preview/api-overview.jd | 521 ++++++++++++ .../intl/ru/preview/behavior-changes.jd | 402 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ docs/html-intl/intl/ru/preview/overview.jd | 362 ++++++++ .../intl/zh-cn/preview/api-overview.jd | 521 ++++++++++++ .../intl/zh-cn/preview/behavior-changes.jd | 402 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ docs/html-intl/intl/zh-cn/preview/overview.jd | 362 ++++++++ .../intl/zh-tw/preview/api-overview.jd | 521 ++++++++++++ .../intl/zh-tw/preview/behavior-changes.jd | 402 +++++++++ .../preview/features/runtime-permissions.jd | 794 ++++++++++++++++++ docs/html-intl/intl/zh-tw/preview/overview.jd | 362 ++++++++ 39 files changed, 14554 insertions(+) create mode 100644 docs/html-intl/intl/es/preview/api-overview.jd create mode 100644 docs/html-intl/intl/es/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/es/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/es/preview/overview.jd create mode 100644 docs/html-intl/intl/ja/preview/api-overview.jd create mode 100644 docs/html-intl/intl/ja/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/ja/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/ja/preview/overview.jd create mode 100644 docs/html-intl/intl/ko/preview/api-overview.jd create mode 100644 docs/html-intl/intl/ko/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/ko/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/ko/preview/overview.jd create mode 100644 docs/html-intl/intl/pt-br/preview/api-overview.jd create mode 100644 docs/html-intl/intl/pt-br/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/pt-br/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/pt-br/preview/images/direct-share-screen.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/direct-share-screen_2x.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/fingerprint-screen.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/fingerprint-screen_2x.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/m-preview-timeline-crop.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/m-preview-timeline.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/perf-test-frame-latency.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/perf-test-framestats.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/text-selection.gif create mode 100644 docs/html-intl/intl/pt-br/preview/images/work-profile-screen.png create mode 100644 docs/html-intl/intl/pt-br/preview/images/work-profile-screen_2x.png create mode 100644 docs/html-intl/intl/pt-br/preview/overview.jd create mode 100644 docs/html-intl/intl/ru/preview/api-overview.jd create mode 100644 docs/html-intl/intl/ru/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/ru/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/ru/preview/overview.jd create mode 100644 docs/html-intl/intl/zh-cn/preview/api-overview.jd create mode 100644 docs/html-intl/intl/zh-cn/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/zh-cn/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/zh-cn/preview/overview.jd create mode 100644 docs/html-intl/intl/zh-tw/preview/api-overview.jd create mode 100644 docs/html-intl/intl/zh-tw/preview/behavior-changes.jd create mode 100644 docs/html-intl/intl/zh-tw/preview/features/runtime-permissions.jd create mode 100644 docs/html-intl/intl/zh-tw/preview/overview.jd diff --git a/docs/html-intl/intl/es/preview/api-overview.jd b/docs/html-intl/intl/es/preview/api-overview.jd new file mode 100644 index 0000000000000..ddd34dbd72889 --- /dev/null +++ b/docs/html-intl/intl/es/preview/api-overview.jd @@ -0,0 +1,521 @@ +page.title=Información general de la API +page.keywords=versión preliminar,sdk,compatibilidad +page.tags=recursos de la versión preliminar, androidm +sdk.platform.apiLevel=22-mnc +page.image=images/cards/card-api-overview_16-9_2x.png +@jd:body + + +
+ +
+ +

M Developer Preview le brinda una perspectiva avanzada de la próxima versión de la plataforma Android, que ofrece nuevas características para usuarios y desarrolladores de aplicaciones. + + En este documento, se brinda una introducción sobre las API más distinguidas.

+ +

M Developer Preview está destinado a usuarios desarrolladores principiantes y evaluadores. + Si le interesa influenciar la dirección del marco de trabajo de Android, +pruebe M Developer Preview y envíenos sus comentarios. + +

+ +

Advertencia: No publique las aplicaciones que utilizan M Developer Preview en la tienda de Google Play. +

+ +

Nota: Este documento, a menudo, hace referencia a clases y métodos que aún no cuentan con materiales de referencia disponibles en developer.android.com. + Estos elementos de API tienen el formato {@code code style} en este documento (sin hipervínculos). + Para obtener la documentación preliminar de la API para estos elementos, descargue la referencia de la versión preliminar. +

+ +

Importantes cambios en los comportamientos

+ +

Si publicó anteriormente una aplicación para Android, tenga en cuenta que su aplicación podría verse afectada por los cambios en la plataforma. +

+ +

Consulte la sección Cambios en los comportamientos para obtener información detallada.

+ +

Vinculación de la aplicación

+

Esta versión preliminar mejora el sistema de intentos de Android al proporcionar una vinculación más sólida de la aplicación. Esta característica le permite asociar una aplicación con un dominio web propio. + Según esta asociación, la plataforma puede determinar la aplicación predeterminada que se debe utilizar para controlar un vínculo web en particular y omitir el paso de pedirles a los usuarios que seleccionen una aplicación. Para aprender a implementar esta característica, consulte la sección +Vinculación de la aplicación. + + + +

Copia de seguridad automática para aplicaciones

+

Ahora, el sistema realiza restauraciones y copias de seguridad de datos completas y automáticas para las aplicaciones. Este comportamiento se habilita de forma predeterminada para las aplicaciones que tienen como destino la versión preliminar de Android M; usted no necesita agregar ningún código adicional. + Si los usuarios eliminan sus cuentas de Google, también se eliminarán sus datos de copias de seguridad. + Para obtener información sobre cómo funciona esta característica y cómo configurar qué elementos incluir en la copia de seguridad del sistema de archivo, consulte la sección +Copia de seguridad automática para aplicaciones. +

+ +

Autenticación

+

Esta versión preliminar ofrece nuevas API para permitirle autenticar usuarios al usar escaneos de huellas dactilares en los dispositivos compatibles y verificar cuán reciente es la última autenticación del usuario al utilizar un mecanismo de desbloqueo de dispositivos (como una contraseña de pantalla de bloqueo). + + Use estas API junto con el sistema Android Keystore. +

+ +

Autenticación por huellas dactilares

+ +

Para autenticar usuarios mediante el escaneo de huellas dactilares, obtenga una instancia de la nueva clase +{@code android.hardware.fingerprint.FingerprintManager} y llame al método +{@code FingerprintManager.authenticate()}. Su aplicación se debe ejecutar en un dispositivo compatible con un sensor de huellas dactilares. + Debe implementar la interfaz de usuario para el flujo de autenticación por huellas dactilares en su aplicación y debe utilizar el ícono de huella dactilar estándar de Android en la UI. El ícono de huella dactilar de Android ({@code c_fp_40px.png}) se incluye en la +aplicación de muestra. Si está desarrollando múltiples aplicaciones que utilizan la autenticación por huellas dactilares, tenga en cuenta que cada aplicación debe autenticar la huella dactilar del usuario de manera independiente. + + + +

+ +

Para utilizar esta característica en su aplicación, primero agregue el permiso {@code USE_FINGERPRINT} en su manifiesto. +

+ +
+<uses-permission
+        android:name="android.permission.USE_FINGERPRINT" />
+
+ + + +

Para ver cómo una aplicación implementa la autenticación por huellas dactilares, consulte la sección + +Ejemplo de diálogo de huella dactilar.

+ +

Si está evaluando esta característica, siga estos pasos:

+
    +
  1. Instale la Revisión de herramientas del SDK de Android versión 24.3, si todavía no la instaló.
    2. +
  2. Registre una huella dactilar nueva en el emulador; para hacerlo, vaya a +Settings > Security > Fingerprint, luego siga las instrucciones de registro.
    3. +
  3. Use un emulador para emular eventos táctiles de huellas dactilares con el siguiente comando. + Utilice el mismo comando para emular eventos táctiles de huellas dactilares en la pantalla de bloqueo o en su aplicación. + +
    +adb -e emu finger touch <finger_id>
+
    +

    En Windows, posiblemente tenga que ejecutar {@code telnet 127.0.0.1 <emulator-id>} seguido de + {@code finger touch <finger_id>}. +

    +
    4. +
+ +

Confirmar credencial

+

Su aplicación puede autenticar usuarios según el tiempo que haya pasado desde que desbloquearon su dispositivo por última vez. Esta característica evita que los usuarios tengan que recordar contraseñas adicionales específicas de la aplicación y elimina la necesidad de que usted tenga que implementar su propia interfaz de usuario de autenticación. + + Su aplicación debe utilizar esta característica junto con una implementación de clave pública o secreta para la autenticación del usuario. +

+ +

Para definir la duración del tiempo de espera en el que se puede volver a usar la misma clave después de que un usuario se haya autenticado correctamente, llame al nuevo método +{@code android.security.keystore.KeyGenParameterSpec.setUserAuthenticationValidityDurationSeconds()} +cuando configure {@link javax.crypto.KeyGenerator} o +{@link java.security.KeyPairGenerator}. + Esta característica actualmente funciona para operaciones criptográficas simétricas. +

+ +

Evite mostrar el diálogo de nueva autenticación de forma excesiva: sus aplicaciones deben intentar utilizar el objeto criptográfico primero y, si se agota el tiempo de espera, deben usar el método +{@link android.app.KeyguardManager#createConfirmDeviceCredentialIntent(java.lang.CharSequence, java.lang.CharSequence) createConfirmDeviceCredentialIntent()} +para volver a autenticar el usuario dentro de su aplicación. + +

+ +

Para ver cómo la aplicación implementa esta característica, consulte la sección + +Ejemplo de cómo confirmar la credencial.

+ +

Compartir de forma directa

+ + + +

Esta versión preliminar le proporciona API para que la acción de compartir sea intuitiva y rápida para los usuarios. Ahora, puede definir destinos para compartir de forma directa que inician una actividad específica en su aplicación. Estos destinos para compartir de forma directa se exponen a los usuarios a través del menú Share. + + Esta característica les permite a los usuarios compartir contenido con los destinos, como contactos, dentro de otras aplicaciones. + Por ejemplo, el destino para compartir de forma directa podría iniciar una actividad en otra aplicación de red social, lo que le permite al usuario compartir contenido directamente con una comunidad o un amigo específicos de esa aplicación. + +

+ +

Para habilitar destinos para compartir de forma directa, debe definir una clase que extienda el +{@code android.service.}
+Clase {@code chooser.ChooserTargetService}. Declare su +{@code ChooserTargetService} en el manifiesto. En esa declaración, especifique el permiso +{@code BIND_CHOOSER_TARGET_SERVICE} y un filtro de intento con la acción +{@code SERVICE_INTERFACE}.

+

El ejemplo a continuación muestra de qué manera podría declarar {@code ChooserTargetService} en su manifiesto. +

+
+<service android:name=".ChooserTargetService"
+        android:label="@string/service_name"
+        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
+    <intent-filter>
+        <action android:name="android.service.chooser.ChooserTargetService" />
+    </intent-filter>
+</service>
+
+ +

Para cada actividad que desee exponer a {@code ChooserTargetService}, agregue un elemento +{@code <meta-data>} con el nombre +{@code "android.service.chooser.chooser_target_service"} en el manifiesto de su aplicación. +

+ +
+<activity android:name=".MyShareActivity”
+        android:label="@string/share_activity_label">
+    <intent-filter>
+        <action android:name="android.intent.action.SEND" />
+    </intent-filter>
+<meta-data
+        android:name="android.service.chooser.chooser_target_service"
+        android:value=".ChooserTargetService" />
+</activity>
+
+ +

Interacciones de voz

+

+Esta versión preliminar proporciona una nueva API de interacción de voz que, junto con las +acciones de voz, +le permite compilar experiencias de conversaciones de voz en sus aplicaciones. Llame al método +{@code android.app.Activity.isVoiceInteraction()} para determinar si su actividad se inició en respuesta a una acción de voz. + De ser así, su aplicación puede utilizar la clase +{@code android.app.VoiceInteractor} para solicitar una confirmación de voz por parte del usuario, realizar una selección de una lista de opciones y mucho más. + Para obtener más información sobre cómo implementar acciones de voz, consulte el +sitio para desarrolladores de acciones de voz. +

+ +

Asistencia de API

+

+Esta versión preliminar ofrece una nueva manera para que los usuarios interactúen con sus aplicaciones a través de un asistente. Si desea utilizar esta característica, el usuario debe habilitar el asistente para utilizar el contexto actual. + Una vez habilitado, para invocar al asistente dentro de cualquier aplicación, el usuario debe mantener presionado el botón Home. +

+

Su aplicación puede optar por no compartir el contexto actual con el asistente al configurar la marca +{@link android.view.WindowManager.LayoutParams#FLAG_SECURE}. Además del conjunto de información estándar que la plataforma le pasa al asistente, su aplicación puede compartir información adicional usando la nueva clase {@code android.app.Activity.AssistContent}. + +

+ +

Para proporcionarle al asistente contexto adicional desde su aplicación, siga estos pasos:

+ +
    +
  1. Implemente la interfaz {@link android.app.Application.OnProvideAssistDataListener}.
    2. +
  2. Registre esta escucha usando +{@link android.app.Application#registerOnProvideAssistDataListener(android.app.Application.OnProvideAssistDataListener) registerOnProvideAssistDataListener()}.
    3. +
  3. Para proporcionar información contextual específica de la actividad, invalide la devolución de llamada +{@link android.app.Activity#onProvideAssistData(android.os.Bundle) onProvideAssistData()} +y, opcionalmente, la nueva devolución de llamada {@code Activity.onProvideAssistContent()}. +
+ +

Notificaciones

+

Esta versión preliminar agrega los siguientes cambios de API para las notificaciones:

+ + +

Compatibilidad del lápiz Bluetooth

+

Esta versión preliminar ofrece soporte mejorado para las entradas de usuarios que utilizan un lápiz Bluetooth. Los usuarios pueden sincronizar y conectar un lápiz Bluetooth compatible con su teléfono o tablet. + Mientras está conectado, la información de posición de la pantalla táctil se fusiona con la información de los botones y la presión del lápiz para proporcionar una mayor variedad de expresiones que al utilizar la pantalla táctil solamente. + + Su aplicación puede obedecer cuando se presiona el botón del lápiz y cuando se realizan acciones secundarias al registrar las nuevas devoluciones de llamadas +{@code View.onStylusButtonPressListener} y {@code GestureDetector.OnStylusButtonPressListener} +en su actividad. +

+ +

Utilice las constantes y los métodos {@link android.view.MotionEvent} para detectar las interacciones del botón del lápiz: +

+ + +

Exploración mejorada de Bluetooth de bajo consumo

+

+Si su aplicación realiza exploraciones de Bluetooth de bajo consumo, puede utilizar el nuevo método +{@code android.bluetooth.le.ScanSettings.Builder.setCallbackType()} para especificar que usted desea que las devoluciones de llamadas se notifiquen solo cuando se encuentre por primera vez un paquete de anuncio que coincida con el conjunto +{@link android.bluetooth.le.ScanFilter} y cuando no se vea durante un período determinado. + + Este enfoque de exploración es más eficaz en cuanto al consumo de energía que la que se proporciona en la versión anterior de la plataforma. + +

+ +

Soporte de Hotspot 2.0 versión 1

+

+Esta versión preliminar agrega soporte para la especificación de Hotspot 2.0 versión 1 en los dispositivos Nexus 6 y Nexus 9. Para proveer credenciales de Hotspot 2.0 en su aplicación, use los métodos nuevos de la clase +{@link android.net.wifi.WifiEnterpriseConfig}, como {@code setPlmn()} y +{@code setRealm()}. + En el objeto {@link android.net.wifi.WifiConfiguration}, puede configurar los campos +{@link android.net.wifi.WifiConfiguration#FQDN} y {@code providerFriendlyName}. La nueva propiedad {@code ScanResult.PasspointNetwork} indica si una red detectada representa un punto de acceso de Hotspot 2.0. + + +

+ +

Modo de pantalla 4K

+

Ahora, la plataforma permite que las aplicaciones soliciten que la resolución de pantalla se actualice a una representación 4K en el hardware compatible. + Para consultar la resolución física actual, use las nuevas API +{@code android.view.Display.Mode}. Si la UI se establece en una resolución lógica más baja y se aumenta a una resolución física más alta, tenga en cuenta que la resolución física que devuelve el método +{@code Display.Mode.getPhysicalWidth()} puede ser diferente de la resolución lógica informada por {@link android.view.Display#getSize(android.graphics.Point) getSize()}. + +

+ +

Puede pedirle al sistema que cambie la resolución física en su aplicación mientras se ejecuta y, para ello, debe configurar la propiedad {@code WindowManager.LayoutParams.preferredDisplayModeId} de la ventana de su aplicación. + Esta característica resulta útil si desea cambiar a la resolución de pantalla 4K. + Mientras se encuentra en el modo de pantalla 4K, la UI se continúa representando en la resolución original (como 1080p) y se aumenta a 4K, pero los objetos +{@link android.view.SurfaceView} pueden mostrar contenido en la resolución nativa. +

+ +

ColorStateLists para poder aplicar temas

+

Ahora, los atributos de tema se admiten en +{@link android.content.res.ColorStateList} para los dispositivos que ejecutan la versión preliminar de Android M. Los métodos +{@link android.content.res.Resources#getColorStateList(int) getColorStateList()} y +{@link android.content.res.Resources#getColor(int) getColor()} se dejaron de usar. Si desea llamar a estas API, en su lugar, llame a los métodos nuevos {@code Context.getColorStateList()} o +{@code Context.getColor()}. + Estos métodos también se encuentran disponibles en la biblioteca AppCompat v4 vía {@link android.support.v4.content.ContextCompat}. +

+ +

Características de audio

+ +

Esta versión preliminar agrega mejoras al procesamiento de audio en Android, lo que incluye lo siguiente:

+ + +

Características de video

+

Esta versión preliminar agrega nuevas capacidades a las API de procesamiento de video, entre ellas, las siguientes:

+ + +

Características de la cámara

+

Esta versión preliminar incluye las siguientes API nuevas para acceder a la luz de flash de la cámara y para el reprocesamiento de imágenes de la cámara: +

+ +

API para luz de flash

+

Si un dispositivo de cámara cuenta con una unidad de flash, puede llamar al método {@code CameraManager.setTorchMode()} +para activar o desactivar el modo linterna de una unidad de flash sin abrir el dispositivo de cámara. La aplicación no tiene propiedad exclusiva de la unidad de flash ni del dispositivo de cámara. + El modo linterna se desactiva y deja de estar disponible cuando la cámara no se encuentra disponible o cuando otros recursos de la cámara que mantienen la linterna encendida dejan de estar disponibles. + + Otras aplicaciones también pueden llamar a {@code setTorchMode()} +para desactivar el modo linterna. Cuando se cierra la última aplicación que activó el modo linterna, este modo se desactiva. +

+ +

Si desea registrar una devolución de llamada para recibir una notificación sobre el estado del modo linterna, llame al método +{@code CameraManager.registerTorchCallback()}. La primera vez que se registra la devolución de llamada, se llama inmediatamente con el estado del modo linterna de todos los dispositivos de cámara que se conocen actualmente y que tengan una unidad de flash. + + Si el modo linterna se activa o desactiva correctamente, se invoca al método +{@code CameraManager.TorchCallback.onTorchModeChanged()}.

+ +

API de reprocesamiento

+

La API {@link android.hardware.camera2 Camera2} se extiende para admitir el reprocesamiento de imágenes privadas de formato opaco y YUV. + Su aplicación determina si las capacidades de reprocesamiento se encuentran disponibles vía {@code CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES}. + Si un dispositivo admite el reprocesamiento, usted puede crear una sesión de captura de cámara reprocesable llamando a +{@code CameraDevice.createReprocessableCaptureSession()} y puede crear solicitudes para el reprocesamiento de búferes de entrada. + +

+ +

Utilice la clase {@code ImageWriter} para conectar el flujo del búfer de entrada a la entrada de reprocesamiento de la cámara. + Para obtener un búfer vacío, siga el modelo de programación que se indica a continuación:

+ +
    +
  1. Llame al método {@code ImageWriter.dequeueInputImage()}.
    2. +
  2. Complete los datos en el búfer de entrada.
    3. +
  3. Envíe el búfer a la cámara llamando al método {@code ImageWriter.queueInputImage()}.
    4. +
+ +

Si está utilizando un objeto {@code ImageWriter} junto con una imagen +{@code android.graphics.ImageFormat.PRIVATE}, su aplicación no puede acceder a los datos de la imagen de forma directa. + En cambio, pase la imagen {@code ImageFormat.PRIVATE} directamente a +{@code ImageWriter} llamando al método {@code ImageWriter.queueInputImage()} sin ninguna copia del búfer. +

+ +

La clase {@code ImageReader} ahora admite secuencias de imagen de formato {@code android.graphics.ImageFormat.PRIVATE}. + Este soporte le permite que su aplicación mantenga una cola de imagen circular de imágenes de salida +{@code ImageReader}, seleccione una o más imágenes y las envíe a +{@code ImageWriter} para el reprocesamiento de la cámara.

+ +

Características de Android for Work

+

Esta versión preliminar incluye las siguientes API nuevas para Android for Work:

+ + +

+ Para obtener una vista detallada de todos los cambios de la API en M Developer Preview, consulte el Informe de diferencias de las API. +

diff --git a/docs/html-intl/intl/es/preview/behavior-changes.jd b/docs/html-intl/intl/es/preview/behavior-changes.jd new file mode 100644 index 0000000000000..75936bdc0634c --- /dev/null +++ b/docs/html-intl/intl/es/preview/behavior-changes.jd @@ -0,0 +1,403 @@ +page.title=Cambios en los comportamientos +page.keywords=versión preliminar,sdk,compatibilidad +sdk.platform.apiLevel=MNC +@jd:body + + +
+ +
+ +

Además de nuevas características y capacidades, M Developer Preview incluye diversos cambios en el sistema y cambios en los comportamientos de la API. + En este documento, se destacan algunos de los cambios principales que debe comprender y justificar en sus aplicaciones. +

+ +

Si publicó anteriormente una aplicación para Android, tenga en cuenta que su aplicación podría verse afectada por estos cambios en la plataforma. +

+ +

Permisos de tiempo de ejecución

+

Esta versión preliminar introduce un nuevo modelo de permisos en el que los usuarios ahora pueden administrar directamente los permisos de la aplicación en tiempo de ejecución. + Este modelo les proporciona a los usuarios mayor visibilidad y control sobre los permisos y, al mismo tiempo, simplifica los procesos de instalación y actualización automática para los desarrolladores de aplicaciones. Los usuarios pueden conceder o revocar permisos de forma individual para las aplicaciones instaladas. + +

+ +

En sus aplicaciones que tienen como destino la versión preliminar de Android M, asegúrese de comprobar y solicitar los permisos en tiempo de ejecución. + Para determinar si se concedió un permiso a su aplicación, llame al nuevo método {@code Context.checkSelfPermission()}. + Para solicitar un permiso, llame al nuevo método +{@code Activity.requestPermission()}. Incluso si su aplicación no tiene como destino la versión preliminar de Android M, debería probar su aplicación de acuerdo con el nuevo modelo de permisos. +

+ +

Para obtener detalles sobre la compatibilidad del nuevo modelo de permisos en su aplicación, consulte la página + +Permisos de la versión preliminar para desarrolladores. Para obtener consejos sobre cómo evaluar el impacto en su aplicación, consulte la Guía de prueba. +

+ +

Optimizaciones de ahorro de energía

+

Esta versión preliminar introduce nuevas optimizaciones de ahorro de energía para aplicaciones y dispositivos inactivos.

+ +

Doze

+

Si un dispositivo está desconectado y permanece quieto con la pantalla apagada durante un período determinado, pasará al modo Doze, en el que el dispositivo intenta mantener el sistema en estado de suspensión. + En este modo, los dispositivos reanudan periódicamente el funcionamiento normal durante períodos breves, de manera que la aplicación se pueda sincronizar y el sistema pueda realizar las operaciones pendientes. + +

+ +

Durante el modo Doze, se aplican las siguientes restricciones a sus aplicaciones:

+ +

+

Al salir del modo Doze, el dispositivo ejecuta los trabajos y las sincronizaciones pendientes.

+

Para probar esta característica, conecte un dispositivo que esté ejecutando la versión preliminar de Android M a su equipo de desarrollo y llame a los siguientes comandos: + +

+
+$ adb shell dumpsys battery unplug
+$ adb shell dumpsys deviceidle step
+$ adb shell dumpsys deviceidle -h
+
+

Nota: La próxima versión de + +Google Cloud Messaging le permite designar mensajes de prioridad alta. + Si su aplicación recibe mensajes de GCM de prioridad alta, se le concede un breve acceso a la red, incluso cuando el dispositivo se encuentra en modo Doze. + +

+ +

Consulte la +Guía de prueba para obtener consejos sobre cómo probar el modo Doze en su aplicación. +

+ +

App Standby

+

Con esta versión preliminar, el sistema puede determinar que las aplicaciones se encuentran inactivas cuando no están en uso activo. + La aplicación se considera inactiva después de un cierto período, salvo que el sistema detecte alguna de las siguientes señales: +

+ + + +

Si el dispositivo está desconectado, las aplicaciones que se consideren inactivas tendrán deshabilitado el acceso a la red y se suspenderán sus sincronizaciones y trabajos. + Cuando el dispositivo se conecte a un sistema de alimentación, estas aplicaciones se podrán conectar a la red y podrán ejecutar los trabajos y las sincronizaciones pendientes. + Si el dispositivo queda inactivo durante períodos prolongados, las aplicaciones inactivas pueden acceder a la red aproximadamente una vez al día. +

+ +

Para probar esta característica, conecte un dispositivo que esté ejecutando la versión preliminar de Android M a su equipo de desarrollo y llame a los siguientes comandos: + +

+
+$ adb shell dumpsys battery unplug
+$ adb shell am set-idle <packageName> true
+$ adb shell am set-idle <packageName> false
+$ adb shell am get-idle <packageName>
+
+ +

Nota: La próxima versión de + +Google Cloud Messaging (GCM) le permite designar mensajes de prioridad alta. + Si su aplicación recibe mensajes de GCM de prioridad alta, se le concede un breve acceso a la red, incluso cuando la aplicación está inactiva. + +

+ +

Consulte la +Guía de prueba para obtener consejos sobre cómo probar el modo App Standby en sus aplicaciones. +

+ +

Dispositivos de almacenamiento adoptables

+

+Con esta versión preliminar, los usuarios pueden adoptar dispositivos de almacenamiento externo, como tarjetas SD. Al adoptar un dispositivo de almacenamiento externo, el dispositivo se cifra y se formatea para que actúe como un elemento de almacenamiento interno. + Esta característica les permite a los usuarios mover tanto las aplicaciones como los datos privados de esas aplicaciones entre dispositivos de almacenamiento. + Al mover aplicaciones, el sistema respeta la preferencia +{@code android:installLocation} +del manifiesto. +

+ +

Si su aplicación accede a las API o a los campos que se indican a continuación, tenga en cuenta que las rutas de archivo que devuelven se modificarán dinámicamente cuando la aplicación se mueva entre dispositivos de almacenamiento interno y externo. Al crear rutas de archivo, lo más recomendable es que siempre llame a estas API de forma dinámica. No use rutas de archivo codificadas de forma rígida ni continúe usando rutas de archivo completas que se hayan creado anteriormente. + + +

+ + + +

Para depurar esta característica en la versión preliminar para desarrolladores, puede habilitar la opción de adoptar una unidad USB que esté conectada a un dispositivo Android mediante un cable USB On-The-Go (OTG) y para habilitarla puede ejecutar el siguiente comando: +

+ +
+$ adb shell sm set-force-adoptable true
+
+ +

Eliminación del cliente HTTP de Apache

+

Esta versión preliminar elimina el soporte del cliente HTTP de Apache. Si su aplicación utiliza este cliente y tiene como destino Android 2.3 (API de nivel 9) o una versión posterior, use, en su lugar, la clase {@link java.net.HttpURLConnection}. + + Esta API es más eficaz porque reduce el uso de la red mediante compresión y almacenamiento de respuesta en caché transparentes, y minimiza el consumo de energía. + Para continuar utilizando las API HTTP de Apache, primero debe declarar la siguiente dependencia en tiempo de compilación en su archivo {@code build.gradle}: + +

+
+android {
+    useLibrary 'org.apache.http.legacy'
+}
+
+

Android está migrando de la biblioteca OpenSSL a +BoringSSL +. Si utiliza Android NDK en su aplicación, no vincule bibliotecas criptográficas que no forman parte de la API de NDK, como {@code libcrypto.so} y {@code libssl.so}. + Estas bibliotecas no son API públicas y se pueden modificar o interrumpir sin aviso en todas las versiones y todos los dispositivos. Además, puede exponerse a vulnerabilidades de seguridad. + + En cambio, modifique su código nativo para llamar a las API de criptografía de Java a través de JNI o para vincular estáticamente una biblioteca criptográfica de su elección. + +

+ +

Cambios en AudioManager

+

Ya no se admitirán las funciones de ajustar el volumen de forma directa o silenciar secuencias específicas por medio de la clase {@link android.media.AudioManager} +. El método {@link android.media.AudioManager#setStreamSolo(int,boolean) +setStreamSolo()} es obsoleto, por lo que debe llamar al método +{@code AudioManager.requestAudioFocus()} en su lugar. Del mismo modo, el método +{@link android.media.AudioManager#setStreamMute(int,boolean) setStreamMute()} es obsoleto; en su lugar, llame al método{@code AudioManager.adjustStreamVolume()} y pase los valores de dirección {@code ADJUST_MUTE} o {@code ADJUST_UNMUTE}. + +

+ +

Selección de texto

+ + + +

Ahora, cuando los usuarios seleccionen texto en su aplicación, usted puede mostrar acciones de selección de texto, como +cortar, copiar y pegar en una +barra de herramientas flotante. La implementación de la interacción del usuario es similar a la de la barra de acciones contextuales, como se describe en la sección + +Habilitación del modo de acción contextual para vistas individuales. +

+ +

Si desea implementar una barra de herramientas flotante para selección de texto, realice los siguientes cambios en sus aplicaciones existentes: +

+
    +
  1. En su objeto {@link android.view.View} o {@link android.app.Activity}, cambie sus llamados +{@link android.view.ActionMode} de +{@code startActionMode(Callback)} a {@code startActionMode(Callback, ActionMode.TYPE_FLOATING)}.
    2. +
  2. Tome su implementación existente de {@code ActionMode.Callback} y, en su lugar, haga que sea extendida +{@code ActionMode.Callback2}.
    3. +
  3. Invalide el método {@code Callback2.onGetContentRect()} para proporcionar las coordenadas del objeto {@link android.graphics.Rect} de contenido (como un rectángulo de selección de texto) en la vista. +
    4. +
  4. Si el posicionamiento del rectángulo ya no es válido y este es el único elemento por invalidar, llame al método {@code ActionMode.invalidateContentRect()}. +
    5. +
+ +

Si utiliza la biblioteca +Android Support Library versión 22.2, tenga en cuenta que las barras de herramientas flotantes no son compatibles con versiones anteriores y AppCompat toma el control de los objetos {@link android.view.ActionMode} de forma predeterminada. + + Esto impide que se muestren las barras de herramientas flotantes. Para permitir la compatibilidad de +{@link android.view.ActionMode} en +{@link android.support.v7.app.AppCompatActivity}, llame a +{@code android.support.v7.app.AppCompatActivity.getDelegate()}, luego llame a +{@code android.support.v7.app.AppCompatDelegate.setHandleNativeActionModesEnabled()} en el objeto +{@link android.support.v7.app.AppCompatDelegate} devuelto y configure el parámetro de entrada como {@code false}. + Esta llamada devuelve el control de los objetos {@link android.view.ActionMode} al marco de trabajo. + En los dispositivos que ejecutan la versión preliminar de Android M, eso permite que el marco de trabajo admita los modos de barras de herramientas flotantes o +{@link android.support.v7.app.ActionBar}, mientras que en los dispositivos anteriores a la versión preliminar de Android M solo se admiten los modos {@link android.support.v7.app.ActionBar}. +

+ +

Cambios en Android Keystore

+

Con esta versión preliminar, el +proveedor de Android Keystore ya no admite DSA. + Aún se admite ECDSA.

+ +

Las claves que no requieren cifrado de datos estáticos ya no se eliminarán cuando se restablezca o deshabilite la pantalla de bloqueo seguro (por ejemplo, cuando lo haga el usuario o el administrador del dispositivo). + Las claves que requieren el cifrado de datos estáticos se eliminarán durante estos eventos. +

+ +

Cambios en las funciones de red y Wi-Fi

+ +

Esta versión preliminar introduce en las API de redes y Wi-Fi los siguientes cambios en los comportamientos.

+ + +

Cambios en el servicio de cámara

+

En esta versión preliminar, el modelo para acceder a los recursos compartidos en el servicio de cámara se cambió del modelo de acceso anterior “por orden de llegada” a un modelo de acceso en el que se favorecen los procesos de prioridad alta. + + Los cambios en el comportamiento del servicio incluyen los siguientes:

+ + +

Tiempo de ejecución de ART

+

El tiempo de ejecución de ART ahora implementa correctamente reglas de acceso para el método +{@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()}. Este cambio soluciona el problema que ocurría con Dalvik, que comprobaba las reglas de acceso incorrectamente en las versiones anteriores. Si su aplicación utiliza el método +{@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()} y usted desea invalidar comprobaciones de acceso, llame al método +{@link java.lang.reflect.Constructor#setAccessible(boolean) setAccessible()} con el parámetro de entrada configurado en {@code true}. + + + + Si su aplicación utiliza la +biblioteca AppCompat versión 7 o la +biblioteca RecyclerView versión 7, debe actualizar su aplicación para utilizar las versiones más recientes de estas bibliotecas. + De lo contrario, asegúrese de que las clases personalizadas a las que se haga referencia desde el XML estén actualizadas, de manera que se pueda acceder a sus constructores de clases. +

+ +

Esta versión preliminar actualiza el comportamiento del vinculador dinámico. El vinculador dinámico ahora entiende la diferencia entre {@code soname} de una biblioteca y su ruta de acceso ( +error público 6670), y ahora se implementa la búsqueda por {@code soname}. + + + Las aplicaciones que anteriormente funcionaban y que tenían entradas {@code DT_NEEDED} incorrectas (generalmente, rutas absolutas en el sistema de archivo del equipo de compilación) pueden generar error al cargarse. +

+ +

Ahora se implementa correctamente la marca {@code dlopen(3) RTLD_LOCAL}. Tenga en cuenta que +{@code RTLD_LOCAL} es lo predeterminado, por lo que se verán afectadas las llamadas a {@code dlopen(3)} que no utilizaron explícitamente +{@code RTLD_LOCAL} (salvo que su aplicación haya usado {@code RTLD_GLOBAL} explícitamente). Con +{@code RTLD_LOCAL}, los símbolos no estarán disponibles para las bibliotecas cargadas por llamadas posteriores a +{@code dlopen(3)} (a diferencia de lo que sucede al hacer referencia mediante entradas {@code DT_NEEDED}).

+

+ +

Validación de APK

+

Ahora la plataforma realiza validaciones más estrictas de APK. El APK se considera dañado si un archivo está declarado en el manifiesto, pero no está presente en el APK en sí. + Si se elimina algún contenido, se debe volver a firmar el APK. +

+ +

Cambios en Android for Work

+

Esta versión preliminar incluye los siguientes cambios en los comportamientos para Android for Work:

+ diff --git a/docs/html-intl/intl/es/preview/features/runtime-permissions.jd b/docs/html-intl/intl/es/preview/features/runtime-permissions.jd new file mode 100644 index 0000000000000..15bd954db6857 --- /dev/null +++ b/docs/html-intl/intl/es/preview/features/runtime-permissions.jd @@ -0,0 +1,794 @@ +page.title=Permisos +page.tags=recursos de la versión preliminar, androidm +page.keywords=permisos, tiempo de ejecución, vista preliminar +page.image={@docRoot}preview/features/images/permissions_check.png +@jd:body + + +
+
+

Quickview

+
    +
  • Si su aplicación tiene como destino el SDK de la versión preliminar de Android M, se solicitará a los usuarios que concedan permisos durante el tiempo de ejecución, en lugar de durante la instalación. +
    • +
  • Los usuarios pueden cancelar los permisos en cualquier momento desde la pantalla Settings de la aplicación. +
    • +
  • La aplicación necesita controlar los permisos cada vez que se ejecuta. +
    • +
+ +

Contenido del documento

+
    +
  1. Información general
    2. +
  2. Codificación para permisos de tiempo de ejecución
    3. +
  3. Prueba de permisos de tiempo de ejecución
    4. +
  4. Mejores prácticas
    5. +
+ + + + +
+
+ + +

+ M Developer Preview introduce un nuevo modelo de permisos de la aplicación que facilita a los usuarios el proceso de instalación y actualización de aplicaciones. + Si una aplicación que se ejecuta en la versión preliminar de Android M es compatible con el nuevo modelo de permisos, el usuario no tiene que conceder ningún permiso al instalar o actualizar la aplicación. En su lugar, la aplicación solicitará los permisos a medida que los vaya necesitado y el sistema mostrará al usuario un diálogo en el que le solicitará los permisos necesarios. + + + + +

+ +

+ Si la aplicación es compatible con el nuevo modelo de permisos, podrá instalarse y ejecutarse en los dispositivos con versiones anteriores de Android, utilizando el modelo de permisos anterior en esos dispositivos. + + +

+ +

+ Información general +

+ +

+ En M Developer Preview, la plataforma introduce un nuevo modelo +de permisos de la aplicación. A continuación, se presenta un resumen de los componentes principales de este nuevo modelo: +

+ + + +

+ Este modelo de permisos cambia la forma en la que la aplicación se comporta para características que requieren permisos. + A continuación, se presenta un resumen de las prácticas de desarrollo que debe seguir para ajustarse a este modelo: + +

+ + + +

+ Nota: Si una aplicación tiene como destino M Developer Preview, debe utilizar el nuevo modelo de permisos. + +

+ +

+ A partir del lanzamiento de M Developer Preview, no todas las aplicaciones de Google implementarán por completo el nuevo modelo de permisos. + Google actualiza estas aplicaciones durante el transcurso de M Developer Preview para respetar adecuadamente las configuraciones de alternancia de los permisos. + + +

+ +

+ Nota: Si la aplicación cuenta con su propia superficie de API, no transmita permisos sin antes asegurarse de que el iniciador de la llamada cuente con los permisos requeridos para acceder a esa información. + + +

+ +

+ Permisos de las aplicaciones de firma y de sistema +

+ +

+ Generalmente, cuando el usuario instala una aplicación, el sistema solo otorga a la aplicación +{@link android.content.pm.PermissionInfo#PROTECTION_NORMAL + PROTECTION_NORMAL}. Sin embargo, en ciertas circunstancias, el sistema le concede a la aplicación más permisos: + +

+ + + +

+ En ambos casos, el usuario aún puede revocar los permisos en cualquier momento si accede a la pantalla Settings del sistema y selecciona Apps > + + app_name > Permissions. La aplicación debe seguir controlando los permisos al momento de la ejecución y solicitarlos si fuese necesario. + + +

+ +

+ Compatibilidad con modelos anteriores y posteriores +

+ +

+ Si una aplicación no tiene como destino M Developer Preview, la aplicación continúa utilizando el modelo de permisos anterior, incluso en dispositivos con la versión preliminar de Android M. + Cuando el usuario instala la aplicación, el sistema le solicita al usuario que otorgue todos los permisos enumerados en el manifiesto de la aplicación. + + +

+ +

+ Nota: En dispositivos que ejecutan M Developer Preview, el usuario puede desactivar los permisos para cualquier aplicación (incluso para aplicaciones heredadas) desde la pantalla Settings de la aplicación. + + Si un usuario desactiva permisos para una aplicación heredada, el sistema desactiva las funciones correspondientes de forma automática. + Cuando la aplicación intenta realizar una operación que requiere ese permiso, la operación no generará necesariamente una excepción. + + En su lugar, devolverá un conjunto de datos vacíos, indicará un error o, de lo contrario, mostrará un comportamiento inesperado. + Por ejemplo, si realiza una consulta sobre el calendario sin permisos, el método devuelve un conjunto de datos vacíos. + +

+ +

+ Si instala una aplicación que utiliza el nuevo modelo de permisos en un dispositivo que no ejecuta la versión preliminar de Android M, el sistema la trata como cualquier otra aplicación: el sistema le pide al usuario, durante la instalación, que conceda los permisos declarados. + + + +

+ +

+ Nota: Para el lanzamiento de la versión preliminar, debe configurar la versión mínima del SDK en M Preview SDK para compilar con la versión del SDK preliminar. + Esto significa que no podrá probar dichas aplicaciones en plataformas anteriores durante la versión preliminar para desarrolladores. + + +

+ +

Permisos frente a intentos

+ +

+ En muchas situaciones, puede elegir entre dos formas para que sus aplicaciones realicen una tarea. + Puede hacer que su aplicación solicite permiso para realizar la operación por sí misma. + De lo contrario, puede hacer que la aplicación utilice un intento para que otra aplicación realice la tarea. + +

+ +

+ Por ejemplo, supongamos que su aplicación necesita poder tomar fotografías con la cámara del dispositivo. + Su aplicación puede solicitar el permiso +android.permission.CAMERA, lo que le permite a su aplicación acceder a la cámara directamente. + Entonces, su aplicación utilizará las API de la cámara para controlar la cámara y tomar una fotografía. + Este enfoque le otorga a su aplicación total control del proceso de fotografía y le permite incorporar la UI de la cámara en su aplicación. + + +

+ +

+ Sin embargo, si no necesita dicho control, puede utilizar {@link + android.provider.MediaStore#ACTION_IMAGE_CAPTURE ACTION_IMAGE_CAPTURE} para solicitar una imagen. + Cuando ejecute el intento, se le solicita al usuario que elija una aplicación de cámara (en caso de que no haya una aplicación de cámara predeterminada) y esa aplicación tomará la fotografía. + + La aplicación de cámara devuelve la fotografía al método {@link + android.app.Activity#onActivityResult onActivityResult()} de su aplicación. +

+ +

+ De manera similar, si necesita realizar una llamada telefónica, acceder a los contactos del usuario, etc., lo puede hacer creando intentos apropiados o puede solicitar los permisos e ingresar directamente a los objetos apropiados. + + Cada enfoque tiene ventajas y desventajas. + +

+ +

+ Si utiliza los permisos: +

+ + + +

+ Si utiliza un intento: +

+ + + +

Codificación para permisos de tiempo de ejecución

+ +

+ Si su aplicación tiene como destino el nuevo M Developer Preview, deberá usar el nuevo modelo de permisos. + Esto significa que, además de declarar los permisos necesarios en el manifiesto, también debe comprobar si tiene los permisos de tiempo de ejecución y solicitarlos en caso de no tenerlos. + + + +

+ +

+ Habilitar el nuevo modelo de permisos +

+ +

+ Para habilitar el nuevo modelo de permisos de M Developer Preview, configure el atributo +targetSdkVersion de la aplicación en "MNC" y +compileSdkVersion en "android-MNC". Al hacerlo, se habilitan todas las características de los nuevos permisos. + +

+ +

+ Para el lanzamiento de la versión preliminar, debe establecer minSdkVersion en +"MNC" para compilar con el SDK preliminar. +

+ +

+ Establecer un permiso solo para la versión preliminar de Android M +

+ +

+ Puede utilizar el nuevo elemento <uses-permission-sdk-m> en el manifiesto de la aplicación para indicar que se necesita un permiso solo para M Developer Preview. + Si declara un permiso de esta manera, cuando la aplicación se instale en un dispositivo anterior, el sistema no le solicitará al usuario el permiso ni se lo otorgará a la aplicación. Al usar el elemento <uses-permission-sdk-m>, puede añadir nuevos permisos a las versiones actualizadas de su aplicación sin forzar a los usuarios a otorgar permisos cuando instalen la actualización. + + + + + + +

+ +

+ Si la aplicación se ejecuta en un dispositivo con M Developer Preview, +<uses-permission-sdk-m> se comporta al igual que +<uses-permission>. + El sistema no le solicita al usuario que otorgue ningún permiso al instalar la aplicación y la aplicación solicita los permisos a medida que se necesiten. + +

+ +

+ Solicitar permisos +

+ +

+ Si su aplicación utiliza el nuevo modelo de permisos de M Developer Preview, no se le pedirá al usuario que otorgue todos los permisos cuando la aplicación se ejecute por primera vez en un dispositivo con la versión preliminar de Android M. + + En su lugar, su aplicación solicita los permisos a medida que los necesita. + Cuando su aplicación solicita un permiso, el sistema le muestra un diálogo al usuario. + +

+ +

+ Si su aplicación se ejecuta en un dispositivo con SDK 22 o anterior, la aplicación utiliza el modelo de permisos anterior. + Cuando el usuario instala la aplicación, se le solicita que otorgue todos los permisos que la aplicación requiere en su manifiesto, excepto aquellos permisos marcados con <uses-permission-sdk-m>. + + +

+ +

Controlar en qué plataforma se ejecuta la aplicación

+ +

+ Este modelo de permisos es compatible solamente con dispositivos que ejecutan M Developer Preview. + Antes de llamar a cualquiera de estos métodos, la aplicación debe verificar en qué plataforma se está ejecutando y, para hacerlo, se controla el valor de {@link android.os.Build.VERSION#CODENAME + Build.VERSION.CODENAME}. + + Si el dispositivo ejecuta M Developer Preview, +{@link android.os.Build.VERSION#CODENAME CODENAME} es "MNC". +

+ +

Controlar si la aplicación cuenta con los permisos necesarios

+ +

Cuando el usuario intenta realizar algo que requiere un permiso, la aplicación controla si ya tiene el permiso para realizar esa operación. + Para hacerlo, la aplicación llama a Context.checkSelfPermission( + +permission_name). La aplicación debe realizar este control incluso si sabe que el usuario ya ha concedido ese permiso, ya que el usuario puede revocar los permisos de una aplicación en cualquier momento. + + + Por ejemplo, si un usuario quiere usar una aplicación para tomar una fotografía, la aplicación llama a Context.checkSelfPermission(Manifest.permission.CAMERA). + +

+ +

+ Tabla 1. Permisos y grupo de permisos.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Grupo de permisosPermisos
android.permission-group.CALENDAR +
    +
  • + android.permission.READ_CALENDAR +
    • +
+
    +
  • + android.permission.WRITE_CALENDAR +
    • +
+
android.permission-group.CAMERA +
    +
  • + android.permission.CAMERA +
    • +
+
android.permission-group.CONTACTS +
    +
  • + android.permission.READ_CONTACTS +
    • +
  • + android.permission.WRITE_CONTACTS +
    • +
  • + android.permission.READ_PROFILE +
    • +
  • + android.permission.WRITE_PROFILE +
    • +
+
android.permission-group.LOCATION +
    +
  • + android.permission.ACCESS_FINE_LOCATION +
    • +
  • + android.permission.ACCESS_COARSE_LOCATION +
    • +
+
android.permission-group.MICROPHONE +
    +
  • + android.permission.RECORD_AUDIO +
    • +
+
android.permission-group.PHONE +
    +
  • + android.permission.READ_PHONE_STATE +
    • +
  • + android.permission.CALL_PHONE +
    • +
  • + android.permission.READ_CALL_LOG +
    • +
  • + android.permission.WRITE_CALL_LOG +
    • +
  • + com.android.voicemail.permission.ADD_VOICEMAIL +
    • +
  • + android.permission.USE_SIP +
    • +
  • + android.permission.PROCESS_OUTGOING_CALLS +
    • +
+
android.permission-group.SENSORS +
    +
  • + android.permission.BODY_SENSORS +
    • +
+
    +
  • + android.permission.USE_FINGERPRINT +
    • +
+
android.permission-group.SMS +
    +
  • + android.permission.SEND_SMS +
    • +
  • + android.permission.RECEIVE_SMS +
    • +
  • + android.permission.READ_SMS +
    • +
  • + android.permission.RECEIVE_WAP_PUSH +
    • +
  • + android.permission.RECEIVE_MMS +
    • +
  • + android.permission.READ_CELL_BROADCASTS +
    • +
+
+ +

Solicitar permisos si se necesitan

+ +

Si la aplicación no posee los permisos que necesita, llama al método +Activity.requestPermissions(String[], int) para solicitar el permiso o los permisos apropiados. + La aplicación pasa el permiso o los permisos que necesita y un “código de solicitud” entero. + + Este método funciona de manera asincrónica: realiza la devolución inmediatamente y cuando el usuario responde a la ventana de diálogo, el sistema llama al método de devolución de llamada de la aplicación con los resultados, y pasa el mismo “código de solicitud” que pasó la aplicación a +requestPermissions(). + +

+ +

El siguiente código verifica si la aplicación tiene permisos para leer los contactos del usuario y solicita los permisos de ser necesario: +

+ +
+if (checkSelfPermission(Manifest.permission.READ_CONTACTS)
+        != PackageManager.PERMISSION_GRANTED) {
+    requestPermissions(new String[]{Manifest.permission.READ_CONTACTS},
+            MY_PERMISSIONS_REQUEST_READ_CONTACTS);
+
+    // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
+    // app-defined int constant
+
+    return;
+}
+
+ +

Administrar la respuesta a la solicitud de permisos

+ +

+ Cuando una aplicación solicita permisos, el sistema le muestra al usuario una ventana de diálogo. + Cuando el usuario responde, el sistema invoca +Activity.onRequestPermissionsResult(int, String[], int[]) + de su aplicación y le transfiere la respuesta del usuario. Su aplicación necesita invalidar ese método. La devolución de llamada pasa el mismo código de solicitud que usted pasó a requestPermissions(). + + Por ejemplo, si una aplicación solicita acceso READ_CONTACTS, es posible que tenga el siguiente método de devolución de llamada: + + +

+ +
+@Override
+public void onRequestPermissionsResult(int requestCode,
+        String permissions[], int[] grantResults) {
+    switch (requestCode) {
+        case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {
+            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+
+                // permission was granted, yay! do the
+                // calendar task you need to do.
+
+            } else {
+
+                // permission denied, boo! Disable the
+                // functionality that depends on this permission.
+            }
+            return;
+        }
+
+        // other 'switch' lines to check for other
+        // permissions this app might request
+    }
+}
+
+ +

Si el usuario concede un permiso, el sistema le otorga a la aplicación todos los permisos enumerados en el manifiesto para esa área funcional. + Se deben tomar acciones apropiadas si el usuario rechaza la solicitud. + Por ejemplo, usted podría desactivar cualquier acción del menú que dependa de este permiso. + + +

+ +

+ Cuando el sistema le solicita al usuario que otorgue un permiso, el usuario tiene la opción de indicarle al sistema que no solicite ese permiso de nuevo. + En ese caso, cuando la aplicación utiliza requestPermissions() para solicitar ese permiso, el sistema rechaza la solicitud inmediatamente. + + En este caso, el sistema llama a su onRequestPermissionsResult() de la misma manera en que lo haría si el usuario hubiese rechazado explícitamente su solicitud nuevamente. + + Por esta razón, su aplicación no puede asumir que se ha llevado a cabo algún tipo de interacción con el usuario. + +

+ +

Prueba de permisos de tiempo de ejecución

+ + +

+ Si su aplicación tiene como destino M Developer Preview, debe probar que administre los permisos correctamente. + No debe asumir que su aplicación tiene algún permiso en particular cuando se ejecuta. + Cuando la aplicación se ejecuta por primera vez, es muy probable que no tenga permisos y el usuario puede revocar o reestablecer los permisos en cualquier momento. + + +

+ +

+ Debe probar su aplicación para asegurarse de que funciona correctamente en todas las situaciones de permisos. + Con el SDK de la versión preliminar de Android M, hemos brindado nuevos comandos Android Debug Bridge (adb) que le permitirán probar su aplicación con cualquier configuración de permisos que necesite probar. + + + +

+ +

+ Nuevas opciones y comandos adb +

+ +

+ Las herramientas de plataforma del SDK de la versión preliminar de Android M contienen varios comandos nuevos que le permiten probar la manera en que su aplicación administra los permisos. + +

+ +

+ Instalar con permisos +

+ +

+ Puede utilizar la nueva opción -g del comando adb + install, que instala la aplicación y concede todos los permisos enumerados en el manifiesto de la aplicación: + +

+ +
+$ adb install -g <path_to_apk>
+
+ +

+ Conceder y revocar permisos +

+ +

+ Puede utilizar los comandos ADB nuevos package manager (pm) para conceder y revocar permisos a una aplicación instalada. Esta funcionalidad puede resultar útil para pruebas automáticas. + + +

+ +

+ Para conceder un permiso, utilice el comando grant de package manager: +

+ +
+$ adb pm grant <package_name> <permission_name>
+
+ +

+ Por ejemplo, para conceder el paquete de permisos com.example.myapp para grabar audio utilice este comando: + +

+ +
+$ adb pm grant com.example.myapp android.permission.RECORD_AUDIO
+
+ +

+ Para revocar un permiso, utilice el comando revoke de package manager: +

+ +
+$ adb pm revoke <package_name> <permission_name>
+
+ +

Mejores prácticas

+ +

+ El nuevo modelo de permisos brinda a los usuarios una experiencia más fluida y les facilita la instalación de aplicaciones, además de hacerlos sentir cómodos con las actividades de sus aplicaciones. + + Sugerimos las siguientes mejores prácticas para obtener el mayor beneficio del nuevo modelo. + +

+ + +

Solicite solo los permisos que necesite

+ +

+ Cada vez que solicite un permiso, usted obliga al usuario a tomar una decisión. + La funcionalidad de su aplicación se verá reducida si el usuario rechaza la solicitud. + Debe minimizar la cantidad de veces que realiza estas solicitudes. +

+ +

+ Por ejemplo, a menudo, su aplicación puede obtener la funcionalidad necesaria a través de un intento en lugar de una solicitud de permiso. + + Si su aplicación necesita tomar fotografías con la cámara del teléfono, la aplicación puede utilizar un intento {@link + android.provider.MediaStore#ACTION_IMAGE_CAPTURE + MediaStore.ACTION_IMAGE_CAPTURE}. + Cuando su aplicación ejecuta el intento, el sistema le solicita al usuario que elija una aplicación para la cámara que ya está instalada a fin de tomar la fotografía. + + +

+ +

+ No abrume al usuario +

+ +

+ Si expone al usuario a muchas solicitudes de permisos al mismo tiempo, lo abrumará y hará que deje de usar su aplicación. Por el contrario, debe pedir permisos en la medida que los necesite. + + +

+ +

+ A veces, uno o más permisos pueden ser absolutamente necesarios para la aplicación. En ese caso, es recomendable pedir todos los permisos no bien se inicie la aplicación. + + Por ejemplo, si crea una aplicación de fotografía, la aplicación necesitará acceso a la cámara del dispositivo. + Cuando el usuario inicie la aplicación por primera vez, no se sorprenderá si la aplicación le solicita permiso para usar la cámara. + + Sin embargo, si la misma aplicación además tuviese una característica para compartir fotografías con los contactos del usuario, no solicite ese permiso la primera vez que se ejecute. + + En su lugar, espere hasta que el usuario utilice la característica “compartir” para solicitar el permiso en ese momento. + +

+ +

+ Si su aplicación proporciona un tutorial, se recomienda que se pidan los permisos esenciales de la aplicación al final del tutorial. + +

+ +

+ Explique por qué se necesitan los permisos +

+ +

+ El diálogo de permisos que muestra el sistema cuando llama a + requestPermissions() informa qué permisos necesita su aplicación pero no establece el motivo. + A veces, el usuario puede confundirse. + Es una buena idea explicarle al usuario los motivos por los que la aplicación necesita esos permisos antes de llamar a requestPermissions(). + +

+ +

+ Por ejemplo, una aplicación de fotografía puede solicitar servicios de ubicación para añadir una etiqueta geográfica a las fotografías. + Es posible que un usuario típico no sepa que una fotografía puede contener información sobre la ubicación y se confundiría si una aplicación de fotografía solicita la ubicación. + + En este caso, es recomendable que la aplicación le informe al usuario acerca de esta característica antes de llamar a +requestPermissions(). + +

+ +

+ Una forma de hacerlo es incorporar estas solicitudes en el tutorial de la aplicación. El tutorial puede mostrar todas las características de la aplicación, una por vez, y mientras lo hace explicar los permisos que son necesarios. + + Por ejemplo, el tutorial de la aplicación de fotografía puede mostrar la característica “compartir fotografías con contactos” y luego explicarle al usuario que debe otorgar permisos para que la aplicación vea los contactos del usuario. + + + La aplicación puede entonces llamar a requestPermissions() para solicitarle al usuario ese acceso. + Por supuesto, no todos los usuarios siguen el tutorial, por lo que aun así debe controlar y solicitar los permisos durante el funcionamiento normal de la aplicación. + + +

diff --git a/docs/html-intl/intl/es/preview/overview.jd b/docs/html-intl/intl/es/preview/overview.jd new file mode 100644 index 0000000000000..49cc3d3ea952c --- /dev/null +++ b/docs/html-intl/intl/es/preview/overview.jd @@ -0,0 +1,362 @@ +page.title=Información general del programa +page.metaDescription=Bienvenido a Android M Developer Preview, el programa que le brinda todo lo que necesita para probar y optimizar sus aplicaciones para la próxima versión de Android. +page.image=images/cards/card-preview_16-9_2x.png +page.tags="preview", "developer", "android" + +@jd:body + +

+ Bienvenido a Android M Developer Preview, el programa que le brinda todo lo que necesita para probar y optimizar sus aplicaciones para la próxima versión de Android. + + Es gratis y puede comenzar a utilizarlo ahora mismo. Solo tiene que descargar las herramientas de M Developer Preview. + +

+ +
+
+
+
+
+ Imágenes del sistema emulador y de hardware +
+ +

+ Ejecute y pruebe sus aplicaciones en Nexus 5, 6, 9 y Player (para TV), además del emulador. + +

+
+ +
+
+ Último código de la plataforma +
+ +

+ Durante la versión preliminar, ofreceremos múltiples actualizaciones, por lo que usted realizará la prueba comparando los últimos cambios de la plataforma. + +

+
+ +
+
+ Actualizaciones vía OTA +
+ +

+ Luego de actualizar su dispositivo a la versión preliminar inicial, usted podrá obtener actualizaciones por red inalámbrica (over-the-air, OTA). + +

+
+
+ +
+ + +
+
+ Nuevos comportamientos y capacidades +
+ +

+ Inicie el funcionamiento con anticipación para admitir los comportamientos de la nueva plataforma como el nuevo modelo de permisos de tiempos de ejecución y las opciones de ahorro de energía. + +

+
+ +
+
+ Ventana de prioridad para los problemas informados por los desarrolladores +
+ +

+ Durante las primeras semanas, daremos prioridad a los problemas informados por los desarrolladores; por lo tanto, realice las pruebas y envíe sus comentarios lo antes posible. + +

+
+ +
+
+ Comentarios y soporte +
+ +

+ Infórmenos los problemas y envíenos comentarios a través de nuestro seguimiento de problemas. + Póngase en contacto con otros desarrolladores de la comunidad M Developer Community. + +

+
+
+
+
+ + + + +

+ Escala de tiempo y actualizaciones +

+Preview program timeline +

+ M Developer Preview estará disponible a partir del 28 de mayo hasta la versión final del SDK de Android M, que lanzaremos al poco tiempo del lanzamiento público durante el tercer trimestre de 2015. + + +

+ +

+ En momentos clave del desarrollo, lanzaremos actualizaciones para sus dispositivos de prueba. + Los momentos clave tentativos son los siguientes: +

+ + + +

+ Estas actualizaciones terminan con el SDK final (más adelante durante el tercer trimestre), lo que proporcionará tanto las API oficiales para la nueva versión de Android como los comportamientos y las características finales del sistema. + + +

+ +

+ A medida que usted prueba y desarrolla en Android M, le recomendamos que mantenga su entorno de desarrollo actualizado a medida que se lanzan las actualizaciones de la versión preliminar. + + Para que el proceso sea más fácil, lanzaremos actualizaciones OTA para los dispositivos que ya hayan sido actualizados a una compilación de la versión preliminar y brindaremos imágenes del sistema que puede descargar y actualizar manualmente. + + +

+

+ Nota: El SDK final y las imágenes del sistema no se pueden proporcionar vía OTA y deberán actualizarse manualmente en sus dispositivos de prueba. + + +

+ +

+ Le informaremos cuando las actualizaciones de la versión preliminar se encuentren disponibles a través del blog de Android para desarrolladores (Android Developers Blog), de este sitio y de la comunidad de desarrolladores Android M Developer Community. + + +

+ +

+ ¿Qué ofrece la versión preliminar? +

+ +

+ M Developer Preview incluye todo lo que necesita para probar sus aplicaciones actuales en una variedad de tamaños de pantalla, de tecnologías de redes, de conjuntos de chip CPU/GPU y de arquitecturas de hardware. + + +

+ +

+ Herramientas del SDK +

+ +

+ Estos componentes se pueden descargar mediante SDK Manager en Android Studio: +

+ + + +

+ Imágenes del sistema de hardware +

+ +

+ Puede descargar estas imágenes del sistema de hardware para dispositivos Nexus desde la página de Descargas: + +

+ + + +

+ Documentación y código de muestra +

+ +

+ Estos recursos de documentación lo ayudan a obtener información sobre la versión preliminar: +

+ + + +

+ Recursos de soporte +

+ +

+ Utilice los siguientes recursos de soporte durante el proceso de prueba y desarrollo en M Developer Preview: + +

+ + + + +

+ Selección del destino, API preliminares y publicación +

+ +

+ Android M Developer Preview es una versión solo para desarrollo y no tiene un nivel de API estándar. + Si quiere darse de baja de los comportamientos de compatibilidad para probar su aplicación (lo que es muy recomendado), puede elegir como destino M Developer Preview estableciendo targetSdkVersion de su aplicación como “MNC”. + + + +

+ +

+ Android M Developer Preview ofrece API preliminares + — las API no serán oficiales hasta que se lance el SDK final, lo que actualmente está planeado para el tercer trimestre de 2015. + Esto quiere decir que surgirán cambios menores en la API con el tiempo, particularmente durante las primeras semanas del programa. + + Con cada actualización de Android M Developer Preview, proporcionaremos un resumen con los cambios realizados. + +

+ +

+ Tenga en cuenta que aunque las API preliminares pueden modificarse, los comportamientos del sistema subyacente, como los permisos de tiempo de ejecución y las opciones de ahorro de energía, se mantienen estables y disponibles para cualquier prueba inmediata. + + +

+ +

+ En cuanto a la publicación, Google Play no permite que se publiquen aplicaciones que tienen como destino M Developer Preview. + Una vez que el SDK final de Android M esté disponible, podrá seleccionar como destino el nivel de API oficial de Android M y publicar su aplicación en Google Play. + + Mientras tanto, si desea distribuir una aplicación con Android M como destino a otros evaluadores, lo puede hacer por correo electrónico o mediante descarga directa desde su sitio. + + +

+ +

+ ¿Cómo comenzar? +

+ +

+ Para comenzar a probar su aplicación: +

+ +
    +
  1. Revise el artículo Información general de la API y Cambios en los comportamientos para obtener una idea sobre las novedades y cómo estas pueden afectar sus aplicaciones. + + En especial, infórmese sobre el nuevo modelo de permisos de tiempo de ejecución, las opciones de ahorro de energía y las copias de seguridad automáticas. + + +
    2. + +
  2. Configure su entorno siguiendo las instrucciones para Configurar el SDK de la versión preliminar y configurar los dispositivos de prueba. + + +
    3. + +
  3. Siga las instrucciones de actualización para actualizar la última imagen del sistema del desarrollador de Android M para Nexus 5, 6, 9 y Player. + + Cuando haya actualizado su dispositivo de desarrollo, recibirá las actualizaciones de la versión preliminar mediante actualizaciones OTA. + +
    4. + +
  4. Descargue la Referencia de la API de M Preview y los Ejemplos de M Preview para obtener más información sobre las nuevas características de la API y sobre cómo utilizarlas en su aplicación. + + + +
    5. + +
  5. Únase a la comunidad Android M Developer Community para recibir las últimas noticias y para contactarse con otros desarrolladores que estén trabajando con la nueva plataforma. + + +
    6. +
+ +

+ ¡Agradecemos su participación en el programa Android M Developer Preview! +

diff --git a/docs/html-intl/intl/ja/preview/api-overview.jd b/docs/html-intl/intl/ja/preview/api-overview.jd new file mode 100644 index 0000000000000..2c0816b54605a --- /dev/null +++ b/docs/html-intl/intl/ja/preview/api-overview.jd @@ -0,0 +1,521 @@ +page.title=API の概要 +page.keywords=プレビュー,sdk,互換性 +page.tags=previewresources, androidm sdk.platform.apiLevel=22-mnc +page.image=images/cards/card-api-overview_16-9_2x.png +@jd:body + + + +
+ +
+ +

M Developer Preview では、ユーザーやアプリ開発者に Android プラットフォームの次期リリースの新機能をいち早く試していただくことができます。 + +このドキュメントでは、いくつかの注目すべき API の概要について説明します。

+ +

M Developer Preview は、Developer の早期導入者とテスターを対象としています。 +是非 +M Developer Preview を試してフィードバックをご提供ください。あなたのご意見が、Android フレームワークの方向性を決定する上で貴重な情報になります。 + +

+ +

注意: M Developer Preview を使用したアプリは、Google Play ストアには公開しないでください。 +

+ +

注: このドキュメントには、まだ developer.android.com のリファレンス マテリアルにないクラスやメソッドが多数登場します。 +このドキュメントでは、API エレメントは {@code code style} 形式で記載されています（ハイパーリンクなし）。 +これらのエレメントに関する API ドキュメント（準備段階）については、プレビューのリファレンスをダウンロードしてください。 +

+ +

重要な動作の変更点

+ +

過去に Android にアプリを公開したことがある場合は、アプリがプラットフォームの変更による影響を受ける場合があります。 +

+ +

詳細については、Behavior Changes をご覧ください。

+ +

アプリのリンク機能

+

このプレビューでは、アプリのリンク機能を強化することで Android のインテント システムが向上しました。この機能では、所有するウェブドメインにアプリを関連付けることができます。 +この関連付けに基づいて、プラットフォームが特定のウェブリンクの処理に使用するデフォルトのアプリを決めることができ、ユーザーにアプリを選択させる操作をスキップできます。この機能の実装方法については、 +アプリのリンク機能をご覧ください。 + + + +

アプリの自動バックアップ

+

システムで、アプリの自動フルデータ バックアップと復元を実行できるようになりました。この動作は、M Preview を対象としたアプリでデフォルトで有効になっています。追加のコードは必要ありません。 +ユーザーが Google アカウントを削除すると、バックアップ データも削除されます。 +この機能の仕組みとファイル システムでバックアップ対象を設定する方法については、 +アプリの自動バックアップをご覧ください。 +

+ +

認証

+

このプレビューでは、サポートされる端末での指紋スキャンを使用したユーザー認証や、端末のロック解除メカニズム（ロック画面のパスワードなど）を使って最後にユーザーが認証された時期の確認などを行える新しい API が提供されます。 + +これらの API は、Android キーストローク システムと共に使用します。 +

+ +

指紋認証

+ +

指紋スキャンでユーザーを認証するには、新しい +{@code android.hardware.fingerprint.FingerprintManager} クラスのインスタンスを取得して、 +{@code FingerprintManager.authenticate()} メソッドを呼び出します。アプリは、指紋センサー付きの、互換性のある端末上で実行している必要があります。 +指紋認証フローのユーザー インターフェースをアプリに実装し、UI には標準の Android 指紋アイコンを使用する必要があります。Android 指紋アイコン（{@code c_fp_40px.png}）はサンプルアプリに含まれています。指紋認証を使用するアプリを複数開発する場合は、それぞれのアプリで個別にユーザーの指紋を認証する必要があります。 + + + + +

+ +

アプリでこの機能を使用するには、まずマニフェストに {@code USE_FINGERPRINT} パーミッションを追加する必要があります。 +

+ +
+<uses-permission
+        android:name="android.permission.USE_FINGERPRINT" />
+
+ + + +

アプリでの指紋認証の実装については、 +指紋ダイアログのサンプルをご覧ください。 +

+ +

この機能をテストする場合は、次の手順を使用します。

+
    +
  1. Android SDK Tools Revision 24.3 をインストールします（まだインストールしていない場合）。
    2. +
  2. +[設定] > [セキュリティ] > [指紋] の登録手順に従い、エミュレータに新しい指紋を登録します。
    3. +
  3. エミュレータを使って、次のコマンドで指紋のタッチ ベントをエミュレートします。 +同じコマンドを使って、ロック画面やアプリでの指紋のタッチイベントをエミュレートします。 + +
    +adb -e emu finger touch <finger_id>
+
    +

    Windows では、{@code telnet 127.0.0.1 <emulator-id>}、 +{@code finger touch <finger_id>} の順に実行する必要がある場合があります。 +

    +
    4. +
+ +

資格情報の確認

+

アプリでは、ユーザーがいつ、最後に端末のロックを解除したかに基づいて、ユーザーを認証できます。この機能によって、ユーザーがアプリ固有のパスワードを覚えたり、開発者が独自の認証ユーザー インターフェースを実装したりする必要性がなくなります。 + +アプリでこの機能を使用する場合は、ユーザー認証用の公開鍵か秘密鍵を実装する必要があります。 +

+ +

ユーザーが正常に認証された後、同じキーを再使用できるタイムアウト期間を設定するには、{@link javax.crypto.KeyGenerator} か +{@link java.security.KeyPairGenerator} のセットアップ後に新しい +{@code android.security.keystore.KeyGenParameterSpec.setUserAuthenticationValidityDurationSeconds()} メソッドを呼び出します。 + +現在、この機能は対象暗号化操作で動作します。 +

+ +

再認証ダイアログを過度に表示しないようにします。アプリでは、まず暗号オブジェクトを使用し、タイムアウトした場合は +{@link android.app.KeyguardManager#createConfirmDeviceCredentialIntent(java.lang.CharSequence, java.lang.CharSequence) createConfirmDeviceCredentialIntent()} メソッドを使用してユーザーをアプリ内で再認証するようにします。 + + +

+ +

アプリでのこの機能の実装については、 +資格情報の確認サンプルをご覧ください。 +

+ +

ダイレクト シェア

+ + + +

このプレビューでは、ユーザーが直感的にすばやく共有できるようにする API が提供されます。アプリで特定のアクティビティを起動するダイレクト シェアのターゲットを定義すると、それらのダイレクト シェアのターゲットは [共有] メニューに表示されるようになります。 + +この機能を使うと、他のアプリ内にある連絡先などのターゲットにコンテンツを共有できます。 +たとえば、ダイレクト シェアのターゲットによって他のソーシャル ネットワーク アプリのアクティビティが起動し、そのアプリ内の特定の友人やコミュニティに直接コンテンツを共有できるようになります。 + +

+ +

ダイレクト シェアのターゲットを有効にするには、まず +{@code android.service.} を拡張するクラスを定義する必要があります。
+{@code chooser.ChooserTargetService} クラス。マニフェストで +{@code ChooserTargetService} を宣言します。その宣言内で、 +{@code BIND_CHOOSER_TARGET_SERVICE} パーミッションと、 +{@code SERVICE_INTERFACE} アクションを使ったインテント フィルタを指定します。

+

次の例は、マニフェストで {@code ChooserTargetService} を宣言する方法を示しています。 +

+
+<service android:name=".ChooserTargetService"
+        android:label="@string/service_name"
+        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
+    <intent-filter>
+        <action android:name="android.service.chooser.ChooserTargetService" />
+    </intent-filter>
+</service>
+
+ +

{@code ChooserTargetService} に公開するアクティビティごとに、 {@code "android.service.chooser.chooser_target_service"} という名前の +{@code <meta-data>} 要素をアプリのマニフェストに追加します。 + +

+ +
+<activity android:name=".MyShareActivity”
+        android:label="@string/share_activity_label">
+    <intent-filter>
+        <action android:name="android.intent.action.SEND" />
+    </intent-filter>
+<meta-data
+        android:name="android.service.chooser.chooser_target_service"
+        android:value=".ChooserTargetService" />
+</activity>
+
+ +

音声インタラクション

+

+このプレビューでは、音声アクションと共に使用することでアプリに対話形式の音声操作をビルドできる新しい音声インタラクション API が提供されます。 + + +{@code android.app.Activity.isVoiceInteraction()} メソッドを呼び出して、アクティビティが音声アクションへの応答として開始されたかどうかを確認します。 +音声アクションへの応答であった場合、アプリで +{@code android.app.VoiceInteractor} クラスを使用してユーザーに音声の確認や、オプションのリストからの選択などを要求できます。 +音声アクションの実装の詳細については、 +音声アクションの開発者サイトをご覧ください。 +

+ +

Assist API

+

+このプレビューでは、アシスタントを介してユーザーがアプリを操作できる新しい方法が用意されています。この機能を使用するには、ユーザーが現在のコンテキストを使うようアシスタントを有効にする必要があります。 +有効にすると、ホーム ボタンを長押しすることで、すべてのアプリ内でアシスタントを呼び出すことができます。 +

+

+{@link android.view.WindowManager.LayoutParams#FLAG_SECURE} フラグを設定すると、アプリが現在のコンテキストをアシスタントと共有しないようにできます。新しい {@code android.app.Activity.AssistContent} クラスを使用すると、プラットフォームがアシスタントに渡す標準的な情報セットの他に、アプリで追加の情報を共有できます。 + +

+ +

アプリから追加のコンテキストをアシスタントに提供するには、次の手順を使用します。

+ +
    +
  1. {@link android.app.Application.OnProvideAssistDataListener} インターフェースを実装します。
    2. +
  2. +{@link android.app.Application#registerOnProvideAssistDataListener(android.app.Application.OnProvideAssistDataListener) registerOnProvideAssistDataListener()} を使用してこのリスナーを登録します。
    3. +
  3. アクティビティ固有の文脈情報を提供するには、 +{@link android.app.Activity#onProvideAssistData(android.os.Bundle) onProvideAssistData()} コールバックと、任意で新しい +{@code Activity.onProvideAssistContent()} コールバックをオーバーライドします。 +
+ +

通知

+

このプレビューでは、通知に関して次のような API の変更点が追加されています。

+ + +

Bluetooth スタイラスのサポート

+

このプレビューでは、Bluetooth スタイラスを使用したユーザー入力のサポートが強化されました。互換性のある Bluetooth スタイラスと電話やタブレットをペアリングして接続できます。 +接続されている間、タッチスクリーンからの位置情報とスタイラスからの筆圧やボタン情報を合わせることで、タッチスクリーン単独の場合よりも表現の幅が大きく広がります。 + +新しい +{@code View.onStylusButtonPressListener} コールバックと {@code GestureDetector.OnStylusButtonPressListener} コールバックをアクティビティに登録すると、スタイラスのボタンが押されたことをアプリがリッスンし、次のアクションを実行できるようになります。 + +

+ +

スタイラスのボタン操作を検出するには、{@link android.view.MotionEvent} メソッドと定数を使用します。 +

+ + +

Bluetooth Low Energy のスキャンの改善

+

+アプリで Bluetooth Low Energy スキャンを実行する場合は、新しい +{@code android.bluetooth.le.ScanSettings.Builder.setCallbackType()} メソッドを使って、設定された +{@link android.bluetooth.le.ScanFilter} に一致する宣伝パケットが最初に見つかったときと、それが長期間見つからない場合に通知する目的でのみコールバックが必要であると指定できます。 + +このスキャン アプローチは、以前のプラットフォーム バージョンで提供されていたものよりもはるかに効率的です。 + +

+ +

アクセス ポイント 2.0 リリース 1 のサポート

+

+このプレビューでは、Nexus 6 と Nexus 9 端末のアクセス ポイント2.0 Release 1 仕様のサポートが追加されました。アクセス ポイント 2.0 の資格情報をアプリに提供するには、 +{@code setPlmn()} や {@code setRealm()} などの +{@link android.net.wifi.WifiEnterpriseConfig} クラスの新しいメソッドを使用します。 +{@link android.net.wifi.WifiConfiguration} オブジェクトで、 +{@link android.net.wifi.WifiConfiguration#FQDN} フィールドと {@code providerFriendlyName} フィールドを設定できます。新しい {@code ScanResult.PasspointNetwork} プロパティは、検出されたネットワークがアクセス ポイント 2.0 のアクセス ポイントを表しているかどうかを示します。 + + +

+ +

4K ディスプレイ モード

+

互換性のあるハードウェアで、ディスプレイの解像度を 4K レンダリングにアップグレードするようアプリから要求できるようになりました。 +現在の物理的解像度を照会するには、新しい +{@code android.view.Display.Mode} API を使用します。UI が低い論理的解像度で描画されていて、より高い物理的解像度にアップスケールされた場合は、 +{@code Display.Mode.getPhysicalWidth()} メソッドが返す物理的解像度が {@link android.view.Display#getSize(android.graphics.Point) getSize()} で報告される論理的解像度と異なる場合があります。 + +

+ +

アプリ ウィンドウの +{@code WindowManager.LayoutParams.preferredDisplayModeId} プロパティを設定することで、アプリの実行時に物理的解像度を変更するようシステムに要求できます。この機能は、4K ディスプレイの解像度に切り替えたい場合に便利です。 +4K ディスプレイ モード中、UI は引き続き元の解像度（1080p など）で表示され、4K にアップスケールされますが、 +{@link android.view.SurfaceView} オブジェクトではコンテンツをネイティブの解像度で表示する場合があります。 +

+ +

テーマ化可能な ColorStateLists

+

M Preview を実行する端末で、テーマの属性が +{@link android.content.res.ColorStateList} でサポートされるようになりました。 +{@link android.content.res.Resources#getColorStateList(int) getColorStateList()} メソッドと +{@link android.content.res.Resources#getColor(int) getColor()} メソッドは廃止されました。これらの API を呼び出す場合は、代わりに新しい {@code Context.getColorStateList()} メソッドか +{@code Context.getColor()} メソッドを呼び出します。 +これらのメソッドは、{@link android.support.v4.content.ContextCompat} の v4 appcompat ライブラリにもあります。 +

+ +

オーディオ機能

+ +

このプレビューでは、次のように Android でのオーディオ処理が改善されました。

+ + +

ビデオ機能

+

このプレビューでは、ビデオ処理の API に次のような新機能が追加されました。

+ + +

カメラ機能

+

このプレビューでは、カメラのフラッシュやカメラによる画像の再処理にアクセスするための新しい API が用意されています。 +

+ +

Flashlight API

+

カメラ端末にフラッシュ ユニットが付属している場合は、{@code CameraManager.setTorchMode()} メソッドを呼び出すことで、カメラ端末を開かずにフラッシュ ユニットのタッチモードのオン/オフを切り替えることができます。 +アプリには、フラッシュ ユニットやカメラ端末のフラッシュの独占所有権はありません。 +トーチモードは、カメラ端末が利用不可になったときや、トーチを付けている他のカメラリソースが利用不可になったときにオフになり、利用できなくなります。 + +他のアプリでも {@code setTorchMode()} を呼び出してトーチモードをオフにできます。 +最後にトーチモードをオンにしたアプリが閉じられると、トーチモードはオフになります。 +

+ +

+{@code CameraManager.registerTorchCallback()} メソッドを呼び出すことで、トーチモードの状態に関する通知を受けるようコールバックを登録できます。コールバックを初めて登録したときに、現在検知されているすべてのフラッシュ ユニット付きのカメラ端末のトーチモードの状態が即座に呼び出されます。 + +トーチモードが正常にオン/オフされると、 +{@code CameraManager.TorchCallback.onTorchModeChanged()} メソッドが呼び出されます。

+ +

Reprocessing API

+

{@link android.hardware.camera2 Camera2} API は、YUV とプライベートな不透明形式の画像の再処理をサポートするよう拡張されました。 +アプリは、再処理機能が利用可能かどうかを {@code CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES} 経由で確認します。 +端末が再処理をサポートしている場合は、 +{@code CameraDevice.createReprocessableCaptureSession()} を呼び出して再処理可能なカメラ撮影セッションを作成し、入力バッファの再処理の要求を作成できます。 + +

+ +

入力バッファのフローをカメラの再処理入力に接続するには、{@code ImageWriter} クラスを使用します。 +空のバッファを取得するには、次のプログラミング モデルを使用します。

+ +
    +
  1. {@code ImageWriter.dequeueInputImage()} メソッドを呼び出します。
    2. +
  2. 入力バッファにデータを入力します。
    3. +
  3. {@code ImageWriter.queueInputImage()} メソッドを呼び出して、バッファをカメラに送ります。
    4. +
+ +

{@code ImageWriter} オブジェクトを +{@code android.graphics.ImageFormat.PRIVATE} 画像と共に使用する場合、アプリから直接画像データにアクセスすることはできません。 +代わりに、{@code ImageWriter.queueInputImage()} メソッドをバッファコピーなしで呼び出して、{@code ImageFormat.PRIVATE} 画像を直接 +{@code ImageWriter} に渡します。 +

+ +

{@code ImageReader} クラスで {@code android.graphics.ImageFormat.PRIVATE} 形式の画像ストリームがサポートされるようになりました。 +これにより、アプリが +{@code ImageReader} 出力画像の循環的な画像のキューを維持でき、1 つ以上の画像を選択して、それらをカメラの再処理用に +{@code ImageWriter} に送ることができます。

+ +

Android for Work の機能

+

このプレビューには、次のような Android for Work 用の新しい API が含まれています。

+ + +

+ M Developer Preview のすべての API の変更点の詳細については、API Differences Report をご覧ください。 +

diff --git a/docs/html-intl/intl/ja/preview/behavior-changes.jd b/docs/html-intl/intl/ja/preview/behavior-changes.jd new file mode 100644 index 0000000000000..a7950a1ad0d0d --- /dev/null +++ b/docs/html-intl/intl/ja/preview/behavior-changes.jd @@ -0,0 +1,402 @@ +page.title=動作の変更点 +page.keywords=プレビュー,sdk,compatibility +sdk.platform.apiLevel=MNC +@jd:body + +
+ +
+ +

M Developer Preview には、新機能以外にもさまざまなシステムの変更点や API の動作の変更点が盛り込まれています。 +このドキュメントでは、アプリ開発において把握しておくべき主な変更点について説明します。 +

+ +

過去に Android にアプリを公開したことがある場合は、アプリがこれらの変更による影響を受ける場合があることに注意してください。 +

+ +

実行時パーミッション

+

このプレビューでは、アプリのパーミッションを実行時にユーザーが直接管理できる新しいパーミッション モデルが採用されました。 +このモデルによって、ユーザーに対するパーミッションの可視性と制御性が向上し、アプリ開発者にとってはアプリのインストールや自動アップデート プロセスの効率が上がります。ユーザーはインストール済みアプリのパーミッションを個別に付与したり取り消したりできます。 + +

+ +

M Preview を対象としたアプリでは、必ずパーミッションを実行時に確認、要求するようにします。 +アプリにパーミッションが付与されているかどうかを確認するには、新しい {@code Context.checkSelfPermission()} メソッドを呼び出します。 +パーミッションを要求するには、新しい +{@code Activity.requestPermission()} メソッドを呼び出します。アプリが M を対象としていない場合でも、新しいパーミッション モデルでアプリをテストするようにしてください。 +

+ +

アプリで新しいパーミッションをサポートする際の詳細については、Developer Preview ページの +Permissions をご覧ください。 +アプリへの影響を評価する際のヒントについては、Testing Guide をご覧ください。 +

+ +

省電力の最適化

+

このプレビューでは、アイドル中の端末やアプリに対する新しい省電力の最適化機能が採用されています。

+ +

Doze

+

端末が電源に接続されておらず、画面が一定時間オフ状態の場合は Doze モードに入り、システムをスリープ状態に保ちます。 +このモードでは、端末は定期的に通常の操作を短時間再開することで、アプリを同期したり、システムが保留中の操作を行ったりすることができます。 + +

+ +

Doze 中は、アプリに次の制限が適用されます。

+ +

+

端末が Doze モードでなくなると、保留中のすべての同期とジョブが実行されます。

+

この機能をテストするには、M Preview を実行する端末を開発マシンに接続して、次のコマンドを呼び出します。 + +

+
+$ adb shell dumpsys battery unplug
+$ adb shell dumpsys deviceidle step
+$ adb shell dumpsys deviceidle -h
+
+

注: +Google Cloud Messaging の次期リリースでは、高優先度のメッセージを指定できます。 + +アプリが高優先度の GCM メッセージを受信する場合は、端末が Doze 中でも短時間のネットワーク アクセスが付与されます。 + +

+ +

アプリで Doze をテストする方法のヒントについては、 +Testing Guide をご覧ください。 +

+ +

App Standby

+

このプレビューでは、アクティブに使用されていないアプリをシステムがアイドル状態であるとみなす場合があります。 +システムが次の信号を検出しない場合、一定時間の経過後にアプリはアイドル状態であるとみなされます。 +

+ + + +

端末が電源に接続されていない場合、アイドル中のみなされたアプリのネットワーク アクセスは無効になり、同期とジョブは保留されます。 +端末が電源に接続されると、アプリのネットワーク アクセスは許可され、保留中のすべてのジョブと同期が実行されます。 +端末が長時間アイドル状態の場合、アイドル中のアプリは 1 日 1 回程度ネットワーク アクセスが許可されます。 +

+ +

この機能をテストするには、M Preview を実行する端末を開発マシンに接続して、次のコマンドを呼び出します。 + +

+
+$ adb shell dumpsys battery unplug
+$ adb shell am set-idle <packageName> true
+$ adb shell am set-idle <packageName> false
+$ adb shell am get-idle <packageName>
+
+ +

注： +Google Cloud Messaging（GCM）の次期リリースでは、高優先度のメッセージを指定できます。 + +アプリが高優先度の GCM メッセージを受信する場合は、アプリがアイドル 中でも短時間のネットワーク アクセスが付与されます。 + +

+ +

アプリで App Standby をテストする方法のヒントについては、 +Testing Guide をご覧ください。 +

+ +

追加可能なストレージ端末

+

+このプレビューでは、SD カードなどの外部ストレージ端末を追加できます。外部ストレージ端末を追加すると、端末が内部ストレージのように動作するよう暗号化とフォーマットが行われます。 +この機能によって、アプリとアプリの個人データをストレージ端末間で移動できるようになります。 +アプリを移動する際、システムはマニフェストの +{@code android:installLocation} を遵守します。 + +

+ +

アプリが次の API やフィールドにアクセスする場合は、アプリが内部ストレージ端末と外部ストレージ端末間で移動する際に返されるファイルパスが動的に変化することに注意してください。ファイルパスの構築時は、これらの API を動的に呼び出すことを強くお勧めします。ハードコードされたファイル パスを使用したり、過去にビルドした完全修飾ファイルパスをそのまま使用したりしないでください。 + + +

+ + + +

Developer Preview のこの機能をデバッグするには、USB On-The-Go（OTG）ケーブルで Android 端末に接続された USB ドライブの追加を有効にして、次のコマンドを実行します。 +

+ +
+$ adb shell sm set-force-adoptable true
+
+ +

Apache HTTP Client の削除

+

このプレビューでは、Apache HTTP クライアントのサポートが削除されました。アプリでこのクライアントを使用していて、Android 2.3（API レベル 9）以上を対象としている場合は、代わりに {@link java.net.HttpURLConnection} クラスを使用します。 + +この API は透過的データ圧縮と応答のキャッシュによってネットワーク使用を軽減し、電源の消費を最小化するため、効率性が向上します。 +Apache HTTP API を引き続き使用するには、まず {@code build.gradle} ファイルで次のコンパイル時の依存関係を宣言する必要があります。 + +

+
+android {
+    useLibrary 'org.apache.http.legacy'
+}
+
+

Android は、OpenSSL から +BoringSSL ライブラリに移行しています。 +アプリで Android NDK を使用している場合は、{@code libcrypto.so} や {@code libssl.so} など、NDK API の一部でない暗号化ライブラリにリンクしないでください。 +これらのライブラリは パブリック API ではなく、リリースや端末に対する通知なしで変更されたり、中断したりする可能性があります。また、セキュリティ上の脆弱性を露呈する場合もあります。 + +代わりに、ネイティブ コードを変更して JNI 経由で Java の暗号化 API を呼び出すか、希望の暗号化ライブラリに静的リンクします。 + +

+ +

AudioManager の変更点

+

{@link android.media.AudioManager} クラスで音量を直接設定したり、特定のストリームをミュートにしたりする方法はサポートされなくなりました。 +{@link android.media.AudioManager#setStreamSolo(int,boolean) +setStreamSolo()} メソッドは廃止されたため、代わりに +{@code AudioManager.requestAudioFocus()} メソッドを呼び出す必要があります。同様に、 +{@link android.media.AudioManager#setStreamMute(int,boolean) setStreamMute()} メソッドも廃止され、代わりに {@code AudioManager.adjustStreamVolume()} メソッドを呼び出して、値に {@code ADJUST_MUTE} か {@code ADJUST_UNMUTE} を渡します。 + +

+ +

テキスト選択

+ + + +

ユーザーがアプリ内でテキストを選択するとき、 +切り取り、コピー、貼り付けなどのテキスト選択のアクションを +フローティング ツール バーに表示できるようになりました。 +個別のビューに対してコンテキスト アクション モードを有効にするにあるように、コンテキスト アクションバーに関するユーザー操作の実装も同様です。 + +

+ +

テキスト選択にフローティング ツール バーを実装するには、既存のアプリに次の変更を加えます。 +

+
    +
  1. {@link android.view.View} オブジェクトか {@link android.app.Activity} オブジェクトで、{@link android.view.ActionMode} の呼び出しを +{@code startActionMode(Callback)} から {@code startActionMode(Callback, ActionMode.TYPE_FLOATING)} に変更します。 +
    2. +
  2. 既存の {@code ActionMode.Callback} の実装を、{@code ActionMode.Callback2} に拡張します。 +
    3. +
  3. {@code Callback2.onGetContentRect()} メソッドをオーバーライドして、ビューのコンテンツの {@link android.graphics.Rect} オブジェクト）テキスト選択の四角形など）の座標を指定します。 +
    4. +
  4. 四角形の位置が有効でなくなり、無効な要素がこれのみである場合は、{@code ActionMode.invalidateContentRect()} メソッドを呼び出します。 +
    5. +
+ +

+Android Support Library revision 22.2 を使用している場合、フローティング ツール バーに下方互換性はなく、デフォルトで appcompat が代わりに {@link android.view.ActionMode} オブジェクトを制御することに注意してください。 + +これにより、フローティング ツール バーは表示されなくなります。 +{@link android.support.v7.app.AppCompatActivity} で +{@link android.view.ActionMode} がサポートされるようにするには、 +{@code android.support.v7.app.AppCompatActivity.getDelegate()} を呼び出して、返された +{@link android.support.v7.app.AppCompatDelegate} オブジェクトで +{@code android.support.v7.app.AppCompatDelegate.setHandleNativeActionModesEnabled()} を呼び出し、 入力パラメータを {@code false} に設定します。 +この呼び出して、{@link android.view.ActionMode} オブジェクトの制御がフレームワークに戻ります。 +M Preview を実行する端末ではフレームワークによる +{@link android.support.v7.app.ActionBar} やフローティング ツール バー モードのサポートが可能ですが、M Preview 以前の端末では +{@link android.support.v7.app.ActionBar} モードのみがサポートされます。

+ +

Android キーストロークの変更点

+

このプレビューでは、 +Android Keystore プロバイダによる DSA のサポートがなくなります。 +ECDSA は引き続きサポートされます。

+ +

停止時に暗号化を必要としないキーが、ロック画面の（ユーザーや端末の管理者などによる）無効時やリセット時に削除されなくなりました。 +停止時に暗号化を必要とするキーは、これらのイベント時に削除されます。 +

+ +

Wi-Fi とネットワークの変更点

+ +

このプレビューでは、Wi-Fi API とネットワーク API の動作に次のような変更点が追加されました。

+ + +

カメラ サービスの変更点

+

このプレビューでは、カメラ サービスの共有リソースへのアクセスモデルが、以前の "先着順" モデルから、"優先度順" に変更されました。 + +この動作の変更には、次のようなものがあります。

+ + +

ART ランタイム

+

ART ランタイムで、 +{@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()} メソッドに対するアクセスルールを正常に実装できるようになりました。この変更によって、以前のバージョンで Dalvik がアクセス ルールを正しく確認できなかった問題が解決しました。アプリで +{@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()} メソッドを使用していて、アクセス チェックをオーバーライドしたい場合は、 {@link java.lang.reflect.Constructor#setAccessible(boolean) setAccessible()} メソッドを使って入力パラメータを {@code true} に設定します。 + + + + +アプリで +v7 appcompat ライブラリや +v7 recyclerview ライブラリを使用する場合は、これらのライブラリの最新バージョンを使用するようアプリをアップデートする必要があります。 +アップデートしない場合は、XML から参照するカスタム クラスがアップデートされていて、クラス コンストラクタがアクセス可能であることを確認しておく必要があります。 +

+ +

このプレビューでは、動的リンクの動作がアップデートされました。動的リンクでは、ライブラリの {@code soname} とそのパス（ +public bug 6670）の違いを認識でき、{@code soname} が実装されています。 + + +以前動作していたアプリで間違った {@code DT_NEEDED} エントリを持つもの（ビルドマシンのファイル システムの絶対パスなど）は、読み込み時に失敗する場合があります。 +

+ +

{@code dlopen(3) RTLD_LOCAL} フラグは正常に実装されました。 +{@code RTLD_LOCAL} はデフォルトのため、 +{@code RTLD_LOCAL} を明示的に使用しない {@code dlopen(3)} への呼び出しは影響を受けます（アプリで明示的に {@code RTLD_GLOBAL} を使用している場合を除く）。 +{@code RTLD_LOCAL} では、後に +{@code dlopen(3)} への呼び出しで読み込まれたライブラリで記号は使用できません（{@code DT_NEEDED} エントリによって参照された場合とは逆）。

+

+ +

APK の検証

+

プラットフォームでより厳しい APK の検証が行われるようになりました。APK がマニフェスト ファイルで宣言されているにもかかわらず、APK 自体に存在しない場合、その APK は破損しているとみなされます。 +コンテンツが一部でも削除された場合は、APK の再署名が必要になります。 +

+ +

Android for Work の変更点

+

このプレビューには、次のような Android for Work に関する動作の変更点が含まれています。

+ diff --git a/docs/html-intl/intl/ja/preview/features/runtime-permissions.jd b/docs/html-intl/intl/ja/preview/features/runtime-permissions.jd new file mode 100644 index 0000000000000..f582756c816ce --- /dev/null +++ b/docs/html-intl/intl/ja/preview/features/runtime-permissions.jd @@ -0,0 +1,794 @@ +page.title=パーミッション +page.tags=previewresources, androidm +page.keywords=パーミッション,実行時,プレビュー +page.image={@docRoot}preview/features/images/permissions_check.png +@jd:body + + +
+
+

クイックビュー

+
    +
  • アプリのターゲットが M Preview SDK の場合、インストール時ではなく実行時に、パーミッションを付与するようユーザーに求めます。 +
    • +
  • ユーザーはいつでもアプリの [設定] 画面からパーミッションを取り消すことができます。 +
    • +
  • アプリは実行時に毎回、必要なパーミッションがあることを確認する必要があります。 +
    • +
+ +

本書の内容

+
    +
  1. 概要
    2. +
  2. 実行時のパーミッションのコード
    3. +
  3. 実行時のパーミッションをテストする
    4. +
  4. ベスト プラクティス
    5. +
+ + + + +
+
+ + +

+ M Developer Preview では、アプリをインストールしてアップグレードするユーザーのプロセスを効率化する新しいアプリのパーミッション モデルが導入されました。 +M Preview で実行しているアプリで新しいパーミッション モデルがサポートされている場合、ユーザーはアプリをインストールまたはアップグレードするときにパーミッションを付与する必要はありません。その代わりに、アプリは必要になるとパーミッションを要求し、パーミッションを確認するよう求めるダイアログが表示されます。 + + + + +

+ +

+ アプリで新しいパーミッション モデルがサポートされている場合、以前のバージョンの Android を実行している端末で、以前のパーミッション モデルを使ってインストールして実行することもできます。 + + +

+ +

+ 概要 +

+ +

+ M Developer Preview とともに、プラットフォームでは新しいアプリのパーミッション モデルが導入されました。 +この新しいモデルの主要なコンポーネントの概要を次に示します。 +

+ + + +

+ このパーミッション モデルにより、パーミッションを要求する機能に対するアプリの動作方法が変わります。 +このモデルに合わせるために、従う必要のある開発プラクティスの概要を次に示します。 + +

+ + + +

+ 注: アプリのターゲットが M Developer Preview の場合、新しいパーミッション モデルを使う必要があります。 + +

+ +

+ M Developer Preview のローンチ時点では、すべての Google アプリで新しいパーミッション モデルが完全に実装されているわけではありません。 +Google はこれらのアプリを M Developer Preview 中にアップデートして、パーミッションの切り替え設定を完全に実装します。 + + +

+ +

+ 注: アプリに独自の API サーフェスがある場合、まず呼び出し側にそのデータへのアクセスに必要なパーミッションがあることを確認しないままパーミッションをプロキシしないでください。 + + +

+ +

+ システムアプリと署名のパーミッション +

+ +

+ 本来、ユーザーがアプリをインストールするとき、システムはアプリに + {@link android.content.pm.PermissionInfo#PROTECTION_NORMAL + PROTECTION_NORMAL} のみを付与します。ただし、特定の環境では、アプリにより多くのパーミッションが付与されます。 + +

+ + + +

+ + +どちらの場合でも、ユーザーはシステムの [設定] 画面に移動して [アプリ] > [app_name] > [パーミッション] を選ぶと、いつでもパーミッションを取り消すことができます。アプリは実行時にパーミッションを継続して確認し、必要に応じて要求する必要があります。 + + +

+ +

+ 上方互換と下方互換 +

+ +

+ アプリのターゲットが M Developer Preview 以外の場合、M Preview 端末でも以前のパーミッション モデルを引き続き使います。 +ユーザーがアプリをインストールするとき、ユーザーはアプリのマニフェストでリストされているすべてのパーミッションを付与するように要求されます。 + + +

+ +

+ 注: M Developer Preview を実行している端末で、ユーザーはアプリの [設定] 画面から従来のアプリを含むすべてのアプリのパーミッションをオフにできます。 + +従来のアプリに対してパーミッションをオフにすると、適切な機能がサイレント状態で無効になります。 +アプリがそのパーミッションを必要とする操作を実行しようとするとき、その操作によって必ずしも例外が発生するとは限りません。 + +代わりに、空のデータセットを返す、エラーを示す、または予期しない動作を返すことがあります。 +たとえば、パーミッションなしでカレンダーを照会すると、メソッドは空のデータセットを返します。 + +

+ +

+ M Preview を実行していない端末で新しいパーミッション モデルを使ってアプリをインストールする場合、他のすべてのアプリと同様に扱われ、インストール時に、すべての宣言されたパーミッションを付与するようユーザーに求めます。 + + + +

+ +

+ 注: Preview リリースの場合、M Preview SDK に SDK の最小バージョンを設定して Preview SDK でコンパイルする必要があります。 +つまり、Developer Preview 中は従来のプラットフォームでそのようなアプリをテストできません。 + + +

+ +

パーミッションとインテント

+ +

+ 多くの場合、アプリがタスクを実行するには 2 つの方法から選択できます。 +アプリ自体が操作を実行するパーミッションを要求できます。 +アプリでインテントを使うようにして、別のアプリがそのタスクを実行するようにすることもできます。 + +

+ +

+ たとえば、端末のカメラで写真を撮る機能がアプリに必要だとします。 +アプリは android.permission.CAMERA パーミッションをリクエストでき、それによりアプリが直接カメラにアクセスできるようになります。 + +そのとき、アプリはカメラの API を使ってカメラを制御し、写真を撮ります。 +このアプローチにより、アプリが写真のプロセスを完全に制御し、カメラの UI をアプリに組み込むことができます。 + + +

+ +

+ ただし、そのような制御が不要な場合は、{@link + android.provider.MediaStore#ACTION_IMAGE_CAPTURE ACTION_IMAGE_CAPTURE} インテントを使うだけで画像を要求できます。 +インテントを開始すると、カメラアプリ（デフォルトのカメラアプリがない場合）を選んでアプリで写真を撮るよう求めるメッセージが表示されます。 + +カメラアプリはアプリの {@link + android.app.Activity#onActivityResult onActivityResult()} メソッドに写真を返します。 +

+ +

+ 同様に、ユーザーの連絡先にアクセスするなどして電話をかける必要がある場合、適切なインテントを作成するか、パーミッションを要求して適切なオブジェクトに直接アクセスできます。 + +各アプローチにはメリットとデメリットがあります。 + +

+ +

+ パーミッションを使う場合: +

+ + + +

+ インテントを使う場合: +

+ + + +

実行時のパーミッションのコード

+ +

+ アプリのターゲットが新しい M Developer Preview の場合、新しいパーミッション モデルを使う必要があります。 +つまり、マニフェストで必要なパーミッションを宣言する他に、実行時にパーミッションがあることを確認し、まだパーミッションがない場合にはパーミッションを要求します。 + + + +

+ +

+ 新しいパーミッション モデルを有効にする +

+ +

+ 新しい M Developer Preview パーミッション モデルを有効にするには、アプリの targetSdkVersion 属性を "MNC" に、compileSdkVersion を "android-MNC" に設定します。 + +このように設定することで、新しいパーミッション機能すべてが有効になります。 + +

+ +

+ Preview リリースの場合、minSdkVersion を "MNC" に設定して Preview SDK でコンパイルする必要があります。 + +

+ +

+ M Preview のみに対するパーミッションの設計 +

+ +

+ アプリ マニフェストで新しい <uses-permission-sdk-m> 要素を使って、M Developer Preview のみで必要なパーミッションを表示できます。 +このようにしてパーミッションを宣言すると、アプリを以前の端末にインストールする場合はユーザーにメッセージが表示されないか、アプリにパーミッションが付与されません。<uses-permission-sdk-m> 要素を使うと、新しいパーミッションを追加してインストールをアップデートするときにパーミッションの付与を強制せずにアプリのバージョンがアップデートされます。 + + + + + + +

+ +

+ M Developer Preview を使ってアプリが端末で実行されている場合、<uses-permission-sdk-m> は <uses-permission> と同じように動作します。 + + + アプリをインストールするとき、パーミッションの付与を求めるメッセージは表示されず、アプリは必要なときにパーミッションを要求します。 + +

+ +

+ パーミッションについてのダイアログを表示する +

+ +

+ アプリで新しい M Developer Preview パーミッション モデルが使われている場合、M Preview を実行している端末でアプリを初めて起動するとき、すべての権限を付与する必要はありません。 + +その代わりに、アプリは必要なときにパーミッションを要求します。 +アプリがパーミッションを要求すると、ユーザーにダイアログが表示されます。 + +

+ +

+ SDK 22 以降がインストールされた端末でアプリを実行する場合、アプリでは以前のパーミッション モデルが使われます。 +ユーザーがアプリをインストールすると、アプリがそのマニフェストで要求するすべてのパーミッションの付与を求めるメッセージが表示されます。ただし、<uses-permission-sdk-m> というラベルの付いたパーミッションは例外です。 + + +

+ +

アプリが実行されているプラットフォームを確認する

+ +

+ このパーミッション モデルは、M Developer Preview を実行している端末でのみサポートされます。 +これらのメソッドのいずれかを呼び出す前に、アプリは {@link android.os.Build.VERSION#CODENAME + Build.VERSION.CODENAME} の値を確認してどのプラットフォーム上で実行されているのかを確認する必要があります。 + +端末で M Developer Preview が実行されている場合、{@link android.os.Build.VERSION#CODENAME CODENAME} は "MNC" です。 + +

+ +

アプリに必要なパーミッションがあるかどうかを確認する

+ +

ユーザーがパーミッションを要求する動作を行うと、アプリは現在この操作を実行するためのパーミッションがあるかどうかを確認します。 + + +確認するために、アプリは Context.checkSelfPermission(permission_name) を呼び出します。ユーザーが既にパーミッションを付与していることをアプリが認識している場合でも、ユーザーはいつでもアプリのパーミッションを取り消すことができるため、この確認が行われます。 + + +たとえば、ユーザーがアプリを使って写真を撮る場合、アプリは Context.checkSelfPermission(Manifest.permission.CAMERA) を呼び出します。 + +

+ +

+ 表 1.パーミッションとパーミッション グループ。

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
パーミッション グループパーミッション
android.permission-group.CALENDAR +
    +
  • + android.permission.READ_CALENDAR +
    • +
+
    +
  • + android.permission.WRITE_CALENDAR +
    • +
+
android.permission-group.CAMERA +
    +
  • + android.permission.CAMERA +
    • +
+
android.permission-group.CONTACTS +
    +
  • + android.permission.READ_CONTACTS +
    • +
  • + android.permission.WRITE_CONTACTS +
    • +
  • + android.permission.READ_PROFILE +
    • +
  • + android.permission.WRITE_PROFILE +
    • +
+
android.permission-group.LOCATION +
    +
  • + android.permission.ACCESS_FINE_LOCATION +
    • +
  • + android.permission.ACCESS_COARSE_LOCATION +
    • +
+
android.permission-group.MICROPHONE +
    +
  • + android.permission.RECORD_AUDIO +
    • +
+
android.permission-group.PHONE +
    +
  • + android.permission.READ_PHONE_STATE +
    • +
  • + android.permission.CALL_PHONE +
    • +
  • + android.permission.READ_CALL_LOG +
    • +
  • + android.permission.WRITE_CALL_LOG +
    • +
  • + com.android.voicemail.permission.ADD_VOICEMAIL +
    • +
  • + android.permission.USE_SIP +
    • +
  • + android.permission.PROCESS_OUTGOING_CALLS +
    • +
+
android.permission-group.SENSORS +
    +
  • + android.permission.BODY_SENSORS +
    • +
+
    +
  • + android.permission.USE_FINGERPRINT +
    • +
+
android.permission-group.SMS +
    +
  • + android.permission.SEND_SMS +
    • +
  • + android.permission.RECEIVE_SMS +
    • +
  • + android.permission.READ_SMS +
    • +
  • + android.permission.RECEIVE_WAP_PUSH +
    • +
  • + android.permission.RECEIVE_MMS +
    • +
  • + android.permission.READ_CELL_BROADCASTS +
    • +
+
+ +

必要に応じてパーミッションを要求する

+ +

アプリに必要なパーミッションがない場合、アプリは Activity.requestPermissions(String[], int) メソッドを呼び出して適切なパーミッションを要求します。 + +アプリは必要なパーミッションと整数の「要求コード」を渡します。 + + このメソッドは非同期に機能します。このメソッドはすぐに返され、ユーザーがダイアログ ボックスに応答した後、システムはその結果と一緒にアプリのコールバック メソッドを呼び出し、アプリが requestPermissions() に渡すのと同じ「要求コード」を渡します。 + + +

+ +

次のコードは、ユーザーの連絡先を読み込むパーミッションがアプリにあることを確認し、必要に応じてパーミッションを要求します。 +

+ +
+if (checkSelfPermission(Manifest.permission.READ_CONTACTS)
+        != PackageManager.PERMISSION_GRANTED) {
+    requestPermissions(new String[]{Manifest.permission.READ_CONTACTS},
+            MY_PERMISSIONS_REQUEST_READ_CONTACTS);
+
+    // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
+    // app-defined int constant
+
+    return;
+}
+
+ +

パーミッションの要求への応答を処理する

+ +

+ アプリがパーミッションを要求すると、システムによってダイアログ ボックスが表示されます。 +ユーザーが応答すると、システムはアプリの Activity.onRequestPermissionsResult(int, String[], int[]) を呼び出し、ユーザーの応答を渡します。 + +アプリはそのメソッドをオーバーライドする必要があります。コールバックには開発者が requestPermissions() に渡したのと同じ要求コードが渡されます。 + +たとえばアプリが READ_CONTACTS アクセスを要求する場合、次のコールバック メソッドが含まれる可能性があります。 + + +

+ +
+@Override
+public void onRequestPermissionsResult(int requestCode,
+        String permissions[], int[] grantResults) {
+    switch (requestCode) {
+        case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {
+            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+
+                // permission was granted, yay! do the
+                // calendar task you need to do.
+
+            } else {
+
+                // permission denied, boo! Disable the
+                // functionality that depends on this permission.
+            }
+            return;
+        }
+
+        // other 'switch' lines to check for other
+        // permissions this app might request
+    }
+}
+
+ +

ユーザーがパーミッションを付与すると、システムは、機能領域のアプリ マニフェストがリストするすべてのパーミッションを付与します。 +ユーザーが要求を拒否する場合は、適切なアクションを取ってください。 +たとえば、このパーミッションに応じて、すべてのメニュー アクションを無効にできます。 + + +

+ +

+ ユーザーにパーミッションの付与を確認するとき、ユーザーにそのパーミッションについて再度確認しないようにするオプションがあります。 +この場合、アプリが requestPermissions() を使ってパーミッションを確認すると、システムはその要求をすぐに拒否します。 + +この場合、システムはユーザーが要求を再度明示的に拒否する場合と同様に onRequestPermissionsResult() を呼び出します。 + +このため、アプリではユーザーとの直接的なやり取りが発生することが想定されません。 + +

+ +

実行時のパーミッションをテストする

+ + +

+ アプリのターゲットが M Developer Preview の場合、パーミッションが正しく処理されることをテストする必要があります。 +アプリ起動時に特定のパーミッションがアプリにあることは想定できません。 +アプリが初めて起動されるとき、パーミッションがない可能性が高く、ユーザーはいつでもパーミッションを取り消すまたは復元できます。 + + +

+ +

+ アプリがすべてのパーミッションの状況下で確実に正しく動作することをテストしてください。 +M Preview SDK とともに、新しい Android デバッグ ブリッジ（adb）コマンドが導入され、試す必要のあるあらゆるパーミッション設定でアプリをテストできます。 + + + +

+ +

+ 新しい adb コマンドとオプション +

+ +

+ M Preview SDK Platform-tools では、アプリがパーミッションをどう処理するかをテストするための、いくつかの新しいコマンドが導入されました + +

+ +

+ パーミッション付きでインストールする +

+ +

+ adb + install コマンドの新しい -g オプションを使ってアプリをインストールし、そのマニフェストにリストされるすべてのパーミッションを付与できます。 + +

+ +
+$ adb install -g <path_to_apk>
+
+ +

+ パーミッションの付与と取り消し +

+ +

+ 新しい ADB Package Manager（pm）コマンドを使って、インストールされているアプリにパーミッションを付与したり取り消したりできます。この機能は自動化されたテストに役立ちます。 + + +

+ +

+ パーミッションを付与するには、Package Manager の grant コマンドを使います。 +

+ +
+$ adb pm grant <package_name> <permission_name>
+
+ +

+ たとえば、com.example.myapp パッケージ パーミッションを付与してオーディオを録音するには、このコマンドを使います。 + +

+ +
+$ adb pm grant com.example.myapp android.permission.RECORD_AUDIO
+
+ +

+ パーミッションを取り消すには、Package Manager の revoke コマンドを使います。 +

+ +
+$ adb pm revoke <package_name> <permission_name>
+
+ +

ベスト プラクティス

+ +

+ 新しいパーミッション モデルにより、ユーザーはよりスムーズな操作感を得られ、アプリを簡単にインストールできるようになり、アプリが実行している内容に満足します。 + +新しいモデルを最大限に活用するために、次のベスト プラクティスをお勧めします。 + +

+ + +

必要なパーミッションのみを要求する

+ +

+ パーミッションを要求するたびに、ユーザーに決定するよう強制します。 + ユーザーが要求を却下すると、アプリの機能が低下します。 + これらの要求回数は最小限にしてください。 +

+ +

+ たとえば、アプリがパーミッションを要求する代わりに、インテントを使って必要な機能を取得できる場合がよくあります。 + +アプリが携帯電話のカメラで写真を撮る必要がある場合、そのアプリでは {@link + android.provider.MediaStore#ACTION_IMAGE_CAPTURE + MediaStore.ACTION_IMAGE_CAPTURE} インテントを使用できます。 +アプリがインテントを実行すると、写真を撮るためのインストール済みのカメラアプリを選ぶようユーザーに促します。 + + +

+ +

+ ユーザーを疲れさせない +

+ +

+ ユーザーにパーミッションをたくさん要求すると、ユーザーを疲れさせてしまい、アプリが終了される原因になります。代わりに、ユーザーには必要なパーミッションのみを要求してください。 + + +

+ +

+ アプリ対して 1 つ以上のパーミッションが必須である場合もあります。その場合は、アプリの起動後すぐに、すべてのパーミッションを要求することが合理的である場合があります。 + +たとえば、カメラアプリを作成する場合、アプリは端末のカメラにアクセスする必要があります。 +アプリを初めて起動するときにカメラの使用についてのパーミッションを求められても驚かないはずです。 + +ただし、同じアプリにユーザーの連絡先と写真を共有する機能もある場合は、最初の起動時にパーミッションを要求しない方が無難です。 + +その代わりに、ユーザーが「共有」機能を使うまで待ち、そのときにパーミッションを要求します。 + +

+ +

+ アプリにチュートリアルが含まれる場合は、チュートリアルのシーケンスの最後で、アプリに必須のパーミッションを要求する方が合理的です。 + +

+ +

+ パーミッションが必要な理由を説明する +

+ +

+ requestPermissions() を呼び出すとき、システムによって表示されるパーミッション ダイアログにはアプリが必要としているパーミッションは表示されますが、理由は表示されません。 + +これによりユーザーが困惑する場合もあります。 + requestPermissions() を呼び出す前に、アプリがパーミッションを必要としている理由をユーザーに説明するのはよい方法です。 + +

+ +

+ たとえば、カメラアプリでは、位置情報サービスを使って写真に位置情報タグを付けられるようにする場合があります。 +通常のユーザーは、写真に位置情報が含まれる場合があることを認識していない可能性があり、なぜカメラアプリで位置情報が必要なのか困惑する可能性があります。 + +この場合、アプリが requestPermissions() を呼び出す前に、この機能についてユーザーに知らせることをお勧めします。 + + +

+ +

+ その方法として、これらの要求をアプリのチュートリアルに組み込むこともできます。チュートリアルでは、アプリの各機能を順番に表示できるので、必要なパーミッションを説明できます。 + +たとえば、カメラアプリのチュートリアルでは、「連絡先と写真を共有する」機能について説明し、ユーザーの連絡先を参照するためにアプリにパーミッションが必要であることをユーザーに知らせることができます。 + + +その後、アプリは requestPermissions() を呼び出して、ユーザーにそのアクセスを求めることができます。 +もちろん、すべてのユーザーがチュートリアルに従うわけではないため、アプリの通常操作中にパーミッションを確認して要求することも必要です。 + + +

diff --git a/docs/html-intl/intl/ja/preview/overview.jd b/docs/html-intl/intl/ja/preview/overview.jd new file mode 100644 index 0000000000000..4cefdd1aadb40 --- /dev/null +++ b/docs/html-intl/intl/ja/preview/overview.jd @@ -0,0 +1,362 @@ +page.title=プログラム概要 +page.metaDescription=Android M Developer Preview では、Android の次のバージョンでアプリをテストして最適化するためのすべてを備えています。 +page.image=images/cards/card-preview_16-9_2x.png +page.tags="preview", "developer", "android" + +@jd:body + +

+ Android M Developer Preview では、Android の次のバージョンでアプリをテストして最適化するためのすべてを備えています。 + +M Developer Preview ツールをダウンロードするだけで、無料ですぐにご利用いただけます。 + +

+ +
+
+
+
+
+ ハードウェアとエミュレータのシステム イメージ +
+ +

+ Nexus 5、6、9、Nexus Player（TV 向け）やエミュレータでアプリをテストしましょう。 + +

+
+ +
+
+ 最新プラットフォーム コード +
+ +

+ プレビューで複数のアップデートが提供されますので、最新プラットフォームの変更に応じてテストできます。 + +

+
+ +
+
+ OTA でのアップデート +
+ +

+ デバイスに初期プレビューをコピーしたら、無線経由でアップデートを入手できます。 + +

+
+
+ +
+ + +
+
+ 新しい動作と機能 +
+ +

+ 新しい実行時パーミッション モデルや省電力機能など、新しいプラットフォームの動作をあらかじめサポートする + +

+
+ +
+
+ 開発者が報告した問題に対する優先度ウィンドウ +
+ +

+ 最初の数週間で開発者から報告のあった問題について優先度を設定し、可能な限り早くテストを行いフィードバックを提供できるようにします。 + +

+
+ +
+
+ フィードバックとサポート +
+ +

+ Issue Tracker で問題を報告し、フィードバックをお送りください。 + M Developer コミュニティ で他の開発者とつながりましょう。 + +

+
+
+
+
+ + + + +

+ タイムラインとアップデート +

+Preview program timeline +

+ M Developer Preview は 5 月 28 日から最終の Android M SDK まで実行されます。Android M SDK はまもなく、2015 年第三四半期に予定されている正式公開の前にリリースされます。 + + +

+ +

+ 開発の主なマイルストーンごとにテスト端末へアップデートを配信する予定としています。 + 暫定マイルストーンは以下のとおりです。 +

+ + + +

+ アップデートは第三四半期後半に予定されている最終 SDK で終了します。最終版では新しい Android に対する正式な API や最終的なシステム動作や機能が提供されます。 + + +

+ +

+ Android M でのテストや開発に際しては、Preview アップデートがリリースされるたびに開発環境を最新に保つことを強くお勧めします。 + + プロセスをより容易にするため、既に Preview ビルドがインストールされた端末に無線経由でアップデート（OTA）を配信します。また手動でダウンロードして展開できるシステム イメージもご提供します。 + + +

+

+ 注: 最終 SDK とシステム イメージは OTA では配信できません。代わりにテスト端末に手動でコピーする必要があります。 + + +

+ +

+ Preview アップデートをご利用いただけるようになった際は Android デベロッパー ブログ、このサイト、Android M デベロッパー コミュニティでお知らせします。 + + +

+ +

+ Preview の内容 +

+ +

+ M Developer Preview では、ご利用のアプリをさまざまな画面サイズ、ネットワーク、テクノロジー、CPU や GPU チップセット、ハードウェア設計でテストするために必要なあらゆるものを備えています。 + + +

+ +

+ SDK ツール +

+ +

+ 各コンポーネントは Android Studio の SDK Manager でダウンロードできます。 +

+ + + +

+ ハードウェアのシステム イメージ +

+ +

+ Nexus 端末向けハードウェア システム イメージは、ダウンロード ページからダウンロードできます。 + +

+ + + +

+ ドキュメントとサンプル コード +

+ +

+ 次のドキュメント リソースで Preview についての詳細をご確認いただけます。 +

+ + + +

+ サポート リソース +

+ +

+ M Developer Preview でのテストや開発について、次のサポート リソースをご確認いただけます。 + +

+ + + + +

+ 対象、プレビュー API、公開 +

+ +

+ Android M Developer Preview は開発リリースのみであり、標準 API レベルはありません。 +アプリのテストで互換性の問題は除外する場合（強く推奨します）、アプリのtargetSdkVersion を “MNC” に設定することで M Developer Preview を対象にできます。 + + + +

+ +

+ Android M Developer Preview ではプレビュー API を配信しています。現在 2015 年度第三四半期に予定されている最終 SDK がリリースされるまで、API は正式版ではありません。 + +つまり、時間がたつにつれて API の細かな変更が見込まれます（特にプログラムの最初の数週間）。 + +Android M Developer Preview でアップデートがあればその都度変更の概要をご提供します。 + +

+ +

+ プレビュー API は変更される可能性がありますが、実行時パーミッションや省電力機能などのシステムの基幹にかかわる機能には変更はありませんので、すぐにテストしていただけます。 + + +

+ +

+ 公開に関して、Google Play では M Developer Preview 対象アプリは公開できません。 +Android M 最終 SDK が利用可能になれば正式な Android M API レベルを対象にして、Google Play でアプリを公開できるようになります。 + +それまでは、Android M 対象のアプリをテスターに配布する場合は電子メールで送付したりご自分のサイトから直接ダウンロードしてもらったりしてください。 + + +

+ +

+ 開始するには +

+ +

+ アプリのテストをはじめるには: +

+ +
    +
  1. API 概要や Behavior Changes で新しい機能やご自分のアプリへの影響についてご確認ください。 + +特に、実行時パーミッション モデルや省電力機能、自動バックアップ機能についてお確かめください。 + + +
    2. + +
  2. Setting up the Preview SDK の手順に従い、ご利用の環境をセットアップしてテスト端末を構成してください。 + + +
    3. + +
  3. コピー手順に従い、最新の M Developer Preview システム イメージを Nexus 5、6、9、Nexus Player にコピーします。 + +1 度開発端末に Preview 環境をコピーすると、アップデートが無線経由（OTA）で配信されます。 + +
    4. + +
  4. M Preview API リファレンスやM Preview サンプルをダウンロードして、新しい API の機能についてさらに学び、ご自分のアプリで活用する方法についてご確認ください。 + + + +
    5. + +
  5. Android M Developer コミュニティに参加して最新のニュースを入手し、Preview に取り組んでいる他のデベロッパーとつながってください。 + + +
    6. +
+ +

+ Android M Developer Preview プログラムへのご参加ありがとうございます。 +

diff --git a/docs/html-intl/intl/ko/preview/api-overview.jd b/docs/html-intl/intl/ko/preview/api-overview.jd new file mode 100644 index 0000000000000..aac9a44924e04 --- /dev/null +++ b/docs/html-intl/intl/ko/preview/api-overview.jd @@ -0,0 +1,521 @@ +page.title=API 개요 +page.keywords=미리 보기, SDK, 호환성 +page.tags=previewresources, androidm +sdk.platform.apiLevel=22-mnc +page.image=images/cards/card-api-overview_16-9_2x.png +@jd:body + + +
+ +
+ +

M 개발자 미리 보기에서는 다가오는 Android 플랫폼 릴리스를 미리 볼 수 있도록 하였습니다. 이 릴리스는 사용자와 앱 개발자를 위한 여러 가지 새 기능을 제공합니다. + + 이 문서에서는 가장 중요한 API를 몇 가지 소개합니다.

+ +

M 개발자 미리 보기는 개발자 얼리 어답터와 테스터를 위해 마련된 것입니다. + Android 프레임워크가 나아갈 방향에 영향을 미치는 데 관심이 있으시다면, M 개발자 미리 보기를 시도해 보시고 피드백을 보내주세요! + + +

+ +

주의: M 개발자 미리 보기를 사용하는 앱을 Google Play 스토어에 게시하지 마세요. +

+ +

참고: 이 문서에서 종종 언급하는 클래스와 메서드 중에는 아직 developer.android.com에서 참조 자료로 이용할 수 없는 것도 있습니다. + 이와 같은 API 요소는 이 문서에서 {@code code style}로 형식 지정되어 있습니다(하이퍼링크 없이). + 이러한 요소에 대한 임시 API 관련 문서가 필요한 경우, 미리 보기 참조를 다운로드하세요. +

+ +

중요한 동작 변경

+ +

이전에 Android용 앱을 게시한 적이 있는 경우, 플랫폼 변경으로 인해 앱이 영향받을 수 있다는 점을 유의하세요. +

+ +

완전한 정보는 동작 변경을 참조하세요.

+ +

앱 연결

+

이 미리 보기는 더욱 강력한 앱 연결을 제공하여 Android의 인텐트 시스템을 한층 강화합니다. 이 기능을 사용하면 앱을 본인이 소유한 웹 도메인과 연관시킬 수 있습니다. + 플랫폼은 이 연관 관계를 근거로 특정한 웹 링크를 처리하는 데 사용할 기본 앱을 결정할 수 있고 사용자에게 앱을 선택하라는 메시지를 건너뛸 수 있습니다. 이 기능을 구현하는 방법을 알아보려면 앱 연결을 참조하세요. + + + + +

앱용 자동 백업

+

시스템에서 이제 앱에 대한 완전한 데이터 백업과 복원을 자동으로 수행합니다. 이 동작은 앱 대상 지정 M 미리 보기에 대한 기본으로 활성화되며, 추가 코드를 전혀 추가하지 않아도 됩니다. + 사용자가 Google 계정을 삭제하면 계정의 백업 데이터도 함께 삭제됩니다. + 이 기능의 작동 원리와 파일 시스템에서 백업 내용 구성하는 방법에 대해 알아보려면 앱용 자동 백업을 참조하세요. + +

+ +

인증

+

이 미리 보기에서는 사용자를 인증할 때 지원되는 기기에서 지문 스캔을 사용하도록 해주는 새로운 API를 제공합니다. 또한 기기 잠금 해제 메커니즘(예: 화면 잠금 비밀번호)을 사용해 사용자의 마지막 인증 시간을 확인할 수도 있습니다. + + 이러한 API는 Android Keystore 시스템과 함께 사용하세요. +

+ +

지문 인증

+ +

지문 스캔을 통해 사용자를 인증하려면 새로운 {@code android.hardware.fingerprint.FingerprintManager} 클래스의 인스턴스를 가져와 {@code FingerprintManager.authenticate()} 메서드를 호출하세요. + + 앱이 지문 센서가 있는 호환되는 기기에서 실행되고 있어야 합니다. + 지문 인증 흐름에 대한 사용자 인터페이스를 앱에 구현해야 하며, UI에 표준 Android 지문 아이콘을 사용해야 합니다. 이 Android 지문 아이콘({@code c_fp_40px.png})은 샘플 앱에 포함되어 있습니다. 지문 인증을 사용하는 앱을 여러 개 개발하는 경우, 각 앱이 사용자의 지문을 따로따로 인증해야 한다는 사실을 명심하세요. + + + + +

+ +

앱에서 이 기능을 사용하려면 우선 매니페스트에 {@code USE_FINGERPRINT} 권한을 추가해야 합니다. +

+ +
+<uses-permission
+        android:name="android.permission.USE_FINGERPRINT" />
+
+ + + +

지문 인증의 앱 구현을 확인하려면, 지문 대화 샘플을 참조하세요. + +

+ +

이 기능을 테스트하는 경우, 다음 단계를 따르면 됩니다.

+
    +
  1. 아직 Android SDK 도구 수정 버전 24.3을 설치합니다(설치하지 않은 경우).
    2. +
  2. 에뮬레이터에 새 지문을 등록하려면 설정 > 보안 > 지문으로 이동한 다음, 등록 지침을 따르면 됩니다. +
    3. +
  3. 에뮬레이터를 사용하여 지문 터치 이벤트를 에뮬레이트하되 다음 명령을 사용하세요. + 잠금 화면이나 앱에서 지문 터치 이벤트를 에뮬레이트할 때에도 같은 명령을 사용합니다. + +
    +adb -e emu finger touch <finger_id>
+
    +

    Windows에서는 {@code telnet 127.0.0.1 <emulator-id>}에 뒤이어 {@code finger touch <finger_id>}를 실행해야 할 수도 있습니다. + +

    +
    4. +
+ +

확인 자격 증명

+

앱에서 사용자를 인증할 때 해당 사용자가 기기를 마지막으로 잠금 해제한 시간을 근거로 할 수 있습니다. 이 기능을 사용하면 사용자가 앱에 따라 각기 다른 비밀번호를 기억할 필요가 없어지고, 개발자는 자신만의 인증 사용자 인터페이스를 구현하지 않아도 됩니다. + + 앱에서 이 기능을 사용하려면 사용자 인증에 대한 공개 또는 비밀 키 구현과 함께 사용해야 합니다. +

+ +

사용자를 성공적으로 인증한 다음 같은 키를 재사용하기 위한 시간 초과 기간을 설정하려면, 새로운 {@code android.security.keystore.KeyGenParameterSpec.setUserAuthenticationValidityDurationSeconds()} 메서드를 호출하세요. {@link javax.crypto.KeyGenerator} 또는 {@link java.security.KeyPairGenerator}를 설정할 때 사용하면 됩니다. + + + + 현재 이 기능은 대칭형 암호화 작동에 맞게 작동합니다. +

+ +

재인증 대화창을 과도하게 표시하는 것을 삼가세요. 우선 앱에서 암호화 객체 사용을 시도해보고, 제한 시간이 만료되면 {@link android.app.KeyguardManager#createConfirmDeviceCredentialIntent(java.lang.CharSequence, java.lang.CharSequence) createConfirmDeviceCredentialIntent()} 메서드를 사용해 앱 내에서 해당 사용자를 재인증하면 됩니다. + + + +

+ +

이 기능의 앱 구현을 확인하려면, 확인 자격 증명 샘플를 참조하세요. + +

+ +

직접 공유

+ + + +

이 미리 보기에서는 사용자가 공유 기능을 간편하고 신속하게 이용할 수 있도록 해주는 API를 제공합니다. 이제 앱에서 특정 액티비티를 시작하는 직접 공유 대상을 정의할 수 있습니다. 이와 같은 직접 공유 대상은 공유 메뉴를 통해 사용자에게 노출됩니다. + + 이 기능을 사용하면 사용자가 다른 앱 내의 대상(예: 연락처)에 대해 콘텐츠를 공유할 수 있습니다. + 예를 들어, 직접 공유 대상이 다른 소셜 네트워크 앱에서 액티비티를 시작하면 사용자가 해당 앱에 있는 특정 친구나 커뮤니티와 콘텐츠를 공유할 수 있습니다. + +

+ +

직접 공유 대상을 활성화하려면 반드시 {@code android.service.} +
+{@code chooser.ChooserTargetService} 클래스를 확장하는 클래스를 정의해야 합니다. 매니페스트에서 {@code ChooserTargetService}를 선언하고 + 해당 선언 내에서 {@code BIND_CHOOSER_TARGET_SERVICE} 권한을 지정하고 {@code SERVICE_INTERFACE} 작업으로 인텐트 필터를 지정합니다. + +

+

다음 예는 매니페스트에서 {@code ChooserTargetService}를 선언할 수 있는 방법입니다. +

+
+<service android:name=".ChooserTargetService"
+        android:label="@string/service_name"
+        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
+    <intent-filter>
+        <action android:name="android.service.chooser.ChooserTargetService" />
+    </intent-filter>
+</service>
+
+ +

{@code ChooserTargetService}에 노출하고자 하는 액티비티마다 {@code <meta-data>} 요소를 하나씩 추가하고, 앱 매니페스트에 {@code "android.service.chooser.chooser_target_service"} 이름을 추가합니다. + + +

+ +
+<activity android:name=".MyShareActivity”
+        android:label="@string/share_activity_label">
+    <intent-filter>
+        <action android:name="android.intent.action.SEND" />
+    </intent-filter>
+<meta-data
+        android:name="android.service.chooser.chooser_target_service"
+        android:value=".ChooserTargetService" />
+</activity>
+
+ +

음성 상호작용

+

+이 미리 보기에서 제공하는 새로운 음성 상호작용 API는 음성 액션과 같이 앱에 대화형 음성 환경을 구축할 수 있도록 합니다. + + {@code android.app.Activity.isVoiceInteraction()} 메서드를 호출하여 액티비티가 음성 액션에 대응하여 시작된 것인지 알아보세요. + + 이 경우에 해당되면, 앱이 {@code android.app.VoiceInteractor} 클래스를 사용하여 사용자로부터 음성 확인을 요청하거나, 선택 항목 목록에서 선택하게 하는 등 여러 가지 일을 할 수 있습니다. + + 음성 액션 구현에 대한 자세한 정보는 음성 액션 개발자 사이트를 참조하세요. + +

+ +

지원 API

+

+이 미리 보기에서는 사용자가 도우미를 통해 앱에 참여하게 하는 새로운 방식을 제시합니다. 이 기능을 사용하려면, 사용자가 현재 컨텍스트를 사용하기 위해 도우미를 활성화해야 합니다. + 일단 활성화하고 나면 홈 버튼을 길게 눌러 해당 도우미를 어느 앱에서나 불러낼 수 있습니다. +

+

앱이 현재 컨텍스트를 도우미와 공유하지 않기로 선택하는 경우, {@link android.view.WindowManager.LayoutParams#FLAG_SECURE} 플래그를 설정하면 됩니다. + 플랫폼이 도우미에게 전달하는 일반적인 일련의 정보 외에도 앱이 추가적인 정보를 공유할 수 있도록 하려면 새로 나온 {@code android.app.Activity.AssistContent} 클래스를 사용할 수 있습니다. + +

+ +

도우미에게 앱에서 가져온 추가 컨텍스트를 제공하려면, 다음 단계를 따르면 됩니다.

+ +
    +
  1. {@link android.app.Application.OnProvideAssistDataListener} 인터페이스를 구현합니다.
    2. +
  2. {@link android.app.Application#registerOnProvideAssistDataListener(android.app.Application.OnProvideAssistDataListener) registerOnProvideAssistDataListener()}를 사용하여 이 수신기를 등록합니다. +
    3. +
  3. 액티비티에 따라 각기 다른 상황별 정보를 제공하려면 {@link android.app.Activity#onProvideAssistData(android.os.Bundle) onProvideAssistData()} 콜백을 재정의하고, 선택 사항으로 새로운 {@code Activity.onProvideAssistContent()} 콜백도 재정의합니다. + + +
+ +

알림

+

이 미리 보기에서는 알림 기능에 다음과 같은 API 변경을 추가합니다.

+ + +

블루투스 스타일러스 지원

+

이 미리 보기에서는 블루투스 스타일러스를 사용하는 사용자 입력에 대한 지원을 개선하여 제공합니다. 사용자는 전화기나 태블릿을 호환되는 블루투스 스타일러스와 페어링하고 이에 연결할 수 있습니다. + 연결된 동안 터치 스크린에서 가져온 위치 정보가 스타일러스에서 가져온 압력 및 버튼 정보와 합쳐져 하나의 터치 스크린을 사용할 때보다 훨씬 폭넓은 표현을 제공합니다. + + 앱이 스타일러스 버튼 누르기를 수신 대기하고 보조 작업을 수행하도록 하려면, 액티비티에 새로운 {@code View.onStylusButtonPressListener} 및 {@code GestureDetector.OnStylusButtonPressListener} 콜백을 등록하면 됩니다. + + +

+ +

스타일러스 버튼 상호작용을 감지하려면 {@link android.view.MotionEvent} 메서드와 상수를 사용하세요. +

+ + +

블루투스 저전력 스캔 개선

+

+앱이 블루투스 저전력 스캔을 수행하는 경우, 새로운 {@code android.bluetooth.le.ScanSettings.Builder.setCallbackType()} 메서드를 사용해 콜백에 알림을 원하는 시점을 지정할 수 있습니다.즉, 정해진 {@link android.bluetooth.le.ScanFilter}에 일치하는 광고 패킷을 처음 찾았을 때와 이것을 일정한 시간 동안 확인하지 못했을 때에만 콜백에 알리도록 하면 됩니다. + + + + 스캔 기능에 대해 이런 식으로 접근하면 이전 버전의 플랫폼에서 제공되었던 것에 비해 훨씬 전력 효율적입니다. + +

+ +

핫스팟 2.0 릴리스 1 지원

+

+이 미리 보기에서는 Nexus 6 및 Nexus 9 기기에서의 핫스팟 2.0 릴리스 1 사양에 대한 지원을 추가합니다. 앱에 핫스팟 2.0 자격 증명을 프로비저닝하려면 {@link android.net.wifi.WifiEnterpriseConfig} 클래스의 새 메서드를 사용할 수 있습니다(예: {@code setPlmn()} 및 {@code setRealm()}). + + + {@link android.net.wifi.WifiConfiguration} 객체에서는 {@link android.net.wifi.WifiConfiguration#FQDN} 및 {@code providerFriendlyName} 필드를 설정하면 됩니다. 새로 나온 {@code ScanResult.PasspointNetwork} 속성이 감지된 네트워크가 핫스팟 2.0 액세스 지점을 나타내는지 여부를 알려줍니다. + + + +

+ +

4K 디스플레이 모드

+

이제 플랫폼에서 앱이 호환되는 하드웨어에서 디스플레이 해상도를 4K 렌더링으로 업그레이드하도록 요청할 수 있습니다. + 현재의 물리적 해상도를 쿼리하려면 새로운 {@code android.view.Display.Mode} API를 사용할 수 있습니다. + UI가 더 낮은 논리적 해상도에서 그려졌고 더 큰 물리적 해상도에 맞춰 확장된 경우, {@code Display.Mode.getPhysicalWidth()} 메서드가 반환하는 물리적 해상도가 {@link android.view.Display#getSize(android.graphics.Point) getSize()}가 보고하는 논리적 해상도와 다를 수 있다는 점을 유의하세요. + + +

+ +

앱이 실행되는 중에 시스템에 물리적 해상도를 변경하도록 요청할 수도 있습니다. 앱의 창에서 {@code WindowManager.LayoutParams.preferredDisplayModeId} 속성을 설정하면 됩니다. + 이 기능은 4K 디스플레이 해상도로 전환하고자 하는 경우 무척 유용합니다. + 4K 디스플레이 모드에서 UI는 계속 원래 해상도(예: 1080p)에서 렌더링되며 4K로 확장되지만, {@link android.view.SurfaceView} 객체는 원래 해상도에서 콘텐츠를 표시할 수 있습니다. + +

+ +

테마 지정 가능 ColorStateLists

+

이제 M 미리 보기를 실행하는 기기에 대해 테마 속성이 {@link android.content.res.ColorStateList}에서 지원됩니다. + {@link android.content.res.Resources#getColorStateList(int) getColorStateList()} 및 {@link android.content.res.Resources#getColor(int) getColor()} 메서드는 사용이 중단되었습니다. + + 이러한 API를 호출하려면, 대신 새로운 {@code Context.getColorStateList()} 또는 {@code Context.getColor()} 메서드를 호출하세요. + + 이 두 메서드는 v4 AppCompat 라이브러리에서도 {@link android.support.v4.content.ContextCompat}를 통해 이용할 수 있습니다. +

+ +

오디오 기능

+ +

이 미리 보기에서는 Android에서의 오디오 처리에 개선점을 더했습니다.

+ + +

비디오 기능

+

이 미리 보기에서는 비디오 처리 API에 새로운 기능을 추가합니다.

+ + +

카메라 기능

+

이 미리 보기에는 다음과 같은 새 API를 제공하여 카메라의 플래시에 액세스하고 이미지를 재처리하는 카메라에 액세스할 수 있도록 했습니다. +

+ +

Flashlight API

+

카메라 기기에 플래시 장치가 있는 경우, {@code CameraManager.setTorchMode()} 메서드를 호출하여 카메라 기기를 열지 않고도 플래시 장치의 Torch 모드를 켜거나 끌 수 있습니다. + 앱에는 플래시 장치 또는 카메라 기기에 대한 독점적인 소유권이 없습니다. + Torch 모드는 꺼져 있다가 카메라 기기를 이용할 수 없게 될 때마다 이용 불가능한 상태가 되고, Torch 모드를 켜진 상태로 유지하던 다른 카메라 리소스를 이용할 수 없게 되면 이용 불가능하게 됩니다. + + 다른 앱도 {@code setTorchMode()}를 호출하여 Torch 모드를 끌 수 있습니다. + Torch 모드를 켠 마지막 앱이 종료되면 Troch 모드도 꺼집니다. +

+ +

Torch 모드 상태에 대해 알림을 받기 위한 콜백을 등록하려면 {@code CameraManager.registerTorchCallback()} 메서드를 호출하면 됩니다. + 콜백을 처음 등록하면 그 즉시, 현재 알려진 모든 카메라 기기(플래시 장치가 있는)의 Torch 모드 상태와 함께 호출됩니다. + + Torch 모드가 성공적으로 켜지거나 꺼지면 {@code CameraManager.TorchCallback.onTorchModeChanged()} 메서드가 불려나옵니다. +

+ +

재처리 API

+

{@link android.hardware.camera2 Camera2} API를 확장하여 YUV를 지원하고 비공개 불투명 형식 이미지 재처리를 지원하게 되었습니다. + 앱은 재처리 기능을 이용할 수 있는지 알아보기 위해 {@code CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES}를 통합니다. + 기기가 재처리를 지원하는 경우, 재처리 가능한 카메라 캡처 세션을 생성하려면 {@code CameraDevice.createReprocessableCaptureSession()}을 호출하고 입력 버퍼 재처리를 위한 요청을 생성하면 됩니다. + + +

+ +

{@code ImageWriter} 클래스를 사용하여 카메라 재처리 입력에 입력 버퍼 흐름을 연결시키세요. + 빈 버퍼를 가져오려면 다음과 같은 프로그래밍 모델을 따르면 됩니다.

+ +
    +
  1. {@code ImageWriter.dequeueInputImage()} 메서드를 호출합니다.
    2. +
  2. 입력 버퍼에 이 데이터를 채웁니다.
    3. +
  3. {@code ImageWriter.queueInputImage()} 메서드를 호출하여 해당 버퍼를 카메라에 전송합니다.
    4. +
+ +

{@code ImageWriter} 객체와 {@code android.graphics.ImageFormat.PRIVATE} 이미지를 함께 사용하는 경우, 앱이 이미지 데이터에 직접 액세스할 수 없습니다. + + 대신, 버퍼 사본 없이 {@code ImageWriter.queueInputImage()} 메서드를 호출하여 {@code ImageFormat.PRIVATE} 이미지를 {@code ImageWriter}에 직접 전달하면 됩니다. + +

+ +

이제 {@code ImageReader} 클래스가 {@code android.graphics.ImageFormat.PRIVATE} 형식 이미지 스트림을 지원합니다. + 이로써 앱이 {@code ImageReader} 출력 이미지의 원형 이미지 대기열을 유지하고 하나 이상의 이미지를 선택하여 이들을 {@code ImageWriter}에 보내 카메라 재처리를 할 수 있습니다. + +

+ +

Android for Work 기능

+

이 미리 보기에는 다음과 같은 Android for Work에 대한 새 API가 포함되어 있습니다.

+ + +

+ M 개발자 미리 보기의 모든 API 변경 내용에 대한 상세한 정보는 API 차이점 보고서를 참조하세요. +

diff --git a/docs/html-intl/intl/ko/preview/behavior-changes.jd b/docs/html-intl/intl/ko/preview/behavior-changes.jd new file mode 100644 index 0000000000000..fa9507056b721 --- /dev/null +++ b/docs/html-intl/intl/ko/preview/behavior-changes.jd @@ -0,0 +1,402 @@ +page.title=동작 변경 +page.keywords=미리 보기, SDK, 호환성 +sdk.platform.apiLevel=MNC +@jd:body + +
+ +
+ +

M 개발자 미리 보기에는 새로운 기능 및 특징과 더불어 다양한 시스템 변경과 API 동작 변경 내용이 포함되어 있습니다. + 이 문서에서는 개발자 여러분이 숙지해야 하고 앱을 개발할 때 감안해야 하는 몇 가지 주요 변경 내용을 소개하겠습니다. +

+ +

이전에 Android용 앱을 게시한 적이 있는 경우, 이와 같은 플랫폼 변경으로 인해 앱이 영향을 받을 수 있다는 점을 유의하세요. +

+ +

런타임 권한

+

이 미리 보기에서는 새 권한 모델을 소개합니다. 여기에서는 이제 사용자가 런타임에 직접 앱 권한을 관리할 수 있게 됩니다. + 이 모델을 사용하면 사용자에게 개선된 가시성과 권한에 대한 제어권을 부여하는 한편 앱 개발자에게는 설치와 자동 업데이트 과정을 간소화해줍니다. 사용자는 설치된 여러 앱에 대해 따로따로 권한을 허용하거나 취소할 수 있습니다. + +

+ +

M 미리 보기를 대상으로 하는 앱을 개발하는 경우, 권한 확인과 요청은 런타임에 해야 합니다. + 앱에 어떤 권한이 허용되었는지 판단하려면, 새로운 {@code Context.checkSelfPermission()} 메서드를 호출하면 됩니다. + 권한을 요청하려면 새 {@code Activity.requestPermission()} 메서드를 호출하세요. + 앱이 M을 대상으로 하지 않더라도, 앱을 새 권한 모델에서 테스트해보는 것이 좋습니다. +

+ +

앱에서 새 권한 모델을 지원하는 방법에 대한 자세한 내용은 권한 개발자 미리 보기 페이지를 참조하세요. + + 앱에 미친 영향을 평가하는 방법에 대한 팁은 테스트 가이드를 참조하세요. +

+ +

절전 최적화

+

이 미리 보기에서는 유휴 상태의 기기 및 앱에 대한 새로운 절전 최적화 기능을 소개합니다.

+ +

Doze

+

기기의 플러그가 뽑히고 화면이 꺼진 채로 일정 시간 동안 변화 없는 상태로 유지되면, Doze 상태로 들어갑니다. 이 상태에서는 기기가 시스템을 절전 모드 상태로 유지하려 시도합니다. + 이 모드에서 기기는 정기적으로 잠시 동안 정상 작동을 재개하여 앱 동기화가 일어날 수 있도록 하고 보류된 작업이 있으면 시스템이 이를 수행할 수 있도록 합니다. + +

+ +

앱이 Doze 상태에 있는 동안 다음과 같은 제한 사항이 적용됩니다.

+ +

+

기기가 Doze 모드를 종료하면 보류되어 있던 작업과 동기화를 모두 실행합니다.

+

이 기능을 테스트하려면 개발 머신에 M 미리 보기를 실행하는 기기를 연결하여 다음과 같은 명령을 호출하면 됩니다. + +

+
+$ adb shell dumpsys battery unplug
+$ adb shell dumpsys deviceidle step
+$ adb shell dumpsys deviceidle -h
+
+

참고: 다가오는 Google Cloud 메시지 릴리스에서는 개발자에게 우선 순위가 높은 메시지를 지정하게 해줍니다. + + + 앱이 우선 순위가 높은 GCM 메시지를 수신하면 이 앱에는 기기가 Doze 모드에 있더라도 잠시 네트워크 액세스가 허용됩니다. + +

+ +

앱에서 Doze를 테스트하는 방법에 대한 팁은 테스트 가이드를 참조하세요. + +

+ +

앱 대기 모드

+

이 미리 보기에서는 시스템이 보기에 앱이 활성 사용 중이 아닌 경우 해당 앱은 유휴 상태라고 판별할 수 있습니다. + 일정 시간이 지나면 앱이 유휴 상태인 것으로 간주되는데, 시스템이 다음과 같은 신호 중 하나를 감지하는 경우는 예외입니다. +

+ + + +

기기의 플러그가 뽑혀 있는 경우, 유휴 상태인 것으로 간주된 앱은 자신의 네트워크 액세스를 비활성화하고 동기화와 작업을 일시 중단시킵니다. + 기기가 전원 공급 장치에 연결되면 이와 같은 앱에 네트워크 액세스가 허용되며 보류 중이었던 작업과 동기화를 모두 실행할 수 있습니다. + 기기가 오랜 시간 동안 유휴 상태인 경우, 유휴 앱에는 하루에 한 번 정도 네트워크 액세스가 허용됩니다. +

+ +

이 기능을 테스트하려면 개발 머신에 M 미리 보기를 실행하는 기기를 연결하여 다음과 같은 명령을 호출하면 됩니다. + +

+
+$ adb shell dumpsys battery unplug
+$ adb shell am set-idle <packageName> true
+$ adb shell am set-idle <packageName> false
+$ adb shell am get-idle <packageName>
+
+ +

참고: 다가오는 Google Cloud 메시지(GCM) 릴리스에서는 개발자에게 우선 순위가 높은 메시지를 지정할 수 있습니다. + + + 앱이 우선 순위가 높은 GCM 메시지를 수신하면 이 앱에는 앱이 유휴 상태에 있더라도 잠시 네트워크 액세스가 허용됩니다. + +

+ +

앱에서 앱 대기 모드를 테스트하는 방법에 대한 팁은 테스트 가이드를 참조하세요. + +

+ +

채택 가능한 저장소 기기

+

+이 미리 보기에서는 사용자가 SD 카드와 같은 외부 저장소 기기를 채택할 수 있습니다. 외부 저장소 기기를 채택하면 기기를 암호화하고 포맷하여 내부 저장소처럼 작동하도록 합니다. + 이 기능을 사용하면 사용자가 앱과 해당 앱의 비공개 데이터를 여러 저장소 기기 사이에서 이동시킬 수 있습니다. + 앱을 이동시키는 경우, 시스템은 매니페스트의 {@code android:installLocation} 기본 설정을 사용합니다. + + +

+ +

앱이 다음과 같은 API 또는 필드에 액세스하는 경우, 앱이 내부 및 외부 저장소 기기 사이를 이동하면서 반환하는 파일 경로가 급격하게 달라진다는 점을 유의하세요. 파일 경로를 구축할 때에는 이와 같은 API를 항상 동적으로 호출하는 것을 강력히 권장합니다. 하드코드된 파일 경로를 사용하거나 이전에 구축된 정규화된 파일 경로를 유지하지 마세요. + + +

+ + + +

개발자 미리 보기에서 이 기능을 디버그하려면, 다음 명령을 실행하여 USB On-The-Go(OTG) 케이블을 통해 Android 기기에 연결된 USB 드라이브 채택을 활성화하면 됩니다. +

+ +
+$ adb shell sm set-force-adoptable true
+
+ +

Apache HTTP 클라이언트 제거

+

이 미리 보기에서는 Apache HTTP 클라이언트에 대한 지원을 제거합니다. 앱이 이 클라이언트를 사용하고 Android 2.3(API 레벨 9) 이상을 대상으로 하는 경우, {@link java.net.HttpURLConnection} 클래스를 대신 사용하세요. + + 이는 투명한 압축과 응답 캐싱을 통해 네트워크 사용량을 줄이고 전력 소모를 최소화하기 때문에 API가 더 효율적입니다. + Apache HTTP API를 계속 사용하려면 우선 다음과 같은 컴파일-시간 종속성을 {@code build.gradle} 파일에서 선언해야 합니다. + +

+
+android {
+    useLibrary 'org.apache.http.legacy'
+}
+
+

Android는 OpenSSL에서 BoringSSL 라이브러리로 옮겨갑니다. + + 앱에서 Android NDK를 사용하는 경우, NDK API의 일부분이 아닌 암호화 라이브러리에 대해 링크를 연결하지 마세요(예:{@code libcrypto.so} 및 {@code libssl.so}). + 이러한 라이브러리는 공개 API가 아니며, 여러 릴리스와 기기에 걸쳐 통보 없이 변경되거나 중단될 수 있으며 스스로를 보안 취약점에 노출시킬 수도 있습니다. + + 대신에 원래 코드를 수정하여 JNI를 통해 Java 암호화 API를 호출하도록 하거나, 직접 선택한 암호화 라이브러리에 대해 정적으로 연결하도록 하세요. + +

+ +

AudioManager 변경

+

볼륨을 직접 설정하거나 특정 스트림을 {@link android.media.AudioManager} 클래스를 통해 음소거하는 것은 이제 더 이상 지원되지 않습니다. + {@link android.media.AudioManager#setStreamSolo(int,boolean) +setStreamSolo()} 메서드는 사용이 중단되었으며, 그 대신 {@code AudioManager.requestAudioFocus()} 메서드를 호출해야 합니다. + 이와 마찬가지로, {@link android.media.AudioManager#setStreamMute(int,boolean) setStreamMute()} 메서드도 사용이 중단되었습니다. 그 대신 {@code AudioManager.adjustStreamVolume()} 메서드를 호출하고 방향 값 {@code ADJUST_MUTE} 또는 {@code ADJUST_UNMUTE}에서 전달해야 합니다. + + +

+ +

텍스트 선택

+ + + +

사용자가 앱에서 텍스트를 선택하면 이제 텍스트 선택 작업을 표시할 수 있습니다. 예를 들어 잘라내기, 복사 및 붙여넣기를 부동 도구 모음으로 표시하게 됩니다. + + 이 사용자 상호작용 구현은 상황별 작업 모음에서와 비슷합니다. 이 내용은 각각의 보기에 대한 상황별 작업 모드의 활성화에 설명되어 있습니다. + + +

+ +

텍스트 선택을 위해 부동 도구 모음을 구현하려면 기존 앱에 다음과 같은 변경을 적용하면 됩니다. +

+
    +
  1. {@link android.view.View} 또는 {@link android.app.Activity} 객체에서 {@link android.view.ActionMode} 호출을 {@code startActionMode(Callback)}에서 {@code startActionMode(Callback, ActionMode.TYPE_FLOATING)}로 변경합니다. + +
    2. +
  2. 기존 {@code ActionMode.Callback} 구현을 변경하여 대신 {@code ActionMode.Callback2}를 확장합니다. +
    3. +
  3. {@code Callback2.onGetContentRect()} 메서드를 재정의하여 보기에서 콘텐츠 {@link android.graphics.Rect} 객체(예: 텍스트 선택 직사각형)의 좌표를 제공합니다. +
    4. +
  4. 직사각형 위치 지정이 더 이상 유효하지 않고, 무효화할 요소가 이것뿐인 경우 {@code ActionMode.invalidateContentRect()} 메서드를 호출합니다. +
    5. +
+ +

Android 지원 라이브러리 수정 버전 22.2를 사용하는 경우, 부동 도구 모음은 이전 버전과 호환되지 않으며 AppCompat이 기본적으로 {@link android.view.ActionMode} 객체의 제어권을 넘겨받는다는 점을 유의하세요. + + + 이렇게 하면 부동 도구 모음이 표시되지 않도록 방지합니다. {@link android.support.v7.app.AppCompatActivity}에서 {@link android.view.ActionMode}를 활성화하려면, {@code android.support.v7.app.AppCompatActivity.getDelegate()}를 호출한 다음 {@code android.support.v7.app.AppCompatDelegate.setHandleNativeActionModesEnabled()}를 반환된 {@link android.support.v7.app.AppCompatDelegate} 객체에서 호출하고 입력 매개변수를 {@code false}로 설정하세요. + + + + + + 이 호출은 {@link android.view.ActionMode} 객체의 제어권을 프레임워크에 돌려줍니다. + M 미리 보기를 실행하는 기기에서 이렇게 하면 프레임워크가 {@link android.support.v7.app.ActionBar} 또는 부동 도구 모음 모드를 지원할 수 있고, 한편 M 미리 보기 이전 기기에서는 {@link android.support.v7.app.ActionBar} 모드만 지원됩니다. + +

+ +

Android 키노트 변경

+

이 미리 보기에서는 Android 키노트 제공자가 더 이상 DSA를 지원하지 않습니다. + + ECDSA는 여전히 지원됩니다.

+ +

휴식 중일 때 암호화가 필요하지 않은 키도 보안 잠금 화면이 비활성화되거나 재설정될 때(예: 사용자가 또는 기기 관리자가 재설정) 더 이상 삭제되지 않습니다. + 휴식 중일 때 암호화가 필요한 키는 이러한 이벤트 중에 삭제됩니다. +

+ +

Wi-Fi 및 네트워킹 변경

+ +

이 미리 보기에서는 Wi-Fi와 네트워킹 API에 다음과 같은 동작 변경을 도입합니다.

+ + +

카메라 서비스 변경

+

이 미리 보기에서는 카메라 서비스에서 공유된 리소스에 액세스하는 모델이 이전의 "선착순" 액세스 모델에서 바뀌어 우선 순위가 높은 프로세스를 선호하는 액세스 모델로 변경되었습니다. + + 서비스 동작에 대한 변경 내용은 다음과 같습니다.

+ + +

ART 런타임

+

이제 ART 런타임이 {@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()} 메서드에 대한 액세스 규칙을 제대로 구현할 수 있습니다. + 이 변경 덕분에 이전 버전에서는 Dalvik이 액세스 규칙을 잘못 확인하던 문제를 해결했습니다. 앱이 {@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()} 메서드를 사용하고 액세스 확인을 재정의하고자 하는 경우, {@link java.lang.reflect.Constructor#setAccessible(boolean) setAccessible()} 메서드를 호출하되 입력 매개변수를 {@code true}로 설정한 상태로 사용합니다. + + + + + + 앱이 v7 AppCompat 라이브러리 또는 v7 RecyclerView 라이브러리를 사용하는 경우, 앱을 업데이트하여 이러한 라이브러리의 최신 버전을 사용하도록 해야 합니다. + + + 그렇지 않으면, XML에서 참조되는 모든 사용자 지정 클래스가 업데이트되도록 확인하여 그 클래스 생성자에 액세스할 수 있도록 해야 합니다. +

+ +

이 미리 보기에서는 동적 링커의 동작을 업데이트합니다. 동적 링커는 이제 라이브러리의 {@code soname}과 그 경로(공개 버그 6670) 사이의 차이점을 숙지하고 있으며, 이제 {@code soname} 기준 검색도 구현되었습니다. + + + + 이전에 작동한 앱 중에서 {@code DT_NEEDED} 항목이 있는 경우(주로 빌드 머신의 파일 시스템에 있는 절대 경로) 로딩했을 때 실패할 수 있습니다. +

+ +

이제 {@code dlopen(3) RTLD_LOCAL} 플래그를 올바르게 구현했습니다. 이때 {@code RTLD_LOCAL}이 기본이므로 {@code dlopen(3)}에 대한 호출 중에서 {@code RTLD_LOCAL}을 명시적으로 사용하지 않으면 영향받을 수 있다는 점을 유의하세요(다만 앱이 명시적으로 {@code RTLD_GLOBAL}을 사용한 경우는 예외입니다). + + {@code RTLD_LOCAL}의 경우, 나중에 {@code dlopen(3)}으로 한 호출로 인해 로딩된 라이브러리에서는 기호를 이용할 수 없게 됩니다({@code DT_NEEDED} 항목에 의해 참조된 것과는 반대입니다). + +

+

+ +

APK 유효성 검사

+

이제 플랫폼이 APK에 대해 좀 더 엄격한 유효성 검사를 수행합니다. APK는 파일이 매니페스트에서는 선언되었지만 APK 자체에는 없는 경우 손상된 것으로 간주됩니다. + 콘텐츠가 하나라도 제거되면 APK를 다시 서명해야 합니다. +

+ +

Android for Work 변경

+

이 미리 보기에는 Android for Work에 대해 다음과 같은 동작 변경을 포함합니다.

+ diff --git a/docs/html-intl/intl/ko/preview/features/runtime-permissions.jd b/docs/html-intl/intl/ko/preview/features/runtime-permissions.jd new file mode 100644 index 0000000000000..20c52329aa693 --- /dev/null +++ b/docs/html-intl/intl/ko/preview/features/runtime-permissions.jd @@ -0,0 +1,794 @@ +page.title=권한 +page.tags=previewresources, androidm +page.keywords=권한, 런타임, 미리 보기 +page.image={@docRoot}preview/features/images/permissions_check.png +@jd:body + + +
+
+

간략히 보기

+
    +
  • 앱이 M 미리 보기 SDK를 대상으로 하는 경우, 앱은 사용자에게 설치 시점이 아닌 런타임에 권한을 허용하도록 메시지를 표시합니다. +
    • +
  • 사용자는 앱 설정 화면에서 언제든 권한을 취소할 수 있습니다. +
    • +
  • 앱은 실행될 때마다 자신에게 필요한 권한이 있는지 확인해야 합니다. +
    • +
+ +

이 문서의 내용

+
    +
  1. 개요
    2. +
  2. 런타임 권한에 대한 코딩
    3. +
  3. 런타임 권한 테스트
    4. +
  4. 모범 사례
    5. +
+ + + + +
+
+ + +

+ M 개발자 미리 보기에서는 새로운 앱 권한 모델을 소개하여 사용자가 앱을 설치하고 업그레이드하는 과정을 간소화할 수 있습니다. + M 미리 보기에서 실행되는 앱이 새 권한 모델을 지원하는 경우, 사용자가 앱을 설치하거나 업그레이드할 때 아무런 권한을 허용하지 않아도 됩니다. 그 대신, 앱이 필요할 때마다 권한을 요청하고 시스템이 사용자에게 해당 권한을 요청하는 대화창을 표시합니다. + + + + +

+ +

+ 앱이 새 권한 모델을 지원하는 경우, Android 이전 버전을 실행하는 기기에서도 설치 및 실행할 수 있는 것은 변하지 않습니다. 이 경우, 그러한 기기의 기존 권한 모델을 사용합니다. + + +

+ +

+ 개요 +

+ +

+ M 개발자 미리 보기에서는 플랫폼에 새로운 권한 모델을 도입합니다. + 이 새로운 모델의 주요 구성 요소를 다음과 같이 요약해 보았습니다. +

+ + + +

+ 이 권한 모델은 앱이 권한을 필요로 하는 기능에 대해 동작하는 방식을 바꾸어 놓습니다. + 다음은 이 모델에 적응하기 위한 몇 가지 개발 사례를 요약했습니다. + +

+ + + +

+ 참고: 앱이 M 개발자 미리 보기를 대상으로 하는 경우, 반드시 새 권한 모델을 사용해야 합니다. + +

+ +

+ M 개발자 미리 보기 시작 시점에는 Google 앱 중에 새 권한 모델을 완전히 구현하지 않는 앱도 있습니다. + Google은 이러한 앱을 M 개발자 미리 보기를 시행하면서 시간을 두고 업데이트하여 권한 설정/해제 설정을 제대로 사용하도록 할 예정입니다. + + +

+ +

+ 참고: 앱에 자체 API 표면이 있는 경우, 권한을 대리로 허가하기 전에 우선 발신자에게 해당 데이터에 액세스할 필수 권한이 있는지 확인해야 합니다. + + +

+ +

+ 시스템 앱 및 서명 권한 +

+ +

+ 보통 사용자가 앱을 설치하면 시스템이 앱에 {@link android.content.pm.PermissionInfo#PROTECTION_NORMAL PROTECTION_NORMAL}만 허용합니다. + + 하지만 시스템이 앱에 더 많은 권한을 허용하는 경우도 몇 가지 있습니다. + +

+ + + +

+ 두 가지 경우 모두, 사용자가 언제든 권한을 취소할 수 있는 것은 변하지 않습니다. 시스템의 설정 화면으로 이동하여 앱 > + + app_name > 권한을 선택하면 됩니다. 이 앱은 계속해서 런타임에 권한을 확인하고 필요한 경우 해당 권한을 요청해야 합니다. + + +

+ +

+ 이전 및 이후 버전과의 호환성 +

+ +

+ 앱이 M 개발자 미리 보기를 대상으로 하지 않더라도, 앱은 M 미리 보기 기기에서도 기존 권한 모델을 계속 사용합니다. + 사용자가 앱을 설치하면 시스템이 사용자에게 앱의 매니페스트에 목록으로 표시된 권한을 모두 허용하도록 요청합니다. + + +

+ +

+ 참고: M 개발자 미리 보기를 실행하는 기기에서는 사용자가 어느 앱에 대해서든(레거시 앱 포함) 앱의 설정 화면에서 권한을 끌 수 있습니다. + + 사용자가 레거시 앱에 대한 권한을 끄면, 시스템이 자동으로 적절한 기능을 비활성화합니다. + 앱이 해당 권한을 필요로 하는 작업을 수행하려 시도한다고 해도 그 작업이 반드시 예외를 발생시키는 것은 아닙니다. + + 그 대신에 빈 데이터 세트를 반환하거나 오류를 신호하거나, 기타 예기치 못한 동작을 선보일 수 있습니다. + 예를 들어 권한 없이 캘린더를 쿼리하면 해당 메서드가 빈 데이터 세트를 반환합니다. + +

+ +

+ M 미리 보기를 실행하지 않는 기기에서 새 권한 모델을 사용하는 앱을 설치하면 시스템은 해당 앱을 다른 앱과 똑같이 다룹니다. 즉, 설치 시점에 시스템에 사용자에게 선언된 권한 모두를 허용하도록 요청합니다. + + + +

+ +

+ 참고: 미리 보기 릴리스에서는 최소 SDK 버전을 M 미리 보기 SDK로 설정해야 미리 보기 SDK와 컴파일할 수 있습니다. + 즉, 개발자 미리 보기 시행 중에는 그러한 앱을 기존 플랫폼에서 테스트할 수 없다는 뜻입니다. + + +

+ +

권한과 인텐트 비교

+ +

+ 대부분의 경우, 앱에게 어떤 작업을 수행하도록 하려면 두 가지 방식 중 하나를 선택할 수 있습니다. + 첫째로 앱이 작업을 직접 수행하도록 권한을 요청할 수 있습니다. + 또는, 앱에 인텐트를 사용하도록 하여 또 다른 앱이 해당 작업을 수행하도록 할 수 있습니다. + +

+ +

+ 예를 들어 앱이 기기 카메라로 사진을 촬영할 수 있어야 한다고 가정합시다. + 그러면 앱은 android.permission.CAMERA 권한을 요청할 수 있습니다. 이렇게 하면 앱이 카메라에 직접 액세스할 수 있습니다. + + 그런 다음 앱이 카메라 API를 사용하여 카메라를 제어하고 사진을 촬영합니다. + 이 방식을 사용하면 앱에 사진 촬영 과정에 대해 완전한 제어권을 부여하고, 카메라 UI를 앱에 통합할 수 있습니다. + + +

+ +

+ 하지만, 그러한 제어권이 필요하지 않은 경우라면 그저 {@link android.provider.MediaStore#ACTION_IMAGE_CAPTURE ACTION_IMAGE_CAPTURE} 인텐트를 사용해 이미지를 요청하면 됩니다. + + 이 인텐트를 시작하면 사용자에게 카메라 앱을 선택하라는 메시지가 표시되고(기본 카메라 앱이 이미 있는 경우) 그 앱이 사진을 촬영합니다. + + 이 카메라 앱은 촬영한 사진을 개발자의 앱의 {@link android.app.Activity#onActivityResult onActivityResult()} 메서드에 반환합니다. + +

+ +

+ 이와 마찬가지로, 전화를 걸어야 하거나 사용자의 연락처에 액세스해야 하는 경우 등에는 적절한 인텐트를 만들거나 적절한 객체에 직접 액세스하도록 권한을 요청할 수 있습니다. + + 이 두 가지 방식에는 각각 장단점이 있습니다. + +

+ +

+ 권한을 사용하는 경우: +

+ + + +

+ 인텐트를 사용하는 경우: +

+ + + +

런타임 권한에 대한 코딩

+ +

+ 새로운 M 개발자 미리 보기를 대상으로 앱을 개발하는 경우, 새 권한 모델을 사용해야 합니다. + 이는 즉, 매니페스트에 필요한 권한을 선언하는 것 말고도 런타임에 자신이 해당 권한을 가지고 있는지도 확인해야 하며, 그러한 권한을 이미 가지고 있지 않으면 권한을 요청해야 한다는 뜻입니다. + + + +

+ +

+ 새 권한 모델 활성화하기 +

+ +

+ 새로운 M 개발자 미리 보기 권한 모델을 활성화하려면 앱의 targetSdkVersion 특성을 "MNC"로 설정하고, compileSdkVersion은 "android-MNC"로 설정하세요. + + 이렇게 하면 새 권한 기능이 모두 활성화됩니다. + +

+ +

+ 미리 보기 릴리스에서는 minSdkVersion을 "MNC"로 설정해야만 미리 보기 SDK와 컴파일할 수 있습니다. + +

+ +

+ M 미리 보기 전용 권한 지정하기 +

+ +

+ 새 <uses-permission-sdk-m> 요소를 앱 매니페스트에 사용하여 권한이 M 개발자 미리 보기에서만 필요하다는 것을 나타낼 수 있습니다. + 권한을 이런 식으로 선언하면 앱이 이전 버전의 기기에 설치될 때마다 시스템에서 사용자에게 메시지를 표시하지도 않고 앱에 권한을 허용하지도 않습니다. <uses-permission-sdk-m> 요소를 사용하면 새 권한을 앱의 업데이트된 버전에 추가하면서도 사용자가 업데이트를 설치할 때 권한을 허용하라고 강제로 시키지 않아도 됩니다. + + + + + + +

+ +

+ 앱이 M 개발자 미리 보기를 갖춘 기기에서 실행되는 경우, <uses-permission-sdk-m>은 <uses-permission>과 똑같이 동작합니다. + + + 시스템은 사용자가 앱을 설치할 때 권한을 허용하라는 메시지를 표시하지 않고, 앱이 필요할 때마다 권한을 요청하게 됩니다. + +

+ +

+ 권한에 대한 메시지 표시하기 +

+ +

+ 앱이 새로운 M 개발자 미리 보기 권한 모델을 사용하는 경우, 앱이 M 미리 보기에서 실행되는 기기에서 처음 시작되었을 때 사용자에게 모든 권한을 허용하도록 요청하지 않습니다. + + 대신, 앱은 필요할 때마다 권한을 요청합니다. + 앱이 권한을 요청하면 시스템이 사용자에게 대화창으로 표시합니다. + +

+ +

+ 앱이 SDK 22 이하를 탑재한 기기에서 실행되는 경우, 앱은 기존 권한 모델을 사용합니다. + 사용자가 앱을 설치하면 앱이 자신의 매니페스트에서 요청하는 모든 권한을 허용하라는 메시지가 표시되는데, 이때 <uses-permission-sdk-m>이라는 레이블이 붙은 권한은 예외입니다. + + +

+ +

앱이 실행되는 플랫폼 확인

+ +

+ 이 권한 모델은 M 개발자 미리 보기를 실행하는 기기에서만 지원됩니다. + 이러한 메서드 중에서 호출하려면 앱은 우선 {@link android.os.Build.VERSION#CODENAME Build.VERSION.CODENAME} 값을 확인하여 자신이 어느 플랫폼에서 실행 중인지 확인해야 합니다. + + + 기기가 M 개발자 미리 보기에서 실행 중인 경우, {@link android.os.Build.VERSION#CODENAME CODENAME}은 "MNC"입니다. + +

+ +

앱에 필요한 권한이 있는지 확인

+ +

사용자가 권한을 필요로 하는 무언가를 하려고 시도하면, 앱은 자신이 현재 이 작업을 수행하는 데 필요한 권한을 가지고 있는지 확인합니다. + 이렇게 하기 위해 앱은 Context.checkSelfPermission( )을 호출합니다. + +permission_name 사용자가 앱의 권한을 언제든 취소할 수 있기 때문에 앱은 사용자가 해당 권한을 이미 허용했다는 것을 알고 있더라도 확인 작업을 수행해야 합니다. + + + 예를 들어, 사용자가 사진 촬영 앱을 사용하고자 한다면 앱은 Context.checkSelfPermission(Manifest.permission.CAMERA)를 호출합니다. + +

+ +

+ 표 1. 권한과 권한 그룹.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
권한 그룹권한
android.permission-group.CALENDAR +
    +
  • + android.permission.READ_CALENDAR +
    • +
+
    +
  • + android.permission.WRITE_CALENDAR +
    • +
+
android.permission-group.CAMERA +
    +
  • + android.permission.CAMERA +
    • +
+
android.permission-group.CONTACTS +
    +
  • + android.permission.READ_CONTACTS +
    • +
  • + android.permission.WRITE_CONTACTS +
    • +
  • + android.permission.READ_PROFILE +
    • +
  • + android.permission.WRITE_PROFILE +
    • +
+
android.permission-group.LOCATION +
    +
  • + android.permission.ACCESS_FINE_LOCATION +
    • +
  • + android.permission.ACCESS_COARSE_LOCATION +
    • +
+
android.permission-group.MICROPHONE +
    +
  • + android.permission.RECORD_AUDIO +
    • +
+
android.permission-group.PHONE +
    +
  • + android.permission.READ_PHONE_STATE +
    • +
  • + android.permission.CALL_PHONE +
    • +
  • + android.permission.READ_CALL_LOG +
    • +
  • + android.permission.WRITE_CALL_LOG +
    • +
  • + com.android.voicemail.permission.ADD_VOICEMAIL +
    • +
  • + android.permission.USE_SIP +
    • +
  • + android.permission.PROCESS_OUTGOING_CALLS +
    • +
+
android.permission-group.SENSORS +
    +
  • + android.permission.BODY_SENSORS +
    • +
+
    +
  • + android.permission.USE_FINGERPRINT +
    • +
+
android.permission-group.SMS +
    +
  • + android.permission.SEND_SMS +
    • +
  • + android.permission.RECEIVE_SMS +
    • +
  • + android.permission.READ_SMS +
    • +
  • + android.permission.RECEIVE_WAP_PUSH +
    • +
  • + android.permission.RECEIVE_MMS +
    • +
  • + android.permission.READ_CELL_BROADCASTS +
    • +
+
+ +

필요한 경우 권한 요청

+ +

앱이 자신에게 필요한 권한을 이미 가지고 있지 않은 경우, 앱은 Activity.requestPermissions(String[], int) 메서드를 호출하여 적절한 권한(여러 개일 수 있음)을 요청합니다. + + 앱은 원하는 권한을 요청하면서 정수 "요청 코드"를 요청합니다. + + 이 메서드는 비동기화 방식으로 기능합니다. 이는 즉각적으로 반환되며, 사용자가 대화 상자에 응답한 다음에는 시스템이 결과를 가지고 앱의 콜백 메서드를 호출하여 앱이 requestPermissions()에 전달한 "요청 코드"와 같은 코드를 전달합니다. + + +

+ +

다음 코드는 앱에 사용자의 연락처를 읽을 권한이 있는지 코드 확인을 하고, 필요한 경우 해당 권한을 요청합니다. +

+ +
+if (checkSelfPermission(Manifest.permission.READ_CONTACTS)
+        != PackageManager.PERMISSION_GRANTED) {
+    requestPermissions(new String[]{Manifest.permission.READ_CONTACTS},
+            MY_PERMISSIONS_REQUEST_READ_CONTACTS);
+
+    // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
+    // app-defined int constant
+
+    return;
+}
+
+ +

권한 요청 응답 처리하기

+ +

+ 앱이 권한을 요청하면 시스템이 사용자에게 대화 상자를 표시합니다. + 사용자가 응답하면 시스템은 앱의 Activity.onRequestPermissionsResult(int, String[], int[])를 불러내 이를 사용자 응답에 전달합니다. + + 앱은 해당 메서드를 재정의해야 합니다. 이 콜백에는 개발자가 requestPermissions()에 전달한 것과 같은 요청 코드가 전달됩니다. + + 예를 들어 어느 앱이 READ_CONTACTS 액세스를 요청한다면 다음과 같은 콜백 메서드를 가지고 있을 수 있습니다. + + +

+ +
+@Override
+public void onRequestPermissionsResult(int requestCode,
+        String permissions[], int[] grantResults) {
+    switch (requestCode) {
+        case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {
+            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+
+                // permission was granted, yay! do the
+                // calendar task you need to do.
+
+            } else {
+
+                // permission denied, boo! Disable the
+                // functionality that depends on this permission.
+            }
+            return;
+        }
+
+        // other 'switch' lines to check for other
+        // permissions this app might request
+    }
+}
+
+ +

사용자가 권한을 허용하면 시스템은 앱 매니페스트에 그 기능 영역에 대해 목록으로 표시된 모든 권한을 해당 앱에 부여합니다. + 사용자가 요청을 거부하면 적절한 조치를 취해야 합니다. + 예를 들어 이 권한에 좌우되는 메뉴 작업을 모두 비활성화할 수 있습니다. + + +

+ +

+ 시스템이 사용자에게 권한을 허용하도록 요청하면 사용자에게는 시스템에 해당 권한을 다시 요청하지 말라고 지시할 선택권이 있습니다. + 그런 경우, 앱이 해당 권한을 요청하기 위해 requestPermissions()를 사용하면 시스템이 즉시 요청을 거부합니다. + + 이 경우 시스템은 사용자가 명시적으로 개발자의 요청을 다시 거부한 것처럼 onRequestPermissionsResult()를 호출합니다. + + 이러한 이유로, 앱은 사용자와의 직접적인 상호작용이 일어났다고 가정해서는 안 됩니다. + +

+ +

런타임 권한 테스트

+ + +

+ M 개발자 미리 보기를 대상으로 삼고 앱을 개발하는 경우, 이 앱이 권한을 적절하게 처리하는지 테스트해보아야 합니다. + 앱이 실행될 때 특정 권한을 가지고 있다고 가정해서는 안 됩니다. + 앱을 처음 시작할 때에는 아무런 권한도 없을 가능성이 높고, 사용자가 언제든 권한을 취소하거나 복원할 수 있기 때문입니다. + + +

+ +

+ 앱을 테스트하여 모든 권한 관련 상황에서 제대로 작동하는지 확인하는 것이 좋습니다. + M 미리 보기 SDK에서는 새로운 Android 디버그 브리지(adb) 명령을 제공하여 여러분이 시도해 보아야 하는 권한 설정이 무엇이든 앱을 테스트할 수 있도록 하였습니다. + + + +

+ +

+ 새로운 adb 명령 및 선택 사항 +

+ +

+ M 미리 보기 SDK 플랫폼 도구에서는 여러 가지 새로운 명령을 제공하여 앱이 권한을 처리하는 방식을 테스트해볼 수 있습니다. + +

+ +

+ 권한으로 설치 +

+ +

+ adb + install 명령의 새로운 -g 선택 항목을 사용하면 앱을 설치하고 해당 앱의 매니페스트에 목록으로 표시된 모든 권한을 허용합니다. + +

+ +
+$ adb install -g <path_to_apk>
+
+ +

+ 권한 허용 및 취소 +

+ +

+ 새로운 ADB 패키지 관리자(pm) 명령을 사용하면 설치된 앱에 권한을 허용하고 취소할 수 있습니다. 이 기능은 자동화 설정에서 유용하게 쓰일 수 있습니다. + + +

+ +

+ 권한을 허용하려면, 패키지 관리자의 grant 명령을 사용하세요. +

+ +
+$ adb pm grant <package_name> <permission_name>
+
+ +

+ 예를 들어 com.example.myapp 패키지 권한을 허용하여 오디오를 녹음하려면 이 명령을 사용하면 됩니다. + +

+ +
+$ adb pm grant com.example.myapp android.permission.RECORD_AUDIO
+
+ +

+ 권한을 취소하려면, 패키지 관리자의 revoke 명령을 사용하세요. +

+ +
+$ adb pm revoke <package_name> <permission_name>
+
+ +

모범 사례

+ +

+ 새 권한 모델을 사용하면 사용자에게 보다 원활한 환경을 제공하고, 앱을 더욱 쉽게 설치하며 앱이 어떤 작업을 하고 있는지 바로 확인할 수 있습니다. + + 새 모델의 장점을 최대한 활용할 수 있도록 다음과 같은 모범 사례를 추천해 드립니다. + +

+ + +

필요한 권한만 요청

+ +

+ 권한을 요청할 때마다 사용자에게는 결정을 내리라는 강요를 하는 셈입니다. + 사용자가 요청을 거절하면 앱의 기능이 저하됩니다. + 때문에 이러한 요청을 하는 횟수를 최소한으로 줄이는 것이 좋습니다. +

+ +

+ 예를 들어 앱이 권한을 요청하는 대신 인텐트를 사용해 필요한 기능을 얻을 수 있는 경우도 꽤 많습니다. + + 앱이 전화기의 카메라를 사용해 사진을 촬영해야 하는 경우, 앱은 {@link android.provider.MediaStore#ACTION_IMAGE_CAPTURE MediaStore.ACTION_IMAGE_CAPTURE} 인텐트를 사용할 수 있습니다. + + + 앱이 인텐트를 실행하면 시스템이 사용자에게 메시지를 표시해 이미 설치된 카메라 앱을 선택하여 사진을 촬영하도록 합니다. + + +

+ +

+ 사용자에게 부담을 주지 말 것 +

+ +

+ 사용자에게 엄청나게 많은 수의 권한 요청을 한꺼번에 들이밀면 사용자가 부담을 느끼고 앱을 종료해버리는 결과를 초래할 수 있습니다. 대신 권한이 필요할 때마다 요청하는 것이 좋습니다. + + +

+ +

+ 일부 경우에는 앱에 절대적으로 꼭 필요한 권한이 한 개 이상 있을 수도 있습니다. 그런 경우에는 앱이 시작되자마자 해당 권한을 모두 요청하는 것을 권장합니다. + + 예를 들어 사진 앱을 만들면 앱이 기기 카메라로 액세스할 수 있는 권한이 필요합니다. + 사용자가 앱을 처음으로 시작할 때 카메라를 사용할 권한을 요청받아도 놀라지는 않을 것입니다. + + 하지만 같은 앱에 사용자의 연락처과 사진을 공유하는 기능도 있다고 가정한다면 이 경우 해당 권한을 첫 시작 시점에 요청하는 것은 별로 권장할 만한 일이 아닙니다. + + 대신, 사용자가 "공유" 기능을 요청하려 할 때까지 기다렸다가 그 때 해당 권한을 요청하면 됩니다. + +

+ +

+ 앱이 튜토리얼을 제공하는 경우, 튜토리얼 시퀀스가 다 끝날 무렵에 앱의 필수 권한을 요청하는 것이 이치에 맞을 수 있습니다. + +

+ +

+ 권한이 필요한 이유 설명 +

+ +

+ 개발자가 requestPermissions()를 호출하면 시스템이 표시하는 권한 대화창에는 앱이 원하는 권한이 무엇인지는 나타나 있지만 그것이 필요한 이유는 설명하지 않습니다. + + 사용자가 이런 것을 의아하게 여기는 경우가 있을 수 있습니다. + 우선 사용자에게 앱이 왜 그런 권한을 원하는지 설명한 다음 requestPermissions()를 호출하는 것이 좋습니다. + +

+ +

+ 예를 들어 사진 앱인 경우 위치 서비스를 이용하고자 할 수 있습니다. 그래야 사진에 지오태그를 표시할 수 있기 때문입니다. + 일반적인 사용자는 사진에 위치 정보를 담을 수 있다는 점을 모를 수도 있고, 그러면 사진 앱이 왜 위치를 알고 싶어 하는지 의아하게 여길 수 있습니다. + + 그러므로 이런 경우에는 앱이 사용자에게 이런 기능에 대해 미리 알려드린 후 requestPermissions()를 호출하는 것이 좋습니다. + + +

+ +

+ 이를 수행하기 위한 한 가지 방법은 이러한 요청을 앱 튜토리얼에 넣는 것입니다. 튜토리얼에는 앱의 각 기능을 표시할 수 있고, 그러면서 어느 권한이 필요한지 설명할 수도 있기 때문입니다. + + 예를 들어 사진 앱의 튜토리얼에서 "연락처 목록의 지인들과 사진 공유" 기능을 시연한 다음 사용자에게 앱이 사용자의 연락처를 보려면 권한을 부여해야 한다고 알리면 됩니다. + + + 그런 다음, 앱이 requestPermissions()를 호출하여 사용자에게 해당 액세스를 요청합니다. + 물론 튜토리얼을 따르지 않는 사용자도 있게 마련이므로 앱의 정상 작동 중에 권한을 확인하고 요청해야 합니다. + + +

diff --git a/docs/html-intl/intl/ko/preview/overview.jd b/docs/html-intl/intl/ko/preview/overview.jd new file mode 100644 index 0000000000000..d32572590f9cc --- /dev/null +++ b/docs/html-intl/intl/ko/preview/overview.jd @@ -0,0 +1,362 @@ +page.title=프로그램 개요 +page.metaDescription=Android M 개발자 미리 보기를 시작하신 여러분, 환영합니다. 이 프로그램은 Android의 다음 버전에 대해 앱을 테스트하고 최적화하는 데 필요한 모든 것을 제공해 드립니다. +page.image=images/cards/card-preview_16-9_2x.png +page.tags="preview", "developer", "android" + +@jd:body + +

+ Android M 개발자 미리 보기를 시작하신 여러분, 환영합니다. 이 프로그램은 Android의 다음 버전에 대해 앱을 테스트하고 최적화하는 데 필요한 모든 것을 제공해 드립니다. + + 이 프로그램은 무료이며, M 개발자 미리 보기 도구만 다운로드하면 시작하실 수 있습니다. + +

+ +
+
+
+
+
+ 하드웨어 및 에뮬레이터 시스템 이미지 +
+ +

+ Nexus 5, 6, 9, Player(TV용)와 에뮬레이터에서 앱을 실행하고 테스트해 보세요. + +

+
+ +
+
+ 최신 플랫폼 코드 +
+ +

+ 미리 보기 시행 중에 여러 번의 업데이트를 제공할 예정입니다. 이로써 여러분은 항상 최신 플랫폼 변경에 대해 테스트할 수 있습니다. + +

+
+ +
+
+ 업데이트를 OTA로 전달 +
+ +

+ 일단 기기를 최초 미리 보기에 플래시하고 나면 OTA로 업데이트를 받을 수 있습니다. + +

+
+
+ +
+ + +
+
+ 새 동작 및 기능 +
+ +

+ 작업을 일찍 시작하여 새 런타임 권한 모델과 절전 기능 등 새로운 플랫폼 동작을 지원합니다. + +

+
+ +
+
+ 개발자가 보고한 문제에 대한 우선 순위 창 +
+ +

+ Google에서는 처음 몇 주 동안 개발자가 보고한 문제에 우선 순위를 부여할 예정입니다. 가능한 빨리 테스트하고 피드백을 보내 주세요. + +

+
+ +
+
+ 피드백 및 지원 +
+ +

+ 문제를 보고하고 Google의 문제 추적기를 사용해 피드백을 보내 주세요. + M 개발자 커뮤니티를 이용하면 다른 개발자들과 의견을 주고받을 수 있습니다. + +

+
+
+
+
+ + + + +

+ 일정 및 업데이트 +

+Preview program timeline +

+ M 개발자 미리 보기는 5월 28일부터 최종 Android M SDK가 출시될 때까지 실행됩니다. 최종 버전은 2015년 3사분기 중으로 예정된 공개 릴리스 직전에 출시할 계획입니다. + + +

+ +

+ 개발 중 중요 단계에 다다를 때마다 여러분의 테스트 기기를 위해 업데이트를 전달해 드리겠습니다. + 잠정적인 중요 단계는 다음과 같습니다. +

+ + + +

+ 이러한 업데이트는 최종 SDK(3사분기 후반)로 막을 내릴 것이며, 이것으로 Android 새 버전에 대한 공식 API뿐만 아니라 최종 시스템 동작 및 기능도 제공하게 됩니다. + + +

+ +

+ Android M에서 테스트와 개발을 수행하는 동안 미리 보기 업데이트가 출시되는 것에 맞춰 개발 환경을 최신 상태로 유지할 것을 강력히 권장합니다. + + 이 과정을 보다 단순화하기 위해 이미 미리 보기 빌드에 플래시한 기기에는 OTA(over-the-air) 업데이트를 제공할 예정이며, 이외에도 수동으로 다운로드하고 플래시할 수 있는 시스템 이미지도 제공할 계획입니다. + + +

+

+ 참고: 최종 SDK와 시스템 이미지는 OTA로 전달할 수 없습니다. 그 대신 개발자 본인의 테스트 기기에서 수동으로 플래시해야 합니다. + + +

+ +

+ 미리 보기 업데이트를 이용할 수 있게 될 때마다 Android 개발자 블로그, 해당 사이트 및 Android M 개발자 커뮤니티를 통해서 알려드릴 것입니다. + + +

+ +

+ 미리 보기 내용 +

+ +

+ M 개발자 미리 보기에는 기존 앱을 여러 가지 화면 크기, 네트워크 기술, CPU/GPU 칩세트 및 하드웨어 아키텍처에서 테스트하는 데 필요한 모든 것이 포함되어 있습니다. + + +

+ +

+ SDK 도구 +

+ +

+ 이러한 구성 요소는 Android Studio에서 SDK Manager를 통해 다운로드할 수 있습니다. +

+ + + +

+ 하드웨어 시스템 이미지 +

+ +

+ Nexus 기기에 대한 다음과 같은 하드웨어 시스템 이미지는 다운로드 페이지에서 다운로드할 수 있습니다. + +

+ + + +

+ 관련 문서 및 샘플 코드 +

+ +

+ 다음과 같은 관련 문서 리소스는 미리 보기에 대해 익히는 데 유용합니다. +

+ + + +

+ 지원 리소스 +

+ +

+ M 개발자 미리 보기에서 테스트하고 개발하는 데 유용한 지원 리소스를 소개합니다. + +

+ + + + +

+ 대상 지정, 미리 보기 API 및 게시 +

+ +

+ Android M 개발자 미리 보기는 개발 전용 릴리스이며 표준 API 레벨이 없습니다. + 앱을 테스트하기 위해 호환성 동작에서 옵트아웃하고자 하는 경우(강력히 권장함), M 개발자 미리 보기를 대상으로 지정하면 됩니다. 앱의 targetSdkVersion을 “MNC”로 지정하세요. + + + +

+ +

+ Android M 개발자 미리 보기에서는 미리 보기 API를 제공합니다. —이 API는 최종 SDK가 출시될 때까지 공식적인 버전으로 인정되지 않습니다. 최종 SDK 릴리스는 현재 2015년 삼사분기 무렵으로 예정되어 있습니다. + + 이는 즉, 시간이 지나면서 사소한 API 변경이 있을 것이라는 점을 예상해야 한다는 뜻입니다. 특히 프로그램 초반 몇 주 동안은 유의해야 합니다. + + Android M 개발자 미리 보기를 업데이트할 때마다 변경 내용을 요약해서 제공해 드릴 것입니다. + +

+ +

+ 미리 보기 API는 변경될 수 있지만, 런타임 권한과 절전 기능과 같은 기본 시스템 동작은 안정적이며 지금 바로 테스트 가능한 상태입니다. + + +

+ +

+ 게시에 관해서는, Google Play에서는 M 개발자 미리 보기를 대상으로 삼는 앱의 게시를 방지합니다. + Android M 최종 SDK를 이용할 수 있게 되면 공식 Android M API 레벨을 대상으로 지정할 수 있고, 그때 Google Play에 앱을 게시하면 됩니다. + + 그때까지는 테스터들에게 Android M을 대상으로 지정한 앱을 배포하고자 하는 경우 이메일이나 본인의 사이트에서 직접 다운로드를 통해 하시면 됩니다. + + +

+ +

+ 시작 방법 +

+ +

+ 앱 테스트를 시작하려면 +

+ +
    +
  1. API 개요와 동작 변경을 검토해 새로운 내용과 이것이 본인의 앱에 미치는 영향에 대해 알고 있어야 합니다. + + 특히, 새로운 런타임 권한 모델, 절전 기능과 자동 백업에 대해 숙지하는 것이 좋습니다. + + +
    2. + +
  2. 환경을 설정할 때에는 미리 보기 SDK 설정과 테스트 기기를 구성하는 데 관련된 지침을 따르세요. + + +
    3. + +
  3. 플래시 지침을 따라 최신 M 개발자 미리 보기 시스템 이미지를 Nexus 5, 6, 9 및 Player에 플래시하세요. + + 일단 개발 기기를 플래시하고 나면, 미리 보기 업데이트가 OTA(over-the-air) 업데이트를 통해 전달됩니다. + +
    4. + +
  4. M 미리 보기 API 참조와 M 미리 보기 샘플을 다운로드하면 새로운 API 기능과 앱에서 그러한 기능을 사용하는 방법에 대해 좀 더 자세히 파악할 수 있습니다. + + + +
    5. + +
  5. Android M 개발자 커뮤니티에 가입하여 최신 소식을 알아보고, 새 플랫폼으로 작업하는 다른 개발자들과 이야기를 나눠보세요. + + +
    6. +
+ +

+ Android M 개발자 미리 보기 프로그램에 참가해 주셔서 대단히 감사합니다! +

diff --git a/docs/html-intl/intl/pt-br/preview/api-overview.jd b/docs/html-intl/intl/pt-br/preview/api-overview.jd new file mode 100644 index 0000000000000..33e8c1f6f46fd --- /dev/null +++ b/docs/html-intl/intl/pt-br/preview/api-overview.jd @@ -0,0 +1,521 @@ +page.title=Visão geral da API +page.keywords=preview,sdk,compatibility +page.tags=previewresources, androidm +sdk.platform.apiLevel=22-mnc +page.image=images/cards/card-api-overview_16-9_2x.png +@jd:body + + +
+ +
+ +

O M Developer Preview fornece uma visualização avançada no próximo lançamento + para a plataforma Android, oferecendo novos recursos para desenvolvedores e usuários +de aplicativos. Este documento fornece uma introdução às APIs mais notáveis.

+ +

O M Developer Preview foi feito para novos desenvolvedores +adotantes e testadores. Caso tenha interesse + em influenciar a direção da estrutura do Android, +experimente o M Developer + Preview e envie-nos feedback!

+ +

Cuidado: não publique aplicativos +que usam o M Developer Preview na Google Play Store.

+ +

Observação: este documento frequentemente +menciona classes e métodos que ainda não possuem material de referência disponível em developer.android.com. Esses elementos de API +são formatados em {@code code style} neste documento (sem hyperlinks). Para a +documentação de API preliminar destes elementos, faça o download da referência da prévia.

+ +

Alterações importantes de comportamento

+ +

Caso tenha publicado anteriormente um aplicativo para Android, saiba que ele pode ser afetado +pelas alterações na plataforma.

+ +

Consulte alterações de comportamento para obter mais informações.

+ +

Vínculo de aplicativo

+

Esta prévia aprimora o sistema de intenções do Android fornecendo vínculo de aplicativo mais poderoso. +Este recurso permite que você associe um aplicativo com um domínio de web próprio. Com base nesta +associação, a plataforma pode determinar o aplicativo padrão a ser usado para lidar com um link da web +em particular e ignorar a solicitação aos usuários para selecionar um aplicativo. Para aprender como implementar este aplicativo, consulte +vínculo de aplicativo. + +

Backup automático para aplicativos

+

O sistema agora realiza backup automático completo de dados e restauração para aplicativos. Este comportamento +é ativado por padrão para aplicativos com M Preview; não é necessário mais código adicional. Se +os usuários excluírem as contas da Google, os dados de backup também serão excluídos. Para aprender como este recurso +funciona e como configurar o backup no sistema do arquivo, consulte +backup automático para aplicativos.

+ +

Autenticação

+

Esta prévia oferece novas APIs para permitir que você autentique os usuários usando digitalizadores de impressão digital em dispositivos +suportados e verifique o quão recentemente os usuários autenticaram pela última vez usando o +mecanismo de desbloqueio por dispositivo (como senha de tela de bloqueio). Use essas APIs em conjunto com +o sistema Android Keystore.

+ +

Autenticação com impressão digital

+ +

Para autenticar os usuários por meio de digitalização de impressão digital, adquira uma instância da nova classe +{@code android.hardware.fingerprint.FingerprintManager} e chame o método +{@code FingerprintManager.authenticate()}. O aplicativo deve ser executado em um dispositivo +compatível com sensor de impressão digital. Deve-se implementar a interface do usuário para o fluxo de autenticação +de impressão digital no aplicativo e usar o ícone de impressão digital padrão do Android na IU. +O ícone de impressão digital do Android ({@code c_fp_40px.png}) é incluído no +aplicativo de exemplo. Caso esteja desenvolvendo vários aplicativos que usam +autenticação de impressão digital, observe que cada aplicativo deve autenticar a impressão digital do usuário independentemente. +

+ +

Para usar este recurso no aplicativo, adicione primeiro a permissão {@code USE_FINGERPRINT} no +manifesto.

+ +
+<uses-permission
+        android:name="android.permission.USE_FINGERPRINT" />
+
+ + + +

Para ver a implementação do aplicativo da autenticação com impressão digital, consulte o + + exemplo de caixa de diálogo de impressão digital.

+ +

Caso esteja testando este recurso, siga estas etapas:

+
    +
  1. Instale o Android SDK Tools Revision 24.3, caso ainda não tenha instalado.
    2. +
  2. Registre uma nova impressão digital no emulador acessando +Configurações > Segurança > Impressão digital e, em seguida, siga as instruções de registro.
    3. +
  3. Use um emulador para emular eventos de toque de dedo com o +comando a seguir. Use o mesmo comando para emular os eventos de toque de impressão digital na tela de +bloqueio ou no aplicativo. +
    +adb -e emu finger touch <finger_id>
+
    +

    No Windows, talvez seja necessário executar {@code telnet 127.0.0.1 <emulator-id>} seguido de +{@code finger touch <finger_id>}. +

    +
    4. +
+ +

Confirmação de credencial

+

O aplicativo pode autenticar os usuários com base no quão recentemente o dispositivo foi desbloqueado pela última vez. Este +recurso libera o usuário de ter que lembrar de senhas específicas de aplicativo extras e evita +a necessidade de implementar a própria interface do usuário de autenticação. O aplicativo deve usar este recurso +em conjunto com uma implementação de chave secreta ou pública para a implementação de usuário.

+ +

Para definir uma duração de tempo limite em que a mesma chave pode ser usada novamente +após o usuário autenticar, chame o novo método +{@code android.security.keystore.KeyGenParameterSpec.setUserAuthenticationValidityDurationSeconds()} + ao definir um {@link javax.crypto.KeyGenerator} ou +{@link java.security.KeyPairGenerator}. Este recurso funciona para operações criptográficas +simétricas.

+ +

Evite exibir o diálogo de nova autenticação excessivamente — os aplicativos devem tentar +usar o objeto criptográfico primeiro e, se o tempo limite expirar, usar o método +{@link android.app.KeyguardManager#createConfirmDeviceCredentialIntent(java.lang.CharSequence, java.lang.CharSequence) createConfirmDeviceCredentialIntent()} + para autenticar novamente o usuário dentro do aplicativo. +

+ +

Para ver uma implementação de aplicativo deste recurso, consulte o + +exemplo de confirmação de credencial.

+ +

Compartilhamento direto

+ + + +

Esta prévia fornece as APIs para tornar o compartilhamento intuitivo e rápido para os usuários. É possível +definir os alvos de compartilhamento direto que iniciam uma atividade específica no aplicativo. +Esses alvos de compartilhamento direto são expostos aos usuários por meio do menu Compartilhar. Este recurso permite que os usuários +compartilhem conteúdos aos alvos, como contatos, dentro de outros aplicativos. Por exemplo: o alvo de compartilhamento direto +pode iniciar uma atividade em outro aplicativo de rede social, o que permite que o usuário compartilhe o conteúdo diretamente +para um amigo ou comunidade específica neste aplicativo.

+ +

Para ativar os alvos de compartilhamento direto, deve-se definir uma classe que estende a classe +{@code android.service.}
+{@code chooser.ChooserTargetService}. Declare o +{@code ChooserTargetService} no manifesto. Dentro desta declaração, especifique a permissão +{@code BIND_CHOOSER_TARGET_SERVICE} e um filtro de intenções na ação +{@code SERVICE_INTERFACE}.

+

O seguinte exemplo mostra como se deve declarar o {@code ChooserTargetService} no +manifesto.

+
+<service android:name=".ChooserTargetService"
+        android:label="@string/service_name"
+        android:permission="android.permission.BIND_CHOOSER_TARGET_SERVICE">
+    <intent-filter>
+        <action android:name="android.service.chooser.ChooserTargetService" />
+    </intent-filter>
+</service>
+
+ +

Para cada atividade que quiser expor ao {@code ChooserTargetService}, adicione um elemento +{@code <meta-data>} com o nome +{@code "android.service.chooser.chooser_target_service"} no manifesto do aplicativo. +

+ +
+<activity android:name=".MyShareActivity”
+        android:label="@string/share_activity_label">
+    <intent-filter>
+        <action android:name="android.intent.action.SEND" />
+    </intent-filter>
+<meta-data
+        android:name="android.service.chooser.chooser_target_service"
+        android:value=".ChooserTargetService" />
+</activity>
+
+ +

Interações por voz

+

+Esta prévia fornece uma API de interação por voz que, junto com +ações de voz +, permite a criação de experiências por voz nos aplicativos. Chame o método +{@code android.app.Activity.isVoiceInteraction()} para determinar se a atividade +foi iniciada em resposta à ação de voz. Caso tenha sido iniciada, o aplicativo pode usar a classe +{@code android.app.VoiceInteractor} para solicitar uma confirmação de voz do usuário, +selecionar a partir de uma lista de opções e muito mais. Para aprender mais sobre a implementação de ações de voz, consulte +o site de desenvolvedor de ações de voz. +

+ +

Auxiliar API

+

+Esta prévia oferece uma nova maneira de usuários se envolverem com os aplicativos com um assistente. Para usar este +recurso, o usuário deve possibilitar que o assistente use o contexto atual. Quando ativado, +o usuário pode invocar um assistente dentro de qualquer aplicativo mantendo o botão Iniciar pressionado.

+

O aplicativo pode optar por não compartilhar o contexto atual com o assistente configurando o sinalizador +{@link android.view.WindowManager.LayoutParams#FLAG_SECURE}. Além do conjunto +padrão de informações que a plataforma passa ao assistente, o aplicativo pode compartilhar +informações adicionais usando a nova classe {@code android.app.Activity.AssistContent}.

+ +

Para fornecer ao assistente contexto adicional do aplicativo, siga estas etapas:

+ +
    +
  1. Implemente a interface {@link android.app.Application.OnProvideAssistDataListener}.
    2. +
  2. Registre esta escuta usando +{@link android.app.Application#registerOnProvideAssistDataListener(android.app.Application.OnProvideAssistDataListener) registerOnProvideAssistDataListener()}.
    3. +
  3. Para fornecer informações contextuais específicas da atividade, substitua o retorno de chamada +{@link android.app.Activity#onProvideAssistData(android.os.Bundle) onProvideAssistData()} + e, opcionalmente, o novo retorno de chamada {@code Activity.onProvideAssistContent()}. +
+ +

Notificações

+

Esta prévia adiciona as seguintes alterações de API às notificações:

+ + +

Suporte para Bluetooth Stylus

+

Esta prévia fornece um suporte aprimorado para a entrada de usuário usando um Bluetooth Stylus. Os usuários podem +parear e conectar um Bluetooth Stylus compatível com o telefone ou tablet. Quando conectado, as informações +de posição da tela tátil são fundidas com as informações de botão e pressão do Stylus +para fornecer um alcance maior de expressão em comparação à tela tátil sozinha. O aplicativo pode escutar o pressionar +de botões do Stylus e realizar ações secundárias registrando os novos retornos de chamada +{@code View.onStylusButtonPressListener} e {@code GestureDetector.OnStylusButtonPressListener} + na atividade.

+ +

Use as constantes e os métodos {@link android.view.MotionEvent} para detectar as interações +de botão do Stylus:

+ + +

Digitalização de baixa energia por Bluetooth aprimorada

+

+Se o aplicativo realizar digitalizações de baixa energia por Bluetooth, é possível usar o novo método +{@code android.bluetooth.le.ScanSettings.Builder.setCallbackType()} para especificar +que você quer que os retornos de chamada sejam notificados apenas quando um pacote de propaganda correspondente ao conjunto +{@link android.bluetooth.le.ScanFilter} for encontrado primeiro e quando +ele não for visto por um período. Esta abordagem de digitalização é mais eficiente +do que a fornecida na versão anterior da plataforma. +

+ +

Suporte a Hotspot 2.0 Release 1

+

+Esta prévia adiciona suporte ao Hotspot 2.0 Release 1 nos dispositivos Nexus 6 e Nexus 9. Para fornecer +as credenciais de Hotspot 2.0 no aplicativo, use os novos métodos da classe +{@link android.net.wifi.WifiEnterpriseConfig}, como {@code setPlmn()} e +{@code setRealm()}. No objeto {@link android.net.wifi.WifiConfiguration}, é possível definir os campos +{@link android.net.wifi.WifiConfiguration#FQDN} e {@code providerFriendlyName}. +A nova propriedade {@code ScanResult.PasspointNetwork} indica se uma rede detectada representa +um ponto de acesso Hotspot 2.0. +

+ +

Modo de exibição 4K

+

A plataforma agora permite que aplicativos solicitem que a resolução seja aprimorada para renderização 4K +em hardware compatível. Para consultar a resolução física atual, use as novas APIs +{@code android.view.Display.Mode}. Se a IU for desenhada em uma resolução lógica +menor e for redimensionada para uma resolução física maior, saiba que a resolução física que o método +{@code Display.Mode.getPhysicalWidth()} retorna pode ser diferente da resolução +física informada por {@link android.view.Display#getSize(android.graphics.Point) getSize()}.

+ +

É possível solicitar que o sistema altere a resolução física no aplicativo à medida que ele é executado configurando +a propriedade {@code WindowManager.LayoutParams.preferredDisplayModeId} da janela do aplicativo. Este +recurso é útil se quiser alternar para a resolução de exibição 4K. Enquanto estiver no modo de exibição 4K, +a IU continua a ser renderizada na resolução original (como 1080 p) e é escalonada para 4K, mas os objetos +{@link android.view.SurfaceView} podem exibir o conteúdo na resolução nativa.

+ +

ColorStateLists com tema

+

Os atributos de tema agora são suportados no +{@link android.content.res.ColorStateList} para dispositivos que executam o M Preview. Os métodos +{@link android.content.res.Resources#getColorStateList(int) getColorStateList()} e +{@link android.content.res.Resources#getColor(int) getColor()} ficaram obsoletos. Caso esteja chamando +essas APIs, chame os novos métodos {@code Context.getColorStateList()} ou +{@code Context.getColor()}. Esses métodos também estão disponíveis na biblioteca +v4 appcompat via {@link android.support.v4.content.ContextCompat}.

+ +

Recursos de áudio

+ +

Esta prévia adiciona aprimoramentos ao processamento de áudio no Android, incluindo:

+ + +

Recursos de vídeo

+

Esta prévia adiciona novas capacidades às APIs de processamento de vídeo, incluindo:

+ + +

Recursos de câmera

+

Esta prévia inclui as seguintes novas APIs para acessar a lanterna da câmera +e para o reprocessamento da câmera de imagens:

+ +

API da lanterna

+

Se um dispositivo de câmera tem uma unidade de flash, é possível chamar o método {@code CameraManager.setTorchMode()} +para ligar ou desligar o modo de tocha da unidade de flash sem abrir o dispositivo da câmera. O aplicativo +não tem propriedade exclusiva da unidade de flash ou do dispositivo de câmera. O modo de tocha é desativado +e torna-se indisponível sempre que o dispositivo de câmera estiver indisponível ou quando outros +recursos de câmera que mantêm a tocha ativada ficam indisponíveis. Outros aplicativos também podem chamar {@code setTorchMode()} +para desativar o modo de tocha. Quando o aplicativo que ativou o modo +de tocha for fechado, o modo é desativado.

+ +

É possível registrar um retorno de chamada para ser notificado sobre o estado da tocha chamando o método +{@code CameraManager.registerTorchCallback()}. Na primeira vez que o retorno de chamada é registrado, +ele é imediatamente chamado com o estado do modo de tocha de todos os dispositivos de câmera conhecidos com +uma unidade de flash. Se o modo de tocha é ativado ou desativado, o método +{@code CameraManager.TorchCallback.onTorchModeChanged()} é invocado.

+ +

API de reprocessamento

+

A API {@link android.hardware.camera2 Camera2} é estendida para suportar YUV e reprocessamento +de imagem de formato opaco privado. O aplicativo determina se as capacidades de reprocessamento estão disponíveis +via {@code CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES}. Se um dispositivo suporta o reprocessamento, +é possível criar uma sessão de captura de câmera de reprocessamento chamando +{@code CameraDevice.createReprocessableCaptureSession()} e criando solicitações para o reprocessamento +do buffer de entrada.

+ +

Use a classe {@code ImageWriter} para conectar o fluxo de buffer de entrada à entrada de reprocessamento +da câmera. Para obter um buffer vazio, siga este modelo de programação:

+ +
    +
  1. Chame o método {@code ImageWriter.dequeueInputImage()}.
    2. +
  2. Preencha os dados no buffer de entrada.
    3. +
  3. Envie o buffer à câmera chamando o método {@code ImageWriter.queueInputImage()}.
    4. +
+ +

Caso esteja usando um objeto {@code ImageWriter} junto com uma imagem +{@code android.graphics.ImageFormat.PRIVATE}, o aplicativo não poderá acessar os dados +da imagem diretamente. Em vez disso, passe a imagem {@code ImageFormat.PRIVATE} diretamente ao +{@code ImageWriter} chamando o método {@code ImageWriter.queueInputImage()} sem nenhuma +cópia de buffer.

+ +

A classe {@code ImageReader} agora suporta as transmissões de imagem +de formato {@code android.graphics.ImageFormat.PRIVATE}. Este suporte permite que o aplicativo mantenha uma fila de imagem circular de imagens de saída +{@code ImageReader}, selecione uma ou mais imagens e envie-as para +{@code ImageWriter} para o reprocessamento de câmera.

+ +

Recursos do Android for Work

+

Esta prévia inclui as seguintes novas APIs para Android for Work:

+ + +

+ Para obter uma vista detalhada de todas as alterações de API no M Developer Preview, consulte o relatório de diferenças de API. +

diff --git a/docs/html-intl/intl/pt-br/preview/behavior-changes.jd b/docs/html-intl/intl/pt-br/preview/behavior-changes.jd new file mode 100644 index 0000000000000..cd99bbd449e33 --- /dev/null +++ b/docs/html-intl/intl/pt-br/preview/behavior-changes.jd @@ -0,0 +1,402 @@ +page.title=Mudanças de comportamento +page.keywords=preview,sdk,compatibility +sdk.platform.apiLevel=MNC +@jd:body + +
+ +
+ +

Junto com novas capacidades e recursos, o M Developer Preview inclui uma variedade +de mudanças do sistema e alterações no comportamento da API. Este documento destaca algumas +das alterações principais que você deve entender e levar em consideração nos aplicativos.

+ +

Caso tenha publicado anteriormente um aplicativo para Android, saiba que ele pode ser afetado + pelas alterações na plataforma.

+ +

Permissões do tempo de execução

+

Esta prévia introduz um novo modelo de permissões em que os usuários podem gerenciar diretamente + as permissões do aplicativo no tempo de execução. Este modelo fornece aos usuários uma visibilidade aprimorada e controle sobre permissões, + ao mesmo tempo em que agiliza os processos de atualização automática e instalação para os desenvolvedores de aplicativos. +Os usuários podem conceder ou revogar as permissões individualmente para os aplicativos instalados.

+ +

Nos aplicativos direcionados para o M Preview, certifique-se de verificar e solicitar as permissões + no tempo de execução. Para determinar se o aplicativo recebeu uma permissão, chame + o novo método {@code Context.checkSelfPermission()}. Para solicitar uma permissão, chame o novo método + {@code Activity.requestPermission()}. Mesmo se o aplicativo não é direcionado para o M, + deve-se testá-lo sob o novo modelo de permissões.

+ +

Para obter mais detalhes sobre o suporte do novo modelo de permissões no aplicativo, consulte a página de prévia de desenvolvedor + +Permissões. Para obter dicas sobre como avaliar o impacto no aplicativo, + consulte o guia de teste.

+ +

Otimizações de economia de energia

+

Esta prévia introduz novas otimizações de economia de energia para dispositivos e aplicativos ociosos.

+ +

Soneca

+

Se o dispositivo estiver desconectado e parado com a tela desligada por um período, + o modo Soneca será ativado, onde ele tentará manter o sistema em um estado ocioso. Neste modo, + os dispositivos retomam as operações normais periodicamente por breves períodos para que a sincronização de aplicativos + possa ocorrer e para que o sistema possa realizar quaisquer operações pendentes.

+ +

As seguintes restrições se aplicam aos aplicativos durante a Soneca:

+ +

+

Quando o dispositivo sair do modo soneca, quaisquer sincronizações e trabalhos pendentes são executados.

+

É possível testar este recurso conectando o dispositivo executando o M Preview + à máquina de desenvolvimento e chamando os seguintes comandos: +

+
+$ adb shell dumpsys battery unplug
+$ adb shell dumpsys deviceidle step
+$ adb shell dumpsys deviceidle -h
+
+

Observação: o próximo lançamento do + +Google Cloud Messaging permite que você designe + mensagens de alta prioridade. Se o aplicativo recebe mensagens de alta prioridade do GCM, + um acesso breve à rede é concedido mesmo quando o dispositivo está no modo soneca. +

+ +

Consulte o +guia de teste para obter dicas sobre +como testar a soneca nos aplicativos.

+ +

Aplicativo em espera

+

Com esta prévia, o sistema pode determinar quais aplicativos estão em espera quando +não estão em uso ativo. O aplicativo é considerado em espera após um período, a não ser que o sistema detecte +algum destes sinais:

+ + + +

Se o dispositivo estiver desconectado, o aplicativo considerado ocioso terá o acesso +à rede desativado e as sincronizações e os trabalhos suspensos. Quando o dispositivo está conectado em uma fonte de alimentação, + esses aplicativos têm acesso à rede permitido e podem executar quaisquer sincronizações e trabalhos pendentes. Se o dispositivo permanece ocioso por longos períodos, + os aplicativos ociosos têm acesso à rede permitido aproximadamente uma vez por dia.

+ +

É possível testar este recurso conectando o dispositivo executando o M Preview + à máquina de desenvolvimento e chamando os seguintes comandos: +

+
+$ adb shell dumpsys battery unplug
+$ adb shell am set-idle <packageName> true
+$ adb shell am set-idle <packageName> false
+$ adb shell am get-idle <packageName>
+
+ +

Observação: o próximo lançamento do + +Google Cloud Messaging (GCM) permite que você +designe mensagens de alta prioridade. Se o aplicativo recebe mensagens de alta prioridade do GCM, +um acesso breve à rede é concedido mesmo quando o aplicativo está ocioso. +

+ +

Consulte o +guia de teste para obter dicas sobre como +testar a espera dos aplicativos.

+ +

Dispositivos de armazenamento adotáveis

+

+Com esta prévia, os usuários podem adotar dispositivos de armazenamento externo como cartões SD. Adotar um dispositivo +de armazenamento externo criptografa e formata o dispositivo para agir como um armazenamento interno. Este recurso +permite que os usuários movam aplicativos e dados privados desses aplicativos entre dispositivos de armazenamento. Ao mover aplicativos, +o sistema respeita a preferência +{@code android:installLocation} +no manifesto.

+ +

Se o aplicativo acessar as seguintes APIs ou campos, saiba que os caminhos de arquivos retornados +serão alterados dinamicamente quando o aplicativo for movido entre os dispositivos de armazenamento externo e interno. +Ao compilar caminhos de arquivos, é recomendado que essas APIs sempre sejam chamadas dinamicamente. +Não use caminhos de arquivo criptografados nem persista em caminhos de arquivo completamente qualificados que foram compilados anteriormente.

+ + + +

Para depurar este recurso na prévia de desenvolvedor, é possível ativar a adoção +de uma unidade USB que está conectada a um dispositivo Android por meio de um cabo USB On-The-Go (OTG) executando este comando:

+ +
+$ adb shell sm set-force-adoptable true
+
+ +

Remoção do cliente Apache HTTP

+

Esta prévia remove o suporte para o cliente Apache HTTP. Se o aplicativo estiver usando este cliente e for direcionado +para Android 2.3 (nível da API 9) ou mais recente, use +a classe {@link java.net.HttpURLConnection}. Esta API é mais eficiente, pois reduz o uso de rede por meio de compressão transparente e armazenamento +em cachê de respostas, além de minimizar o consumo de energia. Para continuar usando as APIs do Apache HTTP, +deve-se primeiro declarar a dependência de tempo de compilação no arquivo {@code build.gradle}: +

+
+android {
+    useLibrary 'org.apache.http.legacy'
+}
+
+

O Android está mudando da biblioteca OpenSSL para +BoringSSL +. Caso esteja usando o Android NDK no aplicativo, não vincule contra bibliotecas criptográficas +que não fazem parte da API de NDK, como {@code libcrypto.so} e {@code libssl.so}. Estas bibliotecas não são APIs públicas +e podem mudar ou apresentar erros sem notificar entre liberações e dispositivos. +Além disso, você pode se expor a vulnerabilidades de segurança. Em vez disso, +modifique o código nativo para chamar as APIs de criptografia Java via JNI ou para vincular estaticamente +com relação a uma biblioteca criptográfica de sua escolha.

+ +

Mudanças no AudioManager

+

Ajustar o volume diretamente ou desativar o áudio de transmissões específicas por meio da classe {@link android.media.AudioManager} +não são mais recursos suportados. O método {@link android.media.AudioManager#setStreamSolo(int,boolean) +setStreamSolo()} é obsoleto e deve-se chamar o método +{@code AudioManager.requestAudioFocus()}. De forma semelhante, o método +{@link android.media.AudioManager#setStreamMute(int,boolean) setStreamMute()} é +obsoleto; em vez disso, chame o método {@code AudioManager.adjustStreamVolume()} +e passe o valor da direção de {@code ADJUST_MUTE} ou {@code ADJUST_UNMUTE}.

+ +

Seleção de texto

+ + + +

Quando os usuários selecionam o texto no aplicativo, agora é possível exibir ações de seleção de texto como +Recortar, Copiar e Colar na +barra de ferramentas flutuante. A implementação da interação do usuário é semelhante ao processo +da barra de ação contextual, como descrito em + +Ativação do modo de ação contextual para vistas individuais.

+ +

Para implementar uma barra de ferramentas flutuante para seleção de texto, faça as seguintes alterações nos aplicativos +existentes:

+
    +
  1. No objeto {@link android.view.View} ou {@link android.app.Activity}, altere as chamadas +{@link android.view.ActionMode} de +{@code startActionMode(Callback)} para {@code startActionMode(Callback, ActionMode.TYPE_FLOATING)}.
    2. +
  2. Pegue a implementação existente de {@code ActionMode.Callback} e torne-a uma extensão de +{@code ActionMode.Callback2}.
    3. +
  3. Substitua o método {@code Callback2.onGetContentRect()} para fornecer as coordenadas do conteúdo +do objeto {@link android.graphics.Rect} (como um retângulo de seleção de texto) na vista.
    4. +
  4. Se o posicionamento do retângulo deixar de ser válido e for o único elemento a ser invalidado, +chame o método {@code ActionMode.invalidateContentRect()}.
    5. +
+ +

Caso esteja usando a +biblioteca de suporte Android revisão 22.2, saiba que as barras de ferramentas flutuantes não +têm compatibilidade com versões anteriores e que o appcompat tem controle sobre os objetos {@link android.view.ActionMode} por +padrão. Isto evita que barras de ferramentas flutuantes sejam exibidas. Para ativar o suporte de +{@link android.view.ActionMode} em um +{@link android.support.v7.app.AppCompatActivity}, chame +{@code android.support.v7.app.AppCompatActivity.getDelegate()} e, em seguida, chame +{@code android.support.v7.app.AppCompatDelegate.setHandleNativeActionModesEnabled()} no objeto +{@link android.support.v7.app.AppCompatDelegate} retornado e defina +o parâmetro de entrada para {@code false}. Esta chamada retorna o controle dos objetos {@link android.view.ActionMode} +à estrutura. Em dispositivos que são executados no M Preview, isto permite que a estrutura suporte os modos de +{@link android.support.v7.app.ActionBar} ou de barra de ferramenta flutuante, enquanto que, para dispositivos anteriores ao M Preview, +somente os modos {@link android.support.v7.app.ActionBar} são suportados.

+ +

Mudanças no Android Keystore

+

Com esta prévia, +o provedor Android Keystore não suporta mais +DSA. ECDSA ainda é suportado.

+ +

As chaves que não exigem criptografia em rest não precisam ser excluídas quando a tela de bloqueio segura +é desativada ou redefinida (por exemplo, pelo usuário ou por um administrador do dispositivo). As chaves que exigem +criptografia serão excluídas durante esses eventos.

+ +

Mudanças de rede e Wi-Fi

+ +

Esta prévia introduz as seguintes alterações de comportamento nas APIs de rede e Wi-Fi.

+ + +

Mudanças no serviço de câmera

+

Nesta prévia, o modelo para acessar recursos compartilhados no serviço de câmera foi alterado +do antigo modelo de acesso “primeiro a chegar, primeiro a ser atendido” para um modelo de acesso onde +os processos de alta prioridade são favorecidos. As mudanças no comportamento do serviço incluem:

+ + +

Tempo de execução de ART

+

O tempo de execução de ART agora implementa adequadamente as regras de acesso +para o método {@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()}. Esta +alteração corrige um problema onde o Dalvik estava verificando as regras de acesso incorretamente em versões anteriores. +Se o aplicativo usa o método +{@link java.lang.reflect.Constructor#newInstance(java.lang.Object...) newInstance()} e você quer +substituir as verificações de acesso, chame o método +{@link java.lang.reflect.Constructor#setAccessible(boolean) setAccessible()} com o parâmetro +de entrada definido como {@code true}. Se o aplicativo usar a +biblioteca v7 appcompat ou a +biblioteca v7 recyclerview, +deve-se atualizá-lo para usar as versões mais recentes dessas bibliotecas. Caso contrário, certifique-se +de que as classes personalizadas mencionadas a partir do XML sejam atualizadas para que os construtores de classe estejam acessíveis.

+ +

Esta prévia atualiza o comportamento do vinculador dinâmico. O vinculador dinâmico agora entende +a diferença entre um {@code soname} da biblioteca e o seu caminho +( +erro público 6670), e a pesquisa por {@code soname} +agora está implementada. Os aplicativos que anteriormente trabalhavam e têm entradas {@code DT_NEEDED} inválidas +(geralmente, caminhos absolutos no sistema de arquivo na máquina de programação) podem falhar ao serem carregados.

+ +

O sinalizador {@code dlopen(3) RTLD_LOCAL} agora está corretamente implementado. Observe que +{@code RTLD_LOCAL} é o padrão. Portanto, chamadas para {@code dlopen(3)} que não usam explicitamente +{@code RTLD_LOCAL} serão afetadas (a não ser que o aplicativo tenha usado explicitamente {@code RTLD_GLOBAL}). Com +{@code RTLD_LOCAL}, os símbolos não estarão disponíveis para as bibliotecas carregadas por chamadas posteriores a +{@code dlopen(3)} (o oposto ocorre quando mencionado por entradas {@code DT_NEEDED}).

+

+ +

Validação de APK

+

A plataforma agora realiza validações mais estritas de APKs. Um APK é considerado corrompido se um arquivo +for declarado no manifesto, mas não estiver presente no próprio APK. Um APK deve ser atribuído novamente se qualquer +conteúdo for removido.

+ +

Mudanças do Android for Work

+

Esta prévia inclui as seguintes mudanças de comportamento para Android for Work:

+ diff --git a/docs/html-intl/intl/pt-br/preview/features/runtime-permissions.jd b/docs/html-intl/intl/pt-br/preview/features/runtime-permissions.jd new file mode 100644 index 0000000000000..762e1ae8243d8 --- /dev/null +++ b/docs/html-intl/intl/pt-br/preview/features/runtime-permissions.jd @@ -0,0 +1,794 @@ +page.title=Permissões +page.tags=previewresources, androidm +page.keywords=permissions, runtime, preview +page.image={@docRoot}preview/images/permissions_check.png +@jd:body + + +
+
+

Visualização rápida

+
    +
  • Se o aplicativo direciona o M Preview SDK, ele indica aos usuários para conceder + permissões no tempo de execução, em vez de tempo de instalação.
    • +
  • Os usuários podem revogar as permissões a qualquer momento na tela de configurações +do aplicativo.
    • +
  • O aplicativo precisa verificar se tem as permissões necessárias +sempre que for executado.
    • +
+ +

Neste documento

+
    +
  1. Visão geral
    2. +
  2. Codificação para permissões de tempo de execução
    3. +
  3. Teste de permissões de tempo de execução
    4. +
  4. Práticas recomendadas
    5. +
+ + + + +
+
+ + +

+ O M Developer Preview introduz um novo modelo de permissões de aplicativo +que agiliza o processo de instalação e atualização de aplicativos para os usuários. Se um aplicativo + que está sendo executado no M Preview suporta o novo modelo de permissões, o usuário não precisa conceder + permissões ao instalar ou atualizar o aplicativo. Em vez disso, o aplicativo + solicita as permissões à medida que precisar e o sistema exibe um diálogo + ao usuário pedindo a permissão. +

+ +

+ Se um aplicativo suportar o novo modelo de permissões, ele + ainda poderá ser instalado e executado em versões mais antigas do Android, usando o antigo modelo + de permissões nesses dispositivos. +

+ +

+ Visão geral +

+ +

+ Com o M Developer Preview, a plataforma introduz um novo modelo + de permissões. Eis um resumo dos componentes essenciais deste novo modelo: +

+ + + +

+ Este modelo de permissões altera a forma como o aplicativo se comporta diante os recursos + que precisam de permissões. Eis um resumo das práticas de desenvolvimento que devem + ser seguidas para ajustar para este modelo: +

+ + + +

+ Observação: se um aplicativo direcionar o M Developer Preview, ele + deve usar o novo modelo de permissões. +

+ +

+ No momento do lançamento do M Developer Preview, + nem todos os aplicativos Google implementam completamente o novo modelo de permissões. A Google está atualizando estes aplicativos + durante o curso do M Developer Preview para respeitar adequadamente a configuração + de alternação de permissões. +

+ +

+ Observação: se o aplicativo tiver a própria superfície de API, + não represente permissões sem antes garantir que o autor da chamada tenha as permissões necessárias + para acessar esses dados. +

+ +

+ Permissões de assinatura e aplicativos do sistema +

+ +

+ Geralmente, quando um usuário instala um aplicativo, o sistema somente fornece ao aplicativo o + {@link android.content.pm.PermissionInfo#PROTECTION_NORMAL + PROTECTION_NORMAL}. No entanto, sob algumas circunstâncias, o sistema concede + ao aplicativo mais permissões: +

+ + + +

+ Em ambos os casos, o usuário ainda pode revogar as permissões a qualquer + momento acessando a tela de configurações do sistema e escolhendo Aplicativos + > app_name > Permissões. O aplicativo + deve continuar com a verificação das permissões no tempo de execução e solicitá-las + se necessário. +

+ +

+ Compatibilidade anterior e posterior +

+ +

+ Se um aplicativo não direciona para o M Developer Preview, ele deve continuar a usar + o modelo antigo de permissões mesmo nos dispositivos M Preview. Quando o usuário instala + o aplicativo, o sistema pede para que ele conceda todas as permissões + listadas no manifesto do aplicativo. +

+ +

+ Observação: em dispositivos que são executados no M Developer Preview, + um usuário pode desativar as permissões para qualquer aplicativo (incluindo aplicativos de legado) + na tela de configurações do aplicativo. Se um usuário desativa as permissões de um aplicativo de legado, o sistema + silenciosamente desativa a funcionalidade adequada. Quando um aplicativo tentar realizar + uma operação que requer esta permissão, a operação não necessariamente causará + uma exceção. Em vez disso, ele retornará um conjunto de dados vazio, + sinalizará um erro ou exibirá um comportamento inesperado. Por exemplo, caso queira + consultar um calendário sem permissão, o método retorna um conjunto de dados vazio. +

+ +

+ Se instalar um aplicativo usando o novo modelo de permissões em um dispositivo + que não está executando o M Preview, + o sistema o tratará da mesma forma que qualquer outro aplicativo: o sistema pedirá + para que o usuário conceda todas as permissões declaradas no momento da instalação. +

+ +

+ Observação: para a liberação de prévia, deve-se definir a versão mínima de SDK + para o M Preview SDK para compilar com o SDK de prévia. Isto significa que você + não poderá testar tais aplicativos em plataformas mais antigas durante a prévia + de desenvolvedor. +

+ +

Permissões versus intenções

+ +

+ Em vários casos, é possível escolher entre duas maneiras para que o aplicativo realize + uma tarefa. É possível fazer com que o aplicativo solicite uma permissão para realizar a operação + por conta própria. Alternativamente, é possível fazer com que o aplicativo use uma intenção para que outro aplicativo + realize a tarefa. +

+ +

+ Por exemplo, imagine que o aplicativo precisa da função de tirar fotos com + a câmera do dispositivo. O aplicativo pode solicitar a permissão +android.permission.CAMERA, que permite que ele acesse + a câmera diretamente. O aplicativo então usará as APIs da câmera + para controlar a câmera e tirar uma foto. Esta abordagem fornece ao aplicativo + controle completo sobre o processo de fotografia e permite + que você incorpore a IU da câmera. +

+ +

+ No entanto, caso não precise de tal controle, é possível apenas usar uma intenção {@link + android.provider.MediaStore#ACTION_IMAGE_CAPTURE ACTION_IMAGE_CAPTURE} + para solicitar uma imagem. Ao iniciar a intenção, o usuário deve escolher + um aplicativo de câmera (se não houver um aplicativo padrão de câmera) + para tirar a foto. O aplicativo da câmera retorna a imagem ao método {@link + android.app.Activity#onActivityResult onActivityResult()} do aplicativo. +

+ +

+ De forma semelhante, caso precise realizar uma ligação, + acessar os contatos do usuário etc., é possível fazer estas ações criando uma intenção adequada + ou solicitar a permissão e o acesso aos objetos adequados diretamente. Essas são + as vantagens e desvantagens de cada abordagem. +

+ +

+ Se usar permissões: +

+ + + +

+ Se usar uma intenção: +

+ + + +

Codificação para permissões de tempo de execução

+ +

+ Se um aplicativo direciona o novo M Developer Preview, ele deve usar o novo + modelo de permissões. Isto significa que, além de declarar as permissões necessárias no manifesto, + deve-se também verificar se o aplicativo + tem as permissões no tempo de execução e, + caso ainda não as tenha, solicitá-las. +

+ +

+ Possibilitar um novo modelo de permissões +

+ +

+ Para possibilitar o modelo de permissões do M Developer Preview, configure o atributo +targetSdkVersion do aplicativo para "MNC" e +compileSdkVersion para "android-MNC". Isto ativará + todos os novos recursos de permissão. +

+ +

+ Para a liberação de uma prévia, deve-se definir minSdkVersion para +"MNC" para compilar com o SDK de prévia. +

+ +

+ Designar uma permissão somente para o M Preview +

+ +

+ É possível usar o novo elemento <uses-permission-sdk-m> no manifesto do aplicativo + para indicar que uma permissão é necessária apenas no M Developer Preview. Se você + declarar uma permissão desta maneira, sempre que o aplicativo for instalado + em um dispositivo mais antigo, o sistema não solicitará ao usuário + nem concederá a permissão ao aplicativo. Usando o elemento <uses-permission-sdk-m> +, é possível adicionar novas permissões + a versões atualizadas do aplicativo sem forçar os usuários a conceder permissões + ao instalar a atualização. +

+ +

+ Se o aplicativo está sendo executado em um dispositivo com M Developer Preview, o +<uses-permission-sdk-m> se comporta da mesma forma que +<uses-permission>. + O sistema não solicita ao usuário que conceda quaisquer permissões ao instalar o aplicativo + e o aplicativo solicita as permissões à medida que forem necessárias. +

+ +

+ Solicitação de permissões +

+ +

+ Se o aplicativo usa o novo modelo de permissões do M Developer Preview, + o usuário não recebe solicitações para conceder todas as permissões quando o aplicativo é iniciado pela primeira vez em um dispositivo + que está sendo executado no M Preview. Em vez disso, o aplicativo solicita as permissões à medida + que forem necessárias. Quando um aplicativo solicita uma permissão, o sistema exibe uma caixa de diálogo + ao usuário. +

+ +

+ Se o aplicativo executar em um dispositivo que tem SDK 22 ou inferior, + ele usará o antigo modelo de permissões. Quando o usuário instala o aplicativo, ele é solicitado a conceder + todas as permissões que o aplicativo lista no manifesto, + exceto as permissões que forem marcadas com <uses-permission-sdk-m>. +

+ +

Verifique em qual plataforma o aplicativo está sendo executado

+ +

+ Este modelo de permissões é suportado apenas em dispositivos que estão executando + o M Developer Preview. Antes de chamar qualquer um destes métodos, + o aplicativo deve verificar em qual plataforma está sendo executado + verificando o valor de {@link android.os.Build.VERSION#CODENAME + Build.VERSION.CODENAME}. Se o dispositivo estiver sendo executado no M Developer Preview, + {@link android.os.Build.VERSION#CODENAME CODENAME} será "MNC". +

+ +

Verifique se o aplicativo tem a permissão necessária

+ +

Quando o usuário tenta fazer algo que requer uma permissão, + o aplicativo verifica se tem a permissão para realizar esta operação. Para fazer isto, + o aplicativo chama + Context.checkSelfPermission(permission_name). O aplicativo + deve realizar isto para verificar se sabe que o usuário já concedeu esta permissão, + levando em consideração que o usuário pode revogar + as permissões do aplicativo a qualquer momento. Por exemplo, + se um usuário quiser usar um aplicativo para tirar uma foto, o aplicativo chamará + Context.checkSelfPermission(Manifest.permission.CAMERA).

+ +

+ Tabela 1. Permissões e grupos de permissões.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Grupo de permissõesPermissões
android.permission-group.CALENDAR +
    +
  • + android.permission.READ_CALENDAR +
    • +
+
    +
  • + android.permission.WRITE_CALENDAR +
    • +
+
android.permission-group.CAMERA +
    +
  • + android.permission.CAMERA +
    • +
+
android.permission-group.CONTACTS +
    +
  • + android.permission.READ_CONTACTS +
    • +
  • + android.permission.WRITE_CONTACTS +
    • +
  • + android.permission.READ_PROFILE +
    • +
  • + android.permission.WRITE_PROFILE +
    • +
+
android.permission-group.LOCATION +
    +
  • + android.permission.ACCESS_FINE_LOCATION +
    • +
  • + android.permission.ACCESS_COARSE_LOCATION +
    • +
+
android.permission-group.MICROPHONE +
    +
  • + android.permission.RECORD_AUDIO +
    • +
+
android.permission-group.PHONE +
    +
  • + android.permission.READ_PHONE_STATE +
    • +
  • + android.permission.CALL_PHONE +
    • +
  • + android.permission.READ_CALL_LOG +
    • +
  • + android.permission.WRITE_CALL_LOG +
    • +
  • + com.android.voicemail.permission.ADD_VOICEMAIL +
    • +
  • + android.permission.USE_SIP +
    • +
  • + android.permission.PROCESS_OUTGOING_CALLS +
    • +
+
android.permission-group.SENSORS +
    +
  • + android.permission.BODY_SENSORS +
    • +
+
    +
  • + android.permission.USE_FINGERPRINT +
    • +
+
android.permission-group.SMS +
    +
  • + android.permission.SEND_SMS +
    • +
  • + android.permission.RECEIVE_SMS +
    • +
  • + android.permission.READ_SMS +
    • +
  • + android.permission.RECEIVE_WAP_PUSH +
    • +
  • + android.permission.RECEIVE_MMS +
    • +
  • + android.permission.READ_CELL_BROADCASTS +
    • +
+
+ +

Solicitar permissões se necessário

+ +

Se o aplicativo já não tem a permissão necessária, ele chama o método + Activity.requestPermissions(String[], int) para solicitar + as permissões necessárias. O aplicativo passa + as permissões que deseja e também um "código de solicitação" do inteiro. + Este método funciona de forma assíncrona: ele retorna imediatamente e, + depois que o usuário responde à caixa de diálogo, o sistema chama + o método de retorno de chamada do aplicativo com os resultados, passando o mesmo "código de solicitação" que o aplicativo passou + para requestPermissions().

+ +

O seguinte código verifica se o aplicativo tem a permissão + para ler os contatos do usuário e solicita a permissão, se necessário:

+ +
+if (checkSelfPermission(Manifest.permission.READ_CONTACTS)
+        != PackageManager.PERMISSION_GRANTED) {
+    requestPermissions(new String[]{Manifest.permission.READ_CONTACTS},
+            MY_PERMISSIONS_REQUEST_READ_CONTACTS);
+
+    // MY_PERMISSIONS_REQUEST_READ_CONTACTS is an
+    // app-defined int constant
+
+    return;
+}
+
+ +

Lidar com a resposta de solicitação das permissões

+ +

+ Quando um aplicativo solicita as permissões, o sistema apresenta uma caixa de diálogo + ao usuário. Quando o usuário responde, o sistema invoca o + Activity.onRequestPermissionsResult(int, String[], int[]) + do aplicativo, passando a ele a resposta do usuário. O aplicativo precisa substituir este método. O retorno de chamada + recebe o mesmo código de solicitação passado para + requestPermissions(). Por exemplo, se um aplicativo solicita o acesso + READ_CONTACTS, ele pode ter o seguinte + método de retorno de chamada: +

+ +
+@Override
+public void onRequestPermissionsResult(int requestCode,
+        String permissions[], int[] grantResults) {
+    switch (requestCode) {
+        case MY_PERMISSIONS_REQUEST_READ_CONTACTS: {
+            if (grantResults[0] == PackageManager.PERMISSION_GRANTED) {
+
+                // permission was granted, yay! do the
+                // calendar task you need to do.
+
+            } else {
+
+                // permission denied, boo! Disable the
+                // functionality that depends on this permission.
+            }
+            return;
+        }
+
+        // other 'switch' lines to check for other
+        // permissions this app might request
+    }
+}
+
+ +

Se o usuário concede a permissão, o sistema fornece ao aplicativo todas as permissões + que o manifesto do aplicativo lista para esta área funcional. Se o usuário negar a solicitação, + deve-se tomar a ação adequada. Por exemplo, deve-se desativar + quaisquer ações de menu que dependam desta permissão. + +

+ +

+ Quando o sistema pede para que o usuário conceda uma permissão, esse usuário tem a opção + de dizer ao sistema para que não peça esta permissão novamente. Nesse caso, + quando um aplicativo usa requestPermissions() para solicitar esta permissão, + o sistema nega imediatamente. Neste caso, o sistema chama + onRequestPermissionsResult() da mesma forma que faria se o usuário tivesse + rejeitado explicitamente a solicitação novamente. Por este motivo, o aplicativo + não pode presumir que uma interação direta com o usuário ocorreu. +

+ +

Teste de permissões de tempo de execução

+ + +

+ Se o aplicativo for direcionado para o M Developer Preview, deve-se testar + se ele lida com as permissões corretamente. Não se pode presumir que o aplicativo + terá qualquer permissão quando executado. Quando o aplicativo é iniciado pela primeira vez, + é provável que não tenha permissões. O usuário pode revogar e restaurar permissões + a qualquer momento. +

+ +

+ Deve-se testar o aplicativo para garantir que ele se comporte corretamente em todas + as situações de permissão. Com o M Preview SDK, fornecemos os novos comandos + de Android + Debug Bridge (adb) para possibilitar que o aplicativo seja testado com quaisquer + configurações de permissões necessárias. +

+ +

+ Novas opções e comandos adb +

+ +

+ As ferramentas da plataforma M Preview SDK fornecem vários comandos novos para permitir + que você teste como o aplicativo lida com permissões. +

+ +

+ Instalar com permissões +

+ +

+ É possível usar a nova opção -g do comando adb + install, que instala o aplicativo + e fornece todas as permissões listadas em seu manifesto: +

+ +
+$ adb install -g <path_to_apk>
+
+ +

+ Conceder e revogar permissões +

+ +

+ É possível usar os novos comandos do gerenciador + de pacotes (pm) de ADB para conceder e revogar as permissões de um aplicativo instalado. + Esta funcionalidade pode ser útil para testes automatizados. +

+ +

+ Para conceder uma permissão, use o comando grant do gerenciador de pacote: +

+ +
+$ adb pm grant <package_name> <permission_name>
+
+ +

+ Por exemplo: para conceder a permissão do pacote com.example.myapp para gravar áudios, + use este comando: +

+ +
+$ adb pm grant com.example.myapp android.permission.RECORD_AUDIO
+
+ +

+ Para revogar uma permissão, use o comando revoke do gerenciador de pacote: +

+ +
+$ adb pm revoke <package_name> <permission_name>
+
+ +

Práticas recomendadas

+ +

+ O novo modelo de permissões fornece aos usuários uma experiência mais suave + e facilita a instalação de aplicativos, deixando-os mais confortáveis + com o que os aplicativos estão fazendo. Sugerimos que você siga as práticas recomendadas para aproveitar + todas as vantagens do novo modelo. +

+ + +

Peça somente as permissões necessárias

+ +

+ Sempre que você pede uma permissão, o usuário é forçado a tomar uma decisão. + Se o usuário negar a solicitação, a funcionalidade do aplicativo será reduzida. + Deve-se minimizar o número de solicitações realizadas. +

+ +

+ Por exemplo: o aplicativo pode frequentemente adquirir a funcionalidade necessária usando + uma intenção em vez + de solicitar permissões. Se o aplicativo precisa tirar fotos com a câmera do telefone, + é possível usar uma intenção {@link + android.provider.MediaStore#ACTION_IMAGE_CAPTURE + MediaStore.ACTION_IMAGE_CAPTURE}. Quando o aplicativo executa a intenção, + o sistema pede para que o usuário escolha um aplicativo de câmera já instalado + para tirar a foto. +

+ +

+ Não oprima o usuário +

+ +

+ Se você confrontar o usuário com várias solicitações de permissão de uma só vez, + é possível que ele se sinta oprimido e saia do aplicativo. + Em vez disso, deve-se solicitar as permissões somente quando necessário. +

+ +

+ Em alguns casos, uma ou mais permissões podem ser absolutamente essenciais para o aplicativo. + Nesta situação, faz sentido solicitar todas as permissões assim + que o aplicativo é iniciado. Por exemplo: se você fizer um aplicativo de fotografia, + ele precisará de acesso à câmera do dispositivo. Quando o usuário iniciar o aplicativo + pela primeira vez, ele não se surpreenderá quando receber + uma solicitação de permissão para usar a câmera. Mas, se o mesmo aplicativo tiver um recurso + para compartilhar fotos com os contatos do usuário, não se deve + pedir esta permissão na primeira inicialização. Em vez disso, espere o usuário tentar usar + o recurso de compartilhamento para pedir a permissão. +

+ +

+ Se o aplicativo fornecer um tutorial, faz sentido solicitar as permissões + necessárias no final da sequência do tutorial. +

+ +

+ Explique o porquê da necessidade das permissões +

+ +

+ O diálogo de permissões exibido pelo sistema ao chamar + requestPermissions() diz quais permissões o aplicativo requer, + mas não diz o porquê. Em alguns casos, o usuário pode achar isto confuso. + É uma boa ideia explicar ao usuário o porquê da necessidade das permissões + para o aplicativo antes de chamar requestPermissions(). +

+ +

+ Por exemplo: um aplicativo de fotografia pode precisar usar serviços de localização + para poder marcar as fotos geograficamente. Um usuário normal pode não entender que uma foto + pode conter informações de localização e ficar confuso quando + o aplicativo de fotografia quiser saber a localização. Portanto, neste caso, é uma boa ideia o aplicativo explicar + ao usuário sobre este recurso antes de chamar + requestPermissions(). +

+ +

+ Uma maneira de fazer isto é incorporar estas solicitações em um tutorial do aplicativo. O tutorial pode exibir cada um dos recursos + do aplicativo e, à medida que fizer isto, + pode também explicar quais permissões são necessárias. Por exemplo, o tutorial do aplicativo de fotografia + pode demonstrar os recursos de compartilhamento de fotos com os contatos e, + em seguida, dizer ao usuário que ele precisa fornecer as permissões + para que o aplicativo possa visualizar os contatos. O aplicativo pode então chamar requestPermissions() para solicitar + ao usuário este acesso. É claro que nem todos os usuários seguirão o tutorial. + Portanto, ainda é necessário verificar e solicitar as permissões durante + a operação normal do aplicativo. +

diff --git a/docs/html-intl/intl/pt-br/preview/images/direct-share-screen.png b/docs/html-intl/intl/pt-br/preview/images/direct-share-screen.png new file mode 100644 index 0000000000000000000000000000000000000000..a53a33ea19d4f4648a27b2e218532d988052a3a7 GIT binary patch literal 57767 zcmXt<1yEbx(}pR<-3k;f5Tv*j0;N#g-HSu865QRPK(WwbL5f2t?(P~~in|vm?)K&P z&HN{m$;_Rbd(S;*&+fCk?~PJZk;TQLz(PVo!j+ek(m+Cb1w?%1G0+f4@L%!ZA%4)z z6=kK6UjF<1YAZ@Y9Km#w(|1Ke!Y2Oj`wA&NgB)=X-A!Iu8hs6w@(nIwK?5iO3F#e@ zyp*_>*Wyu|x0~Uf_wL=pKaGZKRxPu&SI7YI=pT*I5F5pOcDpLj$7o_UmF;>Fe~4Ec z^VpD*@L2xz^wzf9$Ec+1%Y5RKQWAJIBRm%{^@UwC7oeHX5{;r8r1y=Q1*wk9GgAyJ z2=)Zfst|<&0*PO?6b&mLl!*z)ng0 zPhn={a*$qPRgqvba+`D+clQs1t6mHcfb;3PxUjJB{{H^@e3b=&2vccV3ZskKb2->j zAA`qSc7OK8rY&IOiUS2D^x*Gb^MHVV zc@H;Y4|+lsimW%?jC3IR6Bgb4H%j5P;c|08M;k zC_4Vs(ozdZ>WyL3xWnF9rdONs;?mN=!GUbxa9vpY30?6lge1YxcKSo49&@`zZ`nrHL~-#(@R~l(@LK z^YyXt9djR_^qxrk>9w`-a-$X-8yh{J12U6Gtbh;WFgHom;))7p5-h?fsc%yBh;^CF zlePW&RU+9kjNtO-#`X5ptksxn(uSmm+v{ppccIyxt>fZjM`-z>$o+nvo4b3?p)fig zmFdg#6HBy&g$2X7*o%m4JdLzE$yYnO6tLN(arxzF+e~>Nq0q;;P)TRydfQIc-$h3# z%<@F_7G~rpmG_%_8snB{{Xax!?1GmSJh@Wfb(ijlOWmyca<#R!wLYH1rRWJELx5z< zDoZ#i!bVuZ7i<9FQhmy*Bpph_st;STrCB-?1fZ^~E32poCpuepfpcVt1=93z>vaTt zYBG$IqOZEV(bl%S`L}{tar#7zlfajUwDk1NLa0MGzw-6bLQj+Ho)cB%)#024c|T*^ z=Mp2sDBDyGgF1WPw+n4sgK~qAu!J{Z3FQGHHA=5@zP_V63YQ+PZUtL^0SM?PSFvOF za6c=1aZ6wbfagEk*|Bl8-_kdiGlZ>Q9!$^7&gQ_rhCA!LEwnXX5{NKkPs9l-KZFNV z)YQ1XcWk|7Clh3ZSF?~{{noERgI6buT-4VKPz}(fzzJhzO3KUo>yHce+O0+@f-Fy7 z=&RBSn~r?SYj3;?_~_-Qb~;G=eAz4YV_8}s>0nzymUM6|^9`%{`Zo3#oqLx%KT+i1 z&W;iS4l2AFhn406dZ~8=@2K$dSQNsY15gng?i~TfW2uW&muW&oL`2|~FS|SuH8r(V zp1MTN#2epnEp2J-Sw$BIw&Rs5Dw34wEsS1PKsMY#JUZ7rCf9oRN9EJ7)b{4sbHVY-^qn!?eFVUMMt8B3vX-p<3b3q!_ks;r4$#8 zFvLZ(D_Y;b(QNu*Fs9opPXI#y%-e{?H%|=e?B=_BS4Y#Y%byib#ip%YI+6=2WHRo(0 zC0niouNlq$a-Hw~cdgQKSA*K)zUBK|`;>^{Y5+kge_IU}9n8>8-kw0iSt*ZSry{HX z@gT>9D+(?K6r)l>36)Bek#?P-HOknSRln`Lck)9Ba(UzR#Zl)7y2@}=Q(8a1s<(gh zU{MjS&Y`VdNsT^G#dY?Fb#@wyweh+#)ue-8#AvV$GuSXgx#Rv}9Uv|J&D^=GJ~<^q zaY>4`F9LCzN2QCyHT9Ii<-gAA-JzK-_JQJMyU!8k!pO+qpOWgj-B({PL0?3E`>R+uIeF?JDMCmX4Xoan2FrcDY&cbRGY6b9xpZ zn2}=a6XhqW%1+8a8p8twHjXG#P*9j#Sy>%W6c!c9GbO>xUz;M_?Z(E2Az&9no_Z^MC1EQtTO7!IWWWI#sMOQz3vlCvN!8cL@Z&E z*waB^)sF^CeJUZBFejiA3&|GYp)wRBTtZ7*o9E+4_}#@`loY*| zuI_(V+TGi`Tiz3m9N5ZfXh?Z}4iIoy9!zP!WK^2oKHcb1QdXW^SQxSvd(a2z?{d}NBd;~7a~3(!jUB+*18}5(f(Z0zqk8Z{ckpZU{eS-o%gS&o=HLi_TTN|C zh_EZ#kDmXw!^w=-U9%skEG#Srs}YliOMBaie!DL#Has|pQEz|I`5J#>eqIg{&=Ik4 zu=@MJ)`leQJweCQQb#O7NK_OiVmh3f441w4GDR*YBmqhCKEA#SO|Hy{v6wqKCDd4t z^YZcaxX&34MBq~X7sTa@rV%kv^l=0KKf_+Xxa0ILA^k71A`E%|D z_JMqKbd+CE@Zyhwqc(e8NT4>JgC&2x&62e0nEqzS?CH7=vy^-CT&SXCIlLs`S&@g2 zPtwSUn)Yr`_I6tANz>SS=VyVWn8F1z40e9ngYSBMq)(qXsKL^Zieoe)-)GK)a0NDC zaDHLoZZ*CWV(VmO(TLs+sh&S{ygZ29Z70FUwDp$T5GI9fa*JG|6%B*I6tzf6CD#z1 zf?4zo^G~@ETK8*zMbi|A{XGQTqo5QrwCa98c-ft`W4f6)R{?-mh_0qqVxz zd|2Lda#Q1ZVhk%SO-VF8_z-YaYVx0b=TF-*F)>Z>+b?u9?I)_JsL+R*!jn0A&8rH~ z!TO{-j9+4m#^anzF2wTxxYpM0+o5UQ-Kj09e8OoTeN zzeRW~1oc{3MGOteM?^-Zz*@E) z?@k=O-T{~d8y7pzu=HJu)-{!(tepYA#4`)9*PJh9zvCy7dXCy{fs51OT!rkMdzSa^ zTP9}arjzyu475;$Q<+{_iG{%s^MK&%|3FJs^bQdGIVd6mEgcG#FVH~n;l`O40^32R zra`aK@zgXmB|SZFEHOP19F`&KpT3tJNCU5Ke0hFIv`ljoR#sKTkK0O+10WIr^z_2B z5x((C+v!3^`9ob}?{GDi-WOKKK-BZb(WSO-2QIzHL^}rN5HZ}$q+ea0;wO^`N*VYcV z)X&#=U+=gUhnUE^#68hZKqO6P#+byY!9H|HEZG9qb;jUBD6tAofFy{yzcWIw40RoH5) z%(^7ch;UK28(pqGbByG&Mt7r&-FC6@{zg!Vr$tSx;lHxW!_9|XlDc)Bjah?mR+#3< z;cq=B+tz2tzCjXcvy;`fH;TpU>AgE+2Jb&@1SIZL`ECFw?Zi)s^3A&ga=I#hOpvPj zn0)an2+>8r3CfVsKcr(unFO+-V+u85XDRh{l|%s8x(Q=-r+Wd5wRrt6zPc{!o$<40 zMX*4k^c%t+eli(;PKFR&bz%gc*+p#YEMC*&|Hvw2)}!|2>R8_iY0OMODUj8#_`Ry# z+JNAedWqSeUz`eDb}^h6jHgS-L-UGX?EsOjrR&_B^KGgG%Qw3aBsr`6wPP@k4c8!? z1(IQwYS~e!{dN`t2(~bQFG_KeCF^`4{ckjQs$`#Pf7U;#{PUk2LxuQpeE+&(s?Rjl z-T5@k3Ll2Jpdz@;J+h#{!$`qJdeZ=?uSz5*@#B+>_HYLnoelt=W(}x6Hu18c8tCFz zKELzZu}3^cDTYIXul)X|OG%*yvyA$T`S9@j4oS^tc{CIWol0;rUe=v-)-pZZBo2k` zKR{%VYFiHGi(!4-oBA2=0H|oeMY4s}b!{UA@aWw!W{ho=muOPO)K(J84 z1@SOfzV;n*^7%7OiHvWhbt({v3A+K2gaqUVBfY`*fj+V6TLW>_H-?#d-^WO`Lr9|> z-{UiPRx7c$JZ{2Df9)T#^WRqg&}9E93-faLk6FWt*cub;E5}|LjWqOr6z$fPy(4-Hi{aKHrLvz0bLW~1Obu8pHdC% zT(Zt+SLwEwZ-SbDPA}NxzLTXb6ow}XK>sUpsHUIk9GKjzpe-gwO6PB{;S?iXV}9r+ zj0us`CB8w;@KnhN*`#ABzzx=&dQFV2fF7NT*f=Sf{5xk}PEOozTQI;!+YMB9ChxVT z0C|X-2**7VA(-1*^=X<^fBuf@@V$FVpgA=ATx4Bu_=B* z7>vE_M&W#2p+{rMxa9Two1o2Oi4o!Ii>?j@?Q-%C^b<4(OL7O z?)M_WU(L_FDZWw`mzSHtuc7;3$0Fe`vAHnaqh2NF40$uK+mB~gYp>_DqNuA(OBb(i z?NQF`J>s71^mTQ=ZEbh{7_7lZJy#T6_b75_KXkazb8&DR#$6JSe4yvJ_{$7LM-Vh! zKD_x)LHSWd^g4<3#^xz^;8jXsSJSE{ut`LL8z~4jxL+7PaKfAocfHr*;*{Q5D9Ya1 zJ)WB;z^$=@a|RrCp%3j{=>C|LgGlA5tt)Z!y^OP=A{I*FE*Xo{O9pFN+^q!jx%KUSzy1nIX3TR6% z0E=m6b|#5yoBS;$V>0kF%X&^T>tMZo%R;R;WkimNI?6wfmb8r2?eUk#@l>EMWT=V| zIX#-8i91ZnZrlno1mrY9%4Sa-%NM%cV!m5wXD(UuCWbZ~uW#XthQW8f>>iitd~3e- z(`n~|e{HCDm3Z31i>d?`OnqOS#z9p)54xcFM^fXn*-+>~-+YD(AED+z>u4 zL(YV{f#gcMKy55)^;|w{Y1{mqga`!Y4c)l^kkJThX zt`9JaLX%s)>FOLq$qFmFcp-o!VUdb%H zD(^zr)@3~&zDebIxj2K^WO;=KRPjXMh-#JUJCyD0 z7>+q&N0ei$3Tt9*03l0dgczu485y8rM;wMCV$8^ITG|^LjK3v7#3Q?GkM~zbFZ73n<0c|f>@H@+0UmY$Icx~%(+)8gFnS6R?GD>IRhvqb)q6d zzAG#7ar5`jwO@ZYzY}RVY4U&nNlT>|Hf$09sXrW>EZM~_<)fuyvSmmxLGWjSf%==P zt4uKuZC|H)O9s#zc|^=={;g>6#ZRwnc~tF1DB!ZqvD$u5+0DaaYl@`aer?E6u^DZkmhjZ-tEd%M5-DfRjNq#?Yo&BADpTrD&&t#%^b9T)vtZ~;NH8XipDpt}G+teQ z)SGU*)|EhHI&mGh6@f!D+knYt3IzQ}!mHj=z6BIP?dM@#8B7GnyCp;?_g zrGunO=L=u_qNPQ%2M*89<4x{~9NX`h#-Fx@suzx6UQRJZyGES2byE8-RYpqc<*$ZZ z0ozX#k|bWH~aAQYwU#-i%B%8@*v5mR)f~NtF=G>y!m6*?~uB zejshD!s74y>I0!(iF%M|($-mMWB?<8TSR2=`Dxtr5DnF+NSGqOv;`N=JGAXKmL;M{ z2bE6N!a-?LB5hN9$CJHX)-#Ywl`Z3ede%(hXDqh3x62n;$$G5~qtIw>pHhGk^o>z3)lbCQ|&%L@GKyX0HFuVK^o19H_*blA=g6qUoC^H)yPTL(? z$z+V%n)yWCj+GJ$grFB9AD1CK8W&5cbDXB1+~?W;LXxIMnxaa#ev_06eMLuC%DG9* z!-?}9i8aD(!@U$^HrI52`&=0IdLW*rASVYcMX^i3emR|TrHcE?Jf118cdp~{<-Fs$ z>m^u>K<}s1?AG<^PKAHklUA)6QFz$1AKLa+!R|)>Pi22(3 zm~wZ!gMGtD1NBsL5%_pqHbZ-k>odT)pxg@0Bk3=fo22sgXRZg_4o#kKM~`9#*}pmAOD2=ITlHuzXUEu_GkZDr&2;}0us;8j$7!svFC^%RSDW^o5; zwpbAB5+KQ$e~A9XhQvkR5Ee83wD$t7@OvsH`7N>Fc;Uy|7u6-MCGEW@Ex~nB9h+7{{ z;PksAJ}b`S(fEWFEa%XEKN^{qmdUVwv7U-mQw2;XV2O@tH9P$ak4)4~1F^;oY%!D^ z&KG|Ei7Ek+FVF-KV`dcHxDI6co_Td|yLcPILf94Ob$A@pM)SQlt7LC)J6^OFD8s@D zTHQB+1FAPui;HpgWCg7p+2MlZ>qkSz?9&pO+J5OHxX13Tj)!Oh9_|y%iwc!FlpGq7 zf?A`0Mxn(e0dafrS3KEDn-@L_mZ%L&lAQ=nbbmgLe@+mLZx4qx538)gzetd_2gsgQ z>q*zKquad^cs`FT#vV<9(Hm))y&vuP8F;J1E$WgOs`?akyi|XlCU(c?v3xGNd2#Vw zRpq?S(JyjKHs0yESAMm@lj~xL1Ojl~9T9>=0l#uft#xweh4y%fI5;fS27`H(MY29) z#Qt5x)LLdfEt zsZw%(_#2U-p?Mz>LW5*8ON+VUvb_og1GMG6P60*tt; z*r6Z+NxCFyi5@hZ>HJ@m7z6!PxKvA0iIy^4csw4?UfQiw435+V1$C&}nlaK9euy4V zqSRS}n|#E5aioDj?bM1|tiey`_q^R636qKTuY-e~(C6KHJb2Tn3Ui1r(QS(>#MME( zO*jst%JgZQo`EMfr(PmEqfHgx26bqpY6!+(jls6pb^1azNl<$xVpf-<-_A^ZRZN3Z z?}r0l_SXCp(<5}k{?ZGOPTVQ!o_ zE-%NE?NyYtDzmAYX$;AMk$t6cOYU>wmhuzxhd3iGY5Mig&6d#%2k)6=nGZUEG9G@U zM$T#^WQ7E+SBr<>d1vCT-TLs_P*YwSYa5r4-NokWg12D=k2Y(n#igZmMU-Bj901ac zX>uCe?z{&i$@Y+8fEo!ZoLBt~ZFN4U(%01a!lCj%1hMTH)SizNqxPc+Ken|%LdxX5 z!jv-01Aa}1ITZzvUG>T|v9lZCv;d|k6p=$Se!X;~j%5o;0toqmS?8R(uY0<4SZ}pRzHTDrR$~u=tn)*r*vonv86J)9{o>SY^uuKQDkbFm8 zP~y)~{kNN!8fRq}Q7+~@a0_X7-Mbz9)Y9baDmdgtl>!eB3x#VhpDD>YwVQ4@R9Jys z(*Fjbr_krYD4HDzq45l*tjU%ZX{19^5I@fG(>}AQm?VOo`5aJM!@~oaM}HrgLU%p8 zd8oDgcu^HQ@j!^g*sr#NtTF=u;&PaTt8Jqp*7N5uIZ5nHySWgyp!0dApMPRJKkV^6(>I;N=_0j@KO=!_LcyiK=9w;4+eun=Dv<2PJ&?6BHM?(Or z(QiMCJvrU?>=^n(>6xfd$zI&ycQ?0T2qx(mFDd;j_YIw`c5fWv2z3+NX2WM z0AN<6naL)}$UuO6>AgkXY5>fXU4;C=$5(Z_s*qA2BaTLBc;#l4G#tCnf3}1r!ECVUnMdXSPhc zZv<-RrZsi@&KBgWtJG`n1wgV$0wv%GH>S{mV@^09B{Tz3V$YN3-50JaI|fFm@bW}r zdWC9_jE^`WO8OUrVo$`Zc!K3om9GBS5-x<8_xoRMtvG4+3Rd<1&C?+ET#^dB(K6B$ z7-DfSG8V@mkDNj<55ZniaJ`JpuG#8`4xf)`rNl4?Tmtwsr?;o{zbt)8g=R{Mck{$F zeQg*IWrBm;Vg%6&y?l8k=e9+<_X^tDd)Zr5INS* za!Bd1j(zkB-J?OOaY8I?Lla|=GvsdbvnOu>J==#t&Tt93fhayQHEpsvZxNuxX*V|4 zSq^?+F?&BRRPGn_4`h!Ci7#dAXfm6D9cri|Tc!Lr9ae&8+sOZBpn7NzTMqI{&-4p9 z_G()0;9&H~;s<-2anKnS)RYB@xJJnsD5;&4%U>*xaBp%In^3C#nxfq{*ve1Gr zB%4-9$w(U)^}XuJkTDgUo+yeaN@~aovb|@4LT?7<2ud2|CWiKq;srjeFyD?YIfAT2 z$A+GH{w7BAsQhV|xh6-4{O#UTrv^O-lZZvwZ!aF0j1h8;!si=LkC zQjB+_Ik8h!rz!dUtg2HzO1&i~reQhgVs@}2s?R*alIH{2USed&xTfk;Dhx&d$yJ}Y zz%j}wEYar{743#QvPkhq{jJQ-D)b2}nbt6p%opxn{p4F^L=$iu>d5y=Aj%BbdlB** zLzDV+;|6^aThh(VEf+@AyyNuzc;|8^P~sPmqlH@!AP5&}Dj}p|h^Yhv2Fyk6_(YR_ zH3{?{&EUkADHn6%>)}30-zF$kg~VNSRgQQnUm7#aeybUd=c zKf72Z9jf$zZ&_3f+VuMU4d0 z$@9;Aws%kH?PWKpSnF;sj~nH7jQ)l1rk=f!ULF8>uaU-X@;o(ncW@z=QzaS= zKkniNS09jwn!GOZ8LuuYOA|yxyS;t#o#c}r%My*-#^fe6ijlih%L>4Zx8V7Z2*{j$ zC9aa9_Q)Gyo1jv(&|)nZy-RPsKQhkby>&`Saw+k)+ew@iYBcqU7$U_)ZGHZT3H}sc zPR8Z}AsFeKW=W3KuB-%8Dr-BtQ7>`Q?2u+d8M2gkD52e@#WUL4lUgQ<^iUa(_kbz+ zWn;1AoID!}i6FBt`7TY>+G?dMAwGer!LH1c*g_g5IK~y|(q-mgCQ0kY}W0yvz!awPYA}5uSK;=PmTjpReiMDeB2tVo$ zMSzHtBk1>6l3^z#gg(nl@>ReMUp7<9u*>5-&sfG0W0KNzV0pF@le|nr6bvhUDSW%L zKGsN2qTr^R^t#g>m<#G7+-j+WPtm;wUz=liP0y}ZhP#`xkL z@owdx>7iYRE_uTt3k&)PwbI(v=7hpR4P1r)$M%j+9(w%|iuD2-1g0*sVf@(LV>SFf z1%R2F7JE_V=ns_?^Nm_e$GED~2Ji}){e!U&b5#0BF zF;e2UfA{x>S3pqugu$fm@Mda-q^}+oLO)@MwE(6;hlb>6Rw|?2M-s@*%>Ci`Ae53L zX9N(W+W-<=dZ#8*^S1@*zS-uW)MmY=9xb>C^XI+OqSDskcB7_>!6ri!a{fnOfve&w z>50As4e|P7n7>+9^2Q2k=;h#T_tOGoV%*a7c>Ppk7jf4SF z2G`3YLp7mF%s?TylWT=cXktDLB0oBm>|5E1=W!`CZ8 z)%`~w3NJXDzv&oP&3?dC#{Hlb9!jD_In7C=$!X0i%&Wwjxg+S%5q02|Ue(3ZJzAGf z9UekQY;P+GXRcIflNmgbVIg{*gh?fvFwxB~4Hz+`kx!fuak#%ni;^l$Bd2B{!Amg_ z5+_mIY&J`PQ}$Y!W9W-RIKmQGQqhd1CFCd~SNAPBP1f)0sB0VeA){|jACUbn{SR$n zcvD|!J9kn?mfoW6@wNsWVPrxD^X{ICIqhv3b4L`1g|XzYBDkdH--IkuZSbfB zoHz^EuZAsgVCZTm!gp>b4J6&r4-eY7<$5`i8nj^y?!P;{$@(8L;#>VQcI!DetMqa5 zK64gXq%)~>{wmGERK(}bVhwWQ6Q<#UN3h8gC6NtyZY+nYno&jiM3AySbu^PjLCwtl3d*0~Jq5N(ad;a3PrhCo8!w&P zBkUFkKsgtN0Jg46yk65xHL;gSHUG|<9+m?;hq7p&eNZk1s(2`0c5%qba#8f`U}5e2 z8{)wUU1?YzOj}KA1fj$0<@d1iHBi~%rU4#!s-3F-fNzOI3{cVseCnO068=#_+N)ju z-I~CG^(JwMCb3kHsFrk>ICqva28tv(_GrE!c&#^PyiH2GHa+SLlj2MI`)zlSJg2I( z3gj~e3bHg1q+x5wNfu|ZNy-G1?c&yQG8n|rYDf`U-mgyCNc3L(@^Qg!MdweR1?c=% zLcGAR;G5bN@3u;xN(B0i1mNinw?cw8t9KTu#y;>q@Abdv>o73=Wi4s#=Fht}W}ME!>kxM1sx zC7av4Ky2*Q@1@FQUHrB<`vnp#G;gB;Zk(w!{y{9{w4NT#UUS#M>M#rFvb#U}*?~Ny zL?qc^-J_&fqTho`A_qw`2wrBE#*}E2(Df|NKiYG-O;W%0>%E%M8lv^$bAvhNjB)>n z-7uf?i_EE%h*P?-JTG%HY0s(Y4MkIMJ`sPTBkIf^_HV; zrwbUXgyas4*Hb_Eg)~?W1B5B9?VRDcUGzquX&?Vb)H)bO`H`H4b|BC8n;~hS{f}QA zX&~O7@X5C%qp<~0Q;I>zyXeW65LG8P7RgR) zSM|FjE>j`A=_nwxY8FG1plwCj-jdieW@u6pxcwQ;qt=5SoGJFWCAPKRC5Rzohe(0p zAtB`!!hNyI5JmtUq8(yuW5W{D_OmceXDqLMnzQ=!nD9ciT!MF>9tJy}MwYRa93Os|P04Pfkru-x%uz5jj89ag z8$$kMK=qK8p~{o}L2j4BC3y%wfOcDhej;&&KEWRgqL*fw7}hcmih0s(Y^8AmZSY;+7;exK$&=kq=6x#YheZBcmqSbmX_UL6Orty=5pD1lvS!N^u zTgH!3G7&kou@?K}u=w3SyVW>_OZB7ob#_fRp&k8wIdsMk3*uI>wr)M0)!;C_ks@J0 zjWCmd_ex<~VYDC9_`_V;Mi$g#U8=S9d@%;R(v%sMh^caopL6Gr^7Kjx4iZS~cc$Xk zm(~C*M@!JBZasVGZWk$5oF!yr7ntOFp^%flDiI`A|C#+KvnF@i z_dVbTe9i`_jsFju+Gss+TzR;ww0~_h_#e97)m!Aj zIM45ps|oZ_sfY6DG11|iyDnOEE?Jdf7>8`{XIBIk^Ke;ypXb(`)KPvFDh*A~~-#+iPXGMXr7U5T5- zA-JsOfx7kc$&sy1Se~eFlKz1LL!D9Im=&K(_su$FqBcW{8P0o!s|<1#a%i?iuW0u` zp#zZUGm^w5C={OFJ=K;UcTM1e^qI6YLqD!Fr;Mr(?lb}URJ`ulO(8W@BEhWeC=MND zRNuy#oqStC)%pkt8pi!=L_#$6=Z{W3!7{&cy@%(;R*#r0DG^P4N}3^sw&tlVC%7Xr zP01<;gN~rOmrquus;~^Nf|VO5G_i`16Axc=S}#(uvC`gYAwgl!i6lI#Nr*yN5R#SM zf4mPY4*FG4NUH2^mTYTP!%Djhj5tEE74m{!<^_+~?06AMj4$k}{3eCT?%Z-I#3VV|g={^n*MA%JdzU$Fgi!qW9o z*D>c>ob5+E4n!jsEtEVtJVDz~qPqa=D}(sg(#J+i@k~`|Z4eAOK*l^0dPFA@KZV)R=evh4G?72;-QQ03h^>DNe8F#A3BW0xAGIMzGY|x`DDoZA zBX@B_9lXT~Df$?fib*Q3s9*`jWmxopx1QWeja6C6yG-?0wHtr5WH_^|9URj2z*%Es zD*O#8t!C%9_yHsRg)Ed`p!3=l>h>cEqkV)BQybH;zfK9?uxRhsSGF&9k{YYQF=caW zovUpPXR9Co{em^8$BliM5fn7zS_qZ|uJ1L7UIqZBLA+TzKUc*It@h?`HpScTj~y>I z4;@1Ye%sp7tzZ0N!AdjC@?wf=o0zA8Mw#tGUqk)r<*_p7@6HVr>o0M*;=ro{Ta(RJMxP1&-vd{N7F?C{kX9gse(RDi#I;q7{(~dg+Kl?fyE(lH*dWrJkE$ z-LJvEVW*~ha^-2zi4pB)5xPlXLM9U5n4iO}%m0ZuYi?+k~N23W5ptHS?I5us*&SISvfSTvj- z*piWZqA>2jBlQNkmsQUHx5ArQeva);mY!;=N~5c(jH@oq3QpKo(i_qTa7ZEQYEI=hB2iIvQUWT< zgQJH@B3QH>o(lwq8~ANR8-!LiDfLu+7Bk_P?bwc|5q(O;{( z?p`roQQjznsmAxMp%1W=Zi|+xjB|OWr+>^ZWbFtkz;0C}?MAupKk?b++LmPu_{Qc0 zQuOZ5{DEkz1Fk-y7h||`nY-V4u&?dk)v&FoO^mmJviJtqt8lipd%S4X1i1Cxh1fj~ z?MssCsnU_q^YdfFdp*?VCnLYkCsChTck;rsaz{C~o~fU)?eH;qR2@k`*<;VOc@E56 zNRhRqU^Fo0!SxQ3O2>L=YKk2NYDdZ~w#-gfUB{a>JrvS7 z5Slt*H|7XS%G}y@H}boUJ5*cY=1$y+dg9`S4o`_J9lx^UZmd=@agKxT`Kn#NdfK%6?#0CxT|fk!dWXS9bh@f2WKIk z9zZqFuRYuOKy%M;^0GlZ!eqW2xQ2e)_Hz61c*6Wb9I#RtSLm? z&w-TDJXlcb>(>ZB*2teiF-)a4koC2-#eQGMf87ax)s{KqvdFjl=2UoiM3rS_v7hU8 z#$E!CGQItbw3}`^?2g;Uf4K4%*-q6Sh=?l^qJRjb)d_ZTe-*bz`)Es{HVsOnijz18 zmCj)nmA3y1!a!CTvCMi;!XmjxXFr{<%$J#Ai*HwU6YsC$la6*WyF_fWcHt*_w+*l# zTd?!_!}plA#&-hzYj@b_B#A7J{Cn&)y?VpdJXLGKi_P8i>n7&d{fPJDr5Klm4U4j` zKT!$4kZO_(4&R~y`7nu1nPS4w=dmPU9Dts|%ONNQ|MazZbzuZZB)T@Q)vpu1(rU-s zZA=19kg-d&k;L7!e#;f@?GYB=0~VdvTBPX6O?$w5yB3d1Z?&^oR~0K4dT}!wq-Eq2 z-;1u+laGQfy#}jYXO4j%;aUE1vC#U>_sW5)WSKR)rlX=kR*Jj{auejv6Vvwp0(Z>H zjV_64sD0Ac++WOUFYOH`;G;_~-RP96;#z~+xFJCcHP#oWJ@HPnv$|V8sI6eM3boG) zF@$TTQI*W0_KJ`w^68@5^*Ef*hy35wZ!sdIzsHsu_qxz~ts<>G-3#7rq?lul5Y;lxD|jac{WV zd;es;s&~K9NK)dqkU{V1v8^_Op5Z+JpU`Os?j`0Y`pDJLvM8$be=Ky`Vndmvyc_sc zH(wV8hMbgnCA;~c*e-z&X#oNyahXpHRNm|C_YqS{_V%XJ$u#Mjn42FaEBk&404XxQ zg%VIKInSS-e{IG0gPOsujW|DtGZur#u>ak>UNwuKnBldR=%(89yDJrOTYD0DS;kg! zIP5$=#@iB_#7JVAJ=+@3REk%q=Hoi>+FNS6NwfqXE%tsdnf|7roa2byrk_%{ON!?` z;M@w)?=huQHYF)PXF;K9{&9x>$6COQDR|oK(BDY@@ntyuv{rWQJtc@4D06^xa3-x!lbE_#!;`Gl-gv&CCE`(IaxjQx&#%Tng7 z{aM_boS&3bD08nM@#jeFC}84iMf^bhu`Wj=S7K54)%4H!Zsnj5J{0jF%a5klVbR}b z&xz?6cka__M28+xv4Mw2u7lQ7QVczQe|t`L)|;a5<)?@CjEwy(UyncENuLkXrzusn z6{Wn~eEPFEI*(!vKBUhwiIpt8_D7=o{*QQ z_%HRVB>fI=^qQjV?j*R$`T=tm-5Wg|A;|rhw-R(p#lnJb<(~pOxV`G!H-qmmiNp_I zQO|2p7DIBCi^L8`x^M0%Rgik9BH)~l^Kr57(tb@GK+2$#M6b;?wC4i)L^iuTgf`jR zc~2+oPCQ+xoZIibPe}#3NG_8ilBf7f=~O5CXZ)gtL(ui_k0iYek%W()?3O;Qq2&^S z?*>amkTHv+%NOP^9KMTdD#+~nn{=5;plO!%n~}0u5T&s=G**?5W1e_X20l$A`fPBM zoEm!~Y-{Ox0loEul;o_A`a~gP#^Zk4%wipZk`n(idC!k)kASDV?DLwn$Mm9PF~wC} zf@Ep<%mL1&J@f3m!qV@i-YvuqmJcHUA5-RX(ro4NFRFt?d zc>unszbKa#>poe%wZN+|=>AyL`twlWDUogN`MY}0jT(~QsETwM-K_ORjIKyoB+_4$*KdH} zZoz`PyGw9)g1fs0x8S;PcXxLP5ZoPt1`jL8P9NS?{!Aif=_keW20G{2gb@E1HH@zr~Q-And z1yM5_=DW(g;;nH(AavF1a5*u07>Erlm0I3`JvS8cJZNm!DptUZG??0YlE(ci6VVu&TG_hRy(A(v$wID2| z7xXvRk;^JWET8;1Q;TGb-dEF9( z+D7QHv`3NroLpSJ)OO+X@HQqq?c$Ru36B2O0W~;7s8BH#lLwd)jyl8qaXgst>cHlmoIXEcTIDwZu zf5!B_1{kg_O+TJHmVBm2l{48$dh|+}kyUKrT)H|h4kT0)!4EN$_VPI5`&$dkP9H-O z>+Cc;_?v=wcWBw{VJAg>%=aOBDL9U*hp75UF1JfP=eG5y8#s!Nc8{^AM<4+QBYL2+Bfn1bm&!NQ>3Vb%f0wD~q?_gznsr{jE$--==}N(cs^^Z0 z6Xj8}3r$@z8e@n;=i!QRM5SJ1Y9)F-xLVA;fzZ&XXI(y-XpXed>i zay9HQkW$2Nu3tmL&iO)K$~Ccf%sbQJcr0PITLoNq>VKf=IGp;{UEM@Rd4oLu;}-f8 zS4l@(v?y((^gg)iMiaP(W;d4Y^W})ZN|6kOX>1j(-ef2pFBz5GN6E{XO{SJ8)9YHf zuT|_Wa*j1LmLo~_v|J|tT}(*dqR7~YVjK#z75o2U0#zZWv}H`bwEo4yZK!ug!rX6z`>%XXNIme}3RC#OMq{ZvlEM zh6s3oj9Bsp-oBB@(%tn{^=$RzHjcu^m!NewZ8`!&}?y2j)p|>9Sikvl1dkbjz*yX;V zFN1$1koiwBVN!NCM^3zYc$hjR$or*59#!i)53}Y$8c?5KpTQ!dE;;icHMJJApK?fP zGL*dgu^hZ7HO*dcPusKgfiHIU8(aGj`DOfuji0Fjfs;(_3FGD+;5=VE0)oegQS2y* z`$?nMf#dRg;i@Cye?e&P^;w_nEb;y07QpGVo)6*Cqx(5tdr>)VGkipDQ*8EI-T0GD z9)zC9LLX6^ySf|Vv+{%YYKo(CFPcFrP-L0DiLrVQcflgvU<6R>+b9W~ zai0Hx^lsi7KKQu1yI%kb=J@m6?dL%%+OAd|!D{3b!164T^Y)mI>)2B@?E6cHdB=L6>q0;+o%PJ)9i zU&uj{Jo7G~rTw5bvALRDJWp%%y!WZ|tZhTP(exvL33vu7dNF@xNUIl=y)=aRTQ%zujgJ4zryO^L)?WnF=66p37CUcozVT z;C8!abp==r!uR~=KQuY+%Q`jMjYX!d6+ga)(sH4O%pFOR-+F(HK&>1AVT`f0$m}VD%x`Q= z0?2~VBr19BPFJeH$Hn|Hb9O))pT=S|1LSvP<>irP1+S(mQrCbhqiFKR+Iw%9grC-C zFW+BYp1Cu$QoX#%ag(3hVSVWRPJMm<5%M?^fl2{{PWZbyb^|8+AE4t-+m9E?OH0E| zV>ZymsCz^6+ky7mC)_4Yl~Yw$AAEPmcVNWc1+RQMv&DN$0B8X)2Wr+E_C)CYwEab2 z_w&`~zxT(;(&P>y(B$;JtIPpH1>DwE-rc`(<$xq7;D&D+@OvZ(?uT zFnZL)@f4v2&CSWcWRz`J*J;^esU#=s=ElLq!~`U2Hyzzp+&f=xH*^4n|BAjF3d_%D zb|;_3Y->9^GeCv^-q7v0*E@Z`i{W?wBl7-}_-<#V^68h&`7f~mGz8MRbPo))*G>>z z2jE$}e=CYvM-mjMAC8p+Cn(|t#Q^J6FIPI~ha)Metpx#+e-~gn{|5jgAl$RSTm1gE zsQ5nPJdXxG!vPAgx5xUoJ)l#DuLJ?HwhIwJ8<4JD^Any02p1g}BZQTel_tQO{Rc#; zUpXm+%|?(dXL81w+JB3YCmJ72q&@@8u=fc{tgvq#*fBmTijgT_+&82IH2TkfwSMje zBQd}C#}njdKF}Yq-%$v;=YWwZl8jmH_I8sT-F*^f>AA*y2UNW;1UfxFTyR9r|G|C! zhR&c_g9mD-0=mugmnb@E>7UyTC-4g-Py}FCXwY-XJv$$lrklp@MpDEXA1{=?BQ6v& z*~1j52TRip< zV!pltZ4Pe07+$8<`-P<&1!NLBcIs z96(9ytpB-Nj`v~aJG$-pUxdh?46`_V#iSIt{SeZE@^ZLQ7a8j0_q7-pF~A4nAQ53l z2XH0;z69{wIR3x10R5}J`*OlD=&i@!TF#6ZAAfg2p5@@(uK-97FuHujnr1-nd2ajj zyfZV_di@2sxVU}@MW6@o#|gyM`=8mpuk+nEwN4gW-QGms=0v^nMxP(9beb(uHa9n? zGT4fXm~9zxfhc3f7`WeW=RuVB{)!;>iTqlv>9T4PkvI#+$HzAT(jdjSnhp+30FLGz zW}~hwl&a^{Jaj^Ll*%^IeWnJj_K154Hb% zae#$`<2!8_1UkB^XP^1r7g)9K00iu=n=+0Mh9)S$#yVW*DD=V6JcLkz>c)vds?-R?r z8|HYd+W@Q^w{fcUxy{XKwoxK+KzI$Tzf|y0fKnHrLjf~c^0cM*sK8eLFD;|#fB#rx zaGCZ(v6OZI$`Sr#Itv(xBSa-rzR4~ea{}|31%Q>S(QA);54?bY^#m|D$xj9nz|8u| z$d4^<-}!zwVsUvnoGm^pv7Mw~&*vLy-ptfP~ThhBrsxbp0~5!#Wr(;9-AUJ9}(DrV0<Fml>X3bVOQ(=0h`-U+d!PRE`QYiPB?eI~bhyqx1U{rLw(`I)i)K&0%aRXQetTH?1;xc?*Uclsc652% z%Q%d0fu$EI@jcI1qk|=>R(W@6DFd)(;I?O-(WHbl5$T7lv=Md>VfxzDiDcwJh)#;y zzVPH~D_wp}qi^%|)56CW+owiyvPw2)8$M!YjcaFX-}`)_RwZI-)gI#7(243V zrnZzgpWhhMEI?g_Un?ghCcMVOTx;@DaN&c{$!LBH=bNhx6u2iUeIq&(#;Co14NUo) zqj}J}<#{kN<;W-|7FwX)NYW66SK3%2G1*YP?4zYVS`-Pa|LF{I+^~W;` zjRW}^dPfRfu_BOE^(No>DD=IiO)~Hm{xWJuE3$8PQE#$WemTqeVUq@sEZK~!BGvhk zS83{ft!jGHb~eM&@fA&EfT zo43fzZF5&zgba6g7jM5hE@Zl z56~Fux~0~dYE)O;)2Xaj;i0}hP?{Yeu(*#wl`CpH8!7GaEK9y;BAT4^oDRa}$Gs3x za+{W6h7WbIK7?i`lyL+%Y#FBgDoqU}$#$>&zYARscspFX8L$U6@k&xkc7RpnyTYgcB z0}l@Ds65E%Xf&ad$NfP5B+g_@H*Ty@aWs*t^RROMrLRh(l>Vv6m7%kApYDe$LmZ~7 zePDt70zvGT)WmJj@ObRaM)iAA<_GiNZHh(O7uty`wL2T6IMa_I*r(hDRj$=QH;5qB z5uvIX4y%-*ib>LDCM@5kviuSwmxRZnb0WOAZ8`V~H0>5mzV6z`exdNX^ft!y$@FuT z#ZMpdLfvfL_YRM)UHa1VY@cqn6NX8%1*`qu)d_tw(3H*Svx`+??*H4egG3RZ=Q%(e9ixtG~} z8zN56dMn=F#86LC%dzKd<~Nh5HrZO~8d_6@Zlvl|44Y3ox2ahsT$Q6Oa4U#BU*?FH zkanyl8K7VUa#eGZ`9vs@E-|OoRJwpqz80>IoP_Z&n{9lZZy~|n&{K=`Sr6Xi+ZZL! z{a=@D)E#SwX}$WdoXmAG6z$%+AStQ9Jh0pLf7OH21bV&Rj^A*6c{NL;76rBkf@MhW zprTuh@&l#qPjR}Lc~$hgyWZ7yxJtHLNwsPmqjQJUw`dT-S*>AKq694uQ_t;Z*NUQ_ zVmaD2KJ5lHW5^dm-@2^dW1^&|V3sbO`_46q{pnVF`g0$e5V;9;TZT+YDAq7_LK!{jHNIq8%JOhr`Wb zGuGp#pW9a&+kW!i!}(54kgDwgFNdnJilI=6K1stAlmfNU7>%gB?@M52_{OQ+tH#>~ zYGD#I8^ggqG4xK1o8c3D80%RY-d}1{8cF32;mcpIATx>Ru{WB%9JpfncgD~=Ta|7& z5=H&Rwgl%AU5<=Zs_A(RJWt#EaO321v>V~P8wTbGe9c*55=v(a@4M4}8Ojy(f6HxY z=Ux<~3kH{cP$b7CQ`J*u&)frpdt#&nMyJ}S*W-CXBUF$PSJV3A=Jcj=GjV0ANhPye z+JS9P0}Wt>{;54pYWTG|UQtk?WYR{*c+Ggj<038*_!PYyqKIGUDUGrB$#@SF3A6e3 zGI$oZwt@ggDy4@$Caw4mp`nv?`oeE|xg`ocS8^W%KyT~| zk%ySP77cSMcxx1am+rmj`kkV`fUdq)TFmCUS@Ju=Xs}q zN$xqI6uXR%0(y}~!zBi&RX%VWa#D0p3wmycMD~dZV3=xtx!ZnCK1JeL@LIK5n({^S z=teCLK`_d{oG5YeZNN6LtDWwx-)WgQ(Rwm93KzOx8~wJL<;>H^EkV9adk1XM-`Vdk zp9IA4uuB*Prfmh8m^RXWWZBu3Cf*;2>6P$(!j^lcO`~dH3{CjlPNrmi76c<+0 z!AN~?`b^yY;`r+E0vQ99xFGSduMu5%rHm(2Cq_!@Jc9KQg8wrb#2EcN8!`LJC?KTR zgCN5@V@EQ`9)9xkjVVp!nKjWq4hz+KbT!Fcz_p`yARTI3s{-94iWM^y^=p0--eg&2 zXBaq5Wc2c2lK0_H;O@qDXRJQ+-FjDX++bQO%f-M;pebpt_>k^uQ)kTimM{?cV@M@z z35J?U%Y5p}SmF+odHyfS4Ga0&(e!L4S0Uzb{(rlL7b;%{8f_|+ z)v#cGU;j9HSeeaJWKaEl_ELlq)3@;F3Q=CSz7UmFVlS#8gcmlb&{tYSr1$UBw^~1h zT*c(b;mVj*35#F}!El$Wk}G^z&-0QU1}KO7MM$7DImZ4bgfD1XG({%CWVz+I9)VR) zMs~;h8GwcUDfB%rBeiFQQS0EHr)5IO_EJpxDj?Os7$c*BP8))XoQ9%i$4D8Zibuf; z&x#t@b)am&)e=@6_$mY>zwInj9SwVuz~?_QgR5!(a1B!MIonoL^6(B=QVImO>@V@O ze*X-7p2Ba>E-Wp?RTp$ntMQWSyZ37E>2d@-XG~YFwrNUB0*z@z(PN8Y#7~&=XWvtO>PAK)A9$z>58AR_ zn^zkgad@6@VKp6Bl?w5>N{XyQ$^mQa5A_u>>7vElRpJxbz=PV)3GB6E=sbXx|y*H*%fTTDk>?6yE@ zI?&*w{^_Lsrl|EWbCiUt*^HudfV%EsA5tOD#U6MI1%;zf0$Y$U?K`(s-TKn8MIG$N0SRrQ$~#^WhxuO!2^;y7U>b{W_DW#FRimITI1COqxX9hjzmK7li0s zq*`JT_Mh~JG>a>+p5sA0&+ooth+y6oO9y%_XXdVG7k6#BgBpin@0X>vd4A*m(__Xw zj$|jpD_C z==XXt=OS>|DzM24HrWXNWayLVATEx4eW$LT+}G$pt(*nSwIYKQ__~BynVWn_r8KZf zI}+sDZ2%0C5CEF?Hs@~y-0A(bv%7z`nngAESkTs+7>A$m8LyAw&&8F_vmdMl)FG30 zUn$8GI{5is%h~~tfXLjukD{16vEuA-*3;2!_cvshSLwh2dBbuVY4+mZ_Nxq#un5>O zL*}F=Dq+=5lZ>y&2$Di%uxDjfpo;}96f%^AeUXi_K$gOz4Bfff8%~jv=sa5%aa-Mu zxMG0_+2|{q)sL1#=YvT)k|h*lyW#Lx#K`cs)?(06l_+OQZYz&SjVXm>gau+Pqya|S zwIiggw+)xaxiU%$U$%U07nfBkxwe`rH%9f-_+ETTr6Mfy%PILx$7y>-U;V#_b)j4C zwyobyjKN>XLWeM)KAT^q3Rv;DhVEjmVsO_228csB6j0S@0u#@ z7?P9dN|@$@s8tYaKL!-cuNN0m2XVrZF#)`xfN*~h1}T*_mP&fn@C~%S^8Av@td;O} zV8+6_=0)QHw4|u~zmR_;lnR4C@AoE4-1vn3F2@08Dk2319)=;enjCpsSQFJM?kcY2 zvT&J#1K1&g(bD1$H6`fvvv|u&>Crj9>2%lV{Y&l7gGH-=JTWpOm(iyPF!15JSF@Ej zf@>T~t2q*?v)i30qtjA^Voi|<3ngNFk%G6FZMPwf0(5Pc(s2pz*{*6IzW zZJm{|!*l2{eQ6rl&lC1Yh)lc%e-c zDHd!dS-jdClPGE4IZt~K6e{Uvd9ko;_*Wf)JrjAO9ZAZ$Qnuv&;O1@o&HHWi?mzc) zhnVXwk{3K2!xwEaV;z$mRnmE}q{Uq?&>Xx$2_8qd?x^#iRXIoHJo!KU8b79=0fIB} z`Rk(Wra|EuSOuwcRo_D9!vUW51+f3=wigAdISN1)j6Zj`8v`R9Sx4)0%X4dyCgV%2 z2j}|hC2Gc={)3;793E2>ZdV&K|7oT6jN)akiy! zA|o$ix_dnyLKfPNc@hSUm+@`Gq#W)ItbcNX}h(t*EQ`q-EB?+ zXv=nyf21t+5L5LP+*28t4P3lh=aMpR{8AP8RpAT@2pyxI8c8!73?8z0CTDUs=Dp~D zFE$G7VYt!HGQ%OfF3*il zz*Y&?A6FnBTH=6pA7DKUgca;zO#gjW8N+pU)9LP$v6bM8gRcN~^_a&V{ifTjG3rr-7s9I;xcS4SVag50mYC4z7>+|KSI zvRxG{_rC87S?1(Y*v_Dldc~sP|7vmSKIuZM!E-{*-XQp`vaU{#)J+q07zbGF;EbTJ zVk%hwN-5x7_zvsZDadr=eqR@ZoLYtSO`@VSQA@o@1Y& zpbT(L(b21Thkr8Ln(LY&wn)}EA_m14_@hmp{^`(Ren2s4Yv1QX4yzDf#l7J-}n$)=3-Q%!Wu zMtCZNELwTguo-U~C4`Ph4>J{4*ZWA-svFN2EBe8m4KD3+2}k*DD#DU1$WD0axI75GpQgKLRz`%T7*ren3U2O4vN+^Wh`F zBK_ShW;eYf6I4s+Gj11ThR~F@H$O_e*DV(0MXrj0Q*i{fkZ(#sg&D`acDUlEz&I{c z(L7#VHr)tvU)s*ctZz$V{7}2}e#(VVAWcM(InJe_jHQ$UI(!NORmyA9BDFpvvW74T z_-4BSgjyaGS=+xS8Nb=W^xp2JJ#McXOwag>q^_1FuQKP^!paT(GU2r9M!#m^D}q|M zmQ`0YCduHYEOu)$mskSBz6HQDScY6XlVi%$>rzv#t!>Zt&7prjOGVIj+U^cY3&;C_ zDUXMaxq`;JDq$~ch(A|m-HDh2ab4KU{Bz3x2;0VLt~cbO)3Z!vW9Q=*9zwlxv6F_p zA>D@}HmM9f4?j#Psm<8yFpSzu(yu;s2O}{x&z%yV6vcr?zfJ@7xBK=~0RWDNz|HB9x+r5?7r6)~3+i{Gv+7D^V1<8bQW;g`V?Mmkul z4qQ5|C&P#8K28bZ05_V-vur%VIv2U*%{o%#GpUGh%81h8PGw7y&D{qLU}X)c~26P&mc3PixR6?NxOLY3yOwb45)P#ZOFgT4^(@Mc>&a~?!_NCBO zlIXJ!v8XiN-5nnGp0#qg8-!%m%h575usReC4RezEhMcB}cS4AD5zH_{VY7sv+MCrJ zB%RRa(m<|4Er>G1j3w~awlx&OYh|MsbNt3*6K(@~8%ip@V{(?Z*z)qV_ucYd+Q z$ZoxxcD0d)zxrM%#j!gr(|;p7RHPtRwwiNR?&iu6L(|UIQ|u_XJ#;7 zSW28T>KaFNqo}7faXD^$O2nAIGg#iuKRV7lI2nyEGQU}mELp?R1R&q-~JYGPrT1y5Kl+QvfCARlnh7)!o zVfGN-Pmvr4;M|%NIt!sqrv163SX#w(kvBp7$j_fu2`aD1+!ABV+)<2RHntp9dhM!- zamZ6Z&uEtq((Mp+Ygf zb&_X}(9)8$IPB7aRI@6u`dg8;Q8A?VWTGrMlXdO)q&=Ii)4)-DE}^w5x~4kltxUlM zU(8B~SKKkw=5k^SV}t0pV1i(c7R`tIaIFh3&L(JizAG@x&+uX+>cHT}VVQYZf8Wg& z$mI4Uo``ck1vbmKmM2{*eL~f+y9J&2UmeWD!}*RALcF}EVb{wQMm-n_2ndg@ouD>Y zlgLg3oSMd`L3GuG8MWHL@EQ-y>6$^BMxTDn%%YNb$%&?m{pm%5-c z`bB!1+e=ZcridS%K!I?0oVatjD9M2qN-O3Ds5UkS&4Eie8o&M$Px zwy}0BOPEa_FR=kmSA!R9$}~w)jjR}ap7F@iK(6N=8GsgGCK@HQ2nf;B$)SU`8N0>H9Qf%vXbR)jKU&i^tu z*83XW^t_E7SOomUo%+kks8wK#xMl1Sbwez6;XdfXP2~uKfMt2*L=CjO^sBw8t^tvO zo|Rvrmy7e4DlKv$Mr=v*l<+C2#e;Fk=a`Dy>0HWA91>>&ixiv-9l~f|YoV(Sot(Xq zp<&0-D)eEVa<&#?;t^v!`N(L4Win_i%t;$dP3?f1zcG`7*l#q_{ClLUd?XZ5?cx#s zc1l7P8&jPYGNc>TzVfK2=lwi4-<1IVLCnx}X&bt*+t0E^DJJJvE2i+{A|od!I9hwv zl}5~Z4xKb%ft8nYVB}L*CSP;zZ6?xc#u@n;O4w9pS4$$!LX(PU-=D*{XzlWmFJ^-p zS$6zUysDUq)FpWR+;l}QF*)bb__A+thTX5iT`RSg(w;ngM25N#>}ilDS{-tK}Y_69H%dF;hDw;!8oQ$>CHd4ncZZodseLGkUW+UM(Ac0rgjLPTdfest-wK1O|EY!qxcnS(;4n0EN=kM@~ z$>CfSs>JJ@P*VFg(;K+%te#RpttJWg>f`$s`)3Bq#*<>8xFmarfANDd=p?T=o)W8c!?xaw_4lD&(;F2nh&uWtUqT zC^jdZJu}BaAC4nV|Q=WK@2d+cy=Tu!z>e&oY z30)aI)A5F_6?8FodxSK2!kAB-USg)^FtG#hW47b&3=y4yW@&xc6%MYeRmcLa%#Gy4 z{6k1-?2p(d-7pXOdC6NZN`BkbVu3PEyllS%(PY z1iz0E4DV&$v~UB#`g&h>oDW6%^FO&*3zJj4*5r+bq#NvSv9G-tak>eV#PQ_n?t(3* z3~9)t_>K0&I*qAZ;ux_tu?APRe$J(V46_yVr8FfhBQPBmWf=rpIO>e`hIo@WUn>bq z>grG{|9Txcy~X!j#Whz~J-&KE+#K_TGZp9&jwuu7VRSVQH#R}m$SHc{P}d`yJ@Kn67hR%R{3co-v-+|1huF^| zC^%IXeplaOyUBA;DRNIt-P&cjGl88!8O~)ar<(m6D#%>HAg5WA(;_XhgV`ZdTAlXz z9>`%TS1>Qrti0LcOxKnJ-_Xfu(rB3(d>>B~lnSvB9|Z(>vW@QQETf-q$g;Ba#!~6N z+AXwHa)Lg-Ypqkpg=wx-Daf_=0*i)D5`H19MJqx|~l8E3-FG_y+SNc${c;Va2|RC zO6Y7VKuNN{Ou_ag7K!bjr5%)lQnH*^CGe6|conwVbeaom?+uO>(wOXc*i1(72rL!I za4YFHIxaQi9^m{^;`5%#T2wL?%ppCu6!pgY>j$wUi(`RPBGF4}9=0bZlqWok<1|T9mn3Za(#2RFYweyTBs0}!YcW(9(fcn5}zGAVHqi5w+7kqUv08r zDD;9Z!ylNSJl^~*OG_XLAC)q*%b2KbJy1wXljEhfHm%B|Ua3))c7nC!Ls?>LGit&Z z%BZ3J8D4J^wAFn%zNmDt^0O0dqfO?9@_3yR{#S{Y_u9tLAX}(hfvXN?A-e9UjbjB> z`m`xFxk{x%+^hXo)DHdv+s6{pU0FstxXWo2=*#RqD~FiA0mnlC5g-8 z@%v-@lqUkqO_ndPkIDY#sfv19G$-oZxI*?eHD;H8WT)25m<@zB?d_e+X7b#C6D%!$ z1h!eY%%n5#>*e#s-_NO_ zVTgq&kRvt7>E-ldd8hy(RkOq3HeHJU4B{pjzbW+sH;$@y3TpPIM>UsWA=)ieIyQ|{ zdT$J*Bq69%&##&!p3i=VPn)ExG`o;BcYa<(8F)H~?4$A?A&V}$`|CEWycBDFMK7#A@PssV0|zA*|qv6&KqJiB;732Aqv$;wHJ$% zm#UP#golWW=PQwU=H5Tm*PNwZbzqC62}_S_QpU-Fgc-jSJN+NC z8T~e&{Nkh`_f!`IAzjDKnSoP{3c$Xlg#TwTT8*(Hid1k05=)`S&346)eE^87xZoh$ zX6|6`(6AEZhG(QVN;oSNfgfiq8$rI1Izcv;?8ryF_Kk9Jl!01-NaXvBMwxn)Z1ZiA z!vR4H6l07tXIyEH;NC5htY+QjL|*gXgk8MC3{hIlLZ0lwiYSaGaZa8V(gE1x*8o?K z<>PByS9%UB^OP4fzJwb>S9_%#r8a>GW8#vvrNA6) zXka9q^mufj-b*Y}*Oft7xY&)&ZxFEZKSLCLJH%NXsLTrv2mdfU#41+ajcqIkj)9uw z9sw%J52v?6wtsstV9`L70_kM~os#Bji*;67QZa)#S9| zvJ}f^I^zN>Q`m_a!lDPGnWsV<*Jp!W!WcqTy|LzRij+1XUO}vwVXYYJB^Yjkf9+v! zI+<4c&An}&*9Ez3H^Haf@%+HaiP36Z_0wG17Kz2i5@$cyNqdl`7gpV~nkF&w%-MK% zTI%vJ11&&7tLDOO4YXsUUN+U5!jDpW{P&y)UE5h%hG!sY+#FDd^{On}Rz3LTnZ@x3 zOOpgf_vSe&Fxk|BSi6LklmPU*KvrGJ^y3zuP$#Wu(-Z^Y3 z(=0ON!Q&-t&`_i_`O@$}jdo9XYj!*P)y`mrjgjoivQpDL49UaLs15PPMDG>aUSIJc zhh=+X%_g?#BR} zpj<+0jeb|Ci~)mU@?nu3_2PO;0e6a+ov5-E4}`@#UU8CV;YVS%U%sMna*_K8Z&4Kd znnsdBRl34Ig2c)HUkkuKilrwql{FD-?? zV`%v@R!&Kc?iiPCmKIhh-Wz;2YHO6$mnNE?D;U%Rp;FmGBY$jA!Jpq^QPLdDz?{XS z%E9v{ueV!-e%|eG5llFN_JP4AsS^LeQono5o3-#vrJpMGxFtu9>mv<(1jX~gakq)1%4pf$fw`MMKtP!2JCERv>(`;c!|T* z-ok>LyQpz3UVmqPyNf;i)t=rwDrvNT-|Ok^GR|K%oh2>|PWfp|z!k0o7k5}@g<8PP zJP#Eo+z{7OHnM8xlTsb9Eak*Mz!T7!SC+;rJyXpBoP3&U8vg=r?mQFX_Z^7McjKiT zQ8VH}G=a}EXbc+6=Evt@Mw5y};Gj0Uu{hG{37hFvjNNwQF?Dx2^^0?+RG1A{di8xt zH`Zq|LHX?eFE?fc6NLAC>Uq|E-!_t9GxIRx`+WPTBcaeKjz%8XFju|W4X*@WK6d&K zjlJLt!4BCnEXukbVcn@#31>3(*$831;H*wQADTtEmuKAUD14kW_j44$1G;40>f?Fqsl9~tJwpUlD20v-C7xWPA9m;7W^~+?F zsg!EEnLm)-AK8?Lw5{F$yfc$x%o?SF|D_j7Xfo-$$!OG>)IrxbkvM&@y1pjP?UXD> z)p+Sm&BfESam1!TB#<`$gKMtW6p5=T{8c|ma#LRBaFH^W*WUwEZ>>hz$^34$r0Lfq zOBP|csG_3Knthjw&*;S^IpXIQ7#W*|1;H$=c-#IauC7JX8e2-txI&G*3eFt;xhz(Q zzq#kF!wJon)kSkTQ|~vmP&>$p_^-H9?>pLJs}&Okc(MrxIfQ;yk{=0xdIz+A&YS!B za|y>wiF!|oFZV?;c>6GT@y=?3HfFsGru9aV6J$q5fKto|TF_}xyS6_r3Y7m8qnt6C z;hr^8Czy*rEEG6RaV2YL=VZFH#G1Idr@&W%s#o!u;Q10_WsIjsMGB_=ffjz{|Z%ME?qIy|(K3Z3$l1Lr?5R(5#(^)`O)qHJS>2B$k4v~@) zkV{H;w;&x7k`k8&>5@ z9qBN+7fZ_xK~4v|Vop3-XadxdM~Z3v8ZHmzr6dXsJ%m^>=hM#X4PfJQDDyJM;vn*! z2`R&ha`ULBN(`D@l7hnV;Us^hR>LUMk;y+H#)J8 z0%!=*=B8rbU*O42;!p_35={pr4#f_b#RP|uM8*u6^_g*>Ulr&)Es|=sRDIJ{V5cp2 z_w`Qi;VD2-eOcDQ;?l$_O~Bh*Cn9rWh1tkuCpXYElOQ!0 z6yM$vbn=m>-k_Y7UDw7M4|VwM72M+e0Q=yQ1zzniO&-L?Uo|P--TorGgz^`cOd|Yu z={aU6&2a7PA5U%oyQzvPuO$D{X6xo8d`^3&De39Q73N2V{PB2&N{1oCN#aDgSilMs zzWmlvvviGH;Jwc6QqVN>Z$XTXa&`Fu+w5qD`)4UQ^-ld-7QtOwlX4R2DsM@l05p+O zOr8IPujm)&`)}|?6_m;{_!<{CoqgM&BMKrBDXtUW2s0oNwr0_{JK9A~k(og_fgQM} z6~y^gf}+7;Cd6Geba`Pk3MhPday-wFg1?#)BaO+VH>OG{qmhXz*?r@?vXWAWe0_NS zNy07SrF>YeYuEJppicbFu&+^jh$4TwJDdL$!$lZjHt*2e(|grMKG$Ej3-rxx=LSg} zy4`6Ut^G!i=R6LN7rc-P(){l(oKpN)q?I&%vwbyeO9lR%Ph*e=v7z2Tf0ncQ`+3c_ zRqn5FH|`R2bMWIXo;04)>-3Ke%C+N6!x5XQq&7DXmMikR~wQcLodaZWB4tnYur1q9Y6ng`+j4B?#$|Rc6FDY&#|NON$gqG zp2caYj#f;60jr=?DX$0XNMDa{_*%3`O5LJo?56kEZj}$H(vZpEm+RbC5LIO@J!x?{ zR{Vkyvnv7T6dngr+AvaEx!4#L!OHKGX*Fy$nvTcZjNESoQ+-(b?CyM`%~)#Gu$X8N zvXp-kw@l~~HGM#RF3XBH#*}Zu&km;`jhY%P#!@OKK0H<3O~-A`gZY8<7n=cFYNlkC zn{^Pj!9eBBcAqpjQ9!PAKS4|4F!0C4J{dpd`!||GLpgPByZDabCGHB6)R4f}g)0HS z_sHbpZ}G%LA&`nCoZL!{#xwSk1F3{^G9!TYT>B1l$_81bx0euD$$80 zgfMQl#o*xKxF*g&n7U1$CDCLy;gfuZAlAU`>pmAkbL?|W(qK9~EZj)J2!`*&f(E7S zD)#Blycc7Fhq^b<$}iZ&(E7U6hRu!|TVy_}nXmn^Q*ydtgUDRYY%vuS-Qo%~|29*@?S8N=4Sd@Zj7oi;k#*q?-JPWLQ88w>3rRL0 zrbx}%kH0a;MGb*Z3}xn7Xa5)-9)lvL_)c1v2o1vjqp-D^0UDHldc~eRfFBk3&#i4{ zzv_r`{fv;2!WRKA$V5iDzwpp3@b$|v(^L{oLhiJeq+zd{G>v8cCAbc?+fnj?u&H=Z zND(#P{EE@H&&hykCbx!C;+`rA?G*u6-`wY{t&ffui?S9xwnq#*5S@Zq30s+_tTlTMkyzfgE2b^aRRK$ zi3PzCuV9XV{YTd~mu>@RA`E$*ns17J7oh}6KZ8yL+3N;XeToToMbOn`RZ(oCSGq&8uFb0o01u&FQ&?$t8Z1?&3vPF!4);P@+&{?JC?fm%}FBt z<7rRzeiKy`n&%tpZLjLQO5hgl3mQwO5S{ja4_}r&m8J`mu-Mc7QM_PI!biOEG6J%Z zys73km$;@QjjT7`^jswUZK`>C^TPsf47xUNbD+j{FwK=o_}4FzwgGHBdGo7zFa3}U zY9?Ium}|b&z5DOGrSta*I1W}WT011cDw%E3f#I$Ef8pn)h_Z3sUnu(7T&m;h19(ca zf_fYM=F$Y#vWlgI5Lm~s;cP7%=wGix@1bd+@~8;H~V^msQ92n#Ur zEl_=X{63RqK5RZygy~IvjsvK0qI+Pdhgw%%Y~pwvDB}-zDA4{VeLt$RnqYt-MC2#d zfxX>|lJ714i0~D;L(2sr4Aro{TU@?bZ1lhaE-C;vj^J)%1~z0Dx4!4i2hXl`ZSlM~ zs~bT3I-38J6l~CN)X>i2js_MDE{U; zpehxhEG%uDQ+vQ40d7Q(t1k>3>tqvPHlkoEZ-54wP!b)o zDR1ds?TUDQeVW|%)hZQ;rQ`d|03YD#l>hGbmVZ4)ydJ<18USc!`{+p8X6W`}FTy|F zTSPPyC9BB<5Nt?WZ-yM40OcdAh9O115_G~dAOIhs2_c8t%~jXbyiiFl2YU5-fFua*GCjY%1dMShhBcm{VKXj39H$Nh_60;e z{3h)P!vb66z!~p-!Gv~_hJ+EItiZSzFw}?)T{{d=F~qm@RaJ4X5x@%w5+woZ0bnLz z_7Qh?eP&#+F*RSH{m}h&rH?U#E=B%ykbC4c5b;Oxuc81EHu~@DleGpgC1GDcdJ9S( zXXoaufQNJ15N+V^T06}$eI0e$!?hIoeAE6;gO`VtXMD+o?exL*6o&)81|RcynoPd= zkt1|1ptT91{XwMxKIz7*onZj1G0eY)0f-Gd`}^yFb%6_;+QULe>i`9lSzDXr{#Fsd zMgWRqqjKOCJkZ7l6qhxI12bzptdPRu;+(d&3~5S_Ko}ckziOn?r#pSL2fDkbhfGyGsD)mx;IzHpNlMx2baJ!y=rCS{e8*C3iq`?n{%|$S@uaGI-sUawUZ-4|4Ho7*IGqx(ImseNLD?vnDRzNLLK@5|S z10D*1Rh)!~-ur`c*iSbb$!BX+Pv3w%KLjYZ72lpnz&HTTOJA-|nwB1-TCNuFj5J+T zWx*uw7rvVBh?S-cQw{HmAUcaMx`%>Sa3Em+4W8q06Ji(*p~SEy6{w`+0W~`XsOhWR zPfUje_t;?7hX89d48!!~E2K&Bljj!~M~FV%jKCD(K*P=rS_tcvvZg~p*nI(30odwr zCF?t(!diXQdiM&39)R&HvXn!`v4s-=!=UCZlep}w#%RFf?ES@Bi>cfa9_P zlg9(KJiA^_N@mL;;XB6#IC#NrRF&-&8mZv0T^&30rI<7bLMwuj4{rlvG7Q=EHgLX@?% z0M`Pxpd9&JH4Ucn4lsvlsCB>yIgO2t*YjH<(p)KKlRs5tm<7&9#cu%aL=n)ADtai_ z0NP}EHG%^aGRG?x2<(+q)q~KzeR%k4j8RhK>y3dU)Xo8)?WSe z7Kt|3ku=}I^q;F$V2ED<3z#wJB7iyo3$-jWY)oJvAg3`&qOsZ8-E-;CuFv%uV~Hng zJwPJq4dajq3JU%MfxQ0lcJBs^hkiP|gCO}kK=%N6rToG|)KXr6vXI0d+G7D-t?#}P zv=0KhBw{NFC$0Az9L_LC)0|!1r$2~97+jK%i9?(p2Z==hsL2`NTL53n0OO4ebHrl} zEZ!~w&I%ZV2pIJTro)nKR1wM80-d}GTi{N5sCp{dVDzB&AoQC-3laF=fU_gC>{r89 z92)1;FrWFmJ&JVc(yTv$Sw2HV_}9=P3@%~dwjjw6PeU0^R6cMKubTwkNF=#cm^H|? z=o9sn8=M@X)h*a%du0DYuzV32(^*PnvDqBAw%QJUnt7G-dL7gd!6qMUwF4_ex>G+h z2n$3H6o6d_TP89d&kF!RL`_XioS$3@MGU}}07zp6unvU5llBob1%Oy^Bc*g&y#)Y- zi|=a5R}>Z%VKFA#+Nr?5^!L`zOf^nC{QW@ft!1nKS0aS1JO?2!btAWW2iss=<|CK&Pr_EKbNXSV^u12tuIPECGmYwL9@pk#qaJBIBJ zSQjS%|8rJT{w0#bdj%ad7R=X(j5A8x)b~|*(LEk#Lwq{FjGx2UW*`rlncr=dYG7of1OQZk#)C}d9iz2e)tnU^tHb%mpzrbndY0fQJBtHW(zNy1Lppl_5-`-AW%n(rNrX zFAnH)C0V=@c!Qs%V3cVvr3)+aMA&=R1%Q1P=$1q&=BOL+{{hPd0WH|5H;)(#&_ z=wjHZLI0%Y#=F&hmNgH&ZNl3p-H|LSi(_;!-IBIox;_3S+b58ANeK6f1J4}H(gDpR z_2bE1^EAQa*#w0H9Uh6J61WEL0#hEq#C^-xxqnsadU8auqIv9-PxQS0?AyRbI9X4N z(yPXE%9z6o4=b5Pk5AM7LPUpcpx;tBMpom~3eE_TsEA*WvoLxfdT;|<=)SSj)UUwaLOj@z=f_U#y{J_>3zveCq zlY3!JY4sG-^Rli3qt3-}c%bSZ#+%@2xR}z52rWz%ye_9v;gD;Oki`@?ool4sSROc9 z=T4Vx#q-B;QWgv;{`*kt2}l9lotRweiF2aStM>@j4ofe#917-sSS7U)c+b2@SJi#b z9G-%)_~%xxNWC}=;1)Xc?&s?=vy&Tf%>Lm{W`8eR4ji2&>G_SIU*27wT?gO}*AYYw z9%+N_8FQC>iWx~OWy`h$5ZOpg_%o80e5;yNKsw-Z>SUHXEMFBGwVpsL@xJleNy*o~x1K*F$nKyPE zljEp#_Qep_q`PXqM^lt#55zY=mXd$q%`WN(dsmW%%_2E6-0abbR)|*%o`QvK7W1U) z+#5@x?nd%@7KL2!5doQDCHS+{!tBw%hC8@8lCF3*yue3vf7x;;s%Y~+p2${2n|rV* zwnmesy~L72*hJk5ls#T%MsX~TVRjh)d9S9c>Ng&4D%#oZ z_pn3$7n%&~7CwcC*2~}HmZ7re>4kn_MLf0RUG2%@c@`S~ZN=|Z^p%C{SC0tX9rV`2AU^ zhF1F~z5?_Q3?=%l)SrfB#Y;~N=6{|H{cVas8*Kw840BulA*dEgfMEIVXV77n4{7bixc8Cc}|wNE^zI{QXJ4IQUn{QPWg z`>)e`Fi^d!PLIL{bXPeQiKHZdB{0M-2l^ev?PRenIX0CBVWbzXN`iD>qo$z(mWsIn zrE_*=2_8~$Qf1n!>fHeFd<56IC#Fnuodpp0Y_+m8x`Oyf6Bvmz8X{4<- z%weIzUxv7>%@OZz*uF?nHV7x(H@XSULGRIH#iMjAb!F*|G9eOOkVLP)75Sp_X<6p{ z)TQm}ox@YCP_k$M0S+HTCc5Aqe4nkTsL?GGU+aTc6jdAF^r08hU9IBW#zTnx_G1RG z0F=_LfAmOjO)>v${^?rE=TaFNS1m@iV`fQr*gS*0qk)P-i4BkR_|~o=Rw%@{>;Plu zF!7&es&83G!lPfb4F)%)+DCBwtCqx=hesK_f+mh-E{=@OV~v`>HEsKpWoZp17m=$) z+RwV?3r2gLQzpHtmdVtW-+8N#lt~OZ?Wm8nI|hoLtAdK(T~I{7`-*&Is+MD^Q)iKM zaB#>pS`SF?6^k3#AQt+}HfHIPOuQDSAw2IrBDkpkgAOmL%e2Ck7pd+cDM2M(=t! z4SO_02{(2Vxiu``@g5z!)F({*(fx&RVXMKoEpX;yrscotVb=4FQ;@z$og6d&KxMk@ zs~>xO81T#+epDT=kscBnsQ@bSJ;;Ba&#w%9w`#pP+wfi^+I#Iiz1!weN@Lo7;bym7 zK{Oq=e;qvz4qu=w8wkCNybZ^WDPOx2pRV(1j=p`e`v ztsDi&<&W3K1Ycem9W%}yVc=ibwk*mPE~ zvqZtTyncG45RZz_fWaT;<>lpuI&se7yEJ%pWT0eGu3*qk+;|%0Xx)2R@FF>Vu`~U> zqEBw(NM>T!B(oZ8dC7&SW~E*+`M)nXKTxuee%+3yXc$jYn_D(L@>`VKNk2cNrr)|K zZrZkc*BTjmBlo{rfQBh*1ldSGr}q%sy&xtGR0uUXer5toa4c)&;;riY*6ULaw@@c% zdKLwrs#_0{i^nW-ZjTHD*#?iTx|WufT-7sKfY80aKIyt*h<^{Z+6ZTFB6uT(7(qm{N!*aFyrL~O3iyhk^#XhH`AxEN#9E!aETqOfg#P+Oy&Hdfp z=C9U7p<92GHLV}=_pwcez^MsMUYum7#-6gshUOXkEWS(wyIBGH%}=nFWz7%@*Vt97 zc3t}CTOC%*wmv;fiTl?z5^Q7Zk_s*#)#GmFyFK=<;9t_29ny*+A2p->skWM^jreAu zHsz&+7l!bmd;hKVpwQ8U@Y zmvcfGdN+9&zF3t#bdj;?6>Hx=vJk#H+}zt5`7pA>-t^6WAnRrP7`KBMJr-TnrC~{_ zL#DHEuQFVY6;<|xPawG)?xoOHW>qm~E>i^;Yt1D27R*~SADLc z#tXxlN~JH3^S&kXU9;I5UM`9MxG&f{WGglDAZjZ&_OQMZV=ul-t_sCNYdWCek}E5? zJPtuUxZ;`FvcTbFHygVwEt%_C5*ujhiRf3b37kX;RI{@D_mY3^b2x#Ve~jrfj8m3+ z+1qzh7xpF^MtAQdOL!ThQhJ~*q5{;*I7tjtw;eU>IpHB#cS_yeX|*Qs&)ak!iF~T} zM~FAya9h}vWwh0C6lX%!yiafF(%9ndCTR`QZCIzb`9IgWW$xKo)^u0j%zm@ar+-H* zG!iIhaq7JlrSbN5+TPj}sU2ClIyhg@($2+4)OtyGwu#N>PF|EWU_jAkz51n1?EZ;X_nXinVr-vmhL_IiD+5qCF-^j@m?OEW8-9N5ky!LV=vN=B!3XSQ}GWQCvG6}+$CdM}k%)dzQzG&cN zx|zzz(PVb{<-I3(yU&LDVVO3Hm`19H^!3~RH@1N&ZhAkzWeeyk$z^|f1}PfDHOoN6 zlv2t1204|VGaX*o>v(Zm@#j6Sfwz_GOOy{W<}7G+I(Lg}UrKuO$L-S_%w(^LqlRSEC*0LtT93_?mt zb}?g@@54Q&W}Q|0$}eso8uT;zF`3;}r09p5_<*gFwUYS!L-`Ci-ENa}t8%ZV2o_1&P1Wn5 z=vG=T+n>GpxEyZu`E)HJtq2^6&A4W5X`61Rzhxl=|HAFAwa?CWr?bi>fs{5Oe|#d!UU@dY zx0IVd#jT{v?T4c;wXx|c;PJBPa4p!xI9NVpThITs^~?bzj~6YHhPc!E^UFf9(c1J% zfr*fl=S1bs;h=5rSg-&S8++zI*c72CmGzHnJV$%4DrpMHhS1pAy zH06S+_0*Wwn&4cjispG&rSH`vRPv8Wj9-kM9pm>qg2x&*1vQ&*9ZG4vJ_Umixd!}1 zvdkBPg3l9o5QG8}NSW)Hnf@3Xk~F;erHWH34L|eM*n%GU26e;mbbB;NH>cosX`vM`HhPO%-`3ToFlnbRI&3=6q_Wny9jd{H?-W7*wgp~Mgm zfYjejO8oPBYv0hM?V{N2{_%F^PW^@*2c>^E9zE2K7s=H`&2BsD)6PikD8b@j_b^UA8v;SD|I~0aZk&92f^i$ZMK-#= zya9FQp?7SIVK8o~Sa(mr->A=D?BNN>qE08!RN9C_QCM2Wo=fZI1W9cmj;mAB>-gaF zZlCx^W+v`!O@Uh$up%L~3Vq)2Q@jS7t!~gdJv0k>5eM~cod5Yu_1P@zlt*jbk{J}PTbiOe39vz_bQbE?Z(Zm)_+{!9!xT&$YG zpD;>|{o`+~WKxN*#v3aJrY5L+XYB>aZcfZM?X7HFn$_K0wAvxV)RT+vEj<`*HF2g z3F3-iXw5HnHg$E~+4g@Arq$m&XU{QAXmHw9taWW{<&0B>dJ2fmN*j!&`*BUOS=e(W z=B)kJ#s<8KUH%LdMy?SPSs6$C6*cw<%6ng*h4dl2UU_;nP|f z^(->0okDA#zqcIx%0(LI;y*O5-FbKe6#F1kUgey|LxpS3Yta+O~6z7!8!v=+BTd_8KKhOZJxN-X?pM1*nhom94VgY60Y z{l+g_1dmwyc*SIe8C05Hvr02(MYGm~E6%oE-_eQy&U~YQ?^V4u!l7B*L4NSmFGG`Z zUSBmP4yN|JZ+T#EuRusr{pZ2wzIEfRmsJJqH3zY@HY&8)ezpF{pwAL6V^#4#%iZre zTM40jBmMG`GEypgZ>l_}s)~E`qZ{r5I63ZDe2;@Nds{c2bU=xxt2gtOro%<~t3&>& zCZ#yPfSc~Eit@J<%rzE>8Acqt&QPkliGt0)CPn<)XPcGG#wz918ceK&5YG1us42tz z;#oK!5mPTbV|(u2Gom%O1QnqpXpbd!H_*&YW+tTGCjFz1Zzgb(lac&V-~5PJ%I2~p zgviZ(9bP?Ui6ODjiei=Nne6vBV&F63N8#*`gt}W5UP;hlYGMD7KSKKNY)QHFjR^A= z78eyk!bazP=a=RhSB%KW$jRv`gX`m$*iW#-R6SM%NPx;$dC#+nW>7B%a!<3&!~1cT zmOm?S2N8CV4Rh?0NjlP=a!(QvleoEZE!G@coXFhsI-S4&HhTIqqNiEQYG-RpKH0Z; zWaOr=9#vV2;Lu*uNyMbGtnA*n>u%>PTJqmH#(ig6~ZUX3#tQPYU%DW2U;Q{eMSALCf>!Y;B2~ zA{=Oi7!VZY4W*B4zDmJxOI;X!V*Wt}S&ZPgOEr<=<)Uosp&^z0;dBsn_HPW54p9ws z3%^;VeRMP`t^Y4!!PUnxCDVrVz5g2riK*LPiC$*Hak8C5<*NT&KTV{yBOeSq2;1o9 z4Jf{|_fiz}c=O`*zy7l2bU|7;ZZo)|ZMV586iuz><&EJaZ8lAn_Wd&2d@Id>_b>IE zQ_#h{ny#D5J;>w0An>rv6)+6}#|dXcPlOSV0IR>U z9Dx0Cb1(%IJ}i3fvBUD9pg`ozf%CD!d5g=uKOv6(PaqCJf&Ty|GbRpw2#A<13^o-~ z=>$x|aJSjncDXz;!SNz$;VW;)H$dKZqniv=<1V-rfJ{6I_s6f-oIR$TJ~snKPJsMA z{`YSeNCH9t(j1+TZ5dX~0WxQRf&Zx|^hW?Jivq5IixwoCt>rdh1k%EQD&IzeyLPE{ z5Nub1%E(9o$-*6tf1XZgs@wNmccFYm+M1yQY~ilK=lZM)zIRuRhzx)p}_IsV!8_0qx}Gxb6g>0OiawqwNJ1z2|{*V zg6mX3G5s%Vq^BqS)#;2?kR#5S#Y0@g0oxaW5hE*zJ#nJsGj-Jrx>d_UxipmL&70GU za^LUZ=cjE9Bs<^k6r4?}DS?s>!U)dsjp_--HSpIBwTxSW5s|xnzb#P6v6bN~0;}AC zWzE&{ni(cSE{J4iqxG4qwrf1a~@=Dq)c zitOZ!GePJh9ipLZ7T*zh{W~dj>Otj4ef5DU>gw@1TBb)@_c^_19g<)>j4gbQ1Iyug z0P?)Rc4ol!-*TTCISuK;K#)G?1j#8wkU69=ng%gKPmipJ+!;fIgk*L6_kE^$=Bo2# z+Go#sYzKS|v_h5I33n;%{m9*R?eapwd8KlY&w?KXvjM0wp4f>RB4kc)?vc5cKFi9r z7bPI(HQqH4IF8L`MGDXp4n$jzao2Vfls>qHnz|5pdr zUENwUs0J7VG=9*<-0OR!WMo$M_M2cXlv{`3T83jYToY2_E20%tmg2@l=x#@q*cN<< z6(w?|!}Bf&g*YOovC+r9FQZ{jBF;S&ZjQjj;X#l69OhvIGavva7j^44B4;Thqobq0 z9Y7^k(MMt$Jc;MdW9h0tqCA6{svXD=QLsj3Z6?V7S z!fBvZ#19xiBs%izk5T>-l7kgTJw9HwodJ7_3XnF%@_Z~RE?Z?ax9BTj=Mfq7VA32sx1TvkMX088o>Yf~wPC0}0=-B-HTRPb)yENc@V*CN^^0O#tOV%Q!GxtxE**Kb@RcvH5L2q&eP%0W` z7Z2hANgU(`!ZT=B>j3j+3SC1sj3*MLZC=0`yjC(u&e(G}(>!}{V{r%A`L8aLjBxzr z%g5un2~4HG4sb__G*W{MP!hBO^{5 z*ctO@l-H6AtU*N>M(di^qC$WBzYkw#2KyFiidfi`j%9`?BFWAiXz&1-JciN9c$;jN z5RF;IcCcTpakgw}qN*Yzg@xbZt7(lq;AZy~qk_#w8E0%D&XMJYMSkLU3{s+HvBo8J zK$>y!n9K@+45~HSp2()sG#XpoDz^B0sIYg?*yLxhD1)iqb#bfUh7yV<$qKbmL<%k?Wt__1&xO`#w}mhLj(=d=Ny zdw9b5D}gJwa_D*6)Q|_6wVIbhs?dp8gd3B~j)M3JN1UpDo1Lt$vB&2puZ0m8m9ncN z)riUj=;d%?M%>z~&P=BhAB#_;QlFN#S{M!M0(|YErv!3CTBGg{)9VlSsvpojm6R3Q zvq)(?%JUNNPNQFj9`AC%>Fhc;k9cg^{Df49(YMQ$x*fSD=!WFI>sHP28R8N=>=hz^7T5EFdAoH`bF6G73dM z6?XT%B6@yqFJFF&rHb>ocjZ&(J8{!C;QRgX-u*?WP}}0PNBM+88oH`%z7>*Tu`jo0 zk2%Oldr|QiJyNDF+FbdB*v)lK*H5eNdIfyDSiBQWs8J42Im&oaMb3Sq=E!Rfz|!UT zZv9i9`pUEUZ1;c zBBwlv6|}mYC2eZBKG$L>;m257clAM3$A-d%}}+EYU`tgp4s|LWT0 z*+wFR89 za2vhy>RB#L-(RX0!`;vF{CNGM%{M0rk}0<7G5Y1x81#u$Hl_d3Yfbue?yUIcg`~1( zWW>9Bn-Pb{yBFV{xaD}YPZu*(F~30xR0{(}Bkr5Ad_-rj?)vVRC~~)(uSTNHTD->Z zJm9e~5KyXl5_tDtq?@Gb%IGld3yoG2vk2QTH7zam{PC@7$=D0p^2uAaM<`F()UwSZ zcvm>|HUVGM5@T^&ZFKYEmHJcgrElx>Jf@&Y%SS`zTn#iDq!d1}VY@awEG~lUbKv<6PXs~{-!o=jXaQI>|H9J{^k zrbR5`01*i~n4TFwbYw&VH-q($%_qt@20H)4gPY)>`>2DNH{@|bVEYHgi<+~SoKMV@ zxr6sI&695tQ?h v201NbK&@(l_D<*q^BChCqg0&G)=fo2 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