Cuando el sistema detecta una red adecuada, se conecta a la red e invoca la devolución de llamada {@link android.net.ConnectivityManager.NetworkCallback#onAvailable(android.net.Network) onAvailable()}. Puedes usar el objeto {@link android.net.Network} de la devolución de llamada para obtener información adicional acerca de la red o para indicar que el tráfico use la red seleccionada.
Bluetooth de baja energía
-
Android 4.3 introdujo compatibilidad de plataforma para Bluetooth de baja energía (Bluetooth LE) en el rol central. En Android 5.0, un dispositivo Android ahora puede actuar como un dispositivo periférico Bluetooth LE. Las aplicaciones pueden utilizar esta capacidad para que otros dispositivos cercanos detecten su presencia. Por ejemplo, puedes crear aplicaciones que permiten que un dispositivo funcione como un podómetro o un monitor de estado, y comunique sus datos a otro dispositivo Bluetooth LE.
+
Android 4.3 introdujo compatibilidad de plataforma para Bluetooth de baja energía (Bluetooth LE) en el rol central. En Android 5.0, un dispositivo Android ahora puede actuar como un dispositivo periférico Bluetooth LE. Las aplicaciones pueden utilizar esta capacidad para que otros dispositivos cercanos detecten su presencia. Por ejemplo, puedes crear aplicaciones que permiten que un dispositivo funcione como un podómetro o un monitor de estado, y comunique sus datos a otro dispositivo Bluetooth LE.
Las nuevas API {@link android.bluetooth.le} permiten a sus aplicaciones transmitir anuncios, buscar respuestas y establecer conexiones con dispositivos Bluetooth LE cercanos. Para utilizar las nuevas funciones de anuncio y búsqueda, agrega el permiso {@link android.Manifest.permission#BLUETOOTH_ADMIN BLUETOOTH_ADMIN} en el manifiesto. Cuando los usuarios actualizan o descargan tu aplicación desde Play Store, se les pide que concedan el siguiente permiso a tu aplicación: "Información de conexión Bluetooth: Permite que la aplicación controle Bluetooth, incluida la transmisión de información a dispositivos Bluetooth cercanos o la obtención de información sobre ellos".
Para comenzar el anuncio de Bluetooth LE a fin de que otros dispositivos puedan detectar tu aplicación, llama a {@link android.bluetooth.le.BluetoothLeAdvertiser#startAdvertising(android.bluetooth.le.AdvertiseSettings, android.bluetooth.le.AdvertiseData, android.bluetooth.le.AdvertiseCallback) startAdvertising()} y envía una implementación de la clase {@link android.bluetooth.le.AdvertiseCallback}. El objeto de devolución de llamada recibe un informe del éxito o fracaso de la operación de anuncio.
diff --git a/docs/html-intl/intl/es/design/patterns/navigation.jd b/docs/html-intl/intl/es/design/patterns/navigation.jd
index e7d73fd72fc2a..4b0523973d06d 100644
--- a/docs/html-intl/intl/es/design/patterns/navigation.jd
+++ b/docs/html-intl/intl/es/design/patterns/navigation.jd
@@ -137,7 +137,7 @@ evento. En la pantalla de detalles del evento, es posible navegar con los botone
Notificaciones emergentes
-
Las notificaciones emergentes omiten el panel lateral de notificaciones y aparecen directamente
+
Las notificaciones emergentes omiten el panel lateral de notificaciones y aparecen directamente
frente al usuario. Estas casi nunca se utilizan, y se deben reservar para ocasiones en las que es necesario proporcionar una
respuesta oportuna y es necesario realizar una interrupción en el contexto del usuario. Por ejemplo,
en Talk se utiliza este estilo para alertar al usuario sobre una invitación de un amigo para participar en una videocharla, ya que esta
diff --git a/docs/html-intl/intl/es/design/patterns/notifications.jd b/docs/html-intl/intl/es/design/patterns/notifications.jd
index bdbc77b71f467..5499e8b3d4e1c 100644
--- a/docs/html-intl/intl/es/design/patterns/notifications.jd
+++ b/docs/html-intl/intl/es/design/patterns/notifications.jd
@@ -56,7 +56,7 @@ Android, esta se omitirá
Nota: El diseño de las notificaciones de esta versión de
-Android se diferencia
+Android se diferencia
de manera significativa del diseño de las versiones anteriores. Para obtener información sobre el diseño de las notificaciones en versiones
anteriores, consulte Notificaciones en Android 4.4 y versiones anteriores.
@@ -189,7 +189,7 @@ que aparece en la parte superior de una
a los usuarios
durante un período breve, con un diseño expandido que expone las posibles acciones.
Luego de este período, la notificación se retira hacia el
-panel de notificaciones. Si la prioridad de una notificación
+panel de notificaciones. Si la prioridad de una notificación
se marca como Alta, Máxima o Pantalla completa, se obtiene una notificación emergente.
Buenos ejemplos de notificaciones emergentes
@@ -291,8 +291,8 @@ Las notificaciones de alta prioridad activan la pantalla de notificaciones emerg
Utilícelo para las notificaciones que desea que el usuario reciba, pero
que son menos urgentes. Las notificaciones de baja prioridad tienden a aparecer en la parte inferior de la lista,
por lo que son ideales para
-eventos como actualizaciones sociales públicas o indirectas: El usuario solicitó que se le notifiquen
-estas
+eventos como actualizaciones sociales públicas o indirectas: El usuario solicitó que se le notifiquen
+estas
actualizaciones, pero estas notificaciones nunca tendrán prioridad sobre las comunicaciones
urgentes o directas.
@@ -571,7 +571,7 @@ deben ser una imagen sobre un fondo blanco o transparente.
Pulsación adecuada del
LED de notificaciones
-
Muchos dispositivos con Android incluyen un LED de notificaciones, que se utiliza para mantener al
+
Muchos dispositivos con Android incluyen un LED de notificaciones, que se utiliza para mantener al
usuario informado sobre los
eventos cuando la pantalla está apagada. Las notificaciones con un nivel de prioridad MAX,
HIGH o DEFAULT deben
@@ -701,7 +701,7 @@ comentarios sobre tareas más extensas, como descargar un archivo o codificar un
eliminar las notificaciones constantes del panel lateral de notificaciones.
Reproducción de medios
-
En Android 5.0, la pantalla de bloqueo no muestra los controles de transporte para la clase
+
En Android 5.0, la pantalla de bloqueo no muestra los controles de transporte para la clase
{@link android.media.RemoteControlClient} obsoleta. Sin embargo, sí muestra las notificaciones, de modo que las notificaciones de reproducción de cada
aplicación ahora son la forma principal
en la que los usuarios controlan la reproducción desde el estado bloqueado. A través de este comportamiento, se le otorga más control
@@ -771,7 +771,7 @@ para cualquier persona que agarre el dispositivo y encienda la pantalla.
En el caso de los dispositivos que posean una pantalla de bloqueo segura (PIN, patrón o contraseña), la interface está formada por
partes públicas y privadas. La interfaz pública se puede mostrar en una pantalla de bloqueo segura y,
- por ende, cualquier persona puede verla. La interfaz privada es el mundo detrás de esa pantalla de bloqueo y
+ por ende, cualquier persona puede verla. La interfaz privada es el mundo detrás de esa pantalla de bloqueo y
solo se revela cuando el usuario se registra en el dispositivo.
@@ -799,7 +799,7 @@ Se muestra todo el contenido de la notificación.
Esta es la opción predeterminada del sistema si no se especificó el grado de visibilidad.
VISIBILITY_PRIVATE.
-En la pantalla de bloqueo se muestra la información básica sobre la existencia de esta notificación, incluido
+En la pantalla de bloqueo se muestra la información básica sobre la existencia de esta notificación, incluido
el icono y el nombre de la aplicación a través de la cual se publicó. No se muestra el resto de los detalles de la notificación.
A continuación, especificamos algunos puntos que se deben tener en cuenta:
diff --git a/docs/html-intl/intl/es/distribute/googleplay/auto.jd b/docs/html-intl/intl/es/distribute/googleplay/auto.jd
index a2a29434e8e07..d9928b5ab8436 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/auto.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/auto.jd
@@ -158,7 +158,7 @@ page.metaDescription=Distribuye tus aplicaciones y contenido para Android Auto.
- Ten en cuenta que la revisión afecta la disponibilidad de tu aplicación para otros dispositivos en la
+ Ten en cuenta que la revisión afecta la disponibilidad de tu aplicación para otros dispositivos en la
Play Store de Google; por ejemplo, para teléfonos y tablets.
Si tienes una aplicación actual que incluya actualizaciones para el componente de teléfono/tablet,
el componente de Android Auto debe pasar la revisión antes de que la aplicación actualizada
diff --git a/docs/html-intl/intl/es/distribute/googleplay/developer-console.jd b/docs/html-intl/intl/es/distribute/googleplay/developer-console.jd
index fcf5e44d1b545..73cd63ea37009 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/developer-console.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/developer-console.jd
@@ -4,8 +4,8 @@ page.image=/distribute/images/developer-console.jpg
Xnonavpage=true
@jd:body
-
-
+
+
Características de la publicación
@@ -303,7 +303,7 @@ Xnonavpage=true
En la mayoría de los casos, todo lo que necesitas es un solo paquete de aplicaciones (APK), y generalmente es la manera
más sencilla de administrar y mantener la aplicación. Sin embargo, si necesitas
- proporcionar un APK distinto para diferentes dispositivos, Google Play te
+ proporcionar un APK distinto para diferentes dispositivos, Google Play te
permite hacerlo.
diff --git a/docs/html-intl/intl/es/distribute/googleplay/families/faq.jd b/docs/html-intl/intl/es/distribute/googleplay/families/faq.jd
index ecad47ca20fe0..44da2258d3f6a 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/families/faq.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/families/faq.jd
@@ -10,7 +10,7 @@ page.metaDescription=Preguntas y respuestas acerca de Diseñado para familias
font-weight:bold;
}
-
+
En este documento:
@@ -141,7 +141,7 @@ page.metaDescription=Preguntas y respuestas acerca de Diseñado para familias
confirmar que es apta para familias. Suponiendo que tu aplicación cumple con todos los requisitos
del programa, prevemos que el tiempo de publicación no debería prolongarse
más allá de lo habitual; no obstante, puede haber una demora en la publicación de la aplicación si se
- rechaza durante la revisión para la inclusión en Diseñado para familias.
+ rechaza durante la revisión para la inclusión en Diseñado para familias.
diff --git a/docs/html-intl/intl/es/distribute/googleplay/families/start.jd b/docs/html-intl/intl/es/distribute/googleplay/families/start.jd
index 3ed1eb39a9ae9..d6d6126b2d98c 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/families/start.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/families/start.jd
@@ -78,7 +78,7 @@ page.metaDescription=Únete a Diseñado para familias en pocos pasos sencillos.
Nota: Las aplicaciones publicadas en el programa Diseñado para familias
- también están disponibles para todos los usuarios en Google Play.
+ también están disponibles para todos los usuarios en Google Play.
diff --git a/docs/html-intl/intl/es/distribute/googleplay/quality/auto.jd b/docs/html-intl/intl/es/distribute/googleplay/quality/auto.jd
index c7cb65dc40665..2b1f40382c696 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/quality/auto.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/quality/auto.jd
@@ -477,7 +477,7 @@ data-sortorder="-timestamp" data-cardsizes="9x3" data-maxresults="6">
No. Cuando Google inicie el proceso de aprobación, tu aplicación para Auto se someterá a una revisión de
seguridad del conductor y no estará
disponible para distribución hasta que se apruebe. Dado que es el mismo APK que el
- que utilizas para teléfonos y tablets, tus actualizaciones en la Play Store para esos dispositivos no estará disponible hasta que
+ que utilizas para teléfonos y tablets, tus actualizaciones en la Play Store para esos dispositivos no estará disponible hasta que
finalice el proceso de aprobación para Auto.
El primer paso en la provisión de una excelente experiencia con la aplicación en tablets es asegurarte
de que la aplicación cumpla con los criterios de calidad de la aplicación principal en todos los dispositivos
- y formatos a los que apunte. Para obtener información completa, consulta las Pautas de calidad de la aplicación principal.
+ y formatos a los que apunte. Para obtener información completa, consulta las Pautas de calidad de la aplicación principal.
@@ -119,7 +119,7 @@ style="font-weight:500;">Despídete de tu IU "estirada": En las tablets,
@@ -208,7 +208,7 @@ android.app.Fragment}. Esto te permite
maximizar la reutilización de códigos entre diferentes factores y pantallas que
compartan contenido.
Decide en qué tamaños de pantalla usarás una IU multipanel y luego proporciona los
- diferentes diseños en los depósitos para el tamaño de pantalla correspondiente (como
+ diferentes diseños en los depósitos para el tamaño de pantalla correspondiente (como
large/xlarge) o anchos mínimos de pantalla (como
sw600dp/sw720).
@@ -492,7 +492,7 @@ o simplemente centrando el icono dentro del botón transparente.
En forma similar, revisa el manifiesto para detectar elementos <permission> que
+
En forma similar, revisa el manifiesto para detectar elementos <permission> que
impliquen requisitos
de características de hardware que no sean adecuadas para tablets. Si encuentras esos
permisos, asegúrate de declarar explícitamente un elemento
@@ -735,7 +735,7 @@ o simplemente centrando el icono dentro del botón transparente.
distribución.
Si la página de Sugerencias para la optimización indica problemas "Pendientes" que crees que no
- corresponden a tu aplicación o afectan la calidad de la aplicación en las tablets,
+ corresponden a tu aplicación o afectan la calidad de la aplicación en las tablets,
usa el Formulario de contacto de Diseñado para tablets» para comunicárnoslo. Revisaremos
tu aplicación y actualizaremos tu página de Sugerencias para la optimización
según corresponda.
diff --git a/docs/html-intl/intl/es/distribute/googleplay/tv.jd b/docs/html-intl/intl/es/distribute/googleplay/tv.jd
index e3a95bc2929db..e9deacbcfb6f9 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/tv.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/tv.jd
@@ -132,7 +132,7 @@ page.metaDescription=Distribuye tus aplicaciones, juegos y contenido para Androi
Cumple las pautas de Calidad de la aplicación principal
@@ -261,7 +261,7 @@ page.metaDescription=Distribuye tus aplicaciones, juegos y contenido para Androi
los criterios, recibirás una notificación por correo electrónico enviada a tu cuenta
de desarrollador con un resumen de las áreas que debes abordar. Una vez que realices
los ajustes necesarios, puedes cargar una nueva versión de tu aplicación a la Consola para
- desarrolladores.
+ desarrolladores.
@@ -282,7 +282,7 @@ page.metaDescription=Distribuye tus aplicaciones, juegos y contenido para Androi
Aprobada: se revisó tu aplicación y se aprobó. La aplicación
- estará disponible de forma directa para los usuarios de Android TV.
+ estará disponible de forma directa para los usuarios de Android TV.
diff --git a/docs/html-intl/intl/es/distribute/googleplay/wear.jd b/docs/html-intl/intl/es/distribute/googleplay/wear.jd
index f23315d86495f..2c8a804e90d5b 100644
--- a/docs/html-intl/intl/es/distribute/googleplay/wear.jd
+++ b/docs/html-intl/intl/es/distribute/googleplay/wear.jd
@@ -127,7 +127,7 @@ Una vez que hayas leído las pautas, el paso siguientes es desarrollar tu aplica
Cumple las pautas de Calidad de la aplicación principal.
@@ -152,7 +152,7 @@ desarrollo de aplicaciones para Wear.
Una vez que hayas creado tu APK listo para el lanzamiento y lo hayas probado para asegurarte de que cumple todos los criterios de Calidad de las aplicaciones para Wear, cárgalo
a la Consola para desarrolladores. Actualiza el directorio de tu tienda con capturas de pantalla de tu aplicación para Wear y configura opciones
- de distribución, según sea necesario. Si no sabes cómo prepararte para el lanzamiento en Google Play, consulta la
+ de distribución, según sea necesario. Si no sabes cómo prepararte para el lanzamiento en Google Play, consulta la
Lista de comprobación para el lanzamiento.
"Dispositivos compatibles" indica que tus aplicaciones están llegando a los dispositivos
- a los que pretendías llegar. De lo contrario, deberás verificar con tu equipo de desarrollo
+ a los que pretendías llegar. De lo contrario, deberás verificar con tu equipo de desarrollo
los requisitos y las reglas de filtrado de las aplicaciones.
diff --git a/docs/html-intl/intl/es/distribute/tools/localization-checklist.jd b/docs/html-intl/intl/es/distribute/tools/localization-checklist.jd
index 7cb3ccb54b39c..c06849013fa7c 100644
--- a/docs/html-intl/intl/es/distribute/tools/localization-checklist.jd
+++ b/docs/html-intl/intl/es/distribute/tools/localization-checklist.jd
@@ -903,7 +903,7 @@ data-maxresults="6">
Responde las reseñas, si fuera posible. Te recomendamos que interactúes
con los usuarios internacionales en sus idiomas o en un idioma común, si fuera posible.
Si no lo es, puedes intentar utilizar herramientas de traducción, aunque es posible que no puedas
- prever los resultados. Si tu aplicación se vuelve muy popular en un idioma, considera
+ prever los resultados. Si tu aplicación se vuelve muy popular en un idioma, considera
la posibilidad de obtener ayuda por parte de hablantes nativos para brindar soporte.
diff --git a/docs/html-intl/intl/es/google/play/filters.jd b/docs/html-intl/intl/es/google/play/filters.jd
index 03565b9b175d1..07238ee327510 100644
--- a/docs/html-intl/intl/es/google/play/filters.jd
+++ b/docs/html-intl/intl/es/google/play/filters.jd
@@ -81,7 +81,7 @@ Por ejemplo, si una aplicación requiere una cámara, Google Play no mostrará l
solicite específicamente la aplicación al hacer clic en un vínculo profundo que apunte directamente a la
ID de la aplicación en Google Play.
-
Puedes usar cualquier combinación de los filtros disponibles para tu aplicación. Por ejemplo, puedes establecer un requisito
+
Puedes usar cualquier combinación de los filtros disponibles para tu aplicación. Por ejemplo, puedes establecer un requisito
minSdkVersion de "4" y configurar smallScreens="false"
en la aplicación; luego, al cargar la aplicación a Google Play, podrías apuntar a países (operadores) europeos
únicamente. De este modo, los filtros de Google Play evitarán que la aplicación esté disponible en un dispositivo
@@ -102,7 +102,7 @@ Play
, pueden ver todas las aplicaciones publicadas. No obstante, el sitio we
Filtrado en función del manifiesto de la aplicación
-
La mayoría de los filtros son activados por elementos del archivo de manifiesto de una
+
La mayoría de los filtros son activados por elementos del archivo de manifiesto de una
aplicación, AndroidManifest.xml
(aunque no todo lo que se encuentra en el archivo de manifiesto puede desencadenar el filtrado).
La tabla 1 contiene los elementos del manifiesto que debes usar para desencadenar el
diff --git a/docs/html-intl/intl/es/preview/api-overview.jd b/docs/html-intl/intl/es/preview/api-overview.jd
index f84bede97a706..7cee010dc5a71 100644
--- a/docs/html-intl/intl/es/preview/api-overview.jd
+++ b/docs/html-intl/intl/es/preview/api-overview.jd
@@ -62,7 +62,7 @@ las nuevas funciones para desarrolladores.
Compatibilidad con ventanas múltiples
-
En Android N, presentamos una nueva y muy solicitada función multitarea
+
En Android N, presentamos una nueva y muy solicitada función multitarea
en la plataforma: la compatibilidad con ventanas múltiples.
Los usuarios ahora pueden abrir dos aplicaciones al mismo tiempo en la pantalla.
@@ -815,7 +815,7 @@ externo. Cuando se usan las nuevas API, el sistema emplea una IU de
permisos simple en la que se detallan claramente los directorios a los cuales
la aplicación solicita acceso.
-
Para obtener más información, consulta la documentación
+
@@ -846,7 +846,7 @@ de aplicaciones que crean aplicaciones de alto rendimiento y ejecución prolonga
-Android N incluye compatibilidad opcional para un
+Android N incluye compatibilidad opcional para un
modo de rendimiento sostenido, que permite que los fabricantes de equipo original (OEM) arrojen datos sobre las capacidades de rendimiento del dispositivo
para las aplicaciones de ejecución prolongada. Los desarrolladores
de aplicaciones pueden usar estos datos para perfeccionar sus aplicaciones y alcanzar un nivel
@@ -854,7 +854,7 @@ uniforme y predecible de rendimiento en el dispositivo durante períodos prolong
-Los desarrolladores de aplicaciones solo pueden probar esta API nueva en la N Developer Preview instalada solo en dispositivos con
+Los desarrolladores de aplicaciones solo pueden probar esta API nueva en la N Developer Preview instalada solo en dispositivos con
Nexus 6P. Para usar esta función,
establece el indicador de rendimiento sostenido de la ventana
que deseas ejecutar en el modo de rendimiento sostenido. Establece este indicador con el método
@@ -888,7 +888,7 @@ consulta Google VR SDK para
-
Puedes establecer un ícono desde el id. de un recurso llamando a
+
Puedes establecer un ícono desde el id. de un recurso llamando a
PrinterInfo.Builder.setResourceIconId().
diff --git a/docs/html-intl/intl/es/preview/behavior-changes.jd b/docs/html-intl/intl/es/preview/behavior-changes.jd
index 5eb4966b8c347..112c1c985b1a7 100644
--- a/docs/html-intl/intl/es/preview/behavior-changes.jd
+++ b/docs/html-intl/intl/es/preview/behavior-changes.jd
@@ -88,7 +88,7 @@ determinadas intents implícitas.
determinado, se activa en este el modo Descanso y se aplica el primer subconjunto de restricciones: se
desactiva el acceso de las aplicaciones a la red y se aplazan tareas y sincronizaciones. Si el dispositivo
permanece quieto durante un tiempo determinado tras activarse el modo Descanso, el sistema aplica el
- resto de las restricciones del modo a {@link android.os.PowerManager.WakeLock},
+ resto de las restricciones del modo a {@link android.os.PowerManager.WakeLock},
alarmas de {@link android.app.AlarmManager}, GPS y análisis de Wi-Fi. Independientemente de que
se apliquen algunas o todas las restricciones del modo Descanso, el sistema activa el
dispositivo durante plazos de mantenimiento breves en los cuales las aplicaciones tienen
@@ -199,7 +199,7 @@ determinadas intents implícitas.
Los propietarios ya no pueden reducir los permisos de archivo de los archivos privados,
y un intento de hacerlo utilizando
{@link android.content.Context#MODE_WORLD_READABLE} o
- {@link android.content.Context#MODE_WORLD_WRITEABLE} activará una
+ {@link android.content.Context#MODE_WORLD_WRITEABLE} activará una
{@link java.lang.SecurityException}.
Nota: Desde ahora, esta restricción no se aplica planamente.
@@ -211,7 +211,7 @@ determinadas intents implícitas.
Pasar URI file:// fuera del dominio del paquete puede dar al
receptor una ruta de acceso inaccesible. Por lo tanto, los intentos de pasar un
- URI file:// activan una
+ URI file:// activan una
FileUriExposedException. La manera recomendada para compartir el
contenido de un archivo privado consiste en utilizar el {@link
android.support.v4.content.FileProvider}.
@@ -221,8 +221,8 @@ determinadas intents implícitas.
almacenados de manera privada por nombre de archivo. Las aplicaciones heredadas pueden terminar con una
ruta de acceso inaccesible cuando acceden a {@link
android.app.DownloadManager#COLUMN_LOCAL_FILENAME}. Las aplicaciones orientadas a
- Android N o versiones posteriores activan una {@link java.lang.SecurityException} cuando
- intentan acceder a
+ Android N o versiones posteriores activan una {@link java.lang.SecurityException} cuando
+ intentan acceder a
{@link android.app.DownloadManager#COLUMN_LOCAL_FILENAME}.
Las aplicaciones heredadas que establecen la ubicación de descarga en una ubicación pública
usando
@@ -573,7 +573,7 @@ Muchas API de la plataforma han comenzado a controlar en busca del envío de car
a través de transacciones {@link android.os.Binder}. Además, el
sistema ahora vuelve a emitir {@code TransactionTooLargeExceptions}
como {@code RuntimeExceptions}, en lugar de registrarlas o suprimirlas silenciosamente. Un
-ejemplo común es almacenar demasiados datos en
+ejemplo común es almacenar demasiados datos en
{@link android.app.Activity#onSaveInstanceState Activity.onSaveInstanceState()},
lo que hace que {@code ActivityThread.StopInfo} emita una
{@code RuntimeException} cuando la aplicación se orienta a Android N.
@@ -585,7 +585,7 @@ la {@link android.view.View}
no está anexada a una ventana, el sistema
pone en cola la tarea {@link java.lang.Runnable} con la {@link android.view.View}.
La tarea {@link java.lang.Runnable} no se ejecuta hasta que la
-{@link android.view.View} esté anexada
+{@link android.view.View} esté anexada
a una ventana. Este comportamiento soluciona los siguientes errores:
Si una aplicación publicaba una {@link android.view.View} desde un subproceso que no fuera el subproceso de la IU
@@ -600,7 +600,7 @@ a una ventana. Este comportamiento soluciona los siguientes errores:
Si una aplicación en Android N con el permiso
{@link android.Manifest.permission#DELETE_PACKAGES DELETE_PACKAGES}
intentaba borrar un paquete instalado por otra aplicación,
-el sistema solicitaba la confirmación del usuario. En este escenario, las aplicaciones debían esperar recibir el estado
+el sistema solicitaba la confirmación del usuario. En este escenario, las aplicaciones debían esperar recibir el estado
{@link android.content.pm.PackageInstaller#STATUS_PENDING_USER_ACTION STATUS_PENDING_USER_ACTION}
al invocar
{@link android.content.pm.PackageInstaller#uninstall PackageInstaller.uninstall()}.
diff --git a/docs/html-intl/intl/es/preview/features/afw.jd b/docs/html-intl/intl/es/preview/features/afw.jd
index 32e57c83a3d5b..5e550a6d597c8 100644
--- a/docs/html-intl/intl/es/preview/features/afw.jd
+++ b/docs/html-intl/intl/es/preview/features/afw.jd
@@ -35,7 +35,7 @@ page.keywords="android for work", "android N", "enterprise", "QR code"
Los lanzadores deben aplicar una IU distintiva para las aplicaciones suspendidas a fin de mostrar que las
aplicaciones no están actualmente disponibles; por ejemplo, el ícono de la aplicación puede aparecer en color
- gris. Los lanzadores pueden averiguar si una aplicación está suspendida llamando al nuevo método
+ gris. Los lanzadores pueden averiguar si una aplicación está suspendida llamando al nuevo método
DevicePolicyManager.getPackageSuspended().
@@ -181,9 +181,9 @@ Android N.
- Los propietarios pueden requerir el uso de una VPN llamando al nuevo método
+ Los propietarios pueden requerir el uso de una VPN llamando al nuevo método
DevicePolicyManager.setAlwaysOnVpnPackage(). Para averiguar
- si el propietario ha establecido un requisito de VPN, llama al nuevo método
+ si el propietario ha establecido un requisito de VPN, llama al nuevo método
DevicePolicyManager.GetAlwaysOnVpnPackage().
@@ -255,7 +255,7 @@ Android N.
Los propietarios pueden reiniciar sus dispositivos de forma remota. En algunos casos, no se puede acceder al botón de encendido de los dispositivos implementados en
lugares públicos dentro de recintos. Si se debe
- reiniciar un dispositivo, los administradores pueden hacerlo utilizando el nuevo método
+ reiniciar un dispositivo, los administradores pueden hacerlo utilizando el nuevo método
DevicePolicyManager.reboot().
@@ -271,7 +271,7 @@ Android N.
Los propietarios de dispositivos pueden identificar actividades sospechosas mediante un rastreo remoto de la actividad del
dispositivo, incluidos inicios de aplicaciones, actividad adb y desbloqueos de pantalla. Los registros de
- procesos no requieren del consentimiento del usuario. Para recuperar registros, los propietarios de dispositivos habilitan
+ procesos no requieren del consentimiento del usuario. Para recuperar registros, los propietarios de dispositivos habilitan
los registros de dispositivos mediante DevicePolicyManager.setSecurityLoggingEnabled().
@@ -402,10 +402,10 @@ Android N.
El propietario del dispositivo o perfil puede habilitar otra aplicación para que administre las restricciones de
- aplicaciones mediante el nuevo método
+ aplicaciones mediante el nuevo método
DevicePolicyManager.setApplicationRestrictionsManagingPackage()
. La aplicación nominada puede controlar si se otorgó este permiso
- llamando a
+ llamando a
DevicePolicyManager.isCallerApplicationRestrictionsManagingPackage().
@@ -461,8 +461,8 @@ Android N.
Los propietarios de perfiles y dispositivos pueden configurar múltiples certificados de CA para una configuración
de Wi-Fi determinada. Cuando las redes de Wi-Fi corporativas tienen CA independientes para
- diferentes puntos de acceso con el mismo SSID, los administradores de TI pueden incluir todas las
- CA relevantes en la configuración Wi-Fi utilizando el nuevo método
+ diferentes puntos de acceso con el mismo SSID, los administradores de TI pueden incluir todas las
+ CA relevantes en la configuración Wi-Fi utilizando el nuevo método
setCaCertificates().
@@ -511,7 +511,7 @@ Android N.
- El teléfono debe controlar el nuevo marcador
+ El teléfono debe controlar el nuevo marcador
android.telecom.Call.PROPERTY_WORK_CALL para determinar si una llamada es
de tipo laboral. Si se trata de una llamada laboral, el teléfono debe indicarlo
, por ejemplo, mediante el agregado de una insignia de trabajo.
@@ -524,7 +524,7 @@ Android N.
usuario modifique el fondo de pantalla. Los propietarios de dispositivos o perfiles aún pueden
modificar el fondo de pantalla. Sin embargo, solo pueden hacerlo para el
usuario o perfil que controlan. Por ejemplo, el propietario de un perfil no puede modificar el
- fondo de pantalla del usuario primario,
+ fondo de pantalla del usuario primario,
pero sí pueden hacerlo el propietario de un dispositivo o el propietario de un perfil en el perfil principal. El propietario de un dispositivo o perfil que desea modificar el
fondo de pantalla debe controlar si el usuario o perfil que administra posee un
fondo de pantalla ({@link android.app.WallpaperManager#isWallpaperSupported
@@ -544,7 +544,7 @@ Android N.
Control del estado del dispositivo
- El propietario de un perfil o dispositivo puede usar la nueva interfaz
+ El propietario de un perfil o dispositivo puede usar la nueva interfaz
HardwarePropertiesManager para recuperar información
sobre el estado del dispositivo, como por ejemplo, las temperaturas de CPU o GPU y el uso de la CPU. La nueva interfaz
de control es especialmente útil para controlar dispositivos sin supervisión
diff --git a/docs/html-intl/intl/es/preview/features/background-optimization.jd b/docs/html-intl/intl/es/preview/features/background-optimization.jd
index fbae9b503fe6b..c061a093bb297 100644
--- a/docs/html-intl/intl/es/preview/features/background-optimization.jd
+++ b/docs/html-intl/intl/es/preview/features/background-optimization.jd
@@ -274,7 +274,7 @@ public static void scheduleJob(Context context) {
Cuando el sistema informa un cambio en el(los) URI de contenido especificado(s), tu aplicación
- recibe un callback y se pasa un objeto {@link android.app.job.JobParameters}
+ recibe un callback y se pasa un objeto {@link android.app.job.JobParameters}
al método {@link android.app.job.JobService#onStartJob onStartJob()}
en {@code MediaContentJob.class}.
diff --git a/docs/html-intl/intl/es/preview/features/direct-boot.jd b/docs/html-intl/intl/es/preview/features/direct-boot.jd
index a9cfcf099692c..e1d99e9d2b0ef 100644
--- a/docs/html-intl/intl/es/preview/features/direct-boot.jd
+++ b/docs/html-intl/intl/es/preview/features/direct-boot.jd
@@ -58,7 +58,7 @@ el almacenamiento encriptado por credencial.
Debes registrar los componentes de las aplicaciones con el sistema antes de que estas puedan
ejecutarse durante el modo de inicio directo o acceder al almacenamiento encriptado por
dispositivo. Para registrar una aplicación en el sistema, debes marcar los componentes como
-"con reconocimiento de encriptación". Para marcar tu dispositivo como "con reconocimiento de encriptación", configura el atributo
+"con reconocimiento de encriptación". Para marcar tu dispositivo como "con reconocimiento de encriptación", configura el atributo
android:directBootAware como verdadero en el manifiesto.
Los componentes con reconocimiento de encriptación pueden registrarse para recibir un mensaje de transmisión
diff --git a/docs/html-intl/intl/es/preview/features/multi-window.jd b/docs/html-intl/intl/es/preview/features/multi-window.jd
index 89bc3194c577c..441e06af361a3 100644
--- a/docs/html-intl/intl/es/preview/features/multi-window.jd
+++ b/docs/html-intl/intl/es/preview/features/multi-window.jd
@@ -158,7 +158,7 @@ page.keywords="multi-window", "android N", "split screen", "free-form"
si quieres que las actividades de tu aplicación admitan la visualización de ventanas múltiples. Puedes establecer
atributos en tu manifiesto para controlar el tamaño y el diseño.
La configuración de atributos de una actividad raíz se aplica a todas las actividades
- de su pila de tareas. Por ejemplo, si
+ de su pila de tareas. Por ejemplo, si
android:resizeableActivity está configurado en true para la actividad raíz, se puede modificar el tamaño de todas las actividades
de la pila de tareas.
Ya sea que actualices o no tu aplicación para Android N, debes
- verificar la forma en que se comporta en modo de ventanas múltiples en caso de que un usuario intente iniciarla
+ verificar la forma en que se comporta en modo de ventanas múltiples en caso de que un usuario intente iniciarla
en modo de ventanas múltiples en un dispositivo con Android N.
Cambia el tamaño de tu aplicación en modo de pantalla dividida al arrastrar la línea divisoria.
- Verifica que la aplicación cambie de tamaño sin fallar y que estén visibles los elementos
+ Verifica que la aplicación cambie de tamaño sin fallar y que estén visibles los elementos
necesarios de la IU.
- En el caso de las aplicaciones interactivas, como los chats, podría ser útil incluir
+ En el caso de las aplicaciones interactivas, como los chats, podría ser útil incluir
contexto adicional cuando se administra texto recuperado. Por ejemplo, en estas aplicaciones, se podrían mostrar
múltiples líneas de historial de chat. Cuando el usuario responde a través de {@link
android.support.v4.app.RemoteInput}, puedes actualizar el historial de respuestas
diff --git a/docs/html-intl/intl/es/preview/features/picture-in-picture.jd b/docs/html-intl/intl/es/preview/features/picture-in-picture.jd
index 0d9313aae1fef..36c0c5771912b 100644
--- a/docs/html-intl/intl/es/preview/features/picture-in-picture.jd
+++ b/docs/html-intl/intl/es/preview/features/picture-in-picture.jd
@@ -181,7 +181,7 @@ video en la actividad de reproducción actual en modo de pantalla completa, en l
iniciar una nueva actividad que podría confundir al usuario.
A fin de garantizar que se utilice una única actividad para las solicitudes de reproducción de video y que esta
- ingrese en el modo PIP o salga de este cuando sea necesario, configura el
+ ingrese en el modo PIP o salga de este cuando sea necesario, configura el
android:launchMode de la actividad en singleTask, en el manifiesto:
@@ -209,5 +209,5 @@ esquina de la pantalla, debes evitar mostrar información importante en la panta
en cualquier área que pueda quedar oculta detrás de la ventana de PIP.
Cuando una actividad se encuentra en modo PIP, de forma predeterminada, no tiene focalización en las entradas. Para
-recibir eventos de entradas durante este modo, usa
+recibir eventos de entradas durante este modo, usa
MediaSession.setMediaButtonReceiver().
StorageVolume correcta. Luego, crea una intent llamando al
método StorageVolume.createAccessIntent() de esa instancia.
Usa esta intención para acceder a directorios de almacenamiento externo. Para obtener una lista de
-todos los volúmenes disponibles, incluidos los volúmenes de medios extraíbles, usa
+todos los volúmenes disponibles, incluidos los volúmenes de medios extraíbles, usa
StorageManager.getVolumesList().
-
Si tienes información sobre un archivo específico, usa
-StorageManager.getStorageVolume(File) para obtener el
-StorageVolume que contiene el archivo. Llama a
-createAccessIntent() en este StorageVolume para acceder al
+
Si tienes información sobre un archivo específico, usa
+StorageManager.getStorageVolume(File) para obtener el
+StorageVolume que contiene el archivo. Llama a
+createAccessIntent() en este StorageVolume para acceder al
directorio de almacenamiento externo del archivo.
-En el caso de los volúmenes secundarios, como las tarjetas SD externas, pasa un valor nulo cuando llames a
+En el caso de los volúmenes secundarios, como las tarjetas SD externas, pasa un valor nulo cuando llames a
StorageVolume.createAccessIntent() para solicitar acceso al volumen
completo, en lugar de un directorio específico.
StorageVolume.createAccessIntent() regresa un valor nulo si pasas un
@@ -140,7 +140,7 @@ de usuario. Si el usuario deniega una solicitud y la aplicación solicita acceso
-
Figura 1. Una aplicación que presenta una
+
Figura 1. Una aplicación que presenta una
segunda solicitud para obtener acceso a medios extraíbles.
Si el usuario selecciona Don't ask again y deniega la solicitud, todas las
diff --git a/docs/html-intl/intl/es/preview/features/security-config.jd b/docs/html-intl/intl/es/preview/features/security-config.jd
index 39d95c8fb31ea..8c3db641c5773 100644
--- a/docs/html-intl/intl/es/preview/features/security-config.jd
+++ b/docs/html-intl/intl/es/preview/features/security-config.jd
@@ -171,7 +171,7 @@ page.image=images/cards/card-nyc_2x.jpg
Agrega las CA de confianza, en formato PEM o DER, a {@code res/raw/trusted_roots}.
Ten en cuenta que, si usas el formato PEM, el archivo debe incluir solo datos PEM
- y ningún texto adicional. También puedes brindar elementos
+ y ningún texto adicional. También puedes brindar elementos
<certificates>
múltiples en lugar de solo uno.
@@ -338,7 +338,7 @@ base-config}, si no están anidados. Los valores no establecidos en la {@code ba
example.com} deben usar un conjunto personalizado de CA. Además, el tráfico de Cleartext a
estos dominios se permite excepto con las conexiones a {@code
secure.example.com}. Anidando la configuración para {@code
-secure.example.com} dentro de la configuración para {@code example.com},
+secure.example.com} dentro de la configuración para {@code example.com},
{@code trust-anchors} no necesita duplicación.
diff --git a/docs/html-intl/intl/es/preview/features/tv-recording-api.jd b/docs/html-intl/intl/es/preview/features/tv-recording-api.jd
index 58379753cb4d2..855db8d5fffe9 100644
--- a/docs/html-intl/intl/es/preview/features/tv-recording-api.jd
+++ b/docs/html-intl/intl/es/preview/features/tv-recording-api.jd
@@ -33,13 +33,13 @@ durante la grabación y gestionar las sesiones grabadas.
Nota: La aplicación Live Channels todavía no
permite que los usuarios creen grabaciones ni accedan a estas. Hasta que se realicen
- cambios en la aplicación Live Channels, es posible que sea difícil probar completamente la
+ cambios en la aplicación Live Channels, es posible que sea difícil probar completamente la
experiencia de grabación para tu servicio de entrada de TV.
Indicar la compatibilidad para la grabación
-
Para comunicarle al sistema que tu servicio de entrada de TV permite la grabación, configura el
-atributo android:canRecord de tu archivo XML de metadatos de servicio
+
Para comunicarle al sistema que tu servicio de entrada de TV permite la grabación, configura el
+atributo android:canRecord de tu archivo XML de metadatos de servicio
en true:
@@ -49,7 +49,7 @@ en true:
android:setupActivity="com.example.sampletvinput.SampleTvInputSetupActivity" />
-
Para obtener más información sobre el archivo de metadatos de servicio, consulta
+
@@ -123,7 +123,7 @@ las aplicaciones de canal con funcionalidad de grabación en la tabla de proveed
RecordedPrograms.Uri. Usa API de proveedor de contenido para
leer, agregar y borrar entradas de esta tabla.
-
Para obtener más información sobre cómo trabajar con datos del proveedor de contenido, consulta
+
Android N te brinda la oportunidad de garantizar que tus aplicaciones funcionen con la próxima versión de la plataforma.
- Esta versión preliminar incluye diversas API y cambios en los comportamientos que pueden
+ Esta versión preliminar incluye diversas API y cambios en los comportamientos que pueden
tener impactos en tu aplicación, como se describe en las secciones Información general de la API y Cambios en los comportamientos.
Al probar tu aplicación con la versión preliminar, te debes centrar en algunos cambios específicos del sistema para garantizar que los usuarios disfruten de una buena experiencia.
diff --git a/docs/html-intl/intl/es/preview/overview.jd b/docs/html-intl/intl/es/preview/overview.jd
index 279a53649bd06..dc42175c5ba6a 100644
--- a/docs/html-intl/intl/es/preview/overview.jd
+++ b/docs/html-intl/intl/es/preview/overview.jd
@@ -321,7 +321,7 @@ page.tags="preview", "developer", "android"
comportamientos se indican áreas clave que debes probar.
Documentación de nuevas API, entre la que se incluye Información general de API, una Referencia
de API descargable
- y guías exhaustivas para desarrolladores que muestran, por ejemplo, soporte
+ y guías exhaustivas para desarrolladores que muestran, por ejemplo, soporte
de múltiples ventanas, notificaciones integradas, soporte de múltiples configuraciones regionales y mucho más.
Ejemplo de código, en el que se
demuestra la manera de admitir permisos y otras funciones nuevas.
diff --git a/docs/html-intl/intl/es/preview/setup-sdk.jd b/docs/html-intl/intl/es/preview/setup-sdk.jd
index 2f8c4fa6e2515..51260bb68f8b1 100644
--- a/docs/html-intl/intl/es/preview/setup-sdk.jd
+++ b/docs/html-intl/intl/es/preview/setup-sdk.jd
@@ -92,7 +92,7 @@ Android N Preview SDK en Android Studio de la siguiente manera:
n-preview-3-docs.zip
Developer Preview 3 está disponible en todos los dispositivos
compatibles: Nexus 5X, Nexus 6, Nexus 6P, Nexus 9, Nexus Player, Pixel
- C, General Mobile 4G (Android One) y Sony Xperia Z3 (modelos D6603 y
+ C, General Mobile 4G (Android One) y Sony Xperia Z3 (modelos D6603 y
D6653).
- Desde la versión 51 de Android N, WebView ejecutará contenido web en
+ Desde la versión 51 de Android N, WebView ejecutará contenido web en
procesos individuales de espacio aislado cuando se haya habilitado
la opción "Multiprocess WebView". El equipo de WebView espera recibir comentarios sobre compatibilidad y
rendimiento de tiempo de ejecución en N antes de habilitar Multiprocess WebView en
@@ -154,7 +154,7 @@ page.image=images/cards/card-n-support_2x.png
que permite que una aplicación monitoree su rendimiento de representación de IU mediante la exposición de una
transmisión de API Pub/Sub para transferir información sobre el intervalo de los fotogramas para la ventana actual
de la aplicación. Puedes usar FrameMetricsListener para medir
- el rendimiento de la IU del nivel de interacción en producción con una granularidad mayor y
+ el rendimiento de la IU del nivel de interacción en producción con una granularidad mayor y
sin la necesidad de contar con conexión USB.
Ahora, el sistema utiliza metadatos de la actividad para definir el modo de mosaico.
(Antes, el valor de devolución de
- TileService.onTileAdded() determinaba el modo de mosaico). Para obtener más información, consulta
+ TileService.onTileAdded() determinaba el modo de mosaico). Para obtener más información, consulta
TileService.META_DATA_ACTIVE_TILE en la Referencia de la API descargable.
@@ -686,9 +686,9 @@ seguimiento de problemas.
OEM unlock
-
En algunos dispositivos, Enable OEM unlock aparecerá inhabilitado en
+
En algunos dispositivos, Enable OEM unlock aparecerá inhabilitado en
"Developer Options" al ejecutar DP2.
- Método alternativo: Apúntate para
+ Método alternativo: Apúntate para
el Programa Android Beta (si aún no lo has hecho) en
www.google.com/android/beta. Luego, date de baja y acepta el
paso a una versión anterior (OTA). Darse de baja hará que el dispositivo pase a la versión Android 6.0. Ahora deberías
@@ -764,7 +764,7 @@ seguimiento de problemas.
En la muestra multithreadCmdBuffer, {@code vkCmdClearColorImage()} falla cuando
se ejecuta con el controlador N-DP2.
Los valores de devolución de {@code vkGetPhysicalDeviceFormatProperties()} no configuran un valor
- para {@code VkFormatProperties::linearTilingFeatures} que, como resultado,
+ para {@code VkFormatProperties::linearTilingFeatures} que, como resultado,
toma el valor de 0.
Los anexos del búfer de fotogramas de punto flotante de Vulkan no se manejan de forma correcta.
@@ -892,7 +892,7 @@ seguimiento de problemas.
Teléfono
-
La aplicación Teléfono no es compatible con el inicio directo. Este tema se abordará más adelante en
+
La aplicación Teléfono no es compatible con el inicio directo. Este tema se abordará más adelante en
N Developer Preview.
@@ -1021,7 +1021,7 @@ seguimiento de problemas.
El primer registro en un perfil de trabajo tarda varios minutos en
- completarse. Esto puede hacer que el dispositivo tarde más de lo normal en volverse
+ completarse. Esto puede hacer que el dispositivo tarde más de lo normal en volverse
visible en la API Play EMM.
diff --git a/docs/html-intl/intl/es/training/monitoring-device-state/battery-monitoring.jd b/docs/html-intl/intl/es/training/monitoring-device-state/battery-monitoring.jd
index 08a42dd1f7f45..cfccdab0f6281 100644
--- a/docs/html-intl/intl/es/training/monitoring-device-state/battery-monitoring.jd
+++ b/docs/html-intl/intl/es/training/monitoring-device-state/battery-monitoring.jd
@@ -7,8 +7,8 @@ next.title=Cómo determinar y controlar el tipo de conector y el estado de la co
next.link=docking-monitoring.html
@jd:body
-
-
Al modificar la frecuencia de las actualizaciones en segundo plano para reducir el efecto de las mismas en la duración de la batería, te recomendamos que comiences por comprobar el estado de carga y el nivel actual de la batería.
El impacto derivado de actualizar aplicaciones en la duración de la batería varía en función del nivel de batería y del estado de carga del dispositivo, mientras que es insignificante cuando este está conectado a la corriente. Por ello, en la mayoría de los casos, puedes maximizar la frecuencia de actualización cuando el dispositivo esté conectado a un cargador. Por el contrario, si el dispositivo está en proceso de descarga, disminuir la frecuencia de actualización te permitirá aumentar la duración de la batería.
Del mismo modo, puedes comprobar el nivel de carga de la batería y reducir la frecuencia de las actualizaciones o incluso detenerlas cuando la batería esté a punto de agotarse.
-
Cómo determinar el estado de carga actual
-
+
Cómo determinar el estado de carga actual
+
En primer lugar, te recomendamos que determines el estado de carga actual. {@link android.os.BatteryManager} envía los detalles de carga y de la batería en un {@link android.content.Intent} persistente que incluye el estado de carga.
Se trata de un intento persistente, por lo que no es necesario registrar un {@link android.content.BroadcastReceiver}. Para ello, solo tienes que ejecutar {@code registerReceiver} transmitiendo {@code null} como el receptor (como se muestra en el siguiente fragmento). A continuación, se devuelve el intento de estado actual de la batería. Puedes transmitir un objeto {@link android.content.BroadcastReceiver} real, pero hablaremos sobre las actualizaciones en otra sección, por lo que no es necesario ahora.
Normalmente, debes maximizar la frecuencia de las actualizaciones en segundo plano si el dispositivo está conectado a un cargador de corriente alterna, disminuir esa frecuencia si se utiliza un cargador USB y reducirla aún más si la batería se está descargando.
-
Cómo supervisar los cambios en el estado de carga
+
Cómo supervisar los cambios en el estado de carga
Modificar el estado de carga es tan fácil como conectar el dispositivo a un enchufe o USB. Por ello, es importante que supervises el estado de carga por si se producen cambios y modifiques la frecuencia de actualización según corresponda.
public class PowerConnectionReceiver extends BroadcastReceiver {
@Override
- public void onReceive(Context context, Intent intent) {
+ public void onReceive(Context context, Intent intent) {
int status = intent.getIntExtra(BatteryManager.EXTRA_STATUS, -1);
boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING ||
status == BatteryManager.BATTERY_STATUS_FULL;
-
+
int chargePlug = intent.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1);
boolean usbCharge = chargePlug == BATTERY_PLUGGED_USB;
boolean acCharge = chargePlug == BATTERY_PLUGGED_AC;
@@ -87,7 +87,7 @@ boolean acCharge = chargePlug == BATTERY_PLUGGED_AC;
}
-
Cómo determinar el nivel de batería actual
+
Cómo determinar el nivel de batería actual
En algunos casos, también es útil determinar el nivel de batería actual. Puedes disminuir la frecuencia de las actualizaciones en segundo plano si el nivel de carga de la batería es inferior a un valor determinado.
Algunos de los usos más comunes para las alarmas con repetición y los servicios en segundo plano es programar actualizaciones regulares de los datos de aplicaciones a partir de recursos de Internet, almacenar datos en la memoria caché o ejecutar descargas a largo plazo. Sin embargo, si no estás conectado a Internet o la conexión es demasiado débil para completar la descarga, ¿para qué activar el dispositivo y programar la actualización?
Puedes utilizar {@link android.net.ConnectivityManager} para comprobar si estás conectado a Internet y, en ese caso, el tipo de conexión que estás utilizando.
-
Cómo determinar si tienes conexión a Internet
-
+
Cómo determinar si tienes conexión a Internet
+
No es necesario programar una actualización basada en un recurso de Internet si no estás conectado. En el fragmento que aparece a continuación, se muestra cómo utilizar {@link android.net.ConnectivityManager} para consultar la red activa y determinar si hay conexión a Internet.
Cuando hayas inhabilitado las actualizaciones, es importante que detectes si se hay cambios en la conectividad para poder reanudarlas cuando se haya establecido una conexión a Internet.
-
Cómo supervisar los cambios en la conectividad
+
Cómo supervisar los cambios en la conectividad
{@link android.net.ConnectivityManager} emite la acción {@link android.net.ConnectivityManager#CONNECTIVITY_ACTION} ({@code "android.net.conn.CONNECTIVITY_CHANGE"}) cuando se han modificado los detalles de la conectividad. Puedes registrar un receptor de emisión en el archivo de manifiesto para detectar estos cambios y reanudar (o cancelar) las actualizaciones en segundo plano según corresponda.
Los dispositivos Android se pueden conectar a distintos tipos de conectores. Por ejemplo, se puede utilizar conectores para coche o domésticos y tanto digitales como analógicos. Normalmente, el estado del conector está vinculado al estado de carga, ya que muchos conectores cargan el dispositivo mientras está conectado.
El estado del conector se emite también como un {@link android.content.Intent} persistente, lo que te permite consultar si el dispositivo está conectado o no y, si lo está, determinar el tipo de conector.
-
Cómo determinar el estado de conexión actual
-
+
Cómo determinar el estado de conexión actual
+
La información sobre el estado del conector se incluye como información adicional en una emisión persistente de la acción {@link android.content.Intent#ACTION_DOCK_EVENT}. Por ello, no es necesario registrar un {@link android.content.BroadcastReceiver}. Solo tienes que ejecutar {@link android.content.Context#registerReceiver registerReceiver()} transmitiendo {@code null} como el receptor de emisión, como se muestra en el fragmento de código que aparece a continuación.
Ten en cuenta que las últimas dos opciones se introdujeron en Android únicamente en el nivel 11 del API. Por ello, te recomendamos que compruebes las tres opciones solo cuando te interese más el tipo de conector que si se trata de un conector digital o analógico:
Cómo supervisar los cambios en el tipo de conector o en el estado del mismo
+
Cómo supervisar los cambios en el tipo de conector o en el estado del mismo
Cuando el dispositivo está conectado a un conector o desconectado del mismo, se emite la acción {@link android.content.Intent#ACTION_DOCK_EVENT}. Para controlar los cambios que se produzcan en el estado del conector del dispositivo, solo tienes que registrar un receptor de emisión en el archivo de manifiesto de la aplicación, como se muestra en el fragmento que aparece a continuación:
Uno de los objetivos de tu aplicación debe ser limitar su impacto en la duración de la batería del dispositivo en el que esté instalada. Después de leer estas secciones, podrás desarrollar aplicaciones que optimizarán el uso de la batería en función del estado del dispositivo en el que estén instaladas.
Al tomar medidas como inhabilitar las actualizaciones de servicios en segundo plano o disminuir la frecuencia de dichas actualizaciones cuando el nivel de batería sea bajo, puedes garantizar que se minimice el impacto de tu aplicación en la duración de la batería sin afectar a la experiencia del usuario.
Obtén más información sobre cómo determinar y controlar el nivel de batería actual y los cambios en el estado de carga para modificar la frecuencia de actualizaciones en segundo plano de tu aplicación.
@@ -46,4 +46,4 @@ will want to jump to a lesson or not.-->
Los receptores de emisión que declaras en el archivo de manifiesto se pueden alternar durante la ejecución para inhabilitar los que no son necesarios debido al estado actual del dispositivo. Obtén más información sobre cómo alternar y superponer receptores de cambio de estado para mejorar el rendimiento y cómo posponer acciones hasta que el dispositivo se encuentre en un estado concreto.
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/es/training/monitoring-device-state/manifest-receivers.jd b/docs/html-intl/intl/es/training/monitoring-device-state/manifest-receivers.jd
index a90468e373365..0be198cb48d74 100644
--- a/docs/html-intl/intl/es/training/monitoring-device-state/manifest-receivers.jd
+++ b/docs/html-intl/intl/es/training/monitoring-device-state/manifest-receivers.jd
@@ -9,7 +9,7 @@ previous.link=connectivity-monitoring.html
@jd:body
-
La forma más sencilla de controlar los cambios en el estado del dispositivo es crear un {@link android.content.BroadcastReceiver} para cada estado que vayas a controlar y registrar cada uno de ellos en el archivo de manifiesto de tu aplicación. A continuación, en cada uno de esos receptores solo tienes que volver a programar las alarmas recurrentes en función del estado actual del dispositivo.
Un efecto secundario de este método es que tu aplicación activará el dispositivo siempre que uno de los receptores se active (probablemente, con más frecuencia de la necesaria).
Te recomendamos que inhabilites o habilites los receptores de emisión en el momento de la ejecución. De este modo, puedes utilizar los receptores que hayas declarado en el archivo de manifiesto como alarmas pasivas que se activan mediante los eventos del sistema solo cuando es necesario.
-
-
Cómo alternar y superponer receptores de cambio de estado para mejorar el rendimiento
-
+
+
Cómo alternar y superponer receptores de cambio de estado para mejorar el rendimiento
+
Se puede utilizar el {@link android.content.pm.PackageManager} para alternar el estado habilitado en cualquier componente definido en el archivo de manifiesto, incluidos los receptores de emisión que quieras habilitar o inhabilitar, como se muestra en el fragmento que aparece a continuación:
En función del diseño actual de tu aplicación, la interfaz puede variar. Por ejemplo, si tu aplicación está en modo de panel dual, haz clic en un elemento del panel izquierdo para que aparezca en el panel de la derecha. Asimismo, si está en modo de panel único, el contenido debería aparecer por sí mismo (en otra actividad).
@@ -56,7 +56,7 @@ public class NewsReaderActivity extends FragmentActivity {
setContentView(R.layout.main_layout);
View articleView = findViewById(R.id.article);
- mIsDualPane = articleView != null &&
+ mIsDualPane = articleView != null &&
articleView.getVisibility() == View.VISIBLE;
}
}
@@ -116,7 +116,7 @@ public void onCreate(Bundle savedInstanceState) {
else {
/* use list navigation (spinner) */
actionBar.setNavigationMode(android.app.ActionBar.NAVIGATION_MODE_LIST);
- SpinnerAdapter adap = new ArrayAdapter(this,
+ SpinnerAdapter adap = new ArrayAdapter(this,
R.layout.headline_item, CATEGORIES);
actionBar.setListNavigationCallbacks(adap, handler);
}
@@ -168,7 +168,7 @@ public class HeadlinesFragment extends ListFragment {
public class HeadlinesFragment extends ListFragment {
...
@Override
- public void onItemClick(AdapterView<?> parent,
+ public void onItemClick(AdapterView<?> parent,
View view, int position, long id) {
if (null != mHeadlineSelectedListener) {
mHeadlineSelectedListener.onHeadlineSelected(position);
diff --git a/docs/html-intl/intl/es/training/multiscreen/index.jd b/docs/html-intl/intl/es/training/multiscreen/index.jd
index d836f962cc708..b9b591631becd 100644
--- a/docs/html-intl/intl/es/training/multiscreen/index.jd
+++ b/docs/html-intl/intl/es/training/multiscreen/index.jd
@@ -6,10 +6,10 @@ next.link=screensizes.html
@jd:body
-
-
-
-
Dependencias y requisitos previos
+
+
+
+
Dependencias y requisitos previos
Android 1.6 o superior (Android 2.1 o superior para la aplicación de ejemplo)
@@ -26,17 +26,17 @@ href="{@docRoot}tools/support-library/index.html">biblioteca de compatibilidad
Android se utiliza en cientos de dispositivos con diferentes tamaños de pantalla, desde pequeños teléfonos hasta enormes televisores. Por ello, es importante que diseñes tu aplicación para que sea compatible con todos los tamaños de pantalla y esté disponible para el mayor número de usuarios posible.
Sin embargo, no es suficiente con que tu aplicación sea compatible con diferentes dispositivos. Cada tamaño de pantalla ofrece diferentes posibilidades y retos para la interacción del usuario. Por ello, para satisfacer completamente a tus usuarios e impresionarlos, tu aplicación debe ir más allá de simplemente admitir varias pantallas: debe optimizar la experiencia de usuario para cada configuración de pantalla.
@@ -47,17 +47,17 @@ href="{@docRoot}tools/support-library/index.html">biblioteca de compatibilidadNota: en esta sección y en el ejemplo correspondiente, se utiliza la biblioteca de compatibilidad para poder usar las API de {@link android.app.Fragment} en versiones anteriores a Android 3.0. Debes descargar y la biblioteca y añadirla a tu aplicación para poder utilizar todas las API que se indican en esta sección.
-
-
En esta sección se explica cómo crear diseños que se adapten a diferentes tamaños de pantalla (mediante dimensiones flexibles para vistas, {@link android.widget.RelativeLayout}, calificadores de orientación y tamaño de pantalla, filtros de alias y mapas de bits de la clase NinePatch).
En esta sección se explica cómo admitir pantallas con diferentes densidades de píxeles (mediante píxeles independientes de la densidad y mapas de bits adecuados a cada densidad).
En esta sección se explica cómo implementar tu interfaz de usuario para que se adapte a varias combinaciones de densidad o de tamaño de pantalla (detección de tiempo de ejecución del diseño activo, cómo reaccionar en función del diseño actual y cómo administrar los cambios en la configuración de la pantalla).
En esta sección se explica cómo crear diseños que se adapten a diferentes tamaños de pantalla (mediante dimensiones flexibles para vistas, {@link android.widget.RelativeLayout}, calificadores de orientación y tamaño de pantalla, filtros de alias y mapas de bits de la clase NinePatch).
En esta sección se explica cómo admitir pantallas con diferentes densidades de píxeles (mediante píxeles independientes de la densidad y mapas de bits adecuados a cada densidad).
En esta sección se explica cómo implementar tu interfaz de usuario para que se adapte a varias combinaciones de densidad o de tamaño de pantalla (detección de tiempo de ejecución del diseño activo, cómo reaccionar en función del diseño actual y cómo administrar los cambios en la configuración de la pantalla).
En esta sección se explica cómo proporcionar diferentes recursos y utilizar unidades de medida de resolución independiente para admitir diferentes densidades de pantalla.
@@ -48,8 +48,8 @@ next.link=adaptui.html
Por ejemplo, al especificar un espacio entre dos vistas, debes utilizar dp en lugar de px:
En esta sección se explica cómo admitir varios tamaños de pantalla. Para ello, sigue estos pasos:
-
-
Asegúrate de que el diseño se haya ajustado correctamente al tamaño de la pantalla.
-
Configura la pantalla con el diseño de interfaz adecuado.
+
+
Asegúrate de que el diseño se haya ajustado correctamente al tamaño de la pantalla.
+
Configura la pantalla con el diseño de interfaz adecuado.
Asegúrate de aplicar el diseño adecuado a la pantalla correspondiente.
-
Utiliza el mapa de bits con la escala adecuada.
-
+
Utiliza el mapa de bits con la escala adecuada.
+
-
Cómo utilizar los valores "wrap_content" y "match_parent"
+
Cómo utilizar los valores "wrap_content" y "match_parent"
Para garantizar que el diseño es flexible y que se adapta a varios tamaños de pantalla, debes utilizar los valores "wrap_content" y "match_parent" para la altura y el ancho de algunos componentes de la vista. Si utilizas "wrap_content", el ancho o la altura de la vista se establece en el tamaño mínimo necesario para adaptar el contenido a esta vista, mientras que "match_parent" (también conocido como "fill_parent" antes del nivel 8 del API) provoca que el componente se amplíe hasta coincidir con el tamaño de la vista principal.
@@ -65,7 +65,7 @@ next.link=screendensities.html
Figura 1. La aplicación de ejemplo News Reader en modo vertical (izquierda) y horizontal (derecha)
-
Cómo utilizar RelativeLayout
+
Cómo utilizar RelativeLayout
Puedes crear diseños de un cierto nivel de complejidad con instancias anidadas de {@link android.widget.LinearLayout} y combinaciones de los valores de tamaño "wrap_content" y "match_parent". Sin embargo, {@link android.widget.LinearLayout} no te permite controlar con precisión las relaciones espaciales de las vistas secundarias; las vistas de {@link android.widget.LinearLayout} simplemente se alinean en paralelo. Si quieres orientar las vistas secundarias de una forma que no sea una línea recta, a menudo la mejor solución es utilizar {@link android.widget.RelativeLayout}que te permite especificar el diseño según las relaciones espaciales entre los componentes. Por ejemplo, puedes alinear una vista secundaria en el lateral izquierdo y otra vista en el lateral derecho de la pantalla.
Ten en cuenta que aunque el tamaño de los componentes es diferente, las relaciones espaciales se mantienen según se ha especificado con {@link android.widget.RelativeLayout.LayoutParams}.
-
-
Cómo utilizar calificadores de tamaño
+
+
Cómo utilizar calificadores de tamaño
Hay mucha diferencia entre un diseño flexible y un diseño relativo como el que se ha utilizado en las secciones anteriores. Aunque ambos diseños se adaptan a diferentes pantalla estirando el espacio dentro de los componentes y alrededor de los mismos, puede que no ofrezcan la mejor experiencia de usuario para cada tamaño de pantalla. Por tanto, tu aplicación no solo debe implementar los diseños flexibles, sino que también debe ofrecer varios diseños alternativos para diferentes configuraciones de pantalla. Para ello, se utilizan calificadores de configuración, que permiten que el tiempo de ejecución seleccione el recurso adecuado en función de la configuración actual del dispositivo (por ejemplo, un diseño diferente para diferentes tamaños de pantalla).
No obstante, esto no funcionará en los dispositivos anteriores a Android 3.2 porque no reconocen sw600dp como calificador de tamaño, por lo que también tendrás que seguir utilizando el calificador large. Por tanto, debes tener un archivo con el nombre res/layout-large/main.xml idéntico a res/layout-sw600dp/main.xml. En la siguiente sección, obtendrás información sobre una técnica que te permite evitar que se dupliquen los archivos de diseños.
-
Cómo utilizar alias de diseño
+
Cómo utilizar alias de diseño
El calificador de ancho mínimo solo está disponible en Android 3.2 o superior. Por tanto, tendrás que seguir utilizando los contenedores de tamaño abstractos (pequeño, normal, grande y extragrande) para que sean compatibles con versiones anteriores. Por ejemplo, si quieres que tu interfaz de usuario sea de panel único en teléfonos pero multipanel en tablets de 7", televisiones y otros dispositivos grandes, tendrás que utilizar los siguientes archivos:
@@ -202,7 +202,7 @@ next.link=screendensities.html
{@code large}y las televisiones y los tablets posteriores a la versión 3.2 utilizarán sw600dp).
-
Cómo utilizar calificadores de orientación
+
Cómo utilizar calificadores de orientación
Aunque algunos diseños se pueden utilizar tanto en modo horizontal como vertical, la mayoría de ellos pueden beneficiarse de los ajustes. A continuación, se indica cómo se comporta el diseño según cada tamaño y orientación de la pantalla en la aplicación de ejemplo News Reader:
diff --git a/docs/html-intl/intl/in/design/get-started/principles.jd b/docs/html-intl/intl/in/design/get-started/principles.jd
index 9aed08e289d66..2a1d194b0616c 100644
--- a/docs/html-intl/intl/in/design/get-started/principles.jd
+++ b/docs/html-intl/intl/in/design/get-started/principles.jd
@@ -277,7 +277,7 @@ meskipun hanya sesuatu yang sederhana.
Lakukan pekerjaan yang sulit untuk saya
-
Buatlah pemula merasa seperti ahli dengan memungkinkan mereka untuk melakukan hal-hal yang mereka pikir tidak akan bisa.
+
Buatlah pemula merasa seperti ahli dengan memungkinkan mereka untuk melakukan hal-hal yang mereka pikir tidak akan bisa.
Misalnya, pintasan yang menggabungkan beberapa efek foto dapat membuat foto amatir terlihat mengagumkan hanya
dalam beberapa langkah.
diff --git a/docs/html-intl/intl/in/design/patterns/navigation.jd b/docs/html-intl/intl/in/design/patterns/navigation.jd
index a8afaaa794e09..491570030b539 100644
--- a/docs/html-intl/intl/in/design/patterns/navigation.jd
+++ b/docs/html-intl/intl/in/design/patterns/navigation.jd
@@ -121,7 +121,7 @@ pemberitahuan tunggal yang mengarahkan pengguna ke layar antara. Layar ini meran
kejadian tersebut, dan menyediakan path bagi pengguna untuk menjelajah ke dalam aplikasi. Pemberitahuan dengan gaya seperti ini
disebut pemberitahuan tidak langsung.
-
Berbeda dengan pemberitahuan standar (langsung), menekan tombol Back dari
+
Berbeda dengan pemberitahuan standar (langsung), menekan tombol Back dari
layar antara pada pemberitahuan tidak langsung akan mengembalikan pengguna ke titik pemicu pemberitahuan tersebut—tidak ada
layar tambahan yang disisipkan ke dalam back-stack. Setelah pengguna melanjutkan ke dalam aplikasi dari
layar antara, tombol Up dan Back akan berperilaku seperti pada pemberitahuan standar, sebagaimana dijelaskan di atas:
@@ -168,7 +168,7 @@ yang akan dibahas di bawah ini.
informasi dan semua tindakan terkait yang dapat dilakukan pengguna. Aplikasi Anda adalah kumpulan
aktivitas, yang terdiri dari aktivitas yang Anda buat dan aktivitas yang Anda gunakan ulang dari aplikasi lain.
-
Tugas adalah urutan aktivitas yang diikuti pengguna untuk mencapai tujuan.
+
Tugas adalah urutan aktivitas yang diikuti pengguna untuk mencapai tujuan.
Tugas tunggal dapat memanfaatkan aktivitas dari satu aplikasi saja, atau dapat memanfaatkan aktivitas dari sejumlah
aplikasi berbeda.
diff --git a/docs/html-intl/intl/in/guide/components/activities.jd b/docs/html-intl/intl/in/guide/components/activities.jd
index 6cac69638f49a..bbc061cdc8cbb 100644
--- a/docs/html-intl/intl/in/guide/components/activities.jd
+++ b/docs/html-intl/intl/in/guide/components/activities.jd
@@ -53,7 +53,7 @@ jendela lain.
Sebuah aplikasi biasanya terdiri atas beberapa aktivitas yang terikat secara longgar
satu sama lain. Biasanya, satu aktivitas dalam aplikasi ditetapkan sebagai aktivitas "utama", yang
ditampilkan kepada pengguna saat membuka aplikasi untuk pertama kali. Tiap
-aktivitas kemudian bisa memulai aktivitas lain untuk melakukan berbagai tindakan. Tiap kali
+aktivitas kemudian bisa memulai aktivitas lain untuk melakukan berbagai tindakan. Tiap kali
aktivitas baru dimulai, aktivitas sebelumnya akan dihentikan, namun sistem mempertahankan aktivitas
dalam sebuah tumpukan ("back-stack"). Bila sebuah aktivitas baru dimulai, aktivitas itu akan didorong ke atas back-stack dan
mengambil fokus pengguna. Back-stack mematuhi mekanisme dasar tumpukan "masuk terakhir, keluar pertama",
@@ -67,7 +67,7 @@ melalui metode callback daur hidupnya.
Ada beberapa metode callback yang mungkin diterima aktivitas, karena sebuah perubahan dalam
statusnya—apakah sistem sedang membuatnya, menghentikannya, melanjutkannya, atau menghapuskannya—dan
masing-masing callback memberi Anda kesempatan melakukan pekerjaan tertentu yang
-sesuai untuk perubahan status itu. Misalnya, bila dihentikan, aktivitas Anda harus melepas
+sesuai untuk perubahan status itu. Misalnya, bila dihentikan, aktivitas Anda harus melepas
objek besar, seperti koneksi jaringan atau database. Bila aktivitas dilanjutkan, Anda bisa
memperoleh kembali sumber daya yang diperlukan dan melanjutkan tindakan yang terputus. Transisi status ini
semuanya bagian dari daur hidup aktivitas.
@@ -89,7 +89,7 @@ terpenting adalah:
{@link android.app.Activity#onCreate onCreate()}
Anda harus mengimplementasikan metode ini. Sistem memanggilnya saat membuat
- aktivitas Anda. Dalam implementasi, Anda harus menginisialisasi komponen-komponen esensial
+ aktivitas Anda. Dalam implementasi, Anda harus menginisialisasi komponen-komponen esensial
aktivitas.
Yang terpenting, inilah tempat Anda harus memanggil {@link android.app.Activity#setContentView
setContentView()} untuk mendefinisikan layout untuk antarmuka pengguna aktivitas.
@@ -115,7 +115,7 @@ dalam jendela aktivitas dan bisa merespons interaksi pengguna. Misalnya, sebuah
tombol yang mengawali suatu tindakan bila pengguna menyentuhnya.
Android menyediakan sejumlah tampilan siap-dibuat yang bisa Anda gunakan untuk mendesain dan mengatur
-layout. "Widget" adalah tampilan yang menyediakan elemen-elemen visual (dan interaktif) untuk layar,
+layout. "Widget" adalah tampilan yang menyediakan elemen-elemen visual (dan interaktif) untuk layar,
misalnya tombol, bidang teks, kotak cek, atau sekadar sebuah gambar. "Layout" adalah tampilan yang diturunkan dari {@link
android.view.ViewGroup} yang memberikan sebuah model layout unik untuk tampilan anaknya, misalnya
layout linier, layout grid, atau layout relatif. Anda juga bisa mensubkelaskan kelas-kelas {@link android.view.View} dan
@@ -124,7 +124,7 @@ layout Anda sendiri dan menerapkannya ke layout aktivitas Anda.
Cara paling umum untuk mendefinisikan layout dengan menggunakan tampilan adalah dengan file layout XML yang disimpan dalam
sumber daya aplikasi Anda. Dengan cara ini, Anda bisa memelihara desain antarmuka pengguna Anda secara terpisah dari
-kode yang mendefinisikan perilaku aktivitas. Anda bisa mengatur layout sebagai UI
+kode yang mendefinisikan perilaku aktivitas. Anda bisa mengatur layout sebagai UI
aktivitas Anda dengan {@link android.app.Activity#setContentView(int) setContentView()}, dengan meneruskan
ID sumber daya untuk layout itu. Akan tetapi, Anda juga bisa membuat {@link android.view.View} baru dalam
kode aktivitas dan membuat hierarki tampilan dengan menyisipkan {@link
@@ -169,7 +169,7 @@ untuk informasi selengkapnya tentang cara mendeklarasikan aktivitas Anda dalam m
Elemen {@code
<activity>} juga bisa menetapkan berbagai filter intent—dengan menggunakan elemen {@code
-<intent-filter>} —untuk mendeklarasikan cara komponen aplikasi lain
+<intent-filter>} —untuk mendeklarasikan cara komponen aplikasi lain
mengaktifkannya.
Bila Anda membuat aplikasi baru dengan Android SDK Tools, aktivitas stub
@@ -251,7 +251,7 @@ startActivity(intent);
Ekstra {@link android.content.Intent#EXTRA_EMAIL} yang ditambahkan ke intent adalah sebuah larik string
alamat email yang menjadi tujuan pengiriman email. Bila aplikasi email merespons intent ini,
- aplikasi itu akan membaca larik string yang disediakan dalam ekstra dan meletakkannya dalam bidang "to"
+ aplikasi itu akan membaca larik string yang disediakan dalam ekstra dan meletakkannya dalam bidang "to"
pada formulir penulisan email. Dalam situasi ini, aktivitas aplikasi email dimulai dan bila
pengguna selesai, aktivitas Anda akan dilanjutkan.
Contoh ini menunjukkan logika dasar yang harus Anda gunakan dalam metode {@link
-android.app.Activity#onActivityResult onActivityResult()} Anda untuk menangani
+android.app.Activity#onActivityResult onActivityResult()} Anda untuk menangani
hasil aktivitas. Syarat pertama memeriksa apakah permintaan berhasil—jika ya, maka
{@code resultCode} akan berupa {@link android.app.Activity#RESULT_OK}—dan apakah permintaan
yang direspons hasil ini dikenal—dalam hal ini, {@code requestCode} cocok dengan
@@ -602,19 +602,19 @@ tidak berubah. Sebagai gantinya, sistem harus membuat ulang objek {@link android
menyusuri kembali ke aktivitas tersebut. Namun, pengguna tidak menyadari
bahwa sistem memusnahkan aktivitas dan membuatnya kembali dan, karena itu, mungkin
mengharapkan aktivitas untuk sama persis dengan sebelumnya. Dalam situasi ini, Anda bisa memastikan bahwa
-informasi penting tentang status aktivitas tetap terjaga dengan mengimplementasikan
+informasi penting tentang status aktivitas tetap terjaga dengan mengimplementasikan
metode callback tambahan yang memungkinkan Anda menyimpan informasi tentang status aktivitas: {@link
android.app.Activity#onSaveInstanceState onSaveInstanceState()}.
Sistem memanggil {@link android.app.Activity#onSaveInstanceState onSaveInstanceState()}
sebelum membuat aktivitas rawan terhadap pemusnahan. Sistem meneruskan ke metode ini
-sebuah {@link android.os.Bundle} tempat Anda bisa menyimpan
+sebuah {@link android.os.Bundle} tempat Anda bisa menyimpan
informasi status tentang aktivitas sebagai pasangan nama-nilai, dengan menggunakan metode-metode misalnya {@link
android.os.Bundle#putString putString()} dan {@link
android.os.Bundle#putInt putInt()}. Kemudian, jika sistem mematikan proses aplikasi Anda
dan pengguna menyusuri kembali ke aktivitas tersebut, sistem akan membuat kembali aktivitas dan meneruskan
{@link android.os.Bundle} ke {@link android.app.Activity#onCreate onCreate()} maupun {@link
-android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}. Dengan menggunakan salah satu
+android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}. Dengan menggunakan salah satu
metode ini, Anda bisa mengekstrak status tersimpan dari {@link android.os.Bundle} dan memulihkan
status aktivitas. Jika tidak ada informasi status untuk dipulihkan, maka {@link
android.os.Bundle} yang diteruskan kepada adalah Anda null (yang akan terjadi bila aktivitas dibuat untuk
@@ -639,7 +639,7 @@ onPause()}.
Akan tetapi, sekalipun Anda tidak melakukan apa-apa dan tidak mengimplementasikan {@link
android.app.Activity#onSaveInstanceState onSaveInstanceState()}, beberapa status aktivitas
akan dipulihkan oleh implementasi default {@link
-android.app.Activity#onSaveInstanceState onSaveInstanceState()} dalam kelas {@link android.app.Activity}. Khususnya,
+android.app.Activity#onSaveInstanceState onSaveInstanceState()} dalam kelas {@link android.app.Activity}. Khususnya,
implementasi default akan memanggil metode {@link
android.view.View#onSaveInstanceState onSaveInstanceState()} yang sesuai untuk setiap {@link
android.view.View} dalam layout, yang memungkinkan setiap tampilan untuk memberi informasi tentang dirinya
@@ -696,7 +696,7 @@ menggunakan aplikasi.
, dan bahasa). Bila terjadi perubahan demikian, Android akan membuat kembali aktivitas yang berjalan
(sistem akan memanggil {@link android.app.Activity#onDestroy}, kemudian segera memanggil {@link
android.app.Activity#onCreate onCreate()}). Perilaku ini
-didesain untuk membantu aplikasi Anda menyesuaikan diri dengan konfigurasi baru dengan cara memuat ulang
+didesain untuk membantu aplikasi Anda menyesuaikan diri dengan konfigurasi baru dengan cara memuat ulang
aplikasi Anda secara otomatis dengan sumber daya alternatif yang telah Anda sediakan (misalnya layout yang berbeda untuk
layar orientasi dan ukuran yang berbeda).
@@ -722,7 +722,7 @@ Perubahan Runtime.
akan berhenti sementara dan berhenti sama sekali (walau tidak akan berhenti jika masih terlihat di latar belakang), saat
aktivitas lain dibuat. Jika aktivitas-aktivitas ini berbagi data yang disimpan ke disk atau di tempat lain, Anda perlu
memahami bahwa aktivitas pertama tidak dihentikan sepenuhnya sebelum aktivitas kedua dibuat.
-Sebagai gantinya, proses akan memulai aktivitas kedua secara tumpang tindih dengan proses penghentian
+Sebagai gantinya, proses akan memulai aktivitas kedua secara tumpang tindih dengan proses penghentian
aktivitas pertama.
Urutan callback daur hidup didefinisikan dengan baik, khususnya bila kedua aktivitas berada dalam
diff --git a/docs/html-intl/intl/in/guide/components/bound-services.jd b/docs/html-intl/intl/in/guide/components/bound-services.jd
index 5d1f65ed7c8ed..6e5e65a167e8a 100644
--- a/docs/html-intl/intl/in/guide/components/bound-services.jd
+++ b/docs/html-intl/intl/in/guide/components/bound-services.jd
@@ -137,7 +137,7 @@ mendefinisikan {@link android.os.Handler} yang akan merespons aneka tipe objek {
android.os.Message}. {@link android.os.Handler}
ini adalah dasar bagi {@link android.os.Messenger} yang nanti bisa berbagi {@link android.os.IBinder}
dengan klien, sehingga memungkinkan klien mengirim perintah ke layanan dengan menggunakan objek {@link
-android.os.Message}. Selain itu, klien bisa mendefinisikan sendiri {@link android.os.Messenger}
+android.os.Message}. Selain itu, klien bisa mendefinisikan sendiri {@link android.os.Messenger}
sehingga layanan bisa mengirim balik pesan.
Inilah cara termudah melakukan komunikasi antarproses (IPC), karena {@link
android.os.Messenger} akan mengantre semua permintaan ke dalam satu thread sehingga Anda tidak perlu mendesain
@@ -539,7 +539,7 @@ selengkapnya di bawah ini.)
Misalnya, cuplikan berikut menghubungkan klien ke layanan yang dibuat di atas dengan
-memperluas kelas Binder, sehingga tinggal mengkonversi
+memperluas kelas Binder, sehingga tinggal mengkonversi
{@link android.os.IBinder} yang dihasilkan ke kelas {@code LocalService} dan meminta instance {@code
LocalService}:
Parameter pertama {@link android.content.Context#bindService bindService()} adalah sebuah
+
Parameter pertama {@link android.content.Context#bindService bindService()} adalah sebuah
{@link android.content.Intent} yang secara eksplisit menyebutkan layanan yang akan diikat (walaupun intent
boleh implisit).
Parameter kedua adalah objek {@link android.content.ServiceConnection}.
{@link android.app.Fragment} mewakili perilaku atau bagian dari antarmuka pengguna dalam
-{@link android.app.Activity}. Anda bisa mengombinasikan beberapa fragmen dalam satu aktivitas untuk membangun UI
-multipanel dan menggunakan kembali sebuah fragmen dalam beberapa aktivitas. Anda bisa menganggap fragmen sebagai bagian
-modular dari aktivitas, yang memiliki daur hidup sendiri, menerima kejadian input sendiri, dan
-yang bisa Anda tambahkan atau hapus saat aktivitas berjalan (semacam "sub aktivitas" yang
+{@link android.app.Activity}. Anda bisa mengombinasikan beberapa fragmen dalam satu aktivitas untuk membangun UI
+multipanel dan menggunakan kembali sebuah fragmen dalam beberapa aktivitas. Anda bisa menganggap fragmen sebagai bagian
+modular dari aktivitas, yang memiliki daur hidup sendiri, menerima kejadian input sendiri, dan
+yang bisa Anda tambahkan atau hapus saat aktivitas berjalan (semacam "sub aktivitas" yang
bisa digunakan kembali dalam aktivitas berbeda).
-
Fragmen harus selalu tertanam dalam aktivitas dan daur hidup fragmen secara langsung
+
Fragmen harus selalu tertanam dalam aktivitas dan daur hidup fragmen secara langsung
dipengaruhi oleh daur hidup aktivitas host-nya. Misalnya, saat aktivitas dihentikan sementara,
semua fragmen di dalamnya juga dihentikan sementara, dan bila aktivitas dimusnahkan, semua fragmen juga demikian. Akan tetapi, saat
-aktivitas berjalan (dalam status daur hidupdilanjutkan, Anda bisa
-memanipulasi setiap fragmen secara terpisah, seperti menambah atau menghapusnya. Saat melakukan transaksi
+aktivitas berjalan (dalam status daur hidupdilanjutkan, Anda bisa
+memanipulasi setiap fragmen secara terpisah, seperti menambah atau menghapusnya. Saat melakukan transaksi
fragmen, Anda juga bisa menambahkannya ke back-stack yang dikelola oleh aktivitas
-—setiap entri back-stack merupakan record transaksi fragmen yang
+—setiap entri back-stack merupakan record transaksi fragmen yang
terjadi. Dengan back-stack pengguna dapat membalikkan transaksi fragmen (mengarah mundur),
dengan menekan tombol Back.
Bila Anda menambahkan fragmen sebagai bagian dari layout aktivitas, fragmen itu berada dalam {@link
-android.view.ViewGroup} di hierarki tampilan aktivitas tersebut dan fragmen mendefinisikan
+android.view.ViewGroup} di hierarki tampilan aktivitas tersebut dan fragmen mendefinisikan
layout
tampilannya sendiri. Anda bisa menyisipkan fragmen ke dalam layout aktivitas dengan mendeklarasikan fragmen dalam file layout aktivitas
, sebagai elemen {@code <fragment>}, atau dari kode aplikasi dengan menambahkannya ke
- {@link android.view.ViewGroup} yang ada. Akan tetapi, fragmen tidak harus menjadi bagian dari
-layout aktivitas; Anda juga bisa menggunakan fragmen tanpa UI-nya sendiri sebagai pekerja tak terlihat untuk
+ {@link android.view.ViewGroup} yang ada. Akan tetapi, fragmen tidak harus menjadi bagian dari
+layout aktivitas; Anda juga bisa menggunakan fragmen tanpa UI-nya sendiri sebagai pekerja tak terlihat untuk
aktivitas tersebut.
-
Dokumen ini menjelaskan cara membangun aplikasi menggunakan fragmen, termasuk
+
Dokumen ini menjelaskan cara membangun aplikasi menggunakan fragmen, termasuk
cara fragmen mempertahankan statusnya bila ditambahkan ke back-stack aktivitas, berbagi
kejadian dengan aktivitas, dan fragmen lain dalam aktivitas, berkontribusi pada action-bar
aktivitas, dan lainnya.
@@ -80,45 +80,45 @@ aktivitas, dan lainnya.
Filosofi Desain
-
Android memperkenalkan fragmen di Android 3.0 (API level 11), terutama untuk mendukung desain UI yang lebih
-dinamis dan fleksibel pada layar besar, seperti tablet. Karena
-layar tablet jauh lebih besar daripada layar handset, maka lebih banyak ruang untuk mengombinasikan dan
-bertukar komponen UI. Fragmen memungkinkan desain seperti itu tanpa perlu mengelola perubahan
-kompleks pada hierarki tampilan. Dengan membagi layout aktivitas menjadi beberapa fragmen, Anda bisa
-mengubah penampilan aktivitas saat runtime dan mempertahankan perubahan itu di back-stack
+
Android memperkenalkan fragmen di Android 3.0 (API level 11), terutama untuk mendukung desain UI yang lebih
+dinamis dan fleksibel pada layar besar, seperti tablet. Karena
+layar tablet jauh lebih besar daripada layar handset, maka lebih banyak ruang untuk mengombinasikan dan
+bertukar komponen UI. Fragmen memungkinkan desain seperti itu tanpa perlu mengelola perubahan
+kompleks pada hierarki tampilan. Dengan membagi layout aktivitas menjadi beberapa fragmen, Anda bisa
+mengubah penampilan aktivitas saat runtime dan mempertahankan perubahan itu di back-stack
yang dikelola oleh aktivitas.
-
Misalnya, aplikasi berita bisa menggunakan satu fragmen untuk menampilkan daftar artikel di
-sebelah kiri dan fragmen lainnya untuk menampilkan artikel di sebelah kanan—kedua fragmen ini muncul di satu
-aktivitas, berdampingan, dan masing-masing fragmen memiliki serangkaian metode callback daur hidup dan menangani kejadian input
+
Misalnya, aplikasi berita bisa menggunakan satu fragmen untuk menampilkan daftar artikel di
+sebelah kiri dan fragmen lainnya untuk menampilkan artikel di sebelah kanan—kedua fragmen ini muncul di satu
+aktivitas, berdampingan, dan masing-masing fragmen memiliki serangkaian metode callback daur hidup dan menangani kejadian input
penggunanya sendiri. Sehingga, sebagai ganti menggunakan satu aktivitas untuk memilih
-artikel dan aktivitas lainnya untuk membaca artikel, pengguna bisa memilih artikel dan membaca semuanya dalam
+artikel dan aktivitas lainnya untuk membaca artikel, pengguna bisa memilih artikel dan membaca semuanya dalam
aktivitas yang sama, sebagaimana diilustrasikan dalam layout tablet pada gambar 1.
-
Anda harus mendesain masing-masing fragmen sebagai komponen aktivitas modular dan bisa digunakan kembali. Yakni, karena
-setiap fragmen mendefinisikan layoutnya dan perilakunya dengan callback daur hidupnya sendiri, Anda bisa memasukkan
+
Anda harus mendesain masing-masing fragmen sebagai komponen aktivitas modular dan bisa digunakan kembali. Yakni, karena
+setiap fragmen mendefinisikan layoutnya dan perilakunya dengan callback daur hidupnya sendiri, Anda bisa memasukkan
satu fragmen dalam banyak aktivitas, sehingga Anda harus mendesainnya untuk digunakan kembali dan mencegah
-memanipulasi satu fragmen dari fragmen lain secara langsung. Ini terutama penting karena dengan
-fragmen modular Anda bisa mengubah kombinasi fragmen untuk ukuran layar berbeda. Saat mendesain aplikasi
-untuk mendukung tablet maupun handset, Anda bisa menggunakan kembali fragmen dalam
+memanipulasi satu fragmen dari fragmen lain secara langsung. Ini terutama penting karena dengan
+fragmen modular Anda bisa mengubah kombinasi fragmen untuk ukuran layar berbeda. Saat mendesain aplikasi
+untuk mendukung tablet maupun handset, Anda bisa menggunakan kembali fragmen dalam
konfigurasi layout berbeda untuk mengoptimalkan pengalaman pengguna berdasarkan ruang layar yang tersedia. Misalnya
-, pada handset, fragmen mungkin perlu dipisahkan untuk menyediakan UI panel tunggal
+, pada handset, fragmen mungkin perlu dipisahkan untuk menyediakan UI panel tunggal
bila lebih dari satu yang tidak cocok dalam aktivitas yang sama.
Gambar 1. Contoh cara dua modul UI yang didefinisikan oleh
- fragmen bisa digabungkan ke dalam satu aktivitas untuk desain tablet, namun dipisahkan untuk
+ fragmen bisa digabungkan ke dalam satu aktivitas untuk desain tablet, namun dipisahkan untuk
desain handset.
Misalnya—untuk melanjutkan contoh aplikasi berita— aplikasi bisa menanamkan
dua fragmen dalam Aktivitas A, saat berjalan pada perangkat berukuran tablet. Akan tetapi, pada
-layar berukuran handset, ruang untuk kedua fragmen tidak cukup, sehingga Aktivitas A hanya
-menyertakan fragmen untuk daftar artikel, dan saat pengguna memilih artikel,
-Aktivitas B akan dimulai, termasuk fragmen kedua untuk membaca artikel. Sehingga, aplikasi mendukung
+layar berukuran handset, ruang untuk kedua fragmen tidak cukup, sehingga Aktivitas A hanya
+menyertakan fragmen untuk daftar artikel, dan saat pengguna memilih artikel,
+Aktivitas B akan dimulai, termasuk fragmen kedua untuk membaca artikel. Sehingga, aplikasi mendukung
tablet dan handset dengan menggunakan kembali fragmen dalam kombinasi berbeda, seperti diilustrasikan dalam
gambar 1.
-
Untuk informasi selengkapnya tentang mendesain aplikasi menggunakan kombinasi fragmen berbeda
+
Untuk informasi selengkapnya tentang mendesain aplikasi menggunakan kombinasi fragmen berbeda
untuk konfigurasi layar berbeda, lihat panduan untuk Mendukung Tablet dan Handset.
@@ -131,26 +131,26 @@ untuk konfigurasi layar berbeda, lihat panduan untuk Menangani Daur Hidup Fragmen.
@@ -171,15 +171,15 @@ android.app.Fragment}:
{@link android.app.DialogFragment}
Menampilkan dialog mengambang. Penggunaan kelas ini untuk membuat dialog merupakan alternatif yang baik dari
-penggunaan metode helper dialog di kelas {@link android.app.Activity}, karena Anda bisa
-menyatukan dialog fragmen ke dalam back-stack fragmen yang dikelola oleh aktivitas,
+penggunaan metode helper dialog di kelas {@link android.app.Activity}, karena Anda bisa
+menyatukan dialog fragmen ke dalam back-stack fragmen yang dikelola oleh aktivitas,
sehingga pengguna bisa kembali ke fragmen yang ditinggalkan.
{@link android.app.ListFragment}
Menampilkan daftar item yang dikelola oleh adaptor (seperti {@link
android.widget.SimpleCursorAdapter}), serupa dengan {@link android.app.ListActivity}. Menampilkan
beberapa metode pengelolaan daftar tampilan seperti callback {@link
-android.app.ListFragment#onListItemClick(ListView,View,int,long) onListItemClick()} untuk
+android.app.ListFragment#onListItemClick(ListView,View,int,long) onListItemClick()} untuk
menangani kejadian klik.
{@link android.preference.PreferenceFragment}
@@ -196,7 +196,7 @@ layoutnya sendiri ke aktivitas.
Untuk menyediakan layout fragmen, Anda harus mengimplementasikan metode callback {@link
android.app.Fragment#onCreateView onCreateView()}, yang dipanggil sistem Android
-bila tiba saatnya fragmen menggambar layoutnya. Implementasi Anda atas metode ini harus mengembalikan
+bila tiba saatnya fragmen menggambar layoutnya. Implementasi Anda atas metode ini harus mengembalikan
{@link android.view.View} yang menjadi akar layout fragmen.
Catatan: Jika fragmen adalah subkelas {@link
@@ -205,7 +205,7 @@ android.app.ListFragment}, implementasi default akan mengembalikan {@link androi
Untuk mengembalikan layout dari {@link
android.app.Fragment#onCreateView onCreateView()}, Anda bisa memekarkannya dari sumber daya layout yang didefinisikan di XML. Untuk
-membantu melakukannya, {@link android.app.Fragment#onCreateView onCreateView()} menyediakan objek
+membantu melakukannya, {@link android.app.Fragment#onCreateView onCreateView()} menyediakan objek
{@link android.view.LayoutInflater}.
Misalnya, ini adalah subkelas {@link android.app.Fragment} yang memuat layout dari file
@@ -227,7 +227,7 @@ public static class ExampleFragment extends Fragment {
Membuat layout
Dalam contoh di atas, {@code R.layout.example_fragment} merupakan acuan ke sumber daya layout
bernama {@code example_fragment.xml} yang tersimpan dalam sumber daya aplikasi. Untuk informasi tentang cara
-membuat layout di XML, lihat dokumentasi
+membuat layout di XML, lihat dokumentasi
Antarmuka Pengguna.
@@ -235,12 +235,12 @@ membuat layout di XML, lihat dokumentasi
Parameter {@code container} yang diteruskan ke {@link android.app.Fragment#onCreateView
onCreateView()} adalah induk {@link android.view.ViewGroup} (dari layout aktivitas) tempat
layout fragmen
-akan disisipkan. Parameter {@code savedInstanceState} adalah {@link android.os.Bundle} yang
+akan disisipkan. Parameter {@code savedInstanceState} adalah {@link android.os.Bundle} yang
menyediakan data tentang instance fragmen sebelumnya, jika fragmen dilanjutkan
(status pemulihan dibahas selengkapnya di bagian tentang Menangani
Daur Hidup Fragmen).
-
Metode {@link android.view.LayoutInflater#inflate(int,ViewGroup,boolean) inflate()} membutuhkan
+
Metode {@link android.view.LayoutInflater#inflate(int,ViewGroup,boolean) inflate()} membutuhkan
tiga argumen:
ID sumber daya layout yang ingin dimekarkan.
@@ -260,7 +260,7 @@ fragmen ke aktivitas.
Menambahkan fragmen ke aktivitas
-
Biasanya, fragmen berkontribusi pada sebagian UI ke aktivitas host, yang ditanamkan sebagai
+
Biasanya, fragmen berkontribusi pada sebagian UI ke aktivitas host, yang ditanamkan sebagai
bagian dari hierarki tampilan keseluruhan aktivitas. Ada dua cara untuk menambahkan fragmen ke layout
aktivitas:
@@ -297,13 +297,13 @@ untuk mengambil setiap fragmen. Sistem akan menyisipkan {@link android.view.View
Catatan: Setiap fragmen memerlukan identifier
-unik yang bisa digunakan sistem untuk memulihkan fragmen jika aktivitas dimulai kembali (dan identifier yang bisa digunakan menangkap
+unik yang bisa digunakan sistem untuk memulihkan fragmen jika aktivitas dimulai kembali (dan identifier yang bisa digunakan menangkap
fragmen untuk melakukan transaksi, seperti menghapusnya). Ada tiga cara untuk memberikan
ID bagi fragmen:
Memberikan atribut {@code android:id} bersama ID unik.
Memberikan atribut {@code android:tag} bersama string unik.
-
Jika Anda tidak memberikan dua hal tersebut, sistem akan menggunakan ID
+
Jika Anda tidak memberikan dua hal tersebut, sistem akan menggunakan ID
tampilan kontainer.
@@ -354,15 +354,15 @@ android.app.FragmentTransaction#add(Fragment,String)} (dengan menyediakan string
dalam layout aktivitas, ini tidak akan menerima panggilan ke {@link
android.app.Fragment#onCreateView onCreateView()}. Jadi Anda tidak perlu mengimplementasikan metode itu.
-
Menyediakan tag string untuk fragmen tidak hanya untuk fragmen non-UI—Anda juga bisa
+
Menyediakan tag string untuk fragmen tidak hanya untuk fragmen non-UI—Anda juga bisa
menyediakan tag string untuk fragmen yang memiliki UI—namun jika fragmen tidak memiliki UI
-, maka tag string adalah satu-satunya cara untuk mengidentifikasinya. Jika Anda ingin mendapatkan fragmen dari
+, maka tag string adalah satu-satunya cara untuk mengidentifikasinya. Jika Anda ingin mendapatkan fragmen dari
aktivitas nantinya, Anda perlu menggunakan {@link android.app.FragmentManager#findFragmentByTag
findFragmentByTag()}.
Untuk contoh aktivitas yang menggunakan fragmen sebagai pekerja latar belakang, tanpa UI, lihat sampel {@code
-FragmentRetainInstance.java}, yang disertakan dalam sampel SDK (tersedia melalui
-Android SDK Manager) dan terletak di sistem Anda sebagai
+FragmentRetainInstance.java}, yang disertakan dalam sampel SDK (tersedia melalui
+Android SDK Manager) dan terletak di sistem Anda sebagai
<sdk_root>/APIDemos/app/src/main/java/com/example/android/apis/app/FragmentRetainInstance.java.
@@ -378,7 +378,7 @@ mendapatkannya, panggil {@link android.app.Activity#getFragmentManager()} dari a
Dapatkan fragmen yang ada di aktivitas dengan {@link
android.app.FragmentManager#findFragmentById findFragmentById()} (untuk fragmen yang menyediakan UI dalam
layout aktivitas) atau {@link android.app.FragmentManager#findFragmentByTag
-findFragmentByTag()} (untuk fragmen yang menyediakan atau tidak menyediakan UI).
+findFragmentByTag()} (untuk fragmen yang menyediakan atau tidak menyediakan UI).
Tarik fragmen dari back-stack, dengan {@link
android.app.FragmentManager#popBackStack()} (mensimulasikan perintah Back oleh pengguna).
Daftarkan listener untuk perubahan pada back-stack, dengan {@link
@@ -395,7 +395,7 @@ menambah dan menghapus fragmen.
Melakukan Transaksi Fragmen
-
Fitur menarik terkait penggunaan fragmen di aktivitas adalah kemampuan menambah, menghapus, mengganti,
+
Fitur menarik terkait penggunaan fragmen di aktivitas adalah kemampuan menambah, menghapus, mengganti,
dan melakukan tindakan lain dengannya, sebagai respons atas interaksi pengguna. Setiap set perubahan
yang Anda lakukan untuk aktivitas disebut transaksi dan Anda bisa melakukan transaksi menggunakan API di {@link
android.app.FragmentTransaction}. Anda juga bisa menyimpan setiap transaksi ke back-stack yang dikelola
@@ -423,7 +423,7 @@ android.app.FragmentTransaction#addToBackStack addToBackStack()}, untuk menambah
ke back-stack dari transaksi fragmen. Back-stack ini dikelola oleh aktivitas dan memungkinkan
pengguna kembali ke status fragmen sebelumnya, dengan menekan tombol Back.
-
Misalnya, berikut ini cara mengganti satu fragmen dengan yang fragmen yang lain, dan mempertahankan
+
Misalnya, berikut ini cara mengganti satu fragmen dengan yang fragmen yang lain, dan mempertahankan
status sebelumnya di back-stack:
@@ -442,18 +442,18 @@ transaction.commit();
Dalam contoh ini, {@code newFragment} menggantikan fragmen apa saja (jika ada) yang saat ini berada dalam
kontainer layout yang diidentifikasi oleh ID {@code R.id.fragment_container}. Dengan memanggil @link
-android.app.FragmentTransaction#addToBackStack addToBackStack()}, transaksi yang diganti
-disimpan ke back-stack sehingga pengguna bisa membalikkan transaksi dan mengembalikan fragmen
+android.app.FragmentTransaction#addToBackStack addToBackStack()}, transaksi yang diganti
+disimpan ke back-stack sehingga pengguna bisa membalikkan transaksi dan mengembalikan fragmen
sebelumnya dengan menekan tombol Back.
Jika Anda menambahkan beberapa perubahan pada transaksi (seperti {@link
android.app.FragmentTransaction#add add()} atau {@link android.app.FragmentTransaction#remove
remove()}) dan panggil {@link
-android.app.FragmentTransaction#addToBackStack addToBackStack()}, maka semua perubahan akan diterapkan
-sebelum Anda memanggil {@link android.app.FragmentTransaction#commit commit()} akan ditambahkan ke
+android.app.FragmentTransaction#addToBackStack addToBackStack()}, maka semua perubahan akan diterapkan
+sebelum Anda memanggil {@link android.app.FragmentTransaction#commit commit()} akan ditambahkan ke
back-stack sebagai satu transaksi dan tombol Back akan membalikannya semua.
-
Urutan menambahkan perubahan pada {@link android.app.FragmentTransaction} tidak berpengaruh,
+
Urutan menambahkan perubahan pada {@link android.app.FragmentTransaction} tidak berpengaruh,
kecuali:
Anda harus memanggil {@link android.app.FragmentTransaction#commit()} paling akhir
@@ -462,9 +462,9 @@ urutan penambahannya akan menentukan urutan munculnya dalam hierarki tampilan
Jika Anda tidak memanggil {@link android.app.FragmentTransaction#addToBackStack(String)
-addToBackStack()} saat melakukan transaksi yang menghapus fragmen, maka fragmen itu
+addToBackStack()} saat melakukan transaksi yang menghapus fragmen, maka fragmen itu
akan dimusnahkan bila transaksi diikat dan pengguna tidak bisa mengarah kembali ke sana. Sedangkan, jika
-Anda memanggil {@link android.app.FragmentTransaction#addToBackStack(String) addToBackStack()} saat
+Anda memanggil {@link android.app.FragmentTransaction#addToBackStack(String) addToBackStack()} saat
menghapus fragmen, maka fragmen itu akan dihentikan dan akan dilanjutkan jika pengguna mengarah
kembali.
@@ -473,9 +473,9 @@ transisi, dengan memanggil {@link android.app.FragmentTransaction#setTransition
mengikatnya.
Memanggil {@link android.app.FragmentTransaction#commit()} tidak akan langsung menjalankan
-transaksi. Namun sebuah jadwal akan dibuat untuk dijalankan pada thread UI aktivitas (thread "utama")
+transaksi. Namun sebuah jadwal akan dibuat untuk dijalankan pada thread UI aktivitas (thread "utama")
begitu thread bisa melakukannya. Akan tetapi, jika perlu Anda bisa memanggil {@link
-android.app.FragmentManager#executePendingTransactions()} dari thread UI untuk segera
+android.app.FragmentManager#executePendingTransactions()} dari thread UI untuk segera
mengeksekusi transaksi yang diserahkan oleh {@link android.app.FragmentTransaction#commit()}. Hal itu
biasanya tidak perlu kecuali jika transaksi merupakan dependensi bagi pekerjaan dalam thread lain.
@@ -503,7 +503,7 @@ android.app.Fragment#getActivity()} dan dengan mudah melakukan tugas-tugas seper
View listView = {@link android.app.Fragment#getActivity()}.{@link android.app.Activity#findViewById findViewById}(R.id.list);
-
Demikian pula, aktivitas Anda bisa memanggil metode di fragmen dengan meminta acuan ke
+
Demikian pula, aktivitas Anda bisa memanggil metode di fragmen dengan meminta acuan ke
{@link android.app.Fragment} dari {@link android.app.FragmentManager}, menggunakan {@link
android.app.FragmentManager#findFragmentById findFragmentById()} atau {@link
android.app.FragmentManager#findFragmentByTag findFragmentByTag()}. Misalnya:
@@ -537,7 +537,7 @@ public static class FragmentA extends ListFragment {
Selanjutnya aktivitas yang menjadi host fragmen akan mengimplementasikan antarmuka {@code OnArticleSelectedListener}
- dan
+ dan
mengesampingkan {@code onArticleSelected()} untuk memberi tahu fragmen B mengenai kejadian dari fragmen A. Untuk memastikan
bahwa aktivitas host mengimplementasikan antarmuka ini, metode callback fragmen A {@link
android.app.Fragment#onAttach onAttach()} (yang dipanggil sistem saat menambahkan
@@ -564,7 +564,7 @@ public static class FragmentA extends ListFragment {
Jika aktivitas belum mengimplementasikan antarmuka, maka fragmen akan melontarkan
{@link java.lang.ClassCastException}.
-Jika berhasil, anggota {@code mListener} yang menyimpan acuan ke implementasi aktivitas
+Jika berhasil, anggota {@code mListener} yang menyimpan acuan ke implementasi aktivitas
{@code OnArticleSelectedListener}, sehingga fragmen A bisa berbagi kejadian dengan aktivitas, dengan memanggil metode
yang didefinisikan oleh antarmuka {@code OnArticleSelectedListener}. Misalnya, jika fragmen A adalah
ekstensi dari {@link android.app.ListFragment}, maka setiap kali
@@ -654,7 +654,7 @@ seluruh layar).
Dihentikan
Fragmen tidak terlihat. Aktivitas host telah dihentikan atau
fragmen telah dihapus dari aktivitas namun ditambahkan ke back-stack. Fragmen yang dihentikan
-masih hidup (semua status dan informasi anggota masih disimpan oleh sistem). Akan tetapi, fragmen
+masih hidup (semua status dan informasi anggota masih disimpan oleh sistem). Akan tetapi, fragmen
tidak terlihat lagi oleh pengguna dan akan dimatikan jika aktivitas dimatikan.
@@ -668,10 +668,10 @@ android.app.Fragment#onActivityCreated onActivityCreated()}. Untuk informasi sel
status, lihat dokumen Aktivitas
.
-
Perbedaan paling signifikan dalam daur hidup antara aktivitas dan fragmen ada
+
Perbedaan paling signifikan dalam daur hidup antara aktivitas dan fragmen ada
pada cara penyimpanannya dalam back-stack masing-masing. Aktivitas ditempatkan ke back-stack aktivitas
yang dikelola oleh sistem saat dihentikan, secara default (sehingga pengguna bisa mengarah kembali
-ke aktivitas dengan tombol Back, seperti yang dibahas dalam Tugas dan Back-Stack).
+ke aktivitas dengan tombol Back, seperti yang dibahas dalam Tugas dan Back-Stack).
Akan tetapi, fragmen yang ditempatkan ke back-stack dikelola oleh aktivitas host hanya saat
Anda secara eksplisit meminta agar instance disimpan dengan memanggil {@link
android.app.FragmentTransaction#addToBackStack(String) addToBackStack()} selama transaksi yang
@@ -736,7 +736,7 @@ melalui daur hidupnya oleh aktivitas.
Untuk merangkum semua yang telah dibahas dalam dokumen ini, berikut ini contoh aktivitas
yang menggunakan dua fragmen untuk membuat layout dua panel. Aktivitas di bawah ini menyertakan satu fragmen untuk
menampilkan daftar putar Shakespeare dan fragmen lainnya menampilkan rangkuman pemutaran bila dipilih dari
-daftar. Aktivitas ini juga menunjukkan cara menyediakan konfigurasi fragmen berbeda,
+daftar. Aktivitas ini juga menunjukkan cara menyediakan konfigurasi fragmen berbeda,
berdasarkan konfigurasi layar.
Catatan: Kode sumber lengkap untuk aktivitas ini tersedia di
@@ -752,7 +752,7 @@ android.app.Activity#onCreate onCreate()}:
Dengan layout ini, sistem akan membuat instance {@code TitlesFragment} (yang mencantumkan
+
Dengan layout ini, sistem akan membuat instance {@code TitlesFragment} (yang mencantumkan
judul) segera setelah aktivitas memuat layout, sementara {@link android.widget.FrameLayout}
(lokasi penempatan fragmen untuk menampilkan rangkuman pemutaran) menempati ruang di sisi kanan
layar, namun pada awalnya masih kosong. Seperti yang akan Anda lihat di bawah ini, sampai pengguna memilih item
@@ -769,14 +769,14 @@ tersimpan di {@code res/layout/fragment_layout.xml}:
Layout ini hanya menyertakan {@code TitlesFragment}. Ini artinya saat perangkat berada dalam
orientasi tegak, hanya judul daftar putar yang terlihat. Jadi, saat pengguna mengklik item
-daftar dalam konfigurasi ini, aplikasi akan memulai aktivitas baru untuk menampilkan rangkuman,
+daftar dalam konfigurasi ini, aplikasi akan memulai aktivitas baru untuk menampilkan rangkuman,
sebagai ganti pemuatan fragmen kedua.
Berikutnya, Anda bisa melihat bagaimana hal ini dilakukan dalam kelas fragmen. Pertama adalah {@code
TitlesFragment}, yang menampilkan judul daftar putar Shakespeare. Fragmen ini membuat ekstensi {@link
android.app.ListFragment} dan mengandalkannya itu untuk menangani sebagian besar pekerjaan tampilan daftar.
-
Saat Anda memeriksa kode ini, perhatikan bahwa ada dua kemungkinan perilaku saat pengguna mengklik
+
Saat Anda memeriksa kode ini, perhatikan bahwa ada dua kemungkinan perilaku saat pengguna mengklik
item daftar: bergantung pada layout mana yang aktif, bisa membuat dan menampilkan fragmen
baru untuk menampilkan detail dalam aktivitas yang sama (menambahkan fragmen ke {@link
android.widget.FrameLayout}), atau memulai aktivitas baru (tempat fragmen ditampilkan).
@@ -785,11 +785,11 @@ android.widget.FrameLayout}), atau memulai aktivitas baru (tempat fragmen ditamp
Fragmen kedua, {@code DetailsFragment} menampilkan rangkuman pemutaran untuk item yang dipilih dari
daftar dari {@code TitlesFragment}:
Ingatlah dari kelas {@code TitlesFragment}, bahwa, jika pengguna mengklik item daftar dan
-layout saat ini tidak menyertakan tampilan {@code R.id.details} (yaitu tempat
+layout saat ini tidak menyertakan tampilan {@code R.id.details} (yaitu tempat
{@code DetailsFragment} berada), maka aplikasi memulai aktivitas {@code DetailsActivity}
untuk menampilkan konten item.
@@ -798,14 +798,14 @@ yang dipilih saat layar dalam orientasi tegak:
{@sample development/samples/ApiDemos/src/com/example/android/apis/app/FragmentLayout.java
details_activity}
-
+
Perhatikan bahwa aktivitas ini selesai sendiri jika konfigurasi mendatar, sehingga aktivitas utama
bisa mengambil alih dan menampilkan {@code DetailsFragment} bersama {@code TitlesFragment}.
Ini bisa terjadi jika pengguna memulai {@code DetailsActivity} saat dalam orientasi tegak, namun kemudian
memutarnya menjadi mendatar (yang akan memulai lagi aktivitas saat ini).
-
Untuk contoh lainnya mengenai penggunaan fragmen (dan file sumber lengkap untuk contoh ini),
+
Untuk contoh lainnya mengenai penggunaan fragmen (dan file sumber lengkap untuk contoh ini),
lihat aplikasi contoh Demo API yang tersedia di
ApiDemos (bisa diunduh dari Komponen contoh SDK).
Aplikasi Android ditulis dalam bahasa pemrograman Java. Android SDK Tools mengkompilasi
+
Aplikasi Android ditulis dalam bahasa pemrograman Java. Android SDK Tools mengkompilasi
kode Anda—bersama data dan file sumber daya —ke dalam APK: Paket Android,
-yaitu file arsip berekstensi {@code .apk}. Satu file APK berisi semua konten
+yaitu file arsip berekstensi {@code .apk}. Satu file APK berisi semua konten
aplikasi Android dan merupakan file yang digunakan perangkat berbasis Android untuk menginstal aplikasi.
Setelah diinstal di perangkat, setiap aplikasi Android tinggal di sandbox keamanannya sendiri:
-
Sistem operasi Android merupakan sistem Linux multi-pengguna yang di dalamnya setiap
+
Sistem operasi Android merupakan sistem Linux multi-pengguna yang di dalamnya setiap
aplikasi adalah pengguna berbeda.
Secara default, sistem menetapkan ID pengguna Linux unik kepada setiap aplikasi (ID ini hanya
digunakan oleh sistem dan tidak diketahui aplikasi). Sistem menetapkan izin
bagi semua file dalam aplikasi sehingga hanya ID pengguna yang diizinkan yang bisa mengaksesnya.
-
Setiap proses memiliki mesin virtual (VM) sendiri, sehingga kode aplikasi yang berjalan secara terisolasi dari
+
Setiap proses memiliki mesin virtual (VM) sendiri, sehingga kode aplikasi yang berjalan secara terisolasi dari
aplikasi lainnya.
-
Secara default, setiap aplikasi berjalan dalam proses Linux-nya sendiri. Android memulai proses
+
Secara default, setiap aplikasi berjalan dalam proses Linux-nya sendiri. Android memulai proses
bila ada komponen aplikasi yang perlu dijalankan, kemudian mematikan proses bila tidak lagi diperlukan
atau bila sistem harus memulihkan memori untuk digunakan aplikasi lain.
-
Dengan cara ini, sistem Android mengimplementasikan prinsip privilese minim. Ini berarti,
+
Dengan cara ini, sistem Android mengimplementasikan prinsip privilese minim. Ini berarti,
secara default aplikasi hanya memiliki akses ke komponen yang diperlukannya untuk melakukan pekerjaannya dan
-tidak lebih dari itu. Hal ini menghasilkan lingkungan yang sangat aman sehingga aplikasi tidak bisa mengakses bagian
+tidak lebih dari itu. Hal ini menghasilkan lingkungan yang sangat aman sehingga aplikasi tidak bisa mengakses bagian
sistem bila tidak diberi izin.
Akan tetapi, ada beberapa cara bagi aplikasi untuk berbagi data dengan aplikasi lain dan bagi aplikasi
untuk mengakses layanan sistem:
-
Dua aplikasi bisa diatur untuk menggunakan ID pengguna Linux yang sama,
+
Dua aplikasi bisa diatur untuk menggunakan ID pengguna Linux yang sama,
dalam hal ini keduanya bisa saling mengakses file masing-masing. Untuk menghemat sumber daya sistem, aplikasi dengan ID
pengguna yang sama juga bisa diatur agar berjalan dalam proses Linux yang sama dan menggunakan VM yang sama (
aplikasi juga harus ditandatangani dengan sertifikat yang sama).
-
Aplikasi bisa meminta izin akses ke data perangkat seperti kontak
-pengguna, pesan SMS, penyimpanan lepas-pasang (kartu SD), kamera, Bluetooth, dan lainnya. Semua
+
Aplikasi bisa meminta izin akses ke data perangkat seperti kontak
+pengguna, pesan SMS, penyimpanan lepas-pasang (kartu SD), kamera, Bluetooth, dan lainnya. Semua
izin aplikasi harus diberikan oleh pengguna saat menginstal.
@@ -69,7 +69,7 @@ selanjutnya memperkenalkan Anda pada:
Komponen kerangka kerja inti yang mendefinisikan aplikasi.
File manifes tempat Anda mendeklarasikan komponen dan fitur yang diperlukan perangkat
untuk aplikasi.
-
Sumber daya yang terpisah dari kode aplikasi dan memungkinkan
+
Sumber daya yang terpisah dari kode aplikasi dan memungkinkan
aplikasi mengoptimalkan perilakunya untuk beragam konfigurasi perangkat.
Komponen aplikasi adalah blok pembangun penting dari aplikasi Android.
-Setiap komponen merupakan titik berbeda yang digunakan sistem untuk memasuki aplikasi. Tidak semua komponen
-merupakan titik masuk sebenarnya bagi pengguna dan sebagian saling bergantung, namun masing-masing komponen tersedia
+Setiap komponen merupakan titik berbeda yang digunakan sistem untuk memasuki aplikasi. Tidak semua komponen
+merupakan titik masuk sebenarnya bagi pengguna dan sebagian saling bergantung, namun masing-masing komponen tersedia
sebagai kesatuan sendiri dan memainkan peran tertentu—masing-masing merupakan
blok pembangun unik yang mendefinisikan perilaku aplikasi secara keseluruhan.
@@ -93,7 +93,7 @@ dan daur hidupnya sendiri yang mendefinisikan cara komponen dibuat dan dimusnahk
Aktivitas
Sebuah aktivitas mewakili satu layar dengan antarmuka pengguna. Misalnya,
-aplikasi email mungkin memiliki satu aktivitas yang menampilkan daftar email
+aplikasi email mungkin memiliki satu aktivitas yang menampilkan daftar email
baru, aktivitas lain untuk menulis email, dan aktivitas satunya lagi untuk membaca email. Walaupun
semua aktivitas bekerja sama untuk membentuk pengalaman pengguna yang kohesif dalam aplikasi email,
masing-masing tidak saling bergantung. Karenanya, aplikasi berbeda bisa memulai
@@ -110,7 +110,7 @@ tentang hal ini dalam panduan pengembang Layanan.
Sebuah penyedia konten mengelola seperangkat data-bersama aplikasi. Anda bisa menyimpan data
dalam sistem file, database SQLite, di web, atau lokasi penyimpanan permanen lainnya
-yang bisa diakses aplikasi. Melalui penyedia konten, aplikasi lain bisa melakukan query atau bahkan
+yang bisa diakses aplikasi. Melalui penyedia konten, aplikasi lain bisa melakukan query atau bahkan
memodifikasi data (jika penyedia konten mengizinkannya). Misalnya, sistem Android menyediakan penyedia
konten yang mengelola informasi kontak pengguna. Karenanya, setiap aplikasi
dengan izin yang sesuai bisa melakukan query mengenai bagian dari penyedia konten (seperti {@link
@@ -137,7 +137,7 @@ penyedia konten untuk menyimpan catatan.
Penyedia konten diimplementasikan sebagai subkelas {@link android.content.ContentProvider}
dan harus mengimplementasikan seperangkat standar API yang memungkinkan aplikasi
-lain melakukan transaksi. Untuk informasi selengkapnya, lihat panduan pengembang
+lain melakukan transaksi. Untuk informasi selengkapnya, lihat panduan pengembang
Penyedia Konten.
@@ -163,7 +163,7 @@ lihat kelas {@link android.content.BroadcastReceiver}.
-
Aspek unik dari desain sistem Android adalah aplikasi mana pun bisa memulai
+
Aspek unik dari desain sistem Android adalah aplikasi mana pun bisa memulai
komponen aplikasi lain. Misalnya, jika Anda menginginkan pengguna mengambil
foto dengan kamera perangkat, bisa saja aplikasi lain yang melakukannya dan aplikasi
Anda bisa menggunakannya, sebagai ganti mengembangkan aktivitas sendiri untuk mengambil foto. Anda tidak
@@ -175,7 +175,7 @@ kamera seakan menjadi bagian dari aplikasi Anda.
Saat sistem memulai komponen, sistem akan memulai proses untuk aplikasi itu (jika
belum berjalan) dan membuat instance kelas yang diperlukan untuk komponen. Misalnya, jika aplikasi Anda
memulai aktivitas dalam aplikasi kamera yang mengambil foto, aktivitas itu akan
-berjalan dalam proses yang dimiliki oleh aplikasi kamera, bukan dalam proses aplikasi Anda.
+berjalan dalam proses yang dimiliki oleh aplikasi kamera, bukan dalam proses aplikasi Anda.
Karenanya, tidak seperti aplikasi di sebagian besar sistem lain, aplikasi Android tidak memiliki titik
masuk tunggal (misalnya tidak ada fungsi {@code main()}).
@@ -198,13 +198,13 @@ atau milik aplikasi lain.
mengaktifkan komponen tertentu atau komponen tipe komponen tertentu—masing-masing intent
bisa eksplisit atau implisit.
-
Untuk aktivitas dan layanan, intent mendefinisikan tindakan yang akan dilakukan (misalnya, untuk "melihat" atau
-"mengirim" sesuatu) dan mungkin menetapkan URI data untuk ditindaklanjuti (salah satu hal yang mungkin perlu diketahui
-oleh komponen yang akan dimulai). Misalnya, intent mungkin menyampaikan permintaan suatu
+
Untuk aktivitas dan layanan, intent mendefinisikan tindakan yang akan dilakukan (misalnya, untuk "melihat" atau
+"mengirim" sesuatu) dan mungkin menetapkan URI data untuk ditindaklanjuti (salah satu hal yang mungkin perlu diketahui
+oleh komponen yang akan dimulai). Misalnya, intent mungkin menyampaikan permintaan suatu
aktivitas untuk menampilkan gambar atau membuka halaman web. Dalam beberapa kasus, Anda bisa memulai
-aktivitas untuk menerima hasil, dalam hal ini, aktivitas juga akan mengembalikan hasil
+aktivitas untuk menerima hasil, dalam hal ini, aktivitas juga akan mengembalikan hasil
dalam {@link android.content.Intent} (misalnya Anda bisa mengeluarkan intent agar
-pengguna bisa memilih kontak pribadi dan memintanya dikembalikan kepada Anda—intent yang dikembalikan menyertakan URI yang
+pengguna bisa memilih kontak pribadi dan memintanya dikembalikan kepada Anda—intent yang dikembalikan menyertakan URI yang
menunjuk ke kontak yang dipilih).
Untuk penerima siaran, intent hanya mendefinisikan
@@ -213,18 +213,18 @@ hanya menyertakan string tindakan yang menunjukkan "baterai hampir habis").
Tipe komponen lainnya dan penyedia konten, tidak diaktifkan oleh intent. Melainkan
diaktifkan saat ditargetkan oleh permintaan dari {@link android.content.ContentResolver}. Resolver
-konten menangani semua transaksi langsung dengan penyedia konten sehingga komponen yang melakukan
+konten menangani semua transaksi langsung dengan penyedia konten sehingga komponen yang melakukan
transaksi dengan penyedia tidak perlu dan sebagai gantinya memanggil metode pada objek {@link
android.content.ContentResolver}. Ini membuat lapisan abstraksi antara penyedia
konten dan komponen yang meminta informasi (demi keamanan).
Ada beberapa metode terpisah untuk mengaktifkan masing-masing tipe komponen:
-
Anda bisa memulai aktivitas (atau memberinya pekerjaan baru) dengan
+
Anda bisa memulai aktivitas (atau memberinya pekerjaan baru) dengan
meneruskan {@link android.content.Intent} ke {@link android.content.Context#startActivity
startActivity()} atau {@link android.app.Activity#startActivityForResult startActivityForResult()}
(bila Anda ingin aktivitas mengembalikan hasil).
-
Anda bisa memulai layanan (atau memberikan instruksi baru ke layanan yang sedang berlangsung) dengan
+
Anda bisa memulai layanan (atau memberikan instruksi baru ke layanan yang sedang berlangsung) dengan
meneruskan {@link android.content.Intent} ke {@link android.content.Context#startService
startService()}. Atau Anda bisa mengikat ke layanan dengan meneruskan {@link android.content.Intent} ke
{@link android.content.Context#bindService bindService()}.
@@ -237,7 +237,7 @@ android.content.ContentProvider#query query()} pada {@link android.content.Conte
Untuk informasi selengkapnya tentang menggunakan intent, lihat dokumen Intent dan Filter
- Intent. Informasi selengkapnya tentang mengaktifkan komponen
+ Intent. Informasi selengkapnya tentang mengaktifkan komponen
tertentu juga tersedia dalam dokumen berikut: Aktivitas, Layanan, {@link
android.content.BroadcastReceiver} dan Penyedia Konten.
@@ -245,7 +245,7 @@ android.content.BroadcastReceiver} dan File Manifes
Dalam elemen <activity>,
+href="{@docRoot}guide/topics/manifest/activity-element.html"><activity>
,
atribut {@code android:name} menetapkan nama kelas yang sepenuhnya memenuhi syarat subkelas {@link
android.app.Activity} dan atribut {@code android:label} menetapkan string yang akan
digunakan sebagai label yang terlihat oleh pengguna untuk aktivitas tersebut.
@@ -310,12 +310,12 @@ penyedia konten
Aktivitas, layanan, dan penyedia konten yang Anda sertakan dalam kode sumber, namun tidak
dideklarasikan dalam manifes, tidak akan terlihat pada sistem dan, akibatnya, tidak pernah bisa berjalan. Akan tetapi,
-penerima siaran
-bisa dideklarasikan dalam manifes atau dibuat secara dinamis dalam kode (sebagai objek
+penerima siaran
+bisa dideklarasikan dalam manifes atau dibuat secara dinamis dalam kode (sebagai objek
{@link android.content.BroadcastReceiver}) dan didaftarkan pada sistem dengan memanggil
{@link android.content.Context#registerReceiver registerReceiver()}.
-
Untuk informasi selengkapnya tentang cara menstrukturkan file manifes untuk aplikasi Anda,
+
Untuk informasi selengkapnya tentang cara menstrukturkan file manifes untuk aplikasi Anda,
lihat dokumentasi File AndroidManifest.xml.
@@ -379,7 +379,7 @@ membacanya, namun layanan eksternal seperti Google Play akan membacanya untuk me
penyaringan bagi pengguna saat mereka mencari aplikasi dari perangkat.
Misalnya, jika aplikasi memerlukan kamera dan menggunakan API yang disediakan dalam Android 2.1 (API Level 7)
-, Anda harus mendeklarasikannya sebagai kebutuhan dalam file manifes seperti ini:
+, Anda harus mendeklarasikannya sebagai kebutuhan dalam file manifes seperti ini:
<manifest ... >
@@ -390,10 +390,10 @@ penyaringan bagi pengguna saat mereka mencari aplikasi dari perangkat.
</manifest>
-
Sekarang, perangkat yang tidak memiliki kamera dan menggunakan
+
Sekarang, perangkat yang tidak memiliki kamera dan menggunakan
Android versi lebih rendah dari 2.1 tidak bisa menginstal aplikasi Anda dari Google Play.
-
Akan tetapi, bisa juga mendeklarasikan bahwa aplikasi Anda menggunakan kamera, namun tidak
+
Akan tetapi, bisa juga mendeklarasikan bahwa aplikasi Anda menggunakan kamera, namun tidak
mengharuskannya. Dalam hal itu, aplikasi Anda harus mengatur atribut {@code required}
ke {@code "false"} dan memeriksa saat runtime apakah
perangkat memiliki kamera dan menonaktifkan setiap fitur kamera yang sesuai.
@@ -455,11 +455,11 @@ membuat sumber daya alternatif untuk konfigurasi perangkat berbeda, bacalah
Informasi tentang cara membuat instance kelas {@link android.app.Activity},
+
Informasi tentang cara membuat instance kelas {@link android.app.Activity},
yang menyediakan layar tersendiri dalam aplikasi bersama antarmuka pengguna.
Informasi tentang cara aplikasi Android disusun untuk memisahkan sumber daya aplikasi dari
-kode aplikasi, termasuk cara Anda bisa menyediakan sumber daya alternatif untuk
+kode aplikasi, termasuk cara Anda bisa menyediakan sumber daya alternatif untuk
konfigurasi perangkat tertentu.
@@ -468,11 +468,11 @@ konfigurasi perangkat tertentu.
Informasi tentang cara kerja Android pada berbagai tipe perangkat dan
+
Informasi tentang cara kerja Android pada berbagai tipe perangkat dan
pengenalan mengenai cara mengoptimalkan aplikasi untuk setiap perangkat atau membatasi ketersediaan aplikasi Anda untuk
perangkat berbeda.
Informasi tentang cara Android membatasi akses aplikasi pada API tertentu dengan sistem izin
+
Informasi tentang cara Android membatasi akses aplikasi pada API tertentu dengan sistem izin
yang mengharuskan persetujuan pengguna agar aplikasi dapat menggunakan API tersebut.
diff --git a/docs/html-intl/intl/in/guide/components/index.jd b/docs/html-intl/intl/in/guide/components/index.jd
index a8dd5f8820fcb..de40b22d875ec 100644
--- a/docs/html-intl/intl/in/guide/components/index.jd
+++ b/docs/html-intl/intl/in/guide/components/index.jd
@@ -1,7 +1,7 @@
page.title=Komponen Aplikasi
page.landing=true
-page.landing.intro=Kerangka kerja aplikasi Android memungkinkan Anda membuat aplikasi yang kaya dan inovatif menggunakan seperangkat komponen yang dapat digunakan kembali. Bagian ini menjelaskan cara membangun komponen yang mendefinisikan blok pembangun aplikasi Anda dan cara menghubungkannya bersama menggunakan intent.
-page.metaDescription=Kerangka kerja aplikasi Android memungkinkan Anda membuat aplikasi yang kaya dan inovatif menggunakan seperangkat komponen yang dapat digunakan kembali. Bagian ini menjelaskan cara membangun komponen yang mendefinisikan blok pembangun aplikasi Anda dan cara menghubungkannya bersama menggunakan intent.
+page.landing.intro=Kerangka kerja aplikasi Android memungkinkan Anda membuat aplikasi yang kaya dan inovatif menggunakan seperangkat komponen yang dapat digunakan kembali. Bagian ini menjelaskan cara membangun komponen yang mendefinisikan blok pembangun aplikasi Anda dan cara menghubungkannya bersama menggunakan intent.
+page.metaDescription=Kerangka kerja aplikasi Android memungkinkan Anda membuat aplikasi yang kaya dan inovatif menggunakan seperangkat komponen yang dapat digunakan kembali. Bagian ini menjelaskan cara membangun komponen yang mendefinisikan blok pembangun aplikasi Anda dan cara menghubungkannya bersama menggunakan intent.
page.landing.image=images/develop/app_components.png
page.image=images/develop/app_components.png
@@ -11,7 +11,7 @@ page.image=images/develop/app_components.png
dibuat kembali setelah perubahan konfigurasi. Karena itu, loader tidak perlu melakukan query ulang
datanya.
-
+
Rangkuman Loader API
Ada beberapa kelas dan antarmuka yang mungkin dilibatkan dalam menggunakan
@@ -64,11 +64,11 @@ loader pada aplikasi. Semuanya dirangkum dalam tabel ini:
{@link android.app.LoaderManager}
-
Kelas abstrak yang dikaitkan dengan {@link android.app.Activity} atau
+
Kelas abstrak yang dikaitkan dengan {@link android.app.Activity} atau
{@link android.app.Fragment} untuk mengelola satu atau beberapa instance {@link
android.content.Loader}. Ini membantu aplikasi mengelola
operasi berjalan lebih lama bersamaan dengan daur hidup {@link android.app.Activity}
-atau {@link android.app.Fragment}; penggunaan paling umumnya adalah dengan
+atau {@link android.app.Fragment}; penggunaan paling umumnya adalah dengan
{@link android.content.CursorLoader}, akan tetapi aplikasi bebas menulis loader-nya
sendiri untuk memuat tipe data lainnya.
@@ -97,7 +97,7 @@ baru bila konten berubah.
{@link android.content.CursorLoader}
-
Subkelas {@link android.content.AsyncTaskLoader} yang meng-query
+
Subkelas {@link android.content.AsyncTaskLoader} yang meng-query
{@link android.content.ContentResolver} dan mengembalikan {@link
android.database.Cursor}. Kelas ini mengimplementasikan protokol {@link
android.content.Loader} dengan cara standar untuk query kursor,
@@ -124,15 +124,15 @@ yang menggunakan loader biasanya berisi yang berikut ini:
{@link android.app.Activity} atau {@link android.app.Fragment}.
Instance {@link android.app.LoaderManager}.
{@link android.content.CursorLoader} akan memuat data yang didukung oleh {@link
-android.content.ContentProvider}. Atau, Anda dapat mengimplementasikan subkelas sendiri
+android.content.ContentProvider}. Atau, Anda dapat mengimplementasikan subkelas sendiri
dari {@link android.content.Loader} atau {@link android.content.AsyncTaskLoader} untuk
memuat data dari beberapa sumber lain.
Implementasi untuk {@link android.app.LoaderManager.LoaderCallbacks}.
Di sinilah Anda membuat loader baru dan mengelola acuan bagi loader
-yang ada.
+yang ada.
Cara menampilkan data loader, seperti {@link
android.widget.SimpleCursorAdapter}.
-
Sumber data, seperti {@link android.content.ContentProvider}, saat menggunakan
+
Sumber data, seperti {@link android.content.ContentProvider}, saat menggunakan
{@link android.content.CursorLoader}.
{@link android.app.LoaderManager} mengelola satu atau beberapa instance {@link
android.content.Loader} dalam {@link android.app.Activity} atau
{@link android.app.Fragment}. Hanya ada satu {@link
-android.app.LoaderManager} per aktivitas atau fragmen.
+android.app.LoaderManager} per aktivitas atau fragmen.
Anda biasanya
memulai {@link android.content.Loader} dalam metode {@link
-android.app.Activity#onCreate onCreate()} aktivitas, atau dalam metode
+android.app.Activity#onCreate onCreate()} aktivitas, atau dalam metode
{@link android.app.Fragment#onActivityCreated onActivityCreated()} fragmen. Anda
melakukannya dengan cara berikut ini:
@@ -157,13 +157,13 @@ parameter berikut:
ID unik yang mengidentifikasi loader. Dalam contoh ini, ID-nya adalah 0.
Argumen opsional untuk dipasok ke loader
-pada saat pembuatan (dalam contoh ini null).
+pada saat pembuatan (dalam contoh ini null).
Implementasi {@link android.app.LoaderManager.LoaderCallbacks}, yang
akan dipanggil {@link android.app.LoaderManager} untuk melaporkan kejadian loader. Dalam contoh
ini, kelas lokal mengimplementasikan antarmuka {@link
android.app.LoaderManager.LoaderCallbacks}, sehingga meneruskan acuan
-ke dirinya sendiri, {@code this}.
+ke dirinya sendiri, {@code this}.
Panggilan {@link android.app.LoaderManager#initLoader initLoader()} memastikan bahwa loader
telah dimulai dan aktif. Ia memiliki dua kemungkinan hasil:
@@ -193,7 +193,7 @@ masa hidup loader secara otomatis. {@link android.app.LoaderManager}
memulai dan menghentikan pemuatan jika perlu, dan menjaga status loader
dan konten terkaitnya. Seperti yang tersirat di sini, Anda akan jarang berinteraksi dengan loader
secara langsung (meskipun misalnya menggunakan metode loader untuk menyempurnakan perilaku
-loader, lihat contoh LoaderThrottle).
+loader, lihat contoh LoaderThrottle).
Anda paling sering akan menggunakan metode {@link
android.app.LoaderManager.LoaderCallbacks} untuk mengintervensi proses
pemuatan saat terjadi kejadian tertentu. Untuk diskusi selengkapnya mengenai topik ini, lihat Menggunakan Callback LoaderManager.
@@ -245,7 +245,7 @@ Membuat instance dan mengembalikan {@link android.content.Loader} baru untuk ID
— Dipanggil bila loader yang dibuat sebelumnya selesai dimuat.
{@link android.app.LoaderManager.LoaderCallbacks#onLoaderReset onLoaderReset()}
— Dipanggil bila loader yang dibuat sebelumnya sedang di-reset, sehingga datanya
tidak tersedia.
@@ -322,7 +322,7 @@ data tersebut karena loader memilikinya dan akan menanganinya.
Loader akan melepas data setelah mengetahui bahwa aplikasi tidak
lagi menggunakannya. Misalnya, jika data adalah kursor dari {@link
android.content.CursorLoader}, Anda tidak boleh memanggil {@link
-android.database.Cursor#close close()} sendiri. Jika kursor ditempatkan
+android.database.Cursor#close close()} sendiri. Jika kursor ditempatkan
dalam {@link android.widget.CursorAdapter}, Anda harus menggunakan metode {@link
android.widget.SimpleCursorAdapter#swapCursor swapCursor()} agar
{@link android.database.Cursor} lama tidak ditutup. Misalnya:
Metode ini dipanggil bila loader yang dibuat sebelumnya sedang di-reset, sehingga datanya
tidak tersedia. Callback ini memungkinkan Anda mengetahui
kapan data akan dilepas sehingga dapat menghapus acuannya ke callback.
-
Implementasi ini memanggil
+
Implementasi ini memanggil
{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}
dengan nilai null:
@@ -366,7 +366,7 @@ public void onLoaderReset(Loader<Cursor> loader) {
android.app.Fragment} yang menampilkan {@link android.widget.ListView} berisi
hasil query terhadap penyedia konten kontak. Ia menggunakan {@link
android.content.CursorLoader} untuk mengelola query pada penyedia.
-
+
Agar aplikasi dapat mengakses kontak pengguna, seperti yang ditampilkan dalam contoh ini,
manifesnya harus menyertakan izin
{@link android.Manifest.permission#READ_CONTACTS READ_CONTACTS}.
diff --git a/docs/html-intl/intl/in/guide/components/processes-and-threads.jd b/docs/html-intl/intl/in/guide/components/processes-and-threads.jd
index 44051bf492e0a..cdab715bbca84 100644
--- a/docs/html-intl/intl/in/guide/components/processes-and-threads.jd
+++ b/docs/html-intl/intl/in/guide/components/processes-and-threads.jd
@@ -25,13 +25,13 @@ page.tags=daur hidup,latar belakang
-
Bila komponen aplikasi dimulai dan tidak ada komponen aplikasi lain yang
-berjalan, sistem Android akan memulai proses Linux baru untuk aplikasi dengan satu thread
-eksekusi. Secara default, semua komponen aplikasi yang sama berjalan dalam proses dan
-thread yang sama (disebut thread "utama"). Jika komponen aplikasi dimulai dan sudah ada
-proses untuk aplikasi itu (karena komponen lain dari aplikasi itu sudah ada), maka komponen
-akan dimulai dalam proses itu dan menggunakan thread eksekusi yang sama. Akan tetapi, Anda bisa
-mengatur komponen berbeda di aplikasi agar berjalan di proses terpisah, dan Anda bisa membuat thread tambahan untuk
+
Bila komponen aplikasi dimulai dan tidak ada komponen aplikasi lain yang
+berjalan, sistem Android akan memulai proses Linux baru untuk aplikasi dengan satu thread
+eksekusi. Secara default, semua komponen aplikasi yang sama berjalan dalam proses dan
+thread yang sama (disebut thread "utama"). Jika komponen aplikasi dimulai dan sudah ada
+proses untuk aplikasi itu (karena komponen lain dari aplikasi itu sudah ada), maka komponen
+akan dimulai dalam proses itu dan menggunakan thread eksekusi yang sama. Akan tetapi, Anda bisa
+mengatur komponen berbeda di aplikasi agar berjalan di proses terpisah, dan Anda bisa membuat thread tambahan untuk
setiap proses.
Dokumen ini membahas cara kerja proses dan thread di aplikasi Android.
@@ -39,7 +39,7 @@ setiap proses.
Proses
-
Secara default, semua komponen aplikasi yang sama berjalan dalam proses yang sama dan kebanyakan
+
Secara default, semua komponen aplikasi yang sama berjalan dalam proses yang sama dan kebanyakan
aplikasi tidak boleh mengubah ini. Akan tetapi, jika Anda merasa perlu mengontrol proses milik
komponen tertentu, Anda dapat melakukannya dalam file manifes.
@@ -47,54 +47,54 @@ komponen tertentu, Anda dapat melakukannya dalam file manifes.
<activity>}, {@code
<service>}, {@code
<receiver>}, dan {@code
-<provider>}—mendukung atribut {@code android:process} yang bisa menetapkan
-dalam proses mana komponen harus dijalankan. Anda bisa mengatur atribut ini agar setiap komponen
+<provider>}—mendukung atribut {@code android:process} yang bisa menetapkan
+dalam proses mana komponen harus dijalankan. Anda bisa mengatur atribut ini agar setiap komponen
berjalan dalam prosesnya sendiri atau agar beberapa komponen menggunakan proses yang sama sementara yang lainnya tidak. Anda juga bisa mengatur
{@code android:process} agar komponen aplikasi yang berbeda berjalan dalam proses yang sama
-—sepanjang aplikasi menggunakan ID Linux yang sama dan ditandatangani
+—sepanjang aplikasi menggunakan ID Linux yang sama dan ditandatangani
dengan sertifikat yang sama.
Elemen {@code
-<application>} juga mendukung atribut {@code android:process}, untuk mengatur
+<application>} juga mendukung atribut {@code android:process}, untuk mengatur
nilai default yang berlaku bagi semua komponen.
-
Android bisa memutuskan untuk mematikan proses pada waktu tertentu, bila memori tinggal sedikit dan diperlukan oleh
+
Android bisa memutuskan untuk mematikan proses pada waktu tertentu, bila memori tinggal sedikit dan diperlukan oleh
proses lain yang lebih mendesak untuk melayani pengguna. Komponen
-aplikasi yang berjalan dalam proses yang dimatikan maka sebagai konsekuensinya juga akan dimusnahkan. Proses dimulai
+aplikasi yang berjalan dalam proses yang dimatikan maka sebagai konsekuensinya juga akan dimusnahkan. Proses dimulai
kembali untuk komponen itu bila ada lagi pekerjaan untuk mereka lakukan.
Saat memutuskan proses yang akan dimatikan, sistem Android akan mempertimbangkan kepentingan relatifnya bagi
pengguna. Misalnya, sistem lebih mudah menghentikan proses yang menjadi host aktivitas yang tidak
- lagi terlihat di layar, dibandingkan dengan proses yang menjadi host aktivitas yang terlihat. Karena itu, keputusan
+ lagi terlihat di layar, dibandingkan dengan proses yang menjadi host aktivitas yang terlihat. Karena itu, keputusan
untuk menghentikan proses bergantung pada keadaan komponen yang berjalan dalam proses tersebut. Aturan
yang digunakan untuk menentukan proses yang akan dihentikan dibahas di bawah ini.
Daur hidup proses
-
Sistem Android mencoba mempertahankan proses aplikasi selama mungkin, namun
+
Sistem Android mencoba mempertahankan proses aplikasi selama mungkin, namun
pada akhirnya perlu menghapus proses lama untuk mengambil kembali memori bagi proses baru atau yang lebih penting. Untuk
menentukan proses yang akan
-dipertahankan dan yang harus dimatikan, sistem menempatkan setiap proses ke dalam "hierarki prioritas" berdasarkan
-komponen yang berjalan dalam proses dan status komponen tersebut. Proses yang memiliki
+dipertahankan dan yang harus dimatikan, sistem menempatkan setiap proses ke dalam "hierarki prioritas" berdasarkan
+komponen yang berjalan dalam proses dan status komponen tersebut. Proses yang memiliki
prioritas terendah akan dimatikan terlebih dahulu, kemudian yang terendah berikutnya, dan seterusnya, jika perlu
untuk memulihkan sumber daya sistem.
-
Ada lima tingkatan dalam hierarki prioritas. Daftar berikut berisi beberapa
-tipe proses berdasarkan urutan prioritas (proses pertama adalah yang terpenting dan
+
Ada lima tingkatan dalam hierarki prioritas. Daftar berikut berisi beberapa
+tipe proses berdasarkan urutan prioritas (proses pertama adalah yang terpenting dan
dimatikan terakhir):
Proses latar depan
-
Proses yang diperlukan untuk aktivitas yang sedang dilakukan pengguna. Proses
+
Proses yang diperlukan untuk aktivitas yang sedang dilakukan pengguna. Proses
dianggap berada di latar depan jika salah satu kondisi berikut terpenuhi:
Proses menjadi host {@link android.app.Activity} yang berinteraksi dengan pengguna dengan metode ({@link
-android.app.Activity}{@link android.app.Activity#onResume onResume()} telah
+android.app.Activity}{@link android.app.Activity#onResume onResume()} telah
dipanggil).
-
Proses menjadi host {@link android.app.Service} yang terikat dengan aktivitas yang sedang berinteraksi dengan
+
Proses menjadi host {@link android.app.Service} yang terikat dengan aktivitas yang sedang berinteraksi dengan
pengguna.
Proses menjadi host {@link android.app.Service} yang berjalan "di latar depan"—
@@ -108,23 +108,23 @@ onStart()}, atau {@link android.app.Service#onDestroy onDestroy()}).
Secara umum, hanya ada beberapa proses latar depan pada waktu yang diberikan. Proses dimatikan hanya sebagai
-upaya terakhir— jika memori hampir habis sehingga semuanya tidak bisa terus berjalan. Pada umumnya, pada
-titik itu, perangkat dalam keadaan memory paging, sehingga menghentikan beberapa proses latar depan
+
Secara umum, hanya ada beberapa proses latar depan pada waktu yang diberikan. Proses dimatikan hanya sebagai
+upaya terakhir— jika memori hampir habis sehingga semuanya tidak bisa terus berjalan. Pada umumnya, pada
+titik itu, perangkat dalam keadaan memory paging, sehingga menghentikan beberapa proses latar depan
diperlukan agar antarmuka pengguna tetap responsif.
Proses yang terlihat
-
Proses yang tidak memiliki komponen latar depan, namun masih bisa
-memengaruhi apa yang dilihat pengguna di layar. Proses dianggap terlihat jika salah satu kondisi
+
Proses yang tidak memiliki komponen latar depan, namun masih bisa
+memengaruhi apa yang dilihat pengguna di layar. Proses dianggap terlihat jika salah satu kondisi
berikut terpenuhi:
Proses ini menjadi host {@link android.app.Activity} yang tidak berada di latar depan, namun masih
-terlihat oleh penggunanya (metode {@link android.app.Activity#onPause onPause()} telah dipanggil).
-Ini bisa terjadi, misalnya, jika aktivitas latar depan memulai dialog, sehingga
+terlihat oleh penggunanya (metode {@link android.app.Activity#onPause onPause()} telah dipanggil).
+Ini bisa terjadi, misalnya, jika aktivitas latar depan memulai dialog, sehingga
aktivitas sebelumnya terlihat berada di belakangnya.
-
Proses menjadi host {@link android.app.Service} yang terikat dengan aktivitas yang terlihat (atau latar
+
Proses menjadi host {@link android.app.Service} yang terikat dengan aktivitas yang terlihat (atau latar
depan)
@@ -134,53 +134,53 @@ diperlukan agar semua proses latar depan tetap berjalan.
Proses layanan
Proses yang menjalankan layanan yang telah dimulai dengan metode {@link
-android.content.Context#startService startService()} dan tidak termasuk dalam salah satu dari dua kategori
-yang lebih tinggi. Walaupun proses pelayanan tidak langsung terkait dengan semua yang dilihat oleh pengguna, proses ini
-umumnya melakukan hal-hal yang dipedulikan pengguna (seperti memutar musik di latar belakang
-atau mengunduh data di jaringan), jadi sistem membuat proses tetap berjalan kecuali memori tidak cukup untuk
+android.content.Context#startService startService()} dan tidak termasuk dalam salah satu dari dua kategori
+yang lebih tinggi. Walaupun proses pelayanan tidak langsung terkait dengan semua yang dilihat oleh pengguna, proses ini
+umumnya melakukan hal-hal yang dipedulikan pengguna (seperti memutar musik di latar belakang
+atau mengunduh data di jaringan), jadi sistem membuat proses tetap berjalan kecuali memori tidak cukup untuk
mempertahankannya bersama semua proses latar depan dan proses yang terlihat.
Proses latar belakang
-
Proses yang menampung aktivitas yang saat ini tidak terlihat oleh pengguna (metode
-{@link android.app.Activity#onStop onStop()} aktivitas telah dipanggil). Proses ini tidak memiliki dampak
-langsung pada pengalaman pengguna, dan sistem bisa menghentikannya kapan saja untuk memperoleh kembali memori bagi
-proses latar depan, proses yang terlihat,
-atau proses layanan. Biasanya ada banyak proses latar belakang yang berjalan, sehingga disimpan
-dalam daftar LRU (least recently used atau paling sedikit digunakan) untuk memastikan bahwa proses dengan aktivitas yang paling baru
+
Proses yang menampung aktivitas yang saat ini tidak terlihat oleh pengguna (metode
+{@link android.app.Activity#onStop onStop()} aktivitas telah dipanggil). Proses ini tidak memiliki dampak
+langsung pada pengalaman pengguna, dan sistem bisa menghentikannya kapan saja untuk memperoleh kembali memori bagi
+proses latar depan, proses yang terlihat,
+atau proses layanan. Biasanya ada banyak proses latar belakang yang berjalan, sehingga disimpan
+dalam daftar LRU (least recently used atau paling sedikit digunakan) untuk memastikan bahwa proses dengan aktivitas yang paling baru
terlihat oleh pengguna sebagai yang terakhir untuk dimatikan. Jika aktivitas mengimplementasikan metode
- daur hidupnya dengan benar, dan menyimpan statusnya saat ini, menghentikan prosesnya tidak akan memiliki efek
-yang terlihat pada pengalaman pengguna, karena ketika pengguna kembali ke aktivitas, aktivitas itu memulihkan
+ daur hidupnya dengan benar, dan menyimpan statusnya saat ini, menghentikan prosesnya tidak akan memiliki efek
+yang terlihat pada pengalaman pengguna, karena ketika pengguna kembali ke aktivitas, aktivitas itu memulihkan
semua statusnya yang terlihat. Lihat dokumen Aktivitas
untuk mendapatkan informasi tentang menyimpan dan memulihkan status.
Proses kosong
-
Sebuah proses yang tidak berisi komponen aplikasi aktif apa pun. Alasan satu-satunya mempertahankan proses
+
Sebuah proses yang tidak berisi komponen aplikasi aktif apa pun. Alasan satu-satunya mempertahankan proses
seperti ini tetap hidup adalah untuk keperluan caching, meningkatkan waktu mulai (startup) bila
-nanti komponen perlu dijalankan di dalamnya. Sistem sering menghentikan proses ini untuk menyeimbangkan sumber
+nanti komponen perlu dijalankan di dalamnya. Sistem sering menghentikan proses ini untuk menyeimbangkan sumber
daya sistem secara keseluruhan antara proses cache dan cache kernel yang mendasarinya.
Android sebisa mungkin memeringkat proses setinggi
-mungkin, berdasarkan prioritas komponen yang sedang aktif dalam proses. Misalnya, jika suatu proses menjadi host sebuah layanan dan
+mungkin, berdasarkan prioritas komponen yang sedang aktif dalam proses. Misalnya, jika suatu proses menjadi host sebuah layanan dan
aktivitas yang terlihat, proses akan diperingkat sebagai proses yang terlihat, bukan sebagai proses layanan.
Selain itu, peringkat proses dapat meningkat karena adanya proses lain yang bergantung padanya
-—proses yang melayani proses lain tidak bisa diperingkat lebih rendah daripada proses yang
-sedang dilayaninya. Misalnya, jika penyedia konten dalam proses A melayani klien dalam proses B, atau
-jika layanan dalam proses A terikat dengan komponen dalam proses B, proses A selalu dipertimbangkan sebagai paling rendah
+—proses yang melayani proses lain tidak bisa diperingkat lebih rendah daripada proses yang
+sedang dilayaninya. Misalnya, jika penyedia konten dalam proses A melayani klien dalam proses B, atau
+jika layanan dalam proses A terikat dengan komponen dalam proses B, proses A selalu dipertimbangkan sebagai paling rendah
prioritasnya dibandingkan dengan proses B.
-
Karena proses yang menjalankan layanan diperingkat lebih tinggi daripada aktivitas latar belakang,
-aktivitas yang memulai operasi yang berjalan lama mungkin lebih baik memulai layanan untuk operasi itu, daripada hanya
+
Karena proses yang menjalankan layanan diperingkat lebih tinggi daripada aktivitas latar belakang,
+aktivitas yang memulai operasi yang berjalan lama mungkin lebih baik memulai layanan untuk operasi itu, daripada hanya
membuat thread pekerja—khususnya jika operasi mungkin akan berlangsung lebih lama daripada aktivitas.
- Misalnya, aktivitas yang mengunggah gambar ke situs web harus memulai layanan
+ Misalnya, aktivitas yang mengunggah gambar ke situs web harus memulai layanan
untuk mengunggah sehingga unggahan bisa terus berjalan di latar belakang meskipun pengguna meninggalkan aktivitas tersebut.
-Menggunakan layanan akan memastikan operasi paling tidak memiliki prioritas "proses layanan",
-apa pun yang terjadi pada aktivitas. Ini menjadi alasan yang sama yang membuat penerima siaran harus
+Menggunakan layanan akan memastikan operasi paling tidak memiliki prioritas "proses layanan",
+apa pun yang terjadi pada aktivitas. Ini menjadi alasan yang sama yang membuat penerima siaran harus
menjalankan layanan daripada hanya menempatkan operasi yang menghabiskan waktu di thread.
@@ -188,35 +188,35 @@ menjalankan layanan daripada hanya menempatkan operasi yang menghabiskan waktu d
Thread
-
Bila aplikasi diluncurkan, sistem akan membuat thread eksekusi untuk aplikasi tersebut, yang diberi nama,
+
Bila aplikasi diluncurkan, sistem akan membuat thread eksekusi untuk aplikasi tersebut, yang diberi nama,
"main". Thread ini sangat penting karena bertugas mengirim kejadian ke widget
antarmuka pengguna yang sesuai, termasuk kejadian menggambar. Ini juga merupakan thread yang
membuat aplikasi berinteraksi dengan komponen dari Android UI toolkit (komponen dari paket {@link
-android.widget} dan {@link android.view}). Karena itu, thread 'main' juga terkadang
+android.widget} dan {@link android.view}). Karena itu, thread 'main' juga terkadang
disebut thread UI.
-
Sistem ini tidak membuat thread terpisah untuk setiap instance komponen. Semua
-komponen yang berjalan di proses yang sama akan dibuat instance-nya dalam thread UI, dan sistem akan memanggil
+
Sistem ini tidak membuat thread terpisah untuk setiap instance komponen. Semua
+komponen yang berjalan di proses yang sama akan dibuat instance-nya dalam thread UI, dan sistem akan memanggil
setiap komponen yang dikirim dari thread itu. Akibatnya, metode yang merespons callback sistem
(seperti {@link android.view.View#onKeyDown onKeyDown()} untuk melaporkan tindakan pengguna atau metode callback daur hidup)
selalu berjalan di thread UI proses.
-
Misalnya saat pengguna menyentuh tombol pada layar, thread UI aplikasi akan mengirim kejadian
-sentuh ke widget, yang selanjutnya menetapkan status ditekan dan mengirim permintaan yang tidak divalidasi ke
+
Misalnya saat pengguna menyentuh tombol pada layar, thread UI aplikasi akan mengirim kejadian
+sentuh ke widget, yang selanjutnya menetapkan status ditekan dan mengirim permintaan yang tidak divalidasi ke
antrean kejadian. Thread UI akan menghapus antrean permintaan dan memberi tahu widget bahwa widget harus menggambar
dirinya sendiri.
-
Saat aplikasi melakukan pekerjaan intensif sebagai respons terhadap interaksi pengguna, model
+
Saat aplikasi melakukan pekerjaan intensif sebagai respons terhadap interaksi pengguna, model
thread tunggal ini bisa menghasilkan kinerja yang buruk kecuali jika Anda mengimplementasikan aplikasi dengan benar. Khususnya jika
semua terjadi di thread UI, melakukan operasi yang panjang seperti akses ke jaringan atau query
database akan memblokir seluruh UI. Bila thread diblokir, tidak ada kejadian yang bisa dikirim,
-termasuk kejadian menggambar. Dari sudut pandang pengguna, aplikasi
+termasuk kejadian menggambar. Dari sudut pandang pengguna, aplikasi
tampak mogok (hang). Lebih buruk lagi, jika thread UI diblokir selama lebih dari beberapa detik
(saat ini sekitar 5 detik) pengguna akan ditampilkan dialog "aplikasi tidak
-merespons" (ANR) yang populer karena reputasi buruknya. Pengguna nanti bisa memutuskan untuk keluar dari aplikasi dan menghapus aplikasi
+merespons" (ANR) yang populer karena reputasi buruknya. Pengguna nanti bisa memutuskan untuk keluar dari aplikasi dan menghapus aplikasi
jika mereka tidak suka.
-
Selain itu, toolkit Android UI bukan thread-safe. Jadi, Anda tidak harus memanipulasi
+
Selain itu, toolkit Android UI bukan thread-safe. Jadi, Anda tidak harus memanipulasi
UI dari thread pekerja—Anda harus melakukan semua manipulasi pada antarmuka pengguna dari thread
UI. Sehingga hanya ada dua aturan untuk model thread tunggal Android:
@@ -227,12 +227,12 @@ UI. Sehingga hanya ada dua aturan untuk model thread tunggal Android:
Thread pekerja
-
Karena model thread tunggal yang dijelaskan di atas, Anda dilarang memblokir thread
+
Karena model thread tunggal yang dijelaskan di atas, Anda dilarang memblokir thread
UI demi daya respons UI aplikasi. Jika memiliki operasi untuk dijalankan
yang tidak seketika, Anda harus memastikan untuk melakukannya di thread terpisah (thread "latar belakang" atau
thread "pekerja").
-
Misalnya, berikut ini beberapa kode untuk listener klik yang mengunduh gambar dari
+
Misalnya, berikut ini beberapa kode untuk listener klik yang mengunduh gambar dari
thread terpisah dan menampilkannya dalam {@link android.widget.ImageView}:
@@ -246,13 +246,13 @@ public void onClick(View v) {
}
-
Awalnya hal ini tampak bekerja dengan baik, karena menciptakan thread baru untuk menangani
+
Awalnya hal ini tampak bekerja dengan baik, karena menciptakan thread baru untuk menangani
operasi jaringan. Akan tetapi, hal tersebut melanggar aturan kedua model thread tunggal: jangan mengakses
toolkit Android UI dari luar thread UI—sampel ini memodifikasi {@link
android.widget.ImageView} dari thread pekerja sebagai ganti thread UI. Ini bisa
mengakibatkan perilaku yang tidak terdefinisi dan tidak diharapkan, yang bisa menyulitkan dan menghabiskan waktu untuk melacaknya.
-
Untuk memperbaiki masalah ini, Android menawarkan beberapa cara untuk mengakses thread UI dari
+
Untuk memperbaiki masalah ini, Android menawarkan beberapa cara untuk mengakses thread UI dari
thread lainnya. Berikut ini daftar metode yang bisa membantu:
@@ -284,10 +284,10 @@ public void onClick(View v) {
Kini implementasi ini thread-safe: operasi jaringan dilakukan terpisah dari thread
sementara {@link android.widget.ImageView} dimanipulasi dari thread UI.
-
Akan tetapi, karena operasi semakin kompleks, jenis kode seperti ini bisa semakin rumit
-dan sulit dipertahankan. Untuk menangani interaksi yang lebih kompleks dengan thread pekerja, Anda bisa mempertimbangkan
+
Akan tetapi, karena operasi semakin kompleks, jenis kode seperti ini bisa semakin rumit
+dan sulit dipertahankan. Untuk menangani interaksi yang lebih kompleks dengan thread pekerja, Anda bisa mempertimbangkan
penggunaan {@link android.os.Handler}di thread pekerja, untuk memproses pesan yang dikirim dari
- thread UI. Mungkin solusi terbaiknya adalah memperpanjang kelas {@link android.os.AsyncTask},
+ thread UI. Mungkin solusi terbaiknya adalah memperpanjang kelas {@link android.os.AsyncTask},
yang akan menyederhanakan eksekusi tugas-tugas thread pekerja yang perlu berinteraksi dengan UI.
@@ -298,10 +298,10 @@ pengguna. AsyncTask memblokir operasi di thread pekerja kemudian mempublikasikan
di thread UI, tanpa mengharuskan Anda untuk menangani sendiri thread dan/atau handler sendiri.
Untuk menggunakannya, Anda harus menempatkan {@link android.os.AsyncTask} sebagai subkelas dan mengimplementasikan metode callback {@link
-android.os.AsyncTask#doInBackground doInBackground()} yang berjalan di kumpulan
+android.os.AsyncTask#doInBackground doInBackground()} yang berjalan di kumpulan
thread latar belakang. Untuk memperbarui UI, Anda harus mengimplementasikan {@link
android.os.AsyncTask#onPostExecute onPostExecute()}, yang memberikan hasil dari {@link
-android.os.AsyncTask#doInBackground doInBackground()} dan berjalan di thread UI, jadi Anda bisa
+android.os.AsyncTask#doInBackground doInBackground()} dan berjalan di thread UI, jadi Anda bisa
memperbarui UI dengan aman. Selanjutnya Anda bisa menjalankan tugas dengan memanggil {@link android.os.AsyncTask#execute execute()}
dari thread UI.
@@ -319,7 +319,7 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
protected Bitmap doInBackground(String... urls) {
return loadImageFromNetwork(urls[0]);
}
-
+
/** The system calls this to perform work in the UI thread and delivers
* the result from doInBackground() */
protected void onPostExecute(Bitmap result) {
@@ -328,16 +328,16 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
}
-
Kini UI aman dan kode jadi lebih sederhana, karena memisahkan pekerjaan ke
+
Kini UI aman dan kode jadi lebih sederhana, karena memisahkan pekerjaan ke
dalam bagian-bagian yang harus dilakukan pada thread pekerja dan thread UI.
-
Anda harus membaca acuan {@link android.os.AsyncTask} untuk memahami sepenuhnya
+
Anda harus membaca acuan {@link android.os.AsyncTask} untuk memahami sepenuhnya
cara menggunakan kelas ini, namun berikut ini ikhtisar singkat cara kerjanya:
Anda bisa menetapkan tipe parameter, nilai kemajuan, dan nilai
akhir tugas, dengan menggunakan generik
-
Metode {@link android.os.AsyncTask#doInBackground doInBackground()} berjalan secara otomatis pada
+
Metode {@link android.os.AsyncTask#doInBackground doInBackground()} berjalan secara otomatis pada
thread pekerja
{@link android.os.AsyncTask#onPreExecute onPreExecute()}, {@link
android.os.AsyncTask#onPostExecute onPostExecute()}, dan {@link
@@ -352,23 +352,23 @@ android.os.AsyncTask#onProgressUpdate onProgressUpdate()} pada thread UI
Perhatian: Masalah lain yang mungkin Anda temui saat menggunakan
thread pekerja adalah restart tak terduga dalam aktivitas karena perubahan konfigurasi runtime
- (seperti saat pengguna mengubah orientasi layar), yang bisa memusnahkan thread pekerja. Untuk
-melihat cara mempertahankan tugas selama restart ini dan cara membatalkan
+ (seperti saat pengguna mengubah orientasi layar), yang bisa memusnahkan thread pekerja. Untuk
+melihat cara mempertahankan tugas selama restart ini dan cara membatalkan
tugas dengan benar saat aktivitas dimusnahkan, lihat kode sumber untuk aplikasi sampel Shelves.
Metode thread-safe
-
Dalam beberapa situasi, metode yang Anda implementasikan bisa dipanggil dari lebih dari satu thread,
+
Dalam beberapa situasi, metode yang Anda implementasikan bisa dipanggil dari lebih dari satu thread,
dan karena itu harus ditulis agar menjadi thread-safe.
-
Ini terutama terjadi untuk metode yang bisa dipanggil dari jauh —seperti metode dalam layanan terikat. Bila sebuah panggilan pada
-metode yang dijalankan dalam {@link android.os.IBinder} berasal dari proses yang sama di mana
+
Ini terutama terjadi untuk metode yang bisa dipanggil dari jauh —seperti metode dalam layanan terikat. Bila sebuah panggilan pada
+metode yang dijalankan dalam {@link android.os.IBinder} berasal dari proses yang sama di mana
{@link android.os.IBinder IBinder} berjalan, metode ini akan dieksekusi di thread pemanggil.
Akan tetapi, bila panggilan berasal proses lain, metode akan dieksekusi dalam thread yang dipilih dari
kumpulan (pool) thread yang dipertahankan sistem dalam proses yang sama seperti{@link android.os.IBinder
-IBinder} (tidak dieksekusi dalam thread UI proses). Misalnya, karena metode
-{@link android.app.Service#onBind onBind()} layanan akan dipanggil dari thread UI
+IBinder} (tidak dieksekusi dalam thread UI proses). Misalnya, karena metode
+{@link android.app.Service#onBind onBind()} layanan akan dipanggil dari thread UI
proses layanan, metode yang diimplementasikan dalam objek yang dikembalikan {@link android.app.Service#onBind
onBind()} (misalnya, subkelas yang mengimplementasikan metode RPC) akan dipanggil dari thread
di pool. Karena layanan bisa memiliki lebih dari satu klien, maka lebih dari satu pool thread bisa melibatkan
@@ -382,19 +382,19 @@ android.content.ContentProvider} yang merespons permintaan itu—metode {@li
android.content.ContentProvider#query query()}, {@link android.content.ContentProvider#insert
insert()}, {@link android.content.ContentProvider#delete delete()}, {@link
android.content.ContentProvider#update update()}, dan {@link android.content.ContentProvider#getType
-getType()}— dipanggil dari pool thread pada proses penyedia konten, bukan thread UI
-untuk proses tersebut. Mengingat metode ini bisa dipanggil dari thread mana pun
+getType()}— dipanggil dari pool thread pada proses penyedia konten, bukan thread UI
+untuk proses tersebut. Mengingat metode ini bisa dipanggil dari thread mana pun
sekaligus, metode-metode ini juga harus diimplementasikan sebagai thread-safe.
Komunikasi Antarproses
Android menawarkan mekanisme komunikasi antarproses (IPC) menggunakan panggilan prosedur jauh
- (RPC), yang mana metode ini dipanggil oleh aktivitas atau komponen aplikasi lain, namun dieksekusi dari
+ (RPC), yang mana metode ini dipanggil oleh aktivitas atau komponen aplikasi lain, namun dieksekusi dari
jauh (di proses lain), bersama hasil yang dikembalikan ke
-pemanggil. Ini mengharuskan penguraian panggilan metode dan datanya ke tingkat yang bisa
-dipahami sistem operasi, mentransmisikannya dari proses lokal dan ruang alamat untuk proses jauh
-dan ruang proses, kemudian merakit kembali dan menetapkannya kembali di sana. Nilai-nilai yang dikembalikan
+pemanggil. Ini mengharuskan penguraian panggilan metode dan datanya ke tingkat yang bisa
+dipahami sistem operasi, mentransmisikannya dari proses lokal dan ruang alamat untuk proses jauh
+dan ruang proses, kemudian merakit kembali dan menetapkannya kembali di sana. Nilai-nilai yang dikembalikan
akan ditransmisikan dalam arah berlawanan. Android menyediakan semua kode untuk melakukan transaksi IPC
ini, sehingga Anda bisa fokus pada pendefinisian dan implementasi antarmuka pemrograman RPC.
diff --git a/docs/html-intl/intl/in/guide/components/recents.jd b/docs/html-intl/intl/in/guide/components/recents.jd
index dcfcda7a7d5f9..286fdc12732eb 100644
--- a/docs/html-intl/intl/in/guide/components/recents.jd
+++ b/docs/html-intl/intl/in/guide/components/recents.jd
@@ -60,23 +60,23 @@ layar ikhtisar. Selain itu, atribut Menambahkan Tugas ke Layar Ikhtisar
Bila membuat dokumen baru untuk aktivitas, Anda memanggil metode
+
Bila membuat dokumen baru untuk aktivitas, Anda memanggil metode
{@link android.app.ActivityManager.AppTask#startActivity(android.content.Context, android.content.Intent, android.os.Bundle) startActivity()}
- dari kelas {@link android.app.ActivityManager.AppTask}, dengan meneruskannya ke intent yang
+ dari kelas {@link android.app.ActivityManager.AppTask}, dengan meneruskannya ke intent yang
menjalankan aktivitas tersebut. Untuk menyisipkan jeda logis agar sistem memperlakukan aktivitas Anda sebagai tugas
-baru di layar ikhtisar, teruskan flag {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
+baru di layar ikhtisar, teruskan flag {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
dalam metode {@link android.content.Intent#addFlags(int) addFlags()} dari {@link android.content.Intent}
yang memulai aktivitas itu.
Catatan: Flag {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
-menggantikan flag {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET},
+menggantikan flag {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET},
yang tidak digunakan lagi pada Android 5.0 (API level 21).
Jika Anda menetapkan flag {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} saat membuat
@@ -169,18 +169,18 @@ bila pengguna membuka dokumen dengan aplikasi:
"{@code none”}"
Aktivitas ini tidak membuat tugas baru untuk dokumen. Layar ikhtisar memperlakukan
- aktivitas seperti itu secara default: satu tugas ditampilkan untuk aplikasi, yang
+ aktivitas seperti itu secara default: satu tugas ditampilkan untuk aplikasi, yang
dilanjutkan dari aktivitas apa pun yang terakhir dipanggil pengguna.
"{@code never}"
Aktivitas ini tidak membuat tugas baru untuk dokumen. Mengatur nilai ini akan mengesampingkan
perilaku flag {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
- dan {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}, jika salah satunya ditetapkan di
+ dan {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}, jika salah satunya ditetapkan di
intent, dan layar ikhtisar menampilkan satu tugas untuk aplikasi, yang dilanjutkan dari
aktivitas apa pun yang terakhir dipanggil pengguna.
-
Catatan: Untuk nilai selain {@code none} dan {@code never},
+
Catatan: Untuk nilai selain {@code none} dan {@code never},
aktivitas harus didefinisikan dengan {@code launchMode="standard"}. Jika atribut ini tidak ditetapkan, maka
{@code documentLaunchMode="none"} akan digunakan.
@@ -219,8 +219,8 @@ public void onRemoveFromRecents(View view) {
Catatan: Penggunaan metode
-{@link android.app.ActivityManager.AppTask#finishAndRemoveTask() finishAndRemoveTask()}
-akan mengesampingkan penggunaan tag {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS}, seperti
+{@link android.app.ActivityManager.AppTask#finishAndRemoveTask() finishAndRemoveTask()}
+akan mengesampingkan penggunaan tag {@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS}, seperti
dibahas di bawah ini.
Mempertahankan tugas yang telah selesai
diff --git a/docs/html-intl/intl/in/guide/components/services.jd b/docs/html-intl/intl/in/guide/components/services.jd
index 7ecd8cd38db92..b36e5656b0eaa 100644
--- a/docs/html-intl/intl/in/guide/components/services.jd
+++ b/docs/html-intl/intl/in/guide/components/services.jd
@@ -186,7 +186,7 @@ dari komponen aplikasi lain.
aplikasi Anda.
@@ -539,7 +539,7 @@ layanan tersebut harus berhenti sendiri dengan memanggil {@link android.app.Serv
komponen lain bisa menghentikannya dengan memanggil {@link android.content.Context#stopService stopService()}.
Setelah diminta untuk berhenti dengan {@link android.app.Service#stopSelf stopSelf()} atau {@link
-android.content.Context#stopService stopService()}, sistem akan menghapus layanan
+android.content.Context#stopService stopService()}, sistem akan menghapus layanan
secepatnya.
Akan tetapi, bila layanan Anda menangani beberapa permintaan ke {@link
diff --git a/docs/html-intl/intl/in/guide/components/tasks-and-back-stack.jd b/docs/html-intl/intl/in/guide/components/tasks-and-back-stack.jd
index 279442f2ab381..4c344ae126aec 100644
--- a/docs/html-intl/intl/in/guide/components/tasks-and-back-stack.jd
+++ b/docs/html-intl/intl/in/guide/components/tasks-and-back-stack.jd
@@ -29,7 +29,7 @@ parent.link=activities.html
@@ -52,7 +52,7 @@ dikirim, aktivitas Anda akan dilanjutkan dan seolah-olah aktivitas email adalah
aktivitas mungkin dari aplikasi yang berbeda, Android akan tetap mempertahankan pengalaman pengguna yang mulus
dengan menjalankan kedua aktivitas dalam tugas yang sama.
-
Tugas adalah kumpulan aktivitas yang berinteraksi dengan pengguna
+
Tugas adalah kumpulan aktivitas yang berinteraksi dengan pengguna
saat melakukan pekerjaan tertentu. Aktivitas tersebut diatur dalam tumpukan (back-stack), dalam
urutan membuka setiap aktivitas.
@@ -93,7 +93,7 @@ tidak pernah disusun ulang, hanya didorong dan dikeluarkan dari back-stack&mdash
aktivitas saat ini dan dikeluarkan bila pengguna meninggalkannya menggunakan tombol Back. Dengan demikian,
back-stack
beroperasi sebagai struktur objek "masuk terakhir, keluar pertama". Gambar 1 melukiskan perilaku
-ini dengan jangka waktu yang menunjukkan kemajuan antar aktivitas beserta
+ini dengan jangka waktu yang menunjukkan kemajuan antar aktivitas beserta
back-stack pada setiap waktu.
@@ -148,7 +148,7 @@ pengguna untuk memulai aktivitas tertentu dari lebih dari satu aktivitas, instan
aktivitas tersebut akan dibuat dan didorong ke back-stack (bukannya memunculkan instance sebelumnya dari
aktivitas ke atas). Dengan demikian, satu aktivitas pada aplikasi Anda mungkin dibuat beberapa
kali (bahkan dari beberapa tugas), seperti yang ditampilkan dalam gambar 3. Dengan demikian, jika pengguna mengarahkan mundur
-menggunakan tombol Back, setiap instance aktivitas ini akan ditampilkan dalam urutan saat
+menggunakan tombol Back, setiap instance aktivitas ini akan ditampilkan dalam urutan saat
dibuka (masing-masing
dengan status UI sendiri). Akan tetapi, Anda bisa memodifikasi perilaku ini jika tidak ingin aktivitas
dibuat instance-nya lebih dari sekali. Caranya dibahas di bagian selanjutnya tentang Mengelola Tugas.
@@ -347,7 +347,7 @@ aktivitas apa pun yang dimulai dengan ini akan dibuka di tugas yang terpisah.{@code <activity>}
.
Ini berarti bahwa jika aplikasi Anda mengeluarkan
intent untuk membuka Browser Android, aktivitasnya tidak akan ditempatkan dalam tugas
-yang sama seperti aplikasi Anda. Sebagai gantinya, tugas baru akan dimulai untuk Browser atau, jika Browser
+yang sama seperti aplikasi Anda. Sebagai gantinya, tugas baru akan dimulai untuk Browser atau, jika Browser
sudah memiliki tugas yang berjalan di latar belakang, tugas tersebut akan dimajukan untuk menangani intent
baru.
@@ -387,13 +387,13 @@ adalah:
Memulai aktivitas dalam tugas baru. Jika tugas sudah dijalankan untuk aktivitas yang sekarang
Anda mulai, tugas tersebut akan dibawa ke latar depan dengan status terakhir yang dipulihkan dan aktivitas
akan menerima intent baru dalam {@link android.app.Activity#onNewIntent onNewIntent()}.
-
Ini menghasilkan perilaku yang sama dengan nilai {@code "singleTask"} {@code launchMode}
+
Ini menghasilkan perilaku yang sama dengan nilai {@code "singleTask"} {@code launchMode}
yang dibahas di bagian sebelumnya.
Jika aktivitas yang dimulai adalah aktivitas saat ini (di bagian teratas back-stack), maka
instance yang ada akan menerima panggilan ke {@link android.app.Activity#onNewIntent onNewIntent()}
sebagai ganti membuat instance baru aktivitas.
-
Ini menghasilkan perilaku yang sama dengan nilai {@code "singleTop"} {@code launchMode}
+
Ini menghasilkan perilaku yang sama dengan nilai {@code "singleTop"} {@code launchMode}
yang dibahas di bagian sebelumnya.
Jika aktivitas yang dimulai sudah berjalan dalam tugas saat ini, maka sebagai
@@ -427,8 +427,8 @@ afinitas default untuk suatu aktivitas. Aktivitas yang didefinisikan dalam
aplikasi yang berbeda bisa berbagi afinitas, atau aktivitas yang didefinisikan dalam aplikasi yang sama bisa
diberi afinitas tugas yang berbeda.
-
Anda bisa memodifikasi afinitas untuk setiap yang diberikan
-dengan atribut {@code taskAffinity}
+
Aktivitas baru, secara default, diluncurkan ke dalam tugas aktivitas
+
Aktivitas baru, secara default, diluncurkan ke dalam tugas aktivitas
yang disebut {@link android.app.Activity#startActivity startActivity()}. Ini didorong ke back-stack
yang sama seperti caller. Akan tetapi, jika intent yang diteruskan ke
{@link android.app.Activity#startActivity startActivity()}
@@ -473,7 +473,7 @@ dimilikinya, bila tugas tersebut di bawa ke latar depan.
yang didefinisikan sebagai bagian dari aplikasi perjalanan. Aktivitas memiliki afinitas yang sama dengan aktivitas lain dalam aplikasi
yang sama (afinitas aplikasi default) dan aktivitas ini memungkinkan re-parenting dengan atribut ini.
Bila salah satu aktivitas Anda memulai aktivitas laporan cuaca, awalnya aktivitas ini dimiliki oleh tugas
-yang sama dengan aktivitas Anda. Akan tetapi, bila tugas aplikasi perjalanan di bawa ke latar depan,
+yang sama dengan aktivitas Anda. Akan tetapi, bila tugas aplikasi perjalanan di bawa ke latar depan,
aktivitas laporan cuaca akan ditetapkan kembali ke tugas itu dan ditampilkan di dalamnya.
@@ -497,7 +497,7 @@ apa yang mereka kerjakan sebelum dan kembali ke tugas itu untuk memulai sesuatu
Jika atribut ini ditetapkan ke {@code "true"} dalam aktivitas akar tugas,
+
Jika atribut ini ditetapkan ke {@code "true"} dalam aktivitas akar tugas,
perilaku default yang baru dijelaskan tidak akan terjadi.
Tugas akan mempertahankan semua aktivitas dalam back-stack bahkan setelah sekian lama.
Atribut ini seperti {@code clearTaskOnLaunch},
namun beroperasi pada
satu aktivitas, bukan pada seluruh tugas. Hal ini juga bisa menyebabkan aktivitas
-hilang, termasuk aktivitas akar. Bila ini diatur ke {@code "true"},
+hilang, termasuk aktivitas akar. Bila ini diatur ke {@code "true"},
aktivitas akan tetap menjadi bagian dari tugas hanya untuk sesi saat ini. Jika pengguna
keluar dan kemudian kembali ke tugas tersebut, tugas tidak akan ada lagi.
@@ -552,14 +552,14 @@ pembuka yang menandai aktivitas selalu memulai tugas, {@code "singleTask"} d
{@code "singleInstance"}, hanya boleh digunakan bila aktivitas memiliki filter
{@link android.content.Intent#ACTION_MAIN}
dan {@link android.content.Intent#CATEGORY_LAUNCHER}. Bayangkan, misalnya, apa yang akan
-terjadi jika filter tidak ada: Intent meluncurkan aktivitas{@code "singleTask"}, memulai
-tugas yang baru, dan pengguna menghabiskan lebih banyak waktu mengerjakan tugas tersebut. Pengguna kemudian menekan tombol
+terjadi jika filter tidak ada: Intent meluncurkan aktivitas{@code "singleTask"}, memulai
+tugas yang baru, dan pengguna menghabiskan lebih banyak waktu mengerjakan tugas tersebut. Pengguna kemudian menekan tombol
Home. Tugas kini dikirim ke latar belakang dan tidak terlihat. Sekarang pengguna tidak memiliki cara untuk kembali
ke tugas tersebut, karena tidak dinyatakan dalam launcher aplikasi.
-
Untuk kasus-kasus di mana Anda tidak ingin pengguna bisa kembali ke aktivitas, atur dalam
+
diff --git a/docs/html-intl/intl/in/guide/topics/manifest/manifest-intro.jd b/docs/html-intl/intl/in/guide/topics/manifest/manifest-intro.jd
index 6d6a3ad252db4..050abf47da02b 100644
--- a/docs/html-intl/intl/in/guide/topics/manifest/manifest-intro.jd
+++ b/docs/html-intl/intl/in/guide/topics/manifest/manifest-intro.jd
@@ -23,7 +23,7 @@ page.title=Manifes Aplikasi
Setiap aplikasi harus memiliki file AndroidManifest.xml (bernama persis seperti ini) di direktori akar.
File manifes
menyediakan informasi penting tentang aplikasi ke sistem Android,
- informasi yang harus dimiliki sistem agar bisa menjalankan setiap kode
+ informasi yang harus dimiliki sistem agar bisa menjalankan setiap kode
aplikasi. Di antaranya, manifes melakukan hal berikut ini:
@@ -32,26 +32,26 @@ aplikasi. Di antaranya, manifes melakukan hal berikut ini:
Nama paket berfungsi sebagai identifier unik untuk aplikasi.
Menjelaskan berbagai komponen aplikasi—aktivitas,
- layanan, penerima siaran, dan penyedia konten
-yang membentuk aplikasi. Menamai kelas yang mengimplementasikan setiap komponen dan
-mempublikasikan kemampuannya (misalnya, pesan {@link android.content.Intent
-Intent} mana yang bisa ditanganinya). Deklarasi ini memberi tahu sistem Android mengenai
+ layanan, penerima siaran, dan penyedia konten
+yang membentuk aplikasi. Menamai kelas yang mengimplementasikan setiap komponen dan
+mempublikasikan kemampuannya (misalnya, pesan {@link android.content.Intent
+Intent} mana yang bisa ditanganinya). Deklarasi ini memberi tahu sistem Android mengenai
komponennya dan dalam kondisi apa bisa diluncurkan.
-
Menentukan proses yang akan menjadi host komponen aplikasi.
+
Menentukan proses yang akan menjadi host komponen aplikasi.
-
Mendeklarasikan izin aplikasi mana yang harus dimiliki untuk
-mengakses bagian yang dilindungi pada API dan berinteraksi dengan aplikasi lain.
+
Mendeklarasikan izin aplikasi mana yang harus dimiliki untuk
+mengakses bagian yang dilindungi pada API dan berinteraksi dengan aplikasi lain.
-
Juga mendeklarasikan izin lain yang harus dimiliki untuk
+
Juga mendeklarasikan izin lain yang harus dimiliki untuk
untuk berinteraksi dengan komponen aplikasi.
-
Mencantumkan daftar kelas {@link android.app.Instrumentation} yang memberikan
-profil dan informasi lain saat aplikasi berjalan. Deklarasi ini
+
Mencantumkan daftar kelas {@link android.app.Instrumentation} yang memberikan
+profil dan informasi lain saat aplikasi berjalan. Deklarasi ini
hanya ada di manifes saat aplikasi dibuat dan diuji;
deklarasi dihapus sebelum aplikasi dipublikasikan.
-
Mendeklarasikan tingkat minimum API Android yang diperlukan
+
Mendeklarasikan tingkat minimum API Android yang diperlukan
aplikasi.
Mencantumkan daftar pustaka yang harus ditautkan aplikasi.
@@ -61,12 +61,12 @@ aplikasi.
Struktur File Manifes
-Diagram di bawah ini menampilkan struktur umum file manifes dan setiap
-elemen yang bisa ditampungnya. Setiap elemen, bersama
-atributnya, didokumentasikan secara lengkap dalam file terpisah. Untuk melihat
-informasi terperinci tentang setiap elemen, klik nama elemen dalam diagram,
-dalam daftar abjad elemen yang mengikuti diagram, atau penyebutan nama
-elemen lainnya.
+Diagram di bawah ini menampilkan struktur umum file manifes dan setiap
+elemen yang bisa ditampungnya. Setiap elemen, bersama
+atributnya, didokumentasikan secara lengkap dalam file terpisah. Untuk melihat
+informasi terperinci tentang setiap elemen, klik nama elemen dalam diagram,
+dalam daftar abjad elemen yang mengikuti diagram, atau penyebutan nama
+elemen lainnya.
@@ -126,9 +126,9 @@ elemen lainnya.
-Semua elemen yang bisa muncul dalam file manifes tercantum di bawah ini
-dalam urutan abjad. Ini adalah satu-satunya elemen legal; Anda tidak bisa
-menambahkan elemen atau atribut sendiri.
+Semua elemen yang bisa muncul dalam file manifes tercantum di bawah ini
+dalam urutan abjad. Ini adalah satu-satunya elemen legal; Anda tidak bisa
+menambahkan elemen atau atribut sendiri.
@@ -158,74 +158,74 @@ menambahkan elemen atau atribut sendiri.
-
+
Konvensi File
-Sebagian konvensi dan aturan berlaku secara umum untuk semua elemen
+Sebagian konvensi dan aturan berlaku secara umum untuk semua elemen
dan atribut di manifes:
Elemen
-
Hanya elemen
+
Hanya elemen
<manifest> dan
-<application>
-yang diwajibkan, masing-masing harus ada dan hanya boleh terjadi sekali.
-Umumnya elemen lain bisa terjadi berkali-kali atau sama sekali tidak terjadi — meskipun
-setidaknya sebagian dari elemen itu harus ada untuk agar manifes mencapai sesuatu yang
+<application>
+yang diwajibkan, masing-masing harus ada dan hanya boleh terjadi sekali.
+Umumnya elemen lain bisa terjadi berkali-kali atau sama sekali tidak terjadi — meskipun
+setidaknya sebagian dari elemen itu harus ada untuk agar manifes mencapai sesuatu yang
berarti.
-Jika elemen tidak berisi apa pun, berarti elemen itu berisi elemen lain.
+Jika elemen tidak berisi apa pun, berarti elemen itu berisi elemen lain.
Semua nilai diatur melalui atribut, bukan sebagai data karakter dalam elemen.
-Elemen yang sama tingkatan umumnya tidak diurutkan. Misalnya, elemen
-<activity>,
-<provider>, dan
-<service>
-bisa dicampur dalam urutan apa pun. (Elemen
+Elemen yang sama tingkatan umumnya tidak diurutkan. Misalnya, elemen
+<activity>,
+<provider>, dan
+<service>
+bisa dicampur dalam urutan apa pun. (Elemen
<activity-alias>
- merupakan eksepsi untuk aturan ini: Elemen ini harus mengikuti
-<activity>
+ merupakan eksepsi untuk aturan ini: Elemen ini harus mengikuti
+<activity>
ini aliasnya.)
Atribut
-
Secara formal, semua atribut opsional. Akan tetapi, ada sebagian
-yang harus ditetapkan agar elemen bisa mencapai tujuannya. Gunakan
-dokumentasi sebagai panduan. Bagi atribut yang benar-benar opsional, ini menyebutkan
+
Secara formal, semua atribut opsional. Akan tetapi, ada sebagian
+yang harus ditetapkan agar elemen bisa mencapai tujuannya. Gunakan
+dokumentasi sebagai panduan. Bagi atribut yang benar-benar opsional, ini menyebutkan
nilai default atau menyatakan apa yang terjadi jika tidak ada spesifikasi.
-
Selain untuk beberapa atribut elemen akar
+
Selain untuk beberapa atribut elemen akar
<manifest>,
- semua nama atribut dimulai dengan awalan {@code android:} —
-misalnya, {@code android:alwaysRetainTaskState}. Karena awalan ini universal, dokumentasi umumnya meniadakannya saat mengacu atribut
+ semua nama atribut dimulai dengan awalan {@code android:} —
+misalnya, {@code android:alwaysRetainTaskState}. Karena awalan ini universal, dokumentasi umumnya meniadakannya saat mengacu atribut
dengan nama.
Mendeklarasikan nama kelas
-
Banyak elemen berhubungan dengan objek Java, termasuk elemen
-aplikasi itu sendiri (elemen
-<application>
-) dan aktivitas komponen — utamanya
-(<activity>),
-layanan
-(<service>),
-penerima siaran
-(<receiver>),
-dan penyedia konten
-(<provider>).
+
Banyak elemen berhubungan dengan objek Java, termasuk elemen
+aplikasi itu sendiri (elemen
+<application>
+) dan aktivitas komponen — utamanya
+(<activity>),
+layanan
+(<service>),
+penerima siaran
+(<receiver>),
+dan penyedia konten
+(<provider>).
-Jika mendefinisikan subkelas, seperti yang selalu Anda definisikan untuk kelas komponen
-({@link android.app.Activity}, {@link android.app.Service},
-{@link android.content.BroadcastReceiver}, dan {@link android.content.ContentProvider}),
-subkelas dideklarasikan melalui atribut {@code name}. Nama harus menyertakan tujuan
-paket lengkap.
+Jika mendefinisikan subkelas, seperti yang selalu Anda definisikan untuk kelas komponen
+({@link android.app.Activity}, {@link android.app.Service},
+{@link android.content.BroadcastReceiver}, dan {@link android.content.ContentProvider}),
+subkelas dideklarasikan melalui atribut {@code name}. Nama harus menyertakan tujuan
+paket lengkap.
Misalnya, subkelas {@link android.app.Service} mungkin dideklarasikan sebagai berikut:
@@ -239,12 +239,12 @@ Misalnya, subkelas {@link android.app.Service} mungkin dideklarasikan sebagai be
</manifest>
-Akan tetapi, sebagai shorthand, jika karakter pertama string adalah titik,
-string akan ditambahkan ke nama paket aplikasi (seperti yang ditetapkan dalam elemen
-<manifest>
- melalui atribut
+Akan tetapi, sebagai shorthand, jika karakter pertama string adalah titik,
+string akan ditambahkan ke nama paket aplikasi (seperti yang ditetapkan dalam elemen
+<manifest>
+ melalui atribut
package
-). Penetapan berikut sama dengan di atas:
+). Penetapan berikut sama dengan di atas:
<manifest package="com.example.project" . . . >
@@ -257,13 +257,13 @@ string akan ditambahkan ke nama paket aplikasi (seperti yang ditetapkan dalam el
</manifest>
-Saat memulai komponen, Android akan membuat instance subkelas yang diberi nama.
+Saat memulai komponen, Android akan membuat instance subkelas yang diberi nama.
Jika subkelas tidak ditetapkan, maka akak dibuat instance kelas dasar.
Banyak nilai
-
Jika lebih dari satu nilai yang dapat ditetapkan, elemen ini hampir selalu
-diulangi, bukan menampilkan daftar banyak nilai dalam satu elemen.
+
Jika lebih dari satu nilai yang dapat ditetapkan, elemen ini hampir selalu
+diulangi, bukan menampilkan daftar banyak nilai dalam satu elemen.
Misalnya, filter intent dapat mencantumkan beberapa tindakan:
<intent-filter . . . >
@@ -275,23 +275,23 @@ Misalnya, filter intent dapat mencantumkan beberapa tindakan:
Nilai sumber daya
Beberapa atribut memiliki nilai yang bisa ditampilkan kepada pengguna — misalnya
-, label dan ikon aktivitas. Nilai atribut ini
-harus dilokalkan dan karenanya ditetapkan dari sumber daya atau tema. Nilai sumber
+, label dan ikon aktivitas. Nilai atribut ini
+harus dilokalkan dan karenanya ditetapkan dari sumber daya atau tema. Nilai sumber
daya dinyatakan dalam format berikut,
{@code @[package:]type:name}
-dalam hal ini nama package boleh dihilangkan jika sumber daya ada dalam paket yang sama dengan
-dengan aplikasi, type adalah tipe sumber daya — seperti "string" atau
-"drawable" — dan name adalah nama yang mengidentifikasi sumber daya tertentu.
+dalam hal ini nama package boleh dihilangkan jika sumber daya ada dalam paket yang sama dengan
+dengan aplikasi, type adalah tipe sumber daya — seperti "string" atau
+"drawable" — dan name adalah nama yang mengidentifikasi sumber daya tertentu.
Misalnya:
-Nilai tema diekspresikan dengan cara yang sama, namun dengan awal '{@code ?}'
+Nilai tema diekspresikan dengan cara yang sama, namun dengan awal '{@code ?}'
dan bukan '{@code @}':
@@ -299,8 +299,8 @@ dan bukan '{@code @}':
Nilai-nilai string
-
Bila nilai atribut adalah string, dua garis miring kiri ('{@code \\}')
-harus digunakan untuk meninggalkan karakter — misalnya, '{@code \\n}' untuk
+
Bila nilai atribut adalah string, dua garis miring kiri ('{@code \\}')
+harus digunakan untuk meninggalkan karakter — misalnya, '{@code \\n}' untuk
baris baru atau '{@code \\uxxxx}' untuk karakter Unicode.
@@ -308,7 +308,7 @@ baris baru atau '{@code \\uxxxx}' untuk karakter Unicode.
Fitur File
-Bagian berikut menjelaskan cara menerapkan sebagian fitur Android
+Bagian berikut menjelaskan cara menerapkan sebagian fitur Android
dalam file manifest.
@@ -316,37 +316,37 @@ dalam file manifest.
Filter Intent
-Komponen inti dari aplikasi (aktivitasnya, layanannya, dan penerima
-siaran) diaktifkan oleh intent. Intent adalah
-sekumpulan informasi (objek {@link android.content.Intent}) yang menjelaskan
-tindakan yang diinginkan — termasuk data yang akan ditindaklanjuti, kategori
-komponen yang harus melakukan tindakan, dan petunjuk terkait lainnya.
-Android mencari komponen yang sesuai untuk merespons intent, meluncurkan
-instance komponen baru jika diperlukan, dan meneruskannya ke
+Komponen inti dari aplikasi (aktivitasnya, layanannya, dan penerima
+siaran) diaktifkan oleh intent. Intent adalah
+sekumpulan informasi (objek {@link android.content.Intent}) yang menjelaskan
+tindakan yang diinginkan — termasuk data yang akan ditindaklanjuti, kategori
+komponen yang harus melakukan tindakan, dan petunjuk terkait lainnya.
+Android mencari komponen yang sesuai untuk merespons intent, meluncurkan
+instance komponen baru jika diperlukan, dan meneruskannya ke
objek Intent.
-Komponen mengiklankan kemampuannya — jenis intent yang bisa diresponsnya
- — melalui filter intent. Karena sistem Android
-harus mempelajari intent yang dapat ditangani komponen sebelum meluncurkan komponen,
-filter intent ditetapkan dalam manifes sebagai elemen
+Komponen mengiklankan kemampuannya — jenis intent yang bisa diresponsnya
+ — melalui filter intent. Karena sistem Android
+harus mempelajari intent yang dapat ditangani komponen sebelum meluncurkan komponen,
+filter intent ditetapkan dalam manifes sebagai elemen
<intent-filter>
-. Sebuah komponen dapat memiliki filter dalam jumlah berapa saja, masing-masing menjelaskan
+. Sebuah komponen dapat memiliki filter dalam jumlah berapa saja, masing-masing menjelaskan
kemampuan yang berbeda.
Intent yang secara eksplisit menamai komponen target akan mengaktifkan komponen itu;
-filter tidak berperan. Namun intent yang tidak menetapkan target
-dengan nama dapat mengaktifkan komponen hanya jika dapat melewati salah satu filter
+filter tidak berperan. Namun intent yang tidak menetapkan target
+dengan nama dapat mengaktifkan komponen hanya jika dapat melewati salah satu filter
komponen.
-Sejumlah elemen memiliki atribut {@code icon} dan {@code label} untuk
-ikon kecil dan label teks yang bisa ditampilkan kepada pengguna. Sebagian ada juga yang memiliki atribut
-{@code description}untuk teks penjelasan yang lebih panjang yang juga bisa
-ditampilkan pada layar. Misalnya, elemen
+Sejumlah elemen memiliki atribut {@code icon} dan {@code label} untuk
+ikon kecil dan label teks yang bisa ditampilkan kepada pengguna. Sebagian ada juga yang memiliki atribut
+{@code description}untuk teks penjelasan yang lebih panjang yang juga bisa
+ditampilkan pada layar. Misalnya, elemen
<permission>
- memiliki ketiga atribut ini, jadi saat pengguna ditanya apakah akan
-memberi izin bagi aplikasi yang memintanya, ikon yang mewakili
-izin, nama izin, dan keterangan yang
+ memiliki ketiga atribut ini, jadi saat pengguna ditanya apakah akan
+memberi izin bagi aplikasi yang memintanya, ikon yang mewakili
+izin, nama izin, dan keterangan yang
mengikutinya bisa ditampilkan kepada pengguna.
-Dalam setiap kasus, ikon dan label yang ditetapkan dalam elemen yang memuatnya menjadi
-{@code icon} default dan pengaturan {@code label} untuk semua subelemen kontainer ini.
-Karena itu, ikon dan label yang ditetapkan dalam elemen
-<application>
-adalah ikon dan label default untuk setiap komponen aplikasi.
-Demikian pula, ikon dan label yang ditetapkan untuk komponen — misalnya, elemen
-<activity>
-— adalah pengaturan default untuk setiap elemen komponen
+Dalam setiap kasus, ikon dan label yang ditetapkan dalam elemen yang memuatnya menjadi
+{@code icon} default dan pengaturan {@code label} untuk semua subelemen kontainer ini.
+Karena itu, ikon dan label yang ditetapkan dalam elemen
+<application>
+adalah ikon dan label default untuk setiap komponen aplikasi.
+Demikian pula, ikon dan label yang ditetapkan untuk komponen — misalnya, elemen
+<activity>
+— adalah pengaturan default untuk setiap elemen komponen
<intent-filter>
-. Jika elemen
-<application>
-menetapkan label, namun suatu aktivitas dan filter intent-nya tidak menetapkan label,
-maka label aplikasi akan dianggap sama-sama sebagai label aktvitas dan
+. Jika elemen
+<application>
+menetapkan label, namun suatu aktivitas dan filter intent-nya tidak menetapkan label,
+maka label aplikasi akan dianggap sama-sama sebagai label aktvitas dan
filter intent.
-Ikon dan label yang ditetapkan untuk filter intent digunakan untuk mewakili komponen
-kapan saja komponen ditampilkan kepada pengguna saat memenuhi fungsi yang
-diiklankan oleh filter. Misalnya, filter dengan pengaturan
-"{@code android.intent.action.MAIN}" dan
-"{@code android.intent.category.LAUNCHER}" mengiklankan aktivitas
-sebagai aktivitas yang memulai aplikasi—, yaitu
-sebagai salah satu aktivitas yang harus ditampilkan dalam launcher aplikasi. Ikon dan label yang
+Ikon dan label yang ditetapkan untuk filter intent digunakan untuk mewakili komponen
+kapan saja komponen ditampilkan kepada pengguna saat memenuhi fungsi yang
+diiklankan oleh filter. Misalnya, filter dengan pengaturan
+"{@code android.intent.action.MAIN}" dan
+"{@code android.intent.category.LAUNCHER}" mengiklankan aktivitas
+sebagai aktivitas yang memulai aplikasi—, yaitu
+sebagai salah satu aktivitas yang harus ditampilkan dalam launcher aplikasi. Ikon dan label yang
diatur dalam filter karenanya adalah ikon dan label yang ditampilkan dalam launcher.
@@ -397,14 +397,14 @@ diatur dalam filter karenanya adalah ikon dan label yang ditampilkan dalam launc
Izin
-Sebuah izin adalah pembatasan yang membatasi akses ke bagian
-kode atau ke data pada perangkat. Pembatasan diberlakukan untuk melindungi data dan kode
-penting yang bisa disalahgunakan untuk mengganggu atau merusak pengalaman pengguna.
+Sebuah izin adalah pembatasan yang membatasi akses ke bagian
+kode atau ke data pada perangkat. Pembatasan diberlakukan untuk melindungi data dan kode
+penting yang bisa disalahgunakan untuk mengganggu atau merusak pengalaman pengguna.
-Setiap izin diidentifikasi melalui label yang unik. Sering kali, label menunjukkan
-tindakan yang dibatasi. Misalnya, berikut ini adalah beberapa izin yang didefinisikan
+Setiap izin diidentifikasi melalui label yang unik. Sering kali, label menunjukkan
+tindakan yang dibatasi. Misalnya, berikut ini adalah beberapa izin yang didefinisikan
oleh Android:
@@ -418,25 +418,25 @@ Sebuah fitur bisa dilindungi paling banyak oleh satu izin.
-Jika aplikasi memerlukan akses ke fitur yang dilindungi oleh izin,
-aplikasi harus mendeklarasikan bahwa aplikasi memerlukan izin itu dengan elemen
+Jika aplikasi memerlukan akses ke fitur yang dilindungi oleh izin,
+aplikasi harus mendeklarasikan bahwa aplikasi memerlukan izin itu dengan elemen
<uses-permission>
- dalam manifes. Kemudian, bila aplikasi telah diinstal pada
-perangkat, installer akan menentukan apakah izin yang diminta akan diberikan atau tidak
-dengan memeriksa otoritas yang menandatangani
-sertifikat aplikasi dan, dalam beberapa kasus, bertanya pada pengguna.
-Jika izin diberikan, aplikasi tersebut bisa menggunakan
-fitur yang dilindungi. Jika tidak, upaya aplikasi untuk mengakses fitur tersebut akan gagal
-tanpa ada pemberitahuan apa pun kepada pengguna.
+ dalam manifes. Kemudian, bila aplikasi telah diinstal pada
+perangkat, installer akan menentukan apakah izin yang diminta akan diberikan atau tidak
+dengan memeriksa otoritas yang menandatangani
+sertifikat aplikasi dan, dalam beberapa kasus, bertanya pada pengguna.
+Jika izin diberikan, aplikasi tersebut bisa menggunakan
+fitur yang dilindungi. Jika tidak, upaya aplikasi untuk mengakses fitur tersebut akan gagal
+tanpa ada pemberitahuan apa pun kepada pengguna.
-Aplikasi juga bisa melindungi komponennya sendiri (aktivitas, layanan,
-penerima siaran, dan penyedia konten) dengan izin. Aplikasi bisa menerapkan
-izin mana pun yang didefinisikan oleh Android (tercantum dalam
-{@link android.Manifest.permission android.Manifest.permission}) atau dideklarasikan
-oleh aplikasi lain. Atau aplikasi bisa mendefinisikannya sendiri. Izin baru dideklarasikan
-dengan elemen
+Aplikasi juga bisa melindungi komponennya sendiri (aktivitas, layanan,
+penerima siaran, dan penyedia konten) dengan izin. Aplikasi bisa menerapkan
+izin mana pun yang didefinisikan oleh Android (tercantum dalam
+{@link android.Manifest.permission android.Manifest.permission}) atau dideklarasikan
+oleh aplikasi lain. Atau aplikasi bisa mendefinisikannya sendiri. Izin baru dideklarasikan
+dengan elemen
<permission>
. Misalnya, aktivitas dapat dilindungi sebagai berikut:
@@ -457,43 +457,43 @@ dengan elemen
-Perhatikan, dalam contoh ini izin {@code DEBIT_ACCT} tidak hanya
-dideklarasikan dengan elemen
+Perhatikan, dalam contoh ini izin {@code DEBIT_ACCT} tidak hanya
+dideklarasikan dengan elemen
<permission>
-, penggunaannya juga diminta dengan elemen
+, penggunaannya juga diminta dengan elemen
<uses-permission>
-. Penggunaannya harus diminta agar komponen
-aplikasi lainnya bisa menjalankan aktivitas yang dilindungi, meskipun perlindungan itu
-diberlakukan oleh aplikasi itu sendiri.
+. Penggunaannya harus diminta agar komponen
+aplikasi lainnya bisa menjalankan aktivitas yang dilindungi, meskipun perlindungan itu
+diberlakukan oleh aplikasi itu sendiri.
-Dalam contoh yang sama, jika atribut {@code permission} ditetapkan
-untuk izin yang dideklarasikan di tempat lain
-lain (seperti {@code android.permission.CALL_EMERGENCY_NUMBERS}, maka atribut
-tidak perlu mendeklarasikannya lagi dengan elemen
+Dalam contoh yang sama, jika atribut {@code permission} ditetapkan
+untuk izin yang dideklarasikan di tempat lain
+lain (seperti {@code android.permission.CALL_EMERGENCY_NUMBERS}, maka atribut
+tidak perlu mendeklarasikannya lagi dengan elemen
<permission>
-. Akan tetapi, penggunaannya masih perlu dengan
-<uses-permission>.
+. Akan tetapi, penggunaannya masih perlu dengan
+<uses-permission>.
-Elemen
-<permission-tree>
-mendeklarasikan namespace untuk grup izin yang akan didefinisikan dalam
-kode. Dan
+Elemen
+<permission-tree>
+mendeklarasikan namespace untuk grup izin yang akan didefinisikan dalam
+kode. Dan
<permission-group>
-mendefinisikan label untuk seperangkat izin (yang sama-sama dideklarasikan dalam manifes dengan elemen
-<permission>
-dan yang dideklarasikan di tempat lain). Ini hanya memengaruhi cara izin
-dikelompokkan saat ditampilkan kepada pengguna. Elemen
+mendefinisikan label untuk seperangkat izin (yang sama-sama dideklarasikan dalam manifes dengan elemen
+<permission>
+dan yang dideklarasikan di tempat lain). Ini hanya memengaruhi cara izin
+dikelompokkan saat ditampilkan kepada pengguna. Elemen
<permission-group>
- tidak menetapkan izin mana dimiliki grup;
+ tidak menetapkan izin mana dimiliki grup;
elemen hanya memberi nama grup. Izin ditempatkan dalam grup
-dengan memberikan nama grup ke elemen
-<permission>
- melalui atribut
-permissionGroup
+dengan memberikan nama grup ke elemen
+<permission>
+ melalui atribut
+permissionGroup
.
@@ -501,17 +501,17 @@ dengan memberikan nama grup ke elemen
Pustaka
-Setiap aplikasi ditautkan dengan pustaka default Android, yang
-menyertakan paket dasar untuk membangun aplikasi (dengan kelas umum
-seperti Activity, Service, Intent, View, Button, Application, ContentProvider,
+Setiap aplikasi ditautkan dengan pustaka default Android, yang
+menyertakan paket dasar untuk membangun aplikasi (dengan kelas umum
+seperti Activity, Service, Intent, View, Button, Application, ContentProvider,
dan sebagainya).
-Akan tetapi, sebagian paket berada dalam pustakanya sendiri. Jika aplikasi Anda
-menggunakan kode salah satu paket ini, aplikasi secara eksplisit meminta untuk ditautkan dengan
-paket tersebut. Manifes harus berisi elemen
-<uses-library> yang
-terpisah untuk menamai setiap pustaka. (Nama pustaka bisa ditemukan
+Akan tetapi, sebagian paket berada dalam pustakanya sendiri. Jika aplikasi Anda
+menggunakan kode salah satu paket ini, aplikasi secara eksplisit meminta untuk ditautkan dengan
+paket tersebut. Manifes harus berisi elemen
+<uses-library> yang
+terpisah untuk menamai setiap pustaka. (Nama pustaka bisa ditemukan
dalam dokumentasi paket.)
@@ -63,8 +63,8 @@ pada kalender, kejadian, peserta, pengingat, dan seterusnya.
API Penyedia Kalender bisa digunakan oleh aplikasi dan adaptor sinkronisasi. Aturannya
bervariasi menurut tipe program yang membuat panggilan. Dokumen ini
-terutama berfokus pada penggunaan API Penyedia Kalender sebagai sebuah aplikasi. Untuk
-pembahasan ragam adaptor sinkronisasi, lihat
+terutama berfokus pada penggunaan API Penyedia Kalender sebagai sebuah aplikasi. Untuk
+pembahasan ragam adaptor sinkronisasi, lihat
Adaptor Sinkronisasi.
@@ -89,7 +89,7 @@ data kalender seorang pengguna.
Setiap penyedia konten membuka sebuah URI publik (yang dibungkus sebagai objek
{@link android.net.Uri}
) yang mengidentifikasikan set datanya secara unik. Penyedia konten yang mengontrol
- beberapa set data (beberapa tabel) mengekspos URI terpisah untuk tiap set. Semua
+ beberapa set data (beberapa tabel) mengekspos URI terpisah untuk tiap set. Semua
URI untuk penyedia diawali dengan string "content://". String ini
mengidentifikasi data sebagai dikontrol oleh penyedia konten. Penyedia Kalender
mendefinisikan konstanta untuk URI masing-masing kelas (tabel). URI ini
@@ -113,26 +113,26 @@ tabel dan bidang utama yang saling berkaitan.
Tabel ini menyimpan
informasi khusus kalender. Tiap baris dalam tabel ini berisi data untuk
satu kalender, seperti nama, warna, informasi sinkronisasi, dan seterusnya.
{@link android.provider.CalendarContract.Events}
-
+
Tabel ini menyimpan
informasi khusus kejadian. Tiap baris dalam tabel ini berisi informasi untuk satu
kejadian—misalnya, judul kejadian, lokasi, waktu mulai, waktu
selesai, dan seterusnya. Kejadian bisa terjadi satu kali atau bisa berulang beberapa kali. Peserta,
-pengingat, dan properti perluasan disimpan dalam tabel terpisah.
-Masing-masing memiliki sebuah {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+pengingat, dan properti perluasan disimpan dalam tabel terpisah.
+Masing-masing memiliki sebuah {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
yang mengacu {@link android.provider.BaseColumns#_ID} dalam tabel Events.
Tabel ini menyimpan
waktu mulai dan waktu selesai setiap bentuk kejadian. Tiap baris dalam tabel ini
mewakili satu bentuk kejadian. Untuk kejadian satu kali ada pemetaan 1:1
@@ -141,7 +141,7 @@ secara otomatis yang sesuai dengan beberapa kejadian itu.
Tabel ini menyimpan
informasi peserta (tamu) kejadian. Tiap baris mewakili satu tamu
kejadian. Ini menetapkan tipe tamu dan respons kehadiran tamu
@@ -149,17 +149,17 @@ untuk kejadian.
Tabel ini menyimpan
data peringatan/pemberitahuan. Tiap baris mewakili satu peringatan untuk sebuah kejadian. Sebuah
kejadian bisa memiliki beberapa pengingat. Jumlah maksimum pengingat per kejadian
-ditetapkan dalam
-{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS},
+ditetapkan dalam
+{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS},
yang diatur oleh adaptor sinkronisasi yang
memiliki kalender yang diberikan. Pengingat ditetapkan dalam menit sebelum kejadian
dan memiliki metode yang menentukan cara pengguna akan diperingatkan.
-
+
API Penyedia Kalender didesain agar luwes dan tangguh. Sementara itu
@@ -178,9 +178,9 @@ Kalender.
Adaptor sinkronisasi. Adaptor sinkronisasi menyinkronkan data kalender
-pada perangkat pengguna dengan server atau sumber data lain. Dalam tabel
+pada perangkat pengguna dengan server atau sumber data lain. Dalam tabel
{@link android.provider.CalendarContract.Calendars} dan
-{@link android.provider.CalendarContract.Events},
+{@link android.provider.CalendarContract.Events},
ada kolom yang dicadangkan untuk digunakan adaptor sinkronisasi.
Penyedia dan aplikasi tidak boleh memodifikasinya. Sebenarnya, tabel-tabel itu tidak
terlihat kecuali jika diakses sebagai adaptor sinkronisasi. Untuk informasi selengkapnya tentang
@@ -211,7 +211,7 @@ untuk menghapus, menyisipkan, atau memperbarui data kalender:
Tabel {@link android.provider.CalendarContract.Calendars} berisi data
untuk tiap kalender. Kolom-kolom
-berikut ini bisa ditulisi oleh aplikasi maupun adaptor sinkronisasi.
+berikut ini bisa ditulisi oleh aplikasi maupun adaptor sinkronisasi.
Untuk mengetahui daftar lengkap bidang-bidang yang didukung, lihat
acuan {@link android.provider.CalendarContract.Calendars}.
Sebuah boolean yang menunjukkan apakah kalender dipilih untuk ditampilkan. Nilai
0 menunjukkan bahwa kejadian yang terkait dengan kalender ini tidak boleh
ditampilkan. Nilai 1 menunjukkan bahwa kejadian yang terkait dengan kalender ini harus
@@ -240,7 +240,7 @@ android.provider.CalendarContract.Instances}.
Sebuah boolean yang menunjukkan apakah kalender harus disinkronkan dan apakah
kejadiannya harus disimpan pada perangkat. Nilai 0 berarti jangan menyinkronkan kalender ini atau
simpan kejadiannya pada perangkat. Nilai 1 berarti menyinkronkan kejadian untuk kalender ini
@@ -253,8 +253,8 @@ dan simpan kejadiannya pada perangkat.
Berikut ini adalah contoh yang menampilkan cara mendapatkan kalender yang dimiliki oleh
pengguna tertentu. Untuk memudahkan, dalam contoh ini, operasi query ditampilkan dalam
thread antarmuka pengguna ("thread utama"). Dalam praktiknya, hal ini harus dilakukan dalam
-thread asinkron, sebagai ganti pada thread utama. Untuk diskusi selengkapnya, lihat
-Loader. Jika Anda tidak sekadar
+thread asinkron, sebagai ganti pada thread utama. Untuk diskusi selengkapnya, lihat
+Loader. Jika Anda tidak sekadar
membaca data melainkan memodifikasinya, lihat {@link android.content.AsyncQueryHandler}.
@@ -268,18 +268,18 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
Mengapa Anda harus menyertakan
ACCOUNT_TYPE?
Jika Anda membuat query pada {@link
android.provider.CalendarContract.Calendars#ACCOUNT_NAME
-Calendars.ACCOUNT_NAME}, Anda juga harus menyertakan
+Calendars.ACCOUNT_NAME}, Anda juga harus menyertakan
{@link android.provider.CalendarContract.Calendars#ACCOUNT_TYPE Calendars.ACCOUNT_TYPE}
dalam pemilihan. Itu karena akun yang bersangkutan
hanya dianggap unik mengingat ACCOUNT_NAME dan
@@ -289,7 +289,7 @@ autentikator akun yang digunakan bila akun didaftarkan dengan
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} untuk kalender
yang tidak terkait dengan akun perangkat. Akun {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} tidak
-disinkronkan.
+disinkronkan.
Di bagian berikutnya pada contoh ini, Anda akan membuat query. Pemilihan
@@ -301,59 +301,59 @@ kalender yang memiliki ACCOUNT_NAME
telah ditampilkan pengguna, bukan hanya kalender yang dimiliki pengguna, hilangkan OWNER_ACCOUNT.
Query tersebut akan menghasilkan objek {@link android.database.Cursor}
yang bisa Anda gunakan untuk menyusuri set hasil yang dikembalikan oleh
-query database. Untuk diskusi selengkapnya tentang penggunaan query dalam penyedia konten,
+query database. Untuk diskusi selengkapnya tentang penggunaan query dalam penyedia konten,
lihat Penyedia Kalender.
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
Bagian berikutnya ini menggunakan kursor untuk merunut set hasil. Bagian ini menggunakan
konstanta yang disiapkan pada awal contoh ini untuk menghasilkan nilai-nilai
bagi tiap bidang.
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
-
+
Memodifikasi kalender
Untuk melakukan pembaruan kalender, Anda bisa menyediakan {@link
android.provider.BaseColumns#_ID} kalender itu baik sebagai ID yang ditambahkan ke
-URI
+URI
-({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
atau sebagai item pemilihan pertama. Pemilihan
harus diawali dengan "_id=?", dan
selectionArg pertama harus berupa {@link
-android.provider.BaseColumns#_ID} kalender.
+android.provider.BaseColumns#_ID} kalender.
Anda juga bisa melakukan pembaruan dengan menuliskan kode ID dalam URI. Contoh ini mengubah
-nama tampilan kalender dengan pendekatan
-({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+nama tampilan kalender dengan pendekatan
+({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
:
private static final String DEBUG_TAG = "MyActivity";
@@ -375,7 +375,7 @@ perlu membuat sebuah kalender lokal, aplikasi bisa melakukannya dengan melakukan
penyisipan kalender sebagai adaptor sinkronisasi, menggunakan {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} dari {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}.
-{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
+{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
adalah sebuah tipe akun khusus untuk kalender yang tidak
terkait dengan akun perangkat. Kalender tipe ini tidak disinkronkan dengan server. Untuk
diskusi tentang adaptor sinkronisasi, lihat Adaptor Sinkronisasi.
@@ -434,7 +434,7 @@ android.provider.CalendarContract.Events}.
Durasi kejadian dalam format RFC5545.
Misalnya, nilai "PT1H" menyatakan bahwa kejadian
akan berlangsung satu jam, dan nilai "P2W" menunjukkan
@@ -444,39 +444,39 @@ durasi 2 minggu.
Nilai 1 menunjukkan kejadian ini memakan waktu sehari penuh, seperti yang didefinisikan oleh
zona waktu lokal. Nilai 0 menunjukkan kejadian adalah kejadian biasa yang mungkin dimulai
dan selesai pada sembarang waktu selama suatu hari.
Tanggal perulangan kejadian.
- Anda biasanya menggunakan {@link android.provider.CalendarContract.EventsColumns#RDATE}
- bersama dengan {@link android.provider.CalendarContract.EventsColumns#RRULE}
+
Tanggal perulangan kejadian.
+ Anda biasanya menggunakan {@link android.provider.CalendarContract.EventsColumns#RDATE}
+ bersama dengan {@link android.provider.CalendarContract.EventsColumns#RRULE}
untuk mendefinisikan satu set agregat
kejadian berulang. Untuk diskusi selengkapnya, lihat Spesifikasi RFC5545.
@@ -514,11 +514,11 @@ java.util.TimeZone#getAvailableIDs()}. Perhatikan bahwa aturan ini tidak berlaku
Anda menyisipkan kejadian melalui Intent {@link
android.content.Intent#ACTION_INSERT INSERT}, yang dijelaskan dalam Menggunakan intent untuk menyisipkan kejadian—dalam
skenario itu, sebuah zona waktu default akan diberikan.
-
+
Untuk kejadian tidak-berulang, Anda harus menyertakan {@link
android.provider.CalendarContract.EventsColumns#DTEND}.
-
-
+
+
Untuk kejadian berulang, Anda harus menyertakan sebuah {@link
android.provider.CalendarContract.EventsColumns#DURATION} selain {@link
android.provider.CalendarContract.EventsColumns#RRULE} atau {@link
@@ -526,9 +526,9 @@ android.provider.CalendarContract.EventsColumns#RDATE}. Perhatikan bahwa aturan
Anda menyisipkan kejadian melalui Intent {@link
android.content.Intent#ACTION_INSERT INSERT}, yang dijelaskan dalam Menggunakan intent untuk menyisipkan kejadian—dalam
skenario itu, Anda bisa menggunakan {@link
-android.provider.CalendarContract.EventsColumns#RRULE} bersama {@link android.provider.CalendarContract.EventsColumns#DTSTART} dan {@link android.provider.CalendarContract.EventsColumns#DTEND}, dan aplikasi Calendar
+android.provider.CalendarContract.EventsColumns#RRULE} bersama {@link android.provider.CalendarContract.EventsColumns#DTSTART} dan {@link android.provider.CalendarContract.EventsColumns#DTEND}, dan aplikasi Calendar
akan mengubahnya menjadi durasi secara otomatis.
-
+
Berikut ini adalah contoh penyisipan kejadian. Penyisipan ini dilakukan dalam thread UI
@@ -539,8 +539,8 @@ informasi selengkapnya, lihat {@link android.content.AsyncQueryHandler}.
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -561,7 +561,7 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
@@ -578,14 +578,14 @@ peserta atau pengingat ke kejadian.
gunakan Intent {@link android.content.Intent#ACTION_EDIT EDIT}, seperti
dijelaskan dalam Menggunakan intent untuk mengedit kejadian.
Akan tetapi, jika perlu, Anda bisa mengedit kejadian secara langsung. Untuk melakukan pembaruan
-suatu kejadian, Anda bisa memberikan _ID
+suatu kejadian, Anda bisa memberikan _ID
kejadian itu sebagai ID yang ditambahkan ke URI ({@link
-android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
-atau sebagai item pemilihan pertama.
+android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+atau sebagai item pemilihan pertama.
Pemilihan harus dimulai dengan "_id=?", dan
selectionArg yang pertama harus berupa _ID kejadian. Anda juga bisa
melakukan pembaruan dengan menggunakan pemilihan tanpa ID. Berikut ini adalah contoh pembaruan
-kejadian. Contoh ini mengubah judul kejadian dengan pendekatan
+kejadian. Contoh ini mengubah judul kejadian dengan pendekatan
{@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}
:
@@ -598,7 +598,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -625,22 +625,22 @@ ContentValues values = new ContentValues();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().delete(deleteUri, null, null);
-Log.i(DEBUG_TAG, "Rows deleted: " + rows);
+Log.i(DEBUG_TAG, "Rows deleted: " + rows);
Tabel Peserta
Tiap baris tabel {@link android.provider.CalendarContract.Attendees}
-mewakili satu peserta atau tamu dari sebuah kejadian. Memanggil
-{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
+mewakili satu peserta atau tamu dari sebuah kejadian. Memanggil
+{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
akan menghasilkan daftar peserta untuk
-kejadian dengan {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} yang diberikan.
-{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} ini
+kejadian dengan {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} yang diberikan.
+{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} ini
harus cocok dengan {@link
-android.provider.BaseColumns#_ID} kejadian tertentu.
Tabel berikut mencantumkan
-bidang-bidang yang bisa ditulis. Saat menyisipkan peserta baru, Anda harus menyertakan semuanya
+bidang-bidang yang bisa ditulis. Saat menyisipkan peserta baru, Anda harus menyertakan semuanya
kecuali ATTENDEE_NAME.
@@ -698,7 +698,7 @@ kecuali ATTENDEE_NAME.
Menambahkan Peserta
Berikut ini adalah contoh yang menambahkan satu peserta ke kejadian. Perhatikan bahwa
-{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
diperlukan:
@@ -718,17 +718,17 @@ Uri uri = cr.insert(Attendees.CONTENT_URI, values);
Tabel Pengingat
Tiap baris tabel {@link android.provider.CalendarContract.Reminders}
-mewakili satu pengingat untuk sebuah kejadian. Memanggil
+mewakili satu pengingat untuk sebuah kejadian. Memanggil
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()} akan menghasilkan daftar pengingat untuk
-kejadian dengan
+kejadian dengan
{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} yang diberikan.
Tabel berikut mencantumkan bidang-bidang yang bisa ditulis untuk pengingat. Semua bidang harus
disertakan saat menyisipkan pengingat baru. Perhatikan bahwa adaptor sinkronisasi menetapkan
tipe pengingat yang didukungnya dalam tabel {@link
-android.provider.CalendarContract.Calendars}. Lihat
-{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
+android.provider.CalendarContract.Calendars}. Lihat
+{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
untuk detailnya.
@@ -773,16 +773,16 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
Tabel Instances
-
Tabel
+
Tabel
{@link android.provider.CalendarContract.Instances} menyimpan
waktu mulai dan waktu selesai kejadian. Tiap baris dalam tabel ini
mewakili satu bentuk kejadian. Tabel instance tidak bisa ditulis dan hanya
menyediakan sebuah cara untuk membuat query kejadian.
-
Tabel berikut mencantumkan beberapa bidang yang bisa Anda query untuk suatu instance. Perhatikan
-bahwa zona waktu didefinisikan oleh
-{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
-dan
+
Tabel berikut mencantumkan beberapa bidang yang bisa Anda query untuk suatu instance. Perhatikan
+bahwa zona waktu didefinisikan oleh
+{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
+dan
{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_INSTANCES}.
- Anda juga bisa mengacu ke URI dengan
-{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
-Untuk contoh yang menggunakan intent ini, lihat Menggunakan intent untuk menampilkan data kalender.
+ Anda juga bisa mengacu ke URI dengan
+{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
+Untuk contoh yang menggunakan intent ini, lihat Menggunakan intent untuk menampilkan data kalender.
Membuka kalender pada waktu yang ditetapkan oleh <ms_since_epoch>.
@@ -996,7 +996,7 @@ Untuk contoh penggunaan intent ini, lihat file manifesnya.
-
+
Bila pengguna menjalankan aplikasi yang menggunakan pendekatan ini, aplikasi akan mengirim
izin ke Kalender untuk menyelesaikan penambahan kejadian. Intent {@link
android.content.Intent#ACTION_INSERT INSERT} menggunakan bidang-bidang ekstra
untuk mengisi formulir lebih dahulu dengan detail kejadian dalam Kalender. Pengguna nanti bisa
membatalkan kejadian, mengedit formulir sebagaimana diperlukan, atau menyimpan kejadian ke
kalender mereka.
-
+
Berikut ini adalah cuplikan kode yang menjadwalkan kejadian pada tanggal 19 Januari 2012, yang berjalan
dari 7:30 pagi hingga 8:30 pagi Perhatikan hal-hal berikut tentang cuplikan kode ini:
-
Cuplikan kode ini menetapkan {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
+
Cuplikan kode ini menetapkan {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
sebagai URI-nya.
-
+
Cuplikan kode ini menggunakan bidang-bidang ekstra {@link
android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME
CalendarContract.EXTRA_EVENT_BEGIN_TIME} dan {@link
@@ -1083,10 +1083,10 @@ android.provider.CalendarContract#EXTRA_EVENT_END_TIME
CalendarContract.EXTRA_EVENT_END_TIME} untuk mengisi dahulu formulir
dengan waktu kejadian. Nilai-nilai untuk waktu ini harus dalam milidetik UTC
sejak waktu patokan.
-
+
Cuplikan kode ini menggunakan bidang ekstra {@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}
untuk memberikan daftar undangan yang dipisah koma, yang ditetapkan melalui alamat email.
Adaptor sinkronisasi perlu menetapkan bahwa dirinya sebuah adaptor sinkronisasi dengan mengatur {@link android.provider.CalendarContract#CALLER_IS_SYNCADAPTER} ke true.
-
-
+
+
Adaptor sinkronisasi perlu memberikan {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_NAME} dan {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} sebagai parameter query dalam URI.
-
+
Adaptor sinkronisasi memiliki akses tulis ke lebih banyak kolom daripada aplikasi atau widget.
- Misalnya, aplikasi hanya bisa mengubah sedikit karakteristik kalender,
+ Misalnya, aplikasi hanya bisa mengubah sedikit karakteristik kalender,
misalnya nama, nama tampilan, pengaturan visibilitas, dan apakah kalender
disinkronkan atau tidak. Sebagai perbandingan, adaptor sinkronisasi bisa mengakses bukan hanya kolom-kolom itu, namun banyak kolom lainnya,
misalnya warna kalender, zona waktu, tingkat akses, lokasi, dan seterusnya.
-Akan tetapi, adaptor sinkronisasi dibatasi pada ACCOUNT_NAME dan
+Akan tetapi, adaptor sinkronisasi dibatasi pada ACCOUNT_NAME dan
ACCOUNT_TYPE yang ditetapkannya.
Berikut ini adalah metode pembantu yang bisa Anda gunakan untuk menghasilkan URI bagi penggunaan dengan adaptor sinkronisasi:
@@ -1180,5 +1180,5 @@ Akan tetapi, adaptor sinkronisasi dibatasi pada ACCOUNT_NAME dan
.appendQueryParameter(Calendars.ACCOUNT_TYPE, accountType).build();
}
-
Untuk contoh implementasi adaptor sinkronisasi (yang tidak terkait secara khusus dengan Kalender), lihat
+
Untuk contoh implementasi adaptor sinkronisasi (yang tidak terkait secara khusus dengan Kalender), lihat
SampleSyncAdapter.
diff --git a/docs/html-intl/intl/in/guide/topics/providers/content-provider-basics.jd b/docs/html-intl/intl/in/guide/topics/providers/content-provider-basics.jd
index c4003caba88f3..4af92771f7e1c 100644
--- a/docs/html-intl/intl/in/guide/topics/providers/content-provider-basics.jd
+++ b/docs/html-intl/intl/in/guide/topics/providers/content-provider-basics.jd
@@ -236,7 +236,7 @@ page.title=Dasar-Dasar Penyedia Konten
Misalnya, untuk mendapatkan daftar kata dan lokalnya dari Penyedia Kamus Pengguna,
Anda memanggil {@link android.content.ContentResolver#query ContentResolver.query()}.
Metode {@link android.content.ContentResolver#query query()} memanggil
- metode {@link android.content.ContentProvider#query ContentProvider.query()} yang didefinisikan oleh
+ metode {@link android.content.ContentProvider#query ContentProvider.query()} yang didefinisikan oleh
Penyedia Kamus Pengguna. Baris-baris kode berikut menunjukkan sebuah
panggilan {@link android.content.ContentResolver#query ContentResolver.query()}:
Tabel 2 menampilkan cara argumen untuk
- {@link android.content.ContentResolver#query
+ {@link android.content.ContentResolver#query
query(Uri,projection,selection,selectionArgs,sortOrder)} cocok dengan sebuah pernyataan SELECT di SQL:
@@ -310,7 +310,7 @@ mCursor = getContentResolver().query(
{@link android.provider.UserDictionary.Words#CONTENT_URI} mengandung URI konten dari
tabel "words" kamus pengguna. Objek {@link android.content.ContentResolver}
akan mengurai otoritas URI, dan menggunakannya untuk "mengetahui" penyedia dengan
- membandingkan otoritas tersebut dengan sebuah tabel sistem berisi penyedia yang dikenal.
+ membandingkan otoritas tersebut dengan sebuah tabel sistem berisi penyedia yang dikenal.
{@link android.content.ContentResolver} kemudian bisa mengirim argumen query ke penyedia
yang benar.
@@ -343,8 +343,8 @@ Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
salah satunya.
- Catatan: Kelas-kelas {@link android.net.Uri} dan {@link android.net.Uri.Builder}
- berisi metode praktis untuk membangun objek dari string URI yang tersusun dengan baik.
+ Catatan: Kelas-kelas {@link android.net.Uri} dan {@link android.net.Uri.Builder}
+ berisi metode praktis untuk membangun objek dari string URI yang tersusun dengan baik.
{@link android.content.ContentUris} berisi metode praktis untuk menambahkan nilai ID ke
URI. Cuplikan kode sebelumnya menggunakan {@link android.content.ContentUris#withAppendedId
withAppendedId()} untuk menambahkan id ke URI konten User Dictionary.
@@ -359,8 +359,8 @@ Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
Demi kejelasan, cuplikan kode di bagian ini memanggil
- {@link android.content.ContentResolver#query ContentResolver.query()} pada "UI thread"". Akan tetapi, dalam
- kode sesungguhnya, Anda harus melakukan query secara asinkron pada sebuah thread terpisah. Satu cara melakukannya
+ {@link android.content.ContentResolver#query ContentResolver.query()} pada "UI thread"". Akan tetapi, dalam
+ kode sesungguhnya, Anda harus melakukan query secara asinkron pada sebuah thread terpisah. Satu cara melakukannya
adalah menggunakan kelas {@link android.content.CursorLoader}, yang dijelaskan
lebih detail dalam panduan
Loader. Juga, baris-baris kode tersebut hanyalah cuplikan; tidak menunjukkan sebuah aplikasi
@@ -428,7 +428,7 @@ String[] mSelectionArgs = {""};
Cuplikan berikutnya menampilkan cara menggunakan
{@link android.content.ContentResolver#query ContentResolver.query()}, dengan menggunakan Penyedia Kamus Pengguna
- sebagai contoh. Query klien penyedia serupa dengan query SQL, dan berisi satu
+ sebagai contoh. Query klien penyedia serupa dengan query SQL, dan berisi satu
set kolom yang akan dihasilkan, satu set kriteria pemilihan, dan urutan sortir.
Ekspresi yang menetapkan baris yang harus diambil dipecah menjadi klausa pemilihan dan
argumen pemilihan. Klausa pemilihan adalah kombinasi ekspresi logis dan boolean,
- nama kolom, dan nilai (variabel mSelectionClause). Jika Anda menetapkan
- parameter ? yang bisa diganti, sebagai ganti nilai, metode query akan mengambil nilai
+ nama kolom, dan nilai (variabel mSelectionClause). Jika Anda menetapkan
+ parameter ? yang bisa diganti, sebagai ganti nilai, metode query akan mengambil nilai
dari larik argumen pemilihan (variabel mSelectionArgs).
- Sebuah klausa pemilihan yang menggunakan ? sebagai parameter yang bisa diganti dan sebuah larik
+ Sebuah klausa pemilihan yang menggunakan ? sebagai parameter yang bisa diganti dan sebuah larik
argumen pemilihan adalah cara yang lebih disukai untuk menyebutkan pemilihan, sekalipun penyedia tidak
dibuat berdasarkan database SQL.
Menampilkan hasil query
- Metode klien {@link android.content.ContentResolver#query ContentResolver.query()} selalu
- menghasilkan {@link android.database.Cursor} berisi kolom-kolom yang ditetapkan oleh
+ Metode klien {@link android.content.ContentResolver#query ContentResolver.query()} selalu
+ menghasilkan {@link android.database.Cursor} berisi kolom-kolom yang ditetapkan oleh
proyeksi query untuk baris yang cocok dengan kriteria pemilihan query. Objek
- {@link android.database.Cursor} menyediakan akses baca acak ke baris dan kolom yang
- dimuatnya. Dengan metode {@link android.database.Cursor}, Anda bisa mengulang baris-baris dalam
+ {@link android.database.Cursor} menyediakan akses baca acak ke baris dan kolom yang
+ dimuatnya. Dengan metode {@link android.database.Cursor}, Anda bisa mengulang baris-baris dalam
hasil, menentukan tipe data tiap kolom, mengambil data dari kolom, dan memeriksa
- properti lain dari hasil. Beberapa implementasi {@link android.database.Cursor}
- akan memperbarui objek secara otomatis bila data penyedia berubah, atau memicu metode dalam objek pengamat
+ properti lain dari hasil. Beberapa implementasi {@link android.database.Cursor}
+ akan memperbarui objek secara otomatis bila data penyedia berubah, atau memicu metode dalam objek pengamat
bila {@link android.database.Cursor} berubah, atau keduanya.
@@ -703,14 +703,14 @@ if (mCursor != null) {
Untuk mendapatkan izin yang diperlukan untuk mengakses penyedia, aplikasi memintanya dengan elemen
<uses-permission>
- dalam file manifesnya. Bila Android Package Manager memasang aplikasi, pengguna
- harus menyetujui semua izin yang diminta aplikasi. Jika pengguna menyetujui semuanya,
+ dalam file manifesnya. Bila Android Package Manager memasang aplikasi, pengguna
+ harus menyetujui semua izin yang diminta aplikasi. Jika pengguna menyetujui semuanya,
Package Manager akan melanjutkan instalasi; jika pengguna tidak menyetujui, Package Manager
akan membatalkan instalasi.
@@ -793,8 +793,8 @@ content://user_dictionary/words/<id_value>
Untuk memperbarui sebuah baris, gunakan objek {@link android.content.ContentValues} dengan
nilai-nilai yang diperbarui, persis seperti yang Anda lakukan pada penyisipan, dan kriteria pemilihan persis seperti yang Anda lakukan pada query.
Metode klien yang Anda gunakan adalah
- {@link android.content.ContentResolver#update ContentResolver.update()}. Anda hanya perlu menambahkan
- nilai-nilai ke objek {@link android.content.ContentValues} untuk kolom yang sedang Anda perbarui. Jika Anda
+ {@link android.content.ContentResolver#update ContentResolver.update()}. Anda hanya perlu menambahkan
+ nilai-nilai ke objek {@link android.content.ContentValues} untuk kolom yang sedang Anda perbarui. Jika Anda
ingin membersihkan konten kolom, aturlah nilai ke null.
Anda juga harus membersihkan input pengguna bila memanggil
- {@link android.content.ContentResolver#update ContentResolver.update()}. Untuk mengetahui selengkapnya tentang
+ {@link android.content.ContentResolver#update ContentResolver.update()}. Untuk mengetahui selengkapnya tentang
hal ini, bacalah bagian Melindungi dari input merusak.
Anda juga harus membersihkan input pengguna bila memanggil
- {@link android.content.ContentResolver#delete ContentResolver.delete()}. Untuk mengetahui selengkapnya tentang
+ {@link android.content.ContentResolver#delete ContentResolver.delete()}. Untuk mengetahui selengkapnya tentang
hal ini, bacalah bagian Melindungi dari input merusak.
Tipe data lain yang sering digunakan penyedia adalah Binary Large OBject (BLOB) yang diimplementasikan sebagai
- larik byte 64 KB. Anda bisa melihat tipe data yang tersedia dengan memperhatikan metode "get"
+ larik byte 64 KB. Anda bisa melihat tipe data yang tersedia dengan memperhatikan metode "get"
kelas {@link android.database.Cursor}.
- Bagian Acuan Tipe MIME menerangkan
+ Bagian Acuan Tipe MIME menerangkan
sintaks tipe MIME baik yang standar maupun custom.
@@ -946,9 +946,9 @@ mRowsDeleted = getContentResolver().delete(
Untuk mengakses penyedia dalam "mode batch",
buat satu larik objek {@link android.content.ContentProviderOperation}, kemudian
kirim larik itu ke penyedia konten dengan
- {@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}. Anda meneruskan
- otoritas penyedia konten ke metode ini, daripada URI konten tertentu.
- Ini memungkinkan tiap objek {@link android.content.ContentProviderOperation} dalam larik untuk bekerja
+ {@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}. Anda meneruskan
+ otoritas penyedia konten ke metode ini, daripada URI konten tertentu.
+ Ini memungkinkan tiap objek {@link android.content.ContentProviderOperation} dalam larik untuk bekerja
terhadap tabel yang berbeda. Panggilan ke {@link android.content.ContentResolver#applyBatch
ContentResolver.applyBatch()} menghasilkan satu larik hasil.
@@ -1011,7 +1011,7 @@ mRowsDeleted = getContentResolver().delete(
Penyedia mendefinisikan izin URI untuk URI konten dalam manifesnya, dengan menggunakan atribut
android:grantUriPermission
- dari elemen
+ dari elemen
<provider>
, serta elemen anak
<grant-uri-permission>
@@ -1184,7 +1184,7 @@ content://com.example.trains/Line2/5
vnd.android.cursor.item/vnd.example.line2
- Kebanyakan penyedia konten mendefinisikan konstanta kelas kontrak untuk tipe MIME yang digunakannya. Kelas kontrak
+ Kebanyakan penyedia konten mendefinisikan konstanta kelas kontrak untuk tipe MIME yang digunakannya. Kelas kontrak
{@link android.provider.ContactsContract.RawContacts} pada Penyedia Kontak
misalnya, mendefinisikan konstanta
{@link android.provider.ContactsContract.RawContacts#CONTENT_ITEM_TYPE} untuk tipe MIME
diff --git a/docs/html-intl/intl/in/guide/topics/providers/content-provider-creating.jd b/docs/html-intl/intl/in/guide/topics/providers/content-provider-creating.jd
index fefce703c2c8c..7fbc613ff79c9 100644
--- a/docs/html-intl/intl/in/guide/topics/providers/content-provider-creating.jd
+++ b/docs/html-intl/intl/in/guide/topics/providers/content-provider-creating.jd
@@ -1171,7 +1171,7 @@ metadata lain yang melekat ke penyedia. Kelas
android:label: Label informatif yang menjelaskan penyedia atau
- datanya, atau keduanya. Label ini muncul dalam daftar aplikasi di
+ datanya, atau keduanya. Label ini muncul dalam daftar aplikasi di
Settings > Apps > All.
@@ -1189,7 +1189,7 @@ metadata lain yang melekat ke penyedia. Kelas
Aplikasi bisa mengakses penyedia konten secara tidak langsung dengan sebuah {@link android.content.Intent}.
Aplikasi tidak memanggil satu pun dari metode-metode {@link android.content.ContentResolver} atau
{@link android.content.ContentProvider}. Sebagai gantinya, aplikasi mengirim intent yang memulai aktivitas,
- yang sering kali merupakan bagian dari aplikasi penyedia sendiri. Aktivitas tujuan bertugas
+ yang sering kali merupakan bagian dari aplikasi penyedia sendiri. Aktivitas tujuan bertugas
mengambil dan menampilkan data dalam UI-nya. Bergantung pada tindakan dalam intent,
aktivitas tujuan juga bisa meminta pengguna untuk membuat modifikasi pada data penyedia.
Intent juga bisa berisi data "ekstra" yang menampilkan aktivitas tujuan
diff --git a/docs/html-intl/intl/in/guide/topics/providers/content-providers.jd b/docs/html-intl/intl/in/guide/topics/providers/content-providers.jd
index fc6f12b6f569c..2dcd55e8fc29e 100644
--- a/docs/html-intl/intl/in/guide/topics/providers/content-providers.jd
+++ b/docs/html-intl/intl/in/guide/topics/providers/content-providers.jd
@@ -69,7 +69,7 @@ menempelkan data atau file yang kompleks dari aplikasi Anda ke aplikasi lain.
Android sendiri berisi penyedia konten yang mengelola data seperti informasi audio, video, gambar, dan
kontak pribadi. Anda bisa melihat sebagian informasi ini tercantum dalam dokumentasi
- acuan untuk paket
+ acuan untuk paket
android.provider. Dengan beberapa batasan, semua penyedia ini bisa diakses oleh aplikasi Android
apa saja.
diff --git a/docs/html-intl/intl/in/guide/topics/providers/document-provider.jd b/docs/html-intl/intl/in/guide/topics/providers/document-provider.jd
index c066e85b283d4..f85746753c015 100644
--- a/docs/html-intl/intl/in/guide/topics/providers/document-provider.jd
+++ b/docs/html-intl/intl/in/guide/topics/providers/document-provider.jd
@@ -96,7 +96,7 @@ walaupun cara penyedia dokumen Anda secara fisik menyimpan data adalah terserah
Platform Android terdiri dari beberapa penyedia dokumen bawaan, seperti
Downloads, Images, dan Videos.
-
Aplikasi klien—Aplikasi custom yang memanggil intent
+
Aplikasi klien—Aplikasi custom yang memanggil intent
{@link android.content.Intent#ACTION_OPEN_DOCUMENT} dan/atau
{@link android.content.Intent#ACTION_CREATE_DOCUMENT} dan menerima
file yang dihasilkan penyedia dokumen.
@@ -446,7 +446,7 @@ bisa terus menulis ke dokumen itu.
Menghapus dokumen
-
Jika Anda memiliki URI dokumen dan
+
Jika Anda memiliki URI dokumen dan
{@link android.provider.DocumentsContract.Document#COLUMN_FLAGS Document.COLUMN_FLAGS}
dokumen berisi
{@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_DELETE SUPPORTS_DELETE},
diff --git a/docs/html-intl/intl/in/guide/topics/resources/accessing-resources.jd b/docs/html-intl/intl/in/guide/topics/resources/accessing-resources.jd
index e4a0bea1e36ab..6774557b9e62e 100644
--- a/docs/html-intl/intl/in/guide/topics/resources/accessing-resources.jd
+++ b/docs/html-intl/intl/in/guide/topics/resources/accessing-resources.jd
@@ -60,7 +60,7 @@ melihat ke sana untuk menemukan ID sumber daya. ID sumber daya selalu terdiri da
string}, {@code drawable}, dan {@code layout}. Untuk mengetahui selengkapnya tentang berbagai tipe, lihat Tipe Sumber Daya.
Nama sumber daya, bisa berupa: nama file,
-tidak termasuk ekstensi; atau nilai dalam atribut {@code android:name} XML, jika
+tidak termasuk ekstensi; atau nilai dalam atribut {@code android:name} XML, jika
sumber daya itu sebuah nilai sederhana (misalnya sebuah string).
@@ -259,8 +259,8 @@ mengacu sumber daya sistem, Anda perlu memasukkan nama paketnya. Misalnya:
android:text="@string/hello" />
-
Catatan: Anda harus menggunakan sumber daya string sepanjang
-waktu, sehingga aplikasi Anda bisa dilokalkan untuk bahasa lain.
+
Catatan: Anda harus menggunakan sumber daya string sepanjang
+waktu, sehingga aplikasi Anda bisa dilokalkan untuk bahasa lain.
Untuk informasi tentang cara menciptakan
sumber daya alternatif (seperti string lokal), lihat Menyediakan Sumber Daya Alternatif
. Untuk panduan lengkap melokalkan aplikasi Anda ke bahasa lain,
@@ -332,6 +332,6 @@ android.widget.ArrayAdapter}<String>(this, android.R.layout.simple
Dalam contoh ini, {@link android.R.layout#simple_list_item_1} adalah sumber daya layout yang didefinisikan oleh
platform untuk item di {@link android.widget.ListView}. Anda bisa menggunakannya sebagai ganti menciptakan
-layout sendiri untuk item daftar. Untuk informasi selengkapnya, lihat panduan pengembang
+layout sendiri untuk item daftar. Untuk informasi selengkapnya, lihat panduan pengembang
List View.
diff --git a/docs/html-intl/intl/in/guide/topics/resources/overview.jd b/docs/html-intl/intl/in/guide/topics/resources/overview.jd
index 966800cf7daa5..def4932f4af46 100644
--- a/docs/html-intl/intl/in/guide/topics/resources/overview.jd
+++ b/docs/html-intl/intl/in/guide/topics/resources/overview.jd
@@ -24,7 +24,7 @@ aplikasi, agar Anda bisa memeliharanya secara independen. Mengeksternalkan
sumber daya juga membuat Anda dapat menyediakan sumber daya alternatif yang mendukung konfigurasi
perangkat tertentu seperti bahasa atau ukuran layar yang berbeda, yang semakin penting
seiring semakin banyak tersedianya perangkat berbasis Android dengan konfigurasi berbeda. Untuk
-memberikan kompatibilitas dengan konfigurasi berbeda, Anda harus menata sumber daya dalam
+memberikan kompatibilitas dengan konfigurasi berbeda, Anda harus menata sumber daya dalam
direktori {@code res/} proyek Anda, menggunakan berbagai subdirektori yang mengelompokkan sumber daya menurut tipe
dan konfigurasinya.
@@ -46,7 +46,7 @@ ukuran layar berbeda.
alternatif untuk aplikasi Anda:
Sumber daya default adalah sumber daya yang harus digunakan apa pun
-konfigurasi perangkatnya atau jika tidak ada sumber daya alternatif yang sesuai
+konfigurasi perangkatnya atau jika tidak ada sumber daya alternatif yang sesuai
dengan konfigurasi saat ini.
Sumber daya alternatif adalah sumber daya yang Anda desain untuk digunakan dengan
konfigurasi tertentu. Untuk menetapkan bahwa satu kelompok sumber daya ditujukan bagi konfigurasi tertentu,
diff --git a/docs/html-intl/intl/in/guide/topics/resources/providing-resources.jd b/docs/html-intl/intl/in/guide/topics/resources/providing-resources.jd
index d6bbfc58d9113..9bccd24e643ad 100644
--- a/docs/html-intl/intl/in/guide/topics/resources/providing-resources.jd
+++ b/docs/html-intl/intl/in/guide/topics/resources/providing-resources.jd
@@ -176,7 +176,7 @@ string.
@@ -289,7 +289,7 @@ qualifier konfigurasi.
dari kartu SIM dalam perangkat. Misalnya, mcc310 adalah AS untuk operator mana saja,
mcc310-mnc004 adalah AS untuk Verizon, dan mcc208-mnc00 Prancis untuk
Orange.
-
Jika perangkat menggunakan koneksi radio (ponsel GSM), nilai-nilai MCC dan MNC berasal
+
Jika perangkat menggunakan koneksi radio (ponsel GSM), nilai-nilai MCC dan MNC berasal
dari kartu SIM.
Anda juga dapat menggunakan MNC saja (misalnya, untuk menyertakan sumber daya legal
spesifik untuk negara itu di aplikasi Anda). Jika Anda perlu menetapkan hanya berdasarkan bahasa, maka gunakan qualifier
@@ -312,7 +312,7 @@ dan kode jaringan seluler.
dll.
Bahasa didefinisikan oleh kode bahasa dua huruf ISO
-639-1, bisa juga diikuti dengan kode wilayah
+639-1, bisa juga diikuti dengan kode wilayah
dua huruf ISO
3166-1-alpha-2 (diawali dengan huruf kecil "{@code r}").
@@ -428,8 +428,8 @@ berubah antara lanskap dan potret agar cocok dengan lebar sebenarnya saat ini.Bila aplikasi Anda menyediakan beberapa direktori sumber daya dengan nilai yang berbeda
untuk konfigurasi ini, sistem akan menggunakan nilai terdekat dengan (tanpa melebihi)
lebar layar perangkat saat ini. Nilai
-di sini memperhitungkan dekorasi layar akun, jadi jika perangkat memiliki beberapa
-elemen UI persisten di tepi kiri atau kanan, layar
+di sini memperhitungkan dekorasi layar akun, jadi jika perangkat memiliki beberapa
+elemen UI persisten di tepi kiri atau kanan, layar
menggunakan nilai lebar yang lebih kecil daripada ukuran layar sebenarnya, yang memperhitungkan
elemen UI ini dan mengurangi ruang aplikasi yang tersedia.
Ditambahkan dalam API level 13.
@@ -455,14 +455,14 @@ sumber daya —bersama nilai yang didefinisikan oleh <N>.
berubah antara lanskap dan potret agar cocok dengan tinggi sebenarnya saat ini.
Bila aplikasi menyediakan beberapa direktori sumber daya dengan nilai yang berbeda
untuk konfigurasi ini, sistem akan menggunakan nilai yang terdekat dengan (tanpa melebihi)
- tinggi layar perangkat saat ini. Nilai
+ tinggi layar perangkat saat ini. Nilai
di sini memperhitungkan dekorasi layar akun, jadi jika perangkat memiliki beberapa
elemen UI persisten di tepi atas atau bawah, layar akan
menggunakan nilai tinggi yang lebih kecil daripada ukuran layar sebenarnya, memperhitungkan
-elemen UI ini dan mengurangi ruang aplikasi yang tersedia. Dekorasi
-layar yang tidak tetap (misalnya baris status (status-bar) telepon yang bisa
-disembunyikan saat layar penuh) di sini tidak diperhitungkan, demikian pula
-dekorasi jendela seperti baris judul (title-bar)atau baris tindakan (action-bar), jadi aplikasi harus disiapkan
+elemen UI ini dan mengurangi ruang aplikasi yang tersedia. Dekorasi
+layar yang tidak tetap (misalnya baris status (status-bar) telepon yang bisa
+disembunyikan saat layar penuh) di sini tidak diperhitungkan, demikian pula
+dekorasi jendela seperti baris judul (title-bar)atau baris tindakan (action-bar), jadi aplikasi harus disiapkan
untuk menangani ruang yang agak lebih kecil daripada yang ditetapkan.
Ditambahkan dalam API level 13.
Lihat juga bidang konfigurasi {@link android.content.res.Configuration#screenHeightDp}
@@ -482,35 +482,35 @@ Multi Layar.
-
{@code small}: Layar yang berukuran serupa dengan
-layar QVGA densitas rendah. Ukuran layout minimum untuk layar kecil
-adalah sekitar 320x426 satuan dp. Misalnya QVGA densitas rendah
+
{@code small}: Layar yang berukuran serupa dengan
+layar QVGA densitas rendah. Ukuran layout minimum untuk layar kecil
+adalah sekitar 320x426 satuan dp. Misalnya QVGA densitas rendah
dan VGA densitas tinggi.
-
{@code normal}: Layar yang berukuran serupa dengan
+
{@code normal}: Layar yang berukuran serupa dengan
layar HVGA densitas sedang. Ukuran layout minimum untuk
-layar normal adalah sekitar 320x470 satuan dp. Contoh layar seperti itu adalah
+layar normal adalah sekitar 320x470 satuan dp. Contoh layar seperti itu adalah
WQVGA densitas rendah, HVGA densitas sedang, WVGA
densitas tinggi.
-
{@code large}: Layar yang berukuran serupa dengan
+
{@code large}: Layar yang berukuran serupa dengan
layar VGA densitas sedang.
Ukuran layout minimum untuk layar besar adalah sekitar 480x640 satuan dp.
Misalnya layar VGA dan WVGA densitas sedang.
-
{@code xlarge}: Layar yang jauh lebih besar dari layar HVGA
-densitas sedang tradisional. Ukuran layout minimum untuk
-layar ekstra besar adalah sekitar 720x960 satuan dp. Perangkat dengan layar ekstra besar
+
{@code xlarge}: Layar yang jauh lebih besar dari layar HVGA
+densitas sedang tradisional. Ukuran layout minimum untuk
+layar ekstra besar adalah sekitar 720x960 satuan dp. Perangkat dengan layar ekstra besar
seringkali terlalu besar untuk dibawa dalam saku dan kemungkinan besar
berupa perangkat bergaya tablet. Ditambahkan dalam API level 9.
-
Catatan: Menggunakan qualifier ukuran tidak berarti bahwa
+
Catatan: Menggunakan qualifier ukuran tidak berarti bahwa
sumber daya hanya untuk layar ukuran itu saja. Jika Anda tidak menyediakan sumber
daya alternatif dengan qualifier yang lebih cocok dengan konfigurasi perangkat saat ini, sistem dapat menggunakan sumber daya
mana saja yang paling cocok.
-
Perhatian: Jika semua sumber daya Anda menggunakan
-qualifier yang berukuran lebih besar daripada layar saat ini, sistem tidak akan menggunakannya dan aplikasi
+
Perhatian: Jika semua sumber daya Anda menggunakan
+qualifier yang berukuran lebih besar daripada layar saat ini, sistem tidak akan menggunakannya dan aplikasi
Anda akan crash saat runtime (misalnya, jika semua sumber daya layout ditandai dengan qualifier {@code
xlarge}, namun perangkat memiliki ukuran layar normal).
Lihat juga bidang konfigurasi {@link android.content.res.Configuration#screenLayout},
@@ -552,7 +552,7 @@ tidak ada kaitannya dengan orientasi layar.
Ini bisa berubah selama masa pakai aplikasi Anda jika pengguna memutar
layar. Lihat Menangani Perubahan Runtime untuk
informasi tentang bagaimana hal ini memengaruhi aplikasi Anda selama runtime.
-
Lihat juga bidang konfigurasi {@link android.content.res.Configuration#orientation},
+
Lihat juga bidang konfigurasi {@link android.content.res.Configuration#orientation},
yang menunjukkan orientasi perangkat saat ini.
@@ -569,19 +569,19 @@ yang menunjukkan orientasi perangkat saat ini.
{@code car}: Perangkat sedang menampilkan di dudukan perangkat di mobil
{@code desk}: Perangkat sedang menampilkan di dudukan perangkat di meja
-
{@code television}: Perangkat sedang menampilkan di televisi, yang menyediakan
+
{@code television}: Perangkat sedang menampilkan di televisi, yang menyediakan
pengalaman "sepuluh kaki" dengan UI-nya pada layar besar yang berada jauh dari pengguna,
-terutama diorientasikan seputar DPAD atau
+terutama diorientasikan seputar DPAD atau
interaksi non-pointer lainnya
-
{@code appliance}: Perangkat berlaku sebagai
+
{@code appliance}: Perangkat berlaku sebagai
alat, tanpa tampilan
{@code watch}: Perangkat memiliki tampilan dan dikenakan di pergelangan tangan
Ditambahkan dalam API level 8, televisi ditambahkan dalam API 13, jam ditambahkan dalam API 20.
-
Untuk informasi tentang cara aplikasi merespons saat perangkat dimasukkan
+
Ini bisa berubah selama masa pakai aplikasi jika pengguna menempatkan perangkat di
+
Ini bisa berubah selama masa pakai aplikasi jika pengguna menempatkan perangkat di
dudukannya. Anda dapat mengaktifkan atau menonaktifkan sebagian mode ini menggunakan {@link
android.app.UiModeManager}. Lihat Menangani Perubahan Runtime untuk
informasi tentang bagaimana hal ini memengaruhi aplikasi Anda selama runtime.
@@ -601,7 +601,7 @@ informasi tentang bagaimana hal ini memengaruhi aplikasi Anda selama runtime.Ditambahkan dalam API level 8.
Ini bisa berubah selama masa pakai aplikasi jika mode malam dibiarkan dalam
mode otomatis (default), dalam hal ini perubahan mode berdasarkan pada waktu hari. Anda dapat mengaktifkan
-atau menonaktifkan mode ini menggunakan {@link android.app.UiModeManager}. Lihat Menangani Perubahan Runtime untuk informasi tentang bagaimana hal ini memengaruhi
+atau menonaktifkan mode ini menggunakan {@link android.app.UiModeManager}. Lihat Menangani Perubahan Runtime untuk informasi tentang bagaimana hal ini memengaruhi
aplikasi Anda selama runtime.
@@ -627,8 +627,8 @@ aplikasi Anda selama runtime.
Level 8.
{@code xxhdpi}: Layar densitas ekstra-ekstra-tinggi; sekitar 480 dpi. Ditambahkan dalam API
Level 16.
{@code xxxhdpi}: Densitas ekstra-ekstra-ekstra-tinggi (hanya ikon launcher,
+lihat catatan
dalam Mendukung Beberapa Layar); sekitar 640 dpi. Ditambahkan dalam API
Level 18.
{@code nodpi}: Ini bisa digunakan untuk sumber daya bitmap yang tidak ingin Anda
@@ -696,7 +696,7 @@ fisik. Lihat Menangani Perubahan Runtime untu
hal ini memengaruhi aplikasi Anda selama runtime.
Lihat juga bidang konfigurasi {@link
android.content.res.Configuration#hardKeyboardHidden} dan {@link
-android.content.res.Configuration#keyboardHidden}, yang menunjukkan visibilitas
+android.content.res.Configuration#keyboardHidden}, yang menunjukkan visibilitas
keyboard fisik dan visibilitas segala jenis keyboard (termasuk keyboard perangkat lunak), masing-masing.
@@ -716,7 +716,7 @@ pengguna
{@code 12key}: Perangkat memiliki keyboard fisik 12 tombol, baik terlihat maupun tidak
pada pengguna.
-
Lihat juga bidang konfigurasi {@link android.content.res.Configuration#keyboard},
+
Lihat juga bidang konfigurasi {@link android.content.res.Configuration#keyboard},
yang menunjukkan metode utama input teks yang tersedia.
@@ -810,7 +810,7 @@ Sumber Daya.
Anda bisa menetapkan beberapa qualifier untuk satu set sumber daya, yang dipisahkan dengan tanda hubung. Misalnya,
drawable-en-rUS-land berlaku untuk perangkat bahasa Inggris-AS dalam orientasi
lanskap.
-
Qualifier harus dalam urutan seperti yang tercantum dalam tabel 2.
+
Qualifier harus dalam urutan seperti yang tercantum dalam tabel 2.
Misalnya:
Salah: drawable-hdpi-port/
@@ -947,7 +947,7 @@ layout-land/} untuk lanskap dan {@code layout-port/} untuk potret, biarkan salah
{@code layout/} untuk lanskap dan {@code layout-port/} untuk potret.
Sumber daya default perlu disediakan bukan hanya karena aplikasi mungkin berjalan pada
-konfigurasi yang belum Anda antisipasi, namun juga karena versi baru Android terkadang menambahkan
+konfigurasi yang belum Anda antisipasi, namun juga karena versi baru Android terkadang menambahkan
qualifier konfigurasi yang tidak didukung oleh versi lama. Jika Anda menggunakan qualifier sumber daya baru,
namun mempertahankan kompatibilitas kode dengan versi Android yang lebih lama, maka saat versi lama
Android menjalankan aplikasi, aplikasi itu akan crash jika Anda tidak menyediakan sumber daya default, aplikasi
@@ -1058,7 +1058,7 @@ Layar.
Kembali dan ulangi langkah 2, 3, dan 4 hingga tersisa satu direktori. Dalam contoh ini, orientasi
-layar adalah qualifier berikutnya yang memiliki kecocokan.
+layar adalah qualifier berikutnya yang memiliki kecocokan.
Jadi, sumber daya yang tidak menetapkan orientasi layar akan dihapus:
Untuk mempertahankan objek stateful dalam fragmen selama perubahan konfigurasi runtime:
-
Perluas kelas {@link android.app.Fragment} dan deklarasikan referensi ke objek stateful
+
Perluas kelas {@link android.app.Fragment} dan deklarasikan referensi ke objek stateful
Anda.
Panggil {@link android.app.Fragment#setRetainInstance(boolean)} saat fragmen dibuat.
Tambahkan fragmen ke aktivitas.
-
Gunakan {@link android.app.FragmentManager} untuk mengambil fragmen saat aktivitas
+
Gunakan {@link android.app.FragmentManager} untuk mengambil fragmen saat aktivitas
di-restart.
@@ -125,8 +125,8 @@ membocorkan semua tampilan dan sumber daya instance aktivitas semula. (Sumber da
berarti bahwa aplikasi Anda tetap menyimpannya dan tidak bisa dijadikan kumpulan sampah, sehingga bisa banyak
memori yang hilang.)
-
Selanjutnya gunakan {@link android.app.FragmentManager} untuk menambahkan fragmen ke aktivitas.
-Anda bisa memperoleh objek data dari fragmen saat aktivitas memulai kembali selama perubahan
+
Selanjutnya gunakan {@link android.app.FragmentManager} untuk menambahkan fragmen ke aktivitas.
+Anda bisa memperoleh objek data dari fragmen saat aktivitas memulai kembali selama perubahan
konfigurasi runtime. Misalnya, definisikan aktivitas Anda sebagai berikut:
diff --git a/docs/html-intl/intl/in/guide/topics/ui/controls.jd b/docs/html-intl/intl/in/guide/topics/ui/controls.jd
index 7ee2957980a89..3ebf48b5c9d4c 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/controls.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/controls.jd
@@ -69,7 +69,7 @@ semacam kontrol input tertentu, Anda bisa membangun Tombol radio
Mirip dengan kotak cek, hanya saja cuma satu opsi yang bisa dipilih dalam kumpulan tersebut.
diff --git a/docs/html-intl/intl/in/guide/topics/ui/declaring-layout.jd b/docs/html-intl/intl/in/guide/topics/ui/declaring-layout.jd
index 83ff7461e7ac0..1c8a0d6eccaa7 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/declaring-layout.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/declaring-layout.jd
@@ -74,7 +74,7 @@ tertarik dalam membuat instance objek View saat runtime, lihat referensi kelas {
EditText.setText().
Tip: Ketahui selengkapnya berbagai tipe layout dalam Objek
-Layout Umum. Ada juga sekumpulan tutorial tentang cara membangun berbagai layout dalam panduan tutorial
+Layout Umum. Ada juga sekumpulan tutorial tentang cara membangun berbagai layout dalam panduan tutorial
Hello Views.
Tulis XML
@@ -107,7 +107,7 @@ dalam direktori res/layout/ proyek Android, sehingga nanti bisa dik
Muat Sumber Daya XML
-
Saat mengompilasi aplikasi, masing-masing file layout XML akan dikompilasi dalam sebuah sumber daya
+
Saat mengompilasi aplikasi, masing-masing file layout XML akan dikompilasi dalam sebuah sumber daya
{@link android.view.View}. Anda harus memuat sumber daya layout dari kode aplikasi, dalam implementasi
callback {@link android.app.Activity#onCreate(android.os.Bundle) Activity.onCreate()}.
Lakukan dengan memanggil {@link android.app.Activity#setContentView(int) setContentView()},
@@ -367,8 +367,8 @@ kiri anak B) atau terhadap induk (disejajarkan dengan atas induknya).
Membangun Layout dengan Adaptor
-
Bila isi layout bersifat dinamis atau tidak dipastikan sebelumnya, Anda bisa menggunakan layout yang menjadi
-subkelas {@link android.widget.AdapterView} untuk mengisi layout dengan tampilan saat runtime.
+
Bila isi layout bersifat dinamis atau tidak dipastikan sebelumnya, Anda bisa menggunakan layout yang menjadi
+subkelas {@link android.widget.AdapterView} untuk mengisi layout dengan tampilan saat runtime.
Subkelas dari kelas {@link android.widget.AdapterView} menggunakan {@link android.widget.Adapter} untuk
mengikat data ke layoutnya. {@link android.widget.Adapter} berfungsi sebagai penghubung antara sumber data
dan layout{@link android.widget.AdapterView}—{@link android.widget.Adapter}
@@ -445,7 +445,7 @@ harus memasukkan tampilan layout. Misalnya, jika Anda ingin untuk membuat daftar
nama orang dan nomor telepon, Anda bisa melakukan query yang menghasilkan {@link
android.database.Cursor} yang berisi satu baris untuk tiap orang dan kolom-kolom untuk nama dan
nomor. Selanjutnya Anda membuat larik string yang menentukan kolom dari {@link
-android.database.Cursor} yang Anda inginkan dalam layout untuk setiap hasil dan larik integer yang menentukan
+android.database.Cursor} yang Anda inginkan dalam layout untuk setiap hasil dan larik integer yang menentukan
tampilan yang sesuai untuk menempatkan masing-masing kolom:
Bagian-bagian berikutnya dalam panduan ini akan menjelaskan cara menggunakan {@link
android.support.v4.app.DialogFragment} yang dikombinasikan dengan objek {@link android.app.AlertDialog}
-. Jika Anda ingin membuat picker tanggal atau waktu, Anda harus membaca panduan
+. Jika Anda ingin membuat picker tanggal atau waktu, Anda harus membaca panduan
Picker.
Metode set...Button() mengharuskan adanya judul bagi tombol (disediakan
-oleh suatu sumber daya string) dan
-{@link android.content.DialogInterface.OnClickListener} yang mendefinisikan tindakan yang diambil
+oleh suatu sumber daya string) dan
+{@link android.content.DialogInterface.OnClickListener} yang mendefinisikan tindakan yang diambil
bila pengguna menekan tombol.
Ada tiga macam tombol tindakan yang Anda bisa tambahkan:
@@ -247,8 +247,8 @@ bila pengguna menekan tombol.
Anda harus menggunakan tipe ini untuk membatalkan tindakan.
Netral
Anda harus menggunakan tipe ini bila pengguna mungkin tidak ingin melanjutkan tindakan,
- namun tidak ingin membatalkan. Tipe ini muncul antara tombol positif dan
-tombol negatif. Misalnya, tindakan bisa berupa "Ingatkan saya nanti".
+ namun tidak ingin membatalkan. Tipe ini muncul antara tombol positif dan
+tombol negatif. Misalnya, tindakan bisa berupa "Ingatkan saya nanti".
Anda hanya bisa menambahkan salah satu tipe tombol ke {@link
@@ -271,7 +271,7 @@ Dialog dengan satu judul dan daftar.
Daftar pilihan ganda persisten (kotak cek)
-
Untuk membuat daftar pilihan tunggal seperti dalam gambar 3,
+
Untuk membuat daftar pilihan tunggal seperti dalam gambar 3,
gunakan metode {@link android.app.AlertDialog.Builder#setItems setItems()}:
@@ -291,7 +291,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Karena daftar muncul dalam area konten dialog,
dialog tidak bisa menampilkan pesan dan daftar sekaligus dan Anda harus menetapkan judul untuk
-dialog dengan {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
+dialog dengan {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
Untuk menentukan item daftar, panggil {@link
android.app.AlertDialog.Builder#setItems setItems()}, dengan meneruskan larik.
Atau, Anda bisa menetapkan daftar menggunakan {@link
@@ -300,7 +300,7 @@ dengan data dinamis (seperti dari database) dengan menggunakan {@link android.wi
Jika Anda memilih untuk mendukung daftar dengan {@link android.widget.ListAdapter},
selalu gunakan sebuah {@link android.support.v4.content.Loader} agar konten dimuat
-secara asinkron. Hal ini dijelaskan lebih jauh dalam panduan
+secara asinkron. Hal ini dijelaskan lebih jauh dalam panduan
Membuat Layout
dengan Adaptor dan Loader
.
@@ -317,11 +317,11 @@ Daftar item pilihan ganda.
Menambahkan daftar pilihan ganda atau pilihan tunggal persisten
-
Untuk menambahkan daftar item pilihan ganda (kotak cek) atau
-item pilihan tunggal (tombol radio), gunakan masing-masing metode
+
Untuk menambahkan daftar item pilihan ganda (kotak cek) atau
+item pilihan tunggal (tombol radio), gunakan masing-masing metode
{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
-DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()}, atau
-{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()}, atau
+{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()}.
Misalnya, berikut ini cara membuat daftar pilihan ganda seperti
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -373,7 +373,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Walaupun daftar tradisional maupun daftar dengan tombol radio
menyediakan tindakan "pilihan tunggal", Anda harus menggunakan {@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} jika ingin mempertahankan pilihan pengguna.
Yakni, jika nanti membuka dialog lagi untuk menunjukkan pilihan pengguna,
maka Anda perlu membuat daftar dengan tombol radio.
@@ -442,7 +442,7 @@ Anda harus mengubah keluarga font ke {@code "sans-serif"} sehingga kedua bidang
gaya font yang cocok.
Untuk memekarkan layout dalam {@link android.support.v4.app.DialogFragment} Anda,
-ambillah {@link android.view.LayoutInflater} dengan
+ambillah {@link android.view.LayoutInflater} dengan
{@link android.app.Activity#getLayoutInflater()} dan panggil
{@link android.view.LayoutInflater#inflate inflate()}, dengan parameter pertama
adalah ID sumber daya layout dan parameter kedua adalah tampilan induk untuk layout.
@@ -470,7 +470,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -505,7 +505,7 @@ antarmuka yang akan digunakan untuk mengirim kembali suatu kejadian ke aktivitas
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ melalui implementasi antarmuka {@code NoticeDialogListener}:
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -638,12 +638,12 @@ android.support.v4.app.Fragment} yang bisa ditanamkan.
Akan tetapi, dalam hal ini Anda tidak bisa menggunakan {@link android.app.AlertDialog.Builder AlertDialog.Builder}
atau objek {@link android.app.Dialog} lain untuk membangun dialog. Jika
-Anda ingin {@link android.support.v4.app.DialogFragment}
+Anda ingin {@link android.support.v4.app.DialogFragment}
bisa ditanamkan, Anda harus mendefinisikan dialog UI dalam layout, lalu memuat layout itu dalam metode callback
{@link android.support.v4.app.DialogFragment#onCreateView
onCreateView()}.
-
Berikut ini adalah contoh {@link android.support.v4.app.DialogFragment} yang bisa muncul sebagai
+
Berikut ini adalah contoh {@link android.support.v4.app.DialogFragment} yang bisa muncul sebagai
dialog maupun fragmen yang bisa ditanamkan (menggunakan layout bernama purchase_items.xml):
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ atau UI layar penuh, berdasarkan ukuran layar:
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
@@ -776,7 +776,7 @@ android.support.v4.app.DialogFragment#onDismiss onDismiss()} dalam {@link
android.support.v4.app.DialogFragment} Anda.
Anda juga bisa membatalkan dialog. Ini merupakan kejadian khusus yang menunjukkan bahwa pengguna
-secara eksplisit meninggalkan dialog tanpa menyelesaikan tugas. Hal ini terjadi jika pengguna menekan tombol
+secara eksplisit meninggalkan dialog tanpa menyelesaikan tugas. Hal ini terjadi jika pengguna menekan tombol
Back, menyentuh layar di luar area dialog,
atau jika Anda secara eksplisit memanggil {@link android.app.Dialog#cancel()} pada {@link
android.app.Dialog} (seperti saat merespons tombol "Cancel" dalam dialog).
diff --git a/docs/html-intl/intl/in/guide/topics/ui/menus.jd b/docs/html-intl/intl/in/guide/topics/ui/menus.jd
index 2cd3e6a33aa5e..1ee0244c1a9af 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/menus.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/menus.jd
@@ -60,7 +60,7 @@ dan konsisten, Anda harus menggunakan API {@link android.view.Menu} untuk menyaj
tindakan dan opsi lain dalam aktivitas kepada pengguna.
Mulai dengan Android 3.0 (API level 11), perangkat berbasis Android tidak perlu lagi
-menyediakan tombol Menu tersendiri. Dengan perubahan ini, aplikasi Android harus bermigrasi dari
+menyediakan tombol Menu tersendiri. Dengan perubahan ini, aplikasi Android harus bermigrasi dari
dependensi pada panel menu 6 item biasa, dan sebagai ganti menyediakan action-bar untuk menyajikan
berbagai tindakan pengguna yang lazim.
@@ -83,9 +83,9 @@ tidak memilikinya), sehingga Anda harus bermigrasi ke penggunaan action-bar untu
opsi lainnya.
Menu konteks adalah menu mengambang yang muncul saat
pengguna mengklik lama pada suatu elemen. Menu ini menyediakan tindakan yang memengaruhi konten atau
bingkai konteks yang dipilih.
@@ -94,7 +94,7 @@ item tindakan yang memengaruhi konten yang dipilih dalam baris di bagian atas la
memilih beberapa item sekaligus.
Menu popup menampilkan daftar item secara vertikal yang dipasang pada tampilan yang
memanggil menu. Ini cocok untuk menyediakan kelebihan tindakan yang terkait dengan konten tertentu atau
@@ -128,14 +128,14 @@ ukuran layar, dan konfigurasi lainnya dengan memanfaatkan kerangka kerja
@@ -273,7 +273,7 @@ dengan API {@link android.view.MenuItem}.
Jika Anda mengembangkan aplikasi untuk Android 2.3.x dan yang lebih rendah, sistem akan memanggil {@link
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} untuk membuat menu opsi
-bila pengguna membuka menu untuk pertama kali. Jika Anda mengembangkan aplikasi untuk Android 3.0 dan yang lebih tinggi,
+bila pengguna membuka menu untuk pertama kali. Jika Anda mengembangkan aplikasi untuk Android 3.0 dan yang lebih tinggi,
sistem akan memanggil {@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} saat
memulai aktivitas, untuk menampilkan item menu pada action-bar.
@@ -285,7 +285,7 @@ memulai aktivitas, untuk menampilkan item menu pada action-bar.
sistem akan memanggil metode {@link android.app.Activity#onOptionsItemSelected(MenuItem)
onOptionsItemSelected()} aktivitas Anda. Metode ini meneruskan {@link android.view.MenuItem} yang dipilih. Anda
bisa mengidentifikasi item dengan memanggil {@link android.view.MenuItem#getItemId()}, yang menghasilkan
-ID unik untuk item menu itu (yang didefinisikan oleh atribut {@code android:id} dalam sumber daya menu atau dengan
+ID unik untuk item menu itu (yang didefinisikan oleh atribut {@code android:id} dalam sumber daya menu atau dengan
integer yang diberikan ke metode {@link android.view.Menu#add(int,int,int,int) add()}). Anda bisa mencocokkan
ID ini dengan item menu yang diketahui untuk melakukan tindakan yang sesuai. Misalnya:
@@ -317,7 +317,7 @@ untuk setiap fragmen (sesuai dengan urutan penambahan fragmen) hingga satu fragm
{@code true} atau semua fragmen telah dipanggil.
Tip: Android 3.0 menambahkan kemampuan mendefinisikan perilaku on-click
-untuk item menu dalam XML, dengan menggunakan atribut {@code android:onClick}. Nilai atribut
+untuk item menu dalam XML, dengan menggunakan atribut {@code android:onClick}. Nilai atribut
harus berupa nama metode yang didefinisikan aktivitas dengan menggunakan menu. Metode
harus bersifat publik dan menerima satu parameter {@link android.view.MenuItem}—bila sistem
memanggilnya, metode ini akan meneruskan item menu yang dipilih. Untuk informasi selengkapnya dan contoh, lihat dokumen Sumber Daya Menu.
@@ -346,7 +346,7 @@ lagi kecuali menu diinvalidkan karena suatu alasan. Akan tetapi, Anda harus meng
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} hanya untuk membuat
status menu awal dan tidak untuk membuat perubahan selama daur hidup aktivitas.
-
Jika Anda ingin mengubah menu opsi berdasarkan
+
Jika Anda ingin mengubah menu opsi berdasarkan
kejadian yang terjadi selama daur hidup aktivitas, Anda bisa melakukannya dalam metode
{@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}. Metode ini
meneruskan objek {@link android.view.Menu} sebagaimana adanya saat ini sehingga Anda bisa mengubahnya,
@@ -363,7 +363,7 @@ ditampilkan pada action-bar. Bila ada kejadian dan Anda ingin melakukan pembarua
memanggil {@link android.app.Activity#invalidateOptionsMenu invalidateOptionsMenu()} untuk meminta
sistem memanggil {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}.
-
Catatan:
+
Catatan:
Anda tidak boleh mengubah item dalam menu opsi berdasarkan {@link android.view.View} yang saat ini
difokus. Saat dalam mode sentuh (bila pengguna tidak sedang menggunakan trackball atau d-pad), tampilan
tidak bisa mengambil fokus, sehingga Anda tidak boleh menggunakan fokus sebagai dasar untuk mengubah
@@ -419,7 +419,7 @@ android.app.Activity#registerForContextMenu(View) registerForContextMenu()}.
Implementasikan metode {@link
-android.view.View.OnCreateContextMenuListener#onCreateContextMenu onCreateContextMenu()}
+android.view.View.OnCreateContextMenuListener#onCreateContextMenu onCreateContextMenu()}
dalam {@link android.app.Activity} atau {@link android.app.Fragment} Anda.
Bila tampilan yang terdaftar menerima kejadian klik-lama, sistem akan memanggil metode {@link
android.view.View.OnCreateContextMenuListener#onCreateContextMenu onCreateContextMenu()}
@@ -445,7 +445,7 @@ dimekarkan.
Bila Anda memanggil {@link android.app.Activity#startActionMode startActionMode()}, sistem akan mengembalikan
{@link android.view.ActionMode} yang dibuat. Dengan menyimpannya dalam variabel anggota, Anda bisa
-membuat perubahan ke action-bar kontekstual sebagai respons terhadap kejadian lainnya. Dalam contoh di atas,
+membuat perubahan ke action-bar kontekstual sebagai respons terhadap kejadian lainnya. Dalam contoh di atas,
{@link android.view.ActionMode} digunakan untuk memastikan bahwa instance {@link android.view.ActionMode}
tidak dibuat kembali jika sudah aktif, dengan memeriksa apakah anggota bernilai nol sebelum memulai
mode tindakan.
Anda juga bisa menawarkan layanan aktivitas Anda pada aplikasi lainnya, sehingga
aplikasi Anda bisa disertakan dalam menu aplikasi lain (membalik peran yang dijelaskan di atas).
-
Agar bisa dimasukkan dalam menu aplikasi lain, Anda perlu mendefinisikan
+
Agar bisa dimasukkan dalam menu aplikasi lain, Anda perlu mendefinisikan
filter intent seperti biasa, tetapi pastikan menyertakan nilai-nilai {@link android.content.Intent#CATEGORY_ALTERNATIVE}
dan/atau {@link android.content.Intent#CATEGORY_SELECTED_ALTERNATIVE} untuk
kategori filter intent. Misalnya:
Untuk contoh aplikasi yang menggunakan teknik ini, lihat contoh kode
+
Untuk contoh aplikasi yang menggunakan teknik ini, lihat contoh kode
Note
Pad.
diff --git a/docs/html-intl/intl/in/guide/topics/ui/notifiers/notifications.jd b/docs/html-intl/intl/in/guide/topics/ui/notifiers/notifications.jd
index 9033b9f744f3e..bb48b80a0bcc6 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/notifiers/notifications.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/notifiers/notifications.jd
@@ -147,7 +147,7 @@ pemberitahuan, Anda meneruskan objek {@link android.app.Notification} ke sistem
Dalam {@link android.app.Notification}, tindakan itu sendiri didefinisikan oleh
- {@link android.app.PendingIntent} berisi
+ {@link android.app.PendingIntent} berisi
{@link android.content.Intent} yang memulai
{@link android.app.Activity} dalam aplikasi Anda. Untuk mengaitkan
{@link android.app.PendingIntent} dengan gestur, panggil metode
@@ -174,12 +174,12 @@ pemberitahuan, Anda meneruskan objek {@link android.app.Notification} ke sistem
android.support.v4.app.NotificationCompat}. Ada
lima level prioritas, mulai dari {@link
android.support.v4.app.NotificationCompat#PRIORITY_MIN} (-2) hingga {@link
- android.support.v4.app.NotificationCompat#PRIORITY_MAX} (2); jika tidak diatur,
+ android.support.v4.app.NotificationCompat#PRIORITY_MAX} (2); jika tidak diatur,
prioritas default akan ditetapkan {@link
android.support.v4.app.NotificationCompat#PRIORITY_DEFAULT} (0).
Untuk informasi tentang mengatur level prioritas, lihat "Mengatur
- dan mengelola prioritas pemberitahuan dengan benar" dalam panduan
+ dan mengelola prioritas pemberitahuan dengan benar" dalam panduan
Desain Pemberitahuan.
- Bila perlu mengeluarkan pemberitahuan beberapa kali untuk tipe kejadian yang sama,
+ Bila perlu mengeluarkan pemberitahuan beberapa kali untuk tipe kejadian yang sama,
hindari membuat pemberitahuan yang sama sekali baru. Sebagai gantinya, Anda harus mempertimbangkan untuk memperbarui
pemberitahuan sebelumnya, baik dengan mengubah sebagian nilainya atau dengan menambahkan nilai, atau keduanya.
- Tambahkan back-stack ke stack-builder dengan memanggil
+ Tambahkan back-stack ke stack-builder dengan memanggil
{@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()}.
Untuk setiap {@link android.app.Activity} dalam hierarki yang telah Anda definisikan dalam
manifes, back-stack berisi objek {@link android.content.Intent} yang
@@ -933,7 +933,7 @@ untuk informasi selengkapnya tentang API baru untuk mengelola sesi media dan men
tampilan normal dibatasi hingga 64 dp, dan layout tampilan yang diperluas dibatasi hingga 256 dp.
- Untuk mendefinisikan layout pemberitahuan custom, mulailah dengan membuat instance
+ Untuk mendefinisikan layout pemberitahuan custom, mulailah dengan membuat instance
objek {@link android.widget.RemoteViews} yang memekarkan file layout XML. Kemudian,
sebagai ganti memanggil metode seperti
{@link android.support.v4.app.NotificationCompat.Builder#setContentTitle setContentTitle()},
diff --git a/docs/html-intl/intl/in/guide/topics/ui/overview.jd b/docs/html-intl/intl/in/guide/topics/ui/overview.jd
index a0b2b0645a900..ca8b42085ac27 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/overview.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/overview.jd
@@ -39,7 +39,7 @@ dan elemen <LinearLayout> membuat kelompok tampilan {@link an
Untuk mendapatkan panduan lengkap mengenai pembuatan layout UI, lihat Layout
XML.
-
+
Komponen Antarmuka Pengguna
Anda tidak harus membuat semua UI menggunakan objek {@link android.view.View} dan {link
diff --git a/docs/html-intl/intl/in/guide/topics/ui/settings.jd b/docs/html-intl/intl/in/guide/topics/ui/settings.jd
index 5ac61f928c19e..89be52fc2a73a 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/settings.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/settings.jd
@@ -82,7 +82,7 @@ cara membangun pengaturan aplikasi Anda menggunakan API {@link android.preferenc
Gambar 1. Cuplikan layar dari pengaturan
-aplikasi Messaging Android. Memilih item yang didefinisikan oleh {@link android.preference.Preference}
+aplikasi Messaging Android. Memilih item yang didefinisikan oleh {@link android.preference.Preference}
akan membuka antarmuka untuk mengubah pengaturan.
@@ -163,7 +163,7 @@ tersimpan bisa berupa tipe nilai apa pun yang didukung (tercantum di atas).
java.lang.String}.
-
Lihat kelas {@link android.preference.Preference} untuk mengetahui daftar subkelas lain dan
+
Lihat kelas {@link android.preference.Preference} untuk mengetahui daftar subkelas lain dan
propertinya.
Tentu saja, kelas bawaan tidak mengakomodasi setiap kebutuhan dan aplikasi Anda mungkin memerlukan
@@ -226,7 +226,7 @@ android.preference.ListPreference}. Kedua item tersebut menyertakan tiga atribut
{@code android:key}
Atribut ini diperlukan untuk preferensi yang mempertahankan nilai data. Ini menetapkan kunci
unik (string) yang digunakan sistem saat menyimpan nilai pengaturan ini dalam {@link
-android.content.SharedPreferences}.
+android.content.SharedPreferences}.
Instance satu-satunya di mana atribut ini tidak diperlukan adalah bila preferensi berupa
{@link android.preference.PreferenceCategory} atau {@link android.preference.PreferenceScreen}, atau
preferensi menetapkan {@link android.content.Intent} untuk dipanggil (dengan elemen {@code <intent>}) atau {@link android.app.Fragment} untuk ditampilkan (dengan atribut {@code
@@ -285,7 +285,7 @@ android.preference.PreferenceCategory}.
Tindakan yang akan ditetapkan, sesuai metode
{@link android.content.Intent#setAction setAction()}.
{@code android:data}
Data yang akan ditetapkan, sesuai metode {@link android.content.Intent#setData setData()}.
{@code android:mimeType}
-
Tipe MIME yang akan ditetapkan, sesuai metode
+
Tipe MIME yang akan ditetapkan, sesuai metode
{@link android.content.Intent#setType setType()}.
{@code android:targetClass}
Bagian kelas dari nama komponen, sesuai metode {@link android.content.Intent#setComponent
@@ -588,11 +588,11 @@ tunggal dalam elemen {@code <preference-headers>} akar. Misalnya:
Sebagai gantinya, simpan referensi ke listener dalam bidang data instance
+
Sebagai gantinya, simpan referensi ke listener dalam bidang data instance
objek yang akan ada selama listener dibutuhkan:
@@ -975,11 +975,11 @@ negatif dan positif default:
public class NumberPickerPreference extends DialogPreference {
public NumberPickerPreference(Context context, AttributeSet attrs) {
super(context, attrs);
-
+
setDialogLayoutResource(R.layout.numberpicker_dialog);
setPositiveButtonText(android.R.string.ok);
setNegativeButtonText(android.R.string.cancel);
-
+
setDialogIcon(null);
}
...
@@ -1194,7 +1194,7 @@ protected void onRestoreInstanceState(Parcelable state) {
// Cast state to custom BaseSavedState and pass to superclass
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
-
+
// Set this Preference's widget to reflect the restored state
mNumberPicker.setValue(myState.value);
}
diff --git a/docs/html-intl/intl/in/guide/topics/ui/ui-events.jd b/docs/html-intl/intl/in/guide/topics/ui/ui-events.jd
index 5068176fccaef..0307b34a85c1e 100644
--- a/docs/html-intl/intl/in/guide/topics/ui/ui-events.jd
+++ b/docs/html-intl/intl/in/guide/topics/ui/ui-events.jd
@@ -26,11 +26,11 @@ tindakan terjadi pada objek itu. Misalnya, bila View (seperti Button/Tombol) dis
metode onTouchEvent() akan dipanggil pada objek itu. Akan tetapi, untuk mencegatnya, Anda harus memperluas
kelas dan mengesampingkan metode itu. Akan tetapi, memperluas setiap objek View
untuk menangani kejadian seperti itu tidaklah praktis. Karena itulah kelas View juga berisi
-sekumpulan antarmuka tersarang dengan callback yang jauh lebih mudah didefinisikan. Antarmuka ini,
+sekumpulan antarmuka tersarang dengan callback yang jauh lebih mudah didefinisikan. Antarmuka ini,
yang disebut event listener, merupakan tiket Anda untuk menangkap interaksi pengguna dengan UI.
Walaupun Anda akan lebih sering menggunakan event listener ini untuk interaksi pengguna,
-mungkin ada saatnya Anda ingin memperluas kelas View, untuk membuat komponen custom.
+mungkin ada saatnya Anda ingin memperluas kelas View, untuk membuat komponen custom.
Mungkin Anda ingin memperluas kelas {@link android.widget.Button}
untuk membuat sesuatu yang lebih menarik. Dalam hal ini, Anda akan dapat mendefinisikan perilaku kejadian default untuk kelas Anda dengan menggunakan
kelas event handler.
@@ -46,28 +46,28 @@ telah didaftarkan dengan listener dipicu oleh interaksi pengguna dengan item dal
onClick()
-
Dari {@link android.view.View.OnClickListener}.
+
Dari {@link android.view.View.OnClickListener}.
Ini dipanggil baik saat pengguna menyentuh item
(bila dalam mode sentuh), maupun memfokuskan pada item dengan tombol navigasi atau trackball dan
menekan tombol "enter" yang sesuai atau menekan trackball.
onLongClick()
-
Dari {@link android.view.View.OnLongClickListener}.
- Ini dipanggil baik saat pengguna menyentuh dan menahan item (bila dalam mode sentuh),
+
Dari {@link android.view.View.OnLongClickListener}.
+ Ini dipanggil baik saat pengguna menyentuh dan menahan item (bila dalam mode sentuh),
maupun memfokuskan pada item dengan tombol navigasi atau trackball dan
menekan serta menahan tombol "enter" yang sesuai atau menekan dan menahan trackball (selama satu detik).
onFocusChange()
-
Dari {@link android.view.View.OnFocusChangeListener}.
+
Dari {@link android.view.View.OnFocusChangeListener}.
Ini dipanggil saat pengguna menyusuri ke atau dari item, dengan menggunakan tombol navigasi atau trackball.
onKey()
-
Dari {@link android.view.View.OnKeyListener}.
+
Dari {@link android.view.View.OnKeyListener}.
Ini dipanggil saat pengguna memfokuskan pada item dan menekan atau melepas tombol fisik pada perangkat.
onTouch()
-
Dari {@link android.view.View.OnTouchListener}.
+
Dari {@link android.view.View.OnTouchListener}.
Ini dipanggil saat pengguna melakukan tindakan yang digolongkan sebagai kejadian sentuh, termasuk penekanan, pelepasan,
atau gerak perpindahan pada layar (dalam batasan item itu).
onCreateContextMenu()
-
Dari {@link android.view.View.OnCreateContextMenuListener}.
- Ini dipanggil saat Menu Konteks sedang dibuat (akibat "klik lama" terus-menerus). Lihat diskusi
+
Dari {@link android.view.View.OnCreateContextMenuListener}.
+ Ini dipanggil saat Menu Konteks sedang dibuat (akibat "klik lama" terus-menerus). Lihat diskusi
tentang menu konteks di panduan pengembang Menu.
{@link android.view.View#onTouchEvent} - Dipanggil bila terjadi kejadian gerakan layar sentuh.
{@link android.view.View#onFocusChanged} - Dipanggil bila View memperoleh atau kehilangan fokus.
-
Ada beberapa metode lain yang harus Anda ketahui, yang bukan bagian dari kelas View,
+
Ada beberapa metode lain yang harus Anda ketahui, yang bukan bagian dari kelas View,
namun bisa berdampak langsung pada kemampuan Anda menangani kejadian. Jadi, saat mengelola kejadian yang lebih kompleks dalam
layout, pertimbangkanlah metode-metode lain ini:
{@link android.app.Activity#dispatchTouchEvent(MotionEvent)
- Activity.dispatchTouchEvent(MotionEvent)} - Ini memungkinkan {@link
+ Activity.dispatchTouchEvent(MotionEvent)} - Ini memungkinkan {@link
android.app.Activity} Anda mencegat semua kejadian sentuh sebelum dikirim ke jendela.
{@link android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)
ViewGroup.onInterceptTouchEvent(MotionEvent)} - Ini memungkinkan {@link
android.view.ViewGroup} memantau kejadian saat dikirim ke View anak.
{@link android.view.ViewParent#requestDisallowInterceptTouchEvent(boolean)
ViewParent.requestDisallowInterceptTouchEvent(boolean)} - Panggil ini
- pada View induk untuk menunjukan larangan mencegat kejadian sentuh dengan {@link
+ pada View induk untuk menunjukan larangan mencegat kejadian sentuh dengan {@link
android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)}.
@@ -199,11 +199,11 @@ perlu memberikan fokus pada item tindakan (seperti tombol) agar pengguna bisa me
yang akan menerima input. Akan tetapi jika perangkat memiliki kemampuan sentuh, dan pengguna
mulai berinteraksi dengan antarmuka dengan menyentuhnya, maka Anda tidak perlu lagi
menyorot item, atau memfokuskan pada View tertentu. Karena itu, ada mode
-untuk interaksi yang bernama "mode sentuh".
+untuk interaksi yang bernama "mode sentuh".
Untuk perangkat berkemampuan sentuh, setelah pengguna menyentuh layar, perangkat
-akan masuk ke mode sentuh. Dari sini dan selanjutnya, hanya View dengan
+akan masuk ke mode sentuh. Dari sini dan selanjutnya, hanya View dengan
{@link android.view.View#isFocusableInTouchMode} benar yang akan dapat difokus, seperti widget pengedit teks.
View lain yang dapat disentuh, seperti tombol, tidak akan difokus bila disentuh; View ini akan
langsung memicu on-click listener bila ditekan.
@@ -214,7 +214,7 @@ keluar dari mode sentuh, dan mencari tampilan untuk difokuskan. Kini pengguna bi
dengan antarmuka pengguna tanpa menyentuh layar.
-Status mode sentuh dipertahankan di seluruh sistem (semua jendela dan aktivitas).
+Status mode sentuh dipertahankan di seluruh sistem (semua jendela dan aktivitas).
Untuk query status saat ini, Anda bisa memanggil
{@link android.view.View#isInTouchMode} untuk mengetahui apakah perangkat saat ini sedang dalam mode sentuh.
@@ -257,7 +257,7 @@ mana pun, tidak pula akan menyusuri ke bawah dari Button kedua. Karena sekarang
mendefinisikan Button bawah sebagai nextFocusUp (dan sebaliknya), fokus navigasi akan
silih berganti dari atas ke bawah dan bawah ke atas.
-
Jika Anda ingin mendeklarasikan View sebagai dapat difokus dalam UI (bila biasanya tidak dapat difokus),
+
Jika Anda ingin mendeklarasikan View sebagai dapat difokus dalam UI (bila biasanya tidak dapat difokus),
tambahkan atribut XML android:focusable ke View, dalam deklarasi layout Anda.
Atur nilai true. Anda juga bisa mendeklarasikan View
sebagai dapat difokus saat dalam Mode Sentuh dengan android:focusableInTouchMode.
@@ -282,7 +282,7 @@ sebagai dapat difokus saat dalam Mode Sentuh dengan android:focusableInTou
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/in/preview/api-overview.jd b/docs/html-intl/intl/in/preview/api-overview.jd
index b0a0317ca9adb..b652dd91bb27a 100644
--- a/docs/html-intl/intl/in/preview/api-overview.jd
+++ b/docs/html-intl/intl/in/preview/api-overview.jd
@@ -815,7 +815,7 @@ penyimpanan eksternal ke aplikasi Anda. Bila Anda menggunakan API baru, sistem a
sederhana yang memperinci dengan jelas direktori apa yang aksesnya diminta
oleh aplikasi.
-
Untuk informasi selengkapnya, lihat dokumentasi pengembang
+
Bersama fitur dan kemampuan baru, Android N
- menyertakan berbagai macam perubahan sistem dan perubahan perilaku API. Dokumen ini
+ menyertakan berbagai macam perubahan sistem dan perubahan perilaku API. Dokumen ini
menyoroti beberapa perubahan utama yang harus dipahami dan diperhitungkan
dalam aplikasi Anda.
@@ -482,7 +482,7 @@ JavaVM::AttachCurrentThread from <jni.h>.
Pemilik perangkat bisa mengelola pengguna tambahan lebih mudah. Bila perangkat
- berjalan dalam mode pemilik perangkat, maka pembatasan DISALLOW_ADD_USER
+ berjalan dalam mode pemilik perangkat, maka pembatasan DISALLOW_ADD_USER
secara otomatis akan ditetapkan. Ini mencegah pengguna membuat pengguna tambahan yang
tidak terkelola. Selain itu, CreateUser() dan
createAndInitializeUser() metode tidak digunakan lagi; metode
diff --git a/docs/html-intl/intl/in/preview/features/background-optimization.jd b/docs/html-intl/intl/in/preview/features/background-optimization.jd
index 5712ab671059d..c6bf1759393b8 100644
--- a/docs/html-intl/intl/in/preview/features/background-optimization.jd
+++ b/docs/html-intl/intl/in/preview/features/background-optimization.jd
@@ -297,7 +297,7 @@ public static void scheduleJob(Context context) {
Mengembalikan larik URL yang telah memicu pekerjaan. Ini akan berupa {@code
null} jika tidak ada URI yang memicu pekerjaan (misalnya, pekerjaan
- dipicu karena batas waktu atau alasan lainnya), atau jumlah
+ dipicu karena batas waktu atau alasan lainnya), atau jumlah
URI yang berubah lebih dari 50.
N Developer Preview memperluas {@link android.net.ConnectivityManager}
API untuk menyediakan cara pada aplikasi untuk menerima preferensi Data Saver
- pengguna dan memantau perubahan
+ pengguna dan memantau perubahan
preferensi. Hal ini dianggap praktik terbaik bagi aplikasi untuk memeriksa apakah
pengguna telah mengaktifkan DataSaver dan berusaha membatasi penggunaan data latar depan dan
data latar belakang.
diff --git a/docs/html-intl/intl/in/preview/features/multi-window.jd b/docs/html-intl/intl/in/preview/features/multi-window.jd
index 33399e9961c33..3f75def734a68 100644
--- a/docs/html-intl/intl/in/preview/features/multi-window.jd
+++ b/docs/html-intl/intl/in/preview/features/multi-window.jd
@@ -325,7 +325,7 @@ android:supportsPictureInPicture=["true" | "false"]
Catatan: Mode gambar-dalam-gambar adalah kasus khusus pada
mode multi-jendela. Jika myActivity.isInPictureInPictureMode()
- mengembalikan nilai true, maka myActivity.isInMultiWindowMode() juga
+ mengembalikan nilai true, maka myActivity.isInMultiWindowMode() juga
mengembalikan nilai true.
diff --git a/docs/html-intl/intl/in/preview/features/security-config.jd b/docs/html-intl/intl/in/preview/features/security-config.jd
index 53f5576ec94d9..7a0303e59fd7b 100644
--- a/docs/html-intl/intl/in/preview/features/security-config.jd
+++ b/docs/html-intl/intl/in/preview/features/security-config.jd
@@ -739,7 +739,7 @@ Sumber sertifikat CA, bisa salah satu dari
- Algoritme intisari yang digunakan untuk menghasilkan pin. Saat ini, hanya
+ Algoritme intisari yang digunakan untuk menghasilkan pin. Saat ini, hanya
{@code "SHA-256"} yang didukung.
Tiga tahapan pencapaian pratinjau pertama memberikan ujian
pertama dan lingkungan pengembangan yang membantu Anda mengidentifikasi
- masalah kompatibilitas dalam aplikasi Anda saat ini dan merencanakan migrasi atau menampilkan pekerjaan
+ masalah kompatibilitas dalam aplikasi Anda saat ini dan merencanakan migrasi atau menampilkan pekerjaan
yang diperlukan untuk menargetkan platform baru. Ini adalah periode prioritas yang akan
memberi kami masukan dari Anda tentang fitur dan API serta masalah kompatibilitas file
— untuk semua ini, gunakan Issue
@@ -314,8 +314,8 @@ page.tags="preview", "developer", "android"
diff --git a/docs/html-intl/intl/in/preview/support.jd b/docs/html-intl/intl/in/preview/support.jd
index 5571b11610f6d..885e7c7173682 100644
--- a/docs/html-intl/intl/in/preview/support.jd
+++ b/docs/html-intl/intl/in/preview/support.jd
@@ -457,7 +457,7 @@ Tracker.
versi aplikasi multi-APK yang didesain untuk mendukung Vulkan yang lebih rendah pada
perangkat dengan dukungan versi yang lebih tinggi. Saat ini, Google Play Store tidak
menerima unggahan aplikasi yang menggunakan penargetan versi Vulkan. Dukungan ini
- akan ditambahkan pada Google Play Store di masa mendatang dan diperbaiki dalam
+ akan ditambahkan pada Google Play Store di masa mendatang dan diperbaiki dalam
Google Play Services versi berikutnya (akan disertakan dalam rilis Developer Preview
mendatang). Perangkat N yang menggunakan Google Play Services 9.0.83 akan
tetap menerima versi Aplikasi yang menargetkan dukungan Vulkan dasar.
diff --git a/docs/html-intl/intl/in/training/material/drawables.jd b/docs/html-intl/intl/in/training/material/drawables.jd
index 56fd17fc684b9..493abd46bebdf 100644
--- a/docs/html-intl/intl/in/training/material/drawables.jd
+++ b/docs/html-intl/intl/in/training/material/drawables.jd
@@ -66,7 +66,7 @@ sediakan listener sebagai gantinya.
Anda bisa mengambil warna mencolok dari gambar dengan metode getter di kelas
Palette, misalnya Palette.getVibrantColor.
-
Untuk menggunakan kelas {@link android.support.v7.graphics.Palette} dalam proyek Anda, tambahkan
+
Untuk menggunakan kelas {@link android.support.v7.graphics.Palette} dalam proyek Anda, tambahkan
dependensi Gradle berikut ke
modul aplikasi Anda:
Animasi untuk menambahkan dan menghapus item diaktifkan secara default di {@link
-android.support.v7.widget.RecyclerView}. Untuk menyesuaikan animasi ini, perluas kelas
+android.support.v7.widget.RecyclerView}. Untuk menyesuaikan animasi ini, perluas kelas
{@link android.support.v7.widget.RecyclerView.ItemAnimator RecyclerView.ItemAnimator}dan gunakan
metode {@link android.support.v7.widget.RecyclerView#setItemAnimator RecyclerView.setItemAnimator()}.
@@ -253,7 +253,7 @@ dalam layout:
Widget {@link android.support.v7.widget.RecyclerView} dan {@link android.support.v7.widget.CardView}
adalah bagian dari v7 Support
-Library. Untuk menggunakan widget dalam proyek Anda, tambahkan
+Library. Untuk menggunakan widget dalam proyek Anda, tambahkan
dependensi Gradle ini ke
modul aplikasi Anda:
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/developer-console.jd b/docs/html-intl/intl/ja/distribute/googleplay/developer-console.jd
index 8dd562d79a16a..29e4145a7d37d 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/developer-console.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/developer-console.jd
@@ -5,7 +5,7 @@ Xnonavpage=true
@jd:body
-
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/families/faq.jd b/docs/html-intl/intl/ja/distribute/googleplay/families/faq.jd
index 206429c654427..da877f9a21912 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/families/faq.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/families/faq.jd
@@ -10,7 +10,7 @@ page.metaDescription=Designed for Families に関する質問と回答
font-weight:bold;
}
-
+
本書の内容
@@ -106,7 +106,7 @@ page.metaDescription=Designed for Families に関する質問と回答
- Designed for Families プログラムにオプトインすると、Google Play はアプリを審査し、ファミリー層に適切かどうか確認します。アプリがすべてのプログラム要件に準拠している場合、公開までの時間は通常よりも長くかかることはないはずです。ただし、Designed for Families 審査で却下された場合、アプリの公開が遅れる可能性があります。
+ Designed for Families プログラムにオプトインすると、Google Play はアプリを審査し、ファミリー層に適切かどうか確認します。アプリがすべてのプログラム要件に準拠している場合、公開までの時間は通常よりも長くかかることはないはずです。ただし、Designed for Families 審査で却下された場合、アプリの公開が遅れる可能性があります。
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/families/start.jd b/docs/html-intl/intl/ja/distribute/googleplay/families/start.jd
index e8e9ee59af41b..023e2c17e06d1 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/families/start.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/families/start.jd
@@ -51,7 +51,7 @@ page.metaDescription=ほんの数ステップで Designed for Families に参加
- 注: Designed for Families プログラムで公開されたアプリは Google Play ですべてのユーザーも利用できます。
+ 注: Designed for Families プログラムで公開されたアプリは Google Play ですべてのユーザーも利用できます。
@@ -67,4 +67,4 @@ page.metaDescription=ほんの数ステップで Designed for Families に参加
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/guide.jd b/docs/html-intl/intl/ja/distribute/googleplay/guide.jd
index 137c63f6cbe47..1655017efa032 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/guide.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/guide.jd
@@ -54,4 +54,4 @@ page.image=distribute/images/play_dev_guide.png
data-query="collection:play_dev_guide"
data-cardSizes="9x6"
data-maxResults="1">
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/quality/auto.jd b/docs/html-intl/intl/ja/distribute/googleplay/quality/auto.jd
index eda7297741cc1..2870153fe2d93 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/quality/auto.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/quality/auto.jd
@@ -431,4 +431,4 @@ data-sortorder="-timestamp" data-cardsizes="9x3" data-maxresults="6">
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/quality/core.jd b/docs/html-intl/intl/ja/distribute/googleplay/quality/core.jd
index 5229aa7c829fc..ddf41155b082b 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/quality/core.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/quality/core.jd
@@ -13,7 +13,7 @@ page.image=/distribute/images/core-quality-guidelines.jpg
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/quality/tablets.jd b/docs/html-intl/intl/ja/distribute/googleplay/quality/tablets.jd
index f0cc133c8bda7..dbdabc21d57ec 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/quality/tablets.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/quality/tablets.jd
@@ -46,7 +46,7 @@ Xnonavpage=true
はい。上記の要件は、アプリが Google Play で Android Wear アプリとして識別され、Android Wear ユーザーが発見しやすくなるかどうかのみを判断するものです。アプリが Wear アプリとして承認されなくても、電話やタブレットなどの他のデバイス タイプで利用可能です。ウェアラブル端末へのインストールも可能です。
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/start.jd b/docs/html-intl/intl/ja/distribute/googleplay/start.jd
index 3c5e548624aee..93aee136da058 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/start.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/start.jd
@@ -134,4 +134,4 @@ href="https://support.google.com/googleplay/android-developer/bin/answer.py?hl=e
data-query="collection:distribute/googleplay/gettingstarted"
data-sortOrder="-timestamp"
data-cardSizes="9x3"
- data-maxResults="6">
\ No newline at end of file
+ data-maxResults="6">
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/tv.jd b/docs/html-intl/intl/ja/distribute/googleplay/tv.jd
index 1a7558de28abf..9532bf4277e3d 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/tv.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/tv.jd
@@ -173,7 +173,7 @@ page.metaDescription=アプリ、ゲーム、コンテンツを Android TV に
5.審査と承認をトラッキングする
- アプリが上述の Android TV 向けの技術上の基準と品質基準に適合すると、ユーザーはそのアプリを Android TV で活用できるようになります。アプリが基準を満たしていない場合、デベロッパー アカウント アドレスに送られた通知メールを受け取ります。このメールには対処が必要な領域の要約が記載されています。必要な調整を行ったら、デベロッパー コンソールにアプリの新規バージョンをアップロードできます。
+ アプリが上述の Android TV 向けの技術上の基準と品質基準に適合すると、ユーザーはそのアプリを Android TV で活用できるようになります。アプリが基準を満たしていない場合、デベロッパー アカウント アドレスに送られた通知メールを受け取ります。このメールには対処が必要な領域の要約が記載されています。必要な調整を行ったら、デベロッパー コンソールにアプリの新規バージョンをアップロードできます。
@@ -190,7 +190,7 @@ page.metaDescription=アプリ、ゲーム、コンテンツを Android TV に
- 承認 — アプリが審査され、承認されました。アプリは Android TV ユーザーが直接利用できるようになります。
+ 承認 — アプリが審査され、承認されました。アプリは Android TV ユーザーが直接利用できるようになります。
@@ -207,4 +207,4 @@ page.metaDescription=アプリ、ゲーム、コンテンツを Android TV に
data-query="collection:tvlanding"
data-cardSizes="9x6, 6x3x2"
data-maxResults="6">
-
+
diff --git a/docs/html-intl/intl/ja/distribute/googleplay/wear.jd b/docs/html-intl/intl/ja/distribute/googleplay/wear.jd
index 4e0196e8a8057..85cffca6d97fc 100644
--- a/docs/html-intl/intl/ja/distribute/googleplay/wear.jd
+++ b/docs/html-intl/intl/ja/distribute/googleplay/wear.jd
@@ -196,4 +196,4 @@ page.metaDescription=アプリ、ゲーム、コンテンツを Android Wear に
data-query="collection:wearlanding"
data-cardSizes="6x2"
data-maxResults="3">
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/tools/launch-checklist.jd b/docs/html-intl/intl/ja/distribute/tools/launch-checklist.jd
index b1394f8c950eb..a6f1a7f8b6f23 100644
--- a/docs/html-intl/intl/ja/distribute/tools/launch-checklist.jd
+++ b/docs/html-intl/intl/ja/distribute/tools/launch-checklist.jd
@@ -789,4 +789,4 @@ data-maxresults="6">
data-query="collection:distribute/toolsreference/launchchecklist/afterlaunch"
data-sortOrder="-timestamp"
data-cardSizes="9x3,9x3,9x3,9x3,9x3,9x3"
- data-maxResults="6">
\ No newline at end of file
+ data-maxResults="6">
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/distribute/tools/localization-checklist.jd b/docs/html-intl/intl/ja/distribute/tools/localization-checklist.jd
index b2c797b437ab5..5bb9fe0359a6b 100644
--- a/docs/html-intl/intl/ja/distribute/tools/localization-checklist.jd
+++ b/docs/html-intl/intl/ja/distribute/tools/localization-checklist.jd
@@ -2,7 +2,7 @@ page.title=ローカライズのチェックリスト
page.metaDescription=Android と Google Play から提供される世界中のユーザーを活用します。このチェックリストを読んで、お客様の製品を世界中のマーケットに提供する方法の概要を把握してください。
meta.tags="localizing, publishing, disttools"
page.tags="local, l10n, translation, language"
-page.image=/distribute/images/localization-checklist.jpg
+page.image=/distribute/images/localization-checklist.jpg
@jd:body
@@ -713,4 +713,4 @@ data-maxresults="6">
data-query="collection:distribute/toolsreference/localizationchecklist/supportlaunch"
data-sortOrder="-timestamp"
data-cardSizes="9x3,9x3,6x3,9x3,9x3,9x3"
- data-maxResults="6">
\ No newline at end of file
+ data-maxResults="6">
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/google/play/filters.jd b/docs/html-intl/intl/ja/google/play/filters.jd
index 5ab6336eac65b..eed069f74b979 100644
--- a/docs/html-intl/intl/ja/google/play/filters.jd
+++ b/docs/html-intl/intl/ja/google/play/filters.jd
@@ -263,4 +263,4 @@ href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><uses-featur
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/guide/components/activities.jd b/docs/html-intl/intl/ja/guide/components/activities.jd
index 9b06d2c838bbc..227f7f4b40838 100644
--- a/docs/html-intl/intl/ja/guide/components/activities.jd
+++ b/docs/html-intl/intl/ja/guide/components/activities.jd
@@ -53,7 +53,7 @@ page.tags=activity,intent
また、あるプロセスに他のプロセスが依存しているために、そのプロセスのランクが引き上げられる可能性もあります。他のプロセスから依存されているプロセスが、依存しているプロセスよりも低いレベルにランク付けされることはありません。たとえば、プロセス A 内のコンテンツ プロバイダにプロセス B 内のクライアントが依存している場合や、プロセス A 内のサービスがプロセス B 内のコンポーネントにバインドされている場合、プロセス A は常にプロセス B よりは重要度が高いと見なされます。
-
カレンダーを同期してそのイベントを端末に格納するかどうかを示すブール値。
値 0 は、このカレンダーを同期せず、イベントを端末に格納しないことを指定します。
値 1 は、このカレンダーのイベントを同期し、イベントを端末に格納することを指定します。
@@ -268,13 +268,13 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
ACCOUNT_TYPE を含める必要がある理由
{@link android.provider.CalendarContract.Calendars#ACCOUNT_NAME Calendars.ACCOUNT_NAME} にクエリする場合は、このセクションに {@link android.provider.CalendarContract.Calendars#ACCOUNT_TYPE Calendars.ACCOUNT_TYPE} も含める必要があります。
@@ -289,7 +289,7 @@ private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
この例の次の部分では、クエリを作成します。クエリの条件は selection に指定しています。
@@ -308,38 +308,38 @@ private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -561,7 +561,7 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
@@ -598,7 +598,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -625,7 +625,7 @@ ContentValues values = new ContentValues();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().delete(deleteUri, null, null);
-Log.i(DEBUG_TAG, "Rows deleted: " + rows);
+Log.i(DEBUG_TAG, "Rows deleted: " + rows);
複数選択アイテム（チェックボックス）または排他的選択アイテム（ラジオボタン）のリストを追加するには、{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
-DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} または {@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} または {@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} メソッドをそれぞれ使用します。
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -372,7 +372,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
従来のリストとラジオボタンを含むリストでは、「排他的選択」アクションが提供されますが、ユーザーの選択を固定させたい場合は、{@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} を使用してください。つまり、ダイアログを後でもう一度開く場合は、ユーザーの現在の選択を表示し、ラジオボタンを含むリストを作成します。
@@ -470,7 +470,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -505,7 +505,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ public class NoticeDialogFragment extends DialogFragment {
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ public class CustomDialogFragment extends DialogFragment {
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
diff --git a/docs/html-intl/intl/ja/guide/topics/ui/menus.jd b/docs/html-intl/intl/ja/guide/topics/ui/menus.jd
index 7d8090e7a0ad6..53142a1b3e582 100644
--- a/docs/html-intl/intl/ja/guide/topics/ui/menus.jd
+++ b/docs/html-intl/intl/ja/guide/topics/ui/menus.jd
@@ -83,9 +83,9 @@ Android 3.0 からは、Menu ボタンが廃止されたため（一部
UI でビューをフォーカス可能にする場合は（従来は、ビューはフォーカス可能ではありません）、レイアウトの宣言で android:focusable XML 属性をビューに追加し、値を
+
UI でビューをフォーカス可能にする場合は（従来は、ビューはフォーカス可能ではありません）、レイアウトの宣言で android:focusable XML 属性をビューに追加し、値を
true に設定します。また、android:focusableInTouchMode を使用して、タッチモードのときにビューをフォーカス可能にすることもできます。
@@ -282,7 +282,7 @@ dispatchKeyEvent()} メソッドを介して伝わっていると判断
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/ja/preview/features/background-optimization.jd b/docs/html-intl/intl/ja/preview/features/background-optimization.jd
index 1ea9f2eb47658..04921c79b7980 100644
--- a/docs/html-intl/intl/ja/preview/features/background-optimization.jd
+++ b/docs/html-intl/intl/ja/preview/features/background-optimization.jd
@@ -248,7 +248,7 @@ Android N では、{@link android.app.job.JobInfo} と {@link
setPeriodic()} または {@link android.app.job.JobInfo.Builder#setPersisted
setPersisted()} と組み合わせて使うことはできません。
コンテンツの変更を継続的に監視するには、アプリの {@link
- android.app.job.JobService} が最新のコールバックの処理を完了する前に、新しい
+ android.app.job.JobService} が最新のコールバックの処理を完了する前に、新しい
{@link android.app.job.JobInfo} をスケジュールします。
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ja/training/monitoring-device-state/manifest-receivers.jd b/docs/html-intl/intl/ja/training/monitoring-device-state/manifest-receivers.jd
index 7635d9f87c025..eff1221514dcf 100644
--- a/docs/html-intl/intl/ja/training/monitoring-device-state/manifest-receivers.jd
+++ b/docs/html-intl/intl/ja/training/monitoring-device-state/manifest-receivers.jd
@@ -9,7 +9,7 @@ previous.link=connectivity-monitoring.html
@jd:body
-
이 출시 버전에는 다음과 같은 {@link android.media.AudioTrack}에 대한 변경사항이 포함되어 있습니다.
-
이제 앱에서 부동 소수점 형식({@link android.media.AudioFormat#ENCODING_PCM_FLOAT ENCODING_PCM_FLOAT})으로 오디오 데이터를 제공할 수 있습니다. 이를 통해 더 큰 음량비, 더 일관된 정밀도 및 더 큰 헤드룸이 가능해졌습니다. 부동 소수점 연산은 중간 과정 계산에 특히 유용합니다. 재생 엔드포인트는 오디오 데이터에 낮은 비트 심도로 정수 형식을 사용합니다 (Android 5.0에서 일부 내부 파이프라인은 아직 부동 소수점이 아님).
+
이제 앱에서 부동 소수점 형식({@link android.media.AudioFormat#ENCODING_PCM_FLOAT ENCODING_PCM_FLOAT})으로 오디오 데이터를 제공할 수 있습니다. 이를 통해 더 큰 음량비, 더 일관된 정밀도 및 더 큰 헤드룸이 가능해졌습니다. 부동 소수점 연산은 중간 과정 계산에 특히 유용합니다. 재생 엔드포인트는 오디오 데이터에 낮은 비트 심도로 정수 형식을 사용합니다 (Android 5.0에서 일부 내부 파이프라인은 아직 부동 소수점이 아님).
이제 앱에서 오디오 데이터를 {@link android.media.MediaCodec}에서 제공하는 것과 같은 형식인 {@link java.nio.ByteBuffer}로 제공할 수 있습니다.
{@link android.media.AudioTrack#WRITE_NON_BLOCKING WRITE_NON_BLOCKING} 옵션은 일부 앱에서 버퍼링 및 멀티스레딩을 단순화할 수 있습니다.
@@ -429,7 +429,7 @@ sdk.platform.apiLevel=21
시스템에서 적절한 네트워크를 감지하면 감지한 네트워크에 연결하고 {@link android.net.ConnectivityManager.NetworkCallback#onAvailable(android.net.Network) onAvailable()} 콜백을 호출합니다. 콜백의 {@link android.net.Network} 개체를 사용하여 네트워크에 대한 추가 정보를 가져오거나, 트래픽이 선택한 네트워크를 사용하도록 유도합니다.
저전력 블루투스
-
Android 4.3에서는 저전력 블루투스(블루투스 LE)에 대한 플랫폼 지원이 도입되었습니다. Android 5.0에서는 Android 기기가 블루투스 LE 주변기기로 작동할 수 있습니다. 앱에서 이 기능을 사용하여 주변 기기에 블루투스로 연결할 수 있음을 알릴 수 있습니다. 예를 들어 기기가 만보계나 건강 모니터링 기기로 작동하면서 다른 블루투스 LE 기기와 데이터를 통신할 수 있도록 하는 앱을 제작할 수 있습니다.
+
Android 4.3에서는 저전력 블루투스(블루투스 LE)에 대한 플랫폼 지원이 도입되었습니다. Android 5.0에서는 Android 기기가 블루투스 LE 주변기기로 작동할 수 있습니다. 앱에서 이 기능을 사용하여 주변 기기에 블루투스로 연결할 수 있음을 알릴 수 있습니다. 예를 들어 기기가 만보계나 건강 모니터링 기기로 작동하면서 다른 블루투스 LE 기기와 데이터를 통신할 수 있도록 하는 앱을 제작할 수 있습니다.
새 {@link android.bluetooth.le} API를 사용하면 앱에서 광고를 브로드캐스팅하고, 응답을 스캔하며, 주변의 블루투스 LE 기기와 연결을 설정하도록 할 수 있습니다. 새 광고 및 스캔 기능을 사용하려면 매니페스트에 {@link android.Manifest.permission#BLUETOOTH_ADMIN BLUETOOTH_ADMIN} 권한을 추가합니다. 사용자가 Play 스토어에서 앱을 업데이트하거나 다운로드할 때 사용자에게 앱에 권한을 부여할 것인지 묻는 메시지('블루투스 연결 정보: 주변의 블루투스 기기에 브로드캐스팅하거나 이러한 기기에 대한 정보 수집하는 등 앱에서 블루투스를 제어하도록 허용합니다.')가 표시됩니다.
다른 앱에서 내 앱을 찾을 수 있도록 블루투스 LE 광고를 시작하려면 {@link android.bluetooth.le.BluetoothLeAdvertiser#startAdvertising(android.bluetooth.le.AdvertiseSettings, android.bluetooth.le.AdvertiseData, android.bluetooth.le.AdvertiseCallback) startAdvertising()}을 호출하고 이를 {@link android.bluetooth.le.AdvertiseCallback} 클래스 구현에 전달합니다. 콜백 개체는 광고 작업의 성공 또는 실패에 대한 보고서를 수신합니다.
diff --git a/docs/html-intl/intl/ko/design/patterns/navigation.jd b/docs/html-intl/intl/ko/design/patterns/navigation.jd
index 5f335d55408fb..91d1dcc4769c2 100644
--- a/docs/html-intl/intl/ko/design/patterns/navigation.jd
+++ b/docs/html-intl/intl/ko/design/patterns/navigation.jd
@@ -152,7 +152,7 @@ Talk는 친구가 화상 채팅에 참여하도록 보낸
앱 간 탐색
-
Android 시스템의 본질적인 강점 중 하나는 앱이
+
Android 시스템의 본질적인 강점 중 하나는 앱이
다른 앱을 실행할 수 있다는 점이며, 이로 인해 사용자는 한 앱에서 다른 앱으로 직접 이동할 수 있습니다. 예를 들어,
사진을 캡처해야 하는 앱은 카메라 앱을 작동시킬 수 있으며, 카메라 앱은 사진을
해당 앱으로 돌려줍니다. 이러한 기능은 개발자와 사용자 모두에게 매우 유용합니다.
diff --git a/docs/html-intl/intl/ko/distribute/googleplay/about.jd b/docs/html-intl/intl/ko/distribute/googleplay/about.jd
index 57b5226cf293b..2968ed4989f1c 100644
--- a/docs/html-intl/intl/ko/distribute/googleplay/about.jd
+++ b/docs/html-intl/intl/ko/distribute/googleplay/about.jd
@@ -6,7 +6,7 @@ page.image=/distribute/images/about-play.jpg
@jd:body
-
+
Google Play 정보
diff --git a/docs/html-intl/intl/ko/distribute/googleplay/auto.jd b/docs/html-intl/intl/ko/distribute/googleplay/auto.jd
index 6536f1a562c26..5b93b6b272626 100644
--- a/docs/html-intl/intl/ko/distribute/googleplay/auto.jd
+++ b/docs/html-intl/intl/ko/distribute/googleplay/auto.jd
@@ -32,7 +32,7 @@ page.metaDescription=Android Auto에 앱 및 콘텐츠를 배포합니다.
시작하려면 이 문서를 참조하여 Google Play를 통해 사용자에게 Auto 앱을 배포하는 방법을 배우십시오.
- 앱이 충족해야 하는 유용성, 품질 및 안전 관련 가이드라인에 대한 내용은
+ 앱이 충족해야 하는 유용성, 품질 및 안전 관련 가이드라인에 대한 내용은
Auto 앱 품질
을 참조하십시오.
앱이 준비되면 개발자 콘솔의 약관에 동의하고 검토용 APK를 업로드할 수 있습니다.
@@ -98,7 +98,7 @@ page.metaDescription=Android Auto에 앱 및 콘텐츠를 배포합니다.
Auto 앱은 잘 작동하고 차 안에서 멋있게 보이고 최고의 사용자 경험을 제공하도록 디자인해야 합니다.
Google Play는 사용자가 Google Play에서 쉽게 검색할 수 있도록 선정된 고품질 Auto 앱을 소개합니다.
다음과 같은 방법으로 참여하여 사용자에게 멋진 Android Auto 앱을 제공할 수 있습니다.
-
+
@@ -127,7 +127,7 @@ page.metaDescription=Android Auto에 앱 및 콘텐츠를 배포합니다.
약관에 동의한 후에만 Auto 앱을 업로드할 수 있습니다. 다음은 Auto 앱을 지정하는 기준에 대한 설명입니다.
-
+
@@ -159,10 +159,10 @@ page.metaDescription=Android Auto에 앱 및 콘텐츠를 배포합니다.
검토는 휴대폰이나 태블릿 등 Google Play 스토어의 다른 장치에서 앱의 사용 가능성을 결정합니다.
-
+
휴대폰/태블릿 구성요소 업데이트를 포함한 기존 앱이 있는 경우, Android Auto 구성요소가 검토를 통과해야 Google Play 스토어에서 업데이트된 앱을 사용할 수 있습니다.
-
+
@@ -209,7 +209,7 @@ page.metaDescription=Android Auto에 앱 및 콘텐츠를 배포합니다.
앱이 승인되지 않으면 개발자는 해결해야 할 문제에 대한 요약이 포함된 알림 이메일을 개발자 계정 주소로 받게 됩니다.
필요한 조정을 거친 후에 새로운 앱 버전을 개발자 콘솔에 업로드할 수 있습니다.
-
+
diff --git a/docs/html-intl/intl/ko/distribute/googleplay/families/faq.jd b/docs/html-intl/intl/ko/distribute/googleplay/families/faq.jd
index 92dbcf0b97248..8bf330d61424b 100644
--- a/docs/html-intl/intl/ko/distribute/googleplay/families/faq.jd
+++ b/docs/html-intl/intl/ko/distribute/googleplay/families/faq.jd
@@ -10,7 +10,7 @@ Designed for Families에 대한 질문과page.metaDescription= 대답
font-weight:bold;
}
-
+
이 문서의 내용
@@ -141,7 +141,7 @@ Designed for Families에 대한 질문과page.metaDescription= 대답
앱이 모든 프로그램 요구사항을 준수할 경우 게시 시간이 평소보다 오래 걸리지 않습니다. 하지만 Designed for Families 검토 중에 앱이 거부되면 게시가 지연될 수 있습니다.
-
+
@@ -163,7 +163,7 @@ Designed for Families에 대한 질문과page.metaDescription= 대답
앱을 게시한 후에 Designed for Families 프로그램 요구사항을 준수하지 않는 것으로 확인되면 어떻게 됩니까?
-
+
@@ -185,7 +185,7 @@ Designed for Families에 대한 질문과page.metaDescription= 대답
Designed for Families 프로그램에서 승인된 앱을 업데이트하면 어떻게 됩니까?
-
+
@@ -265,7 +265,7 @@ Designed for Families에 대한 질문과page.metaDescription= 대답
인앱 광고를 포함한 전반적인 사용자 경험이 Designed for Families 프로그램 요구사항을 충족하도록 보장하는 것은 개발자의 책임입니다.
-
+
@@ -297,7 +297,7 @@ Designed for Families에 대한 질문과page.metaDescription= 대답
- 당사는 부모와 보호자가 Google Play 스토어에서 신뢰할 수 있는 브랜드와 개발자가 제작한 우수한 아동 및 가족용 앱을 찾을 수 있도록 하는 것을 목표로 합니다.
+ 당사는 부모와 보호자가 Google Play 스토어에서 신뢰할 수 있는 브랜드와 개발자가 제작한 우수한 아동 및 가족용 앱을 찾을 수 있도록 하는 것을 목표로 합니다.
diff --git a/docs/html-intl/intl/ko/distribute/googleplay/families/start.jd b/docs/html-intl/intl/ko/distribute/googleplay/families/start.jd
index 06f76b5c45892..4a93b564ec2e6 100644
--- a/docs/html-intl/intl/ko/distribute/googleplay/families/start.jd
+++ b/docs/html-intl/intl/ko/distribute/googleplay/families/start.jd
@@ -78,7 +78,7 @@ page.metaDescription=간단한 몇 단계로 Designed for Families에 가입합
참고: Designed for Families 프로그램에 게시된 앱은 Google Play의 모든 사용자도 사용할 수 있습니다.
-
+
CR-1
@@ -292,7 +292,7 @@ data-maxresults="6">
앱이 핵심 기능과 관련되지 않은 경우 사용자가 비용을 지불할 수 있는 서비스(예: 전화 걸기 또는 SMS) 또는 민감한 데이터(예: 연락처 또는 시스템 로그)에 대한 액세스 권한을 요청하지 않습니다.
-
+
해당 국가 또는 지역의 개발자 배포 계약을 읽고 동의합니다.
Google Play에 게시하는 앱 및 스토어 목록은 개발자 프로그램 정책 및 미국 수출 법규를 준수해야 합니다.
-
+
Google Wallet을 사용하여 등록 수수료로 미화 25달러를 지불합니다. Google Wallet 계정이 없는 경우 프로세스 진행 중에 계정을 설정할 수 있습니다.
diff --git a/docs/html-intl/intl/ko/distribute/googleplay/tv.jd b/docs/html-intl/intl/ko/distribute/googleplay/tv.jd
index 58f4c2e01ee44..3efa93bdbaf12 100644
--- a/docs/html-intl/intl/ko/distribute/googleplay/tv.jd
+++ b/docs/html-intl/intl/ko/distribute/googleplay/tv.jd
@@ -261,7 +261,7 @@ page.metaDescription=앱, 게임 및 콘텐츠를 Android TV에 배포합니다.
필요한 조정을 거친 후에 새로운 앱 버전을 개발자 콘솔에 업로드할 수 있습니다.
-
+
@@ -282,7 +282,7 @@ page.metaDescription=앱, 게임 및 콘텐츠를 Android TV에 배포합니다.
승인됨 — 앱이 검토 후에 승인되었습니다. Android TV 사용자가 앱을 바로 사용할 수 있습니다.
-
+
diff --git a/docs/html-intl/intl/ko/distribute/googleplay/wear.jd b/docs/html-intl/intl/ko/distribute/googleplay/wear.jd
index 864f668ecd3d8..1f916c2f08a95 100644
--- a/docs/html-intl/intl/ko/distribute/googleplay/wear.jd
+++ b/docs/html-intl/intl/ko/distribute/googleplay/wear.jd
@@ -121,7 +121,7 @@ page.metaDescription=Android Wear에 앱, 게임 및 콘텐츠를 배포합니
Wear 앱은 잘 작동하고 Android Wear에서 멋있게 보이고 최고의 사용자 경험을 제공하도록 디자인해야 합니다.
Google Play는 사용자가 쉽게 검색할 수 있도록 선정된 고품질 Wear 앱을 소개합니다.
다음과 같은 방법으로 참여하여 사용자에게 멋진 Android Wear 앱을 제공할 수 있습니다.
-
+
Android 장치에서 Android 사용자는 검색에 사용할 완성도를 설정할 수 있습니다.
Google Play는 설정에 따라 앱을 필터링하므로 선택한 콘텐츠 등급은 사용자에게 앱을 배포하는 데 영향을 줄 수 있습니다.
- 앱 바이너리를 변경할 필요 없이 개발자 콘솔에서 앱의 콘텐츠 등급을 할당(또는 변경)할 수 있습니다.
+ 앱 바이너리를 변경할 필요 없이 개발자 콘솔에서 앱의 콘텐츠 등급을 할당(또는 변경)할 수 있습니다.
@@ -764,7 +764,7 @@ See how you can facilitate testing with Google Play.
개발자 콘솔에서 앱의 대상 지역을 설정한 후에 지원하는 모든 언어에 대해 현지화된 스토어 목록, 홍보 그래픽 등을 추가하십시오.
-
+
{@link android.app.Activity}는 일종의 애플리케이션 구성 요소로서,
-사용자와 상호작용할 수 있는 화면을 제공하여 전화 걸기, 사진 찍기, 이메일 보내기 또는 지도 보기 등의 일을 할 수
-있습니다. 액티비티마다 창이 하나씩 주어져 이곳에 사용자 인터페이스를 끌어올 수 있습니다. 이 창은
-일반적으로 화면을 가득 채우지만, 작은 창으로 만들어 다른 창 위에 띄울 수도
+
{@link android.app.Activity}는 일종의 애플리케이션 구성 요소로서,
+사용자와 상호작용할 수 있는 화면을 제공하여 전화 걸기, 사진 찍기, 이메일 보내기 또는 지도 보기 등의 일을 할 수
+있습니다. 액티비티마다 창이 하나씩 주어져 이곳에 사용자 인터페이스를 끌어올 수 있습니다. 이 창은
+일반적으로 화면을 가득 채우지만, 작은 창으로 만들어 다른 창 위에 띄울 수도
있습니다.
-
하나의 애플리케이션은 보통 여러 개의 액티비티가 느슨하게 서로 묶여 있는 형태로
-구성됩니다. 통상 한 애플리케이션 내에서 하나의 액티비티가 "주요" 액티비티로 지정되며,
-사용자가 이 애플리케이션을 처음 실행할 때 이 액티비티가 사용자에게 표시됩니다. 그런 후
+
하나의 애플리케이션은 보통 여러 개의 액티비티가 느슨하게 서로 묶여 있는 형태로
+구성됩니다. 통상 한 애플리케이션 내에서 하나의 액티비티가 "주요" 액티비티로 지정되며,
+사용자가 이 애플리케이션을 처음 실행할 때 이 액티비티가 사용자에게 표시됩니다. 그런 후
각각의 액티비티는 여러 가지 작업을 수행하기 위해 또 다른 액티비티를 시작할 수 있습니다. 새로운
액티비티가 시작될 때마다 이전 액티비티는 중단되지만 시스템은 해당 액티비티를
-스택("백 스택")에 보존합니다. 새로운 액티비티가 시작되면, 이것이 백 스택 위로 밀려와 사용자의
-시선을 끕니다. 백 스택은 기본적인 "후입선출" 방식을 지키므로,
-사용자가 현재 액티비티를 끝내고 뒤로 버튼을 누르면 해당 액티비티가
+스택("백 스택")에 보존합니다. 새로운 액티비티가 시작되면, 이것이 백 스택 위로 밀려와 사용자의
+시선을 끕니다. 백 스택은 기본적인 "후입선출" 방식을 지키므로,
+사용자가 현재 액티비티를 끝내고 뒤로 버튼을 누르면 해당 액티비티가
스택에서 튀어나와(소멸되고) 이전 액티비티를 재개합니다 (백 스택은
작업
및 백 스택 문서에서 상세하게 논의합니다).
한 액티비티가 새로운 액티비티의 시작으로 인해 중단된 경우, 이 상태 변경은
-액티비티의 수명 주기 콜백 메서드를 통해 알려집니다.
+액티비티의 수명 주기 콜백 메서드를 통해 알려집니다.
액티비티가 시스템 액티비티를 생성, 중단, 재시작, 제거하는 등의 상태 변화로 인해 받을 수 있는 콜백 메서드는 여러 가지가 있습니다.
각 콜백은 상태 변화에 알맞은 특정 작업을 수행할 기회를 제공합니다.
- 예를 들어 액티비티가 중단되면 네트워크 또는 데이터베이스 연결과 같이
-큰 개체는 모두 해제해야 합니다. 액티비티가 재개되면, 필요한 리소스를
+ 예를 들어 액티비티가 중단되면 네트워크 또는 데이터베이스 연결과 같이
+큰 개체는 모두 해제해야 합니다. 액티비티가 재개되면, 필요한 리소스를
다시 획득하여 중단된 작업을 재개할 수 있습니다. 이러한 상태 전환은
모두 액티비티 수명 주기의 일부입니다.
@@ -83,52 +83,52 @@ page.tags=activity,intent
액티비티를 생성하려면 {@link android.app.Activity}의 하위 클래스(또는 이의
기존 하위 클래스)를 생성해야 합니다. 하위 클래스에서는
액티비티 생성, 중단, 재개, 소멸 시기 등과 같은
-수명 주기의 다양한 상태 간 액티비티가 전환될 때 시스템이 호출하는 콜백 메서드를 구현해야 합니다. 가장 중요한 두 가지 콜백 메서드는
+수명 주기의 다양한 상태 간 액티비티가 전환될 때 시스템이 호출하는 콜백 메서드를 구현해야 합니다. 가장 중요한 두 가지 콜백 메서드는
다음과 같습니다.
{@link android.app.Activity#onCreate onCreate()}
이 메서드는 반드시 구현해야 합니다. 시스템은 액티비티를 생성할 때 이것을 호출합니다.
- 구현하는 중에 액티비티의 필수 구성 요소를 초기화해야
+ 구현하는 중에 액티비티의 필수 구성 요소를 초기화해야
합니다.
무엇보다도 중요한 점은, 바로 여기서 {@link android.app.Activity#setContentView
setContentView()}를 호출해야 액티비티의 사용자 인터페이스 레이아웃을 정의할 수 있다는 점입니다.
{@link android.app.Activity#onPause onPause()}
-
시스템이 이 메서드를 호출하는 것은 사용자가 액티비티를 떠난다는
-첫 번째 신호입니다(다만 이것이 항상 액티비티가 소멸 중이라는 뜻은 아닙니다). 현재 사용자 세션을 넘어서
-지속되어야 하는 변경 사항을 커밋하려면 보통 이곳에서 해아 합니다(사용자가
+
시스템이 이 메서드를 호출하는 것은 사용자가 액티비티를 떠난다는
+첫 번째 신호입니다(다만 이것이 항상 액티비티가 소멸 중이라는 뜻은 아닙니다). 현재 사용자 세션을 넘어서
+지속되어야 하는 변경 사항을 커밋하려면 보통 이곳에서 해아 합니다(사용자가
돌아오지 않을 수 있기 때문입니다).
-
여러 액티비티 사이에서 원활한 사용자 경험을 제공하고, 액티비티 중단이나 심지어
-소멸을 초래할 수도 있는 예상치 못한 간섭을 처리하기 위해 사용해야 하는 다른 수명 주기
-콜백 메서드도 여러 가지 있습니다. 모든 수명 주기 콜백 메서드는 나중에
+
여러 액티비티 사이에서 원활한 사용자 경험을 제공하고, 액티비티 중단이나 심지어
+소멸을 초래할 수도 있는 예상치 못한 간섭을 처리하기 위해 사용해야 하는 다른 수명 주기
+콜백 메서드도 여러 가지 있습니다. 모든 수명 주기 콜백 메서드는 나중에
액티비티 수명 주기 관리 섹션에서 자세히 논의할 것입니다.
사용자 인터페이스 구현하기
-
한 액티비티에 대한 사용자 인터페이스는 보기 계층—즉,
+
한 액티비티에 대한 사용자 인터페이스는 보기 계층—즉,
{@link android.view.View} 클래스에서 파생된 개체가 제공합니다. 각 보기는 액티비티 창 안의 특정한 직사각형 공간을
- 제어하며 사용자 상호 작용에 대응할 수 있습니다. 예를 들어, 어떤 보기는 사용자가 터치하면
+ 제어하며 사용자 상호 작용에 대응할 수 있습니다. 예를 들어, 어떤 보기는 사용자가 터치하면
작업을 시작하는 버튼일 수 있습니다.
-
Android는 레이아웃을 디자인하고 정리하는 데 사용할 수 있도록 여러 가지 보기를 미리 만들어
-제공합니다. "위젯"이란 화면에 시각적(이자 대화형) 요소를 제공하는 보기입니다. 예를 들어
+
Android는 레이아웃을 디자인하고 정리하는 데 사용할 수 있도록 여러 가지 보기를 미리 만들어
+제공합니다. "위젯"이란 화면에 시각적(이자 대화형) 요소를 제공하는 보기입니다. 예를 들어
버튼, 텍스트 필드, 확인란이나 그저 하나의 이미지일 수도 있습니다. "레이아웃"은 선형 레이아웃, 격자형 레이아웃, 상대적 레이아웃과 같이 하위 레이아웃에 대해 독특한 레이아웃 모델을 제공하는 {@link
android.view.ViewGroup}에서 파생된
보기입니다. 또한, {@link android.view.View}와
{@link android.view.ViewGroup} 클래스(또는 기존 하위 클래스)의 아래로 내려가서 위젯과 레이아웃을 생성하고
이를 액티비티 레이아웃에 적용할 수 있습니다.
-
보기를 사용하여 레이아웃을 정의하는 가장 보편적인 방식은 애플리케이션 리소스에 저장된
+
보기를 사용하여 레이아웃을 정의하는 가장 보편적인 방식은 애플리케이션 리소스에 저장된
XML 레이아웃 파일을 사용하는 것입니다. 이렇게 하면 액티비티의 동작을 정의하는
-소스 코드와 별개로 사용자 인터페이스 디자인을 유지할 수 있습니다.
+소스 코드와 별개로 사용자 인터페이스 디자인을 유지할 수 있습니다.
{@link android.app.Activity#setContentView(int) setContentView()}로 액티비티의 UI로서 레이아웃을 설정하고,
해당 레이아웃의 리소스 ID를 전달할 수 있습니다. 그러나 액티비티 코드에 새로운 {@link android.view.View}를 생성하고
새로운 {@link
-android.view.View}를 {@link android.view.ViewGroup}에 삽입하여 보기 계층을 구축한 뒤 루트
+android.view.View}를 {@link android.view.ViewGroup}에 삽입하여 보기 계층을 구축한 뒤 루트
{@link android.view.ViewGroup}을 {@link android.app.Activity#setContentView(View)
setContentView()}에 전달해도 해당 레이아웃을 사용할 수 있습니다.
@@ -138,7 +138,7 @@ setContentView()}에 전달해도 해당 레이아웃을 사용할 수 있습니
Android SDK 도구를 사용하여 새 애플리케이션을 생성하는 경우, 개발자를 위해
-생성되어 있는 스텁 액티비티에 자동으로 인텐트 필터가 포함되어 있어 "주요" 동작에
-응답하는 액티비티를 선언하며, 이는 "시작 관리자" 범주에 배치해야 합니다. 인텐트 필터는 다음과
+
Android SDK 도구를 사용하여 새 애플리케이션을 생성하는 경우, 개발자를 위해
+생성되어 있는 스텁 액티비티에 자동으로 인텐트 필터가 포함되어 있어 "주요" 동작에
+응답하는 액티비티를 선언하며, 이는 "시작 관리자" 범주에 배치해야 합니다. 인텐트 필터는 다음과
같은 형태를 띱니다.
@@ -188,23 +188,23 @@ setContentView()}에 전달해도 해당 레이아웃을 사용할 수 있습니
{@code
<action>} 요소는 이것이 애플리케이션으로 가는 "주요" 진입 지점이라는 것을 나타냅니다. {@code
-<category>} 요소는 이 액티비티가 시스템의
+<category>} 요소는 이 액티비티가 시스템의
애플리케이션 시작 관리자에 목록으로 나열되어야 한다는 것을 나타냅니다(사용자가 이 액티비티를 시작할 수 있도록 해줌).
-
애플리케이션이 자체 포함 방식이기를 원하고 다른 애플리케이션이 이
-애플리케이션의 액티비티를 활성화하도록 허용하지 않고자 하면, 달리 인텐트 필터가 더 필요하지 않습니다. "주요" 동작과 "시작 관리자" 범주가 있는
-액티비티는 하나뿐이어야 합니다(이전 예시 참조). 다른 애플리케이션에서
-사용할 수 없게 하고자 하는 액티비티에는 인텐트 필터가 있으면 안 됩니다.
+
애플리케이션이 자체 포함 방식이기를 원하고 다른 애플리케이션이 이
+애플리케이션의 액티비티를 활성화하도록 허용하지 않고자 하면, 달리 인텐트 필터가 더 필요하지 않습니다. "주요" 동작과 "시작 관리자" 범주가 있는
+액티비티는 하나뿐이어야 합니다(이전 예시 참조). 다른 애플리케이션에서
+사용할 수 없게 하고자 하는 액티비티에는 인텐트 필터가 있으면 안 됩니다.
이러한 액티비티는 명시적인 인텐트를 사용해 직접 시작할 수 있습니다(이 내용은 다음 섹션에서 논의).
-
그러나, 액티비티가 다른 애플리케이션(및 본인의 애플리케이션)에서
-전달된 암시적 인텐트에 응답하도록 하려면 액티비티에 추가로 인텐트 필터를 정의해야만
-합니다. 응답하게 하고자 하는 각 인텐트 유형별로
+
그러나, 액티비티가 다른 애플리케이션(및 본인의 애플리케이션)에서
+전달된 암시적 인텐트에 응답하도록 하려면 액티비티에 추가로 인텐트 필터를 정의해야만
+합니다. 응답하게 하고자 하는 각 인텐트 유형별로
{@code
<action>} 요소를 포함하는 {@code
<intent-filter>}를 하나씩 포함시켜야 하며, 선택 사항으로 {@code
<category>} 요소 및/또는 {@code
-<data>} 요소를 포함시킬 수 있습니다. 이와 같은 요소는 액티비티가 응답할 수 있는 인텐트의 유형을
+<data>} 요소를 포함시킬 수 있습니다. 이와 같은 요소는 액티비티가 응답할 수 있는 인텐트의 유형을
나타냅니다.
액티비티가 인텐트에 응답하는 방식에 관한 자세한 정보는 인텐트 및 인텐트 필터
@@ -215,15 +215,15 @@ setContentView()}에 전달해도 해당 레이아웃을 사용할 수 있습니
액티비티 시작하기
다른 액티비티를 시작하려면 {@link android.app.Activity#startActivity
- startActivity()}를 호출한 다음 이에 시작하고자 하는 액티비티를 설명하는 {@link android.content.Intent}를
-전달하면 됩니다. 인텐트는 시작하고자 하는 액티비티를 정확히 나타내거나, 수행하고자 하는 작업의
-유형을 설명하는 것입니다(시스템이 적절한 액티비티를 선택하며,
+ startActivity()}를 호출한 다음 이에 시작하고자 하는 액티비티를 설명하는 {@link android.content.Intent}를
+전달하면 됩니다. 인텐트는 시작하고자 하는 액티비티를 정확히 나타내거나, 수행하고자 하는 작업의
+유형을 설명하는 것입니다(시스템이 적절한 액티비티를 선택하며,
이는
다른 애플리케이션에서 가져온 것일 수도 있습니다). 인텐트는 소량의 데이터를 운반하여 시작된 액티비티에서
사용할 수 있습니다.
본인의 애플리케이션 안에서 작업하는 경우에는, 알려진 액티비티를 시작하기만 하면 되는 경우가 잦습니다.
- 이렇게 하려면 시작하고자 하는 액티비티를 명시적으로 정의하는 인텐트를 클래스 이름을
+ 이렇게 하려면 시작하고자 하는 액티비티를 명시적으로 정의하는 인텐트를 클래스 이름을
사용하여 생성하면 됩니다. 예를 들어, 다음은 한 액티비티가 {@code
SignInActivity}라는 이름의 다른 액티비티를 시작하는 방법입니다.
그러나, 애플리케이션이 다른 몇 가지 동작을 수행하고자 할 수도 있습니다. 예를 들어 이메일 보내기, 문자
-메시지 보내기 또는 상태 업데이트 등을 액티비티의 데이터를 사용하여 수행하는 것입니다. 이 경우, 본인의 애플리케이션에
-그러한 동작을 수행할 자체 액티비티가 없을 수도 있습니다. 따라서 기기에 있는 다른 애플리케이션이
-제공하는 액티비티를 대신 활용하여 동작을 수행하도록 할 수 있습니다. 바로 이 부분에서
-인텐트의 진가가 발휘됩니다. 수행하고자 하는 동작을 설명하는 인텐트를 생성하면
+
그러나, 애플리케이션이 다른 몇 가지 동작을 수행하고자 할 수도 있습니다. 예를 들어 이메일 보내기, 문자
+메시지 보내기 또는 상태 업데이트 등을 액티비티의 데이터를 사용하여 수행하는 것입니다. 이 경우, 본인의 애플리케이션에
+그러한 동작을 수행할 자체 액티비티가 없을 수도 있습니다. 따라서 기기에 있는 다른 애플리케이션이
+제공하는 액티비티를 대신 활용하여 동작을 수행하도록 할 수 있습니다. 바로 이 부분에서
+인텐트의 진가가 발휘됩니다. 수행하고자 하는 동작을 설명하는 인텐트를 생성하면
시스템이 적절한 액티비티를
다른 애플리케이션에서 시작하는 것입니다. 해당 인텐트를
처리할 수 있는 액티비티가 여러 개 있는 경우, 사용자가 어느 것을 사용할지 선택합니다. 예를
- 들어 사용자가 이메일 메시지를 보낼 수 있게 하려면, 다음과 같은 인텐트를
+ 들어 사용자가 이메일 메시지를 보낼 수 있게 하려면, 다음과 같은 인텐트를
생성하면 됩니다.
@@ -250,7 +250,7 @@ startActivity(intent);
인텐트에 추가된 {@link android.content.Intent#EXTRA_EMAIL} 추가 사항은 이메일이 전송되어야 할 이메일 주소의
- 문자열 배열입니다. 이메일 애플리케이션이 이 인텐트에
+ 문자열 배열입니다. 이메일 애플리케이션이 이 인텐트에
응답하면, 애플리케이션은 추가 사항이 제공한 문자열 배열을 읽어낸 다음 이를 이메일 작성 양식의
"수신" 필드에 배치합니다. 이 상황에서 이메일 애플리케이션의 액티비티가 시작되고 사용자가
작업을 끝내면 본인의 액티비티가 재개되는 것입니다.
@@ -263,14 +263,14 @@ startActivity(intent);
때로는 시작한 액티비티에서 결과를 받고 싶을 수도 있습니다. 그런 경우,
({@link android.app.Activity#startActivity
startActivity()} 대신) {@link android.app.Activity#startActivityForResult
- startActivityForResult()}를 호출해서 액티비티를 시작합니다. 그런 다음 후속 액티비티에서 결과를
+ startActivityForResult()}를 호출해서 액티비티를 시작합니다. 그런 다음 후속 액티비티에서 결과를
받으려면, {@link android.app.Activity#onActivityResult onActivityResult()} 콜백
메서드를 구현합니다. 해당 후속 액티비티가 완료되면, 이것이 {@link
android.content.Intent} 형식으로 결과를 {@link android.app.Activity#onActivityResult onActivityResult()}
메서드에 반환합니다.
-
예를 들어 사용자가 연락처 중에서 하나를 고를 수 있도록 하고 싶을 수 있습니다.
-즉 여러분의 액티비티가 해당 연락처의 정보로 무언가 할 수 있도록 하는 것입니다. 그와 같은 인텐트를 생성하고 결과를 처리하려면
+
예를 들어 사용자가 연락처 중에서 하나를 고를 수 있도록 하고 싶을 수 있습니다.
+즉 여러분의 액티비티가 해당 연락처의 정보로 무언가 할 수 있도록 하는 것입니다. 그와 같은 인텐트를 생성하고 결과를 처리하려면
다음과 같이 하면 됩니다.
이 예시는 액티비티 결과를 처리하기 위해 {@link
android.app.Activity#onActivityResult onActivityResult()} 메서드에서 사용해야 할 기본 논리를
나타낸 것입니다. 첫 번째 조건은 요청이 성공적인지 확인합니다. 요청에 성공했다면
-{@code resultCode}가 {@link android.app.Activity#RESULT_OK}가 됩니다. 또한, 이 결과가 응답하는 요청이
+{@code resultCode}가 {@link android.app.Activity#RESULT_OK}가 됩니다. 또한, 이 결과가 응답하는 요청이
알려져 있는지도 확인합니다. 이 경우에는 {@code requestCode}가
{@link android.app.Activity#startActivityForResult
startActivityForResult()}와 함께 전송된 두 번째 매개변수와 일치합니다. 여기서부터 코드가
@@ -317,58 +317,58 @@ android.content.ContentResolver}가 콘텐츠 제공자에 대한 쿼리를 수
액티비티 종료하기
액티비티를 종료하려면 해당 액티비티의 {@link android.app.Activity#finish
-finish()} 메서드를 호출하면 됩니다.
+finish()} 메서드를 호출하면 됩니다.
{@link android.app.Activity#finishActivity finishActivity()}를 호출하여 이전에 시작한 별도의 액티비티를 종료할 수도 있습니다.
-
참고: 대부분의 경우, 이와 같은 메서드를 사용하여 액티비티를 명시적으로
-종료해서는 안 됩니다. 다음 섹션에서 액티비티 수명 주기에 관해 논의한 바와 같이,
-Android 시스템이 액티비티의 수명을 대신 관리해주므로 직접 액티비티를 종료하지
-않아도 됩니다. 이와 같은 메서드를 호출하면 예상되는 사용자
-환경에 부정적인 영향을 미칠 수 있으며, 따라서 사용자가 액티비티의 이 인스턴스에 돌아오는 것을 절대 바라지 않는 경우에만
+
참고: 대부분의 경우, 이와 같은 메서드를 사용하여 액티비티를 명시적으로
+종료해서는 안 됩니다. 다음 섹션에서 액티비티 수명 주기에 관해 논의한 바와 같이,
+Android 시스템이 액티비티의 수명을 대신 관리해주므로 직접 액티비티를 종료하지
+않아도 됩니다. 이와 같은 메서드를 호출하면 예상되는 사용자
+환경에 부정적인 영향을 미칠 수 있으며, 따라서 사용자가 액티비티의 이 인스턴스에 돌아오는 것을 절대 바라지 않는 경우에만
사용해야 합니다.
액티비티 수명 주기 관리하기
-
콜백 메서드를 구현하여 액티비티의 수명 주기를 관리하는 것은
-강력하고 유연한 애플리케이션 개발에
-대단히 중요한 역할을 합니다. 액티비티의 수명 주기는 다른 액티비티와의 관계,
+
콜백 메서드를 구현하여 액티비티의 수명 주기를 관리하는 것은
+강력하고 유연한 애플리케이션 개발에
+대단히 중요한 역할을 합니다. 액티비티의 수명 주기는 다른 액티비티와의 관계,
액티비티의 작업과 백 스택 등에 직접적으로 영향을 받습니다.
액티비티는 기본적으로 세 가지 상태로 존재할 수 있습니다.
재개됨
-
액티비티가 화면 전경에 있으며 사용자의 초점이 맞춰져 있습니다 (이 상태를 때로는
+
액티비티가 화면 전경에 있으며 사용자의 초점이 맞춰져 있습니다 (이 상태를 때로는
"실행 중"이라고 일컫기도 합니다).
일시정지됨
다른 액티비티가 전경에 나와 있고 사용자의 시선을 집중시키고 있지만, 이 액티비티도 여전히 표시되어 있습니다. 다시 말해,
-다른 액티비티가 이 액티비티 위에 표시되어 있으며 해당 액티비티는 부분적으로 투명하거나
+다른 액티비티가 이 액티비티 위에 표시되어 있으며 해당 액티비티는 부분적으로 투명하거나
전체 화면을 덮지 않는 상태라는 뜻입니다. 일시정지된 액티비티는 완전히 살아있지만({@link android.app.Activity}
-개체가 메모리에 보관되어 있고, 모든 상태 및 구성원 정보를 유지하며,
+개체가 메모리에 보관되어 있고, 모든 상태 및 구성원 정보를 유지하며,
창 관리자에 붙어 있는 상태로 유지됨), 메모리가 극히 부족한 경우 시스템이 중단시킬 수 있습니다.
정지됨
-
이 액티비티가 다른 액티비티에 완전히 가려진 상태입니다(액티비티가 이제
+
이 액티비티가 다른 액티비티에 완전히 가려진 상태입니다(액티비티가 이제
"배경"에 위치함). 중단된 액티비티도 여전히 살아 있기는 마찬가지입니다({@link android.app.Activity}
개체가 메모리에 보관되어 있고, 모든 상태와 구성원 정보를 유지하시만 창 관리자에 붙어 있지 않음
-). 그러나, 이는 더 이상 사용자에게 표시되지 않으며
+). 그러나, 이는 더 이상 사용자에게 표시되지 않으며
다른 곳에 메모리가 필요하면 시스템이 종료시킬 수 있습니다.
-
액티비티가 일시정지 또는 중단된 상태이면, 시스템이 이를 메모리에서 삭제할 수 있습니다. 이러기 위해서는
-종료를 요청하거나({@link android.app.Activity#finish finish()} 메서드를 호출) 단순히 이 액티비티의 프로세스를 중단시키면
-됩니다. 액티비티가 다시 열릴 때에는(종료 또는 중단된 후에) 처음부터 다시 생성해야
+
액티비티가 일시정지 또는 중단된 상태이면, 시스템이 이를 메모리에서 삭제할 수 있습니다. 이러기 위해서는
+종료를 요청하거나({@link android.app.Activity#finish finish()} 메서드를 호출) 단순히 이 액티비티의 프로세스를 중단시키면
+됩니다. 액티비티가 다시 열릴 때에는(종료 또는 중단된 후에) 처음부터 다시 생성해야
합니다.
수명 주기 콜백 구현하기
-
위에서 설명한 바와 같이 액티비티가 여러 가지 상태를 오가며 전환되면, 이와 같은 내용이
-여러 가지 콜백 메서드를 통해 통지됩니다. 콜백 메서드는 모두 후크로서,
-액티비티 상태가 변경될 때 적절한 작업을 하기 위해 이를 재정의할 수 있습니다. 다음의 골격
+
위에서 설명한 바와 같이 액티비티가 여러 가지 상태를 오가며 전환되면, 이와 같은 내용이
+여러 가지 콜백 메서드를 통해 통지됩니다. 콜백 메서드는 모두 후크로서,
+액티비티 상태가 변경될 때 적절한 작업을 하기 위해 이를 재정의할 수 있습니다. 다음의 골격
액티비티에는 기본 수명 주기 메서드가 각각 하나씩 포함되어 있습니다.
@@ -410,51 +410,51 @@ public class ExampleActivity extends Activity {
참고: 이와 같은 수명 주기 메서드를 구현하려면, 항상
슈퍼클래스 구현을 호출한 다음에만 다른 작업을 시작할 수 있습니다(위의 예시 참조).
-
이와 같은 메서드를 모두 합쳐 한 액티비티의 수명 주기 전체를 정의합니다. 이러한 메서드를 구현함으로써
+
이와 같은 메서드를 모두 합쳐 한 액티비티의 수명 주기 전체를 정의합니다. 이러한 메서드를 구현함으로써
액티비티 수명 주기 내의 세 가지 중첩된 루프를 모니터링할 수 있습니다.
한 액티비티의 전체 수명은 {@link
android.app.Activity#onCreate onCreate()} 호출과 {@link
-android.app.Activity#onDestroy} 호출 사이를 말합니다. 액티비티는 {@link android.app.Activity#onCreate onCreate()}에서
-"전체" 상태(레이아웃 정의 등)의 설정을 수행한 다음 나머지 리소스를
-모두 {@link android.app.Activity#onDestroy}에 해제해야 합니다. 예를 들어,
-액티비티에 네트워크에서 데이터를 다운로드하기 위해 배경에서 실행 중인 스레드가 있는 경우, 이는
+android.app.Activity#onDestroy} 호출 사이를 말합니다. 액티비티는 {@link android.app.Activity#onCreate onCreate()}에서
+"전체" 상태(레이아웃 정의 등)의 설정을 수행한 다음 나머지 리소스를
+모두 {@link android.app.Activity#onDestroy}에 해제해야 합니다. 예를 들어,
+액티비티에 네트워크에서 데이터를 다운로드하기 위해 배경에서 실행 중인 스레드가 있는 경우, 이는
해당 스레드를 {@link android.app.Activity#onCreate onCreate()}에서 생성한 다음 {@link
android.app.Activity#onDestroy}에서 그 스레드를 중단할 수 있습니다.
액티비티의 가시적 수명은 {@link
android.app.Activity#onStart onStart()} 호출에서 {@link
-android.app.Activity#onStop onStop()} 호출 사이를 말합니다. 이 기간 중에는 사용자가 액티비티를 화면에서 보고 이와
+android.app.Activity#onStop onStop()} 호출 사이를 말합니다. 이 기간 중에는 사용자가 액티비티를 화면에서 보고 이와
상호작용할 수 있습니다. 예컨대 {@link android.app.Activity#onStop onStop()}이 호출되어
- 새 액티비티가 시작되면 이 액티비티는 더 이상 표시되지 않게 됩니다. 이와 같은 두 가지 메서드 중에서
+ 새 액티비티가 시작되면 이 액티비티는 더 이상 표시되지 않게 됩니다. 이와 같은 두 가지 메서드 중에서
사용자에게 액티비티를 표시하는 데 필요한 리소스를 유지하면 됩니다. 예를 들어,
{@link
android.app.Activity#onStart onStart()}에서 {@link android.content.BroadcastReceiver}를 등록하고 UI에 영향을 미치는 변화를 모니터링하고
-{@link android.app.Activity#onStop onStop()}에서 등록을 해제하면 사용자는 여러분이 무엇을 표시하고 있는지 더 이상 볼 수
+{@link android.app.Activity#onStop onStop()}에서 등록을 해제하면 사용자는 여러분이 무엇을 표시하고 있는지 더 이상 볼 수
없게 됩니다. 시스템은 액티비티의 전체 수명 내내 {@link android.app.Activity#onStart onStart()} 및 {@link
-android.app.Activity#onStop onStop()}을 여러 번 호출할 수 있으며, 이때
+android.app.Activity#onStop onStop()}을 여러 번 호출할 수 있으며, 이때
액티비티는 사용자에게 표시되었다 숨겨지는 상태를 오가게 됩니다.
액티비티의 전경 수명은 {@link
android.app.Activity#onResume onResume()} 호출에서 {@link android.app.Activity#onPause
-onPause()} 호출 사이를 말합니다. 이 기간 중에는 이 액티비티가 화면에서 다른 모든 액티비티 앞에 표시되며 사용자 입력도
+onPause()} 호출 사이를 말합니다. 이 기간 중에는 이 액티비티가 화면에서 다른 모든 액티비티 앞에 표시되며 사용자 입력도
여기에 집중됩니다. 액티비티는 전경에 나타났다 숨겨지는 전환을 자주 반복할 수 있습니다. 예를 들어
-, 기기가 절전 모드에 들어가거나 대화 상자가
-나타나면 {@link android.app.Activity#onPause onPause()}가 호출됩니다. 이 상태는 자주 전환될 수 있으므로, 이 두 가지 메서드의 코드는
+, 기기가 절전 모드에 들어가거나 대화 상자가
+나타나면 {@link android.app.Activity#onPause onPause()}가 호출됩니다. 이 상태는 자주 전환될 수 있으므로, 이 두 가지 메서드의 코드는
상당히 가벼워야 합니다. 그래야 전환이 느려 사용자를 기다리게 하는 일을 피할 수 있습니다.
그림 1은 액티비티가 상태 사이에서 취할 수 있는 이와 같은 루프와 경로를 나타낸 것입니다.
-직사각형이 액티비티가 여러 상태 사이를 전환할 때 작업을 수행하도록
+직사각형이 액티비티가 여러 상태 사이를 전환할 때 작업을 수행하도록
구현할 수 있는 콜백 메서드를 나타냅니다.
그림 1. 액티비티 수명 주기입니다.
-
같은 수명 주기 콜백 메서드가 표 1에 나열되어 있으며, 이 표는 각 콜백
-메서드를 더욱 상세하게 설명하며 액티비티의 전반적인
-수명 주기 내에서 각 메서드의 위치를 나타내기도 합니다. 여기에는 콜백 메서드가 완료된 다음
+
같은 수명 주기 콜백 메서드가 표 1에 나열되어 있으며, 이 표는 각 콜백
+메서드를 더욱 상세하게 설명하며 액티비티의 전반적인
+수명 주기 내에서 각 메서드의 위치를 나타내기도 합니다. 여기에는 콜백 메서드가 완료된 다음
시스템이 액티비티를 중단시킬 수 있는지 여부도 포함되어 있습니다.
표 1. 액티비티 수명 주기
@@ -474,9 +474,9 @@ onPause()} 호출 사이를 말합니다. 이 기간 중에는 이 액티비티
{@link android.app.Activity#onCreate onCreate()}
액티비티가 처음 생성되었을 때 호출됩니다.
- 이곳에서 일반적인 정적 설정을 모두 수행해야 합니다.
-즉 보기 생성, 목록에 데이터 바인딩하기 등을 말합니다. 이 메서드에는
-액티비티의 이전 상태가 캡처된 경우 해당 상태를 포함한
+ 이곳에서 일반적인 정적 설정을 모두 수행해야 합니다.
+즉 보기 생성, 목록에 데이터 바인딩하기 등을 말합니다. 이 메서드에는
+액티비티의 이전 상태가 캡처된 경우 해당 상태를 포함한
번들 개체가 전달됩니다(이 문서 나중에 나오는 액티비티 상태 저장하기를 참조하십시오
).
이 뒤에는 항상 {@code onStart()}가 따라옵니다.
@@ -508,7 +508,7 @@ onRestart()}
{@link android.app.Activity#onResume onResume()}
액티비티가 시작되고 사용자와 상호 작용하기 직전에
-호출됩니다. 이 시점에서 액티비티는 액티비티
+호출됩니다. 이 시점에서 액티비티는 액티비티
스택의 맨 위에 있으며, 사용자 입력이 입력되고 있습니다.
이 뒤에는 항상 {@code onPause()}가 따라옵니다.
아니요
@@ -517,10 +517,10 @@ onRestart()}
{@link android.app.Activity#onPause onPause()}
-
시스템이 다른 액티비티를 재개하기 직전에
-호출됩니다. 이 메서드는 일반적으로 데이터를 유지하기 위해 저장되지 않은 변경 사항을
-커밋하는 데, 애니메이션을 비롯하여 CPU를 소모하는 기타 작업을 중단하는 등
-여러 가지 용도에 사용됩니다. 이 메서드는 무슨 일을 하든 매우 빨리 끝내야 합니다.
+
시스템이 다른 액티비티를 재개하기 직전에
+호출됩니다. 이 메서드는 일반적으로 데이터를 유지하기 위해 저장되지 않은 변경 사항을
+커밋하는 데, 애니메이션을 비롯하여 CPU를 소모하는 기타 작업을 중단하는 등
+여러 가지 용도에 사용됩니다. 이 메서드는 무슨 일을 하든 매우 빨리 끝내야 합니다.
이것이 반환될 때까지 다음 액티비티가 재개되지 않기 때문입니다.
액티비티가 다시 전경으로 돌아오면 {@code onResume()}이 뒤에 따라오고
액티비티가 사용자에게 보이지 않게 되면{@code onStop()}이 뒤에 따라옵니다.
@@ -544,11 +544,11 @@ onRestart()}
액티비티가 소멸되기 전에 호출됩니다. 이것이 액티비티가 받는
-마지막 호출입니다. 이것이 호출될 수 있는 경우는 액티비티가
+
액티비티가 소멸되기 전에 호출됩니다. 이것이 액티비티가 받는
+마지막 호출입니다. 이것이 호출될 수 있는 경우는 액티비티가
완료되는 중이라서(누군가가 여기에 {@link android.app.Activity#finish
- finish()}를 호출해서)일 수도 있고, 시스템이 공간을 절약하기 위해 액티비티의 이 인스턴스를 일시적으로 소멸시키는
-중이기 때문일 수도 있습니다. 이와 같은
+ finish()}를 호출해서)일 수도 있고, 시스템이 공간을 절약하기 위해 액티비티의 이 인스턴스를 일시적으로 소멸시키는
+중이기 때문일 수도 있습니다. 이와 같은
두 가지 시나리오는 {@link
android.app.Activity#isFinishing isFinishing()} 메서드로 구분할 수 있습니다.
예
@@ -558,49 +558,49 @@ onDestroy()}
"완료 후 중단 가능?"이라는 레이블이 붙은 열은
- 시스템이 메서드가 반환된 후 액티비티 코드의 다른 줄을 실행하지 않고도
+ 시스템이 메서드가 반환된 후 액티비티 코드의 다른 줄을 실행하지 않고도
언제든 이 액티비티를 호스팅하는 프로세스를 중단시킬 수 있는지 여부를 나타냅니다. 다음 세 가지 메서드가 "예"로 표시되어 있습니다({@link
android.app.Activity#onPause
onPause()}, {@link android.app.Activity#onStop onStop()} 및 {@link android.app.Activity#onDestroy
onDestroy()}). {@link android.app.Activity#onPause onPause()}가 세 가지 메서드 중에서
첫 번째이므로, 액티비티가 생성되면 {@link android.app.Activity#onPause onPause()}는 프로세스가 지워지기 전에
-반드시 호출되는 마지막 메서드입니다.
+반드시 호출되는 마지막 메서드입니다.
시스템이 비상 시에 메모리를 복구해야 할 경우, {@link
android.app.Activity#onStop onStop()}와 {@link android.app.Activity#onDestroy onDestroy()}는
-호출되지 않을 수도 있습니다. 따라서, 중요한 영구적 데이터(사용자 편집 등)를 보관하기 위해 작성하는 경우에는 {@link android.app.Activity#onPause onPause()}를 사용해야
-합니다. 그러나, {@link android.app.Activity#onPause onPause()} 중에
-어느 정보를 유지해야 할지는 조심해서 선택해야 합니다. 이 메서드에 차단 절차가 있으면
-다음 액티비티로의 전환을 차단하고 사용자 경험을 느려지게 할 수 있기
+호출되지 않을 수도 있습니다. 따라서, 중요한 영구적 데이터(사용자 편집 등)를 보관하기 위해 작성하는 경우에는 {@link android.app.Activity#onPause onPause()}를 사용해야
+합니다. 그러나, {@link android.app.Activity#onPause onPause()} 중에
+어느 정보를 유지해야 할지는 조심해서 선택해야 합니다. 이 메서드에 차단 절차가 있으면
+다음 액티비티로의 전환을 차단하고 사용자 경험을 느려지게 할 수 있기
때문입니다.
-
중단 가능한 열에 "아니요"로 표시된 메서드는 액티비티를 호스팅하는 프로세스를
-보호하여 호출된 즉시 중단되지 않도록 방지합니다. 따라서 액티비티는
-{@link android.app.Activity#onPause onPause()}가 반환되는 시기부터
-{@link android.app.Activity#onResume onResume()}이 호출되는 시기 사이에 중단시킬 수 있습니다. 다시 중단시킬 수 있는 상태가 되려면
+
중단 가능한 열에 "아니요"로 표시된 메서드는 액티비티를 호스팅하는 프로세스를
+보호하여 호출된 즉시 중단되지 않도록 방지합니다. 따라서 액티비티는
+{@link android.app.Activity#onPause onPause()}가 반환되는 시기부터
+{@link android.app.Activity#onResume onResume()}이 호출되는 시기 사이에 중단시킬 수 있습니다. 다시 중단시킬 수 있는 상태가 되려면
{@link android.app.Activity#onPause onPause()}가 다시 호출되어 반환되어야 합니다.
-
참고: 표 1에 나타난 이런 정의에
-따르면 엄밀히 말해 "중단 가능한" 것이 아닌 액티비티라도 시스템이 중단시킬 수는 있습니다. 다만 이것은 다른 리소스가 없는
-극단적인 상황에서만 발생합니다. 액티비티가 중단될 수 있는 시기가
+
참고: 표 1에 나타난 이런 정의에
+따르면 엄밀히 말해 "중단 가능한" 것이 아닌 액티비티라도 시스템이 중단시킬 수는 있습니다. 다만 이것은 다른 리소스가 없는
+극단적인 상황에서만 발생합니다. 액티비티가 중단될 수 있는 시기가
언제인지는 프로세스 및
스레딩 문서에서 보다 자세히 논의합니다.
액티비티 상태 저장하기
-
액티비티 수명 주기 관리하기 도입부에서는 액티비티가
-일시중지되거나
-중단되었더라도 액티비티의 상태는 그대로 유지된다고 잠시 언급한 바 있습니다. 이것은
-{@link android.app.Activity} 개체가 일시중지되거나 중단된 경우에도
-메모리 안에 그대로 보관되었기 때문에 가능합니다. 즉 이 액티비티의 구성원과 현재 상태에 대한 모든 정보가 아직 살아 있다는 뜻입니다. 따라서, 사용자가
-액티비티 내에서 변경한 모든 내용도 그대로 유지되어 액티비티가 전경으로
+
액티비티 수명 주기 관리하기 도입부에서는 액티비티가
+일시중지되거나
+중단되었더라도 액티비티의 상태는 그대로 유지된다고 잠시 언급한 바 있습니다. 이것은
+{@link android.app.Activity} 개체가 일시중지되거나 중단된 경우에도
+메모리 안에 그대로 보관되었기 때문에 가능합니다. 즉 이 액티비티의 구성원과 현재 상태에 대한 모든 정보가 아직 살아 있다는 뜻입니다. 따라서, 사용자가
+액티비티 내에서 변경한 모든 내용도 그대로 유지되어 액티비티가 전경으로
돌아갈 때("재개"될 때) 그와 같은 변경 사항도 그대로 존재하게 됩니다.
그러나 시스템이 메모리를 복구하기 위해 액티비티를 소멸시키는 경우에는 {@link
-android.app.Activity} 개체가 소멸되므로 시스템이 액티비티의 상태를 온전히 유지한 채로 간단하게 재개할 수 없게
-됩니다. 대신, 사용자가 다시 이 액티비티로 이동해 오면 시스템이 {@link android.app.Activity} 개체를
-다시 생성해야 합니다. 하지만, 사용자는 시스템이
-해당 액티비티를 소멸시켰다가 다시 생성했다는 것을 모릅니다.
+android.app.Activity} 개체가 소멸되므로 시스템이 액티비티의 상태를 온전히 유지한 채로 간단하게 재개할 수 없게
+됩니다. 대신, 사용자가 다시 이 액티비티로 이동해 오면 시스템이 {@link android.app.Activity} 개체를
+다시 생성해야 합니다. 하지만, 사용자는 시스템이
+해당 액티비티를 소멸시켰다가 다시 생성했다는 것을 모릅니다.
따라서 액티비티가 예전과 똑같을 것이라고 예상할 것입니다. 이런 상황에서는
액티비티 상태에 관한 정보를 저장할 수 있는 추가 콜백 메서드
{@link
@@ -617,19 +617,19 @@ android.os.Bundle#putInt putInt()} 같은 메서드를 사용하여, 이 메서
android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}에게 전달합니다. 이들 메서드 중
하나를 사용하여 {@link android.os.Bundle}에서 저장된 상태를 추출하고 액티비티 상태
를 복원할 수 있습니다. 복구할 상태 정보가 없는 경우, 여러분에게 전달되는 {@link
-android.os.Bundle}은 null입니다(액티비티가 처음 생성되었을 때 이런 경우가
+android.os.Bundle}은 null입니다(액티비티가 처음 생성되었을 때 이런 경우가
발생합니다).
-
그림 2. 액티비티의 상태가 온전한 채로 사용자의
-초점에 다시 돌아오는 데에는 두 가지 방식이 있습니다. 하나는 액티비티가 소멸되었다가 다시 생성되어 액티비티가
-이전에 저장된 상태를 복구해야 하는 경우, 다른 하나는 액티비티가 중단되었다가 재개되었으며
+
그림 2. 액티비티의 상태가 온전한 채로 사용자의
+초점에 다시 돌아오는 데에는 두 가지 방식이 있습니다. 하나는 액티비티가 소멸되었다가 다시 생성되어 액티비티가
+이전에 저장된 상태를 복구해야 하는 경우, 다른 하나는 액티비티가 중단되었다가 재개되었으며
액티비티 상태가 온전히 유지된 경우입니다.
참고: 상태를 저장할 필요가 없는 경우도 있으므로 액티비티가 소멸되기 전에 {@link
android.app.Activity#onSaveInstanceState onSaveInstanceState()}가 호출된다는 보장은 없습니다
-(예컨대 사용자가
+(예컨대 사용자가
명시적으로
액티비티를 닫기 위해 뒤로 버튼을 눌러서 액티비티를 떠날 때가 이에 해당합니다). 시스템이 {@link android.app.Activity#onSaveInstanceState
onSaveInstanceState()}를 호출하는 경우, {@link
@@ -642,9 +642,9 @@ android.app.Activity#onSaveInstanceState onSaveInstanceState()}를 구현하지
android.app.Activity#onSaveInstanceState onSaveInstanceState()}가 일부 액티비티 상태를 복구합니다. 특히, 기본
구현은 레이아웃에서 {@link
android.view.View}가 나올 때마다 해당하는 {@link
-android.view.View#onSaveInstanceState onSaveInstanceState()} 메서드를 호출하고, 이 때문에 각 보기가 저장해야 하는 자체 관련 정보를 제공할 수
-있게 해줍니다. Android 프레임워크를 사용하는 위젯은 거의 대부분 이 메서드를
-필요에 따라 구현하므로, UI에 눈에 보이는 변경이 있으면 모두 자동으로 저장되며 액티비티를 다시
+android.view.View#onSaveInstanceState onSaveInstanceState()} 메서드를 호출하고, 이 때문에 각 보기가 저장해야 하는 자체 관련 정보를 제공할 수
+있게 해줍니다. Android 프레임워크를 사용하는 위젯은 거의 대부분 이 메서드를
+필요에 따라 구현하므로, UI에 눈에 보이는 변경이 있으면 모두 자동으로 저장되며 액티비티를 다시
생성하면 복구됩니다. 예를 들어, {@link android.widget.EditText} 위젯은 사용자가 입력한 모든 텍스트
를 저장하고 {@link android.widget.CheckBox} 위젯은 확인 여부를 저장합니다.
여러분이 해야 할 유일한 작업은 상태를 저장하고자 하는 각 위젯에 고유 ID({@code android:id}
@@ -653,9 +653,9 @@ android.view.View#onSaveInstanceState onSaveInstanceState()} 메서드를 호출
-
또한,
-{@link android.R.attr#saveEnabled android:saveEnabled} 속성을 {@code "false"}로 설정하거나
-{@link android.view.View#setSaveEnabled setSaveEnabled()} 메서드를 호출해서 레이아웃의 보기가 상태를 저장하지 못하도록 명시적으로 막을 수 있습니다. 보통은 이것을 비활성화해서는
+
또한,
+{@link android.R.attr#saveEnabled android:saveEnabled} 속성을 {@code "false"}로 설정하거나
+{@link android.view.View#setSaveEnabled setSaveEnabled()} 메서드를 호출해서 레이아웃의 보기가 상태를 저장하지 못하도록 명시적으로 막을 수 있습니다. 보통은 이것을 비활성화해서는
안 되지만, 액티비티 UI의 상태를 다르게 복구하고자 하는 경우 그렇게 할 수도 있습니다.
@@ -668,25 +668,25 @@ UI에서 복구된 값과 상관관계가 있을 수 있지만 이런 UI 값을
).
{@link
-android.app.Activity#onSaveInstanceState onSaveInstanceState()}의 기본 구현이 UI 상태를 저장하는 데 도움이 되기 때문에,
-추가 상태 정보를 저장하기 위해 이 메서드를 재정의하려면
+android.app.Activity#onSaveInstanceState onSaveInstanceState()}의 기본 구현이 UI 상태를 저장하는 데 도움이 되기 때문에,
+추가 상태 정보를 저장하기 위해 이 메서드를 재정의하려면
작업을 하기 전에 항상{@link android.app.Activity#onSaveInstanceState onSaveInstanceState()}의 슈퍼클래스 구현
을 호출해야 합니다. 이와 마찬가지로 {@link
-android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}를 재정의하는 경우, 이것의 슈퍼클래스 구현을 호출해야 하기도 합니다.
+android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}를 재정의하는 경우, 이것의 슈퍼클래스 구현을 호출해야 하기도 합니다.
이렇게 해야 기본 구현이 보기 상태를 복구할 수 있습니다.
참고: {@link android.app.Activity#onSaveInstanceState
onSaveInstanceState()}의 호출이 보장되지 않으므로
이것은 액티비티의 일시적 상태(UI의 상태
-)를 기록하는 데에만 사용하고, 영구 데이터를 보관하는 데 사용해서는 안 됩니다. 대신, 사용자가 액티비티를 떠날 때 영구적인 데이터(데이터베이스에 저장되어야
+)를 기록하는 데에만 사용하고, 영구 데이터를 보관하는 데 사용해서는 안 됩니다. 대신, 사용자가 액티비티를 떠날 때 영구적인 데이터(데이터베이스에 저장되어야
하는 데이터 등)를 저장하려면 {@link
android.app.Activity#onPause onPause()}를 사용해야 합니다.
애플리케이션의 상태 저장 기능을 시험하는 좋은 방법은 기기를 회전해보고 화면 방향이
-바뀌는지 확인하는 것입니다. 화면 방향이 바뀌면 시스템은 액티비티를
-소멸시켰다가 다시 생성하여 새 화면 구성에서 이용할 수 있을지 모르는 대체
-리소스를 적용합니다. 이 이유 하나만으로도 액티비티가 다시 생성되었을 때 상태를
-완전히 복구할 수 있어야 한다는 점이 대단히 중요합니다. 사용자는 애플리케이션을 사용하면서 화면을
+바뀌는지 확인하는 것입니다. 화면 방향이 바뀌면 시스템은 액티비티를
+소멸시켰다가 다시 생성하여 새 화면 구성에서 이용할 수 있을지 모르는 대체
+리소스를 적용합니다. 이 이유 하나만으로도 액티비티가 다시 생성되었을 때 상태를
+완전히 복구할 수 있어야 한다는 점이 대단히 중요합니다. 사용자는 애플리케이션을 사용하면서 화면을
자주 돌리기 때문입니다.
@@ -700,8 +700,8 @@ android.app.Activity#onCreate onCreate()}를 호출합니다). 이런 동작은
설계되었습니다
(예: 다양한 화면 방향과 크기에 대한 다양한 레이아웃).
-
액티비티를 적절히 설계하여 화면 방향 변경으로 인한 재시작을 감당할 수 있으며
-위에 설명한 것처럼 액티비티 상태를 복구할 수 있도록 하면, 애플리케이션이 액티비티 수명 주기에서
+
액티비티를 적절히 설계하여 화면 방향 변경으로 인한 재시작을 감당할 수 있으며
+위에 설명한 것처럼 액티비티 상태를 복구할 수 있도록 하면, 애플리케이션이 액티비티 수명 주기에서
예기치 못한 이벤트가 일어나도 더욱 탄력적으로 복구될 수 있습니다.
이러한 재시작을 처리하는 가장 좋은 방법은 이전 섹션에서 논의한 바와 같이
@@ -710,22 +710,22 @@ android.app.Activity#onCreate onCreate()}를 호출합니다). 이런 동작은
android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}(또는 {@link
android.app.Activity#onCreate onCreate()})를 사용하여 액티비티 상태를 저장하고 복구하는 것입니다.
한 액티비티가 다른 액티비티를 시작하면, 둘 모두 수명 주기 전환을 겪습니다. 첫 번째 액티비티는
-일시중지하고 중단되는 반면(배경에서 계속 보이는 경우에는 중단되지 않습니다만), 다른 액티비티는
-생성되는 것입니다. 이와 같은 액티비티가 디스크 또는 다른 속에 저장된 데이터를 공유하는 경우,
-첫 번째 액티비티는 두 번째 액티비티가 생성되기 전에 완전히 중단되지 않는다는 점을 이해하는 것이 중요합니다.
+
한 액티비티가 다른 액티비티를 시작하면, 둘 모두 수명 주기 전환을 겪습니다. 첫 번째 액티비티는
+일시중지하고 중단되는 반면(배경에서 계속 보이는 경우에는 중단되지 않습니다만), 다른 액티비티는
+생성되는 것입니다. 이와 같은 액티비티가 디스크 또는 다른 속에 저장된 데이터를 공유하는 경우,
+첫 번째 액티비티는 두 번째 액티비티가 생성되기 전에 완전히 중단되지 않는다는 점을 이해하는 것이 중요합니다.
그렇다기보다는, 두 번째 액티비티의 시작 과정이 첫 번째 액티비티 중단 과정과 겹쳐 일어납니다.
-
수명 주기 콜백은 분명히 정의된 순서가 있으며 특히 두 개의 액티비티가
+
수명 주기 콜백은 분명히 정의된 순서가 있으며 특히 두 개의 액티비티가
같은 프로세스 안에 있으면서 하나가 다른 하나를 시작하는 경우 순서가 더욱 확실합니다. 다음은 액티비티 A가
액티비티 B를 시작할 때 발생하는 작업 순서입니다.
이처럼 수명 주기 콜백의 순서를 예측할 수 있기 때문에 한 액티비티에서 다른 액티비티로 전환되는
- 정보를 관리할 수 있습니다. 예를 들어 첫 번째 액티비티가 중단될 때 데이터베이스에
-내용을 작성해서 다음 액티비티가 그 내용을 읽을 수 있도록 하려면, 데이터베이스에는
+ 정보를 관리할 수 있습니다. 예를 들어 첫 번째 액티비티가 중단될 때 데이터베이스에
+내용을 작성해서 다음 액티비티가 그 내용을 읽을 수 있도록 하려면, 데이터베이스에는
{@link android.app.Activity#onPause onPause()} 중에({@link
android.app.Activity#onStop onStop()} 중이 아니라) 쓰기 작업을 해야 합니다.
바인딩된 서비스란 클라이언트 서버 인터페이스 안의 서버를 말합니다. 바인딩된 서비스를 사용하면 구성 요소(활동 등)를
-서비스에 바인딩되게 하거나, 요청을 보내고 응답을 수신하며 심지어는
+
바인딩된 서비스란 클라이언트 서버 인터페이스 안의 서버를 말합니다. 바인딩된 서비스를 사용하면 구성 요소(활동 등)를
+서비스에 바인딩되게 하거나, 요청을 보내고 응답을 수신하며 심지어는
프로세스간 통신(IPC)까지 수행할 수 있게 됩니다. 일반적으로 바인딩된 서비스는 다른 애플리케이션
구성 요소를 도울 때까지만 살고 배경에서 무한히 실행되지 않습니다.
이 문서는 다른 애플리케이션 구성 요소의
-서비스에 바인딩하는 방법을 포함하여 바인딩된 서비스를 만드는 방법을 보여줍니다. 하지만 일반적인 서비스에 관한 정보도 알아두는 것이 좋습니다.
-서비스에서 알림을 전달하는 방법이나 서비스를 전경에서 실행되도록 설정하는 방법 등 여러 가지
+서비스에 바인딩하는 방법을 포함하여 바인딩된 서비스를 만드는 방법을 보여줍니다. 하지만 일반적인 서비스에 관한 정보도 알아두는 것이 좋습니다.
+서비스에서 알림을 전달하는 방법이나 서비스를 전경에서 실행되도록 설정하는 방법 등 여러 가지
추가 정보를 알아보려면 서비스 문서를 참조하십시오.
기본 정보
-
바인딩된 서비스란 일종의 {@link android.app.Service} 클래스 구현으로,
-이를 통해 다른 애플리케이션이 이 서비스에 바인딩하여 상호 작용할 수 있도록 해주는 것입니다. 한 서비스에 대한 바인딩을 제공하려면,
-{@link android.app.Service#onBind onBind()} 콜백 메서드를 구현해야 합니다.
+
바인딩된 서비스란 일종의 {@link android.app.Service} 클래스 구현으로,
+이를 통해 다른 애플리케이션이 이 서비스에 바인딩하여 상호 작용할 수 있도록 해주는 것입니다. 한 서비스에 대한 바인딩을 제공하려면,
+{@link android.app.Service#onBind onBind()} 콜백 메서드를 구현해야 합니다.
이 메서드는 클라이언트가 서비스와 상호 작용하는 데 사용하는 프로그래밍 인터페이스를 정의하는 {@link android.os.IBinder} 개체를
반환합니다.
@@ -65,24 +65,24 @@ parent.link=services.html
시작된 서비스에 바인딩
서비스
-문서에서 논의된 바와 같이, 시작되었으면서도 바인딩된 서비스를 만들 수 있습니다. 다시 말해,
-{@link android.content.Context#startService startService()}를 호출하여 서비스를 시작할 수 있으며
+문서에서 논의된 바와 같이, 시작되었으면서도 바인딩된 서비스를 만들 수 있습니다. 다시 말해,
+{@link android.content.Context#startService startService()}를 호출하여 서비스를 시작할 수 있으며
이를 통해 서비스가 무한히 실행되도록 할 수 있으며, {@link
android.content.Context#bindService bindService()}를 호출하면 클라이언트가 해당 서비스에 바인딩되도록 할 수 있다는 것입니다.
-
서비스를 시작되고 바인딩되도록 허용한 다음 서비스가 시작되면
-시스템은 클라이언트가 모두 바인딩을 해제해도 서비스를 소멸시키지 않습니다. 대신,
+
서비스를 시작되고 바인딩되도록 허용한 다음 서비스가 시작되면
+시스템은 클라이언트가 모두 바인딩을 해제해도 서비스를 소멸시키지 않습니다. 대신,
직접 서비스를 확실히 중단시켜야 합니다. 그러려면 {@link android.app.Service#stopSelf stopSelf()} 또는 {@link
android.content.Context#stopService stopService()}를 호출하면 됩니다.
보통은 {@link android.app.Service#onBind onBind()}
또는 {@link android.app.Service#onStartCommand onStartCommand()}
-중 한 가지만 구현하지만, 둘 모두 구현해야 할 때도 있습니다. 예를 들어, 음악 플레이어의 경우 서비스를 무한히 실행하면서
-바인딩도 제공하도록 허용하는 것이 유용하다는 결론을 내릴 수 있습니다. 이렇게 하면, 한 액티비티가 서비스로 하여금 음악을 재생하도록
-시작한 다음 사용자가 애플리케이션을 떠나더라도 음악을 계속 재생하도록 할 수 있습니다. 그런 다음, 사용자가 애플리케이션으로
+중 한 가지만 구현하지만, 둘 모두 구현해야 할 때도 있습니다. 예를 들어, 음악 플레이어의 경우 서비스를 무한히 실행하면서
+바인딩도 제공하도록 허용하는 것이 유용하다는 결론을 내릴 수 있습니다. 이렇게 하면, 한 액티비티가 서비스로 하여금 음악을 재생하도록
+시작한 다음 사용자가 애플리케이션을 떠나더라도 음악을 계속 재생하도록 할 수 있습니다. 그런 다음, 사용자가 애플리케이션으로
다시 돌아오면 이 액티비티가 서비스를 바인딩하여 재생 제어권을 다시 획득할 수 있습니다.
관련 섹션을 꼭 읽어보십시오. 시작된 서비스에 바인딩을
추가할 때 서비스 수명 주기에 관한 자세한 정보를 얻을 수 있습니다.
@@ -90,23 +90,23 @@ android.content.Context#stopService stopService()}를 호출하면 됩니다.클라이언트가 서비스에 바인딩하려면 {@link android.content.Context#bindService
bindService()}를 호출하면 됩니다. 이 때, 반드시 {@link
android.content.ServiceConnection}의 구현을 제공해야 하며 이것이 서비스와의 연결을 모니터링합니다. {@link
-android.content.Context#bindService bindService()} 메서드는 값 없이 즉시 반환됩니다.
-그러나 Android 시스템이 클라이언트와 서비스 사이의
+android.content.Context#bindService bindService()} 메서드는 값 없이 즉시 반환됩니다.
+그러나 Android 시스템이 클라이언트와 서비스 사이의
연결을 만드는 경우, 시스템은 {@link
android.content.ServiceConnection#onServiceConnected onServiceConnected()}를 {@link
-android.content.ServiceConnection}에서 호출하여 클라이언트가 서비스와 통신하는 데 사용할 수 있도록 {@link android.os.IBinder}를
+android.content.ServiceConnection}에서 호출하여 클라이언트가 서비스와 통신하는 데 사용할 수 있도록 {@link android.os.IBinder}를
전달하게 됩니다.
-
여러 클라이언트가 한 번에 서비스에 연결될 수 있습니다. 그러나, 시스템이 서비스의
-{@link android.app.Service#onBind onBind()} 메서드를 호출하여 {@link android.os.IBinder}를 검색하는 경우는 첫 번째 클라이언트가
-바인딩되는 경우뿐입니다. 시스템은 그 후 같은 {@link android.os.IBinder}를 바인딩되는 추가
+
여러 클라이언트가 한 번에 서비스에 연결될 수 있습니다. 그러나, 시스템이 서비스의
+{@link android.app.Service#onBind onBind()} 메서드를 호출하여 {@link android.os.IBinder}를 검색하는 경우는 첫 번째 클라이언트가
+바인딩되는 경우뿐입니다. 시스템은 그 후 같은 {@link android.os.IBinder}를 바인딩되는 추가
클라이언트 모두에 전달하며 이때는 {@link android.app.Service#onBind onBind()}를 다시 호출하지 않습니다.
마지막 클라이언트가 서비스에서 바인딩을 해제하면 시스템은 서비스를 소멸시킵니다(
{@link android.content.Context#startService startService()}가 서비스를 시작했을 경우 제외).
바인딩된 서비스를 구현할 때 가장 중요한 부분은
-{@link android.app.Service#onBind onBind()} 콜백 메서드가 반환하는 인터페이스를 정의하는 것입니다.
+{@link android.app.Service#onBind onBind()} 콜백 메서드가 반환하는 인터페이스를 정의하는 것입니다.
서비스의 {@link android.os.IBinder} 인터페이스를 정의하는 방법에는 몇 가지가 있고, 다음
섹션에서는 각 기법에 관해 논의합니다.
바인딩을 제공하는 서비스를 생성할 때는 클라이언트가 서비스와 상호 작용하는 데 사용할 수 있는 프로그래밍 인터페이스를 제공하는 {@link android.os.IBinder}
-를 제공해야 합니다.
+를 제공해야 합니다.
인터페이스를 정의하는 방법은 세 가지가 있습니다.
서비스가 본인의 애플리케이션 전용이며 클라이언트와 같은 과정으로 실행되는
경우(이런 경우가 흔함), 인터페이스를 생성할 때 {@link android.os.Binder} 클래스를
- 확장하고 그 인스턴스를
-{@link android.app.Service#onBind onBind()}에서 반환하는 방식을 사용해야 합니다. 클라이언트가 {@link android.os.Binder}를 받으며,
-이를 사용하여 {@link android.os.Binder} 구현 또는 심지어 {@link android.app.Service}에서
+ 확장하고 그 인스턴스를
+{@link android.app.Service#onBind onBind()}에서 반환하는 방식을 사용해야 합니다. 클라이언트가 {@link android.os.Binder}를 받으며,
+이를 사용하여 {@link android.os.Binder} 구현 또는 심지어 {@link android.app.Service}에서
사용할 수 있는 공개 메서드에 직접 액세스할 수 있습니다.
-
이것은 서비스가 본인의 애플리케이션을 위해 단순히 배경에서 작동하는 요소에 그치는 경우
-선호되는 기법입니다. 인터페이스를 생성할 때 이 방식을 사용하지 않는 유일한 이유는
+
이것은 서비스가 본인의 애플리케이션을 위해 단순히 배경에서 작동하는 요소에 그치는 경우
+선호되는 기법입니다. 인터페이스를 생성할 때 이 방식을 사용하지 않는 유일한 이유는
서비스를 다른 애플리케이션에서나 별도의 프로세스에 걸쳐 사용하고 있는 경우뿐입니다.
인터페이스를 여러 프로세스에 걸쳐 적용되도록 해야 하는 경우, 서비스에 대한
-인터페이스를 {@link android.os.Messenger}로 생성할 수 있습니다.
+
인터페이스를 여러 프로세스에 걸쳐 적용되도록 해야 하는 경우, 서비스에 대한
+인터페이스를 {@link android.os.Messenger}로 생성할 수 있습니다.
이 방식을 사용하면 서비스가 여러 가지 유형의 {@link
android.os.Message} 개체에 응답하는 {@link android.os.Handler}를 정의합니다. 이 {@link android.os.Handler}
가 {@link android.os.Messenger}의 기초이며, 이를 통해 클라이언트와 함께 {@link android.os.IBinder}
를 공유할 수 있게 되어 클라이언트가 {@link
-android.os.Message} 개체를 사용해 서비스에 명령을 보낼 수 있게 해줍니다. 이외에도, 클라이언트가 자체적으로 {@link android.os.Messenger}를
+android.os.Message} 개체를 사용해 서비스에 명령을 보낼 수 있게 해줍니다. 이외에도, 클라이언트가 자체적으로 {@link android.os.Messenger}를
정의하여 서비스가 메시지를 돌려보낼 수 있도록 할 수도 있습니다.
이것이 프로세스간 통신(IPC)을 수행하는 가장 간단한 방법입니다. {@link
-android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해서, 서비스를 스레드로부터 안전하게
+android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해서, 서비스를 스레드로부터 안전하게
설계하지 않아도 되기 때문입니다.
AIDL 사용하기
-
AIDL(Android Interface Definition Language)은 개체를 운영 체제가 이해할 수 있는
-원시 데이터로 구성 해제한 다음 여러 프로세스에 걸쳐 집결하여 IPC를 수행하기 위해
-필요한 모든 작업을 수행합니다. 이전 기법은 {@link android.os.Messenger}를 사용했는데,
+
AIDL(Android Interface Definition Language)은 개체를 운영 체제가 이해할 수 있는
+원시 데이터로 구성 해제한 다음 여러 프로세스에 걸쳐 집결하여 IPC를 수행하기 위해
+필요한 모든 작업을 수행합니다. 이전 기법은 {@link android.os.Messenger}를 사용했는데,
사실 그 기본 구조가 AIDL을 기반으로 하고 있는 것입니다. 위에서 언급한 바와 같이 {@link android.os.Messenger}는 단일 스레드에 모든 클라이언트 요청
-대기열을 생성하므로 서비스는 한 번에 요청을 하나씩 수신합니다. 그러나,
-서비스가 동시에 여러 요청을 처리하도록 하고 싶은 경우에는 AIDL을 직접 사용해도
+대기열을 생성하므로 서비스는 한 번에 요청을 하나씩 수신합니다. 그러나,
+서비스가 동시에 여러 요청을 처리하도록 하고 싶은 경우에는 AIDL을 직접 사용해도
됩니다. 이 경우, 서비스가 다중 스레딩을 할 수 있어야 하며 스레드로부터 안전하게 구축되었어야 합니다.
AIDL을 직접 사용하려면
프로그래밍 인터페이스를 정의하는 {@code .aidl} 파일을 생성해야 합니다. Android SDK 도구는
@@ -159,10 +159,10 @@ android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해
-
참고: 대부분의 애플리케이션의 경우,
-바인딩된 서비스를 생성하기 위해 AIDL를 사용해서는 안 됩니다.
-그러려면 다중 스레딩 기능이 필요할 수 있고, 따라서 더 복잡한 구현을 초래할 수 있기 때문입니다. 따라서 AIDL은
-대부분의 애플리케이션에 적합하지 않으므로 이 문서에서는 여러분의 서비스에 이를 이용하는 방법에 대해 다루지 않습니다. AIDL을 직접 사용해야 한다는 확신이 드는 경우,
+
참고: 대부분의 애플리케이션의 경우,
+바인딩된 서비스를 생성하기 위해 AIDL를 사용해서는 안 됩니다.
+그러려면 다중 스레딩 기능이 필요할 수 있고, 따라서 더 복잡한 구현을 초래할 수 있기 때문입니다. 따라서 AIDL은
+대부분의 애플리케이션에 적합하지 않으므로 이 문서에서는 여러분의 서비스에 이를 이용하는 방법에 대해 다루지 않습니다. AIDL을 직접 사용해야 한다는 확신이 드는 경우,
AIDL 문서를 참조하십시오.
@@ -172,12 +172,12 @@ android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해
바인더 클래스 확장
서비스를 사용하는 것이 로컬 애플리케이션뿐이고 여러 프로세스에 걸쳐 작동할 필요가 없는 경우,
-나름의 {@link android.os.Binder} 클래스를 구현하여
+나름의 {@link android.os.Binder} 클래스를 구현하여
클라이언트로 하여금 서비스 내의 공개 메서드에 직접 액세스할 수 있도록 할 수도 있습니다.
-
참고: 이것은 클라이언트와 서비스가
-같은 애플리케이션 및 프로세스에 있는 경우에만 통하며, 이 경우가 가장 보편적입니다. 이 방식이 잘 통하는 경우를 예로 들면,
-음악 애플리케이션에서 자체 서비스에 액티비티를 바인딩하여 배경에서 음악을 재생하도록 해야 하는
+
참고: 이것은 클라이언트와 서비스가
+같은 애플리케이션 및 프로세스에 있는 경우에만 통하며, 이 경우가 가장 보편적입니다. 이 방식이 잘 통하는 경우를 예로 들면,
+음악 애플리케이션에서 자체 서비스에 액티비티를 바인딩하여 배경에서 음악을 재생하도록 해야 하는
경우가 있습니다.
이렇게 설정하는 방법은 다음과 같습니다.
@@ -185,7 +185,7 @@ android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해
서비스에서 다음 중 한 가지에 해당하는 {@link android.os.Binder}의 인스턴스를 생성합니다.
클라이언트가 호출할 수 있는 공개 메서드 포함
-
클라이언트가 호출할 수 있는 공개 메서드가 있는 현재{@link android.app.Service}
+
클라이언트가 호출할 수 있는 공개 메서드가 있는 현재{@link android.app.Service}
인스턴스를 반환
클라이언트가 호출할 수 있는 공개 메서드가 포함된 서비스가 호스팅하는 다른 클래스의 인스턴스를 반환
@@ -193,16 +193,16 @@ android.os.Messenger}가 모든 요청을 단일 스레드에 대기하게 해
{@link
android.app.Service#onBind onBind()} 콜백 메서드에서 이 {@link android.os.Binder}의 인스턴스를 반환합니다.
클라이언트의 경우, {@link android.os.Binder}를 {@link
-android.content.ServiceConnection#onServiceConnected onServiceConnected()}
+android.content.ServiceConnection#onServiceConnected onServiceConnected()}
콜백 메서드에서 받아 제공된 메서드를 사용해 서비스를 바인딩하기 위해 호출합니다.
-
참고: 서비스와 클라이언트가 같은 애플리케이션에
-있어야 하는 것은 그래야만 클라이언트가 반환된 개체를 캐스팅하여 해당 API를 적절하게 호출할 수 있기 때문입니다. 또한
-서비스와 클라이언트는 같은 프로세스에 있어야 하기도 합니다. 이 기법에서는
+
참고: 서비스와 클라이언트가 같은 애플리케이션에
+있어야 하는 것은 그래야만 클라이언트가 반환된 개체를 캐스팅하여 해당 API를 적절하게 호출할 수 있기 때문입니다. 또한
+서비스와 클라이언트는 같은 프로세스에 있어야 하기도 합니다. 이 기법에서는
여러 프로세스에 걸친 집결 작업을 전혀 수행하지 않기 때문입니다.
-
예컨대, 어떤 서비스가 클라이언트에게 {@link android.os.Binder} 구현을 통해 서비스 내의
+
예컨대, 어떤 서비스가 클라이언트에게 {@link android.os.Binder} 구현을 통해 서비스 내의
메서드에 액세스할 수 있도록 한다고 합시다.
@@ -303,12 +303,12 @@ public class BindingActivity extends Activity {
}
-
위 예시는 클라이언트가
+
위 예시는 클라이언트가
{@link android.content.ServiceConnection} 구현과 {@link
-android.content.ServiceConnection#onServiceConnected onServiceConnected()} 콜백을 사용하여 서비스에 바인딩하는 방법을 보여줍니다. 다음
+android.content.ServiceConnection#onServiceConnected onServiceConnected()} 콜백을 사용하여 서비스에 바인딩하는 방법을 보여줍니다. 다음
섹션에서는 서비스에 바인딩하는 이러한 과정에 대해 좀 더 자세한 정보를 제공합니다.
-
참고: 위 예시에서는 서비스에서 분명히 바인딩을 해제하지는 않습니다.
+
참고: 위 예시에서는 서비스에서 분명히 바인딩을 해제하지는 않습니다.
그러나 모든 클라이언트는 적절한 시점에 바인딩을 해제해야 합니다(액티비티가 일시 중지될 때 등).
IPC를 수행해야 할 경우, 인터페이스에 대해 {@link android.os.Messenger}를 사용하는 것이
AIDL로 구현하는 것보다 간단합니다. 왜냐하면 {@link android.os.Messenger}는
-모든 호출을 서비스에 대기시키지만 순수한 AIDL 인터페이스는
+모든 호출을 서비스에 대기시키지만 순수한 AIDL 인터페이스는
서비스에 동시에 요청을 전송하여 다중 스레딩을 처리해야 하기 때문입니다.
대부분의 애플리이션에서는 서비스가 다중 스레딩을 수행할 필요가 없으므로 {@link
-android.os.Messenger}를 사용하면 호출을 한 번에 하나씩 처리할 수 있습니다. 서비스가
+android.os.Messenger}를 사용하면 호출을 한 번에 하나씩 처리할 수 있습니다. 서비스가
다중 스레딩되는 것이 중요한 경우, 인터페이스를 정의하는 데 AIDL을 사용해야 합니다.
-
서비스가 원격 프로세스와 통신해야 한다면 서비스에 인터페이스를 제공하는 데
-{@link android.os.Messenger}를 사용하면 됩니다. 이 기법을 사용하면
+
서비스가 원격 프로세스와 통신해야 한다면 서비스에 인터페이스를 제공하는 데
+{@link android.os.Messenger}를 사용하면 됩니다. 이 기법을 사용하면
AIDL을 쓰지 않고도 프로세스간 통신(IPC)을 수행할 수 있게 해줍니다.
다음은 {@link android.os.Messenger} 사용 방법을 간략하게 요약한 것입니다.
-
서비스가 클라이언트로부터 각 호출에 대해 콜백을 받는 {@link android.os.Handler}를
+
서비스가 클라이언트로부터 각 호출에 대해 콜백을 받는 {@link android.os.Handler}를
구현합니다.
{@link android.os.Handler}를 사용하여 {@link android.os.Messenger} 개체를 생성합니다
(이것은 {@link android.os.Handler}에 대한 참조입니다).
-
{@link android.os.Messenger}가 {@link android.os.IBinder}를 생성하여 서비스가
+
클라이언트는 {@link android.os.IBinder}를 사용하여 {@link android.os.Messenger}
(서비스의 {@link android.os.Handler}를 참조)를 인스턴트화하고, 이를 이용하여
@@ -356,8 +356,8 @@ handleMessage()} 메서드를 사용합니다.
-
이렇게 하면, 클라이언트가 서비스에서 호출할 "메서드"가 없습니다. 대신 클라이언트는
-"메시지"({@link android.os.Message} 개체)를 전달하여 서비스가
+
이렇게 하면, 클라이언트가 서비스에서 호출할 "메서드"가 없습니다. 대신 클라이언트는
+"메시지"({@link android.os.Message} 개체)를 전달하여 서비스가
{@link android.os.Handler}로 받을 수 있도록 합니다.
다음은 {@link android.os.Messenger} 인터페이스를 사용하는 간단한 예시 서비스입니다.
@@ -406,7 +406,7 @@ public class MessengerService extends Service {
클라이언트는 서비스가 반환한 {@link
android.os.IBinder}에 기초하여 {@link android.os.Messenger}를 생성하고 {@link
-android.os.Messenger#send send()}로 메시지를 전송하기만 하면 됩니다. 예를 들어, 다음은
+android.os.Messenger#send send()}로 메시지를 전송하기만 하면 됩니다. 예를 들어, 다음은
서비스에 바인딩하여 {@code MSG_SAY_HELLO} 메시지를 서비스에 전달하는 간단한 액티비티입니다.
@@ -477,7 +477,7 @@ public class ActivityMessenger extends Activity {
이 예시에는 서비스가 클라이언트에 응답하는 방식이 나타나 있지 않다는 것을 유념하십시오. 서비스가 응답하게 하려면
- 클라이언트에도 {@link android.os.Messenger}를 생성해야 합니다.
+ 클라이언트에도 {@link android.os.Messenger}를 생성해야 합니다.
클라이언트가 {@link android.content.ServiceConnection#onServiceConnected
onServiceConnected()} 콜백을 받으면 {@link android.os.Messenger#send send()}메서드의 {@link android.os.Message#replyTo} 매개변수에서 클라이언트의 {@link android.os.Messenger}를 포함하는 {@link android.os.Message}를
서비스에 전송합니다.
@@ -493,7 +493,7 @@ MessengerServiceActivities.java}(클라이언트) 예시를 참조하십시
서비스에 바인딩
-
애플리케이션 구성 요소(클라이언트)를 서비스에 바인딩하려면
+
애플리케이션 구성 요소(클라이언트)를 서비스에 바인딩하려면
{@link android.content.Context#bindService bindService()}를 호출하면 됩니다. 그러면 Android
system이 서비스의 {@link android.app.Service#onBind
onBind()} 메서드를 호출하고, 이는 서비스와의 상호 작용을 위해 {@link android.os.IBinder}를 반환합니다.
@@ -505,7 +505,7 @@ android.content.ServiceConnection}의 인스턴스를 생성하여 이를 {@link
bindService()}에 전달해야 합니다. {@link android.content.ServiceConnection}에는
{@link android.os.IBinder}를 전달하기 위해 시스템이 호출하는 콜백 메서드가 포함됩니다.
-
참고: 서비스에 바인딩할 수 있는 것은 액티비티, 서비스 및
+
참고: 서비스에 바인딩할 수 있는 것은 액티비티, 서비스 및
콘텐츠 제공자뿐입니다. 브로드캐스트 수신자로부터는 서비스에 바인딩할 수 없습니다.
시스템이 {@link android.content.ServiceConnection#onServiceConnected
-onServiceConnected()} 콜백 메서드를 호출하면, 인터페이스가 정의한 메서드를 사용하여
+onServiceConnected()} 콜백 메서드를 호출하면, 인터페이스가 정의한 메서드를 사용하여
서비스에 호출을 시작해도 됩니다.
서비스로부터 연결을 해제하려면 {@link
android.content.Context#unbindService unbindService()}를 호출합니다.
-
클라이언트가 소멸되면 이는 서비스에서 바인딩을 해제하게 되지만,
-서비스와 상호 작용을 마쳤을 때 또는 액티비티가 일시 중지되었을 때에는 항상 바인딩을 해제해야 합니다.
-이렇게 해야 서비스가 사용 중이 아닐 때에는 중지할 수 있습니다
+
클라이언트가 소멸되면 이는 서비스에서 바인딩을 해제하게 되지만,
+서비스와 상호 작용을 마쳤을 때 또는 액티비티가 일시 중지되었을 때에는 항상 바인딩을 해제해야 합니다.
+이렇게 해야 서비스가 사용 중이 아닐 때에는 중지할 수 있습니다
(바인딩과 바인딩 해제의 적절한 시기는 아래에서 좀 더 논의합니다).
-
예를 들어, 다음 코드 조각은 위와 같이
-바인더 클래스를 확장해서 생성한 서비스와 클라이언트를 연결합니다. 그러므로 이것이 해야 하는 일은 반환된
+
예를 들어, 다음 코드 조각은 위와 같이
+바인더 클래스를 확장해서 생성한 서비스와 클라이언트를 연결합니다. 그러므로 이것이 해야 하는 일은 반환된
{@link android.os.IBinder}를 {@code LocalService} 클래스에 캐스팅하고 {@code
LocalService} 인스턴스를 요청하는 것뿐입니다.
{@link android.content.Context#bindService bindService()}의 첫 번째 매개변수는 바인딩할 서비스를 명시적으로 명명하는
-{@link android.content.Intent}입니다(인텐트는
+
{@link android.content.Context#bindService bindService()}의 첫 번째 매개변수는 바인딩할 서비스를 명시적으로 명명하는
+{@link android.content.Intent}입니다(인텐트는
암시적일 수 있음).
두 번째 매개변수는 {@link android.content.ServiceConnection} 개체입니다.
세 번째 매개변수는 바인딩 옵션을 나타내는 플래그입니다. 서비스를 생성하기 위해 보통은 {@link
-android.content.Context#BIND_AUTO_CREATE}를 사용합니다(이미 살아 있는 상태가 아닌 경우).
+android.content.Context#BIND_AUTO_CREATE}를 사용합니다(이미 살아 있는 상태가 아닌 경우).
가능한 기타 값은 {@link android.content.Context#BIND_DEBUG_UNBIND}
및 {@link android.content.Context#BIND_NOT_FOREGROUND}, 또는 값이 없는 경우 {@code 0}입니다.
@@ -588,27 +588,27 @@ android.content.Context#BIND_AUTO_CREATE}를 사용합니다(이미 살아 있
다음은 서비스에 바인딩하는 데 관한 몇 가지 중요한 참고 사항입니다.
-
항상 {@link android.os.DeadObjectException} 예외를 트래핑해야 합니다.
+
항상 {@link android.os.DeadObjectException} 예외를 트래핑해야 합니다.
이것은 연결이 끊어지면 발생합니다. 원격 메서드에 의해 발생하는 예외는 이것뿐입니다.
액티비티가 눈에 보이는 동안에만 서비스와 상호 작용해야 한다면
{@link android.app.Activity#onStart onStart()}에는 바인딩하고 {@link
android.app.Activity#onStop onStop()}에는 바인딩을 해제해야 합니다.
배경에서 중단되었을 때도 액티비티가 응답을 받게 하고 싶다면 {@link android.app.Activity#onCreate onCreate()}에는 바인딩하고
-{@link android.app.Activity#onDestroy onDestroy()} 중에는 바인딩을 해제합니다.
-이때, 사용자의 액티비티가 서비스가 실행되는 시간 전체에서(배경에서라도) 서비스를 사용한다는 것을 유념해야 합니다.
+{@link android.app.Activity#onDestroy onDestroy()} 중에는 바인딩을 해제합니다.
+이때, 사용자의 액티비티가 서비스가 실행되는 시간 전체에서(배경에서라도) 서비스를 사용한다는 것을 유념해야 합니다.
서비스가 다른 프로세스에 있을 경우, 사용자가 프로세스의 가중치를 높이면 시스템이
이를 중단할 가능성이 높아집니다.
참고: 일반적으로는, 액티비티의 {@link android.app.Activity#onResume onResume()}와 {@link
android.app.Activity#onPause onPause()}에는 바인딩하거나 바인딩을 해제하지 말아야 합니다. 이러한 콜백은 모든 수명 주기 전환에서 발생하고
이런 전환에서 발생하는 처리는
-최소한으로 유지해야 하기 때문입니다. 또한,
-사용자 애플리케이션의 여러 액티비티가 동일한 서비스에 바인딩되었고
+최소한으로 유지해야 하기 때문입니다. 또한,
+사용자 애플리케이션의 여러 액티비티가 동일한 서비스에 바인딩되었고
두 액티비티 사이에 전환이 있을 경우, 현재 액티비티의 바인딩이 해제된 후(일시중지 중) 다음 액티비티가 바인딩하기 전(재개 중)에
서비스가 제거되었다가 다시 생성될 수 있습니다 (수명 주기를 조절하기 위한 이러한 액티비티 전환은
액티비티
@@ -624,8 +624,8 @@ RemoteService.java} 클래스를 참조하십시오.
바인딩된 서비스 수명 주기 관리
-
서비스가 모든 클라이언트로부터 바인딩 해제되면, Android 시스템이 이를 소멸시킵니다(다만
-{@link android.app.Service#onStartCommand onStartCommand()}와도 함께 시작된 경우는 예외).
+
서비스가 모든 클라이언트로부터 바인딩 해제되면, Android 시스템이 이를 소멸시킵니다(다만
+{@link android.app.Service#onStartCommand onStartCommand()}와도 함께 시작된 경우는 예외).
따라서, 서비스가 순전히 바인딩된 서비스일 경우에는 해당 서비스의 수명 주기를 관리하지 않아도 됩니다.
클라이언트에 바인딩되었는지를 근거로 Android 시스템이 대신 관리해주기 때문입니다.
{@link android.app.Fragment}는 동작 또는
-{@link android.app.Activity} 내에서 사용자 인터페이스의 일부를 나타냅니다. 여러 개의 프래그먼트를 하나의 액티비티에
-조합하여 창이 여러 개인 UI를 구축할 수 있으며, 하나의 프래그먼트를 여러 액티비티에서 재사용할 수 있습니다. 프래그먼트는 자체 수명 주기를 가지고, 자체 입력 이벤트를 받으며,
-액티비티 실행 중에 추가 및 제거가 가능한 액티비티의 모듈식 섹션이라고
-생각하면 됩니다(다른 액티비티에
+
{@link android.app.Fragment}는 동작 또는
+{@link android.app.Activity} 내에서 사용자 인터페이스의 일부를 나타냅니다. 여러 개의 프래그먼트를 하나의 액티비티에
+조합하여 창이 여러 개인 UI를 구축할 수 있으며, 하나의 프래그먼트를 여러 액티비티에서 재사용할 수 있습니다. 프래그먼트는 자체 수명 주기를 가지고, 자체 입력 이벤트를 받으며,
+액티비티 실행 중에 추가 및 제거가 가능한 액티비티의 모듈식 섹션이라고
+생각하면 됩니다(다른 액티비티에
재사용할 수 있는 "하위 액티비티"와 같은 개념).
-
프래그먼트는 항상 액티비티 내에 포함되어 있어야 하며 해당 프래그먼트의 수명 주기는
-호스트 액티비티의 수명 주기에 직접적으로 영향을 받습니다. 예를 들어 액티비티가 일시정지되는 경우, 그 안의 모든 프래그먼트도
-일시정지되며 액티비티가 소멸되면 모든 프래그먼트도 마찬가지로 소멸됩니다. 그러나 액티비티가 실행 중인
-동안에는(재개됨수명 주기 상태에 있을 때를 말합니다)
-각 프래그먼트를 추가 또는 제거하는 등 개별적으로 조작할 수 있습니다. 그와 같은 프래그먼트 트랜잭션을
-수행할 때에는 이를 액티비티가 관리하는 백 스택에도
-추가할 수 있습니다. 각 백 스택 항목이 발생한 프래그먼트 트랜잭션의
+
프래그먼트는 항상 액티비티 내에 포함되어 있어야 하며 해당 프래그먼트의 수명 주기는
+호스트 액티비티의 수명 주기에 직접적으로 영향을 받습니다. 예를 들어 액티비티가 일시정지되는 경우, 그 안의 모든 프래그먼트도
+일시정지되며 액티비티가 소멸되면 모든 프래그먼트도 마찬가지로 소멸됩니다. 그러나 액티비티가 실행 중인
+동안에는(재개됨수명 주기 상태에 있을 때를 말합니다)
+각 프래그먼트를 추가 또는 제거하는 등 개별적으로 조작할 수 있습니다. 그와 같은 프래그먼트 트랜잭션을
+수행할 때에는 이를 액티비티가 관리하는 백 스택에도
+추가할 수 있습니다. 각 백 스택 항목이 발생한 프래그먼트 트랜잭션의
기록이 됩니다. 이 백 스택을 사용하면 사용자가 프래그먼트 트랜잭션을 거꾸로 돌릴 수 있습니다(뒤로 이동).
이때 뒤로 버튼을 누르면 됩니다.
프래그먼트를 액티비티 레이아웃의 일부로 추가하는 경우, 이는 액티비티의 보기 계층 내부의 {@link
-android.view.ViewGroup} 안에 살며, 해당 프래그먼트가 자신의 보기
+android.view.ViewGroup} 안에 살며, 해당 프래그먼트가 자신의 보기
레이아웃을 정의합니다.
-프래그먼트를 액티비티 레이아웃에 삽입하려면 해당 프래그먼트를
-액티비티의 레이아웃 파일에서 {@code <fragment>} 요소로 선언하거나, 애플리케이션 코드에서 이를
-기존의 {@link android.view.ViewGroup}에 추가하면 됩니다. 그러나 프래그먼트가
-액티비티 레이아웃의 일부분이어야만 하는 것은 아닙니다. 나름의 UI가 없는 프래그먼트도 액티비티를 위한
+프래그먼트를 액티비티 레이아웃에 삽입하려면 해당 프래그먼트를
+액티비티의 레이아웃 파일에서 {@code <fragment>} 요소로 선언하거나, 애플리케이션 코드에서 이를
+기존의 {@link android.view.ViewGroup}에 추가하면 됩니다. 그러나 프래그먼트가
+액티비티 레이아웃의 일부분이어야만 하는 것은 아닙니다. 나름의 UI가 없는 프래그먼트도 액티비티를 위한
보이지 않는 작업자로 사용할 수 있습니다.
-
이 문서에서는 프래그먼트를 사용하도록 애플리케이션을 구축하는 법을
-설명합니다. 그중에는 프래그먼트를 액티비티의 백 스택에 추가했을 때 프래그먼트가 자신의 상태를 유지하는 방법,
-액티비티 및 액티비티 내의 다른 프래그먼트와 이벤트를 공유하는 방법과 액티비티의
+
이 문서에서는 프래그먼트를 사용하도록 애플리케이션을 구축하는 법을
+설명합니다. 그중에는 프래그먼트를 액티비티의 백 스택에 추가했을 때 프래그먼트가 자신의 상태를 유지하는 방법,
+액티비티 및 액티비티 내의 다른 프래그먼트와 이벤트를 공유하는 방법과 액티비티의
작업 모음에 참가하는 법 등등 여러 가지가 포함됩니다.
디자인 철학
-
Android가 프래그먼트를 처음 도입한 것은 Android 3.0(API 레벨 11)부터입니다. 기본적으로
-태블릿과 같은 큰 화면에서 보다 역동적이고 유연한 UI 디자인을 지원하는 것이 목적이었습니다. 태블릿의 화면은
-핸드셋 화면보다 훨씬 크기 때문에 UI 구성 요소를 조합하고 상호 교환할 공간이
-더 많습니다. 프래그먼트는 개발자가 보기 계층에 복잡한 변경 내용을 관리하지 않아도
-그러한 디자인을 사용할 수 있도록 해주는 것입니다. 한 액티비티의 레이아웃을 여러 프래그먼트로 나누면
-런타임에 액티비티의 외관을 수정할 수도 있고 그러한 변경 내용을 해당 액티비티가 관리하는
+
Android가 프래그먼트를 처음 도입한 것은 Android 3.0(API 레벨 11)부터입니다. 기본적으로
+태블릿과 같은 큰 화면에서 보다 역동적이고 유연한 UI 디자인을 지원하는 것이 목적이었습니다. 태블릿의 화면은
+핸드셋 화면보다 훨씬 크기 때문에 UI 구성 요소를 조합하고 상호 교환할 공간이
+더 많습니다. 프래그먼트는 개발자가 보기 계층에 복잡한 변경 내용을 관리하지 않아도
+그러한 디자인을 사용할 수 있도록 해주는 것입니다. 한 액티비티의 레이아웃을 여러 프래그먼트로 나누면
+런타임에 액티비티의 외관을 수정할 수도 있고 그러한 변경 내용을 해당 액티비티가 관리하는
백 스택에 보존할 수도 있습니다.
-
예를 들어 뉴스 애플리케이션이라면 하나의 프래그먼트를 사용하여
-왼쪽에 기사 목록을 표시하도록 하고 또 다른 프래그먼트로 오른쪽에 기사 내용을 표시하도록 할 수 있습니다. 두 프래그먼트 모두
-한 액티비티에서 양쪽으로 나란히 나타나며, 각 프래그먼트에 나름의 수명 주기 콜백 메서드가 있고
-각자 사용자 입력 이벤트를 따로 처리하게 됩니다. 따라서, 사용자는 기사를 선택하는 데 한 액티비티를 쓰고
-기사를 읽는 데 또 다른 액티비티를 선택하는 대신에 같은 액티비티 안에서 기사를 선택하고 읽는 과정을
+
예를 들어 뉴스 애플리케이션이라면 하나의 프래그먼트를 사용하여
+왼쪽에 기사 목록을 표시하도록 하고 또 다른 프래그먼트로 오른쪽에 기사 내용을 표시하도록 할 수 있습니다. 두 프래그먼트 모두
+한 액티비티에서 양쪽으로 나란히 나타나며, 각 프래그먼트에 나름의 수명 주기 콜백 메서드가 있고
+각자 사용자 입력 이벤트를 따로 처리하게 됩니다. 따라서, 사용자는 기사를 선택하는 데 한 액티비티를 쓰고
+기사를 읽는 데 또 다른 액티비티를 선택하는 대신에 같은 액티비티 안에서 기사를 선택하고 읽는 과정을
모두 끝낼 수 있는 것입니다. 이것은 그림 1에 나타낸 태블릿 레이아웃과 같습니다.
-
프래그먼트를 디자인할 때에는 각 프래그먼트를 모듈식이며 재사용 가능한 액티비티 구성 요소로 만들어야 합니다.
-다시 말해, 각 프래그먼트가 나름의 레이아웃을 따로 정의하고 자기만의 수명 주기 콜백으로 자기 나름의 동작을 정의하기 때문에
-한 프래그먼트를 여러 액티비티에 포함시킬 수 있습니다. 그러므로 재사용을 염두에 두고 디자인하며
-한 프래그먼트를 또 다른 프래그먼트로부터 직접 조작하는 것은 삼가야 합니다. 이것은 특히 모듈식 프래그먼트를 사용하면
-프래그먼트 조합을 여러 가지 화면 크기에 맞춰 변경할 수 있도록 해주기 때문에 중요한 요점입니다. 태블릿과 핸드셋을 모두 지원하는
-애플리케이션을 디자인하는 경우, 사용 가능한 화면 공간을 토대로 사용자 경험을 최적화하도록 프래그먼트를
-여러 레이아웃 구성에 재사용할 수 있습니다. 예를 들어 핸드셋에서의 경우
-프래그먼트를 분리해서 단일 창 UI를 제공하도록 해야할 수 있습니다. 같은 액티비티 안에 하나 이상이 들어가지 않을 수
+
프래그먼트를 디자인할 때에는 각 프래그먼트를 모듈식이며 재사용 가능한 액티비티 구성 요소로 만들어야 합니다.
+다시 말해, 각 프래그먼트가 나름의 레이아웃을 따로 정의하고 자기만의 수명 주기 콜백으로 자기 나름의 동작을 정의하기 때문에
+한 프래그먼트를 여러 액티비티에 포함시킬 수 있습니다. 그러므로 재사용을 염두에 두고 디자인하며
+한 프래그먼트를 또 다른 프래그먼트로부터 직접 조작하는 것은 삼가야 합니다. 이것은 특히 모듈식 프래그먼트를 사용하면
+프래그먼트 조합을 여러 가지 화면 크기에 맞춰 변경할 수 있도록 해주기 때문에 중요한 요점입니다. 태블릿과 핸드셋을 모두 지원하는
+애플리케이션을 디자인하는 경우, 사용 가능한 화면 공간을 토대로 사용자 경험을 최적화하도록 프래그먼트를
+여러 레이아웃 구성에 재사용할 수 있습니다. 예를 들어 핸드셋에서의 경우
+프래그먼트를 분리해서 단일 창 UI를 제공하도록 해야할 수 있습니다. 같은 액티비티 안에 하나 이상이 들어가지 않을 수
있기 때문입니다.
-
그림 1. 프래그먼트가 정의한 두 가지 UI 모듈이
-태블릿 디자인에서는 하나의 액티비티로 조합될 수 있는 반면 핸드셋 디자인에서는 분리될 수 있다는 것을
+
그림 1. 프래그먼트가 정의한 두 가지 UI 모듈이
+태블릿 디자인에서는 하나의 액티비티로 조합될 수 있는 반면 핸드셋 디자인에서는 분리될 수 있다는 것을
예시로 나타낸 것입니다.
-
예를 들어—뉴스 애플리케이션 예시를 계속 사용하겠습니다—이 애플리케이션을 태블릿 크기의 기기에서 실행하는 경우,
-애플리케이션 내의 액티비티 A 안에 두 개의 프래그먼트를 포함시킬 수 있습니다. 그러나
-핸드셋 크기의 화면에서라면 두 프래그먼트를 모두 쓸 만큼 공간이 충분치 않습니다.
-따라서 액티비티 A에는 기사 목록에 해당되는 프래그먼트만 포함하고, 사용자가 기사를 하나 선택하면 이것이
-액티비티 B를 시작합니다. 여기에 기사를 읽을 두 번째 프래그먼트가 포함되어 있습니다. 따라서 이 애플리케이션은
-서로 다른 조합으로 프래그먼트를 재사용함으로써 태블릿과 핸드셋을 둘 다 지원하는
+
예를 들어—뉴스 애플리케이션 예시를 계속 사용하겠습니다—이 애플리케이션을 태블릿 크기의 기기에서 실행하는 경우,
+애플리케이션 내의 액티비티 A 안에 두 개의 프래그먼트를 포함시킬 수 있습니다. 그러나
+핸드셋 크기의 화면에서라면 두 프래그먼트를 모두 쓸 만큼 공간이 충분치 않습니다.
+따라서 액티비티 A에는 기사 목록에 해당되는 프래그먼트만 포함하고, 사용자가 기사를 하나 선택하면 이것이
+액티비티 B를 시작합니다. 여기에 기사를 읽을 두 번째 프래그먼트가 포함되어 있습니다. 따라서 이 애플리케이션은
+서로 다른 조합으로 프래그먼트를 재사용함으로써 태블릿과 핸드셋을 둘 다 지원하는
것입니다(그림 1 참조).
-
여러 가지 화면 구성에 맞게 여러 가지 프래그먼트 조합으로 애플리케이션을 디자인하는 법에 대한 자세한 정보는
+
여러 가지 화면 구성에 맞게 여러 가지 프래그먼트 조합으로 애플리케이션을 디자인하는 법에 대한 자세한 정보는
태블릿 및 핸드셋 지원에 대한 가이드를 참조하십시오.
@@ -132,36 +132,36 @@ android.view.ViewGroup} 안에 살며, 해당 프래그먼트가 자신의 보
프래그먼트를 생성하려면 {@link android.app.Fragment}의 하위 클래스(또는 이의 기존
-하위 클래스)를 생성해야 합니다. {@link android.app.Fragment} 클래스에는
-{@link android.app.Activity}와 아주 유사해 보이는 코드가 있습니다. 여기에는 액티비티와 비슷한 콜백 메서드가 들어 있습니다.
+하위 클래스)를 생성해야 합니다. {@link android.app.Fragment} 클래스에는
+{@link android.app.Activity}와 아주 유사해 보이는 코드가 있습니다. 여기에는 액티비티와 비슷한 콜백 메서드가 들어 있습니다.
예를 들어 {@link android.app.Fragment#onCreate onCreate()}, {@link android.app.Fragment#onStart onStart()},
-{@link android.app.Fragment#onPause onPause()} 및 {@link android.app.Fragment#onStop onStop()} 등입니다. 사실,
-기존 Android 애플리케이션을 변환하여 프래그먼트를 사용하도록 하려면 그저
-액티비티의 콜백 메서드에서 프래그먼트에 해당되는 콜백 메서드로 코드를 옮기기만 하면
+{@link android.app.Fragment#onPause onPause()} 및 {@link android.app.Fragment#onStop onStop()} 등입니다. 사실,
+기존 Android 애플리케이션을 변환하여 프래그먼트를 사용하도록 하려면 그저
+액티비티의 콜백 메서드에서 프래그먼트에 해당되는 콜백 메서드로 코드를 옮기기만 하면
될 수도 있습니다.
보통은 최소한 다음과 같은 수명 주기 메서드를 구현해야 합니다.
{@link android.app.Fragment#onCreate onCreate()}
-
시스템은 프래그먼트를 생성할 때 이것을 호출합니다. 구현 내에서 프래그먼트의 기본 구성 요소 중
-프래그먼트가 일시정지되거나 중단되었다가 재개되었을 때 유지하고자 하는 것을
+
시스템은 프래그먼트를 생성할 때 이것을 호출합니다. 구현 내에서 프래그먼트의 기본 구성 요소 중
+프래그먼트가 일시정지되거나 중단되었다가 재개되었을 때 유지하고자 하는 것을
초기화해야 합니다.
시스템은 프래그먼트가 자신의 사용자 인터페이스를 처음으로 그릴 시간이 되면
-이것을 호출합니다. 프래그먼트에 맞는 UI를 그리려면 메서드에서 {@link android.view.View}를 반환해야 합니다.
-이 메서드는 프래그먼트 레이아웃의 루트입니다. 프래그먼트가 UI를 제공하지 않는 경우 null을 반환하면
+
시스템은 프래그먼트가 자신의 사용자 인터페이스를 처음으로 그릴 시간이 되면
+이것을 호출합니다. 프래그먼트에 맞는 UI를 그리려면 메서드에서 {@link android.view.View}를 반환해야 합니다.
+이 메서드는 프래그먼트 레이아웃의 루트입니다. 프래그먼트가 UI를 제공하지 않는 경우 null을 반환하면
됩니다.
{@link android.app.Activity#onPause onPause()}
-
시스템이 이 메서드를 호출하는 것은 사용자가 프래그먼트를 떠난다는
-첫 번째 신호입니다(다만 이것이 항상 프래그먼트가 소멸 중이라는 뜻은 아닙니다). 현재 사용자 세션을 넘어서
-지속되어야 하는 변경 사항을 커밋하려면 보통 이곳에서 해아 합니다(사용자가
+
시스템이 이 메서드를 호출하는 것은 사용자가 프래그먼트를 떠난다는
+첫 번째 신호입니다(다만 이것이 항상 프래그먼트가 소멸 중이라는 뜻은 아닙니다). 현재 사용자 세션을 넘어서
+지속되어야 하는 변경 사항을 커밋하려면 보통 이곳에서 해아 합니다(사용자가
돌아오지 않을 수 있기 때문입니다).
-
대부분의 애플리케이션은 각각의 프래그먼트에 이와 같은 메서드를 최소한 세 개씩
-구현해야 하지만, 프래그먼트 수명 주기의 여러 단계를 처리하려면 사용해야 하는 다른 콜백 메서드도
-많이 있습니다. 모든 수명 주기 콜백 메서드는 나중에
+
대부분의 애플리케이션은 각각의 프래그먼트에 이와 같은 메서드를 최소한 세 개씩
+구현해야 하지만, 프래그먼트 수명 주기의 여러 단계를 처리하려면 사용해야 하는 다른 콜백 메서드도
+많이 있습니다. 모든 수명 주기 콜백 메서드는 나중에
프래그먼트 수명 주기 처리 섹션에서 더욱 상세히 논의할 것입니다.
@@ -170,45 +170,45 @@ android.app.Fragment} 클래스 대신 확장하고자 하는 하위 클래스
{@link android.app.DialogFragment}
-
부동 대화 창을 표시합니다. 이 클래스를 사용하여 대화를 생성하면
-{@link android.app.Activity} 클래스의 대화 도우미 메서드를 사용하는 것의
-좋은 대안책이 됩니다. 이렇게 하면 프래그먼트 대화를 액티비티가 관리하는 프래그먼트의 백 스택에 통합시킬 수 있어,
+
부동 대화 창을 표시합니다. 이 클래스를 사용하여 대화를 생성하면
+{@link android.app.Activity} 클래스의 대화 도우미 메서드를 사용하는 것의
+좋은 대안책이 됩니다. 이렇게 하면 프래그먼트 대화를 액티비티가 관리하는 프래그먼트의 백 스택에 통합시킬 수 있어,
사용자가 무시된 프래그먼트를 반환할 수 있도록 해주기 때문입니다.
{@link android.app.ListFragment}
어댑터가 관리하는 항목의 목록(예: {@link
-android.widget.SimpleCursorAdapter})을 표시하며, {@link android.app.ListActivity}와 비슷합니다.
+android.widget.SimpleCursorAdapter})을 표시하며, {@link android.app.ListActivity}와 비슷합니다.
이것은 목록 보기를 관리하는 데 쓰는 몇 가지 메서드를 제공합니다. 예를 들어 {@link
-android.app.ListFragment#onListItemClick(ListView,View,int,long) onListItemClick()} 콜백을
+android.app.ListFragment#onListItemClick(ListView,View,int,long) onListItemClick()} 콜백을
제공하여 클릭 이벤트를 처리하는 것 등입니다.
{@link android.preference.Preference} 객체의 계층을 목록으로 표시하며,
+{@link android.preference.PreferenceActivity}와 비슷합니다. 이것은
애플리케이션에 대한 "설정" 액티비티를 생성할 때 유용합니다.
사용자 인터페이스 추가하기
-
프래그먼트는 일반적으로 액티비티에 속한 사용자 인터페이스의 일부분으로 사용되며
+
프래그먼트는 일반적으로 액티비티에 속한 사용자 인터페이스의 일부분으로 사용되며
자기 나름의 레이아웃으로 액티비티에 참가합니다.
프래그먼트에 대해 레이아웃을 제공하려면 반드시 {@link
-android.app.Fragment#onCreateView onCreateView()} 콜백 메서드를 구현해야 합니다.
-이것은 프래그먼트가 자신의 레이아웃을 그릴 때가 되면 Android 시스템이 호출하는 것입니다. 이 메서드의 구현은 반드시
+android.app.Fragment#onCreateView onCreateView()} 콜백 메서드를 구현해야 합니다.
+이것은 프래그먼트가 자신의 레이아웃을 그릴 때가 되면 Android 시스템이 호출하는 것입니다. 이 메서드의 구현은 반드시
{@link android.view.View}를 반환해야 합니다. 이것은 프래그먼트 레이아웃의 루트입니다.
참고: 프래그먼트가 {@link
-android.app.ListFragment}의 하위 클래스인 경우, 기본 구현이
+android.app.ListFragment}의 하위 클래스인 경우, 기본 구현이
{@link android.app.Fragment#onCreateView onCreateView()}로부터 {@link android.widget.ListView}를 반환하므로 이를 구현하지 않아도 됩니다.
{@link
-android.app.Fragment#onCreateView onCreateView()}로부터 레이아웃을 반환하려면 이를 XML에서 정의된 레이아웃 리소스로부터 팽창시키면 됩니다. 이를 돕기 위해
-{@link android.app.Fragment#onCreateView onCreateView()}가
+android.app.Fragment#onCreateView onCreateView()}로부터 레이아웃을 반환하려면 이를 XML에서 정의된 레이아웃 리소스로부터 팽창시키면 됩니다. 이를 돕기 위해
+{@link android.app.Fragment#onCreateView onCreateView()}가
{@link android.view.LayoutInflater} 객체를 제공합니다.
-
예를 들어 다음은 {@link android.app.Fragment}의 하위 클래스입니다. 이것이
+
예를 들어 다음은 {@link android.app.Fragment}의 하위 클래스입니다. 이것이
{@code example_fragment.xml} 파일로부터 레이아웃을 로딩합니다.
@@ -225,49 +225,49 @@ public static class ExampleFragment extends Fragment {
레이아웃 생성
-
위의 샘플에서 {@code R.layout.example_fragment}는
-애플리케이션 리소스에 저장된 {@code example_fragment.xml}이라는 레이아웃 리소스에 대한 참조입니다. 레이아웃을
+
위의 샘플에서 {@code R.layout.example_fragment}는
+애플리케이션 리소스에 저장된 {@code example_fragment.xml}이라는 레이아웃 리소스에 대한 참조입니다. 레이아웃을
XML로 생성하는 방법에 대한 정보는 사용자 인터페이스
문서를 참조하십시오.
{@link android.view.LayoutInflater#inflate(int,ViewGroup,boolean) inflate()} 메서드는
다음과 같은 세 개의 인수를 취합니다.
팽창시키고자 하는 레이아웃의 리소스 ID.
팽창된 레이아웃의 상위가 될 {@link android.view.ViewGroup}. {@code
-container}를 전달해야 시스템이 레이아웃 매개변수를 팽창된 레이아웃의 루트 보기에 실행 중인 상위 보기에서 지정한 것과 같이
+container}를 전달해야 시스템이 레이아웃 매개변수를 팽창된 레이아웃의 루트 보기에 실행 중인 상위 보기에서 지정한 것과 같이
적용할 수 있으므로 이는 중요한 부분입니다.
팽창된 레이아웃이 팽창 중에 {@link
-android.view.ViewGroup}(두 번째 매개변수)에 첨부되어야 하는지를 나타내는 부울 값 (이 경우,
+android.view.ViewGroup}(두 번째 매개변수)에 첨부되어야 하는지를 나타내는 부울 값 (이 경우,
이것은 거짓입니다. 시스템이 이미 팽창된 레이아웃을 {@code
container} 안에 삽입하고 있기 때문입니다. 참을 전달하면 최종 레이아웃에 중복된 보기 그룹을 생성하게 됩니다).
-
이제 레이아웃을 제공하는 프래그먼트 생성하는 법을 알게 되셨습니다. 다음은 프래그먼트를
+
이제 레이아웃을 제공하는 프래그먼트 생성하는 법을 알게 되셨습니다. 다음은 프래그먼트를
액티비티에 추가해야 합니다.
액티비티에 프래그먼트 추가
-
프래그먼트는 보통 UI의 일부분으로 호스트 액티비티에 참가합니다. 이는 해당 액티비티의
-전반적인 보기 계층의 일부분으로 포함되게 됩니다. 프래그먼트를 액티비티 레이아웃에 추가하는 데에는 두 가지 방법이
+
프래그먼트는 보통 UI의 일부분으로 호스트 액티비티에 참가합니다. 이는 해당 액티비티의
+전반적인 보기 계층의 일부분으로 포함되게 됩니다. 프래그먼트를 액티비티 레이아웃에 추가하는 데에는 두 가지 방법이
있습니다.
프래그먼트를 액티비티의 레이아웃 파일 안에서 선언합니다.
-
이 경우, 프래그먼트에 대한 레이아웃 속성을 마치
-보기인 것처럼 나타낼 수 있습니다. 예를 들어 다음은 프래그먼트가 두 개 있는
+
이 경우, 프래그먼트에 대한 레이아웃 속성을 마치
+보기인 것처럼 나타낼 수 있습니다. 예를 들어 다음은 프래그먼트가 두 개 있는
한 액티비티에 대한 레이아웃 파일을 나타낸 것입니다.
<?xml version="1.0" encoding="utf-8"?>
@@ -290,31 +290,31 @@ container} 안에 삽입하고 있기 때문입니다. 참을 전달하면 최
{@code <fragment>} 안의 {@code android:name} 속성이 레이아웃 안에서 인스턴트화할 {@link
android.app.Fragment} 클래스를 나타냅니다.
-
시스템은 이 액티비티 레이아웃을 생성할 때 레이아웃에서 지정된 각 프래그먼트를 인스턴트화하며 각각에 대해
-{@link android.app.Fragment#onCreateView onCreateView()} 메서드를
-호출하여 각 프래그먼트의 레이아웃을 검색합니다. 시스템은 프래그먼트가 반환한 {@link android.view.View}를
+
시스템은 이 액티비티 레이아웃을 생성할 때 레이아웃에서 지정된 각 프래그먼트를 인스턴트화하며 각각에 대해
+{@link android.app.Fragment#onCreateView onCreateView()} 메서드를
+호출하여 각 프래그먼트의 레이아웃을 검색합니다. 시스템은 프래그먼트가 반환한 {@link android.view.View}를
{@code <fragment>} 요소 자리에 곧바로 삽입합니다.
-
참고: 각 프래그먼트에는 액티비티가 재시작되는 경우
-프래그먼트를 복구하기 위해 시스템이 사용할 수 있는 고유한 식별자가 필요합니다(그리고, 개발자는 이것을 사용하여 프래그먼트를 캡처해
-이를 제거하는 등 여러 가지 트랜잭션을 수행할 수 있습니다). 프래그먼트에 ID를 제공하는 데에는
+
참고: 각 프래그먼트에는 액티비티가 재시작되는 경우
+프래그먼트를 복구하기 위해 시스템이 사용할 수 있는 고유한 식별자가 필요합니다(그리고, 개발자는 이것을 사용하여 프래그먼트를 캡처해
+이를 제거하는 등 여러 가지 트랜잭션을 수행할 수 있습니다). 프래그먼트에 ID를 제공하는 데에는
다음과 같은 세 가지 방법이 있습니다.
고유한 ID와 함께 {@code android:id} 속성을 제공합니다.
고유한 문자열과 함께 {@code android:tag} 속성을 제공합니다.
-
위의 두 가지 중 어느 것도 제공하지 않으면, 시스템은 컨테이너 보기의 ID를
+
위의 두 가지 중 어느 것도 제공하지 않으면, 시스템은 컨테이너 보기의 ID를
사용합니다.
또는, 프로그래밍 방식으로 프래그먼트를 기존의 {@link android.view.ViewGroup}에 추가합니다.
-
액티비티가 실행 중인 동안에는 언제든 액티비티 레이아웃에 프래그먼트를 추가할 수 있습니다. 그저 프래그먼트를 배치할
+
액티비티가 실행 중인 동안에는 언제든 액티비티 레이아웃에 프래그먼트를 추가할 수 있습니다. 그저 프래그먼트를 배치할
{@link
android.view.ViewGroup}를 지정하기만 하면 됩니다.
-
액티비티 내에서 프래그먼트 트랜잭션을 수행하려면(프래그먼트 추가, 제거 또는
-교체 등), {@link android.app.FragmentTransaction}에서 가져온 API를 사용해야 합니다.
+
액티비티 내에서 프래그먼트 트랜잭션을 수행하려면(프래그먼트 추가, 제거 또는
+교체 등), {@link android.app.FragmentTransaction}에서 가져온 API를 사용해야 합니다.
{@link android.app.FragmentTransaction}의 인스턴스를 {@link android.app.Activity}에서 가져오는 방법은 다음과 같습니다.
그런 다음 {@link
-android.app.FragmentTransaction#add(int,Fragment) add()} 메서드를 사용하여 프래그먼트를 추가하고, 추가할 프래그먼트와 이를 삽입할
+android.app.FragmentTransaction#add(int,Fragment) add()} 메서드를 사용하여 프래그먼트를 추가하고, 추가할 프래그먼트와 이를 삽입할
보기를 지정하면 됩니다. 예:
{@link android.app.FragmentTransaction#add(int,Fragment) add()}에
-전달되는 첫 인수가 {@link android.view.ViewGroup}입니다.
+
{@link android.app.FragmentTransaction#add(int,Fragment) add()}에
+전달되는 첫 인수가 {@link android.view.ViewGroup}입니다.
여기에 프래그먼트가 리소스 ID가 지정한 바와 같이 배치되어야 하며, 두 번째 매개변수는 추가할 프래그먼트입니다.
-{@link android.app.FragmentTransaction}을 변경하고 나면, 반드시
+{@link android.app.FragmentTransaction}을 변경하고 나면, 반드시
{@link android.app.FragmentTransaction#commit}을 호출해야 변경 내용이 적용됩니다.
위의 예시에서는 UI를 제공하기 위해 프래그먼트를 액티비티에 추가하는 방법을 보여드렸습니다. 하지만
-추가로 UI를 제시하지 않고 액티비티에 대한 배경 동작을 제공하는 데에도 프래그먼트를 사용할 수
+
위의 예시에서는 UI를 제공하기 위해 프래그먼트를 액티비티에 추가하는 방법을 보여드렸습니다. 하지만
+추가로 UI를 제시하지 않고 액티비티에 대한 배경 동작을 제공하는 데에도 프래그먼트를 사용할 수
있습니다.
UI 없이 프래그먼트를 추가하려면 액티비티로부터 가져온 프래그먼트를 {@link
-android.app.FragmentTransaction#add(Fragment,String)}을 사용하여 추가합니다(이때, 프래그먼트에 대해
-보기 ID보다는 고유한 문자열 "태그"를 제공합니다). 이렇게 하면 프래그먼트가 추가되지만,
+android.app.FragmentTransaction#add(Fragment,String)}을 사용하여 추가합니다(이때, 프래그먼트에 대해
+보기 ID보다는 고유한 문자열 "태그"를 제공합니다). 이렇게 하면 프래그먼트가 추가되지만,
이것은 액티비티 레이아웃 안에 있는 보기와 연관되어 있지 않기 때문에 {@link
android.app.Fragment#onCreateView onCreateView()}로의 호출은 받지 않습니다. 따라서 그 메서드는 구현하지 않아도 됩니다.
-
프래그먼트에 대해 문자열 태그를 제공하는 것은 엄밀히 말해 비 UI 프래그먼트에만 해당되는 것은 아닙니다. UI가 있는
-프래그먼트에도 문자열 태그를 제공할 수 있습니다. 하지만 프래그먼트에
-UI가 없는 경우라면 이를 식별할 방법은 문자열 태그뿐입니다. 액티비티에서 나중에
+
프래그먼트에 대해 문자열 태그를 제공하는 것은 엄밀히 말해 비 UI 프래그먼트에만 해당되는 것은 아닙니다. UI가 있는
+프래그먼트에도 문자열 태그를 제공할 수 있습니다. 하지만 프래그먼트에
+UI가 없는 경우라면 이를 식별할 방법은 문자열 태그뿐입니다. 액티비티에서 나중에
프래그먼트를 가져오고자 하는 경우, {@link android.app.FragmentManager#findFragmentByTag
findFragmentByTag()}를 사용해야 합니다.
예를 들어 어떤 액티비티에서 UI 없이 프래그먼트를 배경 작업자로 사용한다고 가정해봅시다. 이것의 예로 {@code
-FragmentRetainInstance.java} 샘플을 들 수 있으며
-이는 SDK 샘플에 포함되어 있고(Android SDK Manager를 통해 이용 가능), 시스템에는
+FragmentRetainInstance.java} 샘플을 들 수 있으며
+이는 SDK 샘플에 포함되어 있고(Android SDK Manager를 통해 이용 가능), 시스템에는
<sdk_root>/APIDemos/app/src/main/java/com/example/android/apis/app/FragmentRetainInstance.java로 찾을 수 있습니다.
프래그먼트 관리
-
액티비티 내의 프래그먼트를 관리하려면 {@link android.app.FragmentManager}를 사용해야 합니다. 이것을
+
액티비티 내의 프래그먼트를 관리하려면 {@link android.app.FragmentManager}를 사용해야 합니다. 이것을
가져오려면 액티비티에서 {@link android.app.Activity#getFragmentManager()}를 호출하십시오.
{@link android.app.FragmentManager}를 가지고 할 수 있는 여러 가지 일 중에 예를 들면 다음과 같습니다.
액티비티 내에 존재하는 프래그먼트를 {@link
-android.app.FragmentManager#findFragmentById findFragmentById()}로 가져오기(액티비티 레이아웃 내에서
+android.app.FragmentManager#findFragmentById findFragmentById()}로 가져오기(액티비티 레이아웃 내에서
UI를 제공하는 프래그먼트의 경우) 또는 {@link android.app.FragmentManager#findFragmentByTag
-findFragmentByTag()}로 가져오기(UI를 제공하거나 하지 않는 프래그먼트의 경우).
+findFragmentByTag()}로 가져오기(UI를 제공하거나 하지 않는 프래그먼트의 경우).
백 스택에서 프래그먼트를 {@link
android.app.FragmentManager#popBackStack()}을 사용하여 튀어나오게 하기(사용자가 내린 뒤로 명령을 시뮬레이트함).
백 스택에 변경 내용이 있는지 알아보기 위해 {@link
@@ -388,18 +388,18 @@ android.app.FragmentManager#addOnBackStackChangedListener addOnBackStackChangedL
이와 같은 메서드와 그 외 다른 메서드에 대한 자세한 정보는 {@link
android.app.FragmentManager} 클래스 관련 문서를 참조하십시오.
-
이전 섹션에서 설명한 바와 같이 {@link android.app.FragmentManager}를
+
이전 섹션에서 설명한 바와 같이 {@link android.app.FragmentManager}를
사용해서도 {@link android.app.FragmentTransaction}
을 열 수 있습니다. 이렇게 하면 프래그먼트 추가 및 제거 등 트랜잭션을 수행할 수 있게 해줍니다.
프래그먼트 트랜잭션 수행
-
액티비티에서 프래그먼트를 사용하는 경우 특히 유용한 점은 사용자 상호 작용에 응답하여 추가,
-제거, 교체 및 다른 작업을 수행할 수 있다는 것입니다. 액티비티에 적용한
+
액티비티에서 프래그먼트를 사용하는 경우 특히 유용한 점은 사용자 상호 작용에 응답하여 추가,
+제거, 교체 및 다른 작업을 수행할 수 있다는 것입니다. 액티비티에 적용한
변경 내용의 집합을 하나의 트랜잭션이라 칭합니다. 이것을 수행하려면 {@link
-android.app.FragmentTransaction} 내의 API를 사용하면 됩니다. 해당 액티비티가 관리하는 백 스택에 행해진 각 트랜잭션을
-저장할 수도 있습니다. 이렇게 하면 사용자가 프래그먼트 변경 내역을 거쳐 뒤로 탐색할 수 있습니다(액티비티를 통과해
+android.app.FragmentTransaction} 내의 API를 사용하면 됩니다. 해당 액티비티가 관리하는 백 스택에 행해진 각 트랜잭션을
+저장할 수도 있습니다. 이렇게 하면 사용자가 프래그먼트 변경 내역을 거쳐 뒤로 탐색할 수 있습니다(액티비티를 통과해
뒤로 탐색하는 것과 비슷합니다).
각 트랜잭션은 동시에 수행하고자 하는 여러 변경을 집합적으로 일컫는 말입니다. 주어진
트랜잭션에 대해 수행하고자 하는 모든 변경 사항을 설정하려면 {@link
android.app.FragmentTransaction#add add()}, {@link android.app.FragmentTransaction#remove remove()},
-및 {@link android.app.FragmentTransaction#replace replace()}와 같은 메서드를 사용하면 됩니다. 그런 다음,
+및 {@link android.app.FragmentTransaction#replace replace()}와 같은 메서드를 사용하면 됩니다. 그런 다음,
트랜잭션을 액티비티에 적용하려면 반드시 {@link android.app.FragmentTransaction#commit()}을 호출해야 합니다.
하지만 {@link
android.app.FragmentTransaction#commit()}을 호출하기 전에 먼저 호출해야 할 것이 있습니다. 바로 {@link
-android.app.FragmentTransaction#addToBackStack addToBackStack()}입니다.
-이렇게 해야 트랜잭션을 프래그먼트 트랜잭션의 백 스택에 추가할 수 있습니다. 이 백 스택을 액티비티가 관리하며,
+android.app.FragmentTransaction#addToBackStack addToBackStack()}입니다.
+이렇게 해야 트랜잭션을 프래그먼트 트랜잭션의 백 스택에 추가할 수 있습니다. 이 백 스택을 액티비티가 관리하며,
이를 통해 사용자가 이전 프래그먼트 상태로 되돌아갈 수 있습니다. 이때 뒤로 버튼을 누르면 됩니다.
-
예를 들어 다음은 한 프래그먼트를 다른 것으로 교체하고 이전 상태를 백 스택에 보존하는 법을
+
예를 들어 다음은 한 프래그먼트를 다른 것으로 교체하고 이전 상태를 백 스택에 보존하는 법을
나타낸 것입니다.
이 예시에서 {@code newFragment}가 현재 레이아웃 컨테이너에 있는
프래그먼트(있는 경우)를 교체합니다. 이는 {@code R.id.fragment_container} ID로 식별할 수 있습니다. {@link
-android.app.FragmentTransaction#addToBackStack addToBackStack()}를 호출하면 교체 트랜잭션이
-백 스택에 저장되고, 따라서 사용자가 트랜잭션을 거꾸로 수행하여
+android.app.FragmentTransaction#addToBackStack addToBackStack()}를 호출하면 교체 트랜잭션이
+백 스택에 저장되고, 따라서 사용자가 트랜잭션을 거꾸로 수행하여
이전 프래그먼트를 도로 가져올 수 있습니다. 뒤로 버튼을 사용하면 됩니다.
트랜잭션에 여러 개의 변경을 추가하고(예를 들어 또 다른 {@link
android.app.FragmentTransaction#add add()} 또는 {@link android.app.FragmentTransaction#remove
remove()}) {@link
-android.app.FragmentTransaction#addToBackStack addToBackStack()}을 호출하면, {@link android.app.FragmentTransaction#commit commit()}을 호출하기 전에 적용된 모든 변경 내용이
-백 스택에 하나의 트랜잭션으로 추가되며, 뒤로 버튼을 누르면
+android.app.FragmentTransaction#addToBackStack addToBackStack()}을 호출하면, {@link android.app.FragmentTransaction#commit commit()}을 호출하기 전에 적용된 모든 변경 내용이
+백 스택에 하나의 트랜잭션으로 추가되며, 뒤로 버튼을 누르면
모두 한꺼번에 역행하게 됩니다.
-
{@link android.app.FragmentTransaction}에 변경 내용을 추가하는 순서는 중요하지 않습니다.
+
{@link android.app.FragmentTransaction}에 변경 내용을 추가하는 순서는 중요하지 않습니다.
다만 다음과 같은 예외가 있습니다.
{@link android.app.FragmentTransaction#commit()}을 마지막으로 호출해야만 합니다.
-
같은 컨테이너에 여러 개의 프래그먼트를 추가하는 경우, 이를 추가하는 순서가 이들이
+
같은 컨테이너에 여러 개의 프래그먼트를 추가하는 경우, 이를 추가하는 순서가 이들이
보기 계층에 나타나는 순서를 결정 짓습니다.
프래그먼트를 제거하는 트랜잭션을 수행하면서 {@link android.app.FragmentTransaction#addToBackStack(String)
-addToBackStack()}을 호출하지 않는 경우,
-해당 프래그먼트는 트랜잭션이 적용되면 소멸되고 사용자가 이를 되짚어 탐색할 수 없게 됩니다. 반면에
-프래그먼트를 제거하면서 {@link android.app.FragmentTransaction#addToBackStack(String) addToBackStack()}을 호출하면,
-해당 프래그먼트는 중단되고 사용자가 뒤로 탐색하면
+addToBackStack()}을 호출하지 않는 경우,
+해당 프래그먼트는 트랜잭션이 적용되면 소멸되고 사용자가 이를 되짚어 탐색할 수 없게 됩니다. 반면에
+프래그먼트를 제거하면서 {@link android.app.FragmentTransaction#addToBackStack(String) addToBackStack()}을 호출하면,
+해당 프래그먼트는 중단되고 사용자가 뒤로 탐색하면
재개됩니다.
-
팁: 각 프래그먼트 트랜잭션에 대해 전환 애니메이션을 적용하려면
-커밋하기 전에 {@link android.app.FragmentTransaction#setTransition setTransition()}을
+
팁: 각 프래그먼트 트랜잭션에 대해 전환 애니메이션을 적용하려면
+커밋하기 전에 {@link android.app.FragmentTransaction#setTransition setTransition()}을
호출하면 됩니다.
-
{@link android.app.FragmentTransaction#commit()}을 호출해도 그 즉시 트랜잭션을 수행하지는
-않습니다. 그보다는, 액티비티의 UI 스레드("주요" 스레드)를 스레드가 할 수 있는 한 빨리
+
{@link android.app.FragmentTransaction#commit()}을 호출해도 그 즉시 트랜잭션을 수행하지는
+않습니다. 그보다는, 액티비티의 UI 스레드("주요" 스레드)를 스레드가 할 수 있는 한 빨리
이 트랜잭션을 수행하도록 일정을 예약하는 것에 가깝습니다. 하지만 필요한 경우 UI 스레드로부터 {@link
-android.app.FragmentManager#executePendingTransactions()}를 호출하면
-{@link android.app.FragmentTransaction#commit()}이 제출한 트랜잭션을 즉시 실행할 수 있습니다. 트랜잭션이
+android.app.FragmentManager#executePendingTransactions()}를 호출하면
+{@link android.app.FragmentTransaction#commit()}이 제출한 트랜잭션을 즉시 실행할 수 있습니다. 트랜잭션이
다른 스레드의 작업에 대한 종속성이 아니라면 굳이 이렇게 해야만 하는 것은 아닙니다.
주의: 트랜잭션을 적용할 때 {@link
-android.app.FragmentTransaction#commit commit()}을 사용해도 되는 것은 액티비티가 그 상태를
-저장하기 전뿐입니다(사용자가 액티비티를 떠날 때). 그 시점 이후에 적용하려고 하면 예외가
-발생합니다. 이것은 액티비티를 복원해야 하는 경우 적용 이후의 상태가 손실될 수
+android.app.FragmentTransaction#commit commit()}을 사용해도 되는 것은 액티비티가 그 상태를
+저장하기 전뿐입니다(사용자가 액티비티를 떠날 때). 그 시점 이후에 적용하려고 하면 예외가
+발생합니다. 이것은 액티비티를 복원해야 하는 경우 적용 이후의 상태가 손실될 수
있기 때문입니다. 적용이 손실되어도 괜찮은 상황이라면, {@link
android.app.FragmentTransaction#commitAllowingStateLoss()}를 사용하십시오.
{@link android.app.Fragment}는
-{@link android.app.Activity}로부터 독립적인 객체로 구현되었고 여러 개의 액티비티 안에서 사용할 수 있는 것이 사실이지만,
+
{@link android.app.Fragment}는
+{@link android.app.Activity}로부터 독립적인 객체로 구현되었고 여러 개의 액티비티 안에서 사용할 수 있는 것이 사실이지만,
프래그먼트의 주어진 인스턴스는 그것을 포함하고 있는 액티비티에 직접적으로 연결되어 있습니다.
구체적으로 말하면, 이 프래그먼트는 {@link
-android.app.Fragment#getActivity()}를 사용하여 {@link android.app.Activity} 인스턴스에 액세스하여
+android.app.Fragment#getActivity()}를 사용하여 {@link android.app.Activity} 인스턴스에 액세스하여
액티비티 레이아웃에서 보기를 찾는 것과 같은 작업을 손쉽게 수행할 수 있습니다.
이와 마찬가지로, 액티비티도 프래그먼트 안의 메서드를 호출할 수 있습니다. 그러려면 {@link android.app.FragmentManager}로부터의
+
이와 마찬가지로, 액티비티도 프래그먼트 안의 메서드를 호출할 수 있습니다. 그러려면 {@link android.app.FragmentManager}로부터의
{@link android.app.Fragment}에 대한 참조를 가져와야 하며, 이때 {@link
android.app.FragmentManager#findFragmentById findFragmentById()} 또는 {@link
android.app.FragmentManager#findFragmentByTag findFragmentByTag()}를 사용합니다. 예:
@@ -515,14 +515,14 @@ ExampleFragment fragment = (ExampleFragment) getFragmentManager().findFragmentBy
액티비티로의 이벤트 콜백 생성
-
어떤 경우에는 프래그먼트로 하여금 액티비티와 이벤트를 공유하게 해야 할 수 있습니다. 이렇게 하기 위한
-한 가지 좋은 방법은 프래그먼트 내부의 콜백 인터페이스를 정의한 다음 해당 호스트 액티비티가 이를 구현하도록
-하는 것입니다. 액티비티가 인터페이스를 통해 콜백을 수신하면, 필요에 따라 그 정보를 레이아웃 내의
+
어떤 경우에는 프래그먼트로 하여금 액티비티와 이벤트를 공유하게 해야 할 수 있습니다. 이렇게 하기 위한
+한 가지 좋은 방법은 프래그먼트 내부의 콜백 인터페이스를 정의한 다음 해당 호스트 액티비티가 이를 구현하도록
+하는 것입니다. 액티비티가 인터페이스를 통해 콜백을 수신하면, 필요에 따라 그 정보를 레이아웃 내의
다른 프래그먼트와 공유할 수 있습니다.
-
예를 들어 어떤 뉴스 애플리케이션에서 액티비티 하나에 프래그먼트가 두 개 있습니다.
- 하나는 기사 목록을 표시(프래그먼트 A)하고 다른 하나는 기사 하나를 표시(프래그먼트 B)하는 경우 목록 항목이 선택되면
-프래그먼트 A가 액티비티에 알려야 프래그먼트 B에 해당 기사를 표시하라고 알릴 수 있습니다. 이 경우,
+
예를 들어 어떤 뉴스 애플리케이션에서 액티비티 하나에 프래그먼트가 두 개 있습니다.
+ 하나는 기사 목록을 표시(프래그먼트 A)하고 다른 하나는 기사 하나를 표시(프래그먼트 B)하는 경우 목록 항목이 선택되면
+프래그먼트 A가 액티비티에 알려야 프래그먼트 B에 해당 기사를 표시하라고 알릴 수 있습니다. 이 경우,
{@code OnArticleSelectedListener} 인터페이스는 프래그먼트 A 내부에 선언됩니다.
@@ -537,12 +537,12 @@ public static class FragmentA extends ListFragment {
그러면 프래그먼트를 호스팅하는 액티비티가 {@code OnArticleSelectedListener}
- 인터페이스를
-구현하고 {@code onArticleSelected()}를 재정의하여 프래그먼트 A로부터 일어난 이벤트를
-프래그먼트 B에 알립니다. 호스트 액티비티가 이 인터페이스를 구현하도록
+ 인터페이스를
+구현하고 {@code onArticleSelected()}를 재정의하여 프래그먼트 A로부터 일어난 이벤트를
+프래그먼트 B에 알립니다. 호스트 액티비티가 이 인터페이스를 구현하도록
확실히 하려면 프래그먼트 A의 {@link
android.app.Fragment#onAttach onAttach()} 콜백 메서드(프래그먼트를 액티비티에 추가할 때 시스템이 호출하는 것)가 {@code OnArticleSelectedListener}의 인스턴스를 인스턴트화해야 합니다. 이때 {@link android.app.Fragment#onAttach
-onAttach()} 안으로 전달된 {@link android.app.Activity}를
+onAttach()} 안으로 전달된 {@link android.app.Activity}를
캐스팅하는 방법을 씁니다.
@@ -562,14 +562,14 @@ public static class FragmentA extends ListFragment {
}
-
액티비티가 인터페이스를 구현하지 않은 경우, 프래그먼트가
-{@link java.lang.ClassCastException}을 발생시킵니다.
-성공 시, {@code mListener} 구성원이 액티비티의
-{@code OnArticleSelectedListener} 구현에 대한 참조를 보유하므로, 프래그먼트 A가 액티비티와 이벤트를 공유할 수 있습니다.
-이때 {@code OnArticleSelectedListener} 인터페이스가 정의한 메서드를 호출하는 방법을 씁니다. 예를 들어 프래그먼트 A가
-{@link android.app.ListFragment}의 확장인 경우,
+
액티비티가 인터페이스를 구현하지 않은 경우, 프래그먼트가
+{@link java.lang.ClassCastException}을 발생시킵니다.
+성공 시, {@code mListener} 구성원이 액티비티의
+{@code OnArticleSelectedListener} 구현에 대한 참조를 보유하므로, 프래그먼트 A가 액티비티와 이벤트를 공유할 수 있습니다.
+이때 {@code OnArticleSelectedListener} 인터페이스가 정의한 메서드를 호출하는 방법을 씁니다. 예를 들어 프래그먼트 A가
+{@link android.app.ListFragment}의 확장인 경우,
사용자가 목록 항목을 클릭할 때마다 시스템이 프래그먼트 안의 {@link android.app.ListFragment#onListItemClick
-onListItemClick()}을 호출하고, 그러면 이것이 {@code onArticleSelected()}를 호출하여
+onListItemClick()}을 호출하고, 그러면 이것이 {@code onArticleSelected()}를 호출하여
해당 이벤트를 액티비티와 공유하는 것입니다.
@@ -588,42 +588,42 @@ public static class FragmentA extends ListFragment {
{@link
-android.app.ListFragment#onListItemClick onListItemClick()}에 전달된 {@code id} 매개변수가 클릭한 항목의 행 ID이며,
+android.app.ListFragment#onListItemClick onListItemClick()}에 전달된 {@code id} 매개변수가 클릭한 항목의 행 ID이며,
액티비티(또는 다른 프래그먼트)가 이것을 사용해 애플리케이션의 {@link
android.content.ContentProvider}에서 기사를 가져옵니다.
콘텐츠 제공자 사용법에 대한 자세한 정보는
+href="{@docRoot}resources/samples/NotePad/index.html">NotePad sample. -->콘텐츠 제공자 사용법에 대한 자세한 정보는
콘텐츠 제공자 문서에서 이용하실 수 있습니다.
작업 모음에 항목 추가
-
프래그먼트는 액티비티의 옵션 메뉴에(결과적으로 작업 모음에도) 메뉴 항목으로 참가할 수 있습니다. 이때
-{@link android.app.Fragment#onCreateOptionsMenu(Menu,MenuInflater) onCreateOptionsMenu()}를 구현하는 방법을 씁니다. 이 메서드가
+
프래그먼트는 액티비티의 옵션 메뉴에(결과적으로 작업 모음에도) 메뉴 항목으로 참가할 수 있습니다. 이때
+{@link android.app.Fragment#onCreateOptionsMenu(Menu,MenuInflater) onCreateOptionsMenu()}를 구현하는 방법을 씁니다. 이 메서드가
호출을 수신하도록 하려면, {@link
android.app.Fragment#onCreate(Bundle) onCreate()} 중에 {@link
-android.app.Fragment#setHasOptionsMenu(boolean) setHasOptionsMenu()}를 호출하여 프래그먼트가
-옵션 메뉴에 항목을 추가하고자 한다는 것을 나타내야 합니다(그렇지 않으면 해당 프래그먼트가
+android.app.Fragment#setHasOptionsMenu(boolean) setHasOptionsMenu()}를 호출하여 프래그먼트가
+옵션 메뉴에 항목을 추가하고자 한다는 것을 나타내야 합니다(그렇지 않으면 해당 프래그먼트가
{@link android.app.Fragment#onCreateOptionsMenu onCreateOptionsMenu()}로의 호출을 받지 못하게 됩니다).
-
그런 다음 프래그먼트로부터 옵션 메뉴에 추가하는 모든 항목은 기존의 메뉴 항목에
+
그런 다음 프래그먼트로부터 옵션 메뉴에 추가하는 모든 항목은 기존의 메뉴 항목에
추가됩니다. 해당 프래그먼트는 메뉴 항목을 선택하면 {@link
-android.app.Fragment#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}로의 콜백도
+android.app.Fragment#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}로의 콜백도
수신하게 됩니다.
또한 프래그먼트 레이아웃에 보기를 등록하여 컨텍스트 메뉴를 제공하도록 할 수도 있습니다. 이때 {@link
-android.app.Fragment#registerForContextMenu(View) registerForContextMenu()}를 호출하면 됩니다. 사용자가 컨텍스트 메뉴를 열면,
+android.app.Fragment#registerForContextMenu(View) registerForContextMenu()}를 호출하면 됩니다. 사용자가 컨텍스트 메뉴를 열면,
해당 프래그먼트가 {@link
android.app.Fragment#onCreateContextMenu(ContextMenu,View,ContextMenu.ContextMenuInfo)
onCreateContextMenu()}로의 호출을 받습니다. 사용자가 항목을 하나 선택하면, 해당 프래그먼트는 {@link
android.app.Fragment#onContextItemSelected(MenuItem) onContextItemSelected()}로의 호출을 받습니다.
-
참고: 프래그먼트는 추가한 각 메뉴 항목에 대해 '항목 선택됨' 콜백을
-하나씩 받게 되지만, 사용자가 메뉴 항목을 선택할 때 그에 상응하는 콜백을 가장 처음 받는 것은
-액티비티입니다. 액티비티가 구현한 '항목 선택됨' 콜백이 선택된 항목을 다루지 않는 경우,
-해당 이벤트는 프래그먼트의 콜백으로 전달됩니다. 이것은
+
참고: 프래그먼트는 추가한 각 메뉴 항목에 대해 '항목 선택됨' 콜백을
+하나씩 받게 되지만, 사용자가 메뉴 항목을 선택할 때 그에 상응하는 콜백을 가장 처음 받는 것은
+액티비티입니다. 액티비티가 구현한 '항목 선택됨' 콜백이 선택된 항목을 다루지 않는 경우,
+해당 이벤트는 프래그먼트의 콜백으로 전달됩니다. 이것은
옵션 메뉴와 컨텍스트 메뉴에 모두 참입니다.
또 다른 액티비티가 전경에 나와 있고 사용자가 이에 초점을 맞추고 있지만,
-이 프래그먼트가 있는 액티비티도 여전히 표시되어 있습니다(전경의 액티비티가 부분적으로 투명하거나
+
또 다른 액티비티가 전경에 나와 있고 사용자가 이에 초점을 맞추고 있지만,
+이 프래그먼트가 있는 액티비티도 여전히 표시되어 있습니다(전경의 액티비티가 부분적으로 투명하거나
전체 화면을 뒤덮지 않습니다).
정지됨
-
프래그먼트가 표시되지 않습니다. 호스트 액티비티가 정지되었거나
-프래그먼트가 액티비티에서 제거되었지만 백 스택에 추가되었습니다. 정지된 프래그먼트도
-여전히 표시는 됩니다(모든 상태 및 구성원 정보를 시스템이 보존합니다). 하지만, 사용자에게는
+
프래그먼트가 표시되지 않습니다. 호스트 액티비티가 정지되었거나
+프래그먼트가 액티비티에서 제거되었지만 백 스택에 추가되었습니다. 정지된 프래그먼트도
+여전히 표시는 됩니다(모든 상태 및 구성원 정보를 시스템이 보존합니다). 하지만, 사용자에게는
더 이상 표시되지 않으며 액티비티를 종료하면 이것도 종료됩니다.
이번에도 액티비티와 마찬가지로, 프래그먼트의 상태를 보존하려면 {@link
-android.os.Bundle}을 사용합니다. 이는 혹시나 액티비티의 프로세스가 종료되고 액티비티를
+android.os.Bundle}을 사용합니다. 이는 혹시나 액티비티의 프로세스가 종료되고 액티비티를
다시 만들 때 해당 프래그먼트의 상태를 복구해야 할 필요가 있을 때를 대비하는 것입니다. 상태를 저장하려면 프래그먼트의 {@link
-android.app.Fragment#onSaveInstanceState onSaveInstanceState()} 콜백 중에 저장할 수 있고, 복구는
+android.app.Fragment#onSaveInstanceState onSaveInstanceState()} 콜백 중에 저장할 수 있고, 복구는
{@link android.app.Fragment#onCreate onCreate()}, {@link
android.app.Fragment#onCreateView onCreateView()} 또는 {@link
-android.app.Fragment#onActivityCreated onActivityCreated()} 중 한 가지가 진행되는 동안 할 수 있습니다. 상태 저장에 관한 자세한 정보는
+android.app.Fragment#onActivityCreated onActivityCreated()} 중 한 가지가 진행되는 동안 할 수 있습니다. 상태 저장에 관한 자세한 정보는
액티비티
문서를 참조하십시오.
-
액티비티와 프래그먼트의 수명 주기에서 가장 중대한 차이점은
-해당되는 백 스택에 저장되는 방법입니다. 액티비티는 중단되었을 때 시스템이 관리하는
-액티비티 백 스택 안에 배치되는 것이 기본입니다(따라서 사용자가 뒤로 버튼을 사용하여 다시 이 액티비티로
-뒤로 탐색할 수 있습니다. 이 내용은 작업 및 백 스택에서 설명하였습니다).
-하지만, 프래그먼트가 호스트 액티비티가 관리하는 백 스택 안에 배치되는 것은 해당 인스턴스를 저장하라고 명시적으로 요청하는 경우뿐입니다.
+
액티비티와 프래그먼트의 수명 주기에서 가장 중대한 차이점은
+해당되는 백 스택에 저장되는 방법입니다. 액티비티는 중단되었을 때 시스템이 관리하는
+액티비티 백 스택 안에 배치되는 것이 기본입니다(따라서 사용자가 뒤로 버튼을 사용하여 다시 이 액티비티로
+뒤로 탐색할 수 있습니다. 이 내용은 작업 및 백 스택에서 설명하였습니다).
+하지만, 프래그먼트가 호스트 액티비티가 관리하는 백 스택 안에 배치되는 것은 해당 인스턴스를 저장하라고 명시적으로 요청하는 경우뿐입니다.
이때 프래그먼트를 제거하는 트랜잭션 중 {@link
-android.app.FragmentTransaction#addToBackStack(String) addToBackStack()}을
+android.app.FragmentTransaction#addToBackStack(String) addToBackStack()}을
호출합니다.
-
이것만 제외하면, 프래그먼트 수명 주기를 관리하는 것은 액티비티의 수명 주기를 관리하는 것과
-아주 비슷합니다. 따라서, 액티비티
-수명 주기 관리에 쓰이는 실례가 프래그먼트에도 똑같이 적용되는 것입니다. 하지만 또 한 가지 이해해두어야 하는 것이 있습니다. 즉,
+
이것만 제외하면, 프래그먼트 수명 주기를 관리하는 것은 액티비티의 수명 주기를 관리하는 것과
+아주 비슷합니다. 따라서, 액티비티
+수명 주기 관리에 쓰이는 실례가 프래그먼트에도 똑같이 적용되는 것입니다. 하지만 또 한 가지 이해해두어야 하는 것이 있습니다. 즉,
액티비티의 수명이 프래그먼트의 수명에 어떤 영향을 미치는지를 알아두어야 합니다.
-
주의: {@link android.app.Fragment} 내에서 {@link android.content.Context}
-객체가 필요한 경우, {@link android.app.Fragment#getActivity()}를 호출하면 됩니다.
+
주의: {@link android.app.Fragment} 내에서 {@link android.content.Context}
+객체가 필요한 경우, {@link android.app.Fragment#getActivity()}를 호출하면 됩니다.
그러나 {@link android.app.Fragment#getActivity()}를 호출하는 것은 프래그먼트가 액티비티에
- 첨부되어 있는 경우뿐이니 유의하십시오. 프래그먼트가 아직 첨부되지 않았거나 수명 주기가 끝날 무렵 분리된 경우,
+ 첨부되어 있는 경우뿐이니 유의하십시오. 프래그먼트가 아직 첨부되지 않았거나 수명 주기가 끝날 무렵 분리된 경우,
{@link android.app.Fragment#getActivity()}가 null을 반환합니다.
액티비티 수명 주기와 조화
-
프래그먼트가 있는 액티비티의 수명 주기는 해당 프래그먼트의 수명 주기에 직접적인
-영향을 미칩니다. 따라서 액티비티에 대한 각 수명 주기 콜백이 각 프래그먼트에 대한 비슷한 콜백을
-유발합니다. 예를 들어 액티비티가 {@link android.app.Activity#onPause}를 받으면,
+
프래그먼트가 있는 액티비티의 수명 주기는 해당 프래그먼트의 수명 주기에 직접적인
+영향을 미칩니다. 따라서 액티비티에 대한 각 수명 주기 콜백이 각 프래그먼트에 대한 비슷한 콜백을
+유발합니다. 예를 들어 액티비티가 {@link android.app.Activity#onPause}를 받으면,
해당 액티비티 내의 각 프래그먼트가 {@link android.app.Fragment#onPause}를 받습니다.
-
하지만 프래그먼트에는 몇 가지 수명 주기 콜백이 더 있습니다. 이것은 액티비티와의
-고유한 상호 작용을 다루어 프래그먼트의 UI를 구축하고 소멸시키는 것과 같은
+
하지만 프래그먼트에는 몇 가지 수명 주기 콜백이 더 있습니다. 이것은 액티비티와의
+고유한 상호 작용을 다루어 프래그먼트의 UI를 구축하고 소멸시키는 것과 같은
작업을 수행합니다. 이러한 추가적인 콜백 메서드를 예로 들면 다음과 같습니다.
호스트 액티비티의 영향을 받을 프래그먼트 수명 주기의 흐름은 그림 3에서
-확인하십시오. 이 그림을 보면 액티비티의 각 연속된 상태가 프래그먼트가 어느
+
호스트 액티비티의 영향을 받을 프래그먼트 수명 주기의 흐름은 그림 3에서
+확인하십시오. 이 그림을 보면 액티비티의 각 연속된 상태가 프래그먼트가 어느
콜백 메서드를 받게 되는지 결정 짓는다는 것을 볼 수 있습니다. 예를 들어 액티비티가 자신의 {@link
-android.app.Activity#onCreate onCreate()} 콜백을 받은 경우, 해당 액티비티 안에 있는 프래그먼트는
+android.app.Activity#onCreate onCreate()} 콜백을 받은 경우, 해당 액티비티 안에 있는 프래그먼트는
{@link android.app.Fragment#onActivityCreated onActivityCreated()} 콜백을 받을 뿐입니다.
-
액티비티가 재개된 상태에 도달하면 자유자재로 프래그먼트를 액티비티에 추가하거나 액티비티에서
-제거해도 됩니다. 따라서, 액티비티가 재개된 상태에 있는 동안에만 프래그먼트의 수명 주기를
+
액티비티가 재개된 상태에 도달하면 자유자재로 프래그먼트를 액티비티에 추가하거나 액티비티에서
+제거해도 됩니다. 따라서, 액티비티가 재개된 상태에 있는 동안에만 프래그먼트의 수명 주기를
독립적으로 변경할 수 있는 것입니다.
-
그러나 액티비티가 재개된 상태를 떠나면 액티비티는 다시 프래그먼트를 그 수명 주기 안으로
+
그러나 액티비티가 재개된 상태를 떠나면 액티비티는 다시 프래그먼트를 그 수명 주기 안으로
밀어넣습니다.
@@ -733,13 +733,13 @@ android.app.Activity#onCreate onCreate()} 콜백을 받은 경우, 해당 액티
예
-
이 문서에서 논의한 모든 것을 한 번에 모아 보기 위해, 다음은 두 개의 프래그먼트를 사용하여
-창이 두 개인 레이아웃을 생성하는 액티비티를 예시로 나타낸 것입니다. 아래의 액티비티에 포함된
-한 프래그먼트는 셰익스피어 희곡 제목 목록을 표시하고, 또 다른 하나는 목록에서 선택했을 때
-해당 희곡의 요약을 표시합니다. 또한 화면 구성을 근거로 프래그먼트를 여러 가지로 구성하여 제공하는 방법도
+
이 문서에서 논의한 모든 것을 한 번에 모아 보기 위해, 다음은 두 개의 프래그먼트를 사용하여
+창이 두 개인 레이아웃을 생성하는 액티비티를 예시로 나타낸 것입니다. 아래의 액티비티에 포함된
+한 프래그먼트는 셰익스피어 희곡 제목 목록을 표시하고, 또 다른 하나는 목록에서 선택했을 때
+해당 희곡의 요약을 표시합니다. 또한 화면 구성을 근거로 프래그먼트를 여러 가지로 구성하여 제공하는 방법도
보여줍니다.
@@ -752,44 +752,44 @@ android.app.Activity#onCreate onCreate()} 중에 일반적인 방식으로 레
{@sample development/samples/ApiDemos/res/layout-land/fragment_layout.xml layout}
-
시스템은 이 레이아웃을 사용하여 액티비티가 레이아웃을 로딩하자마자 {@code TitlesFragment}를 초기화합니다(이것이 희곡 제목을
+
시스템은 이 레이아웃을 사용하여 액티비티가 레이아웃을 로딩하자마자 {@code TitlesFragment}를 초기화합니다(이것이 희곡 제목을
목록으로 나열합니다). 반면 {@link android.widget.FrameLayout}
-(희곡 요약을 표시하는 프래그먼트가 배치될 곳)은 화면 오른쪽에 있는
-공간을 차지하기는 하지만 처음에는 텅 빈 상태로 유지됩니다. 아래에서 볼 수 있듯이, 사용자가 해당 목록에서
+(희곡 요약을 표시하는 프래그먼트가 배치될 곳)은 화면 오른쪽에 있는
+공간을 차지하기는 하지만 처음에는 텅 빈 상태로 유지됩니다. 아래에서 볼 수 있듯이, 사용자가 해당 목록에서
항목을 하나 선택해야만 프래그먼트가 {@link android.widget.FrameLayout} 안에 배치됩니다.
-
그러나 희곡 목록과 요약을 둘 다 나란히 표시할 만큼 너비가 넓지 않은
-화면 구성도 있습니다. 따라서 위의 레이아웃은 가로 방향 화면 구성에만 사용되며,
+
그러나 희곡 목록과 요약을 둘 다 나란히 표시할 만큼 너비가 넓지 않은
+화면 구성도 있습니다. 따라서 위의 레이아웃은 가로 방향 화면 구성에만 사용되며,
이를 {@code res/layout-land/fragment_layout.xml}에 저장하여 씁니다.
-
그러므로 화면이 세로 방향으로 구성된 경우, 시스템은 다음 레이아웃을 적용합니다. 이것은
+
그러므로 화면이 세로 방향으로 구성된 경우, 시스템은 다음 레이아웃을 적용합니다. 이것은
{@code res/layout/fragment_layout.xml}에 저장되어 있습니다.
이 레이아웃에는 {@code TitlesFragment}만 포함되어 있습니다. 이는 다시 말해 기기가 세로 방향인 경우에는
-희곡 제목 목록만 표시된다는 뜻입니다. 따라서 사용자가 이 구성에서 목록 항목을 하나 클릭하면,
-애플리케이션이 두 번째 프래그먼트를 로딩하는 대신 새 액티비티를 시작하여 요약을
+
이 레이아웃에는 {@code TitlesFragment}만 포함되어 있습니다. 이는 다시 말해 기기가 세로 방향인 경우에는
+희곡 제목 목록만 표시된다는 뜻입니다. 따라서 사용자가 이 구성에서 목록 항목을 하나 클릭하면,
+애플리케이션이 두 번째 프래그먼트를 로딩하는 대신 새 액티비티를 시작하여 요약을
표시하게 됩니다.
다음으로, 프래그먼트 클래스에서 이것을 달성하는 방법을 보시겠습니다. 첫 번째가 {@code
TitlesFragment}로, 셰익스피어 희곡 제목 목록을 표시하는 것입니다. 이 프래그먼트는 {@link
android.app.ListFragment}를 확장하며 목록 보기 작업의 대부분을 처리하기 위해 여기에 의존합니다.
-
이 코드를 살펴보면서 사용자가 목록 항목을 클릭하면 일어날 수 있는 두 가지 동작이
-있다는 점을 눈여겨 보십시오. 두 레이아웃 중 어느 것이 활성화 상태인지에 따라
+
이 코드를 살펴보면서 사용자가 목록 항목을 클릭하면 일어날 수 있는 두 가지 동작이
+있다는 점을 눈여겨 보십시오. 두 레이아웃 중 어느 것이 활성화 상태인지에 따라
같은 액티비티 내에서 세부 사항을 표시하기 위해 새 프래그먼트를 생성하거나 표시할 수도 있고(프래그먼트를 {@link
android.widget.FrameLayout}에 추가함으로써), 새 액티비티를 시작할 수도 있습니다(프래그먼트를 표시할 수 있는 곳).
{@code TitlesFragment} 클래스에서 다룬 것을 되살려 보면, 사용자가 목록 항목을 클릭하고
-현재 레이아웃이 {@code R.id.details} 보기를 포함하지 않는 경우(이 보기가
+
{@code TitlesFragment} 클래스에서 다룬 것을 되살려 보면, 사용자가 목록 항목을 클릭하고
+현재 레이아웃이 {@code R.id.details} 보기를 포함하지 않는 경우(이 보기가
{@code DetailsFragment}가 속하는 곳임), 애플리케이션은 항목의 내용을 표시하기 위해 {@code DetailsActivity}
액티비티를 시작하게 됩니다.
@@ -798,14 +798,14 @@ android.widget.FrameLayout}에 추가함으로써), 새 액티비티를 시작
{@sample development/samples/ApiDemos/src/com/example/android/apis/app/FragmentLayout.java
details_activity}
-
-
이 액티비티는 구성이 가로 방향인 경우 알아서 종료한다는 점을 눈여겨 보십시오. 따라서
+
+
이 액티비티는 구성이 가로 방향인 경우 알아서 종료한다는 점을 눈여겨 보십시오. 따라서
주요 액티비티가 작업을 인계 받아 {@code DetailsFragment}를 {@code TitlesFragment}와 함께 표시할 수 있는 것입니다.
-이것은 사용자가 세로 방향 구성에서 {@code DetailsActivity}를 시작했지만
+이것은 사용자가 세로 방향 구성에서 {@code DetailsActivity}를 시작했지만
그런 다음 가로 방향으로 돌리는 경우(현재 액티비티를 다시 시작함) 일어날 수 있습니다.
-
프래그먼트 사용에 대한 더 많은 샘플(및 이 예시에 대한 완전한 소스 파일)을 보시려면
+
프래그먼트 사용에 대한 더 많은 샘플(및 이 예시에 대한 완전한 소스 파일)을 보시려면
ApiDemos에서 이용할 수 있는 API Demos 샘플 앱을 참조하십시오(샘플 SDK 구성 요소에서 다운로드할 수 있습니다).
diff --git a/docs/html-intl/intl/ko/guide/components/fundamentals.jd b/docs/html-intl/intl/ko/guide/components/fundamentals.jd
index 608b5a2cba1b9..6bb5a9f7ba556 100644
--- a/docs/html-intl/intl/ko/guide/components/fundamentals.jd
+++ b/docs/html-intl/intl/ko/guide/components/fundamentals.jd
@@ -22,54 +22,54 @@ page.title=애플리케이션 기본 항목
-
Android 앱은 Java 프로그래밍 언어로 작성됩니다. Android SDK 도구는
+
Android 앱은 Java 프로그래밍 언어로 작성됩니다. Android SDK 도구는
코드를 컴파일링하여 모든 데이터 및 리소스 파일과 함께 하나의 APK로 만듭니다. 이것은 즉, Android 패키지
-를 뜻하며, 이는 일종의 {@code .apk} 접미사가 있는 아카이브 파일입니다. 한 개의 APK 파일에는
+를 뜻하며, 이는 일종의 {@code .apk} 접미사가 있는 아카이브 파일입니다. 한 개의 APK 파일에는
Android 앱의 모든 콘텐츠가 들어 있으며 이 파일이 바로 Android로 구동하는 기기가 앱을 설치할 때 사용하는 파일입니다.
Android 앱은 일단 기기에 설치되고 나면 각자 나름의 보안 샌드박스 안에 살게 됩니다.
-
Android 운영 체제는 멀티 사용자 Linux 시스템으로, 여기서 각 앱은 각기 다른 사용자와
+
Android 운영 체제는 멀티 사용자 Linux 시스템으로, 여기서 각 앱은 각기 다른 사용자와
같습니다.
-
기본적으로 시스템이 각 앱에 고유한 Linux ID를 할당합니다(이 ID는 시스템만
-사용할 수 있으며 앱은 이것을 알지 못합니다). 시스템은 앱 안의 모든 파일에 대해 권한을 설정하여
+
기본적으로 시스템이 각 앱에 고유한 Linux ID를 할당합니다(이 ID는 시스템만
+사용할 수 있으며 앱은 이것을 알지 못합니다). 시스템은 앱 안의 모든 파일에 대해 권한을 설정하여
해당 앱에 할당된 사용자 ID만 이에 액세스할 수 있도록 합니다.
-
각 프로세스에는 나름의 가상 머신(VM)이 있고, 그렇기 때문에 한 앱의 코드가 다른 여러 앱과는 격리된 상태로
+
각 프로세스에는 나름의 가상 머신(VM)이 있고, 그렇기 때문에 한 앱의 코드가 다른 여러 앱과는 격리된 상태로
실행됩니다.
-
기본적으로 모든 앱이 나름의 Linux 프로세스에서 실행됩니다. Android는 앱의 구성 요소 중
-어느 것이라도 실행해야 하는 경우 프로세스를 시작하고, 이것이 더 이상 필요 없어지거나 시스템이 다른 앱을 위해
+
기본적으로 모든 앱이 나름의 Linux 프로세스에서 실행됩니다. Android는 앱의 구성 요소 중
+어느 것이라도 실행해야 하는 경우 프로세스를 시작하고, 이것이 더 이상 필요 없어지거나 시스템이 다른 앱을 위해
메모리를 회복해야 하는 경우 해당 프로세스를 종료합니다.
-
Android 시스템은 이런 방식으로 최소 특권의 원리를 구현하는 것입니다. 다시 말해,
-각 앱은 기본적으로 자신의 작업을 수행하기 위해 필요한 구성 요소에만 액세스 권한을 가지고
-그 이상은 허용되지 않습니다. 이렇게 하면 대단히 안전한 환경이 만들어져 앱이 시스템에서
+
Android 시스템은 이런 방식으로 최소 특권의 원리를 구현하는 것입니다. 다시 말해,
+각 앱은 기본적으로 자신의 작업을 수행하기 위해 필요한 구성 요소에만 액세스 권한을 가지고
+그 이상은 허용되지 않습니다. 이렇게 하면 대단히 안전한 환경이 만들어져 앱이 시스템에서
자신이 권한을 부여 받지 못한 부분에는 액세스할 수 없게 됩니다.
-
그러나, 앱이 다른 여러 앱과 데이터를 공유하는 것과 앱이 시스템 서비스에 액세스하는 데에는
+
그러나, 앱이 다른 여러 앱과 데이터를 공유하는 것과 앱이 시스템 서비스에 액세스하는 데에는
여러 가지 방법이 있습니다.
-
두 개의 앱이 같은 Linux 사용자 ID를 공유하도록 설정할 수도 있습니다. 이 경우
-두 앱은 서로의 파일에 액세스할 수 있게 됩니다. 시스템 리소스를 절약하려면, 같은 사용자 ID를 가진 앱이
-같은 Linux 프로세스에서 실행되도록 설정하고 같은 VM을 공유하도록 할 수도 있습니다(이들 앱은 같은 인증서로
+
두 개의 앱이 같은 Linux 사용자 ID를 공유하도록 설정할 수도 있습니다. 이 경우
+두 앱은 서로의 파일에 액세스할 수 있게 됩니다. 시스템 리소스를 절약하려면, 같은 사용자 ID를 가진 앱이
+같은 Linux 프로세스에서 실행되도록 설정하고 같은 VM을 공유하도록 할 수도 있습니다(이들 앱은 같은 인증서로
서명해야 합니다).
-
앱은 사용자의 연락처, SMS 메시지, 마운트 가능한 저장소(SD 카드),
-카메라, Bluetooth를 비롯하여 이외에도 여러 가지 기기 데이터에 액세스할 권한을 요청할 수 있습니다. 모든
+
앱은 사용자의 연락처, SMS 메시지, 마운트 가능한 저장소(SD 카드),
+카메라, Bluetooth를 비롯하여 이외에도 여러 가지 기기 데이터에 액세스할 권한을 요청할 수 있습니다. 모든
앱 권한은 설치 시점에 사용자가 허용해야 합니다.
-
이렇게 해서 Android 앱이 시스템 내에 어떤 식으로 존재하는지 기본 정보를 알아보았습니다. 이 문서의
+
이렇게 해서 Android 앱이 시스템 내에 어떤 식으로 존재하는지 기본 정보를 알아보았습니다. 이 문서의
나머지 부분에서 소개될 내용은 다음과 같습니다.
앱을 정의하는 핵심 프레임워크 구성 요소.
-
구성 요소를 선언하고 앱에 맞는 필수 기기 특징을 선언할 수 있는 매니페스트
+
구성 요소를 선언하고 앱에 맞는 필수 기기 특징을 선언할 수 있는 매니페스트
파일.
-
앱 코드로부터 별도로 분리되어 있으며 앱이 다양한 기기 구성에 맞게 자신의 행동을
+
앱 코드로부터 별도로 분리되어 있으며 앱이 다양한 기기 구성에 맞게 자신의 행동을
안정적으로 최적화할 수 있도록 해주는 리소스.
@@ -77,13 +77,13 @@ Android 앱의 모든 콘텐츠가 들어 있으며 이 파일이 바로 Android
앱 구성 요소
-
앱 구성 요소는 Android 앱을 이루는 가장 기본적인 구성 단위입니다. 각
-구성 요소는 시스템이 앱으로 들어올 수 있는 각기 다른 통과 지점을 나타냅니다. 구성 요소 중에는
-실제 사용자가 쓸 수 있는 진입 지점이 아닌 것도 있고, 일부는 서로에게 의존하지만,
-각각의 구성 요소는 따로 떨어진 엔티티로서 존재하며 각기 특정한 역할을 수행합니다. 즉 하나하나가
+
앱 구성 요소는 Android 앱을 이루는 가장 기본적인 구성 단위입니다. 각
+구성 요소는 시스템이 앱으로 들어올 수 있는 각기 다른 통과 지점을 나타냅니다. 구성 요소 중에는
+실제 사용자가 쓸 수 있는 진입 지점이 아닌 것도 있고, 일부는 서로에게 의존하지만,
+각각의 구성 요소는 따로 떨어진 엔티티로서 존재하며 각기 특정한 역할을 수행합니다. 즉 하나하나가
앱의 전반적인 행동을 정의하는 데 유용한 고유한 구성 단위인 것입니다.
-
앱 구성 요소에는 네 가지 서로 다른 유형이 있습니다. 각 유형이 뚜렷한 목적을 가지고 있으며
+
앱 구성 요소에는 네 가지 서로 다른 유형이 있습니다. 각 유형이 뚜렷한 목적을 가지고 있으며
각자 나름의 수명 주기가 있어 구성 요소의 생성 및 소멸 방식을 정의합니다.
다음은 네 가지 유형의 앱 구성 요소를 나타낸 것입니다.
@@ -92,15 +92,15 @@ Android 앱의 모든 콘텐츠가 들어 있으며 이 파일이 바로 Android
액티비티
-
통상 액티비티 라고 하면, 사용자 인터페이스가 있는 화면 하나를 나타냅니다. 예를 들어
-이메일 앱이라면 새 이메일 목록을 표시하는 액티비티가 하나 있고,
-이메일을 작성하는 액티비티가 또 하나, 그리고 이메일을 읽는 데 쓰는 액티비티가 또 하나 있을 수 있습니다. 여러
-액티비티가 함께 작동하여 해당 이메일 앱에서 짜임새 있는 사용자 환경을 형성하는 것은 사실이지만, 각자 서로와는
-독립적인 형태입니다. 따라서, 다른 앱이 이와 같은 액티비티 중 어느 것이라도 하나만
-시작할 수 있습니다(이메일 앱이 그렇게 하도록 허용하는 경우). 예를 들어, 카메라 앱이라면 이메일 앱 안의
+
통상 액티비티 라고 하면, 사용자 인터페이스가 있는 화면 하나를 나타냅니다. 예를 들어
+이메일 앱이라면 새 이메일 목록을 표시하는 액티비티가 하나 있고,
+이메일을 작성하는 액티비티가 또 하나, 그리고 이메일을 읽는 데 쓰는 액티비티가 또 하나 있을 수 있습니다. 여러
+액티비티가 함께 작동하여 해당 이메일 앱에서 짜임새 있는 사용자 환경을 형성하는 것은 사실이지만, 각자 서로와는
+독립적인 형태입니다. 따라서, 다른 앱이 이와 같은 액티비티 중 어느 것이라도 하나만
+시작할 수 있습니다(이메일 앱이 그렇게 하도록 허용하는 경우). 예를 들어, 카메라 앱이라면 이메일 앱 안의
액티비티를 시작하여 새 메일을 작성하도록 해서 사용자가 사진을 공유하도록 할 수 있습니다.
-
액티비티는 {@link android.app.Activity}의 하위 클래스로 구현되며 이에 대한 더 자세한 내용은
+
액티비티는 {@link android.app.Activity}의 하위 클래스로 구현되며 이에 대한 더 자세한 내용은
액티비티
개발자 가이드에서 확인하실 수 있습니다.
@@ -108,14 +108,14 @@ Android 앱의 모든 콘텐츠가 들어 있으며 이 파일이 바로 Android
서비스
-
통상 서비스 라고 하면 배경에서 실행되는 구성 요소로, 오랫동안 실행되는
-작업을 수행하거나 원격 프로세스를 위한 작업을 수행하는 것입니다. 서비스는
-사용자 인터페이스를 제공하지 않습니다. 예를 들어 서비스는 사용자가 다른 앱에 있는 동안에 배경에서 음악을 재생할 수도 있고,
-아니면 사용자와 액티비티 사이의 상호 작용을 차단하지 않고 네트워크를 가로질러
-데이터를 가져올 수도 있습니다. 또 다른 구성 요소(예: 액티비티)가 서비스를 시작한 다음
+
통상 서비스 라고 하면 배경에서 실행되는 구성 요소로, 오랫동안 실행되는
+작업을 수행하거나 원격 프로세스를 위한 작업을 수행하는 것입니다. 서비스는
+사용자 인터페이스를 제공하지 않습니다. 예를 들어 서비스는 사용자가 다른 앱에 있는 동안에 배경에서 음악을 재생할 수도 있고,
+아니면 사용자와 액티비티 사이의 상호 작용을 차단하지 않고 네트워크를 가로질러
+데이터를 가져올 수도 있습니다. 또 다른 구성 요소(예: 액티비티)가 서비스를 시작한 다음
실행되도록 두거나 자신에게 바인딩하여 상호 작용하도록 할 수도 있습니다.
-
서비스는 {@link android.app.Service}의 하위 클래스로 구현되며 이에 대한 더 자세한 내용은
+
서비스는 {@link android.app.Service}의 하위 클래스로 구현되며 이에 대한 더 자세한 내용은
서비스
개발자 가이드에서 확인하실 수 있습니다.
@@ -123,20 +123,20 @@ Android 앱의 모든 콘텐츠가 들어 있으며 이 파일이 바로 Android
콘텐츠 제공자
-
통상 콘텐츠 제공자 는 공유된 앱 데이터 집합을 관리합니다. 데이터는 파일 시스템이나 SQLite 데이터베이스,
-또는 웹이나 기타 영구적인 저장소 위치 중 앱이 액세스할 수 있는 곳이라면 어디에든 저장할 수
-있습니다. 다른 여러 앱은 콘텐츠 제공자를 통해 해당 데이터를 쿼리하거나, 심지어는 수정할 수도
-있습니다(콘텐츠 제공자가 그렇게 하도록 허용하는 경우). 예를 들어, Android 시스템은 사용자의 연락처 정보를
-관리하는 콘텐츠 제공자를 제공합니다. 따라서, 적절한 권한을 가진 앱이라면
+
통상 콘텐츠 제공자 는 공유된 앱 데이터 집합을 관리합니다. 데이터는 파일 시스템이나 SQLite 데이터베이스,
+또는 웹이나 기타 영구적인 저장소 위치 중 앱이 액세스할 수 있는 곳이라면 어디에든 저장할 수
+있습니다. 다른 여러 앱은 콘텐츠 제공자를 통해 해당 데이터를 쿼리하거나, 심지어는 수정할 수도
+있습니다(콘텐츠 제공자가 그렇게 하도록 허용하는 경우). 예를 들어, Android 시스템은 사용자의 연락처 정보를
+관리하는 콘텐츠 제공자를 제공합니다. 따라서, 적절한 권한을 가진 앱이라면
어떤 것이든 해당 콘텐츠 제공자의 일부를 쿼리하여(예를 들어 {@link
android.provider.ContactsContract.Data} 등) 특정한 사람에 대한 정보를 읽고 쓸 수 있습니다.
-
콘텐츠 제공자는 앱에서 비공개이며 공유되지 않는 데이터를 읽고 쓰는 데에도
-유용합니다. 예를 들어 메모장 샘플 앱은 메모한 내용을 저장하는 데
+
콘텐츠 제공자는 앱에서 비공개이며 공유되지 않는 데이터를 읽고 쓰는 데에도
+유용합니다. 예를 들어 메모장 샘플 앱은 메모한 내용을 저장하는 데
콘텐츠 제공자를 사용합니다.
콘텐츠 제공자는 {@link android.content.ContentProvider}의
-하위 클래스로 구현되며, 다른 앱이 트랜잭션을 수행할 수 있도록 활성화하는 표준 API 집합을
+하위 클래스로 구현되며, 다른 앱이 트랜잭션을 수행할 수 있도록 활성화하는 표준 API 집합을
구현해야 합니다. 자세한 내용은 콘텐츠 제공자 개발자
가이드를 참조하십시오.
@@ -144,18 +144,18 @@ android.provider.ContactsContract.Data} 등) 특정한 사람에 대한 정보
브로드캐스트 수신기
-
통상 브로드캐스트 수신기 는 시스템 전체에 대한 브로드캐스트 공지에 응답하는 구성 요소를
-말합니다. 대다수의 브로드캐스트는 시스템에서 시작합니다. 예를 들어, 화면이 꺼졌다거나
+
통상 브로드캐스트 수신기 는 시스템 전체에 대한 브로드캐스트 공지에 응답하는 구성 요소를
+말합니다. 대다수의 브로드캐스트는 시스템에서 시작합니다. 예를 들어, 화면이 꺼졌다거나
배터리 잔량이 부족하다거나, 사진을 캡처했다는 것을 알리는 브로드캐스트가 있습니다.
-앱도 브로드캐스트를 시작합니다. 예를 들어, 기기에 몇 가지 데이터를 다운로드하여 다른 앱도 사용할 수 있다는
-사실을 다른 여러 앱에게 알리는 것입니다. 브로드캐스트 수신기는 사용자 인터페이스를 표시하지 않지만,
-상태 표시줄 알림을 생성하여
-사용자에게 브로드캐스트 이벤트가 발생했다고 알릴 수 있습니다. 다만 브로드캐스트 수신기는
-그저 다른 구성 요소로의 "게이트웨이"인 경우가 더 보편적이고, 극소량의 작업만 수행하도록 만들어진 경우가 많습니다. 예컨대
+앱도 브로드캐스트를 시작합니다. 예를 들어, 기기에 몇 가지 데이터를 다운로드하여 다른 앱도 사용할 수 있다는
+사실을 다른 여러 앱에게 알리는 것입니다. 브로드캐스트 수신기는 사용자 인터페이스를 표시하지 않지만,
+상태 표시줄 알림을 생성하여
+사용자에게 브로드캐스트 이벤트가 발생했다고 알릴 수 있습니다. 다만 브로드캐스트 수신기는
+그저 다른 구성 요소로의 "게이트웨이"인 경우가 더 보편적이고, 극소량의 작업만 수행하도록 만들어진 경우가 많습니다. 예컨대
서비스를 시작하여 이벤트를 근거로 한 어떤 작업을 수행하도록 할 수 있습니다.
-
브로드캐스트 수신기는 {@link android.content.BroadcastReceiver}의
-하위 클래스로 구현되며 각 브로드캐스트는 {@link android.content.Intent} 객체로 전달됩니다. 자세한 정보는
+
브로드캐스트 수신기는 {@link android.content.BroadcastReceiver}의
+하위 클래스로 구현되며 각 브로드캐스트는 {@link android.content.Intent} 객체로 전달됩니다. 자세한 정보는
{@link android.content.BroadcastReceiver} 클래스를 참조하십시오.
@@ -163,72 +163,72 @@ android.provider.ContactsContract.Data} 등) 특정한 사람에 대한 정보
-
Android 시스템 디자인의 독특한 점으로 어떤 앱이든 다른 앱의 구성 요소를 시작할 수 있다는 점을
-들 수 있습니다. 예를 들어 사용자가 기기 카메라로 사진을 캡처하기를 바라는 경우,
-그런 작업을 수행하는 또 다른 앱이 있을 가능성이 높습니다. 그러면 사진을 캡처하는 액티비티를 직접 개발하는 대신
-여러분의 앱이 그 앱을 사용하도록 하면 됩니다. 카메라 앱에
+
Android 시스템 디자인의 독특한 점으로 어떤 앱이든 다른 앱의 구성 요소를 시작할 수 있다는 점을
+들 수 있습니다. 예를 들어 사용자가 기기 카메라로 사진을 캡처하기를 바라는 경우,
+그런 작업을 수행하는 또 다른 앱이 있을 가능성이 높습니다. 그러면 사진을 캡처하는 액티비티를 직접 개발하는 대신
+여러분의 앱이 그 앱을 사용하도록 하면 됩니다. 카메라 앱에
통합하기는커녕 카메라 앱의 코드에 연결시킬 필요조차도 없습니다.
-그 대신, 그저 사진을 캡처하는 카메라 앱 안의 해당 액티비티를 시작하기만 하면
-됩니다. 작업이 완료되면 사진이 앱으로 반환되기까지 하여 바로 사용할 수 있습니다. 사용자에게는,
+그 대신, 그저 사진을 캡처하는 카메라 앱 안의 해당 액티비티를 시작하기만 하면
+됩니다. 작업이 완료되면 사진이 앱으로 반환되기까지 하여 바로 사용할 수 있습니다. 사용자에게는,
마치 카메라가 여러분의 앱의 일부분인 것처럼 보입니다.
-
시스템이 구성 요소를 시작하는 경우, 그 앱에 대한 프로세스를 시작하는 것이며(이미
-실행 중이지 않은 경우), 해당 구성 요소에 필요한 클래스를 인스턴트화하는 것입니다. 예를 들어 여러분의 앱이
-카메라 앱 내에서 사진을 캡처하는 액티비티를 시작한다고 하면, 해당 액티비티는
-여러분 앱의 프로세스가 아니라 카메라 앱에 속한 프로세스에서 실행됩니다.
-따라서 대부분의 다른 시스템에서와는 달리 Android 앱에는 단일한 진입
+
시스템이 구성 요소를 시작하는 경우, 그 앱에 대한 프로세스를 시작하는 것이며(이미
+실행 중이지 않은 경우), 해당 구성 요소에 필요한 클래스를 인스턴트화하는 것입니다. 예를 들어 여러분의 앱이
+카메라 앱 내에서 사진을 캡처하는 액티비티를 시작한다고 하면, 해당 액티비티는
+여러분 앱의 프로세스가 아니라 카메라 앱에 속한 프로세스에서 실행됩니다.
+따라서 대부분의 다른 시스템에서와는 달리 Android 앱에는 단일한 진입
지점이 없습니다(예를 들어 {@code main()} 기능이 없습니다).
-
시스템이 각 앱을 별도의 프로세스에서 실행하며 다른 앱에 대한 액세스를 제한하는
-파일 권한을 가지고 실행하기 때문에 여러분의 앱은 또 다른 앱에서 곧바로 구성 요소를
-활성화할 수는 없습니다. 하지만 Android 시스템은 할 수 있습니다. 그래서 또 다른 앱에 있는
-구성 요소를 활성화하려면 시스템에 메시지를 전달하여 특정 구성 요소를 시작하고자 하는 인텐트를
+
시스템이 각 앱을 별도의 프로세스에서 실행하며 다른 앱에 대한 액세스를 제한하는
+파일 권한을 가지고 실행하기 때문에 여러분의 앱은 또 다른 앱에서 곧바로 구성 요소를
+활성화할 수는 없습니다. 하지만 Android 시스템은 할 수 있습니다. 그래서 또 다른 앱에 있는
+구성 요소를 활성화하려면 시스템에 메시지를 전달하여 특정 구성 요소를 시작하고자 하는 인텐트를
밝혀야 합니다. 그러면 시스템이 대신 해당 구성 요소를 활성화해줍니다.
구성 요소 활성화
-
네 가지 구성 요소 중 세 가지—액티비티, 서비스 및
+
네 가지 구성 요소 중 세 가지—액티비티, 서비스 및
브로드캐스트 수신기—는 일명 인텐트라고 하는 비동기식 메시지가 활성화합니다.
-인텐트는 각각의 구성 요소를 런타임에 서로 바인딩하며(다른 구성 요소로부터 작업을 요청하는
-일종의 메신저로 생각하면 됩니다), 이는 구성 요소가 여러분의 앱에 속하든 아니든
+인텐트는 각각의 구성 요소를 런타임에 서로 바인딩하며(다른 구성 요소로부터 작업을 요청하는
+일종의 메신저로 생각하면 됩니다), 이는 구성 요소가 여러분의 앱에 속하든 아니든
무관합니다.
-
인텐트는 {@link android.content.Intent} 객체로 생성되며, 이것이
-특정 구성 요소를 활성화할지 아니면 구성 요소의 특정 유형을 활성화할지를 나타내는 메시지를 정의합니다. 인텐트는
+
인텐트는 {@link android.content.Intent} 객체로 생성되며, 이것이
+특정 구성 요소를 활성화할지 아니면 구성 요소의 특정 유형을 활성화할지를 나타내는 메시지를 정의합니다. 인텐트는
각각 명시적이거나 암시적일 수 있습니다.
-
액티비티와 서비스의 경우, 인텐트는 수행할 작업을 정의하며(예를 들어 무언가를 '보기" 또는
-"보내기"), 작업을 수행할 데이터의 URI를 나타낼 수 있습니다(시작되는 구성 요소가 알아야 할 것은
-이외에도 많이 있습니다). 예를 들어, 인텐트는 액티비티에 이미지를 표시하거나 웹 페이지를 열라는 요청을
-전달할 수 있습니다. 어떤 경우에는 액티비티를 시작하여
-결과를 받아오도록 할 수 있습니다. 이런 경우 이 액티비티는
-{@link android.content.Intent}로 결과를 반환하기도 합니다(예를 들어, 사용자가
-개인적인 연락처를 선택하도록 한 다음 그것을 반환하도록 하는 인텐트를 발행할 수 있습니다—반환 인텐트에
+
액티비티와 서비스의 경우, 인텐트는 수행할 작업을 정의하며(예를 들어 무언가를 '보기" 또는
+"보내기"), 작업을 수행할 데이터의 URI를 나타낼 수 있습니다(시작되는 구성 요소가 알아야 할 것은
+이외에도 많이 있습니다). 예를 들어, 인텐트는 액티비티에 이미지를 표시하거나 웹 페이지를 열라는 요청을
+전달할 수 있습니다. 어떤 경우에는 액티비티를 시작하여
+결과를 받아오도록 할 수 있습니다. 이런 경우 이 액티비티는
+{@link android.content.Intent}로 결과를 반환하기도 합니다(예를 들어, 사용자가
+개인적인 연락처를 선택하도록 한 다음 그것을 반환하도록 하는 인텐트를 발행할 수 있습니다—반환 인텐트에
선택한 연락처를 가리키는 URI가 포함됩니다).
-
브로드캐스트 수신기의 경우, 인텐트는 단순히 브로드캐스트될 알림을
-정의할 뿐입니다(예를 들어, 기기 배터리 잔량이 낮다는 것을 나타내는 브로드캐스트에는
+
브로드캐스트 수신기의 경우, 인텐트는 단순히 브로드캐스트될 알림을
+정의할 뿐입니다(예를 들어, 기기 배터리 잔량이 낮다는 것을 나타내는 브로드캐스트에는
"배터리 부족"을 나타내는 알려진 작업 문자열만 포함됩니다).
-
남은 하나의 구성 요소 유형, 즉 콘텐츠 제공자는 인텐트가 활성화하지 않습니다. 그보다는
-{@link android.content.ContentResolver}로부터의 요청으로 지정되면 활성화됩니다. 콘텐츠
-확인자는 콘텐츠 제공자와의 모든 직접적인 트랜잭션을 처리하여
+
남은 하나의 구성 요소 유형, 즉 콘텐츠 제공자는 인텐트가 활성화하지 않습니다. 그보다는
+{@link android.content.ContentResolver}로부터의 요청으로 지정되면 활성화됩니다. 콘텐츠
+확인자는 콘텐츠 제공자와의 모든 직접적인 트랜잭션을 처리하여
제공자와의 트랜잭션을 수행하는 구성 요소가 그런 일을 하지 않아도 되게 하고, 그 대신 {@link
-android.content.ContentResolver} 객체에서 메서드를 호출합니다. 이렇게 되면 콘텐츠 제공자와
+android.content.ContentResolver} 객체에서 메서드를 호출합니다. 이렇게 되면 콘텐츠 제공자와
정보를 요청하는 구성 요소 사이에 추상화 계층이 하나 남습니다(보안 목적).
각 유형의 구성 요소를 활성화하는 데에는 각기 별도의 메서드가 있습니다.
-
액티비티를 시작하려면(아니면 무언가 새로운 할 일을 주려면)
+
액티비티를 시작하려면(아니면 무언가 새로운 할 일을 주려면)
{@link android.content.Intent}를 {@link android.content.Context#startActivity
-startActivity()} 또는 {@link android.app.Activity#startActivityForResult startActivityForResult()}에
+startActivity()} 또는 {@link android.app.Activity#startActivityForResult startActivityForResult()}에
전달하면 됩니다(액티비티가 결과를 반환하기를 원하는 경우).
-
서비스를 시작하려면(또는 진행 중인 서비스에 새로운 지침을 주려면)
+
서비스를 시작하려면(또는 진행 중인 서비스에 새로운 지침을 주려면)
{@link android.content.Intent}를 {@link android.content.Context#startService
-startService()}에 전달하면 됩니다. 아니면 {@link android.content.Intent}를
+startService()}에 전달하면 됩니다. 아니면 {@link android.content.Intent}를
{@link android.content.Context#bindService bindService()}에 전달하여 서비스에 바인딩할 수도 있습니다.
-
브로드캐스트를 시작하려면 {@link android.content.Intent}를
+
브로드캐스트를 시작하려면 {@link android.content.Intent}를
{@link android.content.Context#sendBroadcast(Intent) sendBroadcast()}, {@link
android.content.Context#sendOrderedBroadcast(Intent, String) sendOrderedBroadcast()} 또는 {@link
android.content.Context#sendStickyBroadcast sendStickyBroadcast()}와 같은 메서드에 전달하면 됩니다.
인텐트 사용에 관한 자세한 정보는 인텐트 및
-인텐트 필터문서를 참조하십시오. 특정 구성 요소를 활성화하는 데 관한 자세한 정보 또한 다음 문서에
+
인텐트 사용에 관한 자세한 정보는 인텐트 및
+인텐트 필터문서를 참조하십시오. 특정 구성 요소를 활성화하는 데 관한 자세한 정보 또한 다음 문서에
제공되어 있습니다. 액티비티, 서비스, {@link
android.content.BroadcastReceiver} 및 콘텐츠 제공자.
매니페스트 파일
-
Android 시스템이 앱 구성 요소를 시작하려면 시스템은 우선 해당 구성 요소가
+
Android 시스템이 앱 구성 요소를 시작하려면 시스템은 우선 해당 구성 요소가
존재하는지 알아야 합니다. 그러기 위해 앱의 {@code AndroidManifest.xml} 파일을 읽습니다(즉 "매니페스트"
-파일). 앱은 이 파일 안에 모든 구성 요소를 선언해야 하며, 이 파일은 앱 프로젝트 디렉터리의 루트에
+파일). 앱은 이 파일 안에 모든 구성 요소를 선언해야 하며, 이 파일은 앱 프로젝트 디렉터리의 루트에
있어야 합니다.
매니페스트는 앱의 구성 요소를 선언하는 것 이외에도 수많은 역할을 합니다.
예를 들면 다음과 같습니다.
-
앱이 요구하는 모든 사용자 권한 식별(예: 인터넷 액세스 또는 사용자의 연락처로의
+
앱이 요구하는 모든 사용자 권한 식별(예: 인터넷 액세스 또는 사용자의 연락처로의
읽기 액세스)
요소에서는,
{@code android:name} 속성이 {@link
-android.app.Activity} 하위 클래스의 완전히 정규화된 클래스 이름을 나타내며 {@code android:label} 속성은 액티비티의
+android.app.Activity} 하위 클래스의 완전히 정규화된 클래스 이름을 나타내며 {@code android:label} 속성은 액티비티의
사용자에게 표시되는 레이블로 사용할 문자열을 나타냅니다.
액티비티, 서비스를 비롯하여 소스에는 포함시키지만 매니페스트에서는 선언하지 않는
-콘텐츠 제공자는 시스템에 표시되지 않으며, 따라서 실행될 수 없습니다. 그러나
+
액티비티, 서비스를 비롯하여 소스에는 포함시키지만 매니페스트에서는 선언하지 않는
+콘텐츠 제공자는 시스템에 표시되지 않으며, 따라서 실행될 수 없습니다. 그러나
브로드캐스트
수신기는 매니페스트에서 선언해도 되고 코드를 사용해(
-{@link android.content.BroadcastReceiver} 객체로) 동적으로 생성한 다음 시스템에 등록해도 됩니다. 이때
+{@link android.content.BroadcastReceiver} 객체로) 동적으로 생성한 다음 시스템에 등록해도 됩니다. 이때
{@link android.content.Context#registerReceiver registerReceiver()}를 호출하는 방법을 씁니다.
앱에 맞는 매니페스트 파일을 구성하는 방법에 대한 자세한 내용은 AndroidManifest.xml 파일을
@@ -322,26 +322,26 @@ href="{@docRoot}guide/topics/manifest/provider-element.html"><provider>구성 요소 기능 선언
-
위에서 논한 바와 같이, 활성화 상태의 구성 요소에서는
-{@link android.content.Intent}를 사용하여 액티비티, 서비스 및 브로드캐스트 수신기를 시작할 수 있습니다. 그렇게 하려면
-대상 구성 요소를 인텐트 내에서 명시적으로 명명하면 됩니다(구성 요소 클래스 이름을 사용). 그러나,
-인텐트의 진정한 힘은 암시적 인텐트의 개념에서 발휘됩니다. 암시적 인텐트는
-그저 수행할 작업의 유형을 설명할 뿐이며(또한, 선택 사항으로, 해당 작업을 수행하고자 하는
-데이터 위치도) 시스템에 기기에서 작업을 수행할 수 있는 구성 요소를 찾아
-시작하도록 해줍니다. 인텐트가 설명한 작업을 수행할 수 있는 구성 요소가 여러 개인 경우,
+
위에서 논한 바와 같이, 활성화 상태의 구성 요소에서는
+{@link android.content.Intent}를 사용하여 액티비티, 서비스 및 브로드캐스트 수신기를 시작할 수 있습니다. 그렇게 하려면
+대상 구성 요소를 인텐트 내에서 명시적으로 명명하면 됩니다(구성 요소 클래스 이름을 사용). 그러나,
+인텐트의 진정한 힘은 암시적 인텐트의 개념에서 발휘됩니다. 암시적 인텐트는
+그저 수행할 작업의 유형을 설명할 뿐이며(또한, 선택 사항으로, 해당 작업을 수행하고자 하는
+데이터 위치도) 시스템에 기기에서 작업을 수행할 수 있는 구성 요소를 찾아
+시작하도록 해줍니다. 인텐트가 설명한 작업을 수행할 수 있는 구성 요소가 여러 개인 경우,
어느 것을 사용할지 사용자가 선택합니다.
-
시스템이 인텐트에 응답할 수 있는 구성 요소를 식별하는 방법은 수신한 인텐트를
- 인텐트 필터 와 비교하는 것입니다. 이 인텐트 필터는 기기의 다른 여러 앱의 매니페스트
+
시스템이 인텐트에 응답할 수 있는 구성 요소를 식별하는 방법은 수신한 인텐트를
+ 인텐트 필터 와 비교하는 것입니다. 이 인텐트 필터는 기기의 다른 여러 앱의 매니페스트
파일이 제공합니다.
-
앱의 매니페스트에서 액티비티를 선언하는 경우, 선택 사항으로
-해당 액티비티의 기능을 선언하는 인텐트 필터를 포함시켜서 다른 앱으로부터의 인텐트에
-응답할 수 있도록 할 수 있습니다. 구성 요소에 대한 인텐트 필터를 선언하려면
+
앱의 매니페스트에서 액티비티를 선언하는 경우, 선택 사항으로
+해당 액티비티의 기능을 선언하는 인텐트 필터를 포함시켜서 다른 앱으로부터의 인텐트에
+응답할 수 있도록 할 수 있습니다. 구성 요소에 대한 인텐트 필터를 선언하려면
{@code
<intent-filter>} 요소를 해당 구성 요소의 선언 요소 하위로 추가하면 됩니다.
-
예를 들어, 새 이메일을 작성하는 데 쓰는 액티비티가 있는 이메일 앱을 구축했다고 가정합시다. 이때 "전송" 인텐트에
+
예를 들어, 새 이메일을 작성하는 데 쓰는 액티비티가 있는 이메일 앱을 구축했다고 가정합시다. 이때 "전송" 인텐트에
응답하는 인텐트 필터를 선언하려면(새 이메일을 전송하기 위해) 다음과 같이 하면 됩니다.
<manifest ... >
@@ -360,7 +360,7 @@ href="{@docRoot}guide/topics/manifest/provider-element.html"><provider>그런 다음, 다른 앱이 {@link
android.content.Intent#ACTION_SEND} 작업을 가진 인텐트를 생성하여 그것을 {@link android.app.Activity#startActivity
-startActivity()}로 전달하면 시스템이 여러분의 액티비티를 시작하여 사용자가 이메일을 임시 보관하고 전송할 수
+startActivity()}로 전달하면 시스템이 여러분의 액티비티를 시작하여 사용자가 이메일을 임시 보관하고 전송할 수
있습니다.
인텐트 필터 생성에 관한 자세한 내용은 인텐트 및 인텐트 필터 문서를 참조하십시오.
@@ -370,16 +370,16 @@ startActivity()}로 전달하면 시스템이 여러분의 액티비티를 시
앱 요구 사항 선언
-
Android로 구동되는 기기는 수없이 많지만 모두 똑같은 특징을 갖고 같은
-기능을 제공하는 것은 아닙니다. 앱이 필요로 하는 기능이 부족한 기기에 앱을 설치하게 되는 불상사를 방지하려면,
-앱이 지원하는 기기 유형에 대한 프로필을 명확하게 정의하는 것이 중요합니다.
-그러려면 매니페스트 파일에 기기와 소프트웨어 요구 사항을
-선언하면 됩니다. 이와 같은 선언은 대부분 정보성일 뿐이며 시스템은 이를 읽지 않는 것이 일반적이지만,
-Google Play와 같은 외부 서비스는 사용자가 본인의 기기에서 앱을 검색할 때 필터링을 제공하기 위해
+
Android로 구동되는 기기는 수없이 많지만 모두 똑같은 특징을 갖고 같은
+기능을 제공하는 것은 아닙니다. 앱이 필요로 하는 기능이 부족한 기기에 앱을 설치하게 되는 불상사를 방지하려면,
+앱이 지원하는 기기 유형에 대한 프로필을 명확하게 정의하는 것이 중요합니다.
+그러려면 매니페스트 파일에 기기와 소프트웨어 요구 사항을
+선언하면 됩니다. 이와 같은 선언은 대부분 정보성일 뿐이며 시스템은 이를 읽지 않는 것이 일반적이지만,
+Google Play와 같은 외부 서비스는 사용자가 본인의 기기에서 앱을 검색할 때 필터링을 제공하기 위해
이와 같은 선언도 읽습니다.
-
예를 들어, 앱에 카메라가 필요하고 Android 2.1부터 도입된 API를 사용하는 경우(API 레벨 7)
-이과 같은 내용을 매니페스트 파일에 요구 사항으로 선언하려면 다음과 같이 합니다.
+
예를 들어, 앱에 카메라가 필요하고 Android 2.1부터 도입된 API를 사용하는 경우(API 레벨 7)
+이과 같은 내용을 매니페스트 파일에 요구 사항으로 선언하려면 다음과 같이 합니다.
<manifest ... >
@@ -390,15 +390,15 @@ Google Play와 같은 외부 서비스는 사용자가 본인의 기기에서
</manifest>
-
이제 카메라가 없고 Android 버전이 2.1 이하인 기기는
+
이제 카메라가 없고 Android 버전이 2.1 이하인 기기는
Google Play에서 여러분의 앱을 설치할 수 없습니다.
-
그러나, 앱이 카메라를 사용하기는 하지만 꼭
+
그러나, 앱이 카메라를 사용하기는 하지만 꼭
필요한 것은 아니라고 선언할 수도 있습니다. 이 경우에는, 앱이 {@code required}
- 속성을 {@code "false"}에 설정하고 런타임을 확인하여
+ 속성을 {@code "false"}에 설정하고 런타임을 확인하여
해당 기기에 카메라가 있는지, 경우에 따라 모든 카메라 기능을 비활성화할 수 있는지 알아봅니다.
-
여러 가지 기기와 앱의 호환성을 관리하는 방법에 대한 자세한 정보는
+
여러 가지 기기와 앱의 호환성을 관리하는 방법에 대한 자세한 정보는
기기 호환성
문서를 참조하십시오.
@@ -407,40 +407,40 @@ Google Play에서 여러분의 앱을 설치할 수 없습니다.
앱 리소스
Android 앱을 이루는 것은 코드만이 아닙니다. 소스 코드와는 별개인 여러 리소스가 필요합니다.
-예를 들어 이미지, 오디오 파일과 앱을 시각적으로 표현하는 것과 관련된 모든 것들이 있습니다.
-예컨대 애니메이션, 메뉴, 스타일, 색상과 액티비티 사용자 인터페이스의 레이아웃을 XML 파일로
-정의해야 합니다. 앱 리소스를 사용하면 앱의 다양한 특성을
-쉽게 업데이트할 수 있으며 코드를 수정하지 않아도 되고 일련의 대체 리소스를
-제공함으로써 다양한 기기 구성에 맞게 앱을
+예를 들어 이미지, 오디오 파일과 앱을 시각적으로 표현하는 것과 관련된 모든 것들이 있습니다.
+예컨대 애니메이션, 메뉴, 스타일, 색상과 액티비티 사용자 인터페이스의 레이아웃을 XML 파일로
+정의해야 합니다. 앱 리소스를 사용하면 앱의 다양한 특성을
+쉽게 업데이트할 수 있으며 코드를 수정하지 않아도 되고 일련의 대체 리소스를
+제공함으로써 다양한 기기 구성에 맞게 앱을
최적화할 수도 있습니다(예: 여러 가지 언어 및 화면 크기).
-
Android 프로젝트에 포함시키는 리소스마다 SDK 빌드 도구가 고유한
-정수 ID를 정의하므로, 이를 사용하여 앱 코드에서의 리소스나 XML로 정의된
+
Android 프로젝트에 포함시키는 리소스마다 SDK 빌드 도구가 고유한
+정수 ID를 정의하므로, 이를 사용하여 앱 코드에서의 리소스나 XML로 정의된
다른 리소스에서 참조할 수 있습니다. 예를 들어 앱에 {@code
-logo.png}라는 이름의 이미지 파일이 들어 있다고 하면({@code res/drawable/} 디렉터리에 저장됨) SDK 도구가
-{@code R.drawable.logo}라는 리소스 ID를 생성합니다. 이것을 사용하여 이미지를 참조하고 사용자 인터페이스에
+logo.png}라는 이름의 이미지 파일이 들어 있다고 하면({@code res/drawable/} 디렉터리에 저장됨) SDK 도구가
+{@code R.drawable.logo}라는 리소스 ID를 생성합니다. 이것을 사용하여 이미지를 참조하고 사용자 인터페이스에
삽입할 수 있습니다.
-
소스 코드와는 별개로 리소스를 제공하는 것의 가장 중요한 측면 중 하나는
-여러 가지 기기 구성에 맞게 대체 리소스를 제공할 능력을 갖추게
-됩니다. 예를 들어 UI 문자열을 XML로 정의하면 이러한 문자열을 다른 언어로 변환한 뒤
+
소스 코드와는 별개로 리소스를 제공하는 것의 가장 중요한 측면 중 하나는
+여러 가지 기기 구성에 맞게 대체 리소스를 제공할 능력을 갖추게
+됩니다. 예를 들어 UI 문자열을 XML로 정의하면 이러한 문자열을 다른 언어로 변환한 뒤
그러한 문자열을 별개의 파일에 저장할 수 있습니다. 그런 다음, 리소스 디렉터리 이름에 추가한 언어 한정자
-(예를 들어 프랑스어 문자열 값의 경우 {@code res/values-fr/}) 및
-사용자의 언어 설정을 근거로 하여 Android 시스템이 적절한 언어 문자열을 UI에
+(예를 들어 프랑스어 문자열 값의 경우 {@code res/values-fr/}) 및
+사용자의 언어 설정을 근거로 하여 Android 시스템이 적절한 언어 문자열을 UI에
적용하는 것입니다.
Android는 대체 리소스에 대해 다양한 한정자를 지원합니다. 한정자란
- 리소스 디렉터리의 이름에 포함시키는 짧은 문자열로, 이를 사용해 해당 리소스를 사용할 기기 구성을
-정의합니다. 또 다른 예를 들자면,
-기기의 화면 방향과 크기에 따라 액티비티에 여러 가지 레이아웃을 생성해야 할 때가
-많습니다. 예를 들어 기기 화면이 세로
-방향(키가 큼)인 경우, 버튼이 세로 방향으로 되어 있는 레이아웃을 사용하는 것이 좋지만 화면이
-가로 방향(폭이 넓음)인 경우, 버튼이 가로 방향으로 정렬되어야 합니다. 방향에 따라 레이아웃을 변경하려면,
-서로 다른 두 가지 레이아웃을 정의하여 적절한 한정자를 각각의 레이아웃의 디렉터리 이름에
-적용하면 됩니다. 그러면 시스템이 현재 기기 방향에 따라 적절한 레이아웃을
+ 리소스 디렉터리의 이름에 포함시키는 짧은 문자열로, 이를 사용해 해당 리소스를 사용할 기기 구성을
+정의합니다. 또 다른 예를 들자면,
+기기의 화면 방향과 크기에 따라 액티비티에 여러 가지 레이아웃을 생성해야 할 때가
+많습니다. 예를 들어 기기 화면이 세로
+방향(키가 큼)인 경우, 버튼이 세로 방향으로 되어 있는 레이아웃을 사용하는 것이 좋지만 화면이
+가로 방향(폭이 넓음)인 경우, 버튼이 가로 방향으로 정렬되어야 합니다. 방향에 따라 레이아웃을 변경하려면,
+서로 다른 두 가지 레이아웃을 정의하여 적절한 한정자를 각각의 레이아웃의 디렉터리 이름에
+적용하면 됩니다. 그러면 시스템이 현재 기기 방향에 따라 적절한 레이아웃을
자동으로 적용합니다.
-
애플리케이션에 포함할 수 있는 여러 가지 종류의 리소스와, 각기 다른 기기 구성에 따라
+
애플리케이션에 포함할 수 있는 여러 가지 종류의 리소스와, 각기 다른 기기 구성에 따라
대체 리소스를 생성하는 방법에 대한 자세한 내용은 리소스 제공을 읽어보십시오.
@@ -451,15 +451,15 @@ logo.png}라는 이름의 이미지 파일이 들어 있다고 하면({@code res
Android가 특정 API에 대한 앱의 액세스를 제한하기 위해 권한 시스템을
사용하는 방법으로, 그러한 API를 사용하려면 앱에 대해 사용자의 승인이 필요합니다.
diff --git a/docs/html-intl/intl/ko/guide/components/index.jd b/docs/html-intl/intl/ko/guide/components/index.jd
index 36626324e8178..a860c0f5349f9 100644
--- a/docs/html-intl/intl/ko/guide/components/index.jd
+++ b/docs/html-intl/intl/ko/guide/components/index.jd
@@ -1,7 +1,7 @@
page.title=앱 구성 요소
page.landing=true
-page.landing.intro=Android의 애플리케이션 프레임워크는 일련의 재사용 가능한 구성 요소를 사용하여 풍성하고 혁신적인 앱을 생성할 수 있습니다. 이 섹션에서는 앱의 구성 단위를 정의 내리는 구성 요소를 구축하는 방법과 인텐트를 사용하여 이와 같은 구성 요소를 연결시키는 법을 설명합니다.
-page.metaDescription=Android의 애플리케이션 프레임워크는 일련의 재사용 가능한 구성 요소를 사용하여 풍성하고 혁신적인 앱을 생성할 수 있습니다. 이 섹션에서는 앱의 구성 단위를 정의 내리는 구성 요소를 구축하는 방법과 인텐트를 사용하여 이와 같은 구성 요소를 연결시키는 법을 설명합니다.
+page.landing.intro=Android의 애플리케이션 프레임워크는 일련의 재사용 가능한 구성 요소를 사용하여 풍성하고 혁신적인 앱을 생성할 수 있습니다. 이 섹션에서는 앱의 구성 단위를 정의 내리는 구성 요소를 구축하는 방법과 인텐트를 사용하여 이와 같은 구성 요소를 연결시키는 법을 설명합니다.
+page.metaDescription=Android의 애플리케이션 프레임워크는 일련의 재사용 가능한 구성 요소를 사용하여 풍성하고 혁신적인 앱을 생성할 수 있습니다. 이 섹션에서는 앱의 구성 단위를 정의 내리는 구성 요소를 구축하는 방법과 인텐트를 사용하여 이와 같은 구성 요소를 연결시키는 법을 설명합니다.
page.landing.image=images/develop/app_components.png
page.image=images/develop/app_components.png
@@ -11,7 +11,7 @@ page.image=images/develop/app_components.png
로더는 Android 3.0부터 도입된 것으로, 액티비티 또는 프래그먼트에서 비동기식으로 데이터를 쉽게
+
로더는 Android 3.0부터 도입된 것으로, 액티비티 또는 프래그먼트에서 비동기식으로 데이터를 쉽게
로딩할 수 있게 합니다. 로더의 특성은 다음과 같습니다.
모든 {@link android.app.Activity}와 {@link
android.app.Fragment}에 사용할 수 있습니다.
데이터의 비동기식 로딩을 제공합니다.
-
데이터의 출처를 모니터링하여 그 콘텐츠가 변경되면 새 결과를
+
데이터의 출처를 모니터링하여 그 콘텐츠가 변경되면 새 결과를
전달합니다.
-
구성 변경 후에 재생성된 경우, 마지막 로더의 커서로 자동으로
-다시 연결됩니다. 따라서 데이터를 다시 쿼리하지 않아도
+
구성 변경 후에 재생성된 경우, 마지막 로더의 커서로 자동으로
+다시 연결됩니다. 따라서 데이터를 다시 쿼리하지 않아도
됩니다.
-
+
로더 API 요약
-
애플리케이션 안에서 로더를 사용하는 데 관련된 클래스와 인터페이스는
+
애플리케이션 안에서 로더를 사용하는 데 관련된 클래스와 인터페이스는
여러 가지가 있습니다. 다음 표에서 요약되어 있습니다.
@@ -64,16 +64,16 @@ android.app.Fragment}에 사용할 수 있습니다.
{@link android.app.LoaderManager}
-
{@link android.app.Activity} 또는
+
{@link android.app.Activity} 또는
{@link android.app.Fragment}와 연관된 추상 클래스로, 하나 이상의 {@link
-android.content.Loader} 인스턴스를 관리하는 데 쓰입니다. 이것을 사용하면 애플리케이션이
+android.content.Loader} 인스턴스를 관리하는 데 쓰입니다. 이것을 사용하면 애플리케이션이
{@link android.app.Activity}
- 또는 {@link android.app.Fragment} 수명 주기와 함께 실행 시간이 긴 작업을 관리하는 데 도움이 됩니다. 이것의 가장 보편적인 용법은
-{@link android.content.CursorLoader}와 함께 사용하는 것이지만,
+ 또는 {@link android.app.Fragment} 수명 주기와 함께 실행 시간이 긴 작업을 관리하는 데 도움이 됩니다. 이것의 가장 보편적인 용법은
+{@link android.content.CursorLoader}와 함께 사용하는 것이지만,
다른 유형의 데이터를 로드하기 위해 애플리케이션이 자체 로더를 작성하는 것도 얼마든지 가능합니다.
- 액티비티 또는 프래그먼트당 {@link android.app.LoaderManager}는 하나씩밖에 없습니다. 하지만 {@link android.app.LoaderManager}에는 로더가 여러 개 있어도
+ 액티비티 또는 프래그먼트당 {@link android.app.LoaderManager}는 하나씩밖에 없습니다. 하지만 {@link android.app.LoaderManager}에는 로더가 여러 개 있어도
됩니다.
데이터의 비동기식 로딩을 수행하는 추상 클래스입니다. 이것이 로더의 기본
클래스입니다. 보통은 {@link
-android.content.CursorLoader}를 사용하기 마련이지만, 자신만의 하위 클래스를 구현해도 됩니다. 로더가 활성 상태인 동안에는
-소속 데이터의 출처를 모니터링하고 콘텐츠가 변경되면 새 결과를
+android.content.CursorLoader}를 사용하기 마련이지만, 자신만의 하위 클래스를 구현해도 됩니다. 로더가 활성 상태인 동안에는
+소속 데이터의 출처를 모니터링하고 콘텐츠가 변경되면 새 결과를
전달하는 것이 정상입니다.
@@ -97,118 +97,118 @@ android.content.CursorLoader}를 사용하기 마련이지만, 자신만의 하
{@link android.content.CursorLoader}
-
{@link android.content.AsyncTaskLoader}의 하위 클래스로, 이것이
+
{@link android.content.AsyncTaskLoader}의 하위 클래스로, 이것이
{@link android.content.ContentResolver}를 쿼리하고 {@link
android.database.Cursor}를 반환합니다. 이 클래스는 커서 쿼리에 대한 표준 방식으로 {@link
-android.content.Loader} 프로토콜을 구현하며,
-{@link android.content.AsyncTaskLoader}에 구축되어
-배경 스레드에서 커서 쿼리를 수행하므로 애플리케이션의 UI를 차단하지 않습니다.
+android.content.Loader} 프로토콜을 구현하며,
+{@link android.content.AsyncTaskLoader}에 구축되어
+배경 스레드에서 커서 쿼리를 수행하므로 애플리케이션의 UI를 차단하지 않습니다.
이 로더를 사용하는 것이 프래그먼트나 액티비티의 API를 통해 관리된 쿼리를 수행하는 대신 {@link
-android.content.ContentProvider}에서
+android.content.ContentProvider}에서
비동기식으로 데이터를 로딩하는 최선의 방법입니다.
-
위의 표에 나열된 클래스와 인터페이스가 애플리케이션 내에서 로더를 구현하는 데
-사용할 기본적인 구성 요소입니다. 생성하는 로더마다
+
위의 표에 나열된 클래스와 인터페이스가 애플리케이션 내에서 로더를 구현하는 데
+사용할 기본적인 구성 요소입니다. 생성하는 로더마다
이 모든 것이 다 필요한 것은 아니지만, 로더를 초기화하려면 항상 {@link
android.app.LoaderManager}를 참조해야 하고 {@link
-android.content.CursorLoader}와 같은 {@link android.content.Loader}
-클래스도 구현해야 합니다. 다음 몇 섹션에서는 애플리케이션 안에서 이와 같은
+android.content.CursorLoader}와 같은 {@link android.content.Loader}
+클래스도 구현해야 합니다. 다음 몇 섹션에서는 애플리케이션 안에서 이와 같은
클래스와 인터페이스를 사용하는 법을 보여줍니다.
애플리케이션 안에서 로더 사용하기
-
이 섹션에서는 Android 애플리케이션 내에서 로더를 사용하는 방법을 설명합니다. 로더를
+
이 섹션에서는 Android 애플리케이션 내에서 로더를 사용하는 방법을 설명합니다. 로더를
사용하는 애플리케이션에는 보통 다음이 포함되어 있습니다.
{@link android.app.Activity} 또는 {@link android.app.Fragment}.
{@link android.app.LoaderManager}의 인스턴스.
{@link
-android.content.ContentProvider}가 지원하는 데이터를 로딩할 {@link android.content.CursorLoader}. 아니면, 개발자 나름의
-{@link android.content.Loader} 또는 {@link android.content.AsyncTaskLoader} 하위 클래스를 구현하여
+android.content.ContentProvider}가 지원하는 데이터를 로딩할 {@link android.content.CursorLoader}. 아니면, 개발자 나름의
+{@link android.content.Loader} 또는 {@link android.content.AsyncTaskLoader} 하위 클래스를 구현하여
다른 출처에서 데이터를 로딩해도 됩니다.
{@link android.app.LoaderManager.LoaderCallbacks}의 구현.
-여기에서 새 로더를 생성하고 기존 로더에 대한 참조를
-관리합니다.
+여기에서 새 로더를 생성하고 기존 로더에 대한 참조를
+관리합니다.
로더의 데이터를 표시하는 방법(예: {@link
android.widget.SimpleCursorAdapter})
-
{@link android.content.ContentProvider}와 같은 데이터 출처로,
+
{@link android.content.ContentProvider}와 같은 데이터 출처로,
{@link android.content.CursorLoader}를 사용하는 경우에 해당.
로더 시작
-
{@link android.app.LoaderManager}는 {@link android.app.Activity} 또는
+
{@link android.app.LoaderManager}는 {@link android.app.Activity} 또는
{@link android.app.Fragment} 내에서 하나 이상의 {@link
android.content.Loader} 인스턴스를 관리합니다. 액티비티 또는 프래그먼트당 {@link
-android.app.LoaderManager}는 하나씩밖에 없습니다.
+android.app.LoaderManager}는 하나씩밖에 없습니다.
-
보통은
+
보통은
액티비티의 {@link
-android.app.Activity#onCreate onCreate()} 메서드 내에서, 또는 프래그먼트의
-{@link android.app.Fragment#onActivityCreated onActivityCreated()} 메서드 내에서 {@link android.content.Loader}를 초기화합니다. 이렇게 하려면
+android.app.Activity#onCreate onCreate()} 메서드 내에서, 또는 프래그먼트의
+{@link android.app.Fragment#onActivityCreated onActivityCreated()} 메서드 내에서 {@link android.content.Loader}를 초기화합니다. 이렇게 하려면
다음과 같은 방법을 따릅니다.
// Prepare the loader. Either re-connect with an existing one,
// or start a new one.
getLoaderManager().initLoader(0, null, this);
{@link android.app.LoaderManager#initLoader initLoader()} 메서드는
다음과 같은 인수를 취합니다.
로더를 식별하는 고유한 ID. 이 예시에서 ID는 0입니다.
생성 시 로더에 제공할 선택적 인수
-(이 예시에서는 null).
+(이 예시에서는 null).
-
{@link android.app.LoaderManager.LoaderCallbacks} 구현. 로더 이벤트를 보고하기 위해
+
{@link android.app.LoaderManager.LoaderCallbacks} 구현. 로더 이벤트를 보고하기 위해
{@link android.app.LoaderManager}가 이것을 호출합니다. 이 예시에서는
로컬 클래스가 {@link
-android.app.LoaderManager.LoaderCallbacks} 인터페이스를 구현하여 자신에 대한 참조인
-{@code this}를 통과합니다.
+android.app.LoaderManager.LoaderCallbacks} 인터페이스를 구현하여 자신에 대한 참조인
+{@code this}를 통과합니다.
{@link android.app.LoaderManager#initLoader initLoader()} 호출로 로더가 초기화되었고 활성 상태이도록
확실히 합니다. 이로써 발생할 수 있는 결과가 두 가지 있습니다.
-
ID가 지정한 로더가 이미 존재하는 경우, 마지막으로 생성된 로더를
+
ID가 지정한 로더가 이미 존재하는 경우, 마지막으로 생성된 로더를
재사용합니다.
-
ID가 지정한 로더가 존재하지 않는 경우,
-{@link android.app.LoaderManager#initLoader initLoader()}가
-{@link android.app.LoaderManager.LoaderCallbacks} 메서드 {@link android.app.LoaderManager.LoaderCallbacks#onCreateLoader onCreateLoader()}를 발생시킵니다.
+
ID가 지정한 로더가 존재하지 않는 경우,
+{@link android.app.LoaderManager#initLoader initLoader()}가
+{@link android.app.LoaderManager.LoaderCallbacks} 메서드 {@link android.app.LoaderManager.LoaderCallbacks#onCreateLoader onCreateLoader()}를 발생시킵니다.
여기에서 인스턴트화할 코드를 구현하고 새 로더를 반환합니다.
자세한 논의는 onCreateLoader 섹션을 참조하십시오.
어떤 경우에든 주어진 {@link android.app.LoaderManager.LoaderCallbacks}
-구현은 해당 로더와 연관되어 있으며, 로더 상태가 변경되면
-이것이 호출됩니다. 이 호출의 그러한 시점에서 발신자가
-시작된 상태에 있으며 요청한 로더가 이미 존재하고 자신의 데이터를
+구현은 해당 로더와 연관되어 있으며, 로더 상태가 변경되면
+이것이 호출됩니다. 이 호출의 그러한 시점에서 발신자가
+시작된 상태에 있으며 요청한 로더가 이미 존재하고 자신의 데이터를
생성해 놓은 경우, 시스템은 즉시 {@link
-android.app.LoaderManager.LoaderCallbacks#onLoadFinished onLoadFinished()}를
-호출합니다({@link android.app.LoaderManager#initLoader initLoader()} 도중).
+android.app.LoaderManager.LoaderCallbacks#onLoadFinished onLoadFinished()}를
+호출합니다({@link android.app.LoaderManager#initLoader initLoader()} 도중).
따라서 이런 일이 발생할 것에 대비해두어야만 합니다. 이 콜백에 대한 자세한 논의는
onLoadFinished를 참조하십시오.
{@link android.app.LoaderManager#initLoader initLoader()}
-메서드는 생성된 {@link android.content.Loader}를 반환하지만, 이에 대한 참조를 캡처하지 않아도 된다는 점을
-유의하십시오. {@link android.app.LoaderManager}는 로더의 수명을
-자동으로 관리합니다. {@link android.app.LoaderManager}는
-필요에 따라 로딩을 시작하고 중단하며, 로더와 그에 연관된 콘텐츠의 상태를
-유지관리합니다. 이것이 시사하는 바와 같이, 로더와 직접적으로
-상호 작용하는 경우는 극히 드뭅니다(다만, 로더의 행동을 미세하게 조정하기 위해 로더 메서드를 사용하는 사례를 알아보려면
- LoaderThrottle 샘플을 참조하면 좋습니다).
+메서드는 생성된 {@link android.content.Loader}를 반환하지만, 이에 대한 참조를 캡처하지 않아도 된다는 점을
+유의하십시오. {@link android.app.LoaderManager}는 로더의 수명을
+자동으로 관리합니다. {@link android.app.LoaderManager}는
+필요에 따라 로딩을 시작하고 중단하며, 로더와 그에 연관된 콘텐츠의 상태를
+유지관리합니다. 이것이 시사하는 바와 같이, 로더와 직접적으로
+상호 작용하는 경우는 극히 드뭅니다(다만, 로더의 행동을 미세하게 조정하기 위해 로더 메서드를 사용하는 사례를 알아보려면
+ LoaderThrottle 샘플을 참조하면 좋습니다).
가장 보편적으로 사용되는 메서드는 {@link
-android.app.LoaderManager.LoaderCallbacks}로, 이를 사용해 특정한 이벤트가 일어났을 때
+android.app.LoaderManager.LoaderCallbacks}로, 이를 사용해 특정한 이벤트가 일어났을 때
로딩 프로세스에 개입하게 됩니다. 이 주제에 대한 자세한 논의는 LoaderManager 콜백 사용하기를 참조하십시오.
로더 다시 시작
-
위에서 나타난 것과 같이 {@link android.app.LoaderManager#initLoader initLoader()}를 사용하는 경우,
-이것은 지정된 ID에 해당되는 기존 로더가 있으면 그것을 사용합니다.
-없으면, 하나 생성합니다. 하지만 때로는 오래된 데이터를 폐기하고 새로 시작하고 싶을 때가
+
위에서 나타난 것과 같이 {@link android.app.LoaderManager#initLoader initLoader()}를 사용하는 경우,
+이것은 지정된 ID에 해당되는 기존 로더가 있으면 그것을 사용합니다.
+없으면, 하나 생성합니다. 하지만 때로는 오래된 데이터를 폐기하고 새로 시작하고 싶을 때가
있습니다.
오래된 데이터를 폐기하려면 {@link
-android.app.LoaderManager#restartLoader restartLoader()}를 사용합니다. 예를 들어, 다음의
-{@link android.widget.SearchView.OnQueryTextListener} 구현은
-사용자의 쿼리가 변경되면 로더를 다시 시작합니다. 로더를 다시 시작해야 수정된 검색 필터를 사용하여
+android.app.LoaderManager#restartLoader restartLoader()}를 사용합니다. 예를 들어, 다음의
+{@link android.widget.SearchView.OnQueryTextListener} 구현은
+사용자의 쿼리가 변경되면 로더를 다시 시작합니다. 로더를 다시 시작해야 수정된 검색 필터를 사용하여
새 쿼리를 수행할 수 있습니다.
@@ -223,18 +223,18 @@ public boolean onQueryTextChanged(String newText) {
{@link android.app.LoaderManager.LoaderCallbacks}는 클라이언트가
{@link android.app.LoaderManager}와 상호 작용할 수 있게 해주는 콜백 인터페이스입니다.
-
로더, 특히 {@link android.content.CursorLoader}는 중단된 후에도
-자신의 데이터를 유지할 것으로 기대됩니다. 이 때문에 애플리케이션이
+
로더, 특히 {@link android.content.CursorLoader}는 중단된 후에도
+자신의 데이터를 유지할 것으로 기대됩니다. 이 때문에 애플리케이션이
액티비티 또는 프래그먼트의 @link android.app.Activity#onStop
-onStop()} 및 {@link android.app.Activity#onStart onStart()}를 가로질러 데이터를 유지할 수 있고,
-따라서 사용자가 애플리케이션에 되돌아오면 데이터가 다시 로딩되기를 기다리지
-않아도 됩니다. 새 로더를 언제 생성해야 할지 알아보려면 {@link android.app.LoaderManager.LoaderCallbacks}
-메서드를 사용합니다. 또한 로더의 데이터 사용을 중단할 때가 되면
+onStop()} 및 {@link android.app.Activity#onStart onStart()}를 가로질러 데이터를 유지할 수 있고,
+따라서 사용자가 애플리케이션에 되돌아오면 데이터가 다시 로딩되기를 기다리지
+않아도 됩니다. 새 로더를 언제 생성해야 할지 알아보려면 {@link android.app.LoaderManager.LoaderCallbacks}
+메서드를 사용합니다. 또한 로더의 데이터 사용을 중단할 때가 되면
이를 애플리케이션에 알리는 데에도 이것을 사용할 수 있습니다.
-
{@link android.app.LoaderManager.LoaderCallbacks}에는 다음과 같은 메서드가
+
{@link android.app.LoaderManager.LoaderCallbacks}에는 다음과 같은 메서드가
포함됩니다.
{@link android.app.LoaderManager.LoaderCallbacks#onCreateLoader onCreateLoader()} -
@@ -246,7 +246,7 @@ onStop()} 및 {@link android.app.Activity#onStart onStart()}를 가로질러 데
{@link android.app.LoaderManager.LoaderCallbacks#onLoaderReset onLoaderReset()}
-- 이전에 생성된 로더가 휴식 중이라서 해당되는 데이터를 사용할 수 없을 경우
+- 이전에 생성된 로더가 휴식 중이라서 해당되는 데이터를 사용할 수 없을 경우
호출됩니다.
@@ -255,32 +255,32 @@ onStop()} 및 {@link android.app.Activity#onStart onStart()}를 가로질러 데
onCreateLoader
로더에 액세스하려 시도하는 경우(예를 들어 {@link
-android.app.LoaderManager#initLoader initLoader()}를 통해), 로더는 해당 ID가 지정하는 로더가 존재하는지
+android.app.LoaderManager#initLoader initLoader()}를 통해), 로더는 해당 ID가 지정하는 로더가 존재하는지
여부를 확인합니다. 그런 로더가 없으면, {@link
android.app.LoaderManager.LoaderCallbacks} 메서드 {@link
-android.app.LoaderManager.LoaderCallbacks#onCreateLoader onCreateLoader()}를 발생시킵니다. 여기에서
+android.app.LoaderManager.LoaderCallbacks#onCreateLoader onCreateLoader()}를 발생시킵니다. 여기에서
새 로더를 생성합니다. 이것은 보통 {@link
android.content.CursorLoader}이지만, 개발자 나름대로 {@link
android.content.Loader} 하위 클래스를 구현해도 됩니다.
이 예시에서는, {@link
android.app.LoaderManager.LoaderCallbacks#onCreateLoader onCreateLoader()}
- 콜백 메서드가 {@link android.content.CursorLoader}를 생성합니다.
-{@link android.content.CursorLoader}를 자체 생성자 메서드를 사용하여 구축해야 합니다. 이것은
+ 콜백 메서드가 {@link android.content.CursorLoader}를 생성합니다.
+{@link android.content.CursorLoader}를 자체 생성자 메서드를 사용하여 구축해야 합니다. 이것은
{@link
android.content.ContentProvider}로 쿼리를 수행하기 위해 필요한 모든 정보 집합을 필요로 합니다. 구체적으로 필요한 것은 다음과 같습니다.
uri — 검색할 콘텐츠의 URI입니다.
-
예측 — 반환할 열 목록입니다.
+
예측 — 반환할 열 목록입니다.
null을 전달하면 모든 열을 반환하며, 이는 비효율적입니다.
-
선택 — 반환할 행을 선언하는 필터로,
-SQL WHERE 절로 형식이 설정됩니다(WHERE 자체는 제외).
+
선택 — 반환할 행을 선언하는 필터로,
+SQL WHERE 절로 형식이 설정됩니다(WHERE 자체는 제외).
null을 반환하면 주어진 URI에 대한 모든 행을 반환합니다.
-
selectionArgs — 선택에 ?를 포함해도 됩니다. 이렇게 하면
-이것이 selectionArgs에서 가져온 값으로 교체되며, 이때 선택에 표시되는
+
selectionArgs — 선택에 ?를 포함해도 됩니다. 이렇게 하면
+이것이 selectionArgs에서 가져온 값으로 교체되며, 이때 선택에 표시되는
순서를 따릅니다. 값은 문자열로 바인딩됩니다.
-
sortOrder — SQL ORDER BY 절 형식으로 설정된
-행의 순서 지정 방법입니다(ORDER BY 자체는 제외). null을
+
sortOrder — SQL ORDER BY 절 형식으로 설정된
+행의 순서 지정 방법입니다(ORDER BY 자체는 제외). null을
전달하면 기본 정렬 순서를 사용하는데, 이는 순서가 없습니다.
이 메서드는 이전에 생성된 로더가 로딩을 완료하면 호출됩니다.
-이 로더에 대해 제공된 마지막 데이터가 릴리스되기 전에 틀림없이
-이 메서드가 호출됩니다. 이 시점에서 오래된 데이터의
-사용 내용을 모두 제거해야 하지만(곧 릴리스될 것이므로), 데이터 릴리스를 직접 수행해서는 안 됩니다. 해당 데이터는
+
이 메서드는 이전에 생성된 로더가 로딩을 완료하면 호출됩니다.
+이 로더에 대해 제공된 마지막 데이터가 릴리스되기 전에 틀림없이
+이 메서드가 호출됩니다. 이 시점에서 오래된 데이터의
+사용 내용을 모두 제거해야 하지만(곧 릴리스될 것이므로), 데이터 릴리스를 직접 수행해서는 안 됩니다. 해당 데이터는
로더의 소유이며, 로더가 알아서 처리할 것이기 때문입니다.
-
로더는 애플리케이션이 데이터를 더 이상 사용하지 않는다는 사실을 알게 되면 곧바로 해당 데이터를
+
로더는 애플리케이션이 데이터를 더 이상 사용하지 않는다는 사실을 알게 되면 곧바로 해당 데이터를
릴리스할 것입니다. 예를 들어 데이터가 {@link
android.content.CursorLoader}의 커서인 경우, 거기에서 직접 {@link
-android.database.Cursor#close close()}를 호출하면 안 됩니다. 커서가
+android.database.Cursor#close close()}를 호출하면 안 됩니다. 커서가
{@link android.widget.CursorAdapter}에 배치되는 경우, {@link
-android.widget.SimpleCursorAdapter#swapCursor swapCursor()} 메서드를 사용해야 합니다. 그래야
+android.widget.SimpleCursorAdapter#swapCursor swapCursor()} 메서드를 사용해야 합니다. 그래야
오래된 {@link android.database.Cursor}가 종료되지 않습니다. 예:
이 메서드는 이전에 생성된 로더가 휴식 중이라서 해당되는 데이터를 사용할 수 없는 경우
-호출됩니다. 이 콜백을 사용하면 데이터가 언제 릴리스될지 알아낼 수 있어
+
이 메서드는 이전에 생성된 로더가 휴식 중이라서 해당되는 데이터를 사용할 수 없는 경우
+호출됩니다. 이 콜백을 사용하면 데이터가 언제 릴리스될지 알아낼 수 있어
이에 대한 참조를 직접 제거할 수 있습니다.
-
이 구현은
-{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}를 호출하며,
+
이 구현은
+{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}를 호출하며,
이때 값은 null을 씁니다.
@@ -363,12 +363,12 @@ public void onLoaderReset(Loader<Cursor> loader) {
예
일례를 제시하기 위해 아래에 {@link android.widget.ListView}를 표시하는 {@link
-android.app.Fragment}의 전체 구현을 나타내었습니다. 여기에는
+android.app.Fragment}의 전체 구현을 나타내었습니다. 여기에는
연락처 콘텐츠 제공자에 대한 쿼리 결과가 들어 있습니다. 이것은 {@link
android.content.CursorLoader}를 사용하여 제공자에 대한 쿼리를 관리합니다.
-
-
이 예시에서 나타낸 바와 같이 애플리케이션이 사용자의 연락처에 액세스하려면
-애플리케이션의 매니페스트에
+
+
이 예시에서 나타낸 바와 같이 애플리케이션이 사용자의 연락처에 액세스하려면
+애플리케이션의 매니페스트에
{@link android.Manifest.permission#READ_CONTACTS READ_CONTACTS} 권한이 포함되어 있어야 합니다.
@@ -479,16 +479,16 @@ public static class CursorLoaderListFragment extends ListFragment
}
추가 예
-
로더를 사용하는 법을 보여주는 몇 가지 다른 예가 ApiDemos에
+
로더를 사용하는 법을 보여주는 몇 가지 다른 예가 ApiDemos에
소개되어 있습니다.
-LoaderCursor — 위에 표시된 코드 조각의 완전한
+LoaderCursor — 위에 표시된 코드 조각의 완전한
버전입니다.
diff --git a/docs/html-intl/intl/ko/guide/components/processes-and-threads.jd b/docs/html-intl/intl/ko/guide/components/processes-and-threads.jd
index 850d55cf9c71d..cad4917a8c43f 100644
--- a/docs/html-intl/intl/ko/guide/components/processes-and-threads.jd
+++ b/docs/html-intl/intl/ko/guide/components/processes-and-threads.jd
@@ -28,10 +28,10 @@ page.tags=수명 주기, 배경
애플리케이션 구성 요소가 시작되고 애플리케이션에 실행 중인 다른 구성 요소가 없으면
Android 시스템은 하나의 실행 스레드로 애플리케이션의 Linux 프로세스를
시작합니다. 기본적으로 같은 애플리케이션의 모든 구성 요소는 같은 프로세스와 스레드에서 실행됩니다
-("기본" 스레드라고 합니다). 애플리케이션 구성 요소가 시작되고 (애플리케이션의 다른 구성 요소가 존재해서)
+("기본" 스레드라고 합니다). 애플리케이션 구성 요소가 시작되고 (애플리케이션의 다른 구성 요소가 존재해서)
해당 애플리케이션의 프로세스가 이미 존재하면 해당 구성 요소는
-프로세스 내에서 시작되고 같은 실행 스레드를 사용합니다. 하지만 애플리케이션 내의
-여러 가지 구성 요소가 각자 별도의 프로세스에서 실행되도록 할 수도 있고, 어느 프로세스에든 추가 스레드를
+프로세스 내에서 시작되고 같은 실행 스레드를 사용합니다. 하지만 애플리케이션 내의
+여러 가지 구성 요소가 각자 별도의 프로세스에서 실행되도록 할 수도 있고, 어느 프로세스에든 추가 스레드를
만들 수 있습니다.
이 문서는 프로세스와 스레드가 Android 애플리케이션에서 작동하는 방식을 설명합니다.
@@ -48,8 +48,8 @@ Android 시스템은 하나의 실행 스레드로 애플리케이션의 Linux
<service>}, {@code
<receiver>} 및 {@code
<provider>}—의 각 유형에 대한 매니페스트 항목은 구성 요소를 실행할 프로세스를 지정하는 {@code android:process} 속성을 지원합니다.
- 이러한 속성을 설정하여 각 구성 요소를 자체 프로세스에서 실행시키거나
-다른 구성 요소를 제외한 일부 구성 요소만 프로세스를 공유하게 할 수 있습니다 또한,
+ 이러한 속성을 설정하여 각 구성 요소를 자체 프로세스에서 실행시키거나
+다른 구성 요소를 제외한 일부 구성 요소만 프로세스를 공유하게 할 수 있습니다 또한,
{@code android:process}를 설정하여 다른 애플리케이션의 구성 요소를 같은 프로세스에서 실행시킬 수 있습니다.
단, 이는 애플리케이션이 같은 Linux 사용자 ID를 공유하고 같은 인증서에
서명되었을 경우에 한합니다.
@@ -58,35 +58,35 @@ Android 시스템은 하나의 실행 스레드로 애플리케이션의 Linux
<application>} 요소도 {@code android:process} 속성을 지원하여,
모든 구성 요소에 적용되는 기본값을 설정합니다.
-
Android는 어느 시점엔가 프로세스를 종료하기로 결정할 수도 있습니다. 즉 메모리가 부족하거나, 사용자에게 더욱 즉각적인 서비스를 제공하는
-다른 프로세스가 이 프로세스의 중단을 필요로 하는 경우 등입니다. 그러면 중단된
-프로세스에서 실행되고 있던 애플리케이션 구성 요소도 따라서 소멸됩니다. 그와 같은 구성 요소가 할 작업이 다시 생기면
+
Android는 어느 시점엔가 프로세스를 종료하기로 결정할 수도 있습니다. 즉 메모리가 부족하거나, 사용자에게 더욱 즉각적인 서비스를 제공하는
+다른 프로세스가 이 프로세스의 중단을 필요로 하는 경우 등입니다. 그러면 중단된
+프로세스에서 실행되고 있던 애플리케이션 구성 요소도 따라서 소멸됩니다. 그와 같은 구성 요소가 할 작업이 다시 생기면
그에 대한 프로세스도 다시 시작됩니다.
-
어느 프로세스를 삭제할지 결정할 때, Android 시스템은
-사용자에 대한 이들의 상대적 중요성을 가늠합니다. 예를 들어, 눈에 보이는 액티비티를 호스팅하는 프로세스와 비교하여
-화면에 보이지 않는 액티비티를 호스팅하는 프로세스를 쉽게 종료할 수 있습니다. 프로세스 종료 결정은
-해당 프로세스에서 실행되는 구성 요소의 상태에 따라 달라집니다. 종료할
+
어느 프로세스를 삭제할지 결정할 때, Android 시스템은
+사용자에 대한 이들의 상대적 중요성을 가늠합니다. 예를 들어, 눈에 보이는 액티비티를 호스팅하는 프로세스와 비교하여
+화면에 보이지 않는 액티비티를 호스팅하는 프로세스를 쉽게 종료할 수 있습니다. 프로세스 종료 결정은
+해당 프로세스에서 실행되는 구성 요소의 상태에 따라 달라집니다. 종료할
프로세스를 결정하는 데 사용하는 규칙은 아래에 설명되어 있습니다.
프로세스 수명 주기
Android 시스템은 최대한 오래 애플리케이션 프로세스를 유지하려고 시도하지만,
-결국 오래된 프로세스를 제거하고 새 프로세스나 더 중요한 프로세스에 사용할 메모리를 확보해야 합니다. 유지할
+결국 오래된 프로세스를 제거하고 새 프로세스나 더 중요한 프로세스에 사용할 메모리를 확보해야 합니다. 유지할
프로세스와 종료할 프로세스를 결정하기 위해
-시스템은 프로세스에서 실행되는 구성 요소와 해당 구성 요소의 상태에 기초하여 각 프로세스에
-"중요 계층"을 부여합니다. 중요도가 낮은
+시스템은 프로세스에서 실행되는 구성 요소와 해당 구성 요소의 상태에 기초하여 각 프로세스에
+"중요 계층"을 부여합니다. 중요도가 낮은
프로세스가 먼저 제거되고, 그 다음으로 중요도가 낮은 프로세스를 제거하는 식으로
필요에 따라 시스템 리소스를 회복하는 것입니다.
-
중요 계층에는 다섯 가지 단계가 있습니다. 다음 목록은
-중요도 순서에 따른 프로세스 유형을 나타낸 것입니다(첫 번째 프로세스가 가장 중요하고
+
중요 계층에는 다섯 가지 단계가 있습니다. 다음 목록은
+중요도 순서에 따른 프로세스 유형을 나타낸 것입니다(첫 번째 프로세스가 가장 중요하고마지막으로 종료됩니다).
전경 프로세스
-
사용자가 현재 진행하는 작업에 필요한 프로세스입니다. 다음 조건 중
+
사용자가 현재 진행하는 작업에 필요한 프로세스입니다. 다음 조건 중
하나가 참일 경우 프로세스가 전경에 있는 것으로 간주합니다.
@@ -108,19 +108,19 @@ onStart()} 또는 {@link android.app.Service#onDestroy onDestroy()}).
android.content.BroadcastReceiver#onReceive onReceive()} 메서드를 실행하는 {@link android.content.BroadcastReceiver}를 호스팅할 경우.
-
일반적으로, 주어진 시간에 존재하는 전경 프로세스는 몇 개밖에 되지 않습니다. 이들은 최후의
-수단으로서만 종료됩니다. 즉, 메모리가 너무 부족해 계속 실행할 수 없는 경우를 말합니다. 일반적으로 그 시점이 되면
-기기가 메모리 페이징 상태에 도달한 것이므로 전경 프로세스 몇 개를 중단해야만
+
일반적으로, 주어진 시간에 존재하는 전경 프로세스는 몇 개밖에 되지 않습니다. 이들은 최후의
+수단으로서만 종료됩니다. 즉, 메모리가 너무 부족해 계속 실행할 수 없는 경우를 말합니다. 일반적으로 그 시점이 되면
+기기가 메모리 페이징 상태에 도달한 것이므로 전경 프로세스 몇 개를 중단해야만
사용자 인터페이스의 반응성을 유지할 수 있습니다.
가시적 프로세스
-
전경 구성 요소는 없지만
-사용자가 화면에서 보는 것에 영향을 미칠 수 있는 프로세스입니다. 다음 조건 중 하나가 참이면
+
전경 구성 요소는 없지만
+사용자가 화면에서 보는 것에 영향을 미칠 수 있는 프로세스입니다. 다음 조건 중 하나가 참이면
가시적 프로세스로 간주합니다.
전경에 있지는 않지만 사용자에게 보이는 {@link android.app.Activity}를 호스팅할 경우
-({@link android.app.Activity#onPause onPause()} 메서드가 호출되었을 경우).
+({@link android.app.Activity#onPause onPause()} 메서드가 호출되었을 경우).
예를 들어 이것은 전경 액티비티가 대화를 시작하여 이전 액티비티가 그 뒤에 보일 경우
발생합니다.
가시적인 프로세스는 매우 중요도가 높은 것으로 취급하고 모든 전경 프로세스를 실행하는 데 필요할 경우에만
+
가시적인 프로세스는 매우 중요도가 높은 것으로 취급하고 모든 전경 프로세스를 실행하는 데 필요할 경우에만
종료됩니다.
서비스 프로세스
{@link
-android.content.Context#startService startService()} 메서드로 시작되었지만 두 개의 상위 계층 분류에
-들어가지 않는 서비스를 실행하는 프로세스입니다. 서비스 프로세스는 사용자가 보는 것과 직접 연결되어 있지는 않지만,
-일반적으로 사용자가 신경 쓰는 작업을 하므로(배경에서 음악 재생 또는 네트워크에서 데이터 다운로드)
-시스템은 모든 전경 및 가시적 프로세스와 함께 실행할 만큼 메모리가 충분하지 않을 경우에만
+android.content.Context#startService startService()} 메서드로 시작되었지만 두 개의 상위 계층 분류에
+들어가지 않는 서비스를 실행하는 프로세스입니다. 서비스 프로세스는 사용자가 보는 것과 직접 연결되어 있지는 않지만,
+일반적으로 사용자가 신경 쓰는 작업을 하므로(배경에서 음악 재생 또는 네트워크에서 데이터 다운로드)
+시스템은 모든 전경 및 가시적 프로세스와 함께 실행할 만큼 메모리가 충분하지 않을 경우에만
프로세스를 중단합니다.
배경 프로세스
-
현재 사용자에게 보이지 않는 액티비티를 보유한 프로세스입니다(액티비티의
-{@link android.app.Activity#onStop onStop()} 메서드가 호출되었습니다). 이와 같은 프로세스는
-사용자 환경에 직접적 영향을 미치지 않고, 시스템은 언제든 이 프로세스를 중단시켜
+
현재 사용자에게 보이지 않는 액티비티를 보유한 프로세스입니다(액티비티의
+{@link android.app.Activity#onStop onStop()} 메서드가 호출되었습니다). 이와 같은 프로세스는
+사용자 환경에 직접적 영향을 미치지 않고, 시스템은 언제든 이 프로세스를 중단시켜
전경,
-가시적 또는 서비스 프로세스를 위한 메모리를 확보할 수 있습니다. 보통 한번에 실행 중인 배경 프로세스가 많은 편이므로 이들은
-LRU(최저 사용 빈도) 목록에 보관하여 사용자가 가장 최근에 본 액티비티가 있는
-프로세스가 가장 마지막에 중단되도록 합니다. 액티비티가 수명 주기 메서드를 올바르게 구현하고
-자신의 현재 상태를 저장할 경우, 사용자가 액티비티로 다시 이동할 때 액티비티가 모든 가시적 상태를
-복원하므로 프로세스를 중단시키더라도 사용자 환경에는 눈에 띄게 영향을 미치지
+가시적 또는 서비스 프로세스를 위한 메모리를 확보할 수 있습니다. 보통 한번에 실행 중인 배경 프로세스가 많은 편이므로 이들은
+LRU(최저 사용 빈도) 목록에 보관하여 사용자가 가장 최근에 본 액티비티가 있는
+프로세스가 가장 마지막에 중단되도록 합니다. 액티비티가 수명 주기 메서드를 올바르게 구현하고
+자신의 현재 상태를 저장할 경우, 사용자가 액티비티로 다시 이동할 때 액티비티가 모든 가시적 상태를
+복원하므로 프로세스를 중단시키더라도 사용자 환경에는 눈에 띄게 영향을 미치지
않습니다. 상태 저장과 복원에 관한 정보는 액티비티
문서를 참조하십시오.
빈 프로세스
-
활성 애플리케이션 구성 요소를 보유하지 않은 프로세스입니다. 이런 프로세스를
-유지하는 유일한 이유는 다음에 내부 구성 요소를 실행할 때 시작 시간을 절약하기 위한 캐싱
+
활성 애플리케이션 구성 요소를 보유하지 않은 프로세스입니다. 이런 프로세스를
+유지하는 유일한 이유는 다음에 내부 구성 요소를 실행할 때 시작 시간을 절약하기 위한 캐싱
때문입니다. 시스템은 프로세스 캐시와 기본 커널 캐시 사이에서 전반적인 시스템 리소스의 균형을 맞추기 위해
이 프로세스를 중단시키는 경우가 많습니다.
-
Android는 프로세스에서 현재 활성 상태인 구성 요소의 중요도에 따라
-프로세스에 가장 높은 수준을 부여합니다. 예를 들어, 프로세스가 서비스와 가시적 액티비티를 호스팅할 경우,
+
Android는 프로세스에서 현재 활성 상태인 구성 요소의 중요도에 따라
+프로세스에 가장 높은 수준을 부여합니다. 예를 들어, 프로세스가 서비스와 가시적 액티비티를 호스팅할 경우,
해당 프로세스는 서비스 프로세스가 아니라 가시적 프로세스 등급이 부여됩니다.
또한, 프로세스의 등급은 다른 프로세스가 이에 의존할 경우 상승할 수 있습니다.
-즉, 다른 프로세스에 서비스를 제공하는 프로세스가 서비스 제공 대상 프로세스보다
-등급이 낮은 경우는 있을 수 없습니다. 예를 들어 프로세스 A의 콘텐츠 제공자가 프로세스 B의 클라이언트에 서비스를 제공하거나
-프로세스 A의 서비스가 프로세스 B의 구성 요소에 바인딩되어 있을 경우 프로세스 A는 항상 중요도가
+즉, 다른 프로세스에 서비스를 제공하는 프로세스가 서비스 제공 대상 프로세스보다
+등급이 낮은 경우는 있을 수 없습니다. 예를 들어 프로세스 A의 콘텐츠 제공자가 프로세스 B의 클라이언트에 서비스를 제공하거나
+프로세스 A의 서비스가 프로세스 B의 구성 요소에 바인딩되어 있을 경우 프로세스 A는 항상 중요도가
프로세스 B와 같거나 그보다 높습니다.
-
서비스를 실행하는 프로세스가 배경 액티비티가 포함된 프로세스보다 높으므로,
+
서비스를 실행하는 프로세스가 배경 액티비티가 포함된 프로세스보다 높으므로,
장기 작업을 시작하는 액티비티는 작업자 스레드만 생성하기보다는 해당 작업에 대한 서비스를 시작하는 것이 좋습니다.
-이는 특히 작업이 해당 액티비티보다 오래 지속될 경우 더욱 중요합니다.
-예를 들어, 웹사이트에 사진을 업로드하는 액티비티가 업로드를 수행하는 서비스를 시작해야
-사용자가 액티비티를 떠나더라도 배경에서 업로드를 지속할 수 있습니다.
-서비스를 사용하면 액티비티에 어떤 일이 발생하든 해당 작업에 반드시
-"서비스 프로세스" 우선 순위 이상이 부여됩니다. 이것이 브로드캐스트 수신기가 시간이 오래 걸리는 작업을
+이는 특히 작업이 해당 액티비티보다 오래 지속될 경우 더욱 중요합니다.
+예를 들어, 웹사이트에 사진을 업로드하는 액티비티가 업로드를 수행하는 서비스를 시작해야
+사용자가 액티비티를 떠나더라도 배경에서 업로드를 지속할 수 있습니다.
+서비스를 사용하면 액티비티에 어떤 일이 발생하든 해당 작업에 반드시
+"서비스 프로세스" 우선 순위 이상이 부여됩니다. 이것이 브로드캐스트 수신기가 시간이 오래 걸리는 작업을
스레드에 넣기보다는 서비스를 사용해야 하는 것과 같은 이유입니다.
@@ -188,36 +188,36 @@ LRU(최저 사용 빈도) 목록에 보관하여 사용자가 가장 최근에
스레드
-
애플리케이션이 시작되면 시스템이 애플리케이션에 대한 실행의 스레드를 생성하며, 이를
-"기본"이라고 합니다. 이 스레드는 드로어블 이벤트를 포함하여 적절한 사용자 인터페이스 위젯에
+
애플리케이션이 시작되면 시스템이 애플리케이션에 대한 실행의 스레드를 생성하며, 이를
+"기본"이라고 합니다. 이 스레드는 드로어블 이벤트를 포함하여 적절한 사용자 인터페이스 위젯에
이벤트를 발송하는 역할을 맡기 때문에 중요합니다. 이것은 Android UI 도구 키트의 구성 요소({@link
android.widget}과 {@link android.view} 패키지의 구성 요소)와 개발자의 애플리케이션이
-상호 작용하는 스레드이기도 합니다. 따라서 기본 스레드는
+상호 작용하는 스레드이기도 합니다. 따라서 기본 스레드는
UI 스레드라고 불릴 때도 있습니다.
-
시스템은 구성 요소의 각 인스턴스에 대해 별도의 스레드를 생성하지 않습니다. 같은
+
시스템은 구성 요소의 각 인스턴스에 대해 별도의 스레드를 생성하지 않습니다. 같은
프로세스에서 실행되는 모든 구성 요소는 UI 스레드에서 시작되고, 각 구성 요소를 호출하는 시스템이
-해당 스레드에서 발송됩니다. 따라서
-시스템 콜백에 응답하는 메서드(사용자 작업을 보고하는 {@link android.view.View#onKeyDown onKeyDown()} 또는
+해당 스레드에서 발송됩니다. 따라서
+시스템 콜백에 응답하는 메서드(사용자 작업을 보고하는 {@link android.view.View#onKeyDown onKeyDown()} 또는
수명 주기 콜백 메서드)는 항상 프로세스의 UI 스레드에서 실행됩니다.
예를 들어, 사용자가 화면의 버튼을 터치하면, 앱 UI 스레드가 위젯에 터치 이벤트를 발송하고,
-위젯은 눌린 상태를 설정하고 이벤트 대기열에
-무효화 요청을 게시합니다. UI 스레드가 이 요청을 대기열에서 해제하고 위젯에 스스로를 다시
+위젯은 눌린 상태를 설정하고 이벤트 대기열에
+무효화 요청을 게시합니다. UI 스레드가 이 요청을 대기열에서 해제하고 위젯에 스스로를 다시
그려야 한다고 알립니다.
앱이 사용자 상호작용에 응답하여 집약적인 작업을 수행할 때는 이 단일 스레드 모델은
애플리케이션을 제대로 구현하지 않으면 낮은 성능을 보일 수 있습니다. 특히,
-모든 것이 UI 스레드에서 발생하고 네트워크 액세스나 데이터 베이스 쿼리 등의 긴 작업을 수행하면
-UI가 통째로 차단됩니다. 스레드가 차단되면 드로잉 이벤트를 포함하여
-모든 이벤트가 발송되지 않습니다. 사용자가 보기에는 애플리케이션이
+모든 것이 UI 스레드에서 발생하고 네트워크 액세스나 데이터 베이스 쿼리 등의 긴 작업을 수행하면
+UI가 통째로 차단됩니다. 스레드가 차단되면 드로잉 이벤트를 포함하여
+모든 이벤트가 발송되지 않습니다. 사용자가 보기에는 애플리케이션이
중단된 것처럼 보입니다. 더 나쁜 경우, UI 스레드가 몇 초 이상 차단되어 있으면
-(현재 약 5초) 사용자에게 악명 높은 "애플리케이션이 응답하지
-않습니다"(ANR) 대화가 표시됩니다. 그러면 사용자가 여러분의 애플리케이션을 종료 할 수도 있고, 불만족한 경우 앱을
+(현재 약 5초) 사용자에게 악명 높은 "애플리케이션이 응답하지
+않습니다"(ANR) 대화가 표시됩니다. 그러면 사용자가 여러분의 애플리케이션을 종료 할 수도 있고, 불만족한 경우 앱을
제거할 수도 있습니다.
-
또한, Andoid UI 도구 키트는 스레드로부터 안전하지 않습니다. 따라서 UI를
-작업자 스레드에서 조작해서는 안 됩니다. 사용자 인터페이스 조작 작업은 모두 UI
+
또한, Andoid UI 도구 키트는 스레드로부터 안전하지 않습니다. 따라서 UI를
+작업자 스레드에서 조작해서는 안 됩니다. 사용자 인터페이스 조작 작업은 모두 UI
스레드에서 해야만 합니다. 결론적으로, Android의 단일 스레드 모델에는 두 가지 단순한 규칙이 있습니다.
위에 설명한 단일 스레드 모델로 인해, 애플리케이션 UI의 반응성을 위해서는
-UI 스레드를 차단하지 않는 것이 매우 중요합니다. 수행해야 할 작업이 있는데
-이들이 즉각적인 조치를 요하지 않는 경우, 이런 작업은 반드시 별도의 스레드에서 수행해야 합니다("배경" 또는
+
위에 설명한 단일 스레드 모델로 인해, 애플리케이션 UI의 반응성을 위해서는
+UI 스레드를 차단하지 않는 것이 매우 중요합니다. 수행해야 할 작업이 있는데
+이들이 즉각적인 조치를 요하지 않는 경우, 이런 작업은 반드시 별도의 스레드에서 수행해야 합니다("배경" 또는
"작업자" 스레드).
-
예를 들어, 아래는 별도의 스레드에서 이미지를 다운로드하고 이를
+
예를 들어, 아래는 별도의 스레드에서 이미지를 다운로드하고 이를
{@link android.widget.ImageView}에 표시하는 클릭 수신기에 대한 몇 가지 코드입니다.
@@ -246,10 +246,10 @@ public void onClick(View v) {
}
-
처음에는 네트워크 작업을 처리하기 위한 새 스레드를 생성하므로
-아무 문제 없이 작동하는 것처럼 보입니다. 하지만, 이것은 단일 스레드된 모델의 두 번째 규칙 즉, 'UI 스레드 외부에서
+
처음에는 네트워크 작업을 처리하기 위한 새 스레드를 생성하므로
+아무 문제 없이 작동하는 것처럼 보입니다. 하지만, 이것은 단일 스레드된 모델의 두 번째 규칙 즉, 'UI 스레드 외부에서
Android UI 도구 키트에 액세스하지 마세요.'를 위반합니다. 이 샘플은 UI 스레드 대신 작업자 스레드에서 {@link
-android.widget.ImageView}를 수정합니다. 이렇게 되면
+android.widget.ImageView}를 수정합니다. 이렇게 되면
정의되지 않고 예기치 못한 동작이 발생하는 결과를 초래할 수 있고, 이는 추적하기 어려워 시간도 오래 걸립니다.
이 문제를 해결하기 위해 Android는 다른 스레드에서 UI 스레드에 액세스하는 여러 가지 방식을
@@ -281,28 +281,28 @@ public void onClick(View v) {
}
-
이 구현은 이제 스레드로부터 안전합니다. 네트워크 작업은 별도의 스레드에서 수행된 반면
+
이 구현은 이제 스레드로부터 안전합니다. 네트워크 작업은 별도의 스레드에서 수행된 반면
{@link android.widget.ImageView}는 UI 스레드에서 조작되었기 때문입니다.
-
그러나, 작업이 복잡해질수록 이런 종류의 코드가 더 복잡해질 수 있고 유지 관리하기
-까다로워질 수 있습니다. 더 복잡한 상호 작용을 작업자 스레드로 처리하려면, 작업자 스레드에서
-{@link android.os.Handler}를 사용하여 UI 스레드에서 전달 받은 메시지를 처리하는 방안을
-고려해보십시오. 하지만 최선의 해결책은 {@link android.os.AsyncTask} 클래스를 확장하는 방법일 것입니다.
+
그러나, 작업이 복잡해질수록 이런 종류의 코드가 더 복잡해질 수 있고 유지 관리하기
+까다로워질 수 있습니다. 더 복잡한 상호 작용을 작업자 스레드로 처리하려면, 작업자 스레드에서
+{@link android.os.Handler}를 사용하여 UI 스레드에서 전달 받은 메시지를 처리하는 방안을
+고려해보십시오. 하지만 최선의 해결책은 {@link android.os.AsyncTask} 클래스를 확장하는 방법일 것입니다.
이것은 UI와 상호 작용해야 하는 작업자 스레드 작업의 실행을 단순화합니다.
AsyncTask 사용
-
{@link android.os.AsyncTask}를 사용하면 사용자 인터페이스에서 비동기식 작업을 수행할 수
-있게 해줍니다. 이것은 작업자 스레드에서 차단 작업을 수행하고 그런 다음 그 결과를 UI 스레드에
+
{@link android.os.AsyncTask}를 사용하면 사용자 인터페이스에서 비동기식 작업을 수행할 수
+있게 해줍니다. 이것은 작업자 스레드에서 차단 작업을 수행하고 그런 다음 그 결과를 UI 스레드에
게시하며, 개발자가 직접 스레드 및/또는 처리기를 처리할 필요가 없습니다.
이를 사용하려면 우선 {@link android.os.AsyncTask}를 하위 클래스로 한 다음 {@link
-android.os.AsyncTask#doInBackground doInBackground()} 콜백 메서드를 구현해야 합니다. 이것은 여러 가지
+android.os.AsyncTask#doInBackground doInBackground()} 콜백 메서드를 구현해야 합니다. 이것은 여러 가지
배경 스레드에서 실행됩니다. UI를 업데이트하려면 {@link
android.os.AsyncTask#onPostExecute onPostExecute()}를 구현해야 합니다. 이는 {@link
-android.os.AsyncTask#doInBackground doInBackground()}로부터의 결과를 전달하며 UI 스레드에서 실행되므로,
-안전하게 UI를 업데이트할 수 있습니다. 그런 다음 UI 스레드에서 {@link android.os.AsyncTask#execute execute()}를
+android.os.AsyncTask#doInBackground doInBackground()}로부터의 결과를 전달하며 UI 스레드에서 실행되므로,
+안전하게 UI를 업데이트할 수 있습니다. 그런 다음 UI 스레드에서 {@link android.os.AsyncTask#execute execute()}를
호출하여 해당 작업을 실행하면 됩니다.
예를 들어, 이런 방식으로 {@link android.os.AsyncTask}를 사용하여
@@ -319,7 +319,7 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
protected Bitmap doInBackground(String... urls) {
return loadImageFromNetwork(urls[0]);
}
-
+
/** The system calls this to perform work in the UI thread and delivers
* the result from doInBackground() */
protected void onPostExecute(Bitmap result) {
@@ -328,21 +328,21 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
}
-
이제 UI는 안전하고 코드는 더욱 단순해졌습니다. 작업을 작업자 스레드에서 수행되어야 하는
+
이제 UI는 안전하고 코드는 더욱 단순해졌습니다. 작업을 작업자 스레드에서 수행되어야 하는
부분과 UI 스레드에서 수행되어야 하는 부분으로 구분하기 때문입니다.
-
이 클래스를 사용하는 법을 완전히 숙지하려면 {@link android.os.AsyncTask} 참조를
+
이 클래스를 사용하는 법을 완전히 숙지하려면 {@link android.os.AsyncTask} 참조를
읽어보시는 것이 좋습니다. 개괄적인 작동 방식은 아래에 간략히 소개해 놓았습니다.
-
매개 변수의 유형, 진행률 값과 작업의 최종 값을 제네릭을 사용하여
+
매개 변수의 유형, 진행률 값과 작업의 최종 값을 제네릭을 사용하여
지정할 수 있습니다.
메서드 {@link android.os.AsyncTask#doInBackground doInBackground()}는 작업자 스레드에서 자동으로
실행됩니다.
{@link android.os.AsyncTask#onPreExecute onPreExecute()}, {@link
android.os.AsyncTask#onPostExecute onPostExecute()} 및 {@link
android.os.AsyncTask#onProgressUpdate onProgressUpdate()}는 모두 UI 스레드에서 호출됩니다.
-
{@link android.os.AsyncTask#doInBackground doInBackground()}가 반환한 값이
+
{@link android.os.AsyncTask#doInBackground doInBackground()}가 반환한 값이
{@link android.os.AsyncTask#onPostExecute onPostExecute()}로 전송됩니다.
주의: 작업자 스레드를 사용할 때 마주칠 수 있는 또 한 가지 문제는
런타임 구성 변경으로 인해 액티비티가 예기치 못하게 다시 시작되는 것입니다
-(예를 들어 사용자가 화면 방향을 바꾸는 경우). 이 경우 작업자 스레드를 소멸시킬 수 있습니다.
+(예를 들어 사용자가 화면 방향을 바꾸는 경우). 이 경우 작업자 스레드를 소멸시킬 수 있습니다.
스레드가 재시작될 때 작업을 지속하는 방법과 액티비티가 제거되었을 때 작업을 적절히 취소하는 방법은
Shelves 샘플 애플리케이션의 소스 코드를 참조하십시오.
스레드로부터 안전한 메서드
-
어떤 경우에는 구현하는 메서드가 하나 이상의 스레드에서 호출되는 일도 있습니다. 따라서
+
어떤 경우에는 구현하는 메서드가 하나 이상의 스레드에서 호출되는 일도 있습니다. 따라서
이를 스레드로부터 안전하게 작성해야만 합니다.
-
이것은 주로 원격으로 호출할 수 있는 메서드에 대해 참입니다. 예를 들어 바인딩된 서비스 내의 메서드 등이 해당됩니다.
-{@link android.os.IBinder}에서 구현된 메서드가
-{@link android.os.IBinder IBinder}가 실행되는 프로세스에서 호출될 경우, 해당 메서드는 발신자의 스레드에서 실행됩니다.
-그러나 호출이 다른 프로세스에서 발생하면, 해당 메서드는 시스템이
+
이것은 주로 원격으로 호출할 수 있는 메서드에 대해 참입니다. 예를 들어 바인딩된 서비스 내의 메서드 등이 해당됩니다.
+{@link android.os.IBinder}에서 구현된 메서드가
+{@link android.os.IBinder IBinder}가 실행되는 프로세스에서 호출될 경우, 해당 메서드는 발신자의 스레드에서 실행됩니다.
+그러나 호출이 다른 프로세스에서 발생하면, 해당 메서드는 시스템이
{@link android.os.IBinder
-IBinder}와 같은 프로세스에 유지하는 스레드 풀에서 선택된 스레드에서 실행됩니다(프로세스의 UI 스레드에서 실행되지 않습니다). 예를 들어, 어느 서비스의
-{@link android.app.Service#onBind onBind()} 메서드는 해당 서비스
+IBinder}와 같은 프로세스에 유지하는 스레드 풀에서 선택된 스레드에서 실행됩니다(프로세스의 UI 스레드에서 실행되지 않습니다). 예를 들어, 어느 서비스의
+{@link android.app.Service#onBind onBind()} 메서드는 해당 서비스
프로세스의 UI 스레드에서 호출되고, {@link android.app.Service#onBind
-onBind()}가 반환하는 객체에서 구현된 메서드는(예: RPC 메서드를 구현하는 하위 클래스) 해당 풀 안의 여러 스레드에서
+onBind()}가 반환하는 객체에서 구현된 메서드는(예: RPC 메서드를 구현하는 하위 클래스) 해당 풀 안의 여러 스레드에서
호출되게 됩니다. 서비스에 클라이언트가 하나 이상 있을 수 있으므로, 하나 이상의 풀이
동시에 같은 {@link android.os.IBinder IBinder} 메서드에 참여할 수 있습니다. 그러므로 {@link android.os.IBinder
IBinder} 메서드는 스레드로부터 안전하게 구현되어야 합니다.
@@ -389,13 +389,13 @@ getType()} 메서드—)가 프로세스의 UI 스레드가 아니라
프로세스 간 통신
-
Android는 원격 프로시저 호출(RPC)을 사용한 프로세스 간 통신(IPC) 메커니즘을 제공합니다.
-여기서 메서드는 액티비티나 다른 애플리케이션 구성 요소에 호출되지만
-원격으로 (또 다른 프로세스에서) 실행되고, 결과는 모두 발신자에게 되돌려
-보냅니다. 메서드 호출과 메서드의 데이터는 운영 체제가 이해할 수 있는 수준으로 분해되고,
-로컬 프로세스와 주소 공간에서 원격 프로세스와 주소 공간으로 전송된 다음
-다시 결합되어 여기서 호출에 다시 응답합니다. 그런 다음 반환 값이
-반대 방향으로 전송됩니다. Android가 이와 같은 IPC 트랜잭션을 수행하는 데 필요한
+
Android는 원격 프로시저 호출(RPC)을 사용한 프로세스 간 통신(IPC) 메커니즘을 제공합니다.
+여기서 메서드는 액티비티나 다른 애플리케이션 구성 요소에 호출되지만
+원격으로 (또 다른 프로세스에서) 실행되고, 결과는 모두 발신자에게 되돌려
+보냅니다. 메서드 호출과 메서드의 데이터는 운영 체제가 이해할 수 있는 수준으로 분해되고,
+로컬 프로세스와 주소 공간에서 원격 프로세스와 주소 공간으로 전송된 다음
+다시 결합되어 여기서 호출에 다시 응답합니다. 그런 다음 반환 값이
+반대 방향으로 전송됩니다. Android가 이와 같은 IPC 트랜잭션을 수행하는 데 필요한
모든 코드를 제공하므로, 개발자는 그저 RPC 프로그래밍 인터페이스를 정의하고 구현하는 데에만 집중하면 됩니다.
IPC를 수행하려면 애플리케이션이 반드시 서비스에 바인딩되어야만 하며, 이때 {@link
diff --git a/docs/html-intl/intl/ko/guide/components/recents.jd b/docs/html-intl/intl/ko/guide/components/recents.jd
index cba3c45da3dae..28b3c681f5a2b 100644
--- a/docs/html-intl/intl/ko/guide/components/recents.jd
+++ b/docs/html-intl/intl/ko/guide/components/recents.jd
@@ -38,50 +38,50 @@ page.tags="recents","overview"
개요 화면(다른 말로 최근 사용 화면, 최근 작업 목록 또는 최근 앱이라고도 함)은
시스템 수준 UI로, 최근에 액세스한
-액티비티 및 작업을 목록으로 나열한 것입니다. 사용자는
-목록을 가로질러 이동하며 작업을 선택해서 재개할 수도 있고, 아니면
-목록에서 한 작업을 스와이프하여 밀어내어 목록에서 제거할 수도 있습니다. Android 5.0 릴리스(API 레벨 21)의 경우, 같은 액티비티의 여러 인스턴스에
-각기 다른 문서가 담겨 있는 경우 이들이 개요 화면에 작업으로 나타날 수 있습니다. 예를 들어
-Google Drive에 여러 개의 Google 문서 각각에 대한 작업이 있을 수 있습니다. 각 문서는 개요 화면에 하나의
+액티비티 및 작업을 목록으로 나열한 것입니다. 사용자는
+목록을 가로질러 이동하며 작업을 선택해서 재개할 수도 있고, 아니면
+목록에서 한 작업을 스와이프하여 밀어내어 목록에서 제거할 수도 있습니다. Android 5.0 릴리스(API 레벨 21)의 경우, 같은 액티비티의 여러 인스턴스에
+각기 다른 문서가 담겨 있는 경우 이들이 개요 화면에 작업으로 나타날 수 있습니다. 예를 들어
+Google Drive에 여러 개의 Google 문서 각각에 대한 작업이 있을 수 있습니다. 각 문서는 개요 화면에 하나의
작업으로 나타납니다.
-
그림 1. 세 개의 Google Drive 문서가 각기 별도의
+
그림 1. 세 개의 Google Drive 문서가 각기 별도의
작업을 나타내는 모습을 표시한 개요 화면입니다.
-
보통은 개요 화면에 작업과 액티비티가 어떻게 표현될지는 시스템이
-정의하도록 두어야 합니다. 이 행동을 개발자가 수정할 필요도 없습니다.
-하지만, 개요 화면에 액티비티가 언제, 어떻게 나타날지는 앱이 결정할 수 있습니다.
-{@link android.app.ActivityManager.AppTask} 클래스를 사용하면 작업을 관리할 수 있게 해주고,
-{@link android.content.Intent} 클래스의 액티비티 플래그를 사용하면 개요 화면에서 액티비티가 추가되거나 제거되는 시점을
+
보통은 개요 화면에 작업과 액티비티가 어떻게 표현될지는 시스템이
+정의하도록 두어야 합니다. 이 행동을 개발자가 수정할 필요도 없습니다.
+하지만, 개요 화면에 액티비티가 언제, 어떻게 나타날지는 앱이 결정할 수 있습니다.
+{@link android.app.ActivityManager.AppTask} 클래스를 사용하면 작업을 관리할 수 있게 해주고,
+{@link android.content.Intent} 클래스의 액티비티 플래그를 사용하면 개요 화면에서 액티비티가 추가되거나 제거되는 시점을
지정할 수 있습니다. 또한,
<activity> 특성을 사용하면 매니페스트에서의 동작을 설정할 수 있습니다.
개요 화면에 작업 추가
-
{@link android.content.Intent} 클래스의 플래그를 사용하여 작업을 추가하면
-개요 화면에서 문서가 열리거나 다시 열리는 시점과 방법을 보다 철저히 통제할 수 있습니다.
+
{@link android.content.Intent} 클래스의 플래그를 사용하여 작업을 추가하면
+개요 화면에서 문서가 열리거나 다시 열리는 시점과 방법을 보다 철저히 통제할 수 있습니다.
<activity>
- 특성을 사용하는 경우, 문서를 항상 새 작업에서 여는 방법과 기존 작업을 해당 문서에 다시 사용하는 방법 중에서
+ 특성을 사용하는 경우, 문서를 항상 새 작업에서 여는 방법과 기존 작업을 해당 문서에 다시 사용하는 방법 중에서
선택할 수 있습니다.
작업 추가에 인텐트 플래그 사용
-
액티비티를 위해 새 문서를 생성하는 경우,
-{@link android.app.ActivityManager.AppTask} 클래스의
+
액티비티를 위해 새 문서를 생성하는 경우,
+{@link android.app.ActivityManager.AppTask} 클래스의
{@link android.app.ActivityManager.AppTask#startActivity(android.content.Context, android.content.Intent, android.os.Bundle) startActivity()}
- 메서드를 호출하고, 이것을 액티비티를 시작하는 인텐트에 전달하면 됩니다. 논리적인 중단을 삽입하여 시스템이 개요 화면에서 액티비티를
-새 작업으로 처리하도록 하려면, {@link android.content.Intent}의
-{@link android.content.Intent#addFlags(int) addFlags()} 메서드에 있는 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
+ 메서드를 호출하고, 이것을 액티비티를 시작하는 인텐트에 전달하면 됩니다. 논리적인 중단을 삽입하여 시스템이 개요 화면에서 액티비티를
+새 작업으로 처리하도록 하려면, {@link android.content.Intent}의
+{@link android.content.Intent#addFlags(int) addFlags()} 메서드에 있는 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
플래그를 전달하여 액티비티를 시작하도록 합니다.
참고: {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
-플래그가 {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET} 플래그를
+플래그가 {@link android.content.Intent#FLAG_ACTIVITY_CLEAR_WHEN_TASK_RESET} 플래그를
대체합니다. 이것은 Android 5.0(API 레벨 21)부터 사용이 중단되었습니다.
-
새 문서를 생성하면서 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그를 설정하는 경우,
-시스템은 항상 대상 액티비티를 루트로 하여 새 작업을 만듭니다.
-이렇게 설정하면 같은 문서를 하나 이상의 작업에서 열 수 있습니다. 다음 코드는 기본 액티비티가 이 작업을 수행하는 방법을
+
새 문서를 생성하면서 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그를 설정하는 경우,
+시스템은 항상 대상 액티비티를 루트로 하여 새 작업을 만듭니다.
+이렇게 설정하면 같은 문서를 하나 이상의 작업에서 열 수 있습니다. 다음 코드는 기본 액티비티가 이 작업을 수행하는 방법을
보여줍니다.
를 사용한다고 나타낼 수도 있습니다. 이 특성에는 네 가지 값이 있어 사용자가 애플리케이션으로 문서를 열면
다음과 같은 효과를 발생시킵니다.
"{@code intoExisting}"
-
액티비티가 문서에 대해 기존의 작업을 재사용합니다. 이것은
-{@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} 플래그를 설정할 때
-{@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그 없이 설정하는 것과 같습니다.
+
액티비티가 문서에 대해 기존의 작업을 재사용합니다. 이것은
+{@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} 플래그를 설정할 때
+{@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그 없이 설정하는 것과 같습니다.
이는 위의 작업 추가에 인텐트 플래그 사용에서 설명한 것과 같습니다.
"{@code always}"
-
액티비티가 문서에 대해 새 작업을 생성하며, 이는 문서가 이미 열려 있는 경우라도 마찬가지입니다. 이 값을
+
액티비티가 문서에 대해 새 작업을 생성하며, 이는 문서가 이미 열려 있는 경우라도 마찬가지입니다. 이 값을
사용하는 것은 {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
및 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그를 둘 다 설정하는 것과 같습니다.
"{@code none”}"
-
액티비티가 문서에 대해 새 작업을 생성하지 않습니다. 개요 화면은 액티비티를 기본 상태에서와
-같이 다룹니다. 즉 앱에 대한 하나의 작업을 표시하며, 이때 사용자가
+
액티비티가 문서에 대해 새 작업을 생성하지 않습니다. 개요 화면은 액티비티를 기본 상태에서와
+같이 다룹니다. 즉 앱에 대한 하나의 작업을 표시하며, 이때 사용자가
마지막으로 호출한 작업이 무엇이든 관계 없이 그 작업에서부터 재개합니다.
"{@code never}"
-
액티비티가 문서에 대해 새 작업을 생성하지 않습니다. 이 값을 설정하면
+
액티비티가 문서에 대해 새 작업을 생성하지 않습니다. 이 값을 설정하면
{@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT}
- 및 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그의 행동을
-재정의합니다(이들 중 하나가 인텐트에서 설정되어 있는 경우). 개요 화면은 앱에 대한 하나의 작업을 표시하고,
+ 및 {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK} 플래그의 행동을
+재정의합니다(이들 중 하나가 인텐트에서 설정되어 있는 경우). 개요 화면은 앱에 대한 하나의 작업을 표시하고,
이것이 사용자가 마지막으로 호출한 액티비티가 무엇이든 그것부터 재개합니다.
-
참고: {@code none} 및 {@code never}를 제외한 다른 값의 경우,
-액티비티를 {@code launchMode="standard"}로 정의해야 합니다. 이 특성을 지정하지 않으면
+
참고: {@code none} 및 {@code never}를 제외한 다른 값의 경우,
+액티비티를 {@code launchMode="standard"}로 정의해야 합니다. 이 특성을 지정하지 않으면
{@code documentLaunchMode="none"}이 사용됩니다.
작업 제거
-
기본적으로 문서 작업은 해당되는 액티비티가 완료되면 자동으로 개요 화면에서
-제거됩니다. 이 행동을 재정의하려면 {@link android.app.ActivityManager.AppTask} 클래스를 사용합니다. 이때
+
기본적으로 문서 작업은 해당되는 액티비티가 완료되면 자동으로 개요 화면에서
+제거됩니다. 이 행동을 재정의하려면 {@link android.app.ActivityManager.AppTask} 클래스를 사용합니다. 이때
{@link android.content.Intent} 플래그 또는
<activity> 특성을 함께 사용하십시오.
개요 화면에서 앱이 포함할 수 있는 작업의 최대 개수를 설정하려면
<activity>
특성 {@code android:maxRecents}
-를 정수 값으로 설정합니다. 기본은 16개입니다. 작업의 최대 대수에 도달하면 가장 예전에 사용된 작업이 개요 화면에서
-제거됩니다. {@code android:maxRecents} 최대값은
+
를 정수 값으로 설정합니다. 기본은 16개입니다. 작업의 최대 대수에 도달하면 가장 예전에 사용된 작업이 개요 화면에서
+제거됩니다. {@code android:maxRecents} 최대값은
50입니다(메모리 용량이 적은 기기에서는 25). 1 미만의 값은 유효하지 않습니다.
작업 제거에 AppTask 클래스 사용
-
개요 화면에서 새 작업을 생성하는 액티비티에서는 작업을 언제 제거할 것인지와
-그와 관련된 모든 액티비티를 언제 완료할 것인지 지정할 수 있습니다.
+
개요 화면에서 새 작업을 생성하는 액티비티에서는 작업을 언제 제거할 것인지와
+그와 관련된 모든 액티비티를 언제 완료할 것인지 지정할 수 있습니다.
{@link android.app.ActivityManager.AppTask#finishAndRemoveTask() finishAndRemoveTask()} 메서드를 호출하면 됩니다.
같은 효과를 얻기 위해
<activity>
특성
{@code android:autoRemoveFromRecents}를 {@code false}로 설정해도 됩니다. 기본 값은 문서 액티비티의 경우 {@code true}
-이고, 일반 액티비티의 경우 {@code false}입니다. 이 특성을 사용하면 이전에 논한 것과 같이
+이고, 일반 액티비티의 경우 {@code false}입니다. 이 특성을 사용하면 이전에 논한 것과 같이
{@link android.content.Intent#FLAG_ACTIVITY_RETAIN_IN_RECENTS} 플래그를 재정의하게 됩니다.
{@link android.app.Service}는 배경에서 오래 실행되는 작업을
-수행할 수 있는 애플리케이션 구성 요소이며 사용자 인터페이스를 제공하지 않습니다. 또 다른
-애플리케이션 구성 요소가 서비스를 시작할 수 있으며, 이는 사용자가 또 다른
-애플리케이션으로 전환하더라도 배경에서 계속해서 실행됩니다. 이외에도, 구성 요소를 서비스에 바인딩하여
-서비스와 상호 작용할 수 있으며, 심지어는 프로세스 간 통신(IPC)도 수행할 수 있습니다. 예를 들어 한 서비스는
-네트워크 트랜잭션을 처리하고, 음악을 재생하고 파일 I/O를 수행하거나 콘텐츠 제공자와 상호 작용할 수 있으며
+
{@link android.app.Service}는 배경에서 오래 실행되는 작업을
+수행할 수 있는 애플리케이션 구성 요소이며 사용자 인터페이스를 제공하지 않습니다. 또 다른
+애플리케이션 구성 요소가 서비스를 시작할 수 있으며, 이는 사용자가 또 다른
+애플리케이션으로 전환하더라도 배경에서 계속해서 실행됩니다. 이외에도, 구성 요소를 서비스에 바인딩하여
+서비스와 상호 작용할 수 있으며, 심지어는 프로세스 간 통신(IPC)도 수행할 수 있습니다. 예를 들어 한 서비스는
+네트워크 트랜잭션을 처리하고, 음악을 재생하고 파일 I/O를 수행하거나 콘텐츠 제공자와 상호 작용할 수 있으며
이 모든 것을 배경에서 수행할 수 있습니다.
서비스는 본질적으로 두 가지 형식을 취합니다.
시작됨
-
서비스가 "시작된" 상태가 되려면 애플리케이션 구성 요소(예: 액티비티)가
-{@link android.content.Context#startService startService()}를 호출하여 시작하면 됩니다. 서비스는 한 번 시작되고 나면
-배경에서 무기한으로 실행될 수 있으며, 이는 해당 서비스를 시작한 구성 요소가 소멸되었더라도 무관합니다. 보통,
+
서비스가 "시작된" 상태가 되려면 애플리케이션 구성 요소(예: 액티비티)가
+{@link android.content.Context#startService startService()}를 호출하여 시작하면 됩니다. 서비스는 한 번 시작되고 나면
+배경에서 무기한으로 실행될 수 있으며, 이는 해당 서비스를 시작한 구성 요소가 소멸되었더라도 무관합니다. 보통,
시작된 서비스는 한 작업을 수행하고 결과를 발신자에게 반환하지 않습니다.
-예를 들어 네트워크에서 파일을 다운로드하거나 업로드할 수 있습니다. 작업을 완료하면, 해당 서비스는
+예를 들어 네트워크에서 파일을 다운로드하거나 업로드할 수 있습니다. 작업을 완료하면, 해당 서비스는
알아서 중단되는 것이 정상입니다.
바인딩됨
서비스가 "바인딩된" 상태가 되려면 애플리케이션 구성 요소가 {@link
-android.content.Context#bindService bindService()}를 사용하여 해당 서비스에 바인딩되면 됩니다. 바인딩된 서비스는 클라이언트-서버
-인터페이스를 제공하여 구성 요소가 서비스와 상호 작용할 수 있도록 해주며, 결과를 가져올 수도 있고 심지어
-이와 같은 작업을 여러 프로세스에 걸쳐 프로세스 간 통신(IPC)으로 수행할 수도 있습니다. 바인딩된 서비스는 또 다른 애플리케이션 구성 요소가
-이에 바인딩되어 있는 경우에만 실행됩니다. 여러 개의 구성 요소가 서비스에 한꺼번에 바인딩될 수 있지만,
+android.content.Context#bindService bindService()}를 사용하여 해당 서비스에 바인딩되면 됩니다. 바인딩된 서비스는 클라이언트-서버
+인터페이스를 제공하여 구성 요소가 서비스와 상호 작용할 수 있도록 해주며, 결과를 가져올 수도 있고 심지어
+이와 같은 작업을 여러 프로세스에 걸쳐 프로세스 간 통신(IPC)으로 수행할 수도 있습니다. 바인딩된 서비스는 또 다른 애플리케이션 구성 요소가
+이에 바인딩되어 있는 경우에만 실행됩니다. 여러 개의 구성 요소가 서비스에 한꺼번에 바인딩될 수 있지만,
이 모든 것이 바인딩을 해제하면 해당 서비스는 소멸됩니다.
-
이 문서는 주로 이러한 두 가지 유형의 서비스를 따로따로 논하지만, 서비스는
+
이 문서는 주로 이러한 두 가지 유형의 서비스를 따로따로 논하지만, 서비스는
두 가지 방식 모두로 작동할 수 있습니다. 즉 서비스가 시작될 수도 있고(나아가 무기한으로 실행되고) 바인딩도 허용할 수 있다는 뜻입니다.
이는 그저 두어 가지 콜백 메서드의 구현 여부에 달린 문제입니다. {@link
android.app.Service#onStartCommand onStartCommand()}를 사용하면 구성 요소가 서비스를 시작할 수 있게 허용하고, {@link
android.app.Service#onBind onBind()}를 사용하면 바인딩을 허용합니다.
주의: 서비스는 자신의 호스팅 프로세스의
-기본 스레드에서 실행됩니다. 서비스는 자신의 스레드를 직접 생성하지 않으며,
-별도의 프로세스에서 실행되지도 않습니다(별도로 지정하는 경우는 예외). 이것은 즉,
-서비스가 CPU 집약적인 작업을 수행할 예정이거나 차단적인 작업을 수행할 예정인 경우(예를 들어 MP3
-재생 또는 네트워킹 등), 서비스 내에 새 스레드를 생성하여 해당 작업을 수행하도록 해야 한다는 뜻입니다. 별도의 스레드를 사용하면
-'애플리케이션이 응답하지 않습니다(ANR)' 오류가 일어날 위험을 줄일 수 있으며
+
주의: 서비스는 자신의 호스팅 프로세스의
+기본 스레드에서 실행됩니다. 서비스는 자신의 스레드를 직접 생성하지 않으며,
+별도의 프로세스에서 실행되지도 않습니다(별도로 지정하는 경우는 예외). 이것은 즉,
+서비스가 CPU 집약적인 작업을 수행할 예정이거나 차단적인 작업을 수행할 예정인 경우(예를 들어 MP3
+재생 또는 네트워킹 등), 서비스 내에 새 스레드를 생성하여 해당 작업을 수행하도록 해야 한다는 뜻입니다. 별도의 스레드를 사용하면
+'애플리케이션이 응답하지 않습니다(ANR)' 오류가 일어날 위험을 줄일 수 있으며
애플리케이션의 기본 스레드는 액티비티와 사용자 상호 작용 전용으로 유지될 수 있습니다.
@@ -103,89 +103,89 @@ android.app.Service#onBind onBind()}를 사용하면 바인딩을 허용합니
서비스와 스레드 중 어느 것을 사용해야 할까요?
-
서비스는 그저 배경에서 실행될 수 있는 구성 요소일 뿐입니다. 이는 사용자가
-애플리케이션과 상호 작용하지 않아도 관계 없이 해당됩니다. 따라서, 서비스를 생성하는 것은 꼭 그것이 필요할 때만으로 국한되어야
+
서비스는 그저 배경에서 실행될 수 있는 구성 요소일 뿐입니다. 이는 사용자가
+애플리케이션과 상호 작용하지 않아도 관계 없이 해당됩니다. 따라서, 서비스를 생성하는 것은 꼭 그것이 필요할 때만으로 국한되어야
합니다.
-
기본 스레드 외부에서 작업을 수행해야 하지만 사용자가 애플리케이션과 상호 작용 중인
-동안에만 수행하면 되는 경우라면, 서비스가 아니라 그 대신 새 스레드를 생성해야 합니다. 예를 들어
-액티비티가 실행되는 중에만 음악을 재생하고자 하는 경우,
+
서비스를 사용하는 경우 기본적으로 애플리케이션의 기본 스레드에서
-계속 실행되므로 서비스가 집약적이거나 차단적인 작업을 수행하는 경우 여전히 서비스 내에
+
서비스를 사용하는 경우 기본적으로 애플리케이션의 기본 스레드에서
+계속 실행되므로 서비스가 집약적이거나 차단적인 작업을 수행하는 경우 여전히 서비스 내에
새 스레드를 생성해야 한다는 점을 명심하십시오.
-
서비스를 생성하려면 {@link android.app.Service}의 하위 클래스를 생성해야 합니다(아니면 이의
-기존 하위 클래스 중 하나). 구현에서는 서비스 수명 주기의 주요 측면을 처리하는 콜백 메서드를
-몇 가지 재정의해야 하며 서비스에 바인딩할 구성 요소에 대한 메커니즘을
+
서비스를 생성하려면 {@link android.app.Service}의 하위 클래스를 생성해야 합니다(아니면 이의
+기존 하위 클래스 중 하나). 구현에서는 서비스 수명 주기의 주요 측면을 처리하는 콜백 메서드를
+몇 가지 재정의해야 하며 서비스에 바인딩할 구성 요소에 대한 메커니즘을
제공해야 합니다(해당되는 경우). 재정의해야 하는 가장 중요한 콜백 메서드는 다음과 같습니다.
시스템이 이 메서드를 호출하는 것은 또 다른 구성 요소(예: 액티비티)가 서비스를
시작하도록 요청하는 경우입니다. 이때 {@link android.content.Context#startService
-startService()}를 호출하는 방법을 씁니다. 이 메서드가 실행되면 서비스가 시작되고 배경에서 무기한으로 실행될 수
-있습니다. 이것을 구성하면 서비스의 작업이 완료되었을 때 해당 서비스를 중단하는 것은
+startService()}를 호출하는 방법을 씁니다. 이 메서드가 실행되면 서비스가 시작되고 배경에서 무기한으로 실행될 수
+있습니다. 이것을 구성하면 서비스의 작업이 완료되었을 때 해당 서비스를 중단하는 것은
개발자 본인의 책임입니다. 이때 {@link android.app.Service#stopSelf stopSelf()} 또는 {@link
-android.content.Context#stopService stopService()}를 호출하면 됩니다 (바인딩만 제공하고자 하는 경우, 이 메서드를 구현하지
+android.content.Context#stopService stopService()}를 호출하면 됩니다 (바인딩만 제공하고자 하는 경우, 이 메서드를 구현하지
않아도 됩니다).
{@link android.app.Service#onBind onBind()}
시스템이 이 메서드를 호출하는 것은 또 다른 구성 요소가 해당 서비스에 바인딩되고자 하는 경우
(예를 들어 RPC를 수행하기 위해)입니다. 이때 {@link android.content.Context#bindService
-bindService()}를 호출하는 방법을 씁니다. 이 메서드를 구현할 때에는 클라이언트가 서비스와 통신을 주고받기 위해 사용할
-인터페이스를 제공해야 합니다. 이때 {@link android.os.IBinder}를 반환하면 됩니다. 이 메서드는 항상
+bindService()}를 호출하는 방법을 씁니다. 이 메서드를 구현할 때에는 클라이언트가 서비스와 통신을 주고받기 위해 사용할
+인터페이스를 제공해야 합니다. 이때 {@link android.os.IBinder}를 반환하면 됩니다. 이 메서드는 항상
구현해야 하지만, 바인딩을 허용하지 않고자 하면 null을 반환해야 합니다.
{@link android.app.Service#onCreate()}
-
시스템이 이 메서드를 호출하는 것은 서비스가 처음 생성되어 일회성 설정
-절차를 수행하는 경우입니다({@link android.app.Service#onStartCommand onStartCommand()} 또는
-{@link android.app.Service#onBind onBind()}를 호출하기 전에). 서비스가 이미 실행 중인 경우, 이 메서드는 호출되지
+
시스템이 이 메서드를 호출하는 것은 서비스가 처음 생성되어 일회성 설정
+절차를 수행하는 경우입니다({@link android.app.Service#onStartCommand onStartCommand()} 또는
+{@link android.app.Service#onBind onBind()}를 호출하기 전에). 서비스가 이미 실행 중인 경우, 이 메서드는 호출되지
않습니다.
{@link android.app.Service#onDestroy()}
-
시스템이 이 메서드를 호출하는 것은 해당 서비스를 더 이상 사용하지 않고 소멸시키는 경우입니다.
-서비스에 이것을 구현해야 스레드, 등록된 각종 수신기(listener, receiver) 등
+
시스템이 이 메서드를 호출하는 것은 해당 서비스를 더 이상 사용하지 않고 소멸시키는 경우입니다.
+서비스에 이것을 구현해야 스레드, 등록된 각종 수신기(listener, receiver) 등
모든 리소스를 정리할 수 있습니다. 이것이 서비스가 수신하는 마지막 호출입니다.
한 구성 요소가 {@link
android.content.Context#startService startService()}를 호출하여 서비스를 시작하면({@link
-android.app.Service#onStartCommand onStartCommand()}로의 호출을 초래함), 해당 서비스는
-알아서 {@link android.app.Service#stopSelf()}로 스스로를 중단할 때까지 또는
+android.app.Service#onStartCommand onStartCommand()}로의 호출을 초래함), 해당 서비스는
+알아서 {@link android.app.Service#stopSelf()}로 스스로를 중단할 때까지 또는
또 다른 구성 요소가 {@link android.content.Context#stopService stopService()}를 호출하여 서비스를 중단시킬 때까지 실행 중인 상태로 유지됩니다.
-
한 구성 요소가
+
한 구성 요소가
{@link android.content.Context#bindService bindService()}를 호출하여 서비스를 생성하는 경우(그리고 {@link
-android.app.Service#onStartCommand onStartCommand()}를 호출하지 않은 경우), 해당 서비스는
-해당 구성 요소가 바인딩되어 있는 경우에만 실행됩니다. 서비스가 모든 클라이언트로부터 바인딩 해제되면 시스템이 이를
+android.app.Service#onStartCommand onStartCommand()}를 호출하지 않은 경우), 해당 서비스는
+해당 구성 요소가 바인딩되어 있는 경우에만 실행됩니다. 서비스가 모든 클라이언트로부터 바인딩 해제되면 시스템이 이를
소멸시킵니다.
-
Android 시스템이 서비스를 강제 중단시키는 것은 메모리가 부족하여 사용자가 초점을 집중하고 있는
-액티비티를 위해 시스템 리소스를 회복해야만 하는 경우로만 국한됩니다. 해당 서비스가 사용자의 주목을
-끌고 있는 액티비티에 바인딩되어 있다면 중단될 가능성이 낮고, 서비스가 전경에서 실행된다고 선언된 경우(나중에 자세히 논함), 거의 절대 중단되지 않습니다.
-그렇지 않으면, 서비스가 시작되었고 오랫동안 실행되는 경우
-시간이 지나면서 시스템이 배경 작업 목록에서의 이 서비스의 위치를 점점 낮추고
-서비스는 중단되기 매우 쉬워집니다. 서비스가 시작되었다면 이를 시스템에 의한 재시작을 정상적으로
-처리하도록 디자인해야 합니다. 시스템이 서비스를 중단시키는 경우, 리소스를 다시 사용할 수 있게 되면
+
Android 시스템이 서비스를 강제 중단시키는 것은 메모리가 부족하여 사용자가 초점을 집중하고 있는
+액티비티를 위해 시스템 리소스를 회복해야만 하는 경우로만 국한됩니다. 해당 서비스가 사용자의 주목을
+끌고 있는 액티비티에 바인딩되어 있다면 중단될 가능성이 낮고, 서비스가 전경에서 실행된다고 선언된 경우(나중에 자세히 논함), 거의 절대 중단되지 않습니다.
+그렇지 않으면, 서비스가 시작되었고 오랫동안 실행되는 경우
+시간이 지나면서 시스템이 배경 작업 목록에서의 이 서비스의 위치를 점점 낮추고
+서비스는 중단되기 매우 쉬워집니다. 서비스가 시작되었다면 이를 시스템에 의한 재시작을 정상적으로
+처리하도록 디자인해야 합니다. 시스템이 서비스를 중단시키는 경우, 리소스를 다시 사용할 수 있게 되면
시스템이 가능한 한 빨리 이를 다시 시작합니다(다만 이것은 개발자가 {@link
-android.app.Service#onStartCommand onStartCommand()}에서 반환하는 값에도 좌우됩니다. 이 내용은 나중에 논합니다). 시스템이 서비스를
+android.app.Service#onStartCommand onStartCommand()}에서 반환하는 값에도 좌우됩니다. 이 내용은 나중에 논합니다). 시스템이 서비스를
소멸시킬 수 있는 경우에 대한 자세한 정보는 프로세스 및 스레딩
문서를 참조하십시오.
-
다음 섹션에서는 각 유형의 서비스를 생성하는 방법과 다른 애플리케이션 구성 요소에서
+
다음 섹션에서는 각 유형의 서비스를 생성하는 방법과 다른 애플리케이션 구성 요소에서
이를 사용하는 방법을 배우게 됩니다.
매니페스트에서 서비스 선언하기
-
액티비티(및 다른 구성 요소)와 마찬가지로, 서비스는 모두 애플리케이션의 매니페스트
+
액티비티(및 다른 구성 요소)와 마찬가지로, 서비스는 모두 애플리케이션의 매니페스트
파일에서 선언해야 합니다.
{@code <service>} 요소에 포함시킬 수 있는 다른 속성도 있습니다.
-이를 포함시켜 서비스를 시작하는 데 필요한 권한과 서비스가 실행되어야 하는 프로세스 등의
+
{@code <service>} 요소에 포함시킬 수 있는 다른 속성도 있습니다.
+이를 포함시켜 서비스를 시작하는 데 필요한 권한과 서비스가 실행되어야 하는 프로세스 등의
속성을 정의할 수 있습니다. {@code android:name}
-속성이 유일한 필수 속성입니다. 이것은 서비스의 클래스 이름을 나타냅니다. 일단 애플리케이션을
-게시하고 나면 이 이름을 변경해서는 안 됩니다. 이름을 변경하면
+속성이 유일한 필수 속성입니다. 이것은 서비스의 클래스 이름을 나타냅니다. 일단 애플리케이션을
+게시하고 나면 이 이름을 변경해서는 안 됩니다. 이름을 변경하면
서비스를 시작하거나 바인딩할 명시적 인텐트에 대한 종속성으로 인해 코드를 단절시킬 위험이 있기 때문입니다(블로그 게시물의
바꿀 수 없는 항목을 참조하십시오).
앱의 보안을 보장하려면
-{@link android.app.Service}을 시작하거나 바인딩할 때 항상 명시적 인텐트를 사용하고 서비스에 대한 인텐트 필터는 선언하지 마십시오. 어느
-서비스를 시작할지 어느 정도 모호성을 허용하는 것이 중요한 경우, 서비스에 대해
+{@link android.app.Service}을 시작하거나 바인딩할 때 항상 명시적 인텐트를 사용하고 서비스에 대한 인텐트 필터는 선언하지 마십시오. 어느
+서비스를 시작할지 어느 정도 모호성을 허용하는 것이 중요한 경우, 서비스에 대해
인텐트 필터를 제공하고 구성 요소 이름을 {@link
android.content.Intent}에서 배제할 수 있지만, 그러면 해당 인텐트에 대한 패키지를 {@link
-android.content.Intent#setPackage setPackage()}로 설정하여 대상 서비스에 대해 충분한 명확화를
+android.content.Intent#setPackage setPackage()}로 설정하여 대상 서비스에 대해 충분한 명확화를
제공하도록 해야 합니다.
-
이외에도 서비스를 본인의 앱에만 사용 가능하도록 보장할 수도 있습니다.
+
이외에도 서비스를 본인의 앱에만 사용 가능하도록 보장할 수도 있습니다.
{@code android:exported}
- 속성을 포함시킨 뒤 이를 {@code "false"}로 설정하면 됩니다. 이렇게 하면 다른 앱이 여러분의 서비스를 시작하지 못하도록 효과적으로 방지해주며,
+ 속성을 포함시킨 뒤 이를 {@code "false"}로 설정하면 됩니다. 이렇게 하면 다른 앱이 여러분의 서비스를 시작하지 못하도록 효과적으로 방지해주며,
이는 명시적 인텐트를 사용하는 경우에도 문제 없이 적용됩니다.
@@ -229,71 +229,71 @@ android.content.Intent#setPackage setPackage()}로 설정하여 대상 서비스
시작된 서비스 생성하기
시작된 서비스란 다른 구성 요소가 {@link
-android.content.Context#startService startService()}를 호출하여 시작하고, 그 결과 서비스의
+android.content.Context#startService startService()}를 호출하여 시작하고, 그 결과 서비스의
{@link android.app.Service#onStartCommand onStartCommand()} 메서드를 호출하는 결과를 초래한 것을 말합니다.
-
서비스가 시작되면 이를 시작한 구성 요소와 독립된 자신만의
-수명 주기를 가지며 해당 서비스는 배경에서 무기한으로 실행될 수 있습니다. 이는 해당 서비스를
-시작한 구성 요소가 소멸되었더라도 무관합니다. 따라서, 서비스는 작업이 완료되면
-{@link android.app.Service#stopSelf stopSelf()}를 호출하여 스스로 알아서 중단되는 것이 정상이며 아니면 다른 구성 요소가
+
서비스가 시작되면 이를 시작한 구성 요소와 독립된 자신만의
+수명 주기를 가지며 해당 서비스는 배경에서 무기한으로 실행될 수 있습니다. 이는 해당 서비스를
+시작한 구성 요소가 소멸되었더라도 무관합니다. 따라서, 서비스는 작업이 완료되면
+{@link android.app.Service#stopSelf stopSelf()}를 호출하여 스스로 알아서 중단되는 것이 정상이며 아니면 다른 구성 요소가
{@link android.content.Context#stopService stopService()}를 호출하여 중단시킬 수도 있습니다.
애플리케이션 구성 요소(예: 액티비티)가 서비스를 시작하려면 {@link
-android.content.Context#startService startService()}를 호출하고, {@link android.content.Intent}를
-전달하면 됩니다. 이것은 서비스를 나타내고 서비스가 사용할 모든 데이터를 포함합니다. 서비스는 이
+android.content.Context#startService startService()}를 호출하고, {@link android.content.Intent}를
+전달하면 됩니다. 이것은 서비스를 나타내고 서비스가 사용할 모든 데이터를 포함합니다. 서비스는 이
{@link android.content.Intent}를 {@link android.app.Service#onStartCommand
onStartCommand()} 메서드에서 수신합니다.
-
예를 들어 어느 액티비티가 온라인 데이터베이스에 데이터를 약간 저장해야 한다고 가정합니다. 액티비티가
+
예를 들어 어느 액티비티가 온라인 데이터베이스에 데이터를 약간 저장해야 한다고 가정합니다. 액티비티가
동반자 서비스를 시작하여 저장할 데이터를 이에 전달할 수 있습니다. 이때 인텐트를 {@link
android.content.Context#startService startService()}에 전달하면 됩니다. 서비스는 이 인텐트를 {@link
-android.app.Service#onStartCommand onStartCommand()}에서 수신하고 인터넷에 연결한 다음 데이터베이스
-트랜잭션을 수행합니다. 작업을 완료하면, 해당 서비스는 알아서 스스로 중단되고
+android.app.Service#onStartCommand onStartCommand()}에서 수신하고 인터넷에 연결한 다음 데이터베이스
+트랜잭션을 수행합니다. 작업을 완료하면, 해당 서비스는 알아서 스스로 중단되고
소멸됩니다.
-
주의: 서비스는 기본적으로 자신이 선언된 애플리케이션의 같은
-프로세스에서 실행되기도 하고 해당 애플리케이션의 기본 스레드에서 실행되기도 합니다. 따라서, 사용자가
-같은 애플리케이션의 액티비티와 상호 작용하는 동안 서비스가 집약적이거나 차단적인 작업을 수행하는 경우,
-해당 서비스 때문에 액티비티 성능이 느려지게 됩니다. 애플리케이션 성능에 영향을 미치는 것을 방지하려면,
+
주의: 서비스는 기본적으로 자신이 선언된 애플리케이션의 같은
+프로세스에서 실행되기도 하고 해당 애플리케이션의 기본 스레드에서 실행되기도 합니다. 따라서, 사용자가
+같은 애플리케이션의 액티비티와 상호 작용하는 동안 서비스가 집약적이거나 차단적인 작업을 수행하는 경우,
+해당 서비스 때문에 액티비티 성능이 느려지게 됩니다. 애플리케이션 성능에 영향을 미치는 것을 방지하려면,
서비스 내에서 새 스레드를 시작해야 합니다.
기존에는 시작된 서비스를 생성하기 위해 확장할 수 있는 클래스가 두 개 있었습니다.
{@link android.app.Service}
-
이것이 모든 서비스의 기본 클래스입니다. 이 클래스를 확장하는 경우, 서비스의 모든 작업을 수행할
-새 스레드를 만드는 것이 중요합니다. 서비스가 기본적으로 애플리케이션의 기본 스레드를 사용하기
-때문인데, 이로 인해 애플리케이션이 실행 중인 모든 액티비티의 성능이
+
이것이 모든 서비스의 기본 클래스입니다. 이 클래스를 확장하는 경우, 서비스의 모든 작업을 수행할
+새 스레드를 만드는 것이 중요합니다. 서비스가 기본적으로 애플리케이션의 기본 스레드를 사용하기
+때문인데, 이로 인해 애플리케이션이 실행 중인 모든 액티비티의 성능이
느려질 수 있기 때문입니다.
{@link android.app.IntentService}
-
이것은 {@link android.app.Service}의 하위 클래스로, 작업자 스레드를
-사용하여 모든 시작 요청을 처리하되 한 번에 하나씩 처리합니다. 서비스가 여러 개의 요청을
+
이것은 {@link android.app.Service}의 하위 클래스로, 작업자 스레드를
+사용하여 모든 시작 요청을 처리하되 한 번에 하나씩 처리합니다. 서비스가 여러 개의 요청을
동시에 처리하지 않아도 되는 경우 이것이 최선의 옵션입니다. 해야 할 일은 {@link
-android.app.IntentService#onHandleIntent onHandleIntent()}를 구현하는 것뿐으로, 이것이 각 시작 요청에 대한 인텐트를 수신하여
+android.app.IntentService#onHandleIntent onHandleIntent()}를 구현하는 것뿐으로, 이것이 각 시작 요청에 대한 인텐트를 수신하여
개발자는 배경 작업을 수행할 수 있습니다.
-
다음 섹션에서는 이와 같은 클래스 중 하나를 사용하여 서비스를 구현하는 방법을
+
다음 섹션에서는 이와 같은 클래스 중 하나를 사용하여 서비스를 구현하는 방법을
설명합니다.
IntentService 클래스 확장하기
대부분의 시작된 서비스는 여러 개의 요청을 동시에 처리하지 않아도 되기 때문에
-(이는 사실 위험한 다중 스레딩 시나리오일 수 있습니다), 서비스를 구현할 때에는
+(이는 사실 위험한 다중 스레딩 시나리오일 수 있습니다), 서비스를 구현할 때에는
{@link android.app.IntentService} 클래스를 사용하는 것이 최선의 방안일 것입니다.
{@link android.app.IntentService}는 다음과 같은 작업을 수행합니다.
애플리케이션의 기본 스레드와는 별도로 {@link
-android.app.Service#onStartCommand onStartCommand()}에 전달된 모든 인텐트를 실행하는 기본 작업자 스레드를
+android.app.Service#onStartCommand onStartCommand()}에 전달된 모든 인텐트를 실행하는 기본 작업자 스레드를
생성합니다.
한 번에 인텐트를 하나씩 {@link
-android.app.IntentService#onHandleIntent onHandleIntent()} 구현에 전달하는 작업 대기열을 생성하므로 다중 스레딩에 대해 염려할 필요가
+android.app.IntentService#onHandleIntent onHandleIntent()} 구현에 전달하는 작업 대기열을 생성하므로 다중 스레딩에 대해 염려할 필요가
전혀 없습니다.
-
시작 요청이 모두 처리된 후 서비스를 중단하므로 개발자가
+
시작 요청이 모두 처리된 후 서비스를 중단하므로 개발자가
{@link android.app.Service#stopSelf}를 호출할 필요가 전혀 없습니다.
-
{@link android.app.IntentService#onBind onBind()}의 기본 구현을 제공하여 null을
+
{@link android.app.IntentService#onBind onBind()}의 기본 구현을 제공하여 null을
반환하도록 합니다.
{@link android.app.IntentService#onStartCommand
onStartCommand()}의 기본 구현을 제공하여 인텐트를 작업 대기열에 보내고, 다음으로 {@link
@@ -301,7 +301,7 @@ android.app.IntentService#onHandleIntent onHandleIntent()} 구현에 보내도
이 모든 것은 결론적으로 개발자가 직접 할 일은 클라이언트가 제공한 작업을 수행할 {@link
-android.app.IntentService#onHandleIntent onHandleIntent()}를 구현하는 것뿐이라는 사실로
+android.app.IntentService#onHandleIntent onHandleIntent()}를 구현하는 것뿐이라는 사실로
이어집니다. (다만, 서비스에 대해 작은 생성자를 제공해야 하기도 합니다.)
다음은 {@link android.app.IntentService}의 구현을 예시로 나타낸 것입니다.
다른 콜백 메서드도 재정의하기로 결정하는 경우-예를 들어 {@link
android.app.IntentService#onCreate onCreate()}, {@link
android.app.IntentService#onStartCommand onStartCommand()} 또는 {@link
-android.app.IntentService#onDestroy onDestroy()}-슈퍼 구현을 꼭 호출해야 합니다.
+android.app.IntentService#onDestroy onDestroy()}-슈퍼 구현을 꼭 호출해야 합니다.
그래야 {@link android.app.IntentService}가 작업자 스레드의 수명을 적절하게 처리할 수 있습니다.
-
예를 들어 {@link android.app.IntentService#onStartCommand onStartCommand()}는 반드시
+
예를 들어 {@link android.app.IntentService#onStartCommand onStartCommand()}는 반드시
기본 구현을 반환해야 합니다(이로써 인텐트가 {@link
android.app.IntentService#onHandleIntent onHandleIntent()}로 전달되는 것입니다).
@@ -360,25 +360,25 @@ public int onStartCommand(Intent intent, int flags, int startId) {
}
-
{@link android.app.IntentService#onHandleIntent onHandleIntent()} 외에 슈퍼 클래스를
+
{@link android.app.IntentService#onHandleIntent onHandleIntent()} 외에 슈퍼 클래스를
호출하지 않아도 되는 유일한 메서드는 {@link android.app.IntentService#onBind
onBind()}입니다(다만 이를 구현하는 것은 서비스가 바인딩을 허용할 때에만 필요합니다).
-
다음 섹션에서는 기본 {@link android.app.Service}
-클래스를 확장할 때 같은 종류의 서비스를 구현하는 방법을 배우게 됩니다. 이때에는 코드가 훨씬 많이 필요하지만,
+
다음 섹션에서는 기본 {@link android.app.Service}
+클래스를 확장할 때 같은 종류의 서비스를 구현하는 방법을 배우게 됩니다. 이때에는 코드가 훨씬 많이 필요하지만,
동시 시작 요청을 처리해야 하는 경우 이것이 적절할 수 있습니다.
서비스 클래스 확장하기
-
이전 섹션에서 본 것과 같이 {@link android.app.IntentService}를 사용하면
-시작된 서비스 구현이 매우 단순해집니다. 하지만 서비스가 다중 스레딩을
-수행해야 하는 경우(작업 대기열을 통해 시작 요청을 처리하는 대신), 그때는
+
이전 섹션에서 본 것과 같이 {@link android.app.IntentService}를 사용하면
+시작된 서비스 구현이 매우 단순해집니다. 하지만 서비스가 다중 스레딩을
+수행해야 하는 경우(작업 대기열을 통해 시작 요청을 처리하는 대신), 그때는
{@link android.app.Service} 클래스를 확장하여 각 인텐트를 처리하게 할 수 있습니다.
비교를 위해 다음 예시의 코드를 보겠습니다. 이는 {@link
android.app.Service} 클래스의 구현으로, 위의 예시에서 {@link
-android.app.IntentService}를 사용하여 수행한 것과 똑같은 작업을 수행합니다. 바꿔 말하면 각 시작 요청에 대해
+android.app.IntentService}를 사용하여 수행한 것과 똑같은 작업을 수행합니다. 바꿔 말하면 각 시작 요청에 대해
작업자 스레드를 사용하여 작업을 수행하고 한 번에 요청을 하나씩만 처리한다는 뜻입니다.
@@ -455,46 +455,46 @@ public class HelloService extends Service {
보시다시피 {@link android.app.IntentService}를 사용할 때보다 훨씬 손이 많이 갑니다.
그러나, 각 호출을 {@link android.app.Service#onStartCommand
-onStartCommand()}로 직접 처리할 수 있기 때문에 여러 개의 요청을 동시에 수행할 수 있습니다. 이 예시는 그것을
-보여주는 것은 아니지만, 그런 작업을 원하는 경우 각 요청에 대해 새 스레드를
+onStartCommand()}로 직접 처리할 수 있기 때문에 여러 개의 요청을 동시에 수행할 수 있습니다. 이 예시는 그것을
+보여주는 것은 아니지만, 그런 작업을 원하는 경우 각 요청에 대해 새 스레드를
하나씩 생성한 다음 곧바로 실행하면 됩니다(이전 요청이 끝날 때까지 기다리는 대신).
-
{@link android.app.Service#onStartCommand onStartCommand()} 메서드가 반드시
-정수를 반환해야 한다는 사실을 유의하십시오. 정수는 시스템이 서비스를 중단시킨 경우 시스템이 해당 서비스를
+
{@link android.app.Service#onStartCommand onStartCommand()} 메서드가 반드시
+정수를 반환해야 한다는 사실을 유의하십시오. 정수는 시스템이 서비스를 중단시킨 경우 시스템이 해당 서비스를
계속하는 방법에 대해 설명하는 값입니다(위에서 논한 바와 같이 {@link
-android.app.IntentService}의 기본 구현이 이것을 개발자 대신 처리해줍니다. 개발자가 이를 수정할 수도 있습니다).
-{@link android.app.Service#onStartCommand onStartCommand()}로부터의 반환 값은 반드시
+android.app.IntentService}의 기본 구현이 이것을 개발자 대신 처리해줍니다. 개발자가 이를 수정할 수도 있습니다).
+{@link android.app.Service#onStartCommand onStartCommand()}로부터의 반환 값은 반드시
다음 상수 중 하나여야 합니다.
{@link android.app.Service#START_NOT_STICKY}
시스템이 서비스를 {@link android.app.Service#onStartCommand
-onStartCommand()} 반환 후에 중단시키면 서비스를 재생성하면 안 됩니다. 다만 전달할
-보류 인텐트가 있는 경우는 예외입니다. 이것은 서비스가 불필요하게 실행되는 일을 피할 수 있는 가장 안전한 옵션이며,
+onStartCommand()} 반환 후에 중단시키면 서비스를 재생성하면 안 됩니다. 다만 전달할
+보류 인텐트가 있는 경우는 예외입니다. 이것은 서비스가 불필요하게 실행되는 일을 피할 수 있는 가장 안전한 옵션이며,
애플리케이션이 완료되지 않은 모든 작업을 단순히 재시작할 수 있을 때 좋습니다.
{@link android.app.Service#START_STICKY}
시스템이 서비스를 {@link android.app.Service#onStartCommand
onStartCommand()} 반환 후에 중단시키는 경우, 서비스를 재생성하고 {@link
-android.app.Service#onStartCommand onStartCommand()}를 호출하되 마지막 인텐트를 다시 전달하지는 마십시오.
-그 대신, 시스템이 null 인텐트로 {@link android.app.Service#onStartCommand onStartCommand()}를
-호출합니다. 다만 서비스를 시작할 보류 인텐트가 있는 경우만은 예외이며, 이럴 때에는
-그러한 인텐트를 전달합니다. 이것은 명령을 실행하지는 않지만 무기한으로 실행 중이며 작업을 기다리고 있는
+android.app.Service#onStartCommand onStartCommand()}를 호출하되 마지막 인텐트를 다시 전달하지는 마십시오.
+그 대신, 시스템이 null 인텐트로 {@link android.app.Service#onStartCommand onStartCommand()}를
+호출합니다. 다만 서비스를 시작할 보류 인텐트가 있는 경우만은 예외이며, 이럴 때에는
+그러한 인텐트를 전달합니다. 이것은 명령을 실행하지는 않지만 무기한으로 실행 중이며 작업을 기다리고 있는
미디어 플레이어(또는 그와 비슷한 서비스)에 적합합니다.
시스템이 서비스를 {@link android.app.Service#onStartCommand
onStartCommand()} 반환 후에 중단시키는 경우, 서비스를 재생성하고 서비스에 전달된 마지막 인텐트로 {@link
-android.app.Service#onStartCommand onStartCommand()}를
-호출하십시오. 모든 보류 인텐트가 차례로 전달됩니다. 이것은 즉시 재개되어야 하는 작업을
+android.app.Service#onStartCommand onStartCommand()}를
+호출하십시오. 모든 보류 인텐트가 차례로 전달됩니다. 이것은 즉시 재개되어야 하는 작업을
능동적으로 수행 중인 서비스(예를 들어 파일 다운로드 등)에 적합합니다.
-
이러한 반환 값에 대한 자세한 내용은 각 상수에 대해 링크로 연결된 참조 문서를
+
이러한 반환 값에 대한 자세한 내용은 각 상수에 대해 링크로 연결된 참조 문서를
확인하십시오.
서비스 시작
-
액티비티나 다른 구성 요소에서 서비스를 시작하려면
+
액티비티나 다른 구성 요소에서 서비스를 시작하려면
{@link android.content.Intent}를(시작할 서비스를 나타냄) {@link
android.content.Context#startService startService()}에 전달하면 됩니다. Android 시스템이 서비스의 {@link
android.app.Service#onStartCommand onStartCommand()} 메서드를 호출하여 여기에 {@link
@@ -510,53 +510,53 @@ Intent intent = new Intent(this, HelloService.class);
startService(intent);
-
{@link android.content.Context#startService startService()} 메서드가 즉시 반환되며
+
{@link android.content.Context#startService startService()} 메서드가 즉시 반환되며
Android 시스템이 서비스의 {@link android.app.Service#onStartCommand
onStartCommand()} 메서드를 호출합니다. 서비스가 이미 실행 중이지 않은 경우, 시스템은 우선 {@link
android.app.Service#onCreate onCreate()}를 호출하고, 다음으로 {@link android.app.Service#onStartCommand
onStartCommand()}를 호출합니다.
서비스가 바인딩도 제공하지 않는 경우, {@link
-android.content.Context#startService startService()}와 함께 전달된 인텐트가 애플리케이션 구성 요소와 서비스 사이의
-유일한 통신 방법입니다. 그러나 서비스가 결과를 돌려보내기를 원하는 경우, 서비스를 시작한
-클라이언트가 브로드캐스트를 위해 {@link android.app.PendingIntent}를
-만들 수 있고({@link android.app.PendingIntent#getBroadcast getBroadcast()} 사용) 이를 서비스를 시작한
-{@link android.content.Intent} 내의 서비스에 전달할 수 있습니다. 그러면 서비스가
+android.content.Context#startService startService()}와 함께 전달된 인텐트가 애플리케이션 구성 요소와 서비스 사이의
+유일한 통신 방법입니다. 그러나 서비스가 결과를 돌려보내기를 원하는 경우, 서비스를 시작한
+클라이언트가 브로드캐스트를 위해 {@link android.app.PendingIntent}를
+만들 수 있고({@link android.app.PendingIntent#getBroadcast getBroadcast()} 사용) 이를 서비스를 시작한
+{@link android.content.Intent} 내의 서비스에 전달할 수 있습니다. 그러면 서비스가
이 브로드캐스트를 사용하여 결과를 전달할 수 있게 됩니다.
-
서비스를 시작하기 위한 여러 개의 요청은 서비스의
-{@link android.app.Service#onStartCommand onStartCommand()}로의 상응하는 여러 개의 호출이라는 결과를 낳습니다. 하지만, 서비스를 중단하려면
+
서비스를 시작하기 위한 여러 개의 요청은 서비스의
+{@link android.app.Service#onStartCommand onStartCommand()}로의 상응하는 여러 개의 호출이라는 결과를 낳습니다. 하지만, 서비스를 중단하려면
이를 중단하라는 요청 하나({@link android.app.Service#stopSelf stopSelf()} 또는 {@link
android.content.Context#stopService stopService()} 사용)만 있으면 됩니다.
서비스 중단
-
시작된 서비스는 자신만의 수명 주기를 직접 관리해야 합니다. 다시 말해, 시스템이
-서비스를 중단하거나 소멸시키지 않는다는 뜻입니다. 다만 시스템 메모리를 회복해야 하고 서비스가
-{@link android.app.Service#onStartCommand onStartCommand()} 반환 후에도 계속 실행되는 경우는 예외입니다. 따라서,
-서비스는 {@link android.app.Service#stopSelf stopSelf()}를 호출하여 스스로 중단시켜야 하고, 아니면
+
시작된 서비스는 자신만의 수명 주기를 직접 관리해야 합니다. 다시 말해, 시스템이
+서비스를 중단하거나 소멸시키지 않는다는 뜻입니다. 다만 시스템 메모리를 회복해야 하고 서비스가
+{@link android.app.Service#onStartCommand onStartCommand()} 반환 후에도 계속 실행되는 경우는 예외입니다. 따라서,
+서비스는 {@link android.app.Service#stopSelf stopSelf()}를 호출하여 스스로 중단시켜야 하고, 아니면
다른 구성 요소가 {@link android.content.Context#stopService stopService()}를 호출하여 이를 중단시킬 수 있습니다.
일단 {@link android.app.Service#stopSelf stopSelf()} 또는 {@link
-android.content.Context#stopService stopService()}로 중단하기를 요청하고 나면 시스템이 서비스를 가능한 한 빨리
+android.content.Context#stopService stopService()}로 중단하기를 요청하고 나면 시스템이 서비스를 가능한 한 빨리
소멸시킵니다.
그러나, 서비스가 {@link
-android.app.Service#onStartCommand onStartCommand()}로의 요청을 동시에 여러 개 처리하기를 바라는 경우라면 시작 요청 처리를 완료한 뒤에도
-서비스를 중단하면 안 됩니다. 그 이후 새 시작 요청을 받았을 수 있기
-때문입니다(첫 요청 종료 시에 중단하면 두 번째 요청을 종료시킵니다). 이 문제를
-피하려면, {@link android.app.Service#stopSelf(int)}를 사용하여 서비스를
+android.app.Service#onStartCommand onStartCommand()}로의 요청을 동시에 여러 개 처리하기를 바라는 경우라면 시작 요청 처리를 완료한 뒤에도
+서비스를 중단하면 안 됩니다. 그 이후 새 시작 요청을 받았을 수 있기
+때문입니다(첫 요청 종료 시에 중단하면 두 번째 요청을 종료시킵니다). 이 문제를
+피하려면, {@link android.app.Service#stopSelf(int)}를 사용하여 서비스를
중단시키라는 개발자의 요청이 항상 최신 시작 요청에 기반하도록 해야 합니다. 다시 말해, {@link
-android.app.Service#stopSelf(int)}를 호출할 때면 시작 요청의 ID({@link android.app.Service#onStartCommand onStartCommand()}에 전달된
-startId)를 전달하게 됩니다. 여기에 중단 요청이
+android.app.Service#stopSelf(int)}를 호출할 때면 시작 요청의 ID({@link android.app.Service#onStartCommand onStartCommand()}에 전달된
+startId)를 전달하게 됩니다. 여기에 중단 요청이
부합됩니다. 그런 다음 개발자가 {@link
android.app.Service#stopSelf(int)}를 호출할 수 있기 전에 서비스가 새 시작 요청을 받은 경우, ID가 일치하지 않게 되고 서비스는 중단되지 않습니다.
-
주의: 서비스가 작업을 완료한 다음 애플리케이션이
-소속 서비스를 중단할 수 있어야 한다는 점이 중요합니다. 그래야 시스템 리소스 낭비를 피하고 배터리 전력 소모를 줄일 수 있습니다. 필요한 경우
+
주의: 서비스가 작업을 완료한 다음 애플리케이션이
+소속 서비스를 중단할 수 있어야 한다는 점이 중요합니다. 그래야 시스템 리소스 낭비를 피하고 배터리 전력 소모를 줄일 수 있습니다. 필요한 경우
다른 구성 요소도 서비스를 중단시킬 수 있습니다. {@link
-android.content.Context#stopService stopService()}를 호출하면 됩니다. 서비스에 대해 바인딩을 활성화하더라도,
+android.content.Context#stopService stopService()}를 호출하면 됩니다. 서비스에 대해 바인딩을 활성화하더라도,
서비스가 {@link
android.app.Service#onStartCommand onStartCommand()}로의 호출을 한 번이라도 받았으면 항상 서비스를 직접 중단시켜야 합니다.
@@ -571,32 +571,32 @@ android.content.Context#bindService bindService()}를 호출하여 오래 지속
(또한 보통은 구성 요소가 {@link
android.content.Context#startService startService()}를 호출하여 서비스를 시작하는 것을 허용하지 않습니다).
-
액티비티와 애플리케이션의 다른 구성 요소에서 서비스와 상호 작용하기를 원하는 경우
-바인딩된 서비스를 생성해야 합니다. 아니면 애플리케이션의 기능 몇 가지를 프로세스 간 통신(IPC)을 통해
+
액티비티와 애플리케이션의 다른 구성 요소에서 서비스와 상호 작용하기를 원하는 경우
+바인딩된 서비스를 생성해야 합니다. 아니면 애플리케이션의 기능 몇 가지를 프로세스 간 통신(IPC)을 통해
다른 애플리케이션에 노출하고자 하는 경우에도 좋습니다.
바인딩된 서비스를 생성하려면 {@link
-android.app.Service#onBind onBind()} 콜백 메서드를 구현하여 서비스와의 통신을 위한 인터페이스를 정의하는
-{@link android.os.IBinder}를 반환하도록 해야 합니다. 그러면 다른 애플리케이션 구성 요소가
-{@link android.content.Context#bindService bindService()}를 호출하여 해당 인터페이스를 검색하고, 서비스에 있는 메서드를
-호출하기 시작할 수 있습니다. 서비스는 자신에게 바인딩된 애플리케이션 구성 요소에게 도움이 되기 위해서만
-존재하는 것이므로, 서비스에 바인딩된 구성 요소가 없으면 시스템이 이를 소멸시킵니다(바인딩된 서비스는 시작된 서비스처럼
-{@link android.app.Service#onStartCommand onStartCommand()}를 통해
+android.app.Service#onBind onBind()} 콜백 메서드를 구현하여 서비스와의 통신을 위한 인터페이스를 정의하는
+{@link android.os.IBinder}를 반환하도록 해야 합니다. 그러면 다른 애플리케이션 구성 요소가
+{@link android.content.Context#bindService bindService()}를 호출하여 해당 인터페이스를 검색하고, 서비스에 있는 메서드를
+호출하기 시작할 수 있습니다. 서비스는 자신에게 바인딩된 애플리케이션 구성 요소에게 도움이 되기 위해서만
+존재하는 것이므로, 서비스에 바인딩된 구성 요소가 없으면 시스템이 이를 소멸시킵니다(바인딩된 서비스는 시작된 서비스처럼
+{@link android.app.Service#onStartCommand onStartCommand()}를 통해
중단시키지 않아도 됩니다).
-
바인딩된 서비스를 생성하려면 가장 먼저 해야 할 일은 클라이언트가 서비스와
-통신할 수 있는 방법을 나타내는 인터페이스를 정의하는 것입니다. 서비스와 클라이언트 사이에서 쓰이는 이 인터페이스는
-반드시 {@link android.os.IBinder}의 구현이어야 하며 이를
+
바인딩된 서비스를 생성하려면 가장 먼저 해야 할 일은 클라이언트가 서비스와
+통신할 수 있는 방법을 나타내는 인터페이스를 정의하는 것입니다. 서비스와 클라이언트 사이에서 쓰이는 이 인터페이스는
+반드시 {@link android.os.IBinder}의 구현이어야 하며 이를
서비스가 {@link android.app.Service#onBind
-onBind()} 콜백 메서드에서 반환해야 합니다. 클라이언트가 {@link android.os.IBinder}를 수신하면 해당 인터페이스를 통해 서비스와
+onBind()} 콜백 메서드에서 반환해야 합니다. 클라이언트가 {@link android.os.IBinder}를 수신하면 해당 인터페이스를 통해 서비스와
상호 작용을 시작할 수 있습니다.
-
여러 클라이언트가 서비스에 한꺼번에 바인딩될 수 있습니다. 클라이언트가 서비스와의 상호 작용을 완료하면 이는
-{@link android.content.Context#unbindService unbindService()}를 호출하여 바인딩을 해제합니다. 서비스에
+
여러 클라이언트가 서비스에 한꺼번에 바인딩될 수 있습니다. 클라이언트가 서비스와의 상호 작용을 완료하면 이는
+{@link android.content.Context#unbindService unbindService()}를 호출하여 바인딩을 해제합니다. 서비스에
바인딩된 클라이언트가 하나도 없으면 시스템이 해당 서비스를 소멸시킵니다.
-
바인딩된 서비스를 구현하는 데에는 여러 가지 방법이 있으며 그러한 구현은 시작된 서비스보다
-훨씬 복잡합니다. 따라서 바인딩된 서비스 논의는
+
바인딩된 서비스를 구현하는 데에는 여러 가지 방법이 있으며 그러한 구현은 시작된 서비스보다
+훨씬 복잡합니다. 따라서 바인딩된 서비스 논의는
바인딩된 서비스에 관한 별도의 문서에서 다룹니다.
서비스는 일단 실행되고 나면 사용자에게 알림 메시지 또는 상태 표시줄 알림 등을 사용해 이벤트를 알릴 수 있습니다.
-
알림 메시지란 현재 창의 표면에 잠시 나타났다가 사라지는 메시지이고,
-상태 표시줄 알림은 상태 표시줄에 메시지가 담긴 아이콘을 제공하여 사용자가 이를 선택하여
+
알림 메시지란 현재 창의 표면에 잠시 나타났다가 사라지는 메시지이고,
+상태 표시줄 알림은 상태 표시줄에 메시지가 담긴 아이콘을 제공하여 사용자가 이를 선택하여
조치를 취할 수 있게 하는 것입니다(예: 액티비티 시작).
보통, 일종의 배경 작업이 완료되었고
-(예: 파일 다운로드 완료) 이제 사용자가 그에 대해 조치를 취할 수 있는 경우 상태 표시줄 알림이
-최선의 기법입니다. 사용자가 확장된 보기에서 알림을 선택하면,
+(예: 파일 다운로드 완료) 이제 사용자가 그에 대해 조치를 취할 수 있는 경우 상태 표시줄 알림이
+최선의 기법입니다. 사용자가 확장된 보기에서 알림을 선택하면,
해당 알림이 액티비티를 시작할 수 있습니다(예: 다운로드한 파일 보기).
자세한 정보는 알림 메시지 또는 상태 표시줄 알림
@@ -621,19 +621,19 @@ onBind()} 콜백 메서드에서 반환해야 합니다. 클라이언트가 {@li
전경에서 서비스 실행하기
-
전경 서비스는 사용자가 능동적으로 인식하고 있으므로 메모리 부족 시에도
-시스템이 중단할 후보로 고려되지 않는 서비스를 말합니다. 전경
-서비스는 상태 표시줄에 대한 알림을 제공해야 합니다. 이것은
-"진행 중" 제목 아래에 배치되며, 이는 곧 해당 알림은 서비스가 중단되었거나
+
전경 서비스는 사용자가 능동적으로 인식하고 있으므로 메모리 부족 시에도
+시스템이 중단할 후보로 고려되지 않는 서비스를 말합니다. 전경
+서비스는 상태 표시줄에 대한 알림을 제공해야 합니다. 이것은
+"진행 중" 제목 아래에 배치되며, 이는 곧 해당 알림은 서비스가 중단되었거나
전경에서 제거되지 않은 이상 무시할 수 없다는 뜻입니다.
-
예를 들어 서비스에서 음악을 재생하는 음악 플레이어는 전경에서
-실행되도록 설정해야 합니다. 사용자가 이것의 작동을 분명히 인식하고 있기
-때문입니다. 상태 표시줄에 있는 알림은 현재 노래를 나타내고
+
예를 들어 서비스에서 음악을 재생하는 음악 플레이어는 전경에서
+실행되도록 설정해야 합니다. 사용자가 이것의 작동을 분명히 인식하고 있기
+때문입니다. 상태 표시줄에 있는 알림은 현재 노래를 나타내고
사용자로 하여금 음악 플레이어와 상호 작용할 액티비티를 시작하게 해줄 수도 있습니다.
서비스가 전경에서 실행되도록 요청하려면 {@link
-android.app.Service#startForeground startForeground()}를 호출하면 됩니다. 이 메서드는 두 개의 매개변수를 취합니다.
+android.app.Service#startForeground startForeground()}를 호출하면 됩니다. 이 메서드는 두 개의 매개변수를 취합니다.
그 중 하나는 해당 알림을 고유하게 식별하는 정수이고 다른 하나는 상태 표시줄에 해당되는 {@link
android.app.Notification}입니다. 예:
@@ -652,48 +652,48 @@ android.app.Service#startForeground startForeground()}에 부여하는 정수 ID
서비스를 전경에서 제거하려면 {@link
-android.app.Service#stopForeground stopForeground()}를 호출하면 됩니다. 이 메서드는 부울 값을 취하며, 이것이
+android.app.Service#stopForeground stopForeground()}를 호출하면 됩니다. 이 메서드는 부울 값을 취하며, 이것이
상태 표시줄 알림도 제거할지 여부를 나타냅니다. 이 메서드는 서비스를 중단시키지 않습니다.
- 그러나, 서비스가 전경에서 실행 중인 동안 서비스를 중단시키면
+ 그러나, 서비스가 전경에서 실행 중인 동안 서비스를 중단시키면
알림도 마찬가지로 제거됩니다.
서비스의 수명 주기는 액티비티의 수명 주기보다 훨씬 간단합니다. 하지만, 서비스를 생성하고
-소멸시키는 방법에 특히 주의를 기울여야 한다는 면에서 중요도는 이쪽이 더 높습니다. 서비스는 사용자가 모르는 채로
+
서비스의 수명 주기는 액티비티의 수명 주기보다 훨씬 간단합니다. 하지만, 서비스를 생성하고
+소멸시키는 방법에 특히 주의를 기울여야 한다는 면에서 중요도는 이쪽이 더 높습니다. 서비스는 사용자가 모르는 채로
배경에서 실행될 수 있기 때문입니다.
-
서비스 수명 주기—생성되었을 때부터 소멸될 때까지—는 두 가지 서로 다른 경로를
+
서비스 수명 주기—생성되었을 때부터 소멸될 때까지—는 두 가지 서로 다른 경로를
따를 수 있습니다.
시작된 서비스
서비스는 또 다른 구성 요소가 {@link
-android.content.Context#startService startService()}를 호출하면 생성됩니다. 그러면 서비스가 무기한으로 실행될 수 있으며
+android.content.Context#startService startService()}를 호출하면 생성됩니다. 그러면 서비스가 무기한으로 실행될 수 있으며
스스로 알아서 중단되어야 합니다. 이때 {@link
-android.app.Service#stopSelf() stopSelf()}를 호출하는 방법을 씁니다. 또 다른 구성 요소도 서비스를 중단시킬 수
+android.app.Service#stopSelf() stopSelf()}를 호출하는 방법을 씁니다. 또 다른 구성 요소도 서비스를 중단시킬 수
있습니다. {@link android.content.Context#stopService
stopService()}를 호출하면 됩니다. 서비스가 중단되면 시스템이 이를 소멸시킵니다.
바인딩된 서비스
서비스는 또 다른 구성 요소(클라이언트)가 {@link
-android.content.Context#bindService bindService()}를 호출하면 생성됩니다. 그러면 클라이언트가
-{@link android.os.IBinder} 인터페이스를 통해 서비스와 통신을 주고받을 수 있습니다. 클라이언트가 연결을 종료하려면
-{@link android.content.Context#unbindService unbindService()}를 호출하면 됩니다. 여러 클라이언트가 같은 서비스에
-바인딩될 수 있으며, 이 모두가 바인딩을 해제하면 시스템이 해당 서비스를 소멸시킵니다 (서비스가 스스로를 중단시키지
+android.content.Context#bindService bindService()}를 호출하면 생성됩니다. 그러면 클라이언트가
+{@link android.os.IBinder} 인터페이스를 통해 서비스와 통신을 주고받을 수 있습니다. 클라이언트가 연결을 종료하려면
+{@link android.content.Context#unbindService unbindService()}를 호출하면 됩니다. 여러 클라이언트가 같은 서비스에
+바인딩될 수 있으며, 이 모두가 바인딩을 해제하면 시스템이 해당 서비스를 소멸시킵니다 (서비스가 스스로를 중단시키지
않아도 됩니다).
-
이와 같은 두 가지 경로는 완전히 별개의 것은 아닙니다. 다시 말해, 이미
-{@link android.content.Context#startService startService()}로 시작된 서비스에 바인딩할 수도 있다는 뜻입니다. 예를
+
이와 같은 두 가지 경로는 완전히 별개의 것은 아닙니다. 다시 말해, 이미
+{@link android.content.Context#startService startService()}로 시작된 서비스에 바인딩할 수도 있다는 뜻입니다. 예를
들어, 배경 음악 서비스를 시작하려면 {@link android.content.Context#startService
-startService()}를 호출하되 재생할 음악을 식별하는 {@link android.content.Intent}를 사용하면 됩니다. 나중에,
-아마도 사용자가 플레이어에 좀 더 많은 통제권을 발휘하고자 하거나
+startService()}를 호출하되 재생할 음악을 식별하는 {@link android.content.Intent}를 사용하면 됩니다. 나중에,
+아마도 사용자가 플레이어에 좀 더 많은 통제권을 발휘하고자 하거나
현재 노래에 대한 정보를 얻고자 할 때, 액티비티가 서비스에 바인딩될 수 있습니다. {@link
android.content.Context#bindService bindService()}를 사용하면 됩니다. 이런 경우에는 {@link
android.content.Context#stopService stopService()} 또는 {@link android.app.Service#stopSelf
@@ -702,8 +702,8 @@ stopSelf()}도 클라이언트가 모두 바인딩 해제될 때까지 실제로
수명 주기 콜백 구현하기
-
액티비티와 마찬가지로 서비스에도 수명 주기 콜백 메서드가 있어 이를 구현하면 서비스의
-상태 변경 내용을 모니터링할 수 있고 적절한 시기에 작업을 수행할 수 있습니다. 다음의 골격
+
액티비티와 마찬가지로 서비스에도 수명 주기 콜백 메서드가 있어 이를 구현하면 서비스의
+상태 변경 내용을 모니터링할 수 있고 적절한 시기에 작업을 수행할 수 있습니다. 다음의 골격
서비스는 각 수명 주기 메서드를 설명한 것입니다.
@@ -743,13 +743,13 @@ public class ExampleService extends Service {
}
-
참고: 액티비티 수명 주기 콜백 메서드와는 달리 이와 같은 콜백 메서드를 구현하는 데에는
+
참고: 액티비티 수명 주기 콜백 메서드와는 달리 이와 같은 콜백 메서드를 구현하는 데에는
슈퍼클래스 구현을 호출하지 않아도 됩니다.
-
그림 2. 서비스 수명 주기입니다. 왼쪽의 다이어그램은
+
그림 2. 서비스 수명 주기입니다. 왼쪽의 다이어그램은
서비스가 {@link android.content.Context#startService
-startService()}로 생성된 경우의 수명 주기를 나타내며 오른쪽의 다이어그램은 서비스가
+startService()}로 생성된 경우의 수명 주기를 나타내며 오른쪽의 다이어그램은 서비스가
{@link android.content.Context#bindService bindService()}로 생성된 경우의 수명 주기를 나타낸 것입니다.
이와 같은 메서드를 구현함으로써, 서비스 수명 주기의 두 가지 중첩된 루프를 모니터링할 수 있습니다.
@@ -757,20 +757,20 @@ startService()}로 생성된 경우의 수명 주기를 나타내며 오른쪽
서비스의 수명 주기 전체는 {@link
android.app.Service#onCreate onCreate()}가 호출된 시점과 {@link
-android.app.Service#onDestroy}가 반환된 시점 사이에 일어납니다. 액티비티와 마찬가지로 서비스는 자신의 초기 설정을
+android.app.Service#onDestroy}가 반환된 시점 사이에 일어납니다. 액티비티와 마찬가지로 서비스는 자신의 초기 설정을
{@link android.app.Service#onCreate onCreate()}에서 수행하며 남은 리소스를 모두 {@link
-android.app.Service#onDestroy onDestroy()}에 릴리스합니다. 예를 들어
+android.app.Service#onDestroy onDestroy()}에 릴리스합니다. 예를 들어
음악 재생 서비스의 경우 음악이 재생될 스레드를 {@link
android.app.Service#onCreate onCreate()}로 생성하고, 그럼 다음 해당 스레드를 중단할 때에는 {@link
android.app.Service#onDestroy onDestroy()}에서 할 수도 있습니다.
{@link android.app.Service#onCreate onCreate()}와 {@link android.app.Service#onDestroy
-onDestroy()} 메서드는 모든 서비스에 대해 호출됩니다. 이는 서비스가
+onDestroy()} 메서드는 모든 서비스에 대해 호출됩니다. 이는 서비스가
{@link android.content.Context#startService startService()}로 생성되었든 {@link
android.content.Context#bindService bindService()}로 생성되었든 관계 없이 적용됩니다.
서비스의 활성 수명 주기는 {@link
-android.app.Service#onStartCommand onStartCommand()} 또는 {@link android.app.Service#onBind onBind()}로의 호출과 함께 시작됩니다.
+android.app.Service#onStartCommand onStartCommand()} 또는 {@link android.app.Service#onBind onBind()}로의 호출과 함께 시작됩니다.
각 메서드에 {@link
android.content.Intent}가 전달되는데 이것은 각각 {@link android.content.Context#startService
startService()} 또는 {@link android.content.Context#bindService bindService()} 중 하나에 전달된 것입니다.
@@ -781,25 +781,25 @@ android.app.Service#onUnbind onUnbind()}가 반환되면 종료됩니다.
-
참고: 시작된 서비스를 중단하려면
+
참고: 시작된 서비스를 중단하려면
{@link android.app.Service#stopSelf stopSelf()} 또는 {@link
-android.content.Context#stopService stopService()}를 호출하면 되지만, 서비스에 대한 상응하는 콜백은
-없습니다(즉 {@code onStop()} 콜백이 없습니다). 그러므로, 서비스가 클라이언트에 바인딩되어 있지 않은 한
+android.content.Context#stopService stopService()}를 호출하면 되지만, 서비스에 대한 상응하는 콜백은
+없습니다(즉 {@code onStop()} 콜백이 없습니다). 그러므로, 서비스가 클라이언트에 바인딩되어 있지 않은 한
시스템은 서비스가 중단되면 이를 소멸시킵니다. 수신되는 콜백은 {@link
android.app.Service#onDestroy onDestroy()}가 유일합니다.
-
그림 2는 서비스에 대한 일반적인 콜백 메서드를 나타낸 것입니다. 이 그림에서는
-{@link android.content.Context#startService startService()}로 생성된 서비스와
-{@link android.content.Context#bindService bindService()}로 생성된 서비스를
+
그림 2는 서비스에 대한 일반적인 콜백 메서드를 나타낸 것입니다. 이 그림에서는
+{@link android.content.Context#startService startService()}로 생성된 서비스와
+{@link android.content.Context#bindService bindService()}로 생성된 서비스를
구분하고 있지만, 어떤 식으로 시작되었든 모든 서비스는 클라이언트가 자신에 바인딩되도록 허용할 수 있다는 점을 명심하십시오.
말하자면, {@link android.app.Service#onStartCommand
-onStartCommand()}로 처음 시작된 서비스(클라이언트가 {@link android.content.Context#startService startService()}를 호출해서)라고 해도
-여전히 {@link android.app.Service#onBind onBind()}로의 호출을 받을 수 있습니다(클라이언트가
+onStartCommand()}로 처음 시작된 서비스(클라이언트가 {@link android.content.Context#startService startService()}를 호출해서)라고 해도
+여전히 {@link android.app.Service#onBind onBind()}로의 호출을 받을 수 있습니다(클라이언트가
{@link android.content.Context#bindService bindService()}를 호출하는 경우).
바인딩을 제공하는 서비스 생성에 대한 자세한 내용은 바인딩된 서비스 문서를 참조하십시오. 이 안에는 {@link android.app.Service#onRebind onRebind()}
-콜백 메서드에 대한 자세한 정보가 바인딩된 서비스의
-수명 주기 관리에 관한 섹션에
+콜백 메서드에 대한 자세한 정보가 바인딩된 서비스의
+수명 주기 관리에 관한 섹션에
담겨 있습니다.
하나의 애플리케이션에는 보통 여러 개의 액티비티가 들어있습니다. 각 액티비티는
-사용자가 수행할 수 있는 특정한 종류의 작업을 중심으로 디자인되어야 하며 다른 액티비티를
+
하나의 애플리케이션에는 보통 여러 개의 액티비티가 들어있습니다. 각 액티비티는
+사용자가 수행할 수 있는 특정한 종류의 작업을 중심으로 디자인되어야 하며 다른 액티비티를
시작할 수 있는 기능이 있습니다. 예를 들어 이메일 애플리케이션에는 새 메시지 목록을 표시하는 하나의 액티비티가 있을 수 있습니다.
사용자가 메시지를 하나 선택하면, 새 액티비티가 열려 해당 메시지를 볼 수 있게 합니다.
-
액티비티는 기기에서 다른 애플리케이션에 존재하는 액티비티를 시작할 수도 있습니다. 예를 들어
-애플리케이션이 이메일 메시지를 보내고자 하는 경우, "전송" 작업을 수행할 인텐트를
-정의하여 이메일 주소와 메시지 등의 몇 가지 데이터를 포함시키면 됩니다. 그러면 다른 애플리케이션에서 가져온 액티비티 중
-이러한 종류의 인텐트를 처리한다고 스스로 선언한 것이 열립니다. 이 경우, 이 인텐트는
-이메일을 전송하기 위한 것이므로 이메일 애플리케이션의 "작성" 액티비티가 시작됩니다(같은 인텐트를
-지원하는 액티비티가 여러 개 있는 경우, 시스템은 사용자에게 어느 것을 사용할지 선택하도록 합니다). 이메일이 전송되면
-액티비티가 재개되고 해당 이메일 액티비티가 애플리케이션의 일부였던 것처럼 보입니다. 액티비티는
-서로 다른 애플리케이션에서 온 것일 수 있지만, Android는 두 액티비티를
+
액티비티는 기기에서 다른 애플리케이션에 존재하는 액티비티를 시작할 수도 있습니다. 예를 들어
+애플리케이션이 이메일 메시지를 보내고자 하는 경우, "전송" 작업을 수행할 인텐트를
+정의하여 이메일 주소와 메시지 등의 몇 가지 데이터를 포함시키면 됩니다. 그러면 다른 애플리케이션에서 가져온 액티비티 중
+이러한 종류의 인텐트를 처리한다고 스스로 선언한 것이 열립니다. 이 경우, 이 인텐트는
+이메일을 전송하기 위한 것이므로 이메일 애플리케이션의 "작성" 액티비티가 시작됩니다(같은 인텐트를
+지원하는 액티비티가 여러 개 있는 경우, 시스템은 사용자에게 어느 것을 사용할지 선택하도록 합니다). 이메일이 전송되면
+액티비티가 재개되고 해당 이메일 액티비티가 애플리케이션의 일부였던 것처럼 보입니다. 액티비티는
+서로 다른 애플리케이션에서 온 것일 수 있지만, Android는 두 액티비티를
모두 같은 작업 안에 유지하여 이처럼 막힘 없는 사용자 환경을 유지합니다.
-
작업이란 액티비티 컬렉션을 일컫는 말로, 사용자가 특정 작업을 수행할 때 이것과
-상호 작용합니다. 액티비티는 스택 안에 정렬되며(백 스택), 이때
+
작업이란 액티비티 컬렉션을 일컫는 말로, 사용자가 특정 작업을 수행할 때 이것과
+상호 작용합니다. 액티비티는 스택 안에 정렬되며(백 스택), 이때
순서는 각 액티비티가 열린 순서와 같습니다.
-
기기 메인 스크린이 대다수 작업의 시작 지점입니다. 사용자가
-애플리케이션
-시작 관리자에 있는 아이콘(또는 메인 스크린의 바로 가기)을 터치하면 해당 애플리케이션의 작업이 전경으로 나옵니다. 해당 애플리케이션에 대한
-작업이 존재하지 않으면(이 애플리케이션을 최근에 사용한 적이 없는 경우), 새 작업이 생성되고
+
기기 메인 스크린이 대다수 작업의 시작 지점입니다. 사용자가
+애플리케이션
+시작 관리자에 있는 아이콘(또는 메인 스크린의 바로 가기)을 터치하면 해당 애플리케이션의 작업이 전경으로 나옵니다. 해당 애플리케이션에 대한
+작업이 존재하지 않으면(이 애플리케이션을 최근에 사용한 적이 없는 경우), 새 작업이 생성되고
해당 애플리케이션의 "기본" 액티비티가 스택에 있는 루트 액티비티로 열립니다.
-
현재 액티비티가 또 다른 액티비티를 시작하는 경우, 새 액티비티가 스택의 맨 위로 밀어올려지고
-사용자의 초점이 이에 맞춰집니다. 이전 액티비티는 스택에 유지되지만, 중단됩니다. 액티비티가 중단되면
-시스템은 이 액티비티의 사용자 인터페이스의 현재 상태를 보존합니다. 사용자가
+
현재 액티비티가 또 다른 액티비티를 시작하는 경우, 새 액티비티가 스택의 맨 위로 밀어올려지고
+사용자의 초점이 이에 맞춰집니다. 이전 액티비티는 스택에 유지되지만, 중단됩니다. 액티비티가 중단되면
+시스템은 이 액티비티의 사용자 인터페이스의 현재 상태를 보존합니다. 사용자가
뒤로
- 버튼을 누르면, 현재 액티비티가 스택의 맨 위에서 튀어나오고(해당 액티비티는 소멸됩니다)
-이전 액티비티가 재개됩니다(이것의 UI 이전 상태가 복원됩니다). 스택에 있는 액티비티는
-결코 다시 정렬되지 않습니다. 다만 스택에서 밀어올려지거나 튀어나올 뿐입니다. 즉, 현재 액티비티에 의해
-시작되면 스택 위로 밀어올려지고, 사용자가 뒤로 버튼을 사용하여 액티비티를 떠나면 튀어나와 사라지는 것입니다. 따라서,
-백 스택은
-일종의 "후입선출" 객체 구조로서 작동한다고 할 수 있습니다. 그림 1은
-이 행동을 시간 표시 막대와 함께 표시하여 여러 액티비티 사이의 진행률을 보여주며,
+ 버튼을 누르면, 현재 액티비티가 스택의 맨 위에서 튀어나오고(해당 액티비티는 소멸됩니다)
+이전 액티비티가 재개됩니다(이것의 UI 이전 상태가 복원됩니다). 스택에 있는 액티비티는
+결코 다시 정렬되지 않습니다. 다만 스택에서 밀어올려지거나 튀어나올 뿐입니다. 즉, 현재 액티비티에 의해
+시작되면 스택 위로 밀어올려지고, 사용자가 뒤로 버튼을 사용하여 액티비티를 떠나면 튀어나와 사라지는 것입니다. 따라서,
+백 스택은
+일종의 "후입선출" 객체 구조로서 작동한다고 할 수 있습니다. 그림 1은
+이 행동을 시간 표시 막대와 함께 표시하여 여러 액티비티 사이의 진행률을 보여주며,
각 시점에서 현재 백 스택의 모습을 나타낸 것입니다.
-
그림 1. 작업에 있는 각각의 새 액티비티가 백 스택에 항목을 추가하는
-방법을 나타낸 것입니다. 사용자가 뒤로 버튼을 누르면 현재
-액티비티가
+
그림 1. 작업에 있는 각각의 새 액티비티가 백 스택에 항목을 추가하는
+방법을 나타낸 것입니다. 사용자가 뒤로 버튼을 누르면 현재
+액티비티가
소멸되고 이전 액티비티가 재개됩니다.
-
사용자가 계속해서 뒤로 버튼을 누르면, 스택에 있는 각 액티비티가 하나씩 튀어나가
-이전 것을
-드러내고, 마침내는 사용자가 메인 스크린으로 되돌아가게 됩니다(아니면 작업이 시작되었을 때
+
사용자가 계속해서 뒤로 버튼을 누르면, 스택에 있는 각 액티비티가 하나씩 튀어나가
+이전 것을
+드러내고, 마침내는 사용자가 메인 스크린으로 되돌아가게 됩니다(아니면 작업이 시작되었을 때
실행 중이던 액티비티가 무엇이든 그것으로 되돌아갑니다). 스택에서 모든 액티비티가 제거되면 이 작업은 더 이상 존재하지 않게 됩니다.
그림 2. 두 개의 작업: 작업 B가 전경에서 사용자 상호 작용을 수신하는 한편,
+class="img-caption">그림 2. 두 개의 작업: 작업 B가 전경에서 사용자 상호 작용을 수신하는 한편,
작업 A는 배경에서 재개되기를 기다립니다.
@@ -118,39 +118,39 @@ class="img-caption">그림 2. 두 개의 작업: 작업 B가
class="img-caption">그림 3. 하나의 액티비티가 여러 번 인스턴트화됩니다.
-
작업이란 하나의 잘 짜여진 단위로 사용자가 새 작업을 시작할 때 "배경"으로 이동할 수도 있고
-홈 버튼을 통해 메인 스크린으로 이동할 수도 있습니다. 작업의 모든 액티비티는 배경에 있는 동안은
+
작업이란 하나의 잘 짜여진 단위로 사용자가 새 작업을 시작할 때 "배경"으로 이동할 수도 있고
+홈 버튼을 통해 메인 스크린으로 이동할 수도 있습니다. 작업의 모든 액티비티는 배경에 있는 동안은
중단되지만
-, 해당 작업에 대한 백 스택은 그대로 변함 없이 유지됩니다. 이 작업은 또 다른 작업이 발생하는 동안
-초점을 잃을 뿐입니다(그림 2 참조). 그런 다음 작업이 "전경"으로 되돌아와 사용자가
-이전에 하던 일을 계속할 수 있습니다. 예를 들어 현재 작업(작업 A)의 스택에 세 개의 액티비티가 있다고
+, 해당 작업에 대한 백 스택은 그대로 변함 없이 유지됩니다. 이 작업은 또 다른 작업이 발생하는 동안
+초점을 잃을 뿐입니다(그림 2 참조). 그런 다음 작업이 "전경"으로 되돌아와 사용자가
+이전에 하던 일을 계속할 수 있습니다. 예를 들어 현재 작업(작업 A)의 스택에 세 개의 액티비티가 있다고
가정하면 그 중 둘은 현재 액티비티 아래에 있습니다. 사용자가 홈
- 버튼을 누른 다음
-애플리케이션 시작 관리자로부터 새 애플리케이션을 시작합니다. 메인 스크린이 나타나면 작업 A는
+ 버튼을 누른 다음
+애플리케이션 시작 관리자로부터 새 애플리케이션을 시작합니다. 메인 스크린이 나타나면 작업 A는
배경으로 이동합니다. 새 애플리케이션이 시작되면 시스템은 해당 애플리케이션에 대한 작업을 시작하며
-(작업 B) 여기에는 나름의 액티비티 스택이 딸려 있습니다. 해당 애플리케이션과
-상호 작용한 후, 사용자는 다시 홈으로 돌아와 원래 작업 A를 시작한
+(작업 B) 여기에는 나름의 액티비티 스택이 딸려 있습니다. 해당 애플리케이션과
+상호 작용한 후, 사용자는 다시 홈으로 돌아와 원래 작업 A를 시작한
애플리케이션을 선택합니다. 이제 작업 A가 전경으로 옵니다.
-이 스택에 있는 액티비티 세 개는 모두 멀쩡하고, 스택 맨 위에 있는 액티비티가
-재개됩니다. 이 시점에서
-사용자는 작업 B로 도로 전환할 수도 있습니다. 홈으로 이동하여 해당 작업을
-시작한 애플리케이션 아이콘을 선택하면 됩니다(아니면
-개요 화면에서 해당 앱의 작업을 선택해도 됩니다).
+이 스택에 있는 액티비티 세 개는 모두 멀쩡하고, 스택 맨 위에 있는 액티비티가
+재개됩니다. 이 시점에서
+사용자는 작업 B로 도로 전환할 수도 있습니다. 홈으로 이동하여 해당 작업을
+시작한 애플리케이션 아이콘을 선택하면 됩니다(아니면
+개요 화면에서 해당 앱의 작업을 선택해도 됩니다).
이것이 Android에서 멀티태스킹을 하는 작업의 예시입니다.
-
참고: 여러 개의 작업을 배경에 한꺼번에 대기시킬 수 있습니다.
-하지만, 사용자가 수많은 배경 작업을 동시에 실행하면 시스템이 메모리를 복원하기 위해
-배경 액티비티를 소멸시키기 시작할 수 있고, 그러면 액티비티 상태가 손실됩니다.
+
참고: 여러 개의 작업을 배경에 한꺼번에 대기시킬 수 있습니다.
+하지만, 사용자가 수많은 배경 작업을 동시에 실행하면 시스템이 메모리를 복원하기 위해
+배경 액티비티를 소멸시키기 시작할 수 있고, 그러면 액티비티 상태가 손실됩니다.
다음의 액티비티 상태에 관한 섹션을 참조하십시오.
-
백 스택에 있는 액티비티는 결코 다시 정렬되지 않으므로, 애플리케이션에서
-사용자에게 하나 이상의 액티비티로부터 특정 액티비티를 시작하도록 허용하는 경우, 해당 액티비티의 새 인스턴스가
-생성되어 스택 위로 밀려옵니다(해당 액티비티의 기존 인스턴스를
-맨 위로 가져오는 대신). 따라서, 애플리케이션 안의 한 액티비티가 여러 번
-인스턴트화될 수 있으며(서로 다른 작업으로부터도 가능), 이를 나타낸 것이 그림 3입니다. 이 때문에 사용자가
+
백 스택에 있는 액티비티는 결코 다시 정렬되지 않으므로, 애플리케이션에서
+사용자에게 하나 이상의 액티비티로부터 특정 액티비티를 시작하도록 허용하는 경우, 해당 액티비티의 새 인스턴스가
+생성되어 스택 위로 밀려옵니다(해당 액티비티의 기존 인스턴스를
+맨 위로 가져오는 대신). 따라서, 애플리케이션 안의 한 액티비티가 여러 번
+인스턴트화될 수 있으며(서로 다른 작업으로부터도 가능), 이를 나타낸 것이 그림 3입니다. 이 때문에 사용자가
뒤로 버튼을 사용하여 뒤로 이동하는 경우, 액티비티의 각 인스턴스가 열린 순서대로 드러납니다
-(각자 나름의
-UI 상태를 가지고). 다만, 액티비티가 한 번 이상 인스턴트화되는 것을 원치 않으면 이 행동은 수정할 수
+(각자 나름의
+UI 상태를 가지고). 다만, 액티비티가 한 번 이상 인스턴트화되는 것을 원치 않으면 이 행동은 수정할 수
있습니다. 그 방법에 대해서는 작업 관리하기에 관한 이후 섹션에서 이야기합니다.
@@ -159,16 +159,16 @@ UI 상태를 가지고). 다만, 액티비티가 한 번 이상 인스턴트화
액티비티 A가 액티비티 B를 시작하면 액티비티 A는 중단되지만, 시스템이 그 상태를
(예: 스크롤 위치 및 양식에 입력된 텍스트 등) 보존합니다.
-사용자가 액티비티 B에 있는 동안 뒤로 버튼을 누르면 액티비티 A가 재개되며 상태도
+사용자가 액티비티 B에 있는 동안 뒤로 버튼을 누르면 액티비티 A가 재개되며 상태도
복원됩니다.
-
사용자가 홈 버튼을 눌러 작업을 떠나면 현재 액티비티가
-중단되고
-그 소속 작업이 배경으로 들어갑니다. 시스템은 작업에 속한 모든 액티비티의 상태를 보존합니다. 사용자가
-나중에 작업을 시작한 시작 관리자 아이콘을 선택하여 해당 작업을 재개하면, 그 작업이
+
사용자가 홈 버튼을 눌러 작업을 떠나면 현재 액티비티가
+중단되고
+그 소속 작업이 배경으로 들어갑니다. 시스템은 작업에 속한 모든 액티비티의 상태를 보존합니다. 사용자가
+나중에 작업을 시작한 시작 관리자 아이콘을 선택하여 해당 작업을 재개하면, 그 작업이
전경으로 나오고 스택 맨 위에서 액티비티를 재개합니다.
-
사용자가 뒤로 버튼을 누르면, 현재 액티비티가 스택에서 튀어나오고
+
사용자가 뒤로 버튼을 누르면, 현재 액티비티가 스택에서 튀어나오고
소멸됩니다.
- 스택에 있던 이전 액티비티가 재개됩니다. 액티비티가 소멸되면, 시스템은 그 액티비티의 상태를
+ 스택에 있던 이전 액티비티가 재개됩니다. 액티비티가 소멸되면, 시스템은 그 액티비티의 상태를
보존하지 않습니다.
액티비티는 여러 번 인스턴트화할 수 있으며, 다른 작업에서도 이를 수행할 수 있습니다.
@@ -182,20 +182,20 @@ UI 상태를 가지고). 다만, 액티비티가 한 번 이상 인스턴트화
액티비티 상태 저장하기
-
위에서 논한 바와 같이, 시스템의 기본 행동은 액티비티가 중단되면 그 상태를 보존해두는
-것입니다. 이렇게 하면, 사용자가 이전 액티비티로 도로 이동했을 때 그에 속한 사용자 인터페이스가 이전 상태
+
위에서 논한 바와 같이, 시스템의 기본 행동은 액티비티가 중단되면 그 상태를 보존해두는
+것입니다. 이렇게 하면, 사용자가 이전 액티비티로 도로 이동했을 때 그에 속한 사용자 인터페이스가 이전 상태
그대로 표시됩니다. 그러나 액티비티의 상태를 미리 보존할 수도 있으며 사전에 이렇게 해야 합니다.
-이때에는, 액티비티가 소멸되고 다시 만들어야 하는 경우를 대비해
+이때에는, 액티비티가 소멸되고 다시 만들어야 하는 경우를 대비해
콜백 메서드를 사용합니다.
-
시스템이 액티비티 중 하나를 중단시키는 경우(예를 들어 새 액티비티가 시작되었을 때 또는 작업이
-배경으로 이동하는 경우), 시스템은 시스템 메모리를 회복해야 하는 경우 액티비티를
-완전히 소멸시켜버릴 수도 있습니다. 이런 상황이 벌어지면, 액티비티 상태에 대한 정보는 손실됩니다. 이런 일이 벌어지더라도,
-시스템은 여전히
-백 스택에 해당 액티비티의 자리가 있다는 것을 알고 있습니다. 다만 액티비티가 스택 맨 위로 올라오면
-시스템이 이를 (재개하는 것이 아니라) 재생성해야만 합니다. 사용자의 작업 내용을
-잃어버리는 불상사를 피하려면 그 내용을 미리 보존해두어야 합니다. 이때 액티비티의
-{@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} 콜백
+
시스템이 액티비티 중 하나를 중단시키는 경우(예를 들어 새 액티비티가 시작되었을 때 또는 작업이
+배경으로 이동하는 경우), 시스템은 시스템 메모리를 회복해야 하는 경우 액티비티를
+완전히 소멸시켜버릴 수도 있습니다. 이런 상황이 벌어지면, 액티비티 상태에 대한 정보는 손실됩니다. 이런 일이 벌어지더라도,
+시스템은 여전히
+백 스택에 해당 액티비티의 자리가 있다는 것을 알고 있습니다. 다만 액티비티가 스택 맨 위로 올라오면
+시스템이 이를 (재개하는 것이 아니라) 재생성해야만 합니다. 사용자의 작업 내용을
+잃어버리는 불상사를 피하려면 그 내용을 미리 보존해두어야 합니다. 이때 액티비티의
+{@link android.app.Activity#onSaveInstanceState onSaveInstanceState()} 콜백
메서드를 구현하는 방법을 씁니다.
액티비티 상태를 저장하는 방법에 대한 자세한 정보는 액티비티
@@ -205,19 +205,19 @@ UI 상태를 가지고). 다만, 액티비티가 한 번 이상 인스턴트화
작업 관리하기
-
Android가 작업과 백 스택을 관리하는 방식은 위에 설명된 바와 같고—같은 작업 안에서
-연이어 시작된 모든 작업을 한곳에 배치하되 "후입선출" 스택에 두는 것—이 방식은
-대부분의 애플리케이션에 아주 효과적입니다. 여러분은 액티비티가 작업과 연관된 방식이나
-백 스택에서의 존재 방식에 대해 염려하지 않아도 됩니다. 그러나, 정상적인 동작을 인터럽트하기로 결정할 수도
-있습니다. 애플리케이션의 액티비티 하나가 시작되면 새 작업을 시작하려
-할 수도 있습니다(현재 작업 내에 배치되는 것 대신에). 아니면, 액티비티를 시작하면 그것의
-기존 인스턴스 하나를 앞으로 가져오고자 할 수도 있습니다(백 스택 맨 위에서 새 인스턴스를
-생성하는 것 대신에). 또는 백 스택에서 사용자가 작업을 떠날 때의 루트 액티비티를 제외하고
+
Android가 작업과 백 스택을 관리하는 방식은 위에 설명된 바와 같고—같은 작업 안에서
+연이어 시작된 모든 작업을 한곳에 배치하되 "후입선출" 스택에 두는 것—이 방식은
+대부분의 애플리케이션에 아주 효과적입니다. 여러분은 액티비티가 작업과 연관된 방식이나
+백 스택에서의 존재 방식에 대해 염려하지 않아도 됩니다. 그러나, 정상적인 동작을 인터럽트하기로 결정할 수도
+있습니다. 애플리케이션의 액티비티 하나가 시작되면 새 작업을 시작하려
+할 수도 있습니다(현재 작업 내에 배치되는 것 대신에). 아니면, 액티비티를 시작하면 그것의
+기존 인스턴스 하나를 앞으로 가져오고자 할 수도 있습니다(백 스택 맨 위에서 새 인스턴스를
+생성하는 것 대신에). 또는 백 스택에서 사용자가 작업을 떠날 때의 루트 액티비티를 제외하고
모든 액티비티를 지우고자 할 수도 있습니다.
-
이 모든 것과 그 외에도 많은 것을 할 수 있는 것이 바로
+
이 모든 것과 그 외에도 많은 것을 할 수 있는 것이 바로
{@code <activity>}
-매니페스트 요소 안에 있는 속성과,
+매니페스트 요소 안에 있는 속성과,
{@link android.app.Activity#startActivity startActivity()}에 전달한 인텐트에 있는 플래그입니다.
이외에도 별도로 작업과 액티비티를 표시하는 방법에 대한 고려 사항과
+개요 화면에서의 관리 방법을 논합니다. 자세한 정보는 개요 화면을
+참조하십시오. 보통은 개요 화면에 작업과 액티비티가 어떻게 표현될지는
시스템이 정의하도록 두어야 합니다. 이 동작을 개발자가 수정할 필요도 없습니다.
-
주의: 대부분의 애플리케이션은 액티비티와 작업에 대한
-기본 동작을 인터럽트하지 않는 것이 정상입니다. 액티비티가 기본 동작을 수정하는 것이 필요하다는
-판단이 서면, 시작 과정 중에 액티비티의 유용성을 테스트하십시오.
+
주의: 대부분의 애플리케이션은 액티비티와 작업에 대한
+기본 동작을 인터럽트하지 않는 것이 정상입니다. 액티비티가 기본 동작을 수정하는 것이 필요하다는
+판단이 서면, 시작 과정 중에 액티비티의 유용성을 테스트하십시오.
또한 다른 액티비티와 작업에서 뒤로 버튼을 써서 해당 액티비티로 돌아올 때에도 유용성을 테스트해야 합니다.
사용자의 예상되는 동작과 충돌할 가능성이 있는 탐색 동작을 꼭 테스트하십시오.
시작 모드 정의하기
-
시작 모드를 사용하면 액티비티의 새 인스턴스가 현재 작업과 연관된 방식을 정의할 수 있게
+
시작 모드를 사용하면 액티비티의 새 인스턴스가 현재 작업과 연관된 방식을 정의할 수 있게
해줍니다. 여러 가지 시작 모드를 두 가지 방식으로 정의할 수 있습니다.
{@link android.app.Activity#startActivity startActivity()}를 호출하는 경우
-{@link android.content.Intent}에 플래그를 포함시켜 새 액티비티가 현재 작업과 어떻게 연관되어야 할지(또는
+
{@link android.app.Activity#startActivity startActivity()}를 호출하는 경우
+{@link android.content.Intent}에 플래그를 포함시켜 새 액티비티가 현재 작업과 어떻게 연관되어야 할지(또는
애초에 연관을 맺을지 아닐지) 선언하도록 할 수 있습니다.
-
따라서, 액티비티 A가 액티비티 B를 시작하면 액티비티 B는 자신의 매니페스트에서
-현재 작업과 연관을 맺는 데 적당한 방식(연관을 맺어야 한다면)을 정의할 수 있고 액티비티 A 또한
-액티비티 B가 현재 작업과 연관을 맺는 방식을 요청할 수 있습니다. 두 액티비티가 모두 액티비티 B가 작업과
-연관되는 방식을 정의하는 경우, 액티비티 A의 요청(인텐트에 정의된 바를 따름)을 액티비티 B의
+
따라서, 액티비티 A가 액티비티 B를 시작하면 액티비티 B는 자신의 매니페스트에서
+현재 작업과 연관을 맺는 데 적당한 방식(연관을 맺어야 한다면)을 정의할 수 있고 액티비티 A 또한
+액티비티 B가 현재 작업과 연관을 맺는 방식을 요청할 수 있습니다. 두 액티비티가 모두 액티비티 B가 작업과
+연관되는 방식을 정의하는 경우, 액티비티 A의 요청(인텐트에 정의된 바를 따름)을 액티비티 B의
요청(자신의 매니페스트에서 정의)보다 우위로 인식합니다.
-
참고: 매니페스트 파일에 사용할 수 있는 시작 모드 중에는
-인텐트의 플래그로 사용할 수는 없는 것도 있으며, 이와 마찬 가지로 인텐트의 플래그로 사용할 수 있는 시작 모드 중에는
+
참고: 매니페스트 파일에 사용할 수 있는 시작 모드 중에는
+인텐트의 플래그로 사용할 수는 없는 것도 있으며, 이와 마찬 가지로 인텐트의 플래그로 사용할 수 있는 시작 모드 중에는
매니페스트에서 정의할 수 없는 것도 있습니다.
{@code
-launchMode} 속성은 액티비티가 작업 안으로 들어가며 시작되는 방법에 대한 지침을
-나타냅니다.
+launchMode}
속성은 액티비티가 작업 안으로 들어가며 시작되는 방법에 대한 지침을
+나타냅니다.
launchMode
속성에 할당할 수 있는 시작 모드는 네 가지가 있습니다.
{@code "standard"} (기본 모드)
-
기본입니다. 시스템이 액티비티가 시작된 작업에서 액티비티의 새 인스턴스를 만들고
-인텐트의 경로를 이것으로 지정합니다. 액티비티는 여러 번 인스턴트화될 수 있고,
+
기본입니다. 시스템이 액티비티가 시작된 작업에서 액티비티의 새 인스턴스를 만들고
+인텐트의 경로를 이것으로 지정합니다. 액티비티는 여러 번 인스턴트화될 수 있고,
각 인스턴스는 서로 다른 작업에 속할 수 있으며 한 작업에 여러 개의 인스턴스가 있을 수 있습니다.
{@code "singleTop"}
-
액티비티의 인스턴스가 이미 현재 작업의 맨 위에 존재하는 경우, 시스템은 인텐트의 경로를
+
액티비티의 인스턴스가 이미 현재 작업의 맨 위에 존재하는 경우, 시스템은 인텐트의 경로를
해당 인스턴스로 지정합니다. 이때 액티비티의 새 인스턴스를 만들기보다는 해당 인스턴스의 {@link
-android.app.Activity#onNewIntent onNewIntent()} 메서드를 호출하는 방법을
-통합니다. 액티비티는 여러 번 인스턴트화될 수 있고, 각 인스턴스는 서로 다른 작업에
-속할 수 있으며 한 작업에 여러 개의 인스턴스가 있을 수 있습니다(다만 백 스택의 맨 위에 있는
+android.app.Activity#onNewIntent onNewIntent()} 메서드를 호출하는 방법을
+통합니다. 액티비티는 여러 번 인스턴트화될 수 있고, 각 인스턴스는 서로 다른 작업에
+속할 수 있으며 한 작업에 여러 개의 인스턴스가 있을 수 있습니다(다만 백 스택의 맨 위에 있는
액티비티가 액티비티의 기존 인스턴스가 아닌 경우에만 이것이 적용됩니다).
-
예를 들어 어느 작업의 백 스택이 루트 액티비티 A와 액티비티 B, C, 그리고 맨 위의 액티비티 D로
+
예를 들어 어느 작업의 백 스택이 루트 액티비티 A와 액티비티 B, C, 그리고 맨 위의 액티비티 D로
구성되어 있다고 가정합니다(이 스택은 A-B-C-D 형태를 띠며 D가 맨 위에 있습니다). 유형 D의 액티비티에 대한 인텐트가 도착합니다.
-D에 기본 {@code "standard"} 시작 모드가 있는 경우, 클래스의 새 인스턴스가 시작되고 이 스택은
-A-B-C-D-D가 됩니다. 하지만, D의 시작 모드가 {@code "singleTop"}인 경우, D의
+D에 기본 {@code "standard"} 시작 모드가 있는 경우, 클래스의 새 인스턴스가 시작되고 이 스택은
+A-B-C-D-D가 됩니다. 하지만, D의 시작 모드가 {@code "singleTop"}인 경우, D의
기존 인스턴스가 해당 인텐트를 {@link
-android.app.Activity#onNewIntent onNewIntent()}를 통해 받게 됩니다. 이것이 스택의 맨 위에 있기 때문입니다. 스택은
-계속 A-B-C-D로 유지됩니다. 그러나 유형 B의 액티비티에 대한 인텐트가 도착하는 경우,
+android.app.Activity#onNewIntent onNewIntent()}를 통해 받게 됩니다. 이것이 스택의 맨 위에 있기 때문입니다. 스택은
+계속 A-B-C-D로 유지됩니다. 그러나 유형 B의 액티비티에 대한 인텐트가 도착하는 경우,
B의 새 인스턴스가 스택에 추가되며 이는 액티비티의 시작 모드가 {@code "singleTop"}이더라도 무관하게 적용됩니다.
-
참고: 어느 액티비티의 새 인스턴스가 생성되면,
-사용자가 뒤로 버튼을 눌러 이전 액티비티로 되돌아갈 수 있게 됩니다. 그러나 액티비티의 기존
-인스턴스가
+
참고: 어느 액티비티의 새 인스턴스가 생성되면,
+사용자가 뒤로 버튼을 눌러 이전 액티비티로 되돌아갈 수 있게 됩니다. 그러나 액티비티의 기존
+인스턴스가
새 인텐트를 처리하는 경우, 사용자가 뒤로 버튼을 눌러도 새 인텐트가 {@link android.app.Activity#onNewIntent
-onNewIntent()}에 도착하기 전의 액티비티
-상태로
+onNewIntent()}에 도착하기 전의 액티비티
+상태로
되돌아갈 수 없습니다.
{@code "singleTask"}
시스템이 새 작업을 만들고 새 작업의 루트에 있는 액티비티를 인스턴트화합니다.
-하지만, 액티비티의 인스턴스가 이미 별개의 작업에 존재하는 경우, 시스템은 인텐트의 경로를
+하지만, 액티비티의 인스턴스가 이미 별개의 작업에 존재하는 경우, 시스템은 인텐트의 경로를
기존 인스턴스로 지정합니다. 이때 새 인스턴스를 만들기보다 해당 인스턴스의 {@link
-android.app.Activity#onNewIntent onNewIntent()} 메서드를 호출하는 방법을 통합니다. 한 번에
+android.app.Activity#onNewIntent onNewIntent()} 메서드를 호출하는 방법을 통합니다. 한 번에
액티비티 인스턴스 한 개씩만 존재할 수 있습니다.
-
참고: 액티비티가 새 작업에서 시작되더라도,
+
참고: 액티비티가 새 작업에서 시작되더라도,
뒤로 버튼을 누르면 여전히 사용자를 이전 액티비티로 돌려보냅니다.
{@code "singleInstance"}.
-
{@code "singleTask"}와 같습니다. 다만 시스템이 인스턴스를 보유하고 있는 작업 안으로
-다른 어떤 액티비티도 시작하지 않는다는 것은 예외입니다. 액티비티는 언제나 자신의 작업의 유일무이한 구성원입니다.
+
{@code "singleTask"}와 같습니다. 다만 시스템이 인스턴스를 보유하고 있는 작업 안으로
+다른 어떤 액티비티도 시작하지 않는다는 것은 예외입니다. 액티비티는 언제나 자신의 작업의 유일무이한 구성원입니다.
이것으로 시작한 액티비티는 모두 별개의 작업에서 열립니다.
-
또 다른 예로 Android 브라우저 애플리케이션이 있습니다. 이것은 웹 브라우저 액티비티가 항상
-자신만의 작업에서 열려야 한다고 선언합니다. 이때 {@code <activity>} 요소에 {@code singleTask} 시작 모드를 지정하는 방법을 씁니다.
-다시 말해 애플리케이션이 Android 브라우저를 열라는 인텐트를 발행하면
-브라우저의 액티비티가 애플리케이션과 같은 작업에 배치되지 않는다는
-뜻입니다. 그 대신, 브라우저에 대한 새 작업이 시작되거나, 브라우저에 이미
-배경에서 실행 중인 작업이 있는 경우 해당 작업이 전경으로 불려나와 새 인텐트를 처리하게
+
또 다른 예로 Android 브라우저 애플리케이션이 있습니다. 이것은 웹 브라우저 액티비티가 항상
+자신만의 작업에서 열려야 한다고 선언합니다. 이때 {@code <activity>} 요소에 {@code singleTask} 시작 모드를 지정하는 방법을 씁니다.
+다시 말해 애플리케이션이 Android 브라우저를 열라는 인텐트를 발행하면
+브라우저의 액티비티가 애플리케이션과 같은 작업에 배치되지 않는다는
+뜻입니다. 그 대신, 브라우저에 대한 새 작업이 시작되거나, 브라우저에 이미
+배경에서 실행 중인 작업이 있는 경우 해당 작업이 전경으로 불려나와 새 인텐트를 처리하게
됩니다.
-
액티비티가 새 작업에서 시작되었든 액티비티를 시작한 것과 같은 작업에서 시작되었든 관계 없이
-뒤로 버튼을 사용하면 언제나 사용자를 이전 액티비티로 돌려보냅니다. 다만,
-{@code singleTask} 시작 모드를 나타내는 액티비티를 시작한 다음 해당
-액티비티의 인스턴스가 이미 배경 작업에 존재하는 경우, 그 작업 전체가 전경에 불려나옵니다. 이 시점에서
-백 스택에는 이제 앞으로 가져온 작업에서 가져온 모든 액티비티가 포함되어 있으며, 이는 스택의
+
액티비티가 새 작업에서 시작되었든 액티비티를 시작한 것과 같은 작업에서 시작되었든 관계 없이
+뒤로 버튼을 사용하면 언제나 사용자를 이전 액티비티로 돌려보냅니다. 다만,
+{@code singleTask} 시작 모드를 나타내는 액티비티를 시작한 다음 해당
+액티비티의 인스턴스가 이미 배경 작업에 존재하는 경우, 그 작업 전체가 전경에 불려나옵니다. 이 시점에서
+백 스택에는 이제 앞으로 가져온 작업에서 가져온 모든 액티비티가 포함되어 있으며, 이는 스택의
맨 위에 위치합니다. 그림 4는 이와 같은 유형의 시나리오를 나타낸 것입니다.
-
그림 4. 시작 모드가 "singleTask"인 액티비티가
-백 스택에 추가되는 방법을 표현한 것입니다. 이 액티비티가 이미 자신의 백 스택을 가지고 있는
-배경 작업의 일부인 경우, 해당 백 스택도 모두 전경으로
+
그림 4. 시작 모드가 "singleTask"인 액티비티가
+백 스택에 추가되는 방법을 표현한 것입니다. 이 액티비티가 이미 자신의 백 스택을 가지고 있는
+배경 작업의 일부인 경우, 해당 백 스택도 모두 전경으로
불려나오며, 이는 현재 작업 위에 배치됩니다.
-
매니페스트 파일에서 시작 모드를 사용하는 것에 대한 자세한 정보는
+
매니페스트 파일에서 시작 모드를 사용하는 것에 대한 자세한 정보는
<activity>
-요소 문서를 참조하십시오. 여기에서 {@code launchMode} 속성과 허용된 값을 더 자세히
+요소 문서를 참조하십시오. 여기에서 {@code launchMode} 속성과 허용된 값을 더 자세히
논합니다.
-
참고: 액티비티에 대하여 {@code launchMode} 속성으로 지정한 동작을
-재정의하려면 액티비티를 시작한 인텐트에 포함된 플래그를 사용하면 됩니다. 이 내용은
+
참고: 액티비티에 대하여 {@code launchMode} 속성으로 지정한 동작을
+재정의하려면 액티비티를 시작한 인텐트에 포함된 플래그를 사용하면 됩니다. 이 내용은
다음 섹션에서 논합니다.
인텐트 플래그 사용하기
-
액티비티를 시작할 때면, 액티비티가 자신의 작업과 연관되는 기본 방식을 수정할 수 있습니다.
+
액티비티를 시작할 때면, 액티비티가 자신의 작업과 연관되는 기본 방식을 수정할 수 있습니다.
{@link
-android.app.Activity#startActivity startActivity()}에 전달한 인텐트 안에 있는 플래그를 포함시키면 됩니다. 기본 동작을 수정하는 데 사용할 수 있는
+android.app.Activity#startActivity startActivity()}에 전달한 인텐트 안에 있는 플래그를 포함시키면 됩니다. 기본 동작을 수정하는 데 사용할 수 있는
플래그는 다음과 같습니다.
액티비티를 새 작업에서 시작합니다. 지금 시작하고 있는 액티비티에 대해 이미 실행 중인 작업이 있으면,
-해당 작업의 마지막 상태를 복원하여 전경으로 불려나오고 액티비티는 새 인텐트를
+
액티비티를 새 작업에서 시작합니다. 지금 시작하고 있는 액티비티에 대해 이미 실행 중인 작업이 있으면,
+해당 작업의 마지막 상태를 복원하여 전경으로 불려나오고 액티비티는 새 인텐트를
{@link android.app.Activity#onNewIntent onNewIntent()}에서 수신합니다.
-
시작되고 있는 액티비티가 이미 현재 작업에서 실행 중인 경우, 해당 액티비티의
-새 인스턴스를 시작하는 대신 그 위에 있는 모든 다른 액티비티가
-소멸되고 이 인텐트는 해당 액티비티(이제 맨 위로 올라옴)의 재개된 인스턴스로,
+
시작되고 있는 액티비티가 이미 현재 작업에서 실행 중인 경우, 해당 액티비티의
+새 인스턴스를 시작하는 대신 그 위에 있는 모든 다른 액티비티가
+소멸되고 이 인텐트는 해당 액티비티(이제 맨 위로 올라옴)의 재개된 인스턴스로,
{@link android.app.Activity#onNewIntent onNewIntent()}를 통해 전달됩니다.
{@code FLAG_ACTIVITY_CLEAR_TOP}는
-{@code FLAG_ACTIVITY_NEW_TASK}와 함께 쓰이는 경우가 가장 보편적입니다.
-이들 플래그를 함께 사용하면 다른 작업에 있는 기존 액티비티의 위치를
+
{@code FLAG_ACTIVITY_CLEAR_TOP}는
+{@code FLAG_ACTIVITY_NEW_TASK}와 함께 쓰이는 경우가 가장 보편적입니다.
+이들 플래그를 함께 사용하면 다른 작업에 있는 기존 액티비티의 위치를
찾아 이를 인텐트에 응답할 수 있는 위치에 놓을 한 가지 방편이 됩니다.
-
참고: 지정된 액티비티의 시작 모드가
-{@code "standard"}인 경우,
-이것 또한 스택에서 제거되고 그 자리에 새 인스턴스가 대신 생성되어 수신되는 인텐트를
-처리하게 됩니다. 이는 시작 모드가
+
참고: 지정된 액티비티의 시작 모드가
+{@code "standard"}인 경우,
+이것 또한 스택에서 제거되고 그 자리에 새 인스턴스가 대신 생성되어 수신되는 인텐트를
+처리하게 됩니다. 이는 시작 모드가
{@code "standard"}인 경우, 새 인텐트에 대해서는 항상 새 인스턴스가 생성되기 때문입니다.
@@ -420,65 +420,65 @@ android.app.Activity#startActivity startActivity()}에 전달한 인텐트 안
유사성 처리하기
-
유사성이란 액티비티가 어느 작업에 소속되기를 선호하는지를 나타내는 것입니다. 기본적으로,
-같은 애플리케이션에서 나온 액티비티는 서로 유사성을 지니고 있습니다. 따라서, 기본적으로
-같은 애플리케이션 안에 있는 모든 액티비티는 같은 작업 안에 있는 것을 선호합니다. 하지만 액티비티에 대한 기본 유사성은 개발자가
-수정할 수 있습니다. 각기 다른 애플리케이션에서 정의된
-액티비티가 하나의 유사성을 공유할 수도 있고, 같은 애플리케이션에서 정의된 여러 액티비티에
+
유사성이란 액티비티가 어느 작업에 소속되기를 선호하는지를 나타내는 것입니다. 기본적으로,
+같은 애플리케이션에서 나온 액티비티는 서로 유사성을 지니고 있습니다. 따라서, 기본적으로
+같은 애플리케이션 안에 있는 모든 액티비티는 같은 작업 안에 있는 것을 선호합니다. 하지만 액티비티에 대한 기본 유사성은 개발자가
+수정할 수 있습니다. 각기 다른 애플리케이션에서 정의된
+액티비티가 하나의 유사성을 공유할 수도 있고, 같은 애플리케이션에서 정의된 여러 액티비티에
서로 다른 작업 유사성을 할당할 수도 있습니다.
{@code taskAffinity}
-속성은 문자열 값을 취합니다. 이는
+속성은 문자열 값을 취합니다. 이는
{@code <manifest>}
- 요소에서 선언한 기본 패키지 이름과 달리 고유해야 합니다. 왜냐하면 시스템이 이 이름을 사용하여 애플리케이션의 기본 작업 유사성을
+ 요소에서 선언한 기본 패키지 이름과 달리 고유해야 합니다. 왜냐하면 시스템이 이 이름을 사용하여 애플리케이션의 기본 작업 유사성을
식별하기 때문입니다.
유사성이 역할을 갖는 것은 다음과 같은 두 가지 상황에서입니다.
-
액티비티를 시작한 인텐트에
+
액티비티를 시작한 인텐트에
{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}
플래그가 들어 있는 경우.
-
새로운 액티비티는 기본적으로
-{@link android.app.Activity#startActivity startActivity()}를 호출한 액티비티의 작업 안으로 들어가며 시작됩니다. 이것은 발신자와 같은
-백 스택 위로 밀어내집니다. 하지만
-{@link android.app.Activity#startActivity startActivity()}에
+
새로운 액티비티는 기본적으로
+{@link android.app.Activity#startActivity startActivity()}를 호출한 액티비티의 작업 안으로 들어가며 시작됩니다. 이것은 발신자와 같은
+백 스택 위로 밀어내집니다. 하지만
+{@link android.app.Activity#startActivity startActivity()}에
전달된 인텐트에 {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK}
플래그가 들어있는 경우, 시스템은 새 액티비티를 담을 다른 작업을 찾습니다. 이는 새 작업인 경우가 많습니다.
-그렇지만 꼭 그래야 하는 것은 아닙니다. 새 액티비티와 같은 유사성을 가진 기존 작업이 이미 존재하는 경우,
+그렇지만 꼭 그래야 하는 것은 아닙니다. 새 액티비티와 같은 유사성을 가진 기존 작업이 이미 존재하는 경우,
해당 액티비티는 그 작업 안으로 들어가며 시작됩니다. 그렇지 않으면, 새 작업을 시작합니다.
-
이 플래그 때문에 액티비티가 새 작업을 시작하게 되고 사용자가 홈 버튼을 눌러 이 액티비티를
-떠나고자
-하는 경우, 사용자가 작업으로 도로 이동할 방법이 있어야 합니다. 엔티티 중에는(예를 들어
-알림 관리자) 액티비티를 항상 외부 작업으로만 시작하고 자신의 일부로서는 절대 시작하지 않는 것이 있습니다.
-따라서 이들은 {@code FLAG_ACTIVITY_NEW_TASK}를
-{@link android.app.Activity#startActivity startActivity()}에 전달하는 인텐트에 포함시킵니다.
-이 플래그를 사용할 수 있는 외부 엔티티가
-호출할 수 있는 액티비티를 가지고 있는 경우, 사용자가 시작된 작업에 돌아갈 수 있는
-방법을 따로 가지고 있어야 합니다. 예를 들어 시작 관리자 아이콘을 이용한다든지 하는 방법입니다(작업의 루트 액티비티에
+
이 플래그 때문에 액티비티가 새 작업을 시작하게 되고 사용자가 홈 버튼을 눌러 이 액티비티를
+떠나고자
+하는 경우, 사용자가 작업으로 도로 이동할 방법이 있어야 합니다. 엔티티 중에는(예를 들어
+알림 관리자) 액티비티를 항상 외부 작업으로만 시작하고 자신의 일부로서는 절대 시작하지 않는 것이 있습니다.
+따라서 이들은 {@code FLAG_ACTIVITY_NEW_TASK}를
+{@link android.app.Activity#startActivity startActivity()}에 전달하는 인텐트에 포함시킵니다.
+이 플래그를 사용할 수 있는 외부 엔티티가
+호출할 수 있는 액티비티를 가지고 있는 경우, 사용자가 시작된 작업에 돌아갈 수 있는
+방법을 따로 가지고 있어야 합니다. 예를 들어 시작 관리자 아이콘을 이용한다든지 하는 방법입니다(작업의 루트 액티비티에
{@link android.content.Intent#CATEGORY_LAUNCHER} 인텐트 필터가 있습니다. 아래의 작업 시작하기 섹션을 참조하십시오).
이 경우, 액티비티는 자신이 시작한 작업에서 벗어나 유사성을 가진 다른 작업이 전경으로
+
이 경우, 액티비티는 자신이 시작한 작업에서 벗어나 유사성을 가진 다른 작업이 전경으로
나오면 그 작업으로 이동할 수 있습니다.
-
예를 들어 선택한 몇몇 도시에서 기상 상태를 예보하는 어느 액티비티가
-여행 애플리케이션의 일부로 정의되어 있다고 가정합니다. 이것은 같은 애플리케이션에 있는
-다른 여러 액티비티와 같은 유사성을 가지며(기본 애플리케이션 유사성) 이 속성으로 상위 재지정을 허용하기도 합니다.
-액티비티 중 하나가 일기 예보 액티비티를 시작하면, 이는 처음에는 액티비티와 같은 작업에
-속합니다. 하지만 여행 애플리케이션의 작업이 전경으로 불려나오면
+
예를 들어 선택한 몇몇 도시에서 기상 상태를 예보하는 어느 액티비티가
+여행 애플리케이션의 일부로 정의되어 있다고 가정합니다. 이것은 같은 애플리케이션에 있는
+다른 여러 액티비티와 같은 유사성을 가지며(기본 애플리케이션 유사성) 이 속성으로 상위 재지정을 허용하기도 합니다.
+액티비티 중 하나가 일기 예보 액티비티를 시작하면, 이는 처음에는 액티비티와 같은 작업에
+속합니다. 하지만 여행 애플리케이션의 작업이 전경으로 불려나오면
일기 예보 액티비티는 그 작업에 다시 할당되며 그 안에 표시됩니다.
-
팁: {@code .apk} 파일에 사용자 쪽에서 보기에 하나 이상의 "애플리케이션"이
+
팁: {@code .apk} 파일에 사용자 쪽에서 보기에 하나 이상의 "애플리케이션"이
들어있는 경우, {@code taskAffinity}
속성을 사용하여 각 "애플리케이션"과 연관된 액티비티에 서로 다른 유사성을 할당하는 것이 좋습니다.
@@ -486,9 +486,9 @@ android.app.Activity#startActivity startActivity()}에 전달한 인텐트 안
백 스택 지우기
-
사용자가 작업을 오랜 시간 동안 떠나 있으면, 시스템이 루트 액티비티만 빼고 모든 액티비티를
-해당 작업에서 지웁니다. 사용자가 다시 작업으로 돌아오면, 루트 액티비티만 복원됩니다.
-시스템이 이런 식으로 동작하는 것은 오랜 시간이 지난 다음에는 사용자가 전에 하던 일을 중단하고
+
사용자가 작업을 오랜 시간 동안 떠나 있으면, 시스템이 루트 액티비티만 빼고 모든 액티비티를
+해당 작업에서 지웁니다. 사용자가 다시 작업으로 돌아오면, 루트 액티비티만 복원됩니다.
+시스템이 이런 식으로 동작하는 것은 오랜 시간이 지난 다음에는 사용자가 전에 하던 일을 중단하고
새로운 일을 시작하기 위해 작업에 돌아올 가능성이 크기 때문입니다.
이 동작을 수정하는 데 사용할 수 있는 액티비티 속성이 몇 가지 있습니다.
@@ -497,27 +497,27 @@ android.app.Activity#startActivity startActivity()}에 전달한 인텐트 안
이 속성이 작업의 루트 액티비티 안에서 {@code "true"}로 설정되어 있는 경우,
-사용자가 작업을 떠났다가 다시 돌아올 때마다 스택을 루트 액티비티까지
-지웁니다. 바꿔 말하면, 이것은
+
이 속성이 작업의 루트 액티비티 안에서 {@code "true"}로 설정되어 있는 경우,
+사용자가 작업을 떠났다가 다시 돌아올 때마다 스택을 루트 액티비티까지
+지웁니다. 바꿔 말하면, 이것은
-{@code alwaysRetainTaskState}와 정반대입니다. 사용자는 항상 작업의 초기 상태로 돌아오게 되며,
+{@code alwaysRetainTaskState}와 정반대입니다. 사용자는 항상 작업의 초기 상태로 돌아오게 되며,
이는 아주 잠깐 동안만 작업을 떠난 경우에도 마찬가지입니다.
이 속성은 {@code clearTaskOnLaunch}와 같지만,
-작업 전체가 아니라
-하나의 액티비티에서 작동합니다. 이것은 루트 액티비티를 포함한 모든 액티비티가 없어지게
-하기도 합니다. 이것을 {@code "true"}로 설정하면,
-액티비티는 현재 세션에 대해서만 작업의 일부로 유지됩니다. 사용자가 작업을 떠났다가
+
이 속성은 {@code clearTaskOnLaunch}와 같지만,
+작업 전체가 아니라
+하나의 액티비티에서 작동합니다. 이것은 루트 액티비티를 포함한 모든 액티비티가 없어지게
+하기도 합니다. 이것을 {@code "true"}로 설정하면,
+액티비티는 현재 세션에 대해서만 작업의 일부로 유지됩니다. 사용자가 작업을 떠났다가
다시 돌아오면 이 작업은 더 이상 존재하지 않습니다.
액티비티를 작업의 진입 지점으로 설정하려면 여기에 작업에서 지정한 대로
-{@code "android.intent.action.MAIN"}이 있는 인텐트 필터를 부여하고
-{@code "android.intent.category.LAUNCHER"}를
+
액티비티를 작업의 진입 지점으로 설정하려면 여기에 작업에서 지정한 대로
+{@code "android.intent.action.MAIN"}이 있는 인텐트 필터를 부여하고
+{@code "android.intent.category.LAUNCHER"}를
지정된 카테고리로 설정하면 됩니다. 예:
이런 종류의 인텐트 필터를 사용하면 액티비티에 대한 아이콘과 레이블이
-애플리케이션 시작 관리자에 표시되어 사용자에게 액티비티를 시작할 방법을 부여하며,
+
이런 종류의 인텐트 필터를 사용하면 액티비티에 대한 아이콘과 레이블이
+애플리케이션 시작 관리자에 표시되어 사용자에게 액티비티를 시작할 방법을 부여하며,
액티비티를 시작하고 나면 이것이 생성한 작업에 언제든 돌아올 수 있게 됩니다.
-
이 두 번째 능력이 중요합니다. 사용자는 작업을 떠났다가 이 액티비티 시작 관리자를 사용하여 나중에 작업에
+
이 두 번째 능력이 중요합니다. 사용자는 작업을 떠났다가 이 액티비티 시작 관리자를 사용하여 나중에 작업에
돌아올 수 있어야 합니다. 이러한 이유로, 액티비티가 항상 작업을 시작하는 것으로 표시하는 시작
-모드 두 가지, 즉 {@code "singleTask"}와
-{@code "singleInstance"}는 액티비티에
+모드 두 가지, 즉 {@code "singleTask"}와
+{@code "singleInstance"}는 액티비티에
{@link android.content.Intent#ACTION_MAIN}
- 및 {@link android.content.Intent#CATEGORY_LAUNCHER} 필터가 있을 때에만 사용해야 합니다. 예를 들어 필터가 누락되면 다음과 같은 일이
-발생합니다. 어느 인텐트가 {@code "singleTask"} 액티비티를 시작하여 새 작업을 시작하고,
+ 및 {@link android.content.Intent#CATEGORY_LAUNCHER} 필터가 있을 때에만 사용해야 합니다. 예를 들어 필터가 누락되면 다음과 같은 일이
+발생합니다. 어느 인텐트가 {@code "singleTask"} 액티비티를 시작하여 새 작업을 시작하고,
사용자가 이 작업에서 일하며 어느 정도 시간을 보냅니다. 그런 다음 사용자가 홈
- 버튼을 누릅니다. 이제 이 작업은 배경으로 전송되었으며 눈에 보이지 않습니다. 이제 사용자가 작업으로 되돌아갈
+ 버튼을 누릅니다. 이제 이 작업은 배경으로 전송되었으며 눈에 보이지 않습니다. 이제 사용자가 작업으로 되돌아갈
방법이 없어졌습니다. 이는 애플리케이션 시작 관리자에 표시되지 않기 때문입니다.
Android는 풍성한 애플리케이션 프레임워크를 제공하여 Java 언어 환경에서 실행되는
-모바일 기기에서 사용할 혁신적인 앱과 게임을 구축할 수 있습니다. 왼쪽 탐색 영역에 목록으로 나열된
+
Android는 풍성한 애플리케이션 프레임워크를 제공하여 Java 언어 환경에서 실행되는
+모바일 기기에서 사용할 혁신적인 앱과 게임을 구축할 수 있습니다. 왼쪽 탐색 영역에 목록으로 나열된
여러 문서에서 Android의 다양한 API를 사용하여 앱을 구축하는 방법에 대한 상세한 정보를 제공합니다.
-
Android 개발을 처음 시도하신다면, 다음과 같은
+
Android 개발을 처음 시도하신다면, 다음과 같은
Android 앱 프레임워크 기본 개념을 숙지하는 것이 중요합니다.
@@ -23,14 +23,14 @@ Android 앱 프레임워크 기본 개념을 숙지하는 것이 중요합니다
앱은 여러 개의 진입 지점을 제공합니다.
-
Android 앱은 여러 가지 고유한 구성 요소들의 조합으로 구축되며, 이러한 구성 요소는 개별적으로
-호출할 수도 있습니다. 예를 들어 어떤 하나의 액티비티가 사용자 인터페이스를 위한
-화면을 하나 제공하고, 서비스가 배경에서 독립적으로 작업을 수행할
+
Android 앱은 여러 가지 고유한 구성 요소들의 조합으로 구축되며, 이러한 구성 요소는 개별적으로
+호출할 수도 있습니다. 예를 들어 어떤 하나의 액티비티가 사용자 인터페이스를 위한
+화면을 하나 제공하고, 서비스가 배경에서 독립적으로 작업을 수행할
수 있습니다.
-
한 구성 요소에서 또 다른 구성 요소를 시작하려면 인텐트를 사용하면 됩니다. 심지어 다른 앱에서도
-구성 요소를 시작할 수 있습니다. 지도 앱에서 주소를 표시하는 액티비티를 시작하는 것이 좋은 예입니다. 이 모델은
-하나의 앱에 대한 여러 개의 진입 지점을 제공하여 어느 앱이라도 다른 여러 앱이 호출할 수 있는 작업에 대해
+
한 구성 요소에서 또 다른 구성 요소를 시작하려면 인텐트를 사용하면 됩니다. 심지어 다른 앱에서도
+구성 요소를 시작할 수 있습니다. 지도 앱에서 주소를 표시하는 액티비티를 시작하는 것이 좋은 예입니다. 이 모델은
+하나의 앱에 대한 여러 개의 진입 지점을 제공하여 어느 앱이라도 다른 여러 앱이 호출할 수 있는 작업에 대해
사용자의 "기본" 앱 역할을 합니다.
@@ -48,14 +48,14 @@ Android 앱 프레임워크 기본 개념을 숙지하는 것이 중요합니다
앱은 여러 가지 기기에 맞게 변경됩니다.
-
Android는 적응형 앱 프레임워크를 제공하여 여러 가지 기기 구성에 맞게
-고유한 리소스를 제공할 수 있습니다. 예를 들어, 여러 가지 화면 크기에 맞춰 각기 다른 XML
-레이아웃 파일을 생성하면 시스템이 현재 기기의 화면 크기를 근거로
+
Android는 적응형 앱 프레임워크를 제공하여 여러 가지 기기 구성에 맞게
+고유한 리소스를 제공할 수 있습니다. 예를 들어, 여러 가지 화면 크기에 맞춰 각기 다른 XML
+레이아웃 파일을 생성하면 시스템이 현재 기기의 화면 크기를 근거로
어느 레이아웃을 적용할지 결정합니다.
-
앱 기능이 특정한 하드웨어(예: 카메라)를 필요로 하는 경우 런타임에
-기기 특징의 기능을 쿼리할 수 있습니다. 필요하다면 앱이 필요로 하는 기능을 선언할 수도 있습니다.
-그러면 Google Play Store와 같은 앱 마켓에서 해당 기능을 지원하지 않는 기기에서
+
앱 기능이 특정한 하드웨어(예: 카메라)를 필요로 하는 경우 런타임에
+기기 특징의 기능을 쿼리할 수 있습니다. 필요하다면 앱이 필요로 하는 기능을 선언할 수도 있습니다.
+그러면 Google Play Store와 같은 앱 마켓에서 해당 기능을 지원하지 않는 기기에서
설치를 허용하지 않습니다.
- 모든 애플리케이션에는 루트 라이브러리에 AndroidManifest.xml 파일(정확히
-이 이름으로)이 있어야 합니다. 매니페스트 파일은
-Android 시스템에 대한 여러분의 앱 관련 필수 정보를 나타냅니다.
-즉 앱의 코드를 실행하기 전에 시스템이 반드시 필요로 하는 정보를
+ 모든 애플리케이션에는 루트 라이브러리에 AndroidManifest.xml 파일(정확히
+이 이름으로)이 있어야 합니다. 매니페스트 파일은
+Android 시스템에 대한 여러분의 앱 관련 필수 정보를 나타냅니다.
+즉 앱의 코드를 실행하기 전에 시스템이 반드시 필요로 하는 정보를
말합니다. 매니페스트가 하는 일에는 여러 가지가 있지만, 그 중에서 몇 가지만 소개하면 다음과 같습니다.
-
애플리케이션에 대한 Java 패키지의 이름을 나타냅니다.
+
애플리케이션에 대한 Java 패키지의 이름을 나타냅니다.
패키지 이름이 애플리케이션에 대한 고유한 식별자 역할을 합니다.
-
애플리케이션의 구성 요소를 설명합니다. 액티비티,
-서비스, 브로드캐스트 수신기 및 콘텐츠 제공자 등 애플리케이션을 이루는 여러 항목을
-말합니다. 이것은 각 구성 요소를 구현하는 클래스의 이름을 나타내고
-각각의 기능을 게시합니다(예를 들어 처리할 수 있는 {@link android.content.Intent
-Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이 여러 구성 요소가
+
애플리케이션의 구성 요소를 설명합니다. 액티비티,
+서비스, 브로드캐스트 수신기 및 콘텐츠 제공자 등 애플리케이션을 이루는 여러 항목을
+말합니다. 이것은 각 구성 요소를 구현하는 클래스의 이름을 나타내고
+각각의 기능을 게시합니다(예를 들어 처리할 수 있는 {@link android.content.Intent
+Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이 여러 구성 요소가
각각 무엇인지 알게 되고, 어떤 조건에서 시작해야 하는지 알 수 있습니다.
-
어느 프로세스가 애플리케이션 구성 요소를 호스팅할 것인지 결정합니다.
+
어느 프로세스가 애플리케이션 구성 요소를 호스팅할 것인지 결정합니다.
-
API의 보호된 부분에 액세스하여 다른 애플리케이션과 상호 작용하려면
-애플리케이션에 어느 권한이 꼭 필요한지 선언합니다.
+
API의 보호된 부분에 액세스하여 다른 애플리케이션과 상호 작용하려면
+애플리케이션에 어느 권한이 꼭 필요한지 선언합니다.
-
또한, 이 애플리케이션의 구성 요소와 상호 작용하려면 다른 애플리케이션이
+
또한, 이 애플리케이션의 구성 요소와 상호 작용하려면 다른 애플리케이션이
반드시 가지고 있어야 하는 권한도 선언합니다.
-
이는 애플리케이션이 실행 중일 때 프로파일링과 기타 정보를 제공하는
-{@link android.app.Instrumentation} 클래스를 목록으로 표시합니다. 이러한 선언이 매니페스트에 나타나는 것은
-애플리케이션이 개발 중이고 테스트되는 단계에만 국한됩니다.
+
이는 애플리케이션이 실행 중일 때 프로파일링과 기타 정보를 제공하는
+{@link android.app.Instrumentation} 클래스를 목록으로 표시합니다. 이러한 선언이 매니페스트에 나타나는 것은
+애플리케이션이 개발 중이고 테스트되는 단계에만 국한됩니다.
이들은 애플리케이션이 게시되기 전에 제거됩니다.
-
이는 애플리케이션이 필요로 하는 Android API의 최소 레벨을
+
이는 애플리케이션이 필요로 하는 Android API의 최소 레벨을
선언합니다.
애플리케이션이 연결되어야 하는 라이브러리를 목록으로 표시합니다.
@@ -61,12 +61,12 @@ Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이
매니페스트 파일의 구조
-아래의 다이어그램은 매니페스트 파일의 일반적인 구조와 매니페스트 파일에
-들어있을 수 있는 모든 요소를 표시한 것입니다. 각 요소와 각각의 속성을 모두 문서화한
-전문은 별도의 파일에서 확인하실 수 있습니다. 어떤 요소에 대해서든
-상세한 정보를 보려면 다이어그램에서 해당 요소 이름을 클릭하십시오.
-이름은 다이어그램 뒤에 나오는 요소 목록(알파벳 순) 또는
-요소 이름이 언급되는 기타 영역 어디서든 클릭할 수 있습니다.
+아래의 다이어그램은 매니페스트 파일의 일반적인 구조와 매니페스트 파일에
+들어있을 수 있는 모든 요소를 표시한 것입니다. 각 요소와 각각의 속성을 모두 문서화한
+전문은 별도의 파일에서 확인하실 수 있습니다. 어떤 요소에 대해서든
+상세한 정보를 보려면 다이어그램에서 해당 요소 이름을 클릭하십시오.
+이름은 다이어그램 뒤에 나오는 요소 목록(알파벳 순) 또는
+요소 이름이 언급되는 기타 영역 어디서든 클릭할 수 있습니다.
@@ -126,9 +126,9 @@ Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이
-매니페스트 파일에 표시될 수 있는 모든 요소는 아래에 알파벳 순서로
-목록으로 표시되어 있습니다. 합법적인 요소는 이들이 전부입니다. 개발자 나름대로 요소 또는 속성을
-추가해서는 안 됩니다.
+매니페스트 파일에 표시될 수 있는 모든 요소는 아래에 알파벳 순서로
+목록으로 표시되어 있습니다. 합법적인 요소는 이들이 전부입니다. 개발자 나름대로 요소 또는 속성을
+추가해서는 안 됩니다.
@@ -158,74 +158,74 @@ Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이
-
+
파일 규칙
-몇몇 규칙과 규정은 매니페스트 내의 모든 요소와 속성에 전반적으로
+몇몇 규칙과 규정은 매니페스트 내의 모든 요소와 속성에 전반적으로
적용됩니다.
요소
-
필수 요소는
-<manifest> 및
-<application> 요소뿐으로,
-이들은 각기 따로 표시되어야 하며 한 번씩만 발생할 수 있습니다.
-나머지는 대부분 여러 번 발생할 수 있거나 전혀 발생하지 않기도 합니다. 다만,
-그 중 최소한 몇몇은 있어야 매니페스트가 무엇이든 의미 있는 작업을
+
필수 요소는
+<manifest> 및
+<application> 요소뿐으로,
+이들은 각기 따로 표시되어야 하며 한 번씩만 발생할 수 있습니다.
+나머지는 대부분 여러 번 발생할 수 있거나 전혀 발생하지 않기도 합니다. 다만,
+그 중 최소한 몇몇은 있어야 매니페스트가 무엇이든 의미 있는 작업을
달성할 수 있습니다.
-요소에 무엇이든 들어있기만 하면 다른 요소가 그 요소에 들어 있는 것입니다.
+요소에 무엇이든 들어있기만 하면 다른 요소가 그 요소에 들어 있는 것입니다.
모든 값은 요소 내의 문자 데이터로서가 아니라 속성을 통해 설정됩니다.
공식적인 의미에서 모든 속성은 선택 항목입니다. 그러나, 요소가 목적을 달성하기
-위해서 반드시 지정되어야 하는 것이 몇 가지 있습니다. 관련 문서를
-지침으로 사용하십시오. 정말로 선택적인 속성의 경우, 기본 값을 언급하거나
+
공식적인 의미에서 모든 속성은 선택 항목입니다. 그러나, 요소가 목적을 달성하기
+위해서 반드시 지정되어야 하는 것이 몇 가지 있습니다. 관련 문서를
+지침으로 사용하십시오. 정말로 선택적인 속성의 경우, 기본 값을 언급하거나
사양이 없으면 어떤 일이 벌어지는지 진술합니다.
-
루트
+<manifest>
요소의 몇 가지 속성을 제외하고 모든 속성 이름은 {@code android:alwaysRetainTaskState} 접두사로 시작합니다.
-예를 들어, {@code android:}와 같습니다. 이 접두사는 범용이기 때문에
-속성을 이름으로 참조하는 경우 관련 문서가 이를 생략하는 경우가
+예를 들어, {@code android:}와 같습니다. 이 접두사는 범용이기 때문에
+속성을 이름으로 참조하는 경우 관련 문서가 이를 생략하는 경우가
일반적입니다.
하위 클래스를 정의하는 경우 구성 요소 클래스
-({@link android.app.Activity}, {@link android.app.Service},
-{@link android.content.BroadcastReceiver} 및 {@link android.content.ContentProvider})는 거의 항상 이렇게 하게 되는데,
-이때 하위 클래스는 {@code name} 속성을 통해 선언됩니다. 이 이름에 반드시
-완전한 패키지 지정이 포함되어 있어야 합니다.
+({@link android.app.Activity}, {@link android.app.Service},
+{@link android.content.BroadcastReceiver} 및 {@link android.content.ContentProvider})는 거의 항상 이렇게 하게 되는데,
+이때 하위 클래스는 {@code name} 속성을 통해 선언됩니다. 이 이름에 반드시
+완전한 패키지 지정이 포함되어 있어야 합니다.
예를 들어, {@link android.app.Service} 하위 클래스를 선언하려면 다음과 같이 할 수 있습니다.
@@ -239,12 +239,12 @@ Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이
</manifest>
-그러나 일종의 줄임으로서 문자열의 첫 번째 글자가 마침표인 경우, 해당
+그러나 일종의 줄임으로서 문자열의 첫 번째 글자가 마침표인 경우, 해당
문자열은 애플리케이션의 패키지 이름에 추가됩니다(
-<manifest>
-요소의
-package
-속성에서 지정한 바와 같이). 다음 할당은 위의 것과 같습니다.
+<manifest>
+요소의
+package
+속성에서 지정한 바와 같이). 다음 할당은 위의 것과 같습니다.
<manifest package="com.example.project" . . . >
@@ -257,13 +257,13 @@ Intent} 메시지 종류 등). 이러한 선언을 통해 Android 시스템이
</manifest>
-Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스의 인스턴스를 생성합니다.
+Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스의 인스턴스를 생성합니다.
하위 클래스가 지정되지 않은 경우, 기본 클래스의 인스턴스를 생성합니다.
여러 개의 값
-
하나 이상의 값을 지정할 수 있는 경우, 해당 요소는
-한 요소 안에 여러 개의 값을 목록으로 표시하기보다 거의 항상 반복됩니다.
+
하나 이상의 값을 지정할 수 있는 경우, 해당 요소는
+한 요소 안에 여러 개의 값을 목록으로 표시하기보다 거의 항상 반복됩니다.
예를 들어 한 인텐트 필터가 여러 개의 작업을 목록으로 표시할 수 있습니다.
<intent-filter . . . >
@@ -274,9 +274,9 @@ Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스
</intent-filter>
리소스 값
-
몇몇 속성에는 사용자에게 표시될 수 있는 값이 있습니다. 예를 들어
-액티비티에 대한 레이블과 아이콘 등이 이에 해당됩니다. 이러한 속성의 값은
-지역화해야 하며 따라서 리소스나 테마에서 설정됩니다. 리소스
+
몇몇 속성에는 사용자에게 표시될 수 있는 값이 있습니다. 예를 들어
+액티비티에 대한 레이블과 아이콘 등이 이에 해당됩니다. 이러한 속성의 값은
+지역화해야 하며 따라서 리소스나 테마에서 설정됩니다. 리소스
값은 다음과 같은 형식으로 표현됩니다.
{@code @[패키지:]유형:이름}
@@ -284,7 +284,7 @@ Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스
여기에서 패키지 이름은 리소스가 애플리케이션과 같은 패키지에 있으면 생략할 수 있고,
유형 은 "문자열" 또는 "그릴 수 있음" 같은 리소스 유형입니다. 그리고
- 이름 은 특정 리소스를 식별하는 이름입니다.
+ 이름 은 특정 리소스를 식별하는 이름입니다.
예:
@@ -299,8 +299,8 @@ Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스
문자열 값
-
속성 값이 문자열인 경우, 이중 백슬래시('{@code \\}')를 사용하여
-문자 이스케이프를 수행해야 합니다. 예를 들어 줄바꿈에는 {@code \\n},
+
속성 값이 문자열인 경우, 이중 백슬래시('{@code \\}')를 사용하여
+문자 이스케이프를 수행해야 합니다. 예를 들어 줄바꿈에는 {@code \\n},
유니코드 문자에는 '{@code \\uxxxx}'를 쓰십시오.
@@ -308,7 +308,7 @@ Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스
파일 기능
-다음 섹션에서는 Android 기능을 매니페스트 파일에 반영하는
+다음 섹션에서는 Android 기능을 매니페스트 파일에 반영하는
몇 가지 방식을 설명합니다.
@@ -316,37 +316,37 @@ Android는 구성 요소를 시작할 때 이름이 명명된 하위 클래스
인텐트 필터
-애플리케이션의 핵심 구성 요소(액티비티, 서비스 및 브로드캐스트
-수신기)를 활성화하는 것은 인텐트입니다. 인텐트는
+애플리케이션의 핵심 구성 요소(액티비티, 서비스 및 브로드캐스트
+수신기)를 활성화하는 것은 인텐트입니다. 인텐트는
원하는 작업을 설명하는 정보 묶음입니다({@link android.content.Intent} 객체).
-여기에는 작업을 수행할 데이터, 작업을 수행할 구성 요소의 카테고리와
-기타 관련 지침 등이 포함됩니다.
-Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한 경우 구성 요소의
-새 인스턴스를 시작하고, 이것을 인텐트 객체에
+여기에는 작업을 수행할 데이터, 작업을 수행할 구성 요소의 카테고리와
+기타 관련 지침 등이 포함됩니다.
+Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한 경우 구성 요소의
+새 인스턴스를 시작하고, 이것을 인텐트 객체에
전달합니다.
-구성 요소는 자신의 능력을 알립니다. 즉, 자신이 응답할 수 있는
-인텐트 종류를 밝힙니다. 이때 사용하는 것이 인텐트 필터입니다. Android 시스템은
-구성 요소를 시작하기 전에 해당 구성 요소가 처리할 수 있는 인텐트에 대해 학습해야 하기 때문에,
-인텐트 필터는 매니페스트 파일에
-<intent-filter>
-요소로 지정됩니다. 구성 요소 하나에 필터는 얼마든지 있을 수 있으며, 각각 서로 다른 기능을
+구성 요소는 자신의 능력을 알립니다. 즉, 자신이 응답할 수 있는
+인텐트 종류를 밝힙니다. 이때 사용하는 것이 인텐트 필터입니다. Android 시스템은
+구성 요소를 시작하기 전에 해당 구성 요소가 처리할 수 있는 인텐트에 대해 학습해야 하기 때문에,
+인텐트 필터는 매니페스트 파일에
+<intent-filter>
+요소로 지정됩니다. 구성 요소 하나에 필터는 얼마든지 있을 수 있으며, 각각 서로 다른 기능을
설명하게 됩니다.
대상 구성 요소를 명시적으로 지명하는 인텐트가 해당 구성 요소를 활성화합니다.
-필터는 아무런 역할을 하지 않습니다. 하지만 대상을 이름으로 지정하지 않는 인텐트의 경우에는
-자신이 구성 요소의 필터 중 하나를 통과할 수 있을 때에만 해당 구성 요소를 활성화할 수
+필터는 아무런 역할을 하지 않습니다. 하지만 대상을 이름으로 지정하지 않는 인텐트의 경우에는
+자신이 구성 요소의 필터 중 하나를 통과할 수 있을 때에만 해당 구성 요소를 활성화할 수
있습니다.
@@ -354,42 +354,42 @@ Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한
아이콘 및 레이블
-대다수의 요소에 {@code icon}과 {@code label} 속성이 있으며
-이것으로 사용자에게 표시될 수 있는 작은 아이콘과 텍스트 레이블을 나타냅니다. 몇몇 요소에는
-{@code description} 속성도 있어 좀 더 긴 설명 텍스트를 나타낼 수 있고, 이것 또한 화면에
-표시될 수 있습니다. 예를 들어
+대다수의 요소에 {@code icon}과 {@code label} 속성이 있으며
+이것으로 사용자에게 표시될 수 있는 작은 아이콘과 텍스트 레이블을 나타냅니다. 몇몇 요소에는
+{@code description} 속성도 있어 좀 더 긴 설명 텍스트를 나타낼 수 있고, 이것 또한 화면에
+표시될 수 있습니다. 예를 들어
<permission>
-요소는 이와 같은 속성을 셋 모두 가지고 있어 사용자가 이를 요청한 애플리케이션에 대한
-권한을 허가할 것인지 여부를 물으면 해당 권한,
-권한의 이름과 그에 수반되는 내용에 대한 설명을
+요소는 이와 같은 속성을 셋 모두 가지고 있어 사용자가 이를 요청한 애플리케이션에 대한
+권한을 허가할 것인지 여부를 물으면 해당 권한,
+권한의 이름과 그에 수반되는 내용에 대한 설명을
사용자에게 표시할 수 있습니다.
-어떤 경우에든, 요소에서 설정된 아이콘과 레이블이 해당 컨테이너의 모든 하위 요소에 대한 기본
-{@code icon}과 {@code label} 설정이 됩니다.
-따라서
-<application>
-요소에서 설정된 아이콘과 레이블이 애플리케이션의 각 요소에 대한 기본 아이콘과 레이블입니다.
-이와 유사하게, 구성 요소에 대해 설정된 아이콘과 레이블이 — 예를 들어
-<activity>
-요소 — 각 구성 요소의
-<intent-filter>
-요소에 대한 기본 설정입니다.
-<application>
-요소가 레이블을 설정하지만 액티비티와 그 인텐트 필터는 이를 설정하지 않는 경우,
-애플리케이션 레이블을 액티비티와 인텐트 필터 양쪽 모두의 레이블인 것으로
+어떤 경우에든, 요소에서 설정된 아이콘과 레이블이 해당 컨테이너의 모든 하위 요소에 대한 기본
+{@code icon}과 {@code label} 설정이 됩니다.
+따라서
+<application>
+요소에서 설정된 아이콘과 레이블이 애플리케이션의 각 요소에 대한 기본 아이콘과 레이블입니다.
+이와 유사하게, 구성 요소에 대해 설정된 아이콘과 레이블이 — 예를 들어
+<activity>
+요소 — 각 구성 요소의
+<intent-filter>
+요소에 대한 기본 설정입니다.
+<application>
+요소가 레이블을 설정하지만 액티비티와 그 인텐트 필터는 이를 설정하지 않는 경우,
+애플리케이션 레이블을 액티비티와 인텐트 필터 양쪽 모두의 레이블인 것으로
취급합니다.
-인텐트 필터에 대해 설정된 아이콘과 레이블은 구성 요소가 사용자에게
-표시될 때마다 구성 요소를 나타내는 데 사용되며, 이는 필터가 알린 기능을
-충족하는 것입니다. 예를 들어
-"{@code android.intent.action.MAIN}" 및
-"{@code android.intent.category.LAUNCHER}"가 설정된 필터는
-액티비티를 애플리케이션을 초기화하는 주역으로 알립니다. 다시 말해,
-애플리케이션 시작 관리자에 표시되어야 하는 것이 됩니다. 따라서 필터에서 설정된 아이콘과 레이블이
+인텐트 필터에 대해 설정된 아이콘과 레이블은 구성 요소가 사용자에게
+표시될 때마다 구성 요소를 나타내는 데 사용되며, 이는 필터가 알린 기능을
+충족하는 것입니다. 예를 들어
+"{@code android.intent.action.MAIN}" 및
+"{@code android.intent.category.LAUNCHER}"가 설정된 필터는
+액티비티를 애플리케이션을 초기화하는 주역으로 알립니다. 다시 말해,
+애플리케이션 시작 관리자에 표시되어야 하는 것이 됩니다. 따라서 필터에서 설정된 아이콘과 레이블이
시작 관리자에 표시되는 아이콘과 레이블입니다.
@@ -397,14 +397,14 @@ Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한
권한
-통상 권한 이란 기기에서 코드의 일부분 또는 데이터에 대한 액세스를 한정하는
-제한입니다. 이런 한계를 부과하는 것은 중요한 데이터와 코드를 보호하여
-이들이 남용되어서 사용자 환경을 왜곡하거나 손상시키지 않도록 하기 위해서입니다.
+통상 권한 이란 기기에서 코드의 일부분 또는 데이터에 대한 액세스를 한정하는
+제한입니다. 이런 한계를 부과하는 것은 중요한 데이터와 코드를 보호하여
+이들이 남용되어서 사용자 환경을 왜곡하거나 손상시키지 않도록 하기 위해서입니다.
-각 권한은 고유한 레이블로 식별할 수 있습니다. 레이블을 보면 자신이 어떤 작업을 제한하는지
-나타내는 경우가 잦습니다. 예를 들어 다음은 Android가 정의하는 몇 가지 권한을 나타낸
+각 권한은 고유한 레이블로 식별할 수 있습니다. 레이블을 보면 자신이 어떤 작업을 제한하는지
+나타내는 경우가 잦습니다. 예를 들어 다음은 Android가 정의하는 몇 가지 권한을 나타낸
것입니다.
@@ -418,26 +418,26 @@ Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한
-애플리케이션에서 권한으로 보호하는 기능에 액세스해야 하는 경우,
-해당 권한이 필요하다고 매니페스트의
-<uses-permission>
-요소로 선언해야 합니다. 그런 다음, 해당 애플리케이션이 기기에 설치되고 나면
-설치 관리자가 요청한 권한을 허가할지 여부를 판별합니다.
-이때 애플리케이션의 인증서를 서명한 권한을 확인하고 어떤 경우에는 사용자에게
-묻기도 합니다.
-권한이 허가되면 해당 애플리케이션은 보호된 기능을 사용할 수
-있습니다. 허가되지 않으면, 그러한 기능에 액세스하려는 애플리케이션의 시도가 단순히 실패하고 사용자에게는
-아무런 알림도 표시되지 않습니다.
+애플리케이션에서 권한으로 보호하는 기능에 액세스해야 하는 경우,
+해당 권한이 필요하다고 매니페스트의
+<uses-permission>
+요소로 선언해야 합니다. 그런 다음, 해당 애플리케이션이 기기에 설치되고 나면
+설치 관리자가 요청한 권한을 허가할지 여부를 판별합니다.
+이때 애플리케이션의 인증서를 서명한 권한을 확인하고 어떤 경우에는 사용자에게
+묻기도 합니다.
+권한이 허가되면 해당 애플리케이션은 보호된 기능을 사용할 수
+있습니다. 허가되지 않으면, 그러한 기능에 액세스하려는 애플리케이션의 시도가 단순히 실패하고 사용자에게는
+아무런 알림도 표시되지 않습니다.
-애플리케이션은 권한을 사용하여 자신의 구성 요소를(액티비티, 서비스,
-브로드캐스트 수신기 및 콘텐츠 제공자) 보호할 수도 있습니다. Android가 정의한
+애플리케이션은 권한을 사용하여 자신의 구성 요소를(액티비티, 서비스,
+브로드캐스트 수신기 및 콘텐츠 제공자) 보호할 수도 있습니다. Android가 정의한
권한이라면 어떤 것이든 사용할 수 있고(
-{@link android.Manifest.permission android.Manifest.permission}에 목록으로 나열),
-아니면 다른 애플리케이션이 선언한 권한을 사용해도 됩니다. 아예 직접 자신만의 권한을 정의해도 됩니다. 새 권한을 선언할 때에는
+{@link android.Manifest.permission android.Manifest.permission}에 목록으로 나열),
+아니면 다른 애플리케이션이 선언한 권한을 사용해도 됩니다. 아예 직접 자신만의 권한을 정의해도 됩니다. 새 권한을 선언할 때에는
-<permission>
+<permission>
요소를 사용합니다. 예를 들어 액티비티를 보호하려면 다음과 같이 하면 됩니다.
@@ -457,43 +457,43 @@ Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한
-이 예시에서는 {@code DEBIT_ACCT} 권한이
+이 예시에서는 {@code DEBIT_ACCT} 권한이
-<permission>
-요소로 선언하였을 뿐만 아니라, 해당 권한의 사용 또한
-<uses-permission>
-요소로 요청되었다는 점을 눈여겨 보십시오. 이것의 사용을 요청해야 애플리케이션의 다른 구성 요소가 보호된
-액티비티를 시작할 수 있습니다. 이는 해당 보호를 애플리케이션 자신이 부과한 것이더라도
-관계 없이 적용됩니다.
+<permission>
+요소로 선언하였을 뿐만 아니라, 해당 권한의 사용 또한
+<uses-permission>
+요소로 요청되었다는 점을 눈여겨 보십시오. 이것의 사용을 요청해야 애플리케이션의 다른 구성 요소가 보호된
+액티비티를 시작할 수 있습니다. 이는 해당 보호를 애플리케이션 자신이 부과한 것이더라도
+관계 없이 적용됩니다.
-같은 예시에서, {@code permission} 속성이 다른 곳에서
+같은 예시에서, {@code permission} 속성이 다른 곳에서
선언한 권한에 설정된 경우
-(예: {@code android.permission.CALL_EMERGENCY_NUMBERS}), 이것을
+(예: {@code android.permission.CALL_EMERGENCY_NUMBERS}), 이것을
-<permission>
-요소를 사용하여 다시 선언할 필요가 없습니다. 하지만 해당 권한의 사용은 여전히
-<uses-permission>로 요청해야 합니다.
+<permission>
+요소를 사용하여 다시 선언할 필요가 없습니다. 하지만 해당 권한의 사용은 여전히
+<uses-permission>로 요청해야 합니다.
-<permission-tree>
-요소는 코드로 정의될 권한 그룹에 대한 네임스페이스를
-선언합니다. 그리고
+<permission-tree>
+요소는 코드로 정의될 권한 그룹에 대한 네임스페이스를
+선언합니다. 그리고
<permission-group>
-가 권한 집합에 대한 레이블을 정의합니다(매니페스트에
-<permission>
-요소로 선언한 것과 다른 곳에서 선언한 것 양쪽 모두). 이것은 권한이 사용자에게 표시될 때
-그룹 지정될 방식에만 영향을 미칩니다.
+가 권한 집합에 대한 레이블을 정의합니다(매니페스트에
+<permission>
+요소로 선언한 것과 다른 곳에서 선언한 것 양쪽 모두). 이것은 권한이 사용자에게 표시될 때
+그룹 지정될 방식에만 영향을 미칩니다.
<permission-group>
-요소는 그룹에 어느 권한이 속해 있는지 지정하는 것이 아니라, 그저
-그룹에 이름을 부여할 뿐입니다. 그룹에 권한을 배치하려면 그룹 이름을
+요소는 그룹에 어느 권한이 속해 있는지 지정하는 것이 아니라, 그저
+그룹에 이름을 부여할 뿐입니다. 그룹에 권한을 배치하려면 그룹 이름을
-<permission>
-요소의
-permissionGroup
+<permission>
+요소의
+permissionGroup
속성에 할당하면 됩니다.
@@ -501,17 +501,17 @@ Android는 인텐트에 응답할 적절한 구성 요소를 찾아 필요한
라이브러리
-모든 애플리케이션은 기본 Android 라이브러리에 연결되어 있습니다. 여기에는
-애플리케이션 구축을 위한 기본적인 패키지(액티비티, 서비스,
-인텐트, 보기, 버튼, 애플리케이션, ContentProvider 등 보편적인 클래스 포함)가 포함되어
+모든 애플리케이션은 기본 Android 라이브러리에 연결되어 있습니다. 여기에는
+애플리케이션 구축을 위한 기본적인 패키지(액티비티, 서비스,
+인텐트, 보기, 버튼, 애플리케이션, ContentProvider 등 보편적인 클래스 포함)가 포함되어
있습니다.
-그러나 패키지 가운데에는 자신만의 라이브러리에 속한 것도 있습니다. 애플리케이션이
-사용하는 코드의 출처가 이러한 패키지 가운데 어느 한 가지에 해당되는 경우, 해당 패키지에 연결되도록
-명시적으로 요청해야만 합니다. 매니페스트에는 별도의
-<uses-library>
-요소가 들어 있어 각 라이브러리의 이름을 나타내야 합니다 (라이브러리 이름은 패키지에 대한
+그러나 패키지 가운데에는 자신만의 라이브러리에 속한 것도 있습니다. 애플리케이션이
+사용하는 코드의 출처가 이러한 패키지 가운데 어느 한 가지에 해당되는 경우, 해당 패키지에 연결되도록
+명시적으로 요청해야만 합니다. 매니페스트에는 별도의
+<uses-library>
+요소가 들어 있어 각 라이브러리의 이름을 나타내야 합니다 (라이브러리 이름은 패키지에 대한
관련 문서에서 찾을 수 있습니다).
캘린더 제공자는 사용자의 캘린더 이벤트를 저장하는 리포지토리입니다.
-캘린더 제공자 API를 사용하면 캘린더, 이벤트, 참석자, 알림 등의 쿼리, 삽입, 업데이트 및
+
캘린더 제공자는 사용자의 캘린더 이벤트를 저장하는 리포지토리입니다.
+캘린더 제공자 API를 사용하면 캘린더, 이벤트, 참석자, 알림 등의 쿼리, 삽입, 업데이트 및
삭제 등의 작업을 수행할 수 있습니다.
-
캘린더 제공자 API는 애플리케이션과 동기화 어댑터에서 사용할 수 있습니다.
-어떤 유형의 프로그램이 호출을 하는 주체인지에 따라 규칙이 각기 다릅니다.
-이 문서는 주로 캘린더 제공자 API를 애플리케이션으로 사용하는 것에 주안점을 두었습니다.
-여러 동기화 어댑터가 서로 어떻게 다른지 논의한 내용은
+
캘린더 제공자 API는 애플리케이션과 동기화 어댑터에서 사용할 수 있습니다.
+어떤 유형의 프로그램이 호출을 하는 주체인지에 따라 규칙이 각기 다릅니다.
+이 문서는 주로 캘린더 제공자 API를 애플리케이션으로 사용하는 것에 주안점을 두었습니다.
+여러 동기화 어댑터가 서로 어떻게 다른지 논의한 내용은
동기화 어댑터를 참조하십시오.
-
캘린더 데이터를 읽거나 쓰려면 보통 애플리케이션의 매니페스트에
-적절한 권한이 포함되어 있어야 합니다. 이는 사용자
+
에 설명된 바와 같이 인텐트 집합을 제공합니다. 이와 같은 인텐트는 사용자를 캘린더 애플리케이션으로 이동시켜
+이벤트 삽입, 보기 및 편집을 할 수 있게 해줍니다. 사용자는 캘린더 애플리케이션과 상호 작용한 다음
+원래 애플리케이션으로 돌아옵니다. 따라서, 여러분의 애플리케이션이 이벤트를 보거나
생성하기 위해 권한 허가를 요청할 필요도 없고 사용자 인터페이스를 제공할 필요도 없는 것입니다.
콘텐츠 제공자는 데이터를 저장하여 애플리케이션에서
이에 액세스할 수 있도록 합니다. 일반적으로, Android 플랫폼에서 제공하는 콘텐츠 제공자(캘린더 제공자 포함)는
관계 데이터베이스 모델에 기초하여 테이블 집합으로 데이터를 노출합니다. 이 모델에서 각 행은 레코드이고,
-각 열은 특정한 유형과 의미를 가진 데이터입니다. 애플리케이션과 동기화 어댑터는
-캘린더 제공자 API를 통해 사용자의 캘린더 데이터를 보관하고 있는 데이터베이스 테이블에
+각 열은 특정한 유형과 의미를 가진 데이터입니다. 애플리케이션과 동기화 어댑터는
+캘린더 제공자 API를 통해 사용자의 캘린더 데이터를 보관하고 있는 데이터베이스 테이블에
읽기/쓰기 액세스 권한을 얻을 수 있습니다.
모든 콘텐츠 제공자는 데이터 세트를 고유하게 식별하는 공개 URI(
-{@link android.net.Uri}
+{@link android.net.Uri}
개체로 래핑됨)를 노출합니다. 여러 데이터 세트(여러 테이블)를 제어하는 콘텐츠 제공자는
-각 데이터 세트에 별도의 URI를 노출합니다.
-제공자에 대한 URI는 모두 문자열 "content://"로 시작합니다.
-이것을 보면 데이터를 콘텐츠 제공자가 제어하고 있다는 것을 알아볼 수 있습니다.
-캘린더 제공자가 각각의 클래스(테이블)에 대한 URI의 상수를 정의합니다.
-이와 같은 URI는 <class>.CONTENT_URI 형식을 취합니다.
+각 데이터 세트에 별도의 URI를 노출합니다.
+제공자에 대한 URI는 모두 문자열 "content://"로 시작합니다.
+이것을 보면 데이터를 콘텐츠 제공자가 제어하고 있다는 것을 알아볼 수 있습니다.
+캘린더 제공자가 각각의 클래스(테이블)에 대한 URI의 상수를 정의합니다.
+이와 같은 URI는 <class>.CONTENT_URI 형식을 취합니다.
예를 들면 다음과 같습니다. {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
-
그림 1은 캘린더 제공자 데이터 모델을 그림으로 나타낸 것입니다.
+
그림 1은 캘린더 제공자 데이터 모델을 그림으로 나타낸 것입니다.
이 그림에는 메인 테이블과이들을 서로 연결하는 필드가 표시되어 있습니다.
이 테이블에는 캘린더별 정보가 담겨 있습니다.
- 이 테이블의 행마다 한 캘린더의 세부 정보,
+ 이 테이블의 행마다 한 캘린더의 세부 정보,
예를 들어 이름, 색상, 동기화 정보 등이 들어갑니다.
{@link android.provider.CalendarContract.Events}
-
+
이 테이블에는 이벤트별 정보가 담겨 있습니다.
이 테이블의 행마다 한 이벤트의 세부 정보
예를 들어 이벤트 제목, 위치, 시작 시간, 종료 시간 등의 정보가 들어갑니다.
- 이벤트는 일회성일 수도 있고 여러 번 반복될 수도 있습니다.
-참석자, 알림 및 확장된 속성 등은 별도의 테이블에 저장됩니다.
-이들 테이블에는 각기 {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}가 있어
+ 이벤트는 일회성일 수도 있고 여러 번 반복될 수도 있습니다.
+참석자, 알림 및 확장된 속성 등은 별도의 테이블에 저장됩니다.
+이들 테이블에는 각기 {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}가 있어
이벤트 테이블의 {@link android.provider.BaseColumns#_ID}를 참조합니다.
이 테이블에는 각 이벤트 발생의 시작 시간과 종료 시간이
담겨 있습니다. 이 테이블의 각 행이 하나의 이벤트 발생을 나타냅니다.
일회성 이벤트의 경우, 이벤트에 대한 1:1 인스턴스 매핑이 있습니다.
- 반복되는 이벤트의 경우, 해당 이벤트가 여러 번 발생하는 것에 맞추어
+ 반복되는 이벤트의 경우, 해당 이벤트가 여러 번 발생하는 것에 맞추어
자동으로 여러 행이 생성됩니다.
이 테이블에는 이벤트 참석자(게스트) 정보가 담겨 있습니다.
각 행이 주어진 이벤트의 게스트 한 사람을 나타냅니다.
- 이것이 게스트의 유형과, 이벤트에 대한 해당 게스트의 참석 여부 응답을
+ 이것이 게스트의 유형과, 이벤트에 대한 해당 게스트의 참석 여부 응답을
나타냅니다.
이 테이블에는 경고/알림 데이터가 담겨 있습니다.
- 각 행이 주어진 이벤트에 대한 경고 하나를 나타냅니다.
+ 각 행이 주어진 이벤트에 대한 경고 하나를 나타냅니다.
이벤트 하나에 여러 개의 알림이 있을 수 있습니다. 이벤트당 최대 알림 개수는
-{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS}에서 지정되고,
+{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS}에서 지정되고,
이는 주어진 캘린더를 소유한 동기화 어댑터가 설정합니다.
- 알림은 이벤트 몇 분 전에 지정되며 사용자에게 어떻게 경고할 것인지를
+ 알림은 이벤트 몇 분 전에 지정되며 사용자에게 어떻게 경고할 것인지를
결정하는 메서드를 가지고 있습니다.
-
+
-
캘린더 제공자 API는 유연성과 강력함을 염두에 두고 만들어진 것입니다.
-그와 동시에 우수한 최종 사용자 경험을 제공하고 캘린더와 그 데이터의
+
캘린더 제공자 API는 유연성과 강력함을 염두에 두고 만들어진 것입니다.
+그와 동시에 우수한 최종 사용자 경험을 제공하고 캘린더와 그 데이터의
무결성을 보호하는 것 또한 중요합니다. 이를 위해서
API를 사용할 때 유념해야 할 사항은 다음과 같습니다.
-
캘린더 이벤트 삽입, 업데이트 및 보기. 캘린더 제공자로부터 직접 이벤트를 삽입, 변경하고 읽으려면 적절한 권한이 필요합니다. 그러나, 완전한 캘린더 애플리케이션 또는 동기화 어댑터를 구축하는 경우가 아니라면 이와 같은 권한을 요청할 필요가 없습니다. 대신 Android의 캘린더 애플리케이션이 지원하는 인텐트를 사용하여 해당 애플리케이션에 읽기 및 쓰기 작업을 분배하면 됩니다. 인텐트를 사용하면, 애플리케이션이 사용자를 캘린더 애플리케이션으로 보내 사전에 작성된 양식으로 원하는 작업을
-수행하게 합니다. 작업이 끝나면 사용자는 애플리케이션으로 돌아옵니다.
-캘린더를 통해 공통 작업을 수행하도록 애플리케이션을 설계함으로써 사용자에게 일관되고 강력한
+
캘린더 이벤트 삽입, 업데이트 및 보기. 캘린더 제공자로부터 직접 이벤트를 삽입, 변경하고 읽으려면 적절한 권한이 필요합니다. 그러나, 완전한 캘린더 애플리케이션 또는 동기화 어댑터를 구축하는 경우가 아니라면 이와 같은 권한을 요청할 필요가 없습니다. 대신 Android의 캘린더 애플리케이션이 지원하는 인텐트를 사용하여 해당 애플리케이션에 읽기 및 쓰기 작업을 분배하면 됩니다. 인텐트를 사용하면, 애플리케이션이 사용자를 캘린더 애플리케이션으로 보내 사전에 작성된 양식으로 원하는 작업을
+수행하게 합니다. 작업이 끝나면 사용자는 애플리케이션으로 돌아옵니다.
+캘린더를 통해 공통 작업을 수행하도록 애플리케이션을 설계함으로써 사용자에게 일관되고 강력한
사용자 인터페이스를 제공하는 것입니다. 이것이 권장 방법입니다.
자세한 정보는 캘린더
인텐트를 참조하십시오.
-
동기화 어댑터.
-동기화 어댑터는 사용자의 기기에 있는 캘린더 데이터를 다른 서버 또는 데이터 소스와 동기화합니다.
+
동기화 어댑터.
+동기화 어댑터는 사용자의 기기에 있는 캘린더 데이터를 다른 서버 또는 데이터 소스와 동기화합니다.
{@link android.provider.CalendarContract.Calendars}와
{@link android.provider.CalendarContract.Events} 테이블에는
동기화 어댑터가 사용하도록 예약된 열이 있습니다.
-제공자와 애플리케이션은 이를 수정해서는 안 됩니다. 사실, 동기화 어댑터로 액세스하지 않는 한
-이 열이 표시되지 않습니다.
+제공자와 애플리케이션은 이를 수정해서는 안 됩니다. 사실, 동기화 어댑터로 액세스하지 않는 한
+이 열이 표시되지 않습니다.
동기화 어댑터에 대한 자세한 정보는 동기화 어댑터를 참조하십시오.
@@ -192,8 +192,8 @@ API를 사용할 때 유념해야 할 사항은 다음과 같습니다.
사용자 권한
캘린더 데이터를 읽으려면 애플리케이션의 매니페스트 파일에 {@link
-android.Manifest.permission#READ_CALENDAR} 권한이 포함되어 있어야 합니다.
-캘린더 데이터를 삭제, 삽입 또는 업데이트하려면{@link android.Manifest.permission#WRITE_CALENDAR}
+android.Manifest.permission#READ_CALENDAR} 권한이 포함되어 있어야 합니다.
+캘린더 데이터를 삭제, 삽입 또는 업데이트하려면{@link android.Manifest.permission#WRITE_CALENDAR}
권한이 포함되어 있어야 합니다.
@@ -209,10 +209,10 @@ android.Manifest.permission#READ_CALENDAR} 권한이 포함되어 있어야 합
캘린더 테이블
-
{@link android.provider.CalendarContract.Calendars}
-테이블에는 각각의 캘린더에 대한 세부 정보가 들어 있습니다.
-다음 캘린더 열은 애플리케이션과 동기화 어댑터 모두 쓸 수 있는 것입니다.
-지원되는 필드의 전체 목록은
+
{@link android.provider.CalendarContract.Calendars}
+테이블에는 각각의 캘린더에 대한 세부 정보가 들어 있습니다.
+다음 캘린더 열은 애플리케이션과 동기화 어댑터 모두 쓸 수 있는 것입니다.
+지원되는 필드의 전체 목록은
{@link android.provider.CalendarContract.Calendars} 참조를 확인하십시오.
@@ -229,8 +229,8 @@ android.Manifest.permission#READ_CALENDAR} 권한이 포함되어 있어야 합
캘린더를 표시하기로 선택했는지를 나타내는 부울입니다.
값이 0이면 이 캘린더와 연관된 이벤트는 표시하면 안 된다는 뜻입니다.
값이 1이면 이 캘린더와 연관된 이벤트를 표시해야 한다는 뜻입니다.
이 값이 {@link
@@ -240,10 +240,10 @@ android.provider.CalendarContract.Instances} 테이블의 행 생성에 영향
캘린더를 동기화하고 이 캘린더의 이벤트를 기기에 저장해야할지를
-나타내는 부울입니다. 값이 0이면 이 캘린더를 동기화하거나 이에 속한 이벤트를
-기기에 저장하면 안 된다는 뜻입니다. 값이 1이면 이 캘린더에 대한 이벤트를 동기화하고 이에 속한
+
+
캘린더를 동기화하고 이 캘린더의 이벤트를 기기에 저장해야할지를
+나타내는 부울입니다. 값이 0이면 이 캘린더를 동기화하거나 이에 속한 이벤트를
+기기에 저장하면 안 된다는 뜻입니다. 값이 1이면 이 캘린더에 대한 이벤트를 동기화하고 이에 속한
이벤트를 기기에 저장하라는 뜻입니다.
@@ -253,8 +253,8 @@ android.provider.CalendarContract.Instances} 테이블의 행 생성에 영향
다음은 특정한 사용자가 소유한 캘린더를 가져오는 법을 나타낸 예시입니다.
이 예시에서는 단순하게 나타내기 위해 쿼리 작업을 사용자 인터페이스 스레드("주 스레드")에 표시했습니다.
실제로는, 이 작업은 주 스레드 대신 비동기화 스레드에서 해야 합니다.
- 자세한 논의는
-로더를 참조하십시오. 데이터를 읽기만 하는 것이 아니라 변경도 하는 경우라면,
+ 자세한 논의는
+로더를 참조하십시오. 데이터를 읽기만 하는 것이 아니라 변경도 하는 경우라면,
{@link android.content.AsyncQueryHandler}를 참조하십시오.
@@ -268,90 +268,90 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
ACCOUNT_TYPE을 반드시 포함시켜야 하는 이유는 무엇일까요?
{@link
android.provider.CalendarContract.Calendars#ACCOUNT_NAME
-Calendars.ACCOUNT_NAME}에 대해 쿼리하는 경우, 해당 선택에
+Calendars.ACCOUNT_NAME}에 대해 쿼리하는 경우, 해당 선택에
{@link android.provider.CalendarContract.Calendars#ACCOUNT_TYPE Calendars.ACCOUNT_TYPE}
-도 포함시켜야 합니다. 이는 주어진 계정을 고유하다고 간주하는 것은 해당 계정의
-ACCOUNT_NAME 및
-ACCOUNT_TYPE이 모두 있을 때뿐이기 때문입니다. ACCOUNT_TYPE은 계정이
+도 포함시켜야 합니다. 이는 주어진 계정을 고유하다고 간주하는 것은 해당 계정의
+ACCOUNT_NAME 및
+ACCOUNT_TYPE이 모두 있을 때뿐이기 때문입니다. ACCOUNT_TYPE은 계정이
{@link android.accounts.AccountManager}로 등록되었을 때 사용된 계정 인증자에 상응하는 문자열입니다. 기기와 연관되지 않은 캘린더에 적용되는 특별한 유형의 계정도 있으며 이를 {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}이라고 합니다.
{@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} 계정은 동기화되지 않습니다.
-
+
다음 예시에서는 여러분이 직접 나름의 쿼리를 생성해보십시오. 선택 영역이 쿼리의 기준을 나타냅니다.
- 이 예시에서 쿼리는
+ 이 예시에서 쿼리는
ACCOUNT_NAME
"sampleuser@google.com", ACCOUNT_TYPE
"com.google" 및 OWNER_ACCOUNT
-"sampleuser@google.com"을 가지고 있는 캘린더를 찾고 있습니다. 사용자가 소유한 캘린더뿐만 아니라 사용자가 전에 본 캘린더까지 모두 확인하려면
-OWNER_ACCOUNT를 생략합니다.
+"sampleuser@google.com"을 가지고 있는 캘린더를 찾고 있습니다. 사용자가 소유한 캘린더뿐만 아니라 사용자가 전에 본 캘린더까지 모두 확인하려면
+OWNER_ACCOUNT를 생략합니다.
쿼리가 {@link android.database.Cursor}
개체를 반환하여 이를 시용하면 데이터베이스 쿼리가 반환한 결과 집합을 트래버스할 수 있습니다.
- 콘텐츠 제공자에서 쿼리를 사용하는 법에 대한 자세한 논의는
+ 콘텐츠 제공자에서 쿼리를 사용하는 법에 대한 자세한 논의는
콘텐츠 제공자를 참조하십시오.
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
-
다음에 표시된 섹션에서는 커서를 사용하여 결과 집합을 단계별로 살펴봅니다.
+
다음에 표시된 섹션에서는 커서를 사용하여 결과 집합을 단계별로 살펴봅니다.
여기에서는 예시의 시작 부분에서 설정된 상수를 사용하여 각 필드에 대한 값을 반환합니다.
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
-
+
캘린더 수정
캘린더 업데이트를 수행하려면 캘린더의 {@link
-android.provider.BaseColumns#_ID}를
+android.provider.BaseColumns#_ID}를
URI에 추가된 ID로
({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}), 또는 첫 번째 선택 항목으로 제공하면 됩니다.
-
-선택은 "_id=?"로 시작해야 하며, 첫 번째
+
+선택은 "_id=?"로 시작해야 하며, 첫 번째
selectionArg는 캘린더의 {@link
-android.provider.BaseColumns#_ID}여야 합니다.
-또한 ID를 URI에 인코딩해서도 업데이트를 수행할 수 있습니다. 이 예시에서는 캘린더의 표시 이름을
+android.provider.BaseColumns#_ID}여야 합니다.
+또한 ID를 URI에 인코딩해서도 업데이트를 수행할 수 있습니다. 이 예시에서는 캘린더의 표시 이름을
({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
방식으로 변경하였습니다.
캘린더는 주로 동기화 어댑터가 관리하도록 설계되어 있습니다. 따라서 새 캘린더는
-동기화 어댑터로서만 삽입해야 합니다. 대다수의 경우 애플리케이션은 캘린더에
-표면적인 사항만 변경할 수 있게 되어 있습니다(예: 표시 이름 변경 등).
-어떤 애플리케이션이 로컬 캘린더를 생성해야 하는 경우, 캘린더 삽입을 동기화 어댑터로 수행하면 됩니다.
+
캘린더는 주로 동기화 어댑터가 관리하도록 설계되어 있습니다. 따라서 새 캘린더는
+동기화 어댑터로서만 삽입해야 합니다. 대다수의 경우 애플리케이션은 캘린더에
+표면적인 사항만 변경할 수 있게 되어 있습니다(예: 표시 이름 변경 등).
+어떤 애플리케이션이 로컬 캘린더를 생성해야 하는 경우, 캘린더 삽입을 동기화 어댑터로 수행하면 됩니다.
이때 {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}의 {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE}을 사용합니다.
{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
은 기기 계정과 연관되지 않은 캘린더에 적용되는 특별한 유형의 계정입니다.
- 이 유형의 캘린더는 서버에 동기화되지 않습니다.
+ 이 유형의 캘린더는 서버에 동기화되지 않습니다.
동기화 어댑터에 대한 논의는 동기화 어댑터를 참조하십시오.
이벤트 테이블
-
{@link android.provider.CalendarContract.Events}
-테이블에는 각각의 이벤트에 대한 세부 정보가 들어 있습니다. 이벤트를 추가, 업데이트 또는 삭제하려면 애플리케이션의
+
{@link android.provider.CalendarContract.Events}
+테이블에는 각각의 이벤트에 대한 세부 정보가 들어 있습니다. 이벤트를 추가, 업데이트 또는 삭제하려면 애플리케이션의
매니페스트 파일에 {@link android.Manifest.permission#WRITE_CALENDAR}
권한이 포함되어 있어야 합니다.
-
다음 이벤트 열은 애플리케이션과
+
다음 이벤트 열은 애플리케이션과
동기화 어댑터 모두 쓸 수 있는 것입니다. 지원되는 필드의 전체 목록은 {@link
android.provider.CalendarContract.Events} 참조를 확인하십시오.
이벤트의 반복 날짜입니다.
일반적으로 {@link android.provider.CalendarContract.EventsColumns#RDATE}
를 {@link android.provider.CalendarContract.EventsColumns#RRULE}
과 함께 사용하여 반복되는 발생의 집계 집합을 정의하게 됩니다.
자세한 논의는 RFC5545 사양을 참조하십시오.
애플리케이션이 새 이벤트를 추가하는 경우,
{@link android.content.Intent#ACTION_INSERT INSERT} 인텐트를 사용하는 것이 좋습니다. 이때 인텐트를 사용하여 이벤트 삽입에서 설명한 대로 따릅니다. 그러나, 필요한 경우 직접 이벤트를 삽입해도 됩니다.
이 섹션에서는 이렇게 하는 방법을 설명합니다.
{@link
-android.provider.CalendarContract.EventsColumns#EVENT_TIMEZONE}을 포함해야 합니다.
+android.provider.CalendarContract.EventsColumns#EVENT_TIMEZONE}을 포함해야 합니다.
시스템에 설치된 표준 시간대 ID 목록을 가져오려면 {@link
java.util.TimeZone#getAvailableIDs()}를 사용하십시오. 이 규칙은 인텐트를 사용하여 이벤트 삽입에서 설명한 바와 같이
{@link
android.content.Intent#ACTION_INSERT INSERT} 인텐트를 통해서 이벤트를 삽입할 경우에는 적용되지 않습니다. 이 시나리오의 경우,
기본 시간대가 제공됩니다.
-
+
비반복적인 이벤트의 경우, {@link
android.provider.CalendarContract.EventsColumns#DTEND}를 포함해야 합니다.
-
-
+
+
반복적인 이벤트의 경우 {@link
android.provider.CalendarContract.EventsColumns#DURATION}과 {@link
android.provider.CalendarContract.EventsColumns#RRULE} 또는 {@link
android.provider.CalendarContract.EventsColumns#RDATE}를 포함해야 합니다. 이 규칙은 인텐트를 사용하여 이벤트 삽입에서 설명한 바와 같이
{@link
-android.content.Intent#ACTION_INSERT INSERT} 인텐트를 통해서 이벤트를 삽입할 경우에는 적용되지 않습니다.
+android.content.Intent#ACTION_INSERT INSERT} 인텐트를 통해서 이벤트를 삽입할 경우에는 적용되지 않습니다.
이 시나리오에서는 {@link android.provider.CalendarContract.EventsColumns#DTSTART} 및 {@link android.provider.CalendarContract.EventsColumns#DTEND}와 함께 {@link
android.provider.CalendarContract.EventsColumns#RRULE}를 사용할 수 있고, 캘린더 애플리케이션이 이것을 기간으로 자동 변환해줍니다.
-
+
다음은 이벤트 삽입의 예입니다. 단순하게 나타내기 위해 UI 스레드에서 수행한 것입니다.
실제로, 삽입과 업데이트는 비동기화 스레드에서 수행해야 작업을 배경 스레드로 이동시킬 수 있습니다.
-
+
자세한 정보는 {@link android.content.AsyncQueryHandler}를 참조하십시오.
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -561,13 +561,13 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
참고: 이벤트가 생성된 다음 이 예시가 이벤트 ID를 캡처하는 법을 눈여겨 보십시오.
- 이것이 이벤트 ID를 가져오는 가장 쉬운 방법입니다.
+ 이것이 이벤트 ID를 가져오는 가장 쉬운 방법입니다.
다른 캘린더 작업을 수행하기 위해 이벤트 ID가 필요한 경우가 자주 있습니다. 예를 들어 이벤트에 참석자나 알림을 추가하는 데 필요합니다.
@@ -577,15 +577,15 @@ long eventID = Long.parseLong(uri.getLastPathSegment());
애플리케이션이 사용자에게 이벤트 편집을 허용할 경우, 인텐트로 이벤트 편집에서 설명한 바와 같이
{@link android.content.Intent#ACTION_EDIT EDIT} 인텐트
를 사용하는 것이 좋습니다.
-그러나 필요한 경우 직접 이벤트를 편집해도 됩니다.
+그러나 필요한 경우 직접 이벤트를 편집해도 됩니다.
이벤트 업데이트를 수행하려면 이벤트의 _ID를 URI에 추가된 ID로({@link
-android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
또는 첫 번째 선택 항목으로 제공하면 됩니다.
-
-선택은 "_id=?"로 시작해야 하며, 첫 번째
-selectionArg는 이벤트의 _ID여야 합니다.
+
+선택은 "_id=?"로 시작해야 하며, 첫 번째
+selectionArg는 이벤트의 _ID여야 합니다.
ID 없이 선택을 사용해도 업데이트를 수행할 수 있습니다. 다음은 이벤트 업데이트의 예입니다.
- 여기에서는 이벤트 제목을 변경할 때
+ 여기에서는 이벤트 제목을 변경할 때
{@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}
방법을 사용합니다.
@@ -598,7 +598,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -608,11 +608,11 @@ Log.i(DEBUG_TAG, "Rows updated: " + rows);
이벤트를 삭제하려면 이벤트의 {@link
android.provider.BaseColumns#_ID}를 URI에 추가된 ID로 써도 되고, 표준 선택을 사용해도 됩니다.
추가된 ID를 사용하는 경우, 선택도 할 수 없습니다.
-삭제에는 두 가지 버전이 있습니다. 애플리케이션으로 삭제와 동기화 어댑터로의 삭제입니다.
-애플리케이션 삭제의 경우 삭제된 열을 1로 설정합니다.
-이것은 동기화 어댑터에 행이 삭제되었다고 알리는 플래그이며,
-이 삭제를 서버에 알려야 한다는 것을 나타내기도 합니다.
-동기화 어댑터 삭제의 경우, 이벤트를 연관된 데이터 일체와 함께 데이터베이스에서 제거합니다.
+삭제에는 두 가지 버전이 있습니다. 애플리케이션으로 삭제와 동기화 어댑터로의 삭제입니다.
+애플리케이션 삭제의 경우 삭제된 열을 1로 설정합니다.
+이것은 동기화 어댑터에 행이 삭제되었다고 알리는 플래그이며,
+이 삭제를 서버에 알려야 한다는 것을 나타내기도 합니다.
+동기화 어댑터 삭제의 경우, 이벤트를 연관된 데이터 일체와 함께 데이터베이스에서 제거합니다.
다음은 애플리케이션이 이벤트를 {@link android.provider.BaseColumns#_ID}를 통해 삭제하는 예입니다.
{@link android.provider.CalendarContract.Attendees} 테이블의 각 행은
-이벤트의 참석자 또는 게스트 하나를 나타냅니다.
+이벤트의 참석자 또는 게스트 하나를 나타냅니다.
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
-를호출하면 주어진
-{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}와 함께 해당 이벤트의 참석자 목록을 반환합니다.
+를호출하면 주어진
+{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}와 함께 해당 이벤트의 참석자 목록을 반환합니다.
이 {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}는
특정 이벤트의 {@link
-android.provider.BaseColumns#_ID}와 반드시 일치해야 합니다.
+android.provider.BaseColumns#_ID}와 반드시 일치해야 합니다.
다음 표는 쓸 수 있는 필드를 목록으로 나열한 것입니다.
- 새 참석자를 삽입하는 경우 이 모두를 포함해야 하며,
+ 새 참석자를 삽입하는 경우 이 모두를 포함해야 하며,
단 ATTENDEE_NAME은 예외입니다.
@@ -697,7 +697,7 @@ android.provider.BaseColumns#_ID}와 반드시 일치해야 합니다.
참석자 추가
-
다음은 이벤트에 참석자 한 명을 추가하는 예입니다.
+
다음은 이벤트에 참석자 한 명을 추가하는 예입니다.
{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
가 필수인 점을 유념하십시오.
@@ -717,8 +717,8 @@ Uri uri = cr.insert(Attendees.CONTENT_URI, values);
알림 테이블
-
{@link android.provider.CalendarContract.Reminders}
-테이블의 각 행은 이벤트의 알림 하나를 나타냅니다.
+
{@link android.provider.CalendarContract.Reminders}
+테이블의 각 행은 이벤트의 알림 하나를 나타냅니다.
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()} 를 호출하면
주어진 {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}와 함께 이벤트 알림 목록을 반환합니다.
@@ -728,7 +728,7 @@ Uri uri = cr.insert(Attendees.CONTENT_URI, values);
동기화 어댑터가 {@link
android.provider.CalendarContract.Calendars} 테이블에서 지원하는 알림을 나타낸다는 점을 눈여겨 보십시오.
자세한 내용은
-{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
+{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
를 참조하십시오.
@@ -774,15 +774,15 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
인스턴스 테이블
-{@link android.provider.CalendarContract.Instances} 테이블에는
+{@link android.provider.CalendarContract.Instances} 테이블에는
이벤트 발생의 시작 및 종료 시간이 담겨 있습니다. 이 테이블의 각 행이 하나의 이벤트 발생을 나타냅니다.
이 인스턴스 테이블은 쓸 수 없으며 이벤트 발생 쿼리 방법을 제공할 뿐입니다.
-
다음 표에는 인스턴스에 대해 쿼리할 수 있는 몇 가지 필드를 목록으로 나열하였습니다.
-표준 시간대가
+
다음 표에는 인스턴스에 대해 쿼리할 수 있는 몇 가지 필드를 목록으로 나열하였습니다.
+표준 시간대가
{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
- 및
+ 및
{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_INSTANCES}에 의해 정의된다는 점을 눈여겨 보십시오.
@@ -801,18 +801,18 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
인스턴스의 시작 시간(분 단위)을 캘린더 시간대에 비례하여 자정부터 측정한 것입니다.
-
+
-
+
@@ -839,10 +839,10 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
인스턴스 테이블을 쿼리하려면, 해당 쿼리에 대한 범위 시간을 URI에 지정해야 합니다.
이 예시에서는 {@link android.provider.CalendarContract.Instances}
가 {@link
-android.provider.CalendarContract.EventsColumns#TITLE} 필드에 액세스 권한을 얻으며, 이때
-{@link android.provider.CalendarContract.EventsColumns} 인터페이스의 구현을 통합니다.
+android.provider.CalendarContract.EventsColumns#TITLE} 필드에 액세스 권한을 얻으며, 이때
+{@link android.provider.CalendarContract.EventsColumns} 인터페이스의 구현을 통합니다.
바꿔 말하면, {@link
-android.provider.CalendarContract.EventsColumns#TITLE}이
+android.provider.CalendarContract.EventsColumns#TITLE}이
데이터베이스 보기를 통해 반환되며 원시 {@link
android.provider.CalendarContract.Instances} 테이블 쿼리를 통해서가 아니라는 뜻입니다.
@@ -853,7 +853,7 @@ public static final String[] INSTANCE_PROJECTION = new String[] {
Instances.BEGIN, // 1
Instances.TITLE // 2
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_BEGIN_INDEX = 1;
@@ -868,7 +868,7 @@ long startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2011, 10, 24, 8, 0);
long endMillis = endTime.getTimeInMillis();
-
+
Cursor cur = null;
ContentResolver cr = getContentResolver();
@@ -883,28 +883,28 @@ ContentUris.appendId(builder, startMillis);
ContentUris.appendId(builder, endMillis);
// Submit the query
-cur = cr.query(builder.build(),
- INSTANCE_PROJECTION,
- selection,
- selectionArgs,
+cur = cr.query(builder.build(),
+ INSTANCE_PROJECTION,
+ selection,
+ selectionArgs,
null);
-
+
while (cur.moveToNext()) {
String title = null;
long eventID = 0;
- long beginVal = 0;
-
+ long beginVal = 0;
+
// Get the field values
eventID = cur.getLong(PROJECTION_ID_INDEX);
beginVal = cur.getLong(PROJECTION_BEGIN_INDEX);
title = cur.getString(PROJECTION_TITLE_INDEX);
-
- // Do something with the values.
- Log.i(DEBUG_TAG, "Event: " + title);
+
+ // Do something with the values.
+ Log.i(DEBUG_TAG, "Event: " + title);
Calendar calendar = Calendar.getInstance();
- calendar.setTimeInMillis(beginVal);
+ calendar.setTimeInMillis(beginVal);
DateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
- Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
+ Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
}
}
@@ -922,9 +922,9 @@ while (cur.moveToNext()) {
-
-{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}로도 URI를 참조할 수 있습니다.
-이 인텐트 사용법의 예시를 보려면 인텐트를 사용하여 캘린더 데이터 보기를 참조하십시오.
+
+{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}로도 URI를 참조할 수 있습니다.
+이 인텐트 사용법의 예시를 보려면 인텐트를 사용하여 캘린더 데이터 보기를 참조하십시오.
캘린더를 <ms_since_epoch>에 의해 지정된 시간으로 엽니다.
@@ -935,11 +935,11 @@ while (cur.moveToNext()) {
content://com.android.calendar/events/<event_id>
-
-
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}로도 URI를 참조할 수 있습니다.
+
+
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}로도 URI를 참조할 수 있습니다.
이 인텐트 사용법의 예시를 보려면 인텐트를 사용하여 캘린더 데이터 보기를 참조하십시오.
-
+
<event_id>에 의해 지정된 이벤트를 봅니다.
@@ -952,12 +952,12 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_EDIT EDIT}
content://com.android.calendar/events/<event_id>
-
-
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}로도 URI를 참조할 수 있습니다.
+
+
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}로도 URI를 참조할 수 있습니다.
이 인텐트 사용법의 예시를 보려면 인텐트를 사용하여 이벤트 편집을 참조하십시오.
-
-
+
+
<event_id>에 의해 지정된 이벤트를 편집합니다.
@@ -972,11 +972,11 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_INSERT INSERT}
content://com.android.calendar/events
-
-
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}로도 URI를 참조할 수 있습니다.
+
+
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}로도 URI를 참조할 수 있습니다.
이 인텐트 사용법의 예시를 보려면 인텐트를 사용하여 이벤트 삽입을 참조하십시오.
-
+
이 이벤트가 사용 중인 시간으로 간주되는지, 다시 일정을 예약할 수 있는 자유 시간으로 간주되는지를 나타냅니다.
-
-
+
+
아래 섹션에서는 이와 같은 인텐트의 사용법을 설명합니다.
인텐트를 사용하여 이벤트 삽입
-
{@link android.content.Intent#ACTION_INSERT INSERT} 인텐트를 사용하면
+
{@link android.content.Intent#ACTION_INSERT INSERT} 인텐트를 사용하면
캘린더에 이벤트 삽입 작업을 분배할 수 있습니다.
이 방법을 사용하는 경우, 애플리케이션의 매니페스트 파일에 {@link
android.Manifest.permission#WRITE_CALENDAR} 권한을 포함할 필요가 없습니다.
-
+
사용자가 이 방법을 사용하는 애플리케이션을 실행하면 해당 애플리케이션이
사용자를 캘린더로 보내 이벤트 추가를 완료합니다. {@link
android.content.Intent#ACTION_INSERT INSERT} 인텐트는 추가 필드를 사용하여
-캘린더에 있는 이벤트 세부 정보로 양식을 미리 채웁니다.
-그러면 사용자가 이벤트를 취소하거나 양식을 필요에 따라 편집할 수 있고,
+캘린더에 있는 이벤트 세부 정보로 양식을 미리 채웁니다.
+그러면 사용자가 이벤트를 취소하거나 양식을 필요에 따라 편집할 수 있고,
이벤트를 본인의 캘린더에 저장할 수도 있습니다.
-
-
다음은 2012년 1월 19일에 이벤트 일정을 예약하는 코드 조각으로,
+
+
다음은 2012년 1월 19일에 이벤트 일정을 예약하는 코드 조각으로,
이는 오전 7:30~오전 8:30까지 실행됩니다. 이 코드 조각에 관해서는 다음 내용을 주의하십시오.
이것은 {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}를 URI로 지정합니다.
-
+
이것은 {@link
android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME
CalendarContract.EXTRA_EVENT_BEGIN_TIME} 및 {@link
@@ -1083,10 +1083,10 @@ android.provider.CalendarContract#EXTRA_EVENT_END_TIME
CalendarContract.EXTRA_EVENT_END_TIME} 추가 필드를 사용하여 이벤트 시간으로 양식을 미리 채웁니다.
이러한 시간에 해당하는 값은 Epoch로부터 UTC 밀리초 단위로 표시해야 합니다.
-
+
이것은 {@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}
추가 필드를 사용하여 쉼표로 구분된 초청인 목록을 제공하며, 이는 이메일 주소로 나타납니다.
이벤트 업데이트에서 설명한 바와 같이 이벤트를 직접 업데이트할 수 있습니다. 그러나 {@link
-android.content.Intent#ACTION_EDIT EDIT} 인텐트를 사용하면
+android.content.Intent#ACTION_EDIT EDIT} 인텐트를 사용하면
캘린더 애플리케이션에 이벤트 편집을 분배할 권한이 없는 애플리케이션을 허용합니다.
사용자가 캘린더에서 이벤트 편집을 마치면 원래 애플리케이션으로 돌아오게 됩니다.
다음은 지정된 이벤트에 새 제목을 설정하여 사용자에게 캘린더에서 이벤트를 편집할 수 있도록 해주는 인텐트의 예입니다.
@@ -1158,18 +1158,18 @@ startActivity(intent);
동기화 어댑터는 {@link android.provider.CalendarContract#CALLER_IS_SYNCADAPTER}를 true로 설정하여 이것이 동기화 어댑터라는 것을 나타내야 합니다.
동기화 어댑터에는 애플리케이션 또는 위젯에 비해 더 많은 열에 대한 쓰기 액세스 권한이 있습니다.
- 예를 들어, 애플리케이션은 캘린더의 몇 가지 특성만 수정할 수 있습니다.
+ 예를 들어, 애플리케이션은 캘린더의 몇 가지 특성만 수정할 수 있습니다.
즉 이름, 표시 이름, 가시성 설정 및 캘린더 동기화 여부 등만 해당됩니다.
이에 비해 동기화 어댑터의 경우 이 열만이 아니라 다른 수많은 열에도 액세스할 수 있습니다.
예를 들어 캘린더 색상, 표준 시간대, 액세스 수준 등이 해당됩니다.
-다만, 동기화 어댑터는 지정된 ACCOUNT_NAME 및
+다만, 동기화 어댑터는 지정된 ACCOUNT_NAME 및
ACCOUNT_TYPE에 한정됩니다.
다음은 URI를 반환하여 동기화 어댑터와 사용하도록 할 때 쓸 수 있는 도우미 메서드입니다.
동기화 어댑터의 샘플 구현(캘린더에 구체적으로 관련된 것이 아님)은
SampleSyncAdpater를 참조하십시오.
diff --git a/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd
index 94d3295c1d465..ad60b6dfbd856 100644
--- a/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd
+++ b/docs/html-intl/intl/ko/guide/topics/providers/contacts-provider.jd
@@ -83,12 +83,12 @@ page.title=연락처 제공자
콘텐츠 제공자는 기기의 사람에 대한 중앙 데이터 리포지토리를 관리하는 강력하고 유연한
-Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애플리케이션에서 개발자에게 표시되는
-데이터의 출처입니다. 여기의 데이터에는 개발자 자신의 애플리케이션에서
-액세스하여 기기와 온라인 서비스 사이에서 데이터를 전송할 수도 있습니다. 제공자는
-광범위한 데이터 소스를 수용하며 각 인물에 대해 가능한 한 많은 데이터를 관리하여야 하므로, 그 결과 조직이 무척
-복잡합니다. 이 때문에 이 제공자의 API에는
-광범위한 계약 클래스와 인터페이스 세트가 포함되어 있어 데이터 검색과 수정을 모두 한층
+Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애플리케이션에서 개발자에게 표시되는
+데이터의 출처입니다. 여기의 데이터에는 개발자 자신의 애플리케이션에서
+액세스하여 기기와 온라인 서비스 사이에서 데이터를 전송할 수도 있습니다. 제공자는
+광범위한 데이터 소스를 수용하며 각 인물에 대해 가능한 한 많은 데이터를 관리하여야 하므로, 그 결과 조직이 무척
+복잡합니다. 이 때문에 이 제공자의 API에는
+광범위한 계약 클래스와 인터페이스 세트가 포함되어 있어 데이터 검색과 수정을 모두 한층
용이하게 해줍니다.
@@ -105,23 +105,23 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
제공자에서 데이터를 수정하는 방법.
- 동기화 어댑터를 작성하여 서버에서 가져온 데이터를 연락처 제공자와
+ 동기화 어댑터를 작성하여 서버에서 가져온 데이터를 연락처 제공자와
동기화하는 방법.
- 이 가이드는 독자가 Android 콘텐츠 제공자의 기본 정보를 알고 있는 것으로 간주합니다. Android 콘텐츠 제공자에
-관한 자세한 내용은
+ 이 가이드는 독자가 Android 콘텐츠 제공자의 기본 정보를 알고 있는 것으로 간주합니다. Android 콘텐츠 제공자에
+관한 자세한 내용은
-콘텐츠 제공자 기본 정보 가이드를 읽어보십시오.
+콘텐츠 제공자 기본 정보 가이드를 읽어보십시오.
샘플 동기화 어댑터
샘플 앱은 동기화 어댑터를 사용하여 연락처 제공자와 Google Web Services가 호스팅하는 샘플 애플리케이션 사이에서
데이터를 전송하는 동기화 어댑터의 사용 예시입니다.
연락처 제공자 조직
- 연락처 제공자는 Android 콘텐츠 제공자 구성 요소입니다. 이것은 한 사람에 대해
-각기 세 가지 유형의 데이터를 관리합니다. 각 데이터는 그림 1에서 설명하는 바와 같이 제공자가 제공하는
+ 연락처 제공자는 Android 콘텐츠 제공자 구성 요소입니다. 이것은 한 사람에 대해
+각기 세 가지 유형의 데이터를 관리합니다. 각 데이터는 그림 1에서 설명하는 바와 같이 제공자가 제공하는
각 테이블에 상응합니다.
@@ -129,7 +129,7 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
그림 1. 연락처 제공자 테이블 구조입니다.
- 이 세 개의 테이블은 보통 자신의 계약 클래스의 이름으로 불립니다. 이들 클래스는
+ 이 세 개의 테이블은 보통 자신의 계약 클래스의 이름으로 불립니다. 이들 클래스는
테이블에서 사용하는 콘텐츠 URI, 열 이름 및 열 값의 상수를 정의합니다.
@@ -153,29 +153,29 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
- {@link android.provider.ContactsContract}의 계약 클래스가 대표하는 다른 테이블은
-보조 테이블로, 연락처 제공자는 이들을 사용하여 작업을 관리하거나 기기의 연락처에 있는
+ {@link android.provider.ContactsContract}의 계약 클래스가 대표하는 다른 테이블은
+보조 테이블로, 연락처 제공자는 이들을 사용하여 작업을 관리하거나 기기의 연락처에 있는
특정 기능 또는 전화 통신 애플리케이션 등을 지원합니다.
원시 연락처
- 원시 연락처는 단일 계정 유형과 계정 이름에서 가져오는
-한 사람의 데이터를 나타냅니다. 연락처 제공자는 한 사람에 대해 하나 이상의 온라인 서비스를 데이터의 출처로 허용하므로,
+ 원시 연락처는 단일 계정 유형과 계정 이름에서 가져오는
+한 사람의 데이터를 나타냅니다. 연락처 제공자는 한 사람에 대해 하나 이상의 온라인 서비스를 데이터의 출처로 허용하므로,
연락처 제공자에서는 같은 사람에 대해 여러 개의 원시 연락처를 허용합니다.
- 원시 연락처를 여러 개 사용하면 사용자가 같은 계정 유형의 하나 이상의 계정에서 가져온
+ 원시 연락처를 여러 개 사용하면 사용자가 같은 계정 유형의 하나 이상의 계정에서 가져온
한 사람의 여러 데이터를 조합할 수 있습니다.
- 원시 연락처의 데이터 대부분은
-{@link android.provider.ContactsContract.RawContacts} 테이블에 저장되지 않습니다. 대신,
+ 원시 연락처의 데이터 대부분은
+{@link android.provider.ContactsContract.RawContacts} 테이블에 저장되지 않습니다. 대신,
{@link android.provider.ContactsContract.Data} 테이블에서 하나 이상의 행에 저장됩니다. 각 데이터 행에는
-상위 {@link android.provider.ContactsContract.RawContacts} 행의 {@code android.provider.BaseColumns#_ID RawContacts._ID} 값을 포함하는
-열 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}가
+상위 {@link android.provider.ContactsContract.RawContacts} 행의 {@code android.provider.BaseColumns#_ID RawContacts._ID} 값을 포함하는
+열 {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID Data.RAW_CONTACT_ID}가
있습니다.
중요한 원시 연락처 열
- {@link android.provider.ContactsContract.RawContacts} 테이블의 중요한 열은
+ {@link android.provider.ContactsContract.RawContacts} 테이블의 중요한 열은
표 1에 나열되어 있습니다. 표 뒤에 이어지는 참고 사항을 꼭 읽어주십시오.
@@ -193,13 +193,13 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
이 원시 연락처의 소스인 계정 유형에 대한 계정 이름입니다.
- 예를 들어, Google 계정의 계정 이름은
-기기 소유자의 Gmail 주소 중 하나입니다. 자세한 정보는
-{@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE}의
+ 예를 들어, Google 계정의 계정 이름은
+기기 소유자의 Gmail 주소 중 하나입니다. 자세한 정보는
+{@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE}의
다음 항목을 참조하십시오.
- 이 이름의 형식은 각자의 계정 유형별로 다릅니다. 이것은 꼭
+ 이 이름의 형식은 각자의 계정 유형별로 다릅니다. 이것은 꼭
이메일 주소여야 하는 것은 아닙니다.
@@ -208,13 +208,13 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
{@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE}
- 이 원시 연락처의 소스인 계정 유형입니다. 예를 들어, Google 계정의
-계정 유형은 com.google입니다. 계정 유형을 정규화할 때에는 항상
-본인이 소유하거나 제어하는 도메인의 도메인 식별자를 사용하십시오. 이렇게 하면 계정 유형이 고유한 것이도록
+ 이 원시 연락처의 소스인 계정 유형입니다. 예를 들어, Google 계정의
+계정 유형은 com.google입니다. 계정 유형을 정규화할 때에는 항상
+본인이 소유하거나 제어하는 도메인의 도메인 식별자를 사용하십시오. 이렇게 하면 계정 유형이 고유한 것이도록
확실히 해둘 수 있습니다.
- 연락처 데이터를 제공하는 계정 유형은 대개 연락처 제공자와 동기화되는 동기화 어댑터와
+ 연락처 데이터를 제공하는 계정 유형은 대개 연락처 제공자와 동기화되는 동기화 어댑터와
연관되어 있습니다.
@@ -225,44 +225,44 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
원시 연락처에 대한 "삭제됨" 플래그입니다.
- 이 플래그를 사용하면 연락처 제공자가 해당 행을 내부에 계속 유지할 수 있습니다.
-이는 동기화 어댑터가 해당 행을 자신의 서버에서 삭제하고 마침내는 행을 리포지토리에서도 삭제할 수 있을
+ 이 플래그를 사용하면 연락처 제공자가 해당 행을 내부에 계속 유지할 수 있습니다.
+이는 동기화 어댑터가 해당 행을 자신의 서버에서 삭제하고 마침내는 행을 리포지토리에서도 삭제할 수 있을
때까지만입니다.
참고
- 다음은
+ 다음은
{@link android.provider.ContactsContract.RawContacts} 테이블에 관한 중요한 참고 사항입니다.
- 원시 연락처의 이름은
-{@link android.provider.ContactsContract.RawContacts}에 있는 자신의 행에 저장되지 않습니다. 대신,
-{@link android.provider.ContactsContract.CommonDataKinds.StructuredName} 행에 있는
-{@link android.provider.ContactsContract.Data} 테이블에 저장됩니다. 원시 연락처 하나에는
+ 원시 연락처의 이름은
+{@link android.provider.ContactsContract.RawContacts}에 있는 자신의 행에 저장되지 않습니다. 대신,
+{@link android.provider.ContactsContract.CommonDataKinds.StructuredName} 행에 있는
+{@link android.provider.ContactsContract.Data} 테이블에 저장됩니다. 원시 연락처 하나에는
{@link android.provider.ContactsContract.Data} 테이블에서 이런 유형의 행이 하나씩만 있습니다.
- 주의: 원시 연락처에서 본인의 계정 데이터를 사용하려면 이를 우선
-{@link android.accounts.AccountManager}로 등록해야 합니다. 이렇게 하려면,
-사용자에게 계정 유형과 본인의 계정 이름을 계정 목록에 추가하라는 프롬프트를 표시하십시오. 이렇게 하지 않으면,
+ 주의: 원시 연락처에서 본인의 계정 데이터를 사용하려면 이를 우선
+{@link android.accounts.AccountManager}로 등록해야 합니다. 이렇게 하려면,
+사용자에게 계정 유형과 본인의 계정 이름을 계정 목록에 추가하라는 프롬프트를 표시하십시오. 이렇게 하지 않으면,
연락처 제공자가 원시 연락처 행을 자동으로 삭제합니다.
- 예를 들어, 앱에서 도메인 {@code com.example.dataservice}로 웹 베이스 서비스에 대한 연락처 데이터를 유지하고
-서비스에 대한 사용자 계정이
-{@code becky.sharp@dataservice.example.com}이라면, 사용자는 앱이 원시 연락처 행을 추가하기 전에
+ 예를 들어, 앱에서 도메인 {@code com.example.dataservice}로 웹 베이스 서비스에 대한 연락처 데이터를 유지하고
+서비스에 대한 사용자 계정이
+{@code becky.sharp@dataservice.example.com}이라면, 사용자는 앱이 원시 연락처 행을 추가하기 전에
계정 "유형"({@code com.example.dataservice})과 계정 "이름"
({@code becky.smart@dataservice.example.com})을 먼저 추가해야 합니다.
- 이 요구 사항을 사용자에게 설명하려면 관련 문서를 사용해도 되고, 아니면 사용자에게
-유형과 이름을 추가하라는 프롬프트를 표시해도 되고 두 가지 방법을 다 써도 됩니다. 계정 유형과 계정 이름은
+ 이 요구 사항을 사용자에게 설명하려면 관련 문서를 사용해도 되고, 아니면 사용자에게
+유형과 이름을 추가하라는 프롬프트를 표시해도 되고 두 가지 방법을 다 써도 됩니다. 계정 유형과 계정 이름은
다음 섹션에서 더 자세히 설명되어 있습니다.
원시 연락처 데이터 소스
- 원시 연락처의 작동 원리를 이해하기 위해, 다음과 같이 기기에서 정의한 사용자 계정 세 가지를 보유한 사용자 "Emily Dickinson"이 있다고
+ 원시 연락처의 작동 원리를 이해하기 위해, 다음과 같이 기기에서 정의한 사용자 계정 세 가지를 보유한 사용자 "Emily Dickinson"이 있다고
가정해 봅시다.
@@ -275,11 +275,11 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
활성화했습니다.
- Emily Dickinson이 브라우저 창을 열고,
+ Emily Dickinson이 브라우저 창을 열고,
Gmail에 emily.dickinson@gmail.com으로 로그인하고,
-연락처를 열어서 "Thomas Higginson"을 추가한다고 가정하겠습니다. 이 사용자는 나중에 Gmail에
-emilyd@gmail.com으로 로그인하고 "Thomas Higginson"에게 이메일을 전송합니다.
-이렇게 하면 이 사람을 자동으로 연락처로 추가합니다. Emily는 Twitter에서 "colonel_tom"(Thomas Higginson의 Twitter ID)도
+연락처를 열어서 "Thomas Higginson"을 추가한다고 가정하겠습니다. 이 사용자는 나중에 Gmail에
+emilyd@gmail.com으로 로그인하고 "Thomas Higginson"에게 이메일을 전송합니다.
+이렇게 하면 이 사람을 자동으로 연락처로 추가합니다. Emily는 Twitter에서 "colonel_tom"(Thomas Higginson의 Twitter ID)도
팔로우합니다.
emilyd@gmail.com과 연관된 "Thomas Higginson"의 두 번째 원시 연락처입니다.
- 사용자 계정 유형은 마찬가지로 Google입니다. 이름이 이전 이름과 똑같더라도 두 번째 원시 연락처가
-더해집니다. 왜냐하면 이 사람은 아까와 다른
+ 사용자 계정 유형은 마찬가지로 Google입니다. 이름이 이전 이름과 똑같더라도 두 번째 원시 연락처가
+더해집니다. 왜냐하면 이 사람은 아까와 다른
사용자 계정에 추가되었기 때문입니다.
- "belle_of_amherst"와 연관된 "Thomas Higginson"의 세 번째 원시 연락처입니다. 사용자
+ "belle_of_amherst"와 연관된 "Thomas Higginson"의 세 번째 원시 연락처입니다. 사용자
계정 유형은 Twitter입니다.
데이터
이전에 언급한 바와 같이, 원시 연락처의 데이터는
-원시 연락처의 _ID 값과 연결된{@link android.provider.ContactsContract.Data} 행에
-저장됩니다. 이렇게 하면 하나의 원시 연락처에 같은 유형의 데이터의 인스턴스가 여러 개 있을 수 있게 됩니다.
-예를 들어 이메일 주소 또는 전화 번호 등이 이에 해당됩니다. 예를 들어,
+원시 연락처의 _ID 값과 연결된{@link android.provider.ContactsContract.Data} 행에
+저장됩니다. 이렇게 하면 하나의 원시 연락처에 같은 유형의 데이터의 인스턴스가 여러 개 있을 수 있게 됩니다.
+예를 들어 이메일 주소 또는 전화 번호 등이 이에 해당됩니다. 예를 들어,
{@code emilyd@gmail.com}에 대한 "Thomas Higginson"(Google 계정 emilyd@gmail.com과 연관된 Thomas Higginson의
-원시 연락처)에는
+원시 연락처)에는
thigg@gmail.com이라는 집 이메일 주소와
thomas.higginson@gmail.com이라는 직장 이메일 주소가 있고, 연락처 제공자는 두 개의 이메일 주소 행을 저장하고
원시 연락처에 두 가지를 연결합니다.
- 이 테이블 하나에 여러 가지 유형의 데이터가 저장된 점에 주의하십시오. 표시 이름,
-전화 번호, 이메일, 우편 주소, 사진 및 웹사이트 세부 정보 행은 모두
-{@link android.provider.ContactsContract.Data} 테이블에서 찾을 수 있습니다. 이런 데이터 관리를 돕기 위해
-{@link android.provider.ContactsContract.Data} 테이블에는 설명이 포함된 이름이 있는 열이 몇 개 있고
-일반적 이름이 포함된 열도 몇 개 있습니다. 설명이 포함된 이름 열의 콘텐츠는 행 안의 데이터 유형과 관계 없이 모두 의미가 같고,
-일반적인 이름 열의 콘텐츠는 데이터 유형에 따라
+ 이 테이블 하나에 여러 가지 유형의 데이터가 저장된 점에 주의하십시오. 표시 이름,
+전화 번호, 이메일, 우편 주소, 사진 및 웹사이트 세부 정보 행은 모두
+{@link android.provider.ContactsContract.Data} 테이블에서 찾을 수 있습니다. 이런 데이터 관리를 돕기 위해
+{@link android.provider.ContactsContract.Data} 테이블에는 설명이 포함된 이름이 있는 열이 몇 개 있고
+일반적 이름이 포함된 열도 몇 개 있습니다. 설명이 포함된 이름 열의 콘텐츠는 행 안의 데이터 유형과 관계 없이 모두 의미가 같고,
+일반적인 이름 열의 콘텐츠는 데이터 유형에 따라
서로 의미가 다릅니다.
- 이 행에 저장되는 데이터 유형으로, 사용자 지정 MIME 유형으로 표현됩니다. 연락처 제공자는
-{@link android.provider.ContactsContract.CommonDataKinds}의 하위 클래스에서 정의된
-MIME 유형을 사용합니다. 이러한 MIME 유형은 오픈 소스이고,
+ 이 행에 저장되는 데이터 유형으로, 사용자 지정 MIME 유형으로 표현됩니다. 연락처 제공자는
+{@link android.provider.ContactsContract.CommonDataKinds}의 하위 클래스에서 정의된
+MIME 유형을 사용합니다. 이러한 MIME 유형은 오픈 소스이고,
연락처 제공자와 함께 사용할 수 있는 모든 애플리케이션 또는 동기화 어댑터가 사용할 수 있습니다.
@@ -347,25 +347,25 @@ MIME 유형을 사용합니다. 이러한 MIME 유형은 오픈 소스이고,
이 유형의 데이터 행이 원시 연락처에서 한 번 이상 발생하는 경우,
-{@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 열은
-해당 유형의 기본 데이터가 들어있는 데이터 행을 플래그로 표시합니다. 예를 들어,
-사용자가 연락처의 전화 번호를 길게 누르고 기본값으로 설정을 선택하면
+{@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 열은
+해당 유형의 기본 데이터가 들어있는 데이터 행을 플래그로 표시합니다. 예를 들어,
+사용자가 연락처의 전화 번호를 길게 누르고 기본값으로 설정을 선택하면
그 번호가 들어있는 {@link android.provider.ContactsContract.Data} 행이
-{@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 열을
+{@link android.provider.ContactsContract.DataColumns#IS_PRIMARY} 열을
0이 아닌 값으로 설정합니다.
일반 열 이름
- 15개의 일반 열 중에서 DATA1부터
-DATA15까지는 일반적으로 이용할 수 있고 이외에 추가로 마련된 네 개의 일반
-열, 즉 SYNC1부터 SYNC4까지는
-동기화 어댑터 전용입니다. 일반 열 이름 상수는 해당 행에 들어있는 데이터 유형과 관계 없이
+ 15개의 일반 열 중에서 DATA1부터
+DATA15까지는 일반적으로 이용할 수 있고 이외에 추가로 마련된 네 개의 일반
+열, 즉 SYNC1부터 SYNC4까지는
+동기화 어댑터 전용입니다. 일반 열 이름 상수는 해당 행에 들어있는 데이터 유형과 관계 없이
언제나 통합니다.
- DATA1 열은 색인됩니다. 연락처 제공자는 제공자가 가장 자주 쿼리의 대상이 될 것으로 예상하는
-데이터에 대해 항상 이 열을 사용합니다. 예컨대
+ DATA1 열은 색인됩니다. 연락처 제공자는 제공자가 가장 자주 쿼리의 대상이 될 것으로 예상하는
+데이터에 대해 항상 이 열을 사용합니다. 예컨대
이메일 행의 경우, 이 열에 실제 이메일 주소가 들어있습니다.
@@ -374,36 +374,36 @@ MIME 유형을 사용합니다. 이러한 MIME 유형은 오픈 소스이고,
유형별 열 이름
- 특정 유형의 행에 대한 열과의 작업을 돕기 위해, 연락처 제공자는
- 유형별 열 이름 상수도 제공합니다. 이는
-{@link android.provider.ContactsContract.CommonDataKinds}의 하위 클래스에서 정의합니다. 이 상수는 그저 같은 열 이름에
-서로 다른 상수 이름을 부여할 뿐이며, 이렇게 하면 개발자가 특정 유형의 행에 있는 데이터에
+ 특정 유형의 행에 대한 열과의 작업을 돕기 위해, 연락처 제공자는
+ 유형별 열 이름 상수도 제공합니다. 이는
+{@link android.provider.ContactsContract.CommonDataKinds}의 하위 클래스에서 정의합니다. 이 상수는 그저 같은 열 이름에
+서로 다른 상수 이름을 부여할 뿐이며, 이렇게 하면 개발자가 특정 유형의 행에 있는 데이터에
액세스하기 쉽습니다.
- 예를 들어, {@link android.provider.ContactsContract.CommonDataKinds.Email} 클래스는
+ 예를 들어, {@link android.provider.ContactsContract.CommonDataKinds.Email} 클래스는
MIME 유형{@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_ITEM_TYPE
Email.CONTENT_ITEM_TYPE}을 갖는
-{@link android.provider.ContactsContract.Data} 행에
+{@link android.provider.ContactsContract.Data} 행에
대한 유형별 열 이름 상수를 정의합니다. 이 클래스에는 이메일 주소 열에 대한
- 상수 {@link android.provider.ContactsContract.CommonDataKinds.Email#ADDRESS}가
-들어있습니다.
-{@link android.provider.ContactsContract.CommonDataKinds.Email#ADDRESS}의 실제 값은
+ 상수 {@link android.provider.ContactsContract.CommonDataKinds.Email#ADDRESS}가
+들어있습니다.
+{@link android.provider.ContactsContract.CommonDataKinds.Email#ADDRESS}의 실제 값은
"data1"이고, 이는 열의 일반 이름과 같습니다.
- 주의: 개발자 본인의 사용자 지정 데이터를
-{@link android.provider.ContactsContract.Data} 테이블에
-추가할 때 제공자의 미리 정의된 MIME 유형 중 하나가 있는 행을 사용하면 안 됩니다. 그렇게 하면 데이터가 손실되거나 제공자의 오작동을
-유발할 수 있습니다. 예를 들어, MIME 유형
+ 주의: 개발자 본인의 사용자 지정 데이터를
+{@link android.provider.ContactsContract.Data} 테이블에
+추가할 때 제공자의 미리 정의된 MIME 유형 중 하나가 있는 행을 사용하면 안 됩니다. 그렇게 하면 데이터가 손실되거나 제공자의 오작동을
+유발할 수 있습니다. 예를 들어, MIME 유형
{@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_ITEM_TYPE
- Email.CONTENT_ITEM_TYPE} 안에
-DATA1 열에 있는 이메일 주소 대신 사용자 이름이 들어있는 행은 추가하면 안 됩니다. 해당 행에 개발자 나름의 사용자 지정 MIME 유형을 사용하는 경우
+ Email.CONTENT_ITEM_TYPE} 안에
+DATA1 열에 있는 이메일 주소 대신 사용자 이름이 들어있는 행은 추가하면 안 됩니다. 해당 행에 개발자 나름의 사용자 지정 MIME 유형을 사용하는 경우
본인만의 유형별 열 이름을 자유자재로 정의하고 이러한 열을 마음대로 사용해도 됩니다.
- 그림 2는
-{@link android.provider.ContactsContract.Data} 행에서 설명 열과 데이터 열이 나타나는 방식과 유형별 열 이름이
+ 그림 2는
+{@link android.provider.ContactsContract.Data} 행에서 설명 열과 데이터 열이 나타나는 방식과 유형별 열 이름이
일반 열 이름에 "오버레이"되는 방식을 나타낸 것입니다.
@@ -446,51 +446,51 @@ Email.CONTENT_ITEM_TYPE}을 갖는
- 그룹은 계정 유형과 계정 이름의 선택적 기능입니다. 이러한 내용은
+ 그룹은 계정 유형과 계정 이름의 선택적 기능입니다. 이러한 내용은
연락처 그룹 섹션에 자세히 설명되어 있습니다.
연락처
- 연락처 제공자는 모든 계정 유형과 계정 이름을 통틀어 원시 연락처 행을 조합하여
-하나의 연락처를 형성합니다. 이렇게 하면 사용자가 한 사람에 대해 수집한
-모든 데이터를 표시하고 수정하기 쉽습니다. 연락처 제공자는 새 연락처 행의 생성을 관리하고
-원시 연락처를 기존 연락처 행과 통합하기도 합니다. 애플리케이션과
+ 연락처 제공자는 모든 계정 유형과 계정 이름을 통틀어 원시 연락처 행을 조합하여
+하나의 연락처를 형성합니다. 이렇게 하면 사용자가 한 사람에 대해 수집한
+모든 데이터를 표시하고 수정하기 쉽습니다. 연락처 제공자는 새 연락처 행의 생성을 관리하고
+원시 연락처를 기존 연락처 행과 통합하기도 합니다. 애플리케이션과
동기화 어댑터는 모두 연락처를 추가할 수 없으며, 연락처 행에 있는 열 중 몇몇은 읽기 전용입니다.
- 참고: 연락처 제공자에 연락처를 추가하려고
-{@link android.content.ContentResolver#insert(Uri,ContentValues) insert()}를 사용하는 경우,
-{@link java.lang.UnsupportedOperationException} 예외가 발생합니다. "읽기 전용"으로 표시된 열을 업데이트하려고 하면
+ 참고: 연락처 제공자에 연락처를 추가하려고
+{@link android.content.ContentResolver#insert(Uri,ContentValues) insert()}를 사용하는 경우,
+{@link java.lang.UnsupportedOperationException} 예외가 발생합니다. "읽기 전용"으로 표시된 열을 업데이트하려고 하면
그 업데이트는 무시됩니다.
- 연락처 제공자는 기존 연락처 어느 것과도 일치하지 않는 새로운 원시 연락처가 추가되면
-새로운 연락처를 생성합니다. 제공자가 이 작업을 하는 또 다른 경우는
-기존 원시 연락처의 데이터가 변경되어 이전에 첨부되어 있던 연락처에 더 이상 일치하지 않는
-경우입니다. 애플리케이션이나 동기화 어댑터가
+ 연락처 제공자는 기존 연락처 어느 것과도 일치하지 않는 새로운 원시 연락처가 추가되면
+새로운 연락처를 생성합니다. 제공자가 이 작업을 하는 또 다른 경우는
+기존 원시 연락처의 데이터가 변경되어 이전에 첨부되어 있던 연락처에 더 이상 일치하지 않는
+경우입니다. 애플리케이션이나 동기화 어댑터가
기존 연락처와 일치하는 새로운 원시 연락처를 생성하면, 새로운 원시 연락처는
기존 연락처에 통합됩니다.
연락처 제공자는
-{@link android.provider.ContactsContract.Contacts Contacts} 테이블에 있는 연락처 행의 _ID 열로
-연락처 행과 원시 연락처 행를 연결합니다. 원시 연락처 테이블 {@link android.provider.ContactsContract.RawContacts}의 CONTACT_ID 행에는
-각 원시 연락처 행과 관련된 연락처 행에 대한 _ID 값이
+{@link android.provider.ContactsContract.Contacts Contacts} 테이블에 있는 연락처 행의 _ID 열로
+연락처 행과 원시 연락처 행를 연결합니다. 원시 연락처 테이블 {@link android.provider.ContactsContract.RawContacts}의 CONTACT_ID 행에는
+각 원시 연락처 행과 관련된 연락처 행에 대한 _ID 값이
들어있습니다.
{@link android.provider.ContactsContract.Contacts} 테이블에는 연락처 행에 대한 "영구" 링크인
{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} 열도
-있습니다. 연락처 제공자가 연락처를 자동으로 관리하므로,
-통합이나 동기화에 응답하여 연락처 행의 {@code android.provider.BaseColumns#_ID} 값을
-변경할 수도 있습니다. 이런 일이 발생한다 하더라도 콘텐츠 URI
-{@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}와
-연락처의 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}는 여전히
-연락처 행을 가리키므로,
-{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}를
-사용하여 "즐겨찾기" 연락처에 대한 연결 등을 그대로 유지할 수 있습니다. 이 열에는
+있습니다. 연락처 제공자가 연락처를 자동으로 관리하므로,
+통합이나 동기화에 응답하여 연락처 행의 {@code android.provider.BaseColumns#_ID} 값을
+변경할 수도 있습니다. 이런 일이 발생한다 하더라도 콘텐츠 URI
+{@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}와
+연락처의 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}는 여전히
+연락처 행을 가리키므로,
+{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}를
+사용하여 "즐겨찾기" 연락처에 대한 연결 등을 그대로 유지할 수 있습니다. 이 열에는
{@code android.provider.BaseColumns#_ID} 열의 형식과 관련이 없는 나름의 형식이 있습니다.
@@ -502,17 +502,17 @@ Email.CONTENT_ITEM_TYPE}을 갖는
동기화 어댑터의 데이터
- 사용자가 연락처 데이터를 기기에 직접 입력하기도 하지만, 데이터는 웹 서비스에서
-동기화 어댑터를 통해 연락처 제공자로 흘러들어가기도 합니다. 이것이 기기와
-서비스 사이에서 데이터의 전송을 자동화하는 것입니다. 동기화 어댑터는 시스템의 제어를 받으며
-배경에서 실행되고, {@link android.content.ContentResolver} 메서드를
+ 사용자가 연락처 데이터를 기기에 직접 입력하기도 하지만, 데이터는 웹 서비스에서
+동기화 어댑터를 통해 연락처 제공자로 흘러들어가기도 합니다. 이것이 기기와
+서비스 사이에서 데이터의 전송을 자동화하는 것입니다. 동기화 어댑터는 시스템의 제어를 받으며
+배경에서 실행되고, {@link android.content.ContentResolver} 메서드를
호출하여 데이터를 관리합니다.
Android에서 동기화 어댑터와 함께 작업하는 웹 서비스는 계정 유형으로 식별됩니다.
- 각 동기화 어댑터는 계정 유형 하나에 통하지만, 그 유형에 대한 여러 개의 계정이름을
-지원할 수 있습니다. 계정 유형과 계정 이름은
-원시 연락처 데이터 소스 섹션에 간단히 설명되어 있습니다. 다음 정의는 좀 더 자세한 내용을 제공하며,
+ 각 동기화 어댑터는 계정 유형 하나에 통하지만, 그 유형에 대한 여러 개의 계정이름을
+지원할 수 있습니다. 계정 유형과 계정 이름은
+원시 연락처 데이터 소스 섹션에 간단히 설명되어 있습니다. 다음 정의는 좀 더 자세한 내용을 제공하며,
계정 유형과 이름이 동기화 어댑터와 서비스에 관련되는 방식을 설명합니다.
@@ -520,34 +520,34 @@ Email.CONTENT_ITEM_TYPE}을 갖는
계정 유형
- 사용자가 데이터를 저장해둔 서비스를 식별합니다. 대부분의 경우, 사용자가
-서비스로 인증해야 합니다. 예를 들어, Google 주소록은 계정 유형이고, 이는
-코드 google.com으로 식별됩니다. 이 값은
+ 사용자가 데이터를 저장해둔 서비스를 식별합니다. 대부분의 경우, 사용자가
+서비스로 인증해야 합니다. 예를 들어, Google 주소록은 계정 유형이고, 이는
+코드 google.com으로 식별됩니다. 이 값은
{@link android.accounts.AccountManager}가 사용하는 계정 유형에 상응합니다.
계정 이름
- 하나의 계정 유형에 대한 특정 계정 또는 로그인을 식별합니다. Google 주소록 계정은
+ 하나의 계정 유형에 대한 특정 계정 또는 로그인을 식별합니다. Google 주소록 계정은
Google 계정과 같고, 이는 계정 이름으로 이메일 주소를 사용합니다.
다른 서비스는 한 단어로 된 사용자 이름이나 숫자 ID를 사용할 수 있습니다.
- 계정 유형은 고유하지 않아도 됩니다. 한 사람의 사용자가 여러 개의 Google 주소록을 구성할 수 있고
-그 데이터를 연락처 제공자에 다운로드할 수 있습니다. 이런 일은 사용자에게
-개인용 계정 이름에 대한 개인용 연락처가 한 세트 있고, 업무용으로 또 한 세트가 있는 경우 일어납니다. 계정 이름은 보통
-고유합니다. 이 둘은 함께 사용되어 연락처 제공자와 외부 서비스 사이의 특정 데이터
+ 계정 유형은 고유하지 않아도 됩니다. 한 사람의 사용자가 여러 개의 Google 주소록을 구성할 수 있고
+그 데이터를 연락처 제공자에 다운로드할 수 있습니다. 이런 일은 사용자에게
+개인용 계정 이름에 대한 개인용 연락처가 한 세트 있고, 업무용으로 또 한 세트가 있는 경우 일어납니다. 계정 이름은 보통
+고유합니다. 이 둘은 함께 사용되어 연락처 제공자와 외부 서비스 사이의 특정 데이터
흐름을 식별합니다.
- 서비스의 데이터를 연락처 제공자에 전송하려면, 나름의
-동기화 어댑터를 작성해야 합니다. 이 내용은
+ 서비스의 데이터를 연락처 제공자에 전송하려면, 나름의
+동기화 어댑터를 작성해야 합니다. 이 내용은
연락처 제공자 동기화 어댑터 섹션에 자세히 설명되어 있습니다.
- 그림 4는 연락처 제공자가 사람에 대한 데이터 흐름에
+ 그림 4는 연락처 제공자가 사람에 대한 데이터 흐름에
어떻게 들어맞는지 나타낸 것입니다. "동기화 어댑터"라고 표시된 상자에서, 각 어댑터에는 계정 유형에 따라 레이블이 붙어 있습니다.
@@ -556,67 +556,67 @@ Google 계정과 같고, 이는 계정 이름으로 이메일 주소를 사용
필수 권한
- 연락처 제공자에 액세스하고자 하는 애플리케이션은 다음 권한을
+ 연락처 제공자에 액세스하고자 하는 애플리케이션은 다음 권한을
요청해야 합니다.
하나 이상의 테이블에 대한 읽기 액세스
- {@link android.Manifest.permission#READ_CONTACTS},
-AndroidManifest.xml에서
+ {@link android.Manifest.permission#READ_CONTACTS},
+AndroidManifest.xml에서
- <uses-permission> 요소와 함께
+ <uses-permission> 요소와 함께
<uses-permission android:name="android.permission.READ_CONTACTS">로 지정된 것.
하나 이상의 테이블에 대한 쓰기 액세스
- {@link android.Manifest.permission#WRITE_CONTACTS},
-AndroidManifest.xml에서
+ {@link android.Manifest.permission#WRITE_CONTACTS},
+AndroidManifest.xml에서
- <uses-permission> 요소와 함께
+ <uses-permission> 요소와 함께
<uses-permission android:name="android.permission.WRITE_CONTACTS">로 지정된 것.
- 이들 권한은 사용자 프로필 데이터로 확대되지 않습니다. 사용자 프로필과
-필수 권한은
+ 이들 권한은 사용자 프로필 데이터로 확대되지 않습니다. 사용자 프로필과
+필수 권한은
다음 섹션인 사용자 프로필에서 논의합니다.
- 사용자의 연락처 데이터는 중요한 개인 정보라는 사실을 명심하십시오. 사용자는 자신의
+ 사용자의 연락처 데이터는 중요한 개인 정보라는 사실을 명심하십시오. 사용자는 자신의
개인정보보호를 중요하게 생각하고 신경 쓰기 때문에 애플리케이션이 자신이나 자신의 연락처에 관한 정보를 수집하는 것을 바라지 않습니다.
- 사용자의 연락처 데이터에 액세스할 권한이 필요한 이유가 분명하지 않으면 여러분의
+ 사용자의 연락처 데이터에 액세스할 권한이 필요한 이유가 분명하지 않으면 여러분의
애플리케이션에 낮은 순위를 매기거나 설치를 거부할 수도 있습니다.
사용자 프로필
- {@link android.provider.ContactsContract.Contacts} 테이블에 있는 한 개의 행에는 기기의 사용자에 대한 프로필
-데이터가 담겨 있습니다. 이 데이터는 사용자의 연락처 중 하나라기보다는 기기의 user를
-설명하는 것입니다. 프로필 연락처 행은
+ {@link android.provider.ContactsContract.Contacts} 테이블에 있는 한 개의 행에는 기기의 사용자에 대한 프로필
+데이터가 담겨 있습니다. 이 데이터는 사용자의 연락처 중 하나라기보다는 기기의 user를
+설명하는 것입니다. 프로필 연락처 행은
프로필을 사용하는 각 시스템에 대한 원시 연락처 행에 연결되어 있습니다.
- 각 프로필 원시 연락처 행에는 여러 개의 데이터 행이 있을 수 있습니다. 사용자 프로필에 액세스하기 위한 상수는
+ 각 프로필 원시 연락처 행에는 여러 개의 데이터 행이 있을 수 있습니다. 사용자 프로필에 액세스하기 위한 상수는
{@link android.provider.ContactsContract.Profile} 클래스에서 이용할 수 있습니다.
- 사용자 프로필에 액세스하려면 특수 권한이 필요합니다. 읽기와 쓰기에 필요한
+ 사용자 프로필에 액세스하려면 특수 권한이 필요합니다. 읽기와 쓰기에 필요한
{@link android.Manifest.permission#READ_CONTACTS}와
-{@link android.Manifest.permission#WRITE_CONTACTS} 권한 외에도,
-사용자 프로필에 액세스하려면 각각 읽기와 쓰기 액세스를 위한{@code android.Manifest.permission#READ_PROFILE}과
-{@code android.Manifest.permission#WRITE_PROFILE} 권한이
+{@link android.Manifest.permission#WRITE_CONTACTS} 권한 외에도,
+사용자 프로필에 액세스하려면 각각 읽기와 쓰기 액세스를 위한{@code android.Manifest.permission#READ_PROFILE}과
+{@code android.Manifest.permission#WRITE_PROFILE} 권한이
필요합니다.
- 사용자의 프로필은 중요한 정보로 간주해야 한다는 점을 명심하십시오.
-{@code android.Manifest.permission#READ_PROFILE}권한을 사용하면 개발자가 기기 사용자의
-개인 식별 데이터에 액세스할 수 있게 해줍니다. 애플리케이션 설명에서
+ 사용자의 프로필은 중요한 정보로 간주해야 한다는 점을 명심하십시오.
+{@code android.Manifest.permission#READ_PROFILE}권한을 사용하면 개발자가 기기 사용자의
+개인 식별 데이터에 액세스할 수 있게 해줍니다. 애플리케이션 설명에서
사용자에게 왜 여러분이 사용자 프로필 권한을 필요로 하는지 밝혀두어야 합니다.
사용자 프로필이 포함된 연락처 행을 검색하려면,
{@link android.content.ContentResolver#query(Uri,String[], String, String[], String)
ContentResolver.query()}를 호출합니다. 콘텐츠 URI 를
-{@link android.provider.ContactsContract.Profile#CONTENT_URI}로 설정하고
-선택 기준은 아무것도 제공하지 마십시오. 이 콘텐츠 URI는 원시 연락처 또는 프로필에 대한 데이터를 검색하기 위한
+{@link android.provider.ContactsContract.Profile#CONTENT_URI}로 설정하고
+선택 기준은 아무것도 제공하지 마십시오. 이 콘텐츠 URI는 원시 연락처 또는 프로필에 대한 데이터를 검색하기 위한
기본 URI로도 쓸 수 있습니다. 예를 들어, 이 코드 조각은 프로필에 대한 데이터를 검색합니다.
@@ -639,18 +639,18 @@ mProfileCursor =
null);
- 참고: 여러 개의 연락처 행을 검색하고 그 중 하나가
-사용자 프로필인지 판별하고자 하는 경우,
-행의 {@link android.provider.ContactsContract.ContactsColumns#IS_USER_PROFILE} 열을 테스트합니다. 이 열은
+ 참고: 여러 개의 연락처 행을 검색하고 그 중 하나가
+사용자 프로필인지 판별하고자 하는 경우,
+행의 {@link android.provider.ContactsContract.ContactsColumns#IS_USER_PROFILE} 열을 테스트합니다. 이 열은
해당 연락처가 사용자 프로필이면 "1"로 설정됩니다.
연락처 제공자 메타데이터
- 연락처 제공자는 리포지토리에서 연락처 데이터 상태를
-추적하는 데이터를 관리합니다. 이 리포지토리 관련 데이터는
+ 연락처 제공자는 리포지토리에서 연락처 데이터 상태를
+추적하는 데이터를 관리합니다. 이 리포지토리 관련 데이터는
원시 연락처, 데이터 및 연락처 테이블 행,
-{@link android.provider.ContactsContract.Settings} 테이블 및
-{@link android.provider.ContactsContract.SyncState} 테이블 등의 여러 장소에 저장됩니다. 다음 표는 각 메타데이터 조각이 미치는
+{@link android.provider.ContactsContract.Settings} 테이블 및
+{@link android.provider.ContactsContract.SyncState} 테이블 등의 여러 장소에 저장됩니다. 다음 표는 각 메타데이터 조각이 미치는
영향을 나타낸 것입니다.
- 기기에서 변경되었고 서버로 다시 동기화되어야 하는 원시 데이터를
-표시합니다. 이 값은 Android 애플리케이션이 행을 업데이트하면 연락처 제공자가
+ 기기에서 변경되었고 서버로 다시 동기화되어야 하는 원시 데이터를
+표시합니다. 이 값은 Android 애플리케이션이 행을 업데이트하면 연락처 제공자가
자동으로 설정합니다.
- 원시 연락처나 데이터 테이블을 수정하는 동기화 어댑터는
-언제나 문자열 {@link android.provider.ContactsContract#CALLER_IS_SYNCADAPTER}를
+ 원시 연락처나 데이터 테이블을 수정하는 동기화 어댑터는
+언제나 문자열 {@link android.provider.ContactsContract#CALLER_IS_SYNCADAPTER}를
자신이 사용하는 콘텐츠 URI에 추가해야 합니다. 이렇게 하면 제공자가 행을 변경(dirty)으로 표시하지 못하게 방지합니다.
- 그렇지 않으면, 동기화 어댑터 수정이 로컬 수정으로 나타나며
+ 그렇지 않으면, 동기화 어댑터 수정이 로컬 수정으로 나타나며
서버가 수정의 근원이었다 하더라도 이 내용이 다시 서버로 전송됩니다.
- 이 원시 연락처를 자신이 생성된 계정에 대해 고유하게 식별하는
+ 이 원시 연락처를 자신이 생성된 계정에 대해 고유하게 식별하는
문자열 값입니다.
- 동기화 어댑터가 새로운 원시 연락처를 생성하면, 이 열이
-해당 원시 연락처에 대한 서버의 고유 ID로 설정되어야 합니다. Android 애플리케이션이 새로운 원시 연락처를 생성하면,
-애플리케이션은 이 열을 빈 채로 두어야 합니다. 이것은 동기화 어댑터에
-서버에 새 원시 데이터를 생성해야 한다고 신호하고,
+ 동기화 어댑터가 새로운 원시 연락처를 생성하면, 이 열이
+해당 원시 연락처에 대한 서버의 고유 ID로 설정되어야 합니다. Android 애플리케이션이 새로운 원시 연락처를 생성하면,
+애플리케이션은 이 열을 빈 채로 두어야 합니다. 이것은 동기화 어댑터에
+서버에 새 원시 데이터를 생성해야 한다고 신호하고,
{@link android.provider.ContactsContract.SyncColumns#SOURCE_ID}에 대한 값을 가져오라고 알립니다.
- 특히, 소스 ID는 각 계정 유형에 대해 고유해야 하고
+ 특히, 소스 ID는 각 계정 유형에 대해 고유해야 하고
동기화 전체에서 안정적이어야 합니다.
- 고유: 하나의 계정에 대한 각 원시 연락처에는 나름의 소스 ID가 있어야 합니다. 개발자가
+ 고유: 하나의 계정에 대한 각 원시 연락처에는 나름의 소스 ID가 있어야 합니다. 개발자가
이것을 강제 적용하지 않으면 연락처 애플리케이션에 문제를 유발하게 됩니다.
- 같은 계정 유형에 대한 두 개의 원시 연락처는 소스 ID가
-같을 수 있다는 점을 유의하십시오. 예를 들어,
-{@code emily.dickinson@gmail.com} 계정에 대한 원시 연락처 "Thomas Higginson"은
-{@code emilyd@gmail.com} 계정에 대한
+ 같은 계정 유형에 대한 두 개의 원시 연락처는 소스 ID가
+같을 수 있다는 점을 유의하십시오. 예를 들어,
+{@code emily.dickinson@gmail.com} 계정에 대한 원시 연락처 "Thomas Higginson"은
+{@code emilyd@gmail.com} 계정에 대한
원시 연락처 "Thomas Higginson"과 소스 ID가 같을 수 있습니다.
- 안정적: 소스 ID는 원시 연락처에 대한 온라인 서비스의 데이터 중 영구적인
-부분입니다. 예를 들어, 사용자가 앱 설정에서 연락처 저장소를 삭제하고 다시 동기화하면
-복원된 원시 연락처의 소스 ID는 전과 같아야
+ 안정적: 소스 ID는 원시 연락처에 대한 온라인 서비스의 데이터 중 영구적인
+부분입니다. 예를 들어, 사용자가 앱 설정에서 연락처 저장소를 삭제하고 다시 동기화하면
+복원된 원시 연락처의 소스 ID는 전과 같아야
합니다. 개발자가 이것을 강제 적용하지 않으면 바로 가기가 더 이상
작동하지 않습니다.
- "0" - 이 계정과 계정 유형의 경우, 그룹에 속하지 않는 연락처는 Android 애플리케이션 UI에
+ "0" - 이 계정과 계정 유형의 경우, 그룹에 속하지 않는 연락처는 Android 애플리케이션 UI에
표시되지 않습니다.
- 기본적으로, 연락처에 그룹에 속한 원시 데이터가 하나도 없는 경우 이는 표시되지 않습니다(원시 연락처의 그룹 구성원은
-{@link android.provider.ContactsContract.Data} 테이블에서
-하나 이상의 {@link android.provider.ContactsContract.CommonDataKinds.GroupMembership} 행으로
+ 기본적으로, 연락처에 그룹에 속한 원시 데이터가 하나도 없는 경우 이는 표시되지 않습니다(원시 연락처의 그룹 구성원은
+{@link android.provider.ContactsContract.Data} 테이블에서
+하나 이상의 {@link android.provider.ContactsContract.CommonDataKinds.GroupMembership} 행으로
표시됩니다).
- 계정 유형과 계정에 대한 {@link android.provider.ContactsContract.Settings} 테이블 행에서
+ 계정 유형과 계정에 대한 {@link android.provider.ContactsContract.Settings} 테이블 행에서
이 플래그를 설정하면 그룹이 없는 연락처가 표시되도록 강제할 수 있습니다.
이 플래그의 용도 중 하나는 그룹을 사용하지 않는 서버로부터 가져온 연락처를 표시하는 것입니다.
- "1" - 이 계정과 계정 유형의 경우, 그룹에 속하지 않는 연락처가 애플리케이션 UI에
+ "1" - 이 계정과 계정 유형의 경우, 그룹에 속하지 않는 연락처가 애플리케이션 UI에
표시됩니다.
@@ -781,14 +781,14 @@ mProfileCursor =
이 테이블을 사용하여 동기화 어댑터의 메타데이터를 저장합니다.
- 이 테이블을 사용하면 동기화 상태와 기타 동기화 관련 데이터를 기기에 영구적으로
+ 이 테이블을 사용하면 동기화 상태와 기타 동기화 관련 데이터를 기기에 영구적으로
저장할 수 있습니다.
연락처 제공자 액세스
- 이 섹션은 연락처 제공자에서 가져온 데이터에 액세스하는 법에 대한 지침을 제공하며,
+ 이 섹션은 연락처 제공자에서 가져온 데이터에 액세스하는 법에 대한 지침을 제공하며,
요점은 다음과 같습니다.
@@ -806,49 +806,49 @@ mProfileCursor =
- 동기화 어댑터에서 수정하는 방법은
+ 동기화 어댑터에서 수정하는 방법은
연락처 제공자 동기화 어댑터 섹션에도 자세히 설명되어 있습니다.
엔티티 쿼리
- 연락처 제공자 테이블은 계층을 사용하여 조직화되어 있으므로,
-행과 그 행에 연결된 모든 "하위" 행을 검색하는 것이 유용할 때가 많습니다. 예를 들어,
-어떤 개인의 모든 정보를 표시하려면
-하나의 {@link android.provider.ContactsContract.Contacts} 행에 대한 모든
-{@link android.provider.ContactsContract.RawContacts} 행을 검색하거나 하나의
-{@link android.provider.ContactsContract.RawContacts} 행에 대한 모든
-{@link android.provider.ContactsContract.CommonDataKinds.Email} 행을 검색하는 것이 좋습니다. 이를 용이하게 하기 위해,
-연락처 제공자는 테이블 사이를 연결하는 데이터베이스 역할을 하는 엔티티 구조를
+ 연락처 제공자 테이블은 계층을 사용하여 조직화되어 있으므로,
+행과 그 행에 연결된 모든 "하위" 행을 검색하는 것이 유용할 때가 많습니다. 예를 들어,
+어떤 개인의 모든 정보를 표시하려면
+하나의 {@link android.provider.ContactsContract.Contacts} 행에 대한 모든
+{@link android.provider.ContactsContract.RawContacts} 행을 검색하거나 하나의
+{@link android.provider.ContactsContract.RawContacts} 행에 대한 모든
+{@link android.provider.ContactsContract.CommonDataKinds.Email} 행을 검색하는 것이 좋습니다. 이를 용이하게 하기 위해,
+연락처 제공자는 테이블 사이를 연결하는 데이터베이스 역할을 하는 엔티티 구조를
제공합니다.
하나의 엔티티는 마치 상위 테이블과 그 하위 테이블에서 가져온 선택된 몇 개의 열로 이루어진 테이블과 같습니다.
- 엔티티를 쿼리하는 경우, 해당 엔티티에서 사용할 수 있는 열을 기반으로 하여 예측과 검색
-기준을 제공합니다. 그 결과도 도출되는 것이 {@link android.database.Cursor}이며,
-여기에 검색된 각 하위 테이블에 대해 행이 하나씩 들어있습니다. 예를 들어 연락처 이름에 대해
-{@link android.provider.ContactsContract.Contacts.Entity}를 쿼리하고
-그 이름에 대한 모든 원시 연락처에 대한 모든 {@link android.provider.ContactsContract.CommonDataKinds.Email} 행을 쿼리하면
-{@link android.database.Cursor}를 돌려받게 되며 이 안에
+ 엔티티를 쿼리하는 경우, 해당 엔티티에서 사용할 수 있는 열을 기반으로 하여 예측과 검색
+기준을 제공합니다. 그 결과도 도출되는 것이 {@link android.database.Cursor}이며,
+여기에 검색된 각 하위 테이블에 대해 행이 하나씩 들어있습니다. 예를 들어 연락처 이름에 대해
+{@link android.provider.ContactsContract.Contacts.Entity}를 쿼리하고
+그 이름에 대한 모든 원시 연락처에 대한 모든 {@link android.provider.ContactsContract.CommonDataKinds.Email} 행을 쿼리하면
+{@link android.database.Cursor}를 돌려받게 되며 이 안에
각 {@link android.provider.ContactsContract.CommonDataKinds.Email}행에 대한 행이 하나씩 들어있습니다.
- 엔티티는 쿼리를 단순화합니다. 엔티티를 사용하면 연락처나 원시 연락처에 대한 모든 연락처 데이터를
-한꺼번에 검색할 수 있습니다. 즉 우선 상위 테이블을 검색하여 ID를 가져오고, 그런 다음
-하위 테이블을 그 ID로 검색하지 않아도 된다는 뜻입니다. 또한, 연락처 제공자에는 엔티티에 대한 쿼리를
-하나의 트랜잭션으로 처리하므로, 검색된 데이터가 내부적으로 일관성을 유지하도록
+ 엔티티는 쿼리를 단순화합니다. 엔티티를 사용하면 연락처나 원시 연락처에 대한 모든 연락처 데이터를
+한꺼번에 검색할 수 있습니다. 즉 우선 상위 테이블을 검색하여 ID를 가져오고, 그런 다음
+하위 테이블을 그 ID로 검색하지 않아도 된다는 뜻입니다. 또한, 연락처 제공자에는 엔티티에 대한 쿼리를
+하나의 트랜잭션으로 처리하므로, 검색된 데이터가 내부적으로 일관성을 유지하도록
보장합니다.
- 참고: 하나의 엔티티에 상위 및 하위 테이블의 모든 열이 들어있지는 않은 것이
-보통입니다. 엔티티에 대한 열 이름 상수 목록에 없는 열 이름으로 작업하려 시도하면,
+ 참고: 하나의 엔티티에 상위 및 하위 테이블의 모든 열이 들어있지는 않은 것이
+보통입니다. 엔티티에 대한 열 이름 상수 목록에 없는 열 이름으로 작업하려 시도하면,
{@link java.lang.Exception}이 발생합니다.
- 다음 조각은 하나의 연락처에 대해 모든 원시 연락처 행을 검색하는 방법을 나타낸 것입니다. 이 조각은
-두 개의 액티비티, 즉 "기본"과 "세부"를 가진 더 큰 애플리케이션의 일부입니다. 기본 액티비티는
-연락처 행 목록을 보여줍니다. 사용자가 하나를 선택하면, 이 액티비티가 해당 목록의 ID를
-세부 액티비티에 전송합니다. 세부 액티비티는 {@link android.provider.ContactsContract.Contacts.Entity}를 사용하여
-선택된 연락처와 연관된 모든 원시 연락처에서
+ 다음 조각은 하나의 연락처에 대해 모든 원시 연락처 행을 검색하는 방법을 나타낸 것입니다. 이 조각은
+두 개의 액티비티, 즉 "기본"과 "세부"를 가진 더 큰 애플리케이션의 일부입니다. 기본 액티비티는
+연락처 행 목록을 보여줍니다. 사용자가 하나를 선택하면, 이 액티비티가 해당 목록의 ID를
+세부 액티비티에 전송합니다. 세부 액티비티는 {@link android.provider.ContactsContract.Contacts.Entity}를 사용하여
+선택된 연락처와 연관된 모든 원시 연락처에서
모든 데이터 행을 표시합니다.
- 로딩이 완료되면, {@link android.app.LoaderManager}가
+ 로딩이 완료되면, {@link android.app.LoaderManager}가
{@link android.app.LoaderManager.LoaderCallbacks#onLoadFinished(Loader, D)
-onLoadFinished()}에 대한 콜백을 호출합니다. 이 메서드로 수신되는 인수 중 하나가
-{@link android.database.Cursor}로, 여기에 쿼리 결과도 함께 들어옵니다. 개발자 본인의 앱에서는, 이
+onLoadFinished()}에 대한 콜백을 호출합니다. 이 메서드로 수신되는 인수 중 하나가
+{@link android.database.Cursor}로, 여기에 쿼리 결과도 함께 들어옵니다. 개발자 본인의 앱에서는, 이
{@link android.database.Cursor}에서 데이터를 가져와 이를 표시할 수도 있고 여기에 작업을 더할 수도 있습니다.
일괄 수정
- 연락처 제공자에서 데이터를 삽입, 업데이트 및 삭제하는 경우 가급적이면
-"일괄 모드"를 쓰는 것이 좋습니다. 이때
-{@link android.content.ContentProviderOperation} 객체의 {@link java.util.ArrayList}를 생성하고
-{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}를 호출하면 됩니다. 연락처 제공자는
+ 연락처 제공자에서 데이터를 삽입, 업데이트 및 삭제하는 경우 가급적이면
+"일괄 모드"를 쓰는 것이 좋습니다. 이때
+{@link android.content.ContentProviderOperation} 객체의 {@link java.util.ArrayList}를 생성하고
+{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}를 호출하면 됩니다. 연락처 제공자는
-{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}에서의 모든 작업을
-하나의 트랜잭션으로 수행하기 때문에, 수정한 내용이 일관되지 않은 상태로 연락처 리포지토리를
-떠날 일이 결코 없습니다. 일괄 수정을 사용하면 원시 연락처와 그 세부 데이터를 동시에 삽입하는 것도
+{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}에서의 모든 작업을
+하나의 트랜잭션으로 수행하기 때문에, 수정한 내용이 일관되지 않은 상태로 연락처 리포지토리를
+떠날 일이 결코 없습니다. 일괄 수정을 사용하면 원시 연락처와 그 세부 데이터를 동시에 삽입하는 것도
쉽습니다.
- 참고:하나의 원시 연락처를 수정하려면 수정 작업을 앱에서 처리하는 것보다는
-인텐트를 기기의 연락처 애플리케이션에 보내는 방안을 고려하십시오.
-이렇게 하는 방법이
+ 참고:하나의 원시 연락처를 수정하려면 수정 작업을 앱에서 처리하는 것보다는
+인텐트를 기기의 연락처 애플리케이션에 보내는 방안을 고려하십시오.
+이렇게 하는 방법이
인텐트로 검색 및 수정 섹션에 자세히 설명되어 있습니다.
양보 지점
- 대량의 작업이 들어있는 일괄 수정은 다른 프로세스를 차단하므로,
-그 결과 전반적으로 불량한 사용자 환경을 유발할 수 있습니다. 수행하고자 하는 모든 수정 작업을 가능한 한
-적은 수의 별도의 목록으로 정리하고 그와 동시에 이 작업이 시스템을 차단하지 못하도록 방지하려면
+ 대량의 작업이 들어있는 일괄 수정은 다른 프로세스를 차단하므로,
+그 결과 전반적으로 불량한 사용자 환경을 유발할 수 있습니다. 수행하고자 하는 모든 수정 작업을 가능한 한
+적은 수의 별도의 목록으로 정리하고 그와 동시에 이 작업이 시스템을 차단하지 못하도록 방지하려면
하나 이상의 작업에 양보 지점을 설정해야 합니다.
양보 지점은 {@link android.content.ContentProviderOperation#isYieldAllowed()} 값이 true로 설정된 {@link android.content.ContentProviderOperation} 객체입니다.
- 연락처 제공자가 양보 지점을 만나면
-다른 프로세스가 실행되도록 작업을 잠시 멈추고 현재 트랜잭션을 종료합니다. 제공자가 다시 시작되면, 이는
-{@link java.util.ArrayList}에서 다음 작업을 계속 진행하고
+ 연락처 제공자가 양보 지점을 만나면
+다른 프로세스가 실행되도록 작업을 잠시 멈추고 현재 트랜잭션을 종료합니다. 제공자가 다시 시작되면, 이는
+{@link java.util.ArrayList}에서 다음 작업을 계속 진행하고
새 트랜잭션을 시작합니다.
- 양보 지점을 사용하면 그 결과
-{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}로의 호출 한 건당 하나 이상의 트랜잭션이 생기는 것은 사실입니다. 이 때문에,
+ 양보 지점을 사용하면 그 결과
+{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}로의 호출 한 건당 하나 이상의 트랜잭션이 생기는 것은 사실입니다. 이 때문에,
양보 지점은 관련된 행 한 세트에서 마지막 작업에 설정해야 합니다.
- 예를 들어, 원시 연락처 행과 관련된 데이터 행을 추가하는 세트의 마지막 작업에
-양보 지점을 설정하거나, 하나의 연락처와 관련된 행 한 세트의
+ 예를 들어, 원시 연락처 행과 관련된 데이터 행을 추가하는 세트의 마지막 작업에
+양보 지점을 설정하거나, 하나의 연락처와 관련된 행 한 세트의
마지막 작업에 양보 지점을 설정해야 합니다.
- 양보 지점은 원자성 작업의 단위이기도 합니다. 두 개의 양보 지점 사이를 향한 액세스는 모두
-한 가지 단위로서 성공 또는 실패합니다. 양보 지점을 설정하지 않는 경우, 가장 작은
-원자성 작업은 작업 전체가 됩니다. 양보 지점을 사용하면, 작업이
-시스템 성능을 저하하지 않도록 방지하는 동시에 작업의 하위 세트가 원자성 작업이도록
+ 양보 지점은 원자성 작업의 단위이기도 합니다. 두 개의 양보 지점 사이를 향한 액세스는 모두
+한 가지 단위로서 성공 또는 실패합니다. 양보 지점을 설정하지 않는 경우, 가장 작은
+원자성 작업은 작업 전체가 됩니다. 양보 지점을 사용하면, 작업이
+시스템 성능을 저하하지 않도록 방지하는 동시에 작업의 하위 세트가 원자성 작업이도록
보장할 수 있습니다.
수정 역참조
- 새로운 원시 연락처 행과 관련 데이터 행을
-일련의 {@link android.content.ContentProviderOperation} 개체로 삽입할 때는,
- 원시 연락처의
+ 새로운 원시 연락처 행과 관련 데이터 행을
+일련의 {@link android.content.ContentProviderOperation} 개체로 삽입할 때는,
+ 원시 연락처의
{@code android.provider.BaseColumns#_ID} 값을
-{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 값으로 삽입하여 데이터 행과 원시 연락처 행을 연결해야 합니다. 그러나, 이 값은
-데이터 행에 대하여 {@link android.content.ContentProviderOperation}을
+{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID} 값으로 삽입하여 데이터 행과 원시 연락처 행을 연결해야 합니다. 그러나, 이 값은
+데이터 행에 대하여 {@link android.content.ContentProviderOperation}을
생성하는 경우에는 사용할 수 없습니다. 원시 연락처 행에 대해 {@link android.content.ContentProviderOperation}
-을 아직 적용하지 않았기 때문입니다. 이 문제를 해결하려면
+을 아직 적용하지 않았기 때문입니다. 이 문제를 해결하려면
{@link android.content.ContentProviderOperation.Builder} 클래스에
{@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()} 메서드가 있어야 합니다.
- 이 메서드를 사용하면 열을 이전 작업의 결과로 삽입 또는 수정할 수
+ 이 메서드를 사용하면 열을 이전 작업의 결과로 삽입 또는 수정할 수
있습니다.
@@ -997,29 +997,29 @@ onLoadFinished()}에 대한 콜백을 호출합니다. 이 메서드로 수신
key
- 키-값 쌍의 키입니다. 이 인수의 값은 수정하는 테이블의
+ 키-값 쌍의 키입니다. 이 인수의 값은 수정하는 테이블의
열 이름이어야 합니다.
previousResult
-
+
{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}의 {@link android.content.ContentProviderResult} 객체 배열에 있는
-값의 0 기반 색인입니다.
-일괄 작업이 적용되면 각 작업의 결과가
-결과의 중간 배열에 저장됩니다. previousResult 값은
-이러한 결과 중 하나의 색인이고, 이는 key 값으로
+값의 0 기반 색인입니다.
+일괄 작업이 적용되면 각 작업의 결과가
+결과의 중간 배열에 저장됩니다. previousResult 값은
+이러한 결과 중 하나의 색인이고, 이는 key 값으로
검색 및 저장됩니다. 이것을 사용하면 새 원시 연락처 레코드를 삽입하고
-{@code android.provider.BaseColumns#_ID} 값을 다시 가져온 뒤,
+{@code android.provider.BaseColumns#_ID} 값을 다시 가져온 뒤,
{@link android.provider.ContactsContract.Data} 행을 추가할 때 해당 값을 "역참조"할 수 있게 해줍니다.
-
-{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}를 처음 호출할 때,
-개발자가 제공하는 {@link android.content.ContentProviderOperation} 객체의 {@link java.util.ArrayList} 크기와 같은 크기로
-전체 결과 배열이 생성됩니다. 그러나
-결과 배열의 모든 요소는 null로 설정되고,
-아직 적용되지 않은 작업 결과에 대한 역참조를 수행하려 시도하면
+
+{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}를 처음 호출할 때,
+개발자가 제공하는 {@link android.content.ContentProviderOperation} 객체의 {@link java.util.ArrayList} 크기와 같은 크기로
+전체 결과 배열이 생성됩니다. 그러나
+결과 배열의 모든 요소는 null로 설정되고,
+아직 적용되지 않은 작업 결과에 대한 역참조를 수행하려 시도하면
{@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()}가
{@link java.lang.Exception}을 발생시킵니다.
@@ -1027,15 +1027,15 @@ onLoadFinished()}에 대한 콜백을 호출합니다. 이 메서드로 수신
- 다음 조각은 새로운 원시 연락처와 데이터를 일괄 삽입하는 방법을 나타낸 것입니다. 여기에는
-양보 지점을 지정하고 역참조를 사용하는 코드가 포함되어 있습니다. 이 조각은
-createContacEntry() 메서드의 확장 버전이며, 이는
+ 다음 조각은 새로운 원시 연락처와 데이터를 일괄 삽입하는 방법을 나타낸 것입니다. 여기에는
+양보 지점을 지정하고 역참조를 사용하는 코드가 포함되어 있습니다. 이 조각은
+createContacEntry() 메서드의 확장 버전이며, 이는
- Contact Manager 샘플 애플리케이션에 있는 ContactAdder 클래스의
+ Contact Manager 샘플 애플리케이션에 있는 ContactAdder 클래스의
일부입니다.
- 첫 번째 조각은 UI에서 연락처 데이터를 검색합니다. 이 시점에서 사용자는 이미
+ 첫 번째 조각은 UI에서 연락처 데이터를 검색합니다. 이 시점에서 사용자는 이미
새로운 원시 연락처를 추가할 계정을 선택하였습니다.
- 다음 조각은
+ 다음 조각은
{@link android.provider.ContactsContract.RawContacts} 테이블에 원시 연락처 행을 삽입하는 작업을 생성합니다.
@@ -1086,18 +1086,18 @@ protected void createContactEntry() {
그런 다음, 코드가 표시 이름, 전화 및 이메일 행에 대한 데이터 행을 생성합니다.
- 각 작업 빌더 개체는
-{@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()}를
+ 각 작업 빌더 개체는
+{@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()}를
사용하여
-{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}를 가져옵니다. 참조는
-첫 번째 작업의 {@link android.content.ContentProviderResult} 객체를 다시 가리키고,
+{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}를 가져옵니다. 참조는
+첫 번째 작업의 {@link android.content.ContentProviderResult} 객체를 다시 가리키고,
이것이 원시 연락처 행을 추가한 뒤 이의 새 {@code android.provider.BaseColumns#_ID}
-값을 반환합니다. 그 결과, 각 데이터 행은 자동으로 자신의
+값을 반환합니다. 그 결과, 각 데이터 행은 자동으로 자신의
{@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}
에 의해 자신이 속하는 새 {@link android.provider.ContactsContract.RawContacts} 행에 연결됩니다.
- 마지막 조각은 새로운 원시 연락처와 데이터 행을 삽입하는
-{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}에 대한 호출을
+ 마지막 조각은 새로운 원시 연락처와 데이터 행을 삽입하는
+{@link android.content.ContentResolver#applyBatch(String, ArrayList) applyBatch()}에 대한 호출을
나타낸 것입니다.
- 일괄 작업을 사용하면 낙관적 동시성 제어도 구현할 수 있습니다.
+ 일괄 작업을 사용하면 낙관적 동시성 제어도 구현할 수 있습니다.
이것은 기본 리포지토리를 잠그지 않고도 수정 트랜잭션을 적용할 수 있는 메서드입니다.
- 이 메서드를 사용하려면 트랜잭션을 적용하고 동시에 발생한
-다른 수정 사항이 있는지 확인합니다. 부합하지 않는 수정이 발생한 것을 발견하면
+ 이 메서드를 사용하려면 트랜잭션을 적용하고 동시에 발생한
+다른 수정 사항이 있는지 확인합니다. 부합하지 않는 수정이 발생한 것을 발견하면
트랜잭션을 롤백하고 다시 시도합니다.
- 낙관적 동시성 제어는 한 번에 한 명의 사용자만 존재하고 데이터 리포지토리에 대한 동시 액세스가 드문 모바일 기기에
-유용합니다. 잠금을 사용하지 않으므로
+ 낙관적 동시성 제어는 한 번에 한 명의 사용자만 존재하고 데이터 리포지토리에 대한 동시 액세스가 드문 모바일 기기에
+유용합니다. 잠금을 사용하지 않으므로
잠금을 설정하거나 다른 트랜잭션이 잠금을 해제하기를 기다리면서 시간을 낭비하지 않습니다.
- 하나의
+ 하나의
{@link android.provider.ContactsContract.RawContacts} 행을 업데이트하면서 동시에 낙관적 동시성 제어를 사용하려면, 다음 단계를 따르십시오.
- 검색하는 다른 데이터와 함께 행 연락처의 {@link android.provider.ContactsContract.SyncColumns#VERSION}을
+ 검색하는 다른 데이터와 함께 행 연락처의 {@link android.provider.ContactsContract.SyncColumns#VERSION}을
검색합니다.
- 제약을 강제 적용하는 데 적합한
-{@link android.content.ContentProviderOperation.Builder} 객체를 하나 생성하되
-{@link android.content.ContentProviderOperation#newAssertQuery(Uri)} 메서드를 사용합니다. 콘텐츠 URI의 경우,
+ 제약을 강제 적용하는 데 적합한
+{@link android.content.ContentProviderOperation.Builder} 객체를 하나 생성하되
+{@link android.content.ContentProviderOperation#newAssertQuery(Uri)} 메서드를 사용합니다. 콘텐츠 URI의 경우,
{@link android.provider.ContactsContract.RawContacts#CONTENT_URI
- RawContacts.CONTENT_URI}를 사용하되
+ RawContacts.CONTENT_URI}를 사용하되
이에 추가된 원시 데이터의 {@code android.provider.BaseColumns#_ID}를 함께 씁니다.
행을 읽고 수정하려고 시도하는 사이에 다른 작업이 원시 연락처 행을 업데이트하면,
-"어설션" {@link android.content.ContentProviderOperation}은
-실패하고 전체 일괄 작업이 취소됩니다. 그러면 일괄 작업을 다시 시도하거나
+"어설션" {@link android.content.ContentProviderOperation}은
+실패하고 전체 일괄 작업이 취소됩니다. 그러면 일괄 작업을 다시 시도하거나
다른 조치를 취하기로 선택할 수 있습니다.
- 다음 조각은 {@link android.content.CursorLoader}를 사용하여 단일 원시 연락처를 쿼리한 후
-"어설션" {@link android.content.ContentProviderOperation}을
+ 다음 조각은 {@link android.content.CursorLoader}를 사용하여 단일 원시 연락처를 쿼리한 후
+"어설션" {@link android.content.ContentProviderOperation}을
생성하는 방법을 나타낸 것입니다.
@@ -1311,8 +1311,8 @@ try
인텐트로 검색 및 수정
- 기기 연락처 애플리케이션에 인텐트를 전송하면 연락처 제공자에
-간접적으로 액세스할 수 있습니다. 인텐트는 기기의 연락처 애플리케이션 UI를 시작하고, 여기서 사용자는
+ 기기 연락처 애플리케이션에 인텐트를 전송하면 연락처 제공자에
+간접적으로 액세스할 수 있습니다. 인텐트는 기기의 연락처 애플리케이션 UI를 시작하고, 여기서 사용자는
연락처 관련 작업을 할 수 있습니다. 사용자가 이런 액세스 유형을 가지고 할 수 있는 일은 다음과 같습니다.
목록에서 연락처를 선택하고 추가 작업을 위해 앱에 반환시킵니다.
@@ -1321,20 +1321,20 @@ try
연락처 또는 연락처 데이터를 삭제합니다.
- 사용자가 데이터를 삽입하거나 업데이트하고 있다면, 먼저 데이터를 수집하고
+ 사용자가 데이터를 삽입하거나 업데이트하고 있다면, 먼저 데이터를 수집하고
인텐트의 일부로 전송할 수 있습니다.
- 인텐트를 사용하여 기기의 연락처 애플리케이션을 통해 연락처 제공자에 액세스하는 경우
-제공자에 액세스하기 위해 개발자 나름의 UI나 코드를 작성하지 않아도 됩니다. 제공자에 대한 읽기 또는 쓰기 권한도 요청하지 않아도
-됩니다. 기기 연락처 애플리케이션은
-연락처에 대한 읽기 권한을 위임할 수 있고, 다른 애플리케이션을 통해 수정하기 때문에
+ 인텐트를 사용하여 기기의 연락처 애플리케이션을 통해 연락처 제공자에 액세스하는 경우
+제공자에 액세스하기 위해 개발자 나름의 UI나 코드를 작성하지 않아도 됩니다. 제공자에 대한 읽기 또는 쓰기 권한도 요청하지 않아도
+됩니다. 기기 연락처 애플리케이션은
+연락처에 대한 읽기 권한을 위임할 수 있고, 다른 애플리케이션을 통해 수정하기 때문에
쓰기 권한도 필요 없습니다.
- 제공자에 액세스하기 위해 인텐트를 전송하는 일반적인 과정은
+ 제공자에 액세스하기 위해 인텐트를 전송하는 일반적인 과정은
"인텐트를 통한 데이터 액세스" 섹션의
-콘텐츠 제공자 기본 정보 가이드에 상세히 설명되어 있습니다. 이용 가능한 작업에 대해 사용하는 동작,
+콘텐츠 제공자 기본 정보 가이드에 상세히 설명되어 있습니다. 이용 가능한 작업에 대해 사용하는 동작,
MIME 유형 및 데이터 값은 표 4에 요약되어 있고,
{@link android.content.Intent#putExtra(String, String) putExtra()}와 함께 사용할 수 있는 추가 값은
@@ -1358,20 +1358,20 @@ MIME 유형 및 데이터 값은 표 4에 요약되어 있고,
다음 중 하나로 정해집니다.
-{@link android.provider.ContactsContract.Contacts#CONTENT_URI Contacts.CONTENT_URI},
+{@link android.provider.ContactsContract.Contacts#CONTENT_URI Contacts.CONTENT_URI},
이는 연락처 목록을 표시합니다.
-{@link android.provider.ContactsContract.CommonDataKinds.Phone#CONTENT_URI Phone.CONTENT_URI},
+{@link android.provider.ContactsContract.CommonDataKinds.Phone#CONTENT_URI Phone.CONTENT_URI},
이는 원시 연락처에 대한 전화 번호 목록을 표시합니다.
{@link android.provider.ContactsContract.CommonDataKinds.StructuredPostal#CONTENT_URI
-StructuredPostal.CONTENT_URI},
+StructuredPostal.CONTENT_URI},
이는 원시 연락처에 대한 우편 주소 목록을 표시합니다.
-{@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_URI Email.CONTENT_URI},
+{@link android.provider.ContactsContract.CommonDataKinds.Email#CONTENT_URI Email.CONTENT_URI},
이는 원시 연락처에 대한 이메일 주소 목록을 표시합니다.
@@ -1380,15 +1380,15 @@ StructuredPostal.CONTENT_URI},
사용하지 않음
- 개발자가 제공하는 콘텐츠 URI에 따라 원시 연락처 목록이나 원시 연락처에서 가져온
+ 개발자가 제공하는 콘텐츠 URI에 따라 원시 연락처 목록이나 원시 연락처에서 가져온
데이터 목록을 표시합니다.
-
-{@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()} 호출,
-이는 선택한 행의 콘텐츠 URI를 반환합니다. URI의 형태는
+
+{@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()} 호출,
+이는 선택한 행의 콘텐츠 URI를 반환합니다. URI의 형태는
테이블의 콘텐츠 URI에 행의 LOOKUP_ID를 추가한 것입니다.
- 기기의 연락처 앱은 액티비티 수명 동안 이 콘텐츠 URI에
-읽기 및 쓰기 권한을 위임합니다. 자세한 내용은
+ 기기의 연락처 앱은 액티비티 수명 동안 이 콘텐츠 URI에
+읽기 및 쓰기 권한을 위임합니다. 자세한 내용은
콘텐츠 제공자 기본 정보 가이드를 참조하십시오.
@@ -1403,12 +1403,12 @@ StructuredPostal.CONTENT_URI},
RawContacts.CONTENT_TYPE}, 일련의 원시 연락처에 대한 MIME 유형입니다.
- 기기의 연락처 애플리케이션의 연락처 추가 화면을 표시합니다. 개발자가
-인텐트에 추가하는 추가 사항 값이 표시됩니다.
+ 기기의 연락처 애플리케이션의 연락처 추가 화면을 표시합니다. 개발자가
+인텐트에 추가하는 추가 사항 값이 표시됩니다.
{@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()}와 함께 전송되는 경우,
-새로 추가된 원시 연락처의 콘텐츠 URI는
+새로 추가된 원시 연락처의 콘텐츠 URI는
"데이터" 필드의 {@link android.content.Intent} 인수에 있는 액티비티의 {@link android.app.Activity#onActivityResult(int, int, Intent) onActivityResult()}
-콜백 메서드로
+콜백 메서드로
다시 전달됩니다. 값을 가져오려면, {@link android.content.Intent#getData()}를 호출합니다.
@@ -1416,16 +1416,16 @@ RawContacts.CONTENT_TYPE}, 일련의 원시 연락처에 대한 MIME 유형입
연락처 편집
{@link android.content.Intent#ACTION_EDIT}
- 연락처에 대한
-{@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}입니다. 편집자 액티비티를 사용하면 사용자가 이 연락처와 관련된 데이터를 어느 것이든
+ 연락처에 대한
+{@link android.provider.ContactsContract.Contacts#CONTENT_LOOKUP_URI}입니다. 편집자 액티비티를 사용하면 사용자가 이 연락처와 관련된 데이터를 어느 것이든
편집할 수 있습니다.
{@link android.provider.ContactsContract.Contacts#CONTENT_ITEM_TYPE
Contacts.CONTENT_ITEM_TYPE}, 하나의 연락처입니다.
- 연락처 애플리케이션에 연락처 편집 화면을 표시합니다. 개발자가
-인텐트에 추가하는 추가 사항 값이 표시됩니다. 사용자가 완료를 클릭하여 편집 내용을 저장하면,
+ 연락처 애플리케이션에 연락처 편집 화면을 표시합니다. 개발자가
+인텐트에 추가하는 추가 사항 값이 표시됩니다. 사용자가 완료를 클릭하여 편집 내용을 저장하면,
액티비티가 전경으로 돌아옵니다.
@@ -1439,31 +1439,31 @@ Contacts.CONTENT_ITEM_TYPE}, 하나의 연락처입니다.
{@link android.provider.ContactsContract.Contacts#CONTENT_ITEM_TYPE}
- 이 인텐트는 항상 연락처 앱의 선택기 화면을 표시합니다. 사용자는
-편집할 연락처를 선택하거나 새 연락처를 추가할 수 있습니다. 사용자의 선택에 따라
-편집 또는 추가 화면이 나타나고 개발자가 인텐트에 전달하는 추가 사항 데이터가
-표시됩니다. 앱이 이메일이나 전화 번호 등의 연락처 데이터를 표시하는 경우,
-이 인텐트를 사용하면 사용자가 기존 연락처에 데이터를 추가할 수
+ 이 인텐트는 항상 연락처 앱의 선택기 화면을 표시합니다. 사용자는
+편집할 연락처를 선택하거나 새 연락처를 추가할 수 있습니다. 사용자의 선택에 따라
+편집 또는 추가 화면이 나타나고 개발자가 인텐트에 전달하는 추가 사항 데이터가
+표시됩니다. 앱이 이메일이나 전화 번호 등의 연락처 데이터를 표시하는 경우,
+이 인텐트를 사용하면 사용자가 기존 연락처에 데이터를 추가할 수
있습니다.
- 참고: 이 인텐트의 추가 사항에서는 이름 값을 전송하지 않아도 됩니다.
-사용자가 항상 기존의 이름을 선택하거나 새 이름을 추가하기 때문입니다. 게다가,
-개발자가 이름을 전송하고 사용자가 편집을 선택하면 연락처 앱은 개발자가 전송한 이름을 표시하면서
-이전 값을 재정의하게 됩니다. 사용자가
+ 참고: 이 인텐트의 추가 사항에서는 이름 값을 전송하지 않아도 됩니다.
+사용자가 항상 기존의 이름을 선택하거나 새 이름을 추가하기 때문입니다. 게다가,
+개발자가 이름을 전송하고 사용자가 편집을 선택하면 연락처 앱은 개발자가 전송한 이름을 표시하면서
+이전 값을 재정의하게 됩니다. 사용자가
이를 눈치채지 못하고 편집 내용을 저장하면 이전 값은 손실됩니다.
- 기기의 연락처 앱은 개발자가 인텐트로 원시 연락처 또는 그에 속한 모든 데이터를 삭제하도록
-허용하지 않습니다. 대신, 원시 연락처를 삭제하려면
-{@link android.content.ContentResolver#delete(Uri, String, String[]) ContentResolver.delete()}
+ 기기의 연락처 앱은 개발자가 인텐트로 원시 연락처 또는 그에 속한 모든 데이터를 삭제하도록
+허용하지 않습니다. 대신, 원시 연락처를 삭제하려면
+{@link android.content.ContentResolver#delete(Uri, String, String[]) ContentResolver.delete()}
또는 {@link android.content.ContentProviderOperation#newDelete(Uri)
ContentProviderOperation.newDelete()}를 사용합니다.
- 다음 조각은 새로운 원시 연락처와
+ 다음 조각은 새로운 원시 연락처와
데이터를 삽입하는 인텐트를 구성, 전송하는 방법을 나타낸 것입니다.
- 연락처 리포지토리에는 사용자 측에서 올바르고 최신일 것으로 기대하는 중요하고 민감한 데이터가 들어있으므로
-연락처 제공자는 데이터 무결성에 대한 잘 정의된 규칙이 있습니다. 개발자
-여러분에게는 연락처 데이터를 수정할 때 이와 같은 규칙을 준수할 의무가 있습니다. 아래에는 중요한 규칙을
+ 연락처 리포지토리에는 사용자 측에서 올바르고 최신일 것으로 기대하는 중요하고 민감한 데이터가 들어있으므로
+연락처 제공자는 데이터 무결성에 대한 잘 정의된 규칙이 있습니다. 개발자
+여러분에게는 연락처 데이터를 수정할 때 이와 같은 규칙을 준수할 의무가 있습니다. 아래에는 중요한 규칙을
몇 가지 나열해 놓았습니다.
- {@link android.provider.ContactsContract.RawContacts} 행을 추가할 때마다 언제나
+ {@link android.provider.ContactsContract.RawContacts} 행을 추가할 때마다 언제나
{@link android.provider.ContactsContract.CommonDataKinds.StructuredName} 행을 추가합니다.
- {@link android.provider.ContactsContract.Data} 테이블에 {@link android.provider.ContactsContract.CommonDataKinds.StructuredName} 행이 없는 {@link android.provider.ContactsContract.RawContacts} 행이 있으면
+ {@link android.provider.ContactsContract.Data} 테이블에 {@link android.provider.ContactsContract.CommonDataKinds.StructuredName} 행이 없는 {@link android.provider.ContactsContract.RawContacts} 행이 있으면
통합 과정에서
문제가 발생할 수 있습니다.
- 언제나 새로운 {@link android.provider.ContactsContract.Data} 행을
+ 언제나 새로운 {@link android.provider.ContactsContract.Data} 행을
해당 상위 {@link android.provider.ContactsContract.RawContacts} 행에 연결합니다.
- {@link android.provider.ContactsContract.RawContacts}에 연결되지 않은 {@link android.provider.ContactsContract.Data} 행은
-기기 연락처 애플리케이션에 표시되지 않고,
+ {@link android.provider.ContactsContract.RawContacts}에 연결되지 않은 {@link android.provider.ContactsContract.Data} 행은
+기기 연락처 애플리케이션에 표시되지 않고,
동기화 어댑터에서 문제를 발생시킬 수 있습니다.
개발자 본인의 소유인 원시 연락처에 대한 데이터만 변경하십시오.
- 연락처 제공자는 보통 여러 가지 서로 다른 계정 유형/온라인 서비스에서 가져온
-데이터를 관리한다는 점을 명심하십시오. 개발자의 애플리케이션은 본인에게
-속한 행에 대한 데이터만 수정 또는 삭제하도록 확실히 해두어야 하며, 데이터를 삽입할 때에도 개발자 본인이
+ 연락처 제공자는 보통 여러 가지 서로 다른 계정 유형/온라인 서비스에서 가져온
+데이터를 관리한다는 점을 명심하십시오. 개발자의 애플리케이션은 본인에게
+속한 행에 대한 데이터만 수정 또는 삭제하도록 확실히 해두어야 하며, 데이터를 삽입할 때에도 개발자 본인이
제어하는 계정 유형과 이름만 사용해야 합니다.
- 권한, 콘텐츠 URI, URI 경로, 열 이름, MIME 유형 및
-{@link android.provider.ContactsContract.CommonDataKinds.CommonColumns#TYPE} 값에 대해서는 항상
+ 권한, 콘텐츠 URI, URI 경로, 열 이름, MIME 유형 및
+{@link android.provider.ContactsContract.CommonDataKinds.CommonColumns#TYPE} 값에 대해서는 항상
{@link android.provider.ContactsContract} 및 그 하위 클래스에서 정의한 상수를 사용합니다.
- 이런 상수를 사용하면 오류를 피하는 데 도움이 됩니다. 이런 상수 중 하나라도 사용하지 않게 되는 경우 컴파일러로부터
+ 이런 상수를 사용하면 오류를 피하는 데 도움이 됩니다. 이런 상수 중 하나라도 사용하지 않게 되는 경우 컴파일러로부터
알림을 받기도 합니다.
사용자 지정 데이터 행
사용자 지정 MIME 유형을 생성하여 사용하면,
-{@link android.provider.ContactsContract.Data} 테이블에 있는 본인의 데이터 행을 삽입, 편집, 삭제 및 검색할 수 있습니다. 개발자의 행은
-{@link android.provider.ContactsContract.DataColumns}에서
-정의된 열만 사용하도록 제한되어 있습니다. 다만 나름의 유형별 열 이름을
-기본 열 이름에 매핑할 수는 있습니다. 기기의 연락처 애플리케이션에서는
-개발자의 행에 대한 데이터가 표시는 되지만 편집이나 삭제는 할 수 없고, 사용자가 추가 데이터를
-추가할 수도 없습니다. 사용자가 개발자의 사용자 지정 데이터 행을 수정하도록 허용하려면, 본인의 애플리케이션에
+{@link android.provider.ContactsContract.Data} 테이블에 있는 본인의 데이터 행을 삽입, 편집, 삭제 및 검색할 수 있습니다. 개발자의 행은
+{@link android.provider.ContactsContract.DataColumns}에서
+정의된 열만 사용하도록 제한되어 있습니다. 다만 나름의 유형별 열 이름을
+기본 열 이름에 매핑할 수는 있습니다. 기기의 연락처 애플리케이션에서는
+개발자의 행에 대한 데이터가 표시는 되지만 편집이나 삭제는 할 수 없고, 사용자가 추가 데이터를
+추가할 수도 없습니다. 사용자가 개발자의 사용자 지정 데이터 행을 수정하도록 허용하려면, 본인의 애플리케이션에
편집기 액티비티를 제공해야 합니다.
- 개발자의 사용자 지정 데이터를 표시하려면, <ContactsAccountType> 요소와 하나 이상의 <ContactsDataKind> 하위 요소를 포함하는 contacts.xml 파일을
+ 개발자의 사용자 지정 데이터를 표시하려면, <ContactsAccountType> 요소와 하나 이상의 <ContactsDataKind> 하위 요소를 포함하는 contacts.xml 파일을
제공합니다.
- 이 내용은
+ 이 내용은
<ContactsDataKind> element 섹션에 자세히 설명되어 있습니다.
- 연락처 제공자는 기기와 온라인 서비스 사이에서 연락처 데이터의 동기화를
-처리한다는 구체적인 목적을 두고 디자인된 것입니다. 이것을 사용하면 사용자가 기존의
+ 연락처 제공자는 기기와 온라인 서비스 사이에서 연락처 데이터의 동기화를
+처리한다는 구체적인 목적을 두고 디자인된 것입니다. 이것을 사용하면 사용자가 기존의
데이터를 새 기기에 다운로드할 수도 있고, 기존의 데이터를 새 계정에 업로드할 수도 있습니다.
- 동기화를 사용하면 사용자가 추가나 변경의 출처와 관계 없이 최신 데이터를
-편리하게 사용할 수 있게 보장하기도 합니다. 동기화의 또 다른 장점은
+ 동기화를 사용하면 사용자가 추가나 변경의 출처와 관계 없이 최신 데이터를
+편리하게 사용할 수 있게 보장하기도 합니다. 동기화의 또 다른 장점은
기기가 네트워크에 연결되어 있지 않더라도 연락처 데이터를 사용할 수 있다는 것입니다.
- 다양한 방식으로 동기화를 구현할 수 있지만, Android 시스템은
+ 다양한 방식으로 동기화를 구현할 수 있지만, Android 시스템은
플러그인 동기화 프레임워크를 제공하여 다음과 같은 작업들을 자동화해줍니다.
- 이 프레임워크를 사용하려면 동기화 어댑터 플러그인은 개발자가 직접 제공해야 합니다. 동기화 어댑터는
-서비스와 콘텐츠 제공자마다 각기 다르지만, 같은 서비스에 대해 여러 개의 계정 이름을 처리할 수 있습니다. 이
+ 이 프레임워크를 사용하려면 동기화 어댑터 플러그인은 개발자가 직접 제공해야 합니다. 동기화 어댑터는
+서비스와 콘텐츠 제공자마다 각기 다르지만, 같은 서비스에 대해 여러 개의 계정 이름을 처리할 수 있습니다. 이
프레임워크 또한 같은 서비스와 제공자에 대해 여러 개의 동기화 어댑터를 허용합니다.
동기화 어댑터 클래스 및 파일
- 동기화 어댑터를
-{@link android.content.AbstractThreadedSyncAdapter}의
-하위 클래스로 구현하고 이를Android 애플리케이션의 일부로 설치합니다. 시스템은 애플리케이션 매니페스트의 요소와 매니페스트가 가리키는
-특수 XML 파일에서 동기화 어댑터에 관한 정보를 얻습니다. XML 파일은
-온라인 서비스와 콘텐츠 제공자의 권한에 대한 계정 유형을 정의하고,
-이들이 함께 어댑터를 고유하게 식별합니다. 동기화 어댑터가 활성화되려면 사용자가
-동기화 어댑터의 계정 유형에 대해 계정을 추가하고 해당 동기화 어댑터와 동기화하는 콘텐츠 제공자의 동기화를
-활성화해야 합니다. 이 시점에서, 시스템이 어댑터 관리를 시작하고,
+ 동기화 어댑터를
+{@link android.content.AbstractThreadedSyncAdapter}의
+하위 클래스로 구현하고 이를Android 애플리케이션의 일부로 설치합니다. 시스템은 애플리케이션 매니페스트의 요소와 매니페스트가 가리키는
+특수 XML 파일에서 동기화 어댑터에 관한 정보를 얻습니다. XML 파일은
+온라인 서비스와 콘텐츠 제공자의 권한에 대한 계정 유형을 정의하고,
+이들이 함께 어댑터를 고유하게 식별합니다. 동기화 어댑터가 활성화되려면 사용자가
+동기화 어댑터의 계정 유형에 대해 계정을 추가하고 해당 동기화 어댑터와 동기화하는 콘텐츠 제공자의 동기화를
+활성화해야 합니다. 이 시점에서, 시스템이 어댑터 관리를 시작하고,
콘텐츠 제공자와 서버 사이에서 동기화가 필요할 때 이를 호출합니다.
- 참고: 계정 유형을 동기화 어댑터 식별의 일부로 사용하면
-시스템이 동일한 같은 조직에서 여러 서비스에 액세스하는 동기화 어댑터를
-감지하고 그룹화할 수 있습니다. 예를 들어, Google 온라인 서비스의 동기화 어댑터는 계정 유형이 모두
-com.google로 같습니다. 사용자가 기기에 Google 계정을 추가하면,
-Google 서비스에 설치된 모든 동기화 어댑터가 함께 목록으로 표시됩니다. 목록에 게재된 각 동기화는
+ 참고: 계정 유형을 동기화 어댑터 식별의 일부로 사용하면
+시스템이 동일한 같은 조직에서 여러 서비스에 액세스하는 동기화 어댑터를
+감지하고 그룹화할 수 있습니다. 예를 들어, Google 온라인 서비스의 동기화 어댑터는 계정 유형이 모두
+com.google로 같습니다. 사용자가 기기에 Google 계정을 추가하면,
+Google 서비스에 설치된 모든 동기화 어댑터가 함께 목록으로 표시됩니다. 목록에 게재된 각 동기화는
기기에서 각기 다른 콘텐츠 제공자와 동기화합니다.
- 대부분의 서비스에서는 사용자가 데이터에 액세스하기 전에
-ID를 확인해야 하기 때문에 Android에서는 동기화 어댑터 프레임워크와 비슷하면서 종종 이와 함께 쓰이기도 하는
-인증 프레임워크를 제공합니다. 인증 프레임워크는
-{@link android.accounts.AbstractAccountAuthenticator}의 하위 클래스인
-플러그인 인증자를 사용합니다. 인증자는 다음 절차에 따라
+ 대부분의 서비스에서는 사용자가 데이터에 액세스하기 전에
+ID를 확인해야 하기 때문에 Android에서는 동기화 어댑터 프레임워크와 비슷하면서 종종 이와 함께 쓰이기도 하는
+인증 프레임워크를 제공합니다. 인증 프레임워크는
+{@link android.accounts.AbstractAccountAuthenticator}의 하위 클래스인
+플러그인 인증자를 사용합니다. 인증자는 다음 절차에 따라
사용자의 ID를 확인합니다.
- 사용자 이름, 암호 또는 유사한 정보(사용자의
+ 사용자 이름, 암호 또는 유사한 정보(사용자의
자격 증명)를 수집합니다.
@@ -1695,9 +1695,9 @@ ID를 확인해야 하기 때문에 Android에서는 동기화 어댑터 프레
- 서비스가 자격 증명을 수락하면
-인증자가 자격 증명을 저장하여 나중에 사용할 수 있습니다. 플러그인 인증자 프레임워크로 인해,
-{@link android.accounts.AccountManager}는 Oauth2 authToken과 같이 인증자가 지원하고 노출하기로 선택하는 모든 authToken에 액세스를
+ 서비스가 자격 증명을 수락하면
+인증자가 자격 증명을 저장하여 나중에 사용할 수 있습니다. 플러그인 인증자 프레임워크로 인해,
+{@link android.accounts.AccountManager}는 Oauth2 authToken과 같이 인증자가 지원하고 노출하기로 선택하는 모든 authToken에 액세스를
제공합니다.
@@ -1706,18 +1706,18 @@ ID를 확인해야 하기 때문에 Android에서는 동기화 어댑터 프레
동기화 어댑터 구현
- 연락처 제공자에 대한 동기화 어댑터를 구현하려면,
+ 연락처 제공자에 대한 동기화 어댑터를 구현하려면,
다음이 들어있는 Android 애플리케이션을 생성하는 것으로 시작합니다.
- 시스템의 요청에 응답하여 동기화 어댑터에 바인딩하는 {@link android.app.Service}
+ 시스템의 요청에 응답하여 동기화 어댑터에 바인딩하는 {@link android.app.Service}
구성 요소.
- 시스템이 동기화를 실행하고자 하는 경우, 이는
+ 시스템이 동기화를 실행하고자 하는 경우, 이는
서비스의 {@link android.app.Service#onBind(Intent) onBind()} 메서드를 호출하여
-동기화 어댑터의 {@link android.os.IBinder}를 가져옵니다. 이렇게 하면 시스템이 어댑터의
+동기화 어댑터의 {@link android.os.IBinder}를 가져옵니다. 이렇게 하면 시스템이 어댑터의
메서드에 대해 프로세스간 호출을 수행할 수 있습니다.
- {@link android.content.AbstractThreadedSyncAdapter}의
+ {@link android.content.AbstractThreadedSyncAdapter}의
하위 클래스로 구현된 실제 동기화 어댑터.
- 이 클래스는 서버에서 데이터를 다운로드하고, 기기에서 데이터를 업로드하고,
-충돌을 해결하는 작업을 수행합니다. 어댑터의 주요 작업은
+ 이 클래스는 서버에서 데이터를 다운로드하고, 기기에서 데이터를 업로드하고,
+충돌을 해결하는 작업을 수행합니다. 어댑터의 주요 작업은
{@link android.content.AbstractThreadedSyncAdapter#onPerformSync(
Account, Bundle, String, ContentProviderClient, SyncResult)
onPerformSync()} 메서드에서 실행합니다. 이 클래스는 반드시 단일 항목으로 인스턴트화해야 합니다.
@@ -1745,23 +1745,23 @@ onPerformSync()} 메서드에서 실행합니다. 이 클래스는 반드시 단
{@link android.app.Application}의 하위 클래스.
- 이 클래스는 동기화 어댑터 단일 항목의 팩터리 역할을 합니다.
-{@link android.app.Application#onCreate()} 메서드는
-동기화 어댑터를 인스턴트화하고, 단일 항목을 동기화 어댑터 서비스의
-{@link android.app.Service#onBind(Intent) onBind()} 메서드에 반환할 정적 "getter" 메서드를 제공하는 데
+ 이 클래스는 동기화 어댑터 단일 항목의 팩터리 역할을 합니다.
+{@link android.app.Application#onCreate()} 메서드는
+동기화 어댑터를 인스턴트화하고, 단일 항목을 동기화 어댑터 서비스의
+{@link android.app.Service#onBind(Intent) onBind()} 메서드에 반환할 정적 "getter" 메서드를 제공하는 데
사용하십시오.
- 선택 항목: 사용자 인증에 대한 시스템으로부터의 요청에 응답하는 {@link android.app.Service}
+ 선택 항목: 사용자 인증에 대한 시스템으로부터의 요청에 응답하는 {@link android.app.Service}
구성 요소.
- {@link android.accounts.AccountManager}가 이 서비스를 시작하여 인증
-절차를 시작합니다. 서비스의 {@link android.app.Service#onCreate()} 메서드가
-인증자 객체를 인스턴트화합니다. 시스템이 애플리케이션 동기화 어댑터의 사용자 계정을 인증하고자 하는 경우,
-시스템은 서비스의
-{@link android.app.Service#onBind(Intent) onBind()} 메서드를 호출하여
-인증자의 {@link android.os.IBinder}를 가져옵니다. 이렇게 하면 시스템이 인증자의
+ {@link android.accounts.AccountManager}가 이 서비스를 시작하여 인증
+절차를 시작합니다. 서비스의 {@link android.app.Service#onCreate()} 메서드가
+인증자 객체를 인스턴트화합니다. 시스템이 애플리케이션 동기화 어댑터의 사용자 계정을 인증하고자 하는 경우,
+시스템은 서비스의
+{@link android.app.Service#onBind(Intent) onBind()} 메서드를 호출하여
+인증자의 {@link android.os.IBinder}를 가져옵니다. 이렇게 하면 시스템이 인증자의
메서드에 대해 프로세스간 호출을 수행할 수 있습니다.
- 선택 항목: 인증에 대한 요청을 처리하는
-{@link android.accounts.AbstractAccountAuthenticator}의 구체적인
+ 선택 항목: 인증에 대한 요청을 처리하는
+{@link android.accounts.AbstractAccountAuthenticator}의 구체적인
하위 클래스.
- 이 클래스는 {@link android.accounts.AccountManager}가
-서버로 사용자 자격 증명 인증을 호출하는 메서드를 제공합니다. 인증 절차의 세부 사항은
-사용하는 서버 기술에 따라 매우 차이가 있습니다. 인증에 대한
+ 이 클래스는 {@link android.accounts.AccountManager}가
+서버로 사용자 자격 증명 인증을 호출하는 메서드를 제공합니다. 인증 절차의 세부 사항은
+사용하는 서버 기술에 따라 매우 차이가 있습니다. 인증에 대한
자세한 정보는 각자의 서버 소프트웨어에 해당되는 관련 문서를 참조하십시오.
@@ -1789,31 +1789,31 @@ onPerformSync()} 메서드에서 실행합니다. 이 클래스는 반드시 단
동기화 어댑터와 서버의 인증자를 정의하는 XML 파일.
- 이전에 설명한 동기화 어댑터와 인증자 서비스 구성 요소는
-애플리케이션 매니페스트의
-<service> 요소에서
-정의합니다. 이런 요소에는
-시스템에 특정 데이터를 제공하는
+ 이전에 설명한 동기화 어댑터와 인증자 서비스 구성 요소는
+애플리케이션 매니페스트의
+<service> 요소에서
+정의합니다. 이런 요소에는
+시스템에 특정 데이터를 제공하는
<meta-data>
-하위 요소가
+하위 요소가
들어있습니다.
- 동기화 어댑터 서비스에 대한
+ 동기화 어댑터 서비스에 대한
<meta-data>
-요소는
-XML 파일 res/xml/syncadapter.xml을 가리킵니다. 그런가 하면
-이 파일은 연락처 제공자와 동기화될 웹 서비스에 대한 URI와 웹 서비스에 대한 계정 유형을
+요소는
+XML 파일 res/xml/syncadapter.xml을 가리킵니다. 그런가 하면
+이 파일은 연락처 제공자와 동기화될 웹 서비스에 대한 URI와 웹 서비스에 대한 계정 유형을
나타냅니다.
- 선택 항목: 인증자의
+ 선택 항목: 인증자의
<meta-data>
-요소는 XML 파일
-res/xml/authenticator.xml을 가리킵니다. 이 파일은 다시
-이 인증이 지원하는 계정 유형과, 인증 과정 중에 표시되는 UI 리소스를
-나타냅니다. 이 요소에서 지정한 계정 유형은 반드시
-동기화 어댑터에 대해 지정된 계정 유형과
+요소는 XML 파일
+res/xml/authenticator.xml을 가리킵니다. 이 파일은 다시
+이 인증이 지원하는 계정 유형과, 인증 과정 중에 표시되는 UI 리소스를
+나타냅니다. 이 요소에서 지정한 계정 유형은 반드시
+동기화 어댑터에 대해 지정된 계정 유형과
같아야 합니다.
@@ -1821,18 +1821,18 @@ XML 파일 res/xml/syncadapter.xml을 가리킵니다. 그런가
소셜 스트림 데이터
- {@code android.provider.ContactsContract.StreamItems}와
-{@code android.provider.ContactsContract.StreamItemPhotos} 테이블은
-소셜 네트워크에서 수신하는 데이터를 관리합니다. 개발자는 본인의 네트워크의 스트림 데이터를 이 테이블에 추가하는
-동기화 어댑터를 작성할 수도 있고, 이 테이블에서 스트림 데이터를 읽어서
-본인의 애플리케이션에 표시할 수도 있으며 두 가지를 모두 해도 됩니다. 이 기능을 사용하면 소셜 네트워킹
+ {@code android.provider.ContactsContract.StreamItems}와
+{@code android.provider.ContactsContract.StreamItemPhotos} 테이블은
+소셜 네트워크에서 수신하는 데이터를 관리합니다. 개발자는 본인의 네트워크의 스트림 데이터를 이 테이블에 추가하는
+동기화 어댑터를 작성할 수도 있고, 이 테이블에서 스트림 데이터를 읽어서
+본인의 애플리케이션에 표시할 수도 있으며 두 가지를 모두 해도 됩니다. 이 기능을 사용하면 소셜 네트워킹
서비스와 애플리케이션을 Android의 소셜 네트워킹 환경에 통합할 수 있습니다.
소셜 스트림 텍스트
- 스트림 항목은 항상 원시 연락처와 연관됩니다.
-{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}는
-원시 연락처의 _ID 값과 연관됩니다. 원시 연락처의 계정 유형과 계정 이름도
+ 스트림 항목은 항상 원시 연락처와 연관됩니다.
+{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}는
+원시 연락처의 _ID 값과 연관됩니다. 원시 연락처의 계정 유형과 계정 이름도
스트림 항목 행에 저장됩니다.
@@ -1843,36 +1843,36 @@ XML 파일 res/xml/syncadapter.xml을 가리킵니다. 그런가
{@code android.provider.ContactsContract.StreamItemsColumns#ACCOUNT_TYPE}
- 필수입니다. 이 스트림 항목과 연관된 원시 연락처에 대한
+ 필수입니다. 이 스트림 항목과 연관된 원시 연락처에 대한
사용자 계정입니다. 스트림 항목을 삽입할 때 이 값을 설정하는 것을 잊지 마십시오.
- 필수입니다. 이 스트림 항목과 연관된 원시 연락처에 대한
+ 필수입니다. 이 스트림 항목과 연관된 원시 연락처에 대한
사용자 계정 이름입니다. 스트림 항목을 삽입할 때 이 값을 설정하는 것을 잊지 마십시오.
식별자 열
- 필수입니다. 스트림 항목을 삽입할 때
+ 필수입니다. 스트림 항목을 삽입할 때
다음 식별자 열을 삽입해야 합니다.
- {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: 이
-스트림 항목과 연관된 연락처의 {@code android.provider.BaseColumns#_ID}
+ {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_ID}: 이
+스트림 항목과 연관된 연락처의 {@code android.provider.BaseColumns#_ID}
값입니다.
- {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: 이
-스트림 항목과 연관된 연락처의 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}
+ {@code android.provider.ContactsContract.StreamItemsColumns#CONTACT_LOOKUP_KEY}: 이
+스트림 항목과 연관된 연락처의 {@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}
값입니다.
- {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: 이
-스트림 항목과 연관된 원시 연락처의 {@code android.provider.BaseColumns#_ID}
+ {@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID}: 이
+스트림 항목과 연관된 원시 연락처의 {@code android.provider.BaseColumns#_ID}
값입니다.
@@ -1887,19 +1887,19 @@ XML 파일 res/xml/syncadapter.xml을 가리킵니다. 그런가
{@code android.provider.ContactsContract.StreamItemsColumns#TEXT}
- 스트림 항목의 텍스트로, 항목의 소스가 게시한 콘텐츠 또는
-스트림 항목을 생성하는 작업의 설명 중 하나입니다. 이 열에는
-{@link android.text.Html#fromHtml(String) fromHtml()}가 렌더링할 수 있는 모든 서식과 포함된 리소스 이미지가
-들어있을 수 있습니다. 제공자는 긴 콘텐츠를
+ 스트림 항목의 텍스트로, 항목의 소스가 게시한 콘텐츠 또는
+스트림 항목을 생성하는 작업의 설명 중 하나입니다. 이 열에는
+{@link android.text.Html#fromHtml(String) fromHtml()}가 렌더링할 수 있는 모든 서식과 포함된 리소스 이미지가
+들어있을 수 있습니다. 제공자는 긴 콘텐츠를
자르거나 생략할 수 있지만, 가능하면 태그를 손상시키는 것은 피하려 듭니다.
- 스트림 항목이 삽입되거나 업데이트된 시간이 들어있는 텍스트 문자열로, 형식은
-epoch 이후 밀리초 형태를 취합니다. 이 열을 관리할 책임은
-스트림 항목을 삽입 또는 업데이트하는 애플리케이션에 있으며, 이것은 연락처 제공자가 자동으로
+ 스트림 항목이 삽입되거나 업데이트된 시간이 들어있는 텍스트 문자열로, 형식은
+epoch 이후 밀리초 형태를 취합니다. 이 열을 관리할 책임은
+스트림 항목을 삽입 또는 업데이트하는 애플리케이션에 있으며, 이것은 연락처 제공자가 자동으로
유지 관리하지 않습니다.
@@ -1911,18 +1911,18 @@ epoch 이후 밀리초 형태를 취합니다. 이 열을 관리할 책
리소스를 연결하십시오.
- {@code android.provider.ContactsContract.StreamItemPhotos} 테이블은 스트림 항목과 연관된
-사진을 저장합니다. 테이블의
+ {@code android.provider.ContactsContract.StreamItemPhotos} 테이블은 스트림 항목과 연관된
+사진을 저장합니다. 테이블의
{@code android.provider.ContactsContract.StreamItemPhotosColumns#STREAM_ITEM_ID} 열은
-{@code android.provider.ContactsContract.StreamItems} 테이블의 {@code android.provider.BaseColumns#_ID} 열에 있는 값과
-연결됩니다. 사진 참조는
+{@code android.provider.ContactsContract.StreamItems} 테이블의 {@code android.provider.BaseColumns#_ID} 열에 있는 값과
+연결됩니다. 사진 참조는
다음 열의 테이블에 저장됩니다.
@@ -1931,21 +1931,21 @@ epoch 이후 밀리초 형태를 취합니다. 이 열을 관리할 책
사진의 바이너리 표현으로, 제공자가 저장하고 표시하기 위해 크기를 조정한 것입니다.
- 이 열은 사진을 저장하는 데 사용한 연락처 제공자의 이전 버전과
-호환됩니다. 그러나 현재 버전에서는
-이 열을 사진 저장에 사용하면 안 됩니다. 대신,
-{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 또는
+ 이 열은 사진을 저장하는 데 사용한 연락처 제공자의 이전 버전과
+호환됩니다. 그러나 현재 버전에서는
+이 열을 사진 저장에 사용하면 안 됩니다. 대신,
+{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} 또는
{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI}(
-다음 항목에서 두 가지 모두 설명)를 사용하여 사진을 파일로 저장합니다. 지금 이 열에는
+다음 항목에서 두 가지 모두 설명)를 사용하여 사진을 파일로 저장합니다. 지금 이 열에는
사진의 미리 보기가 들어있어 읽기 작업에 사용할 수 있습니다.
- 원시 연락처에 대한 사진의 숫자 식별자입니다. 이 값을
-상수 {@link android.provider.ContactsContract.DisplayPhoto#CONTENT_URI DisplayPhoto.CONTENT_URI}에 추가하여
-하나의 사진 파일을 가리키는 콘텐츠 URI를 가져온 다음,
+ 원시 연락처에 대한 사진의 숫자 식별자입니다. 이 값을
+상수 {@link android.provider.ContactsContract.DisplayPhoto#CONTENT_URI DisplayPhoto.CONTENT_URI}에 추가하여
+하나의 사진 파일을 가리키는 콘텐츠 URI를 가져온 다음,
{@link android.content.ContentResolver#openAssetFileDescriptor(Uri, String)
openAssetFileDescriptor()}를 호출하여 사진 파일에 대한 핸들을 가져옵니다.
@@ -1965,91 +1965,91 @@ openAssetFileDescriptor()}를 호출하면 사진 파일에 대한 핸들을 가
이 테이블에는 추가 액세스 권한이 필요합니다. 여기서 읽기 작업을 수행하려면 애플리케이션에
-{@code android.Manifest.permission#READ_SOCIAL_STREAM} 권한이 있어야 합니다. 여기서 수정 작업을 수행하려면
+{@code android.Manifest.permission#READ_SOCIAL_STREAM} 권한이 있어야 합니다. 여기서 수정 작업을 수행하려면
애플리케이션에
{@code android.Manifest.permission#WRITE_SOCIAL_STREAM} 권한이 있어야 합니다.
- {@code android.provider.ContactsContract.StreamItems} 테이블의 경우, 각 원시 연락처에 저장되는
-행 개수가 제한되어 있습니다. 이 한계에 도달하면,
+ {@code android.provider.ContactsContract.StreamItems} 테이블의 경우, 각 원시 연락처에 저장되는
+행 개수가 제한되어 있습니다. 이 한계에 도달하면,
연락처 제공자가 새 스트림 항목 열에 필요한 공간을 만들어야 합니다.
-이때 가장 오래된 {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}가
-있는 행부터 자동으로 삭제하는 방법을 씁니다. 이 한계를
-가져오려면, 콘텐츠 URI
-{@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}에 쿼리를 발행합니다. 콘텐츠
-URI를 뺀 나머지 모든 인수는 null로 설정한 채 두면 됩니다. 이 쿼리는
-행이 하나 들어 있는 커서를 반환하며,
+이때 가장 오래된 {@code android.provider.ContactsContract.StreamItemsColumns#TIMESTAMP}가
+있는 행부터 자동으로 삭제하는 방법을 씁니다. 이 한계를
+가져오려면, 콘텐츠 URI
+{@code android.provider.ContactsContract.StreamItems#CONTENT_LIMIT_URI}에 쿼리를 발행합니다. 콘텐츠
+URI를 뺀 나머지 모든 인수는 null로 설정한 채 두면 됩니다. 이 쿼리는
+행이 하나 들어 있는 커서를 반환하며,
{@code android.provider.ContactsContract.StreamItems#MAX_ITEMS} 열 하나가 수반됩니다.
- {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} 클래스는
-스트림 항목 하나의 사진 행을 포함하는 {@code android.provider.ContactsContract.StreamItemPhotos}의
+ {@code android.provider.ContactsContract.StreamItems.StreamItemPhotos} 클래스는
+스트림 항목 하나의 사진 행을 포함하는 {@code android.provider.ContactsContract.StreamItemPhotos}의
하위 테이블을 정의합니다.
소셜 스트림 상호 작용
- 연락처 제공자가 기기 연락처 애플리케이션과 함께 관리하는 소셜 스트림 데이터는
-소셜 네트워킹 시스템과
+ 연락처 제공자가 기기 연락처 애플리케이션과 함께 관리하는 소셜 스트림 데이터는
+소셜 네트워킹 시스템과
기존 연락처를 연결하는 강력한 방법을 제공합니다. 사용할 수 있는 기능은 다음과 같습니다.
- 소셜 네트워킹 서비스를 동기화 어댑터로 연락처 제공자에 동기화함으로써,
-사용자 연락처의 최근 활동을 검색하고 이를
-{@code android.provider.ContactsContract.StreamItems} 및
+ 소셜 네트워킹 서비스를 동기화 어댑터로 연락처 제공자에 동기화함으로써,
+사용자 연락처의 최근 활동을 검색하고 이를
+{@code android.provider.ContactsContract.StreamItems} 및
{@code android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장해 두어 나중에 사용할 수 있습니다.
- 정기 동기화 외에도 사용자가 볼 연락처를 선택하면 동기화 어댑터를 트리거하여
-추가 데이터를 검색하게 할 수 있습니다. 이렇게 하면 동기화 어댑터가
+ 정기 동기화 외에도 사용자가 볼 연락처를 선택하면 동기화 어댑터를 트리거하여
+추가 데이터를 검색하게 할 수 있습니다. 이렇게 하면 동기화 어댑터가
해당 연락처의 고해상도 사진과 가장 최근 스트림 항목을 검색할 수 있습니다.
- 기기 연락처 애플리케이션과 연락처 제공자에 알림을 등록하면,
-연락처가 열람될 때 인텐트를 수신하고,
-그 시점에 개발자의 서비스로부터 연락처의 상태를 업데이트할 수 있습니다. 이 방법을 사용하면 동기화 어댑터로
+ 기기 연락처 애플리케이션과 연락처 제공자에 알림을 등록하면,
+연락처가 열람될 때 인텐트를 수신하고,
+그 시점에 개발자의 서비스로부터 연락처의 상태를 업데이트할 수 있습니다. 이 방법을 사용하면 동기화 어댑터로
완전 동기화를 수행하는 것보다 빠르고 대역폭도 적게 사용합니다.
- 사용자는 기기의 연락처 애플리케이션을 보면서 여러분의 소셜 네트워킹 서비스에
-연락처를 추가할 수 있습니다. 이는 "연락처 초대" 기능으로 사용할 수 있습니다.
-연락처 초대 기능은 기존 연락처를 네트워크에 추가하는 액티비티와
-기기의 연락처 애플리케이션을 제공하는 XML 파일,
+ 사용자는 기기의 연락처 애플리케이션을 보면서 여러분의 소셜 네트워킹 서비스에
+연락처를 추가할 수 있습니다. 이는 "연락처 초대" 기능으로 사용할 수 있습니다.
+연락처 초대 기능은 기존 연락처를 네트워크에 추가하는 액티비티와
+기기의 연락처 애플리케이션을 제공하는 XML 파일,
애플리케이션의 세부 정보가 포함된 연락처 제공자를 조합하여 활성화합니다.
- 연락처 제공자로 스트림 항목을 정기 동기화하는 방법은
-다른 동기화와 같습니다. 동기화에 관한 자세한 내용은
-연락처 제공자 동기화 어댑터 섹션을 참조하십시오. 알림을 등록하고 연락처를 초대하는 방법은
+ 연락처 제공자로 스트림 항목을 정기 동기화하는 방법은
+다른 동기화와 같습니다. 동기화에 관한 자세한 내용은
+연락처 제공자 동기화 어댑터 섹션을 참조하십시오. 알림을 등록하고 연락처를 초대하는 방법은
다음 두 섹션에서 다룰 것입니다.
소셜 네트워킹 보기를 처리하기 위한 등록
- 동기화 어댑터를 등록하여 사용자가 동기화 어댑터에서 관리하는 연락처를 볼 때 알림을
+ 동기화 어댑터를 등록하여 사용자가 동기화 어댑터에서 관리하는 연락처를 볼 때 알림을
수신하는 방법:
- 프로젝트의 res/xml/ 디렉터리에 contacts.xml 파일을
+ 프로젝트의 res/xml/ 디렉터리에 contacts.xml 파일을
만듭니다. 이미 이 파일이 있다면 이 절차를 건너뛰어도 됩니다.
- 이 파일에서,
+ 이 파일에서,
<ContactsAccountType xmlns:android="http://schemas.android.com/apk/res/android"> 요소를 추가합니다.
이 요소가 이미 존재한다면 이 절차를 건너뛰어도 됩니다.
- 사용자가 기기의 연락처 애플리케이션에서
+ 사용자가 기기의 연락처 애플리케이션에서
연락처 세부 정보 페이지를 열면 알림을 보내는 서비스를 등록하려면,
-viewContactNotifyService="serviceclass" 속성을 요소에 추가합니다.
-이 요소에서 serviceclass는 기기의 연락처 애플리케이션에서 인텐트를 수신하는 서비스의
-완전히 정규화된 클래스 이름입니다. 알림 서비스의 경우,
-{@link android.app.IntentService}를 확장하는 클래스를 사용하여 서비스가 인텐트를 수신하도록
-허용합니다. 수신되는 인텐트의 데이터에는
-사용자가 클릭한 원시 연락처의 콘텐츠 URI가 들어있습니다. 알림 서비스에서 동기화 어댑터에 바인딩한 다음 동기화 어댑터를 호출하여
+viewContactNotifyService="serviceclass" 속성을 요소에 추가합니다.
+이 요소에서 serviceclass는 기기의 연락처 애플리케이션에서 인텐트를 수신하는 서비스의
+완전히 정규화된 클래스 이름입니다. 알림 서비스의 경우,
+{@link android.app.IntentService}를 확장하는 클래스를 사용하여 서비스가 인텐트를 수신하도록
+허용합니다. 수신되는 인텐트의 데이터에는
+사용자가 클릭한 원시 연락처의 콘텐츠 URI가 들어있습니다. 알림 서비스에서 동기화 어댑터에 바인딩한 다음 동기화 어댑터를 호출하여
원시 연락처의 데이터를 업데이트할 수 있습니다.
@@ -2058,31 +2058,31 @@ URI를 뺀 나머지 모든 인수는 null로 설정한 채 두면
- 프로젝트의 res/xml/ 디렉터리에 contacts.xml 파일을
+ 프로젝트의 res/xml/ 디렉터리에 contacts.xml 파일을
만듭니다. 이미 이 파일이 있다면 이 절차를 건너뛰어도 됩니다.
- 이 파일에서,
+ 이 파일에서,
<ContactsAccountType xmlns:android="http://schemas.android.com/apk/res/android"> 요소를 추가합니다.
이 요소가 이미 존재한다면 이 절차를 건너뛰어도 됩니다.
- 사용자가 기기의 연락처 애플리케이션에서 스트림 항목을 클릭했을 때
-처리할 액티비티를 등록하려면,
-viewStreamItemActivity="activityclass" 속성을 요소에 추가합니다.
-이 요소에서 activityclass는 기기의 연락처 애플리케이션에서 인텐트를 수신하는 액티비티의
+ 사용자가 기기의 연락처 애플리케이션에서 스트림 항목을 클릭했을 때
+처리할 액티비티를 등록하려면,
+viewStreamItemActivity="activityclass" 속성을 요소에 추가합니다.
+이 요소에서 activityclass는 기기의 연락처 애플리케이션에서 인텐트를 수신하는 액티비티의
완전히 정규화된 클래스 이름입니다.
- 사용자가 기기의 연락처 애플리케이션에서 스트림 사진을 클릭했을 때
+ 사용자가 기기의 연락처 애플리케이션에서 스트림 사진을 클릭했을 때
처리할 액티비티를 등록하려면,
viewStreamItemPhotoActivity="activityclass" 속성을 요소에 추가합니다.
-이 요소에서 activityclass는 기기의 연락처 애플리케이션에서 인텐트를 수신하는 액티비티의
+이 요소에서 activityclass는 기기의 연락처 애플리케이션에서 인텐트를 수신하는 액티비티의
완전히 정규화된 클래스 이름입니다.
- <ContactsAccountType> 요소는
+ <ContactsAccountType> 요소는
<ContactsAccountType> 요소 섹션에 자세히 설명되어 있습니다.
@@ -2091,17 +2091,17 @@ URI를 뺀 나머지 모든 인수는 null로 설정한 채 두면
소셜 네트워킹 서비스로 상호 작용
- 사용자는 소셜 네트워킹 사이트에 연락처를 초대할 때
-기기의 연락처 애플리케이션을 떠나지 않아도 됩니다. 대신, 개발자가 기기의 연락처 앱에 액티비티 중 하나로 연락처를 초대하는 인텐트를
+ 사용자는 소셜 네트워킹 사이트에 연락처를 초대할 때
+기기의 연락처 애플리케이션을 떠나지 않아도 됩니다. 대신, 개발자가 기기의 연락처 앱에 액티비티 중 하나로 연락처를 초대하는 인텐트를
보내게 할 수 있습니다. 이렇게 설정하는 방법은 다음과 같습니다.
- 프로젝트의 res/xml/ 디렉터리에 contacts.xml 파일을
+ 프로젝트의 res/xml/ 디렉터리에 contacts.xml 파일을
만듭니다. 이미 이 파일이 있다면 이 절차를 건너뛰어도 됩니다.
- 이 파일에서,
+ 이 파일에서,
<ContactsAccountType xmlns:android="http://schemas.android.com/apk/res/android"> 요소를 추가합니다.
이 요소가 이미 존재한다면 이 절차를 건너뛰어도 됩니다.
@@ -2113,25 +2113,25 @@ URI를 뺀 나머지 모든 인수는 null로 설정한 채 두면
inviteContactActionLabel="@string/invite_action_label"
- activityclass 값은 인텐트를 수신해야 하는 액티비티의
+ activityclass 값은 인텐트를 수신해야 하는 액티비티의
완전히 정규화된 클래스 이름입니다. invite_action_label
-값은 기기의 연락처 애플리케이션에 있는 연결 추가 메뉴에
+값은 기기의 연락처 애플리케이션에 있는 연결 추가 메뉴에
표시되는 텍스트 문자열입니다.
- 참고:ContactsSource는
+ 참고:ContactsSource는
ContactsAccountType에 대하여 이제 사용하지 않는 태그 이름입니다.
contacts.xml 참조
- contacts.xml 파일에는 XML 요소가 들어있어 개발자의 동기화 어댑터와
-애플리케이션, 연락처 애플리케이션과 연락처 제공자 사이의 상호 작용을 제어합니다. 이런
+ contacts.xml 파일에는 XML 요소가 들어있어 개발자의 동기화 어댑터와
+애플리케이션, 연락처 애플리케이션과 연락처 제공자 사이의 상호 작용을 제어합니다. 이런
요소는 다음 섹션에 설명되어 있습니다.
<ContactsAccountType> 요소
- <ContactsAccountType>요 요소는 개발자의 애플리케이션과
+ <ContactsAccountType>요 요소는 개발자의 애플리케이션과
연락처 애플리케이션 사이의 상호 작용을 제어합니다. 이 요소에는 다음 구문이 있습니다.
@@ -2161,12 +2161,12 @@ URI를 뺀 나머지 모든 인수는 null로 설정한 채 두면
설명:
- 사용자가 연락처 중 하나를 소셜 네트워크에 초대하고,
-소셜 네트워킹 스트림이 업데이트되면 사용자에게 알리는 등의 작업을 허용하는
+ 사용자가 연락처 중 하나를 소셜 네트워크에 초대하고,
+소셜 네트워킹 스트림이 업데이트되면 사용자에게 알리는 등의 작업을 허용하는
Android 구성 요소와 UI 레이블을 선언합니다.
- 속성 접두사 android:는
+ 속성 접두사 android:는
<ContactsAccountType>의 속성에는 필요하지 않다는 점을 눈여겨보십시오.
@@ -2175,48 +2175,48 @@ Android 구성 요소와 UI 레이블을 선언합니다.
{@code inviteContactActivity}
- 사용자가 기기의 연락처 애플리케이션에서
-연결 추가를 선택했을 때 활성화하고자 하는
+ 사용자가 기기의 연락처 애플리케이션에서
+연결 추가를 선택했을 때 활성화하고자 하는
애플리케이션 액티비티의 완전히 정규화된 클래스 이름입니다.
{@code inviteContactActionLabel}
- 연결 추가 메뉴의
+ 연결 추가 메뉴의
{@code inviteContactActivity}에서 지정된 액티비티에 대해 표시되는 텍스트 문자열입니다.
- 예를 들어, 문자열 "제 네트워크를 팔로우하세요"를 사용할 수 있습니다. 이 레이블에 대한 문자열 리소스
+ 예를 들어, 문자열 "제 네트워크를 팔로우하세요"를 사용할 수 있습니다. 이 레이블에 대한 문자열 리소스
식별자를 사용할 수 있습니다.
{@code viewContactNotifyService}
- 사용자가 연락처를 볼 때 알림을 수신해야 하는
-애플리케이션 서비스의 완전히 정규화된 클래스 이름입니다. 이 알림은
-기기의 연락처 애플리케이션이 전송합니다. 이것을 사용하면 개발자의 애플리케이션이 데이터 집약적인 작업을 필요할 때까지
-연기할 수 있습니다. 예를 들어, 개발자의 애플리케이션은
-연락처의 고해상도 사진과 가장 최근 소셜 스트림 항목을 읽어서 표시함으로써
-이 알림에 응답할 수 있습니다. 이 기능은
-소셜 스트림 상호 작용에 상세히 설명되어 있습니다. 알림 서비스의 예시를
+ 사용자가 연락처를 볼 때 알림을 수신해야 하는
+애플리케이션 서비스의 완전히 정규화된 클래스 이름입니다. 이 알림은
+기기의 연락처 애플리케이션이 전송합니다. 이것을 사용하면 개발자의 애플리케이션이 데이터 집약적인 작업을 필요할 때까지
+연기할 수 있습니다. 예를 들어, 개발자의 애플리케이션은
+연락처의 고해상도 사진과 가장 최근 소셜 스트림 항목을 읽어서 표시함으로써
+이 알림에 응답할 수 있습니다. 이 기능은
+소셜 스트림 상호 작용에 상세히 설명되어 있습니다. 알림 서비스의 예시를
보려면 SampleSyncAdapter
- 샘플 앱에 있는 NotifierService.java 파일을
+ 샘플 앱에 있는 NotifierService.java 파일을
확인합니다.
{@code viewGroupActivity}
- 그룹 정보를 표시할 수 있는 애플리케이션 액티비티의
-완전히 정규화된 클래스 이름입니다. 사용자가 기기의 연락처 애플리케이션에서 그룹 레이블을 클릭하면,
+ 그룹 정보를 표시할 수 있는 애플리케이션 액티비티의
+완전히 정규화된 클래스 이름입니다. 사용자가 기기의 연락처 애플리케이션에서 그룹 레이블을 클릭하면,
이 액티비티의 UI가 표시됩니다.
{@code viewGroupActionLabel}
- 사용자가 개발자의 애플리케이션에서 그룹을 살펴볼 수 있도록 해주는 UI 제어에 대해
+ 사용자가 개발자의 애플리케이션에서 그룹을 살펴볼 수 있도록 해주는 UI 제어에 대해
연락처 애플리케이션이 표시하는 레이블입니다.
- 예를 들어, 기기에 Google+ 애플리케이션을 설치하고
-Google+를 연락처 애플리케이션과 동기화하면, Google+ 서클이
-연락처 애플리케이션의 그룹 탭에 표시되는 것을 볼 수 있습니다. Google+ 서클을
-클릭하면 해당 서클에서 "그룹"으로 표시된 사람들을 볼 수 있습니다. 이 표시의 맨 위에
-Google+ 아이콘이 표시되며, 이것을 클릭하면 제어가
-Google+ 앱으로 전환됩니다. 연락처 애플리케이션은 이 작업을
-{@code viewGroupActivity}로 수행하며, Google+ 아이콘을
+ 예를 들어, 기기에 Google+ 애플리케이션을 설치하고
+Google+를 연락처 애플리케이션과 동기화하면, Google+ 서클이
+연락처 애플리케이션의 그룹 탭에 표시되는 것을 볼 수 있습니다. Google+ 서클을
+클릭하면 해당 서클에서 "그룹"으로 표시된 사람들을 볼 수 있습니다. 이 표시의 맨 위에
+Google+ 아이콘이 표시되며, 이것을 클릭하면 제어가
+Google+ 앱으로 전환됩니다. 연락처 애플리케이션은 이 작업을
+{@code viewGroupActivity}로 수행하며, Google+ 아이콘을
{@code viewGroupActionLabel}의 값으로 사용합니다.
@@ -2225,19 +2225,19 @@ Google+ 앱으로 전환됩니다. 연락처 애플리케이션은 이 작업을
{@code viewStreamItemActivity}
- 사용자가 원시 연락처의 스트림 항목을 클릭할 때 기기의 연락처 애플리케이션이 시작하는
+ 사용자가 원시 연락처의 스트림 항목을 클릭할 때 기기의 연락처 애플리케이션이 시작하는
애플리케이션 액티비티의 완전히 정규화된 클래스 이름입니다.
{@code viewStreamItemPhotoActivity}
- 사용자가 원시 연락처 스트림 항목의 사진을 클릭할 때
-기기의 연락처 애플리케이션이 시작하는 애플리케이션 액티비티의
+ 사용자가 원시 연락처 스트림 항목의 사진을 클릭할 때
+기기의 연락처 애플리케이션이 시작하는 애플리케이션 액티비티의
완전히 정규화된 클래스 이름입니다.
<ContactsDataKind> 요소
- <ContactsDataKind> 요소는 연락처 애플리케이션 UI에서 애플리케이션의 사용자 지정 데이터 행 표시를
+ <ContactsDataKind> 요소는 연락처 애플리케이션 UI에서 애플리케이션의 사용자 지정 데이터 행 표시를
제어합니다. 이 요소에는 다음 구문이 있습니다.
@@ -2255,11 +2255,11 @@ Google+ 앱으로 전환됩니다. 연락처 애플리케이션은 이 작업을
설명:
- 이 요소를 사용하여 연락처 애플리케이션이 사용자 지정 데이터 행의 콘텐츠를
-원시 연락처 세부 정보의 일부로 표시하게 합니다. <ContactsAccountType>의 각 <ContactsDataKind> 하위 요소는
-동기화 어댑터가 {@link android.provider.ContactsContract.Data}에 추가하는
-사용자 지정 데이터 행의 유형을 나타냅니다. 개발자가 사용하는 사용자 지정 MIME 유형 하나마다
-<ContactsDataKind> 요소를 하나씩 추가합니다. 데이터를
+ 이 요소를 사용하여 연락처 애플리케이션이 사용자 지정 데이터 행의 콘텐츠를
+원시 연락처 세부 정보의 일부로 표시하게 합니다. <ContactsAccountType>의 각 <ContactsDataKind> 하위 요소는
+동기화 어댑터가 {@link android.provider.ContactsContract.Data}에 추가하는
+사용자 지정 데이터 행의 유형을 나타냅니다. 개발자가 사용하는 사용자 지정 MIME 유형 하나마다
+<ContactsDataKind> 요소를 하나씩 추가합니다. 데이터를
표시하는 것을 원치 않는 사용자 지정 데이터 행이 있으면, 이 요소를 추가하지 않아도 됩니다.
@@ -2268,35 +2268,35 @@ Google+ 앱으로 전환됩니다. 연락처 애플리케이션은 이 작업을
{@code android:mimeType}
- {@link android.provider.ContactsContract.Data} 테이블에서
-사용자 지정 데이터 행 유형 중 하나로 지정한 사용자 지정 MIME 유형입니다. 예를 들어,
-vnd.android.cursor.item/vnd.example.locationstatus 값은 연락처의 마지막으로 알려진 위치를 기록하는
+ {@link android.provider.ContactsContract.Data} 테이블에서
+사용자 지정 데이터 행 유형 중 하나로 지정한 사용자 지정 MIME 유형입니다. 예를 들어,
+vnd.android.cursor.item/vnd.example.locationstatus 값은 연락처의 마지막으로 알려진 위치를 기록하는
데이터 행에 대한 사용자 지정 MIME 유형이 될 수 있습니다.
{@code android:icon}
- 연락처 애플리케이션이 개발자의 데이터 옆에 표시하는
+ 연락처 애플리케이션이 개발자의 데이터 옆에 표시하는
Android 드로어블 리소스
-입니다. 이 리소스를 사용하여 사용자에게
+입니다. 이 리소스를 사용하여 사용자에게
데이터 출처가 개발자의 서비스임을 나타내는 것입니다.
{@code android:summaryColumn}
- 데이터 행에서 검색한 두 개 값 중에서 첫 번째 값에 대한 열 이름입니다. 이 값은
-이 데이터 행에 대한 항목의 첫 번째 줄로 표시됩니다. 첫 번째 줄은
-데이터 요약으로 사용되는 것이 본 목적이지만, 이것은 선택 사항입니다.
+ 데이터 행에서 검색한 두 개 값 중에서 첫 번째 값에 대한 열 이름입니다. 이 값은
+이 데이터 행에 대한 항목의 첫 번째 줄로 표시됩니다. 첫 번째 줄은
+데이터 요약으로 사용되는 것이 본 목적이지만, 이것은 선택 사항입니다.
android:detailColumn도 참조하십시오.
{@code android:detailColumn}
데이터 행에서 검색한 두 개 값 중에서 두 번째 값에 대한 열 이름입니다. 이 값은
-이 데이터 행에 대한 항목의 두 번째 줄로 표시됩니다.
+이 데이터 행에 대한 항목의 두 번째 줄로 표시됩니다.
{@code android:summaryColumn}도 참조하십시오.
추가 연락처 제공자 기능
- 이전 섹션에서 설명한 주요 기능 외에도 연락처 제공자는 연락처 데이터를 다루는 데
+ 이전 섹션에서 설명한 주요 기능 외에도 연락처 제공자는 연락처 데이터를 다루는 데
유용한 기능을 많이 제공합니다. 예를 들면 다음과 같습니다.
- 연락처 제공자는 관련된 연락처 컬렉션에
-그룹 데이터로 레이블을 붙이기로 선택할 수 있습니다. 사용자 계정과 연관된 서버에서
-그룹을 관리하고자 하는 경우, 계정의 계정 유형에 대한 동기화 어댑터가
-연락처 제공자와 서버 사이에서 그룹 데이터를 전송해야 합니다. 사용자가 해당 서버에 새 연락처를 추가하고
+ 연락처 제공자는 관련된 연락처 컬렉션에
+그룹 데이터로 레이블을 붙이기로 선택할 수 있습니다. 사용자 계정과 연관된 서버에서
+그룹을 관리하고자 하는 경우, 계정의 계정 유형에 대한 동기화 어댑터가
+연락처 제공자와 서버 사이에서 그룹 데이터를 전송해야 합니다. 사용자가 해당 서버에 새 연락처를 추가하고
이 연락처를 새 그룹에 넣으면, 동기화 어댑터가 해당 새 그룹을
-{@link android.provider.ContactsContract.Groups} 테이블에 추가해야 합니다. 원시 연락처가 속한 그룹(또는 여러 그룹)은
-{@link android.provider.ContactsContract.Data} 테이블에 저장되며, 이때
+{@link android.provider.ContactsContract.Groups} 테이블에 추가해야 합니다. 원시 연락처가 속한 그룹(또는 여러 그룹)은
+{@link android.provider.ContactsContract.Data} 테이블에 저장되며, 이때
{@link android.provider.ContactsContract.CommonDataKinds.GroupMembership} MIME 유형을 사용합니다.
- 개발자가 서버에서 가져온 원시 연락처 데이터를 연락처 제공자에 추가할
-동기화 어댑터를 디자인하는 중이고 그룹은 사용하지 않는다면,
-제공자 쪽에 데이터를 표시하라고 지시해야 합니다. 사용자가 기기에 계정을 추가했을 때 실행되는 코드에서
-연락처 제공자가 계정에 추가하는{@link android.provider.ContactsContract.Settings} 행을
-업데이트하십시오. 이 행에서
+ 개발자가 서버에서 가져온 원시 연락처 데이터를 연락처 제공자에 추가할
+동기화 어댑터를 디자인하는 중이고 그룹은 사용하지 않는다면,
+제공자 쪽에 데이터를 표시하라고 지시해야 합니다. 사용자가 기기에 계정을 추가했을 때 실행되는 코드에서
+연락처 제공자가 계정에 추가하는{@link android.provider.ContactsContract.Settings} 행을
+업데이트하십시오. 이 행에서
{@link android.provider.ContactsContract.SettingsColumns#UNGROUPED_VISIBLE
-Settings.UNGROUPED_VISIBLE} 열의 값을 1로 설정합니다. 이렇게 하면 연락처 제공자가
+Settings.UNGROUPED_VISIBLE} 열의 값을 1로 설정합니다. 이렇게 하면 연락처 제공자가
개발자의 연락처 데이터를 항상 표시하게 되고, 이는 그룹을 사용하지 않더라도 관계 없습니다.
연락처 사진
{@link android.provider.ContactsContract.Data} 테이블은
{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE
-Photo.CONTENT_ITEM_TYPE} MIME 유형으로 사진을 행에 저장합니다. 이 행의
-{@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 열은
+Photo.CONTENT_ITEM_TYPE} MIME 유형으로 사진을 행에 저장합니다. 이 행의
+{@link android.provider.ContactsContract.RawContactsColumns#CONTACT_ID} 열은
행이 속한 원시 연락처의 {@code android.provider.BaseColumns#_ID} 열과 연결됩니다.
- 클래스 {@link android.provider.ContactsContract.Contacts.Photo}는
-연락처 기본 사진의 사진 정보가 들어있는 {@link android.provider.ContactsContract.Contacts} 하위 테이블을 정의합니다.
-연락처의 기본 사진은 연락처 기본 원시 연락처의 기본 사진입니다. 마찬가지로,
+ 클래스 {@link android.provider.ContactsContract.Contacts.Photo}는
+연락처 기본 사진의 사진 정보가 들어있는 {@link android.provider.ContactsContract.Contacts} 하위 테이블을 정의합니다.
+연락처의 기본 사진은 연락처 기본 원시 연락처의 기본 사진입니다. 마찬가지로,
{@link android.provider.ContactsContract.RawContacts.DisplayPhoto} 클래스는
원시 연락처의 기본 사진의 사진 정보가 들어있는 {@link android.provider.ContactsContract.RawContacts} 하위 테이블을
정의합니다.
- {@link android.provider.ContactsContract.Contacts.Photo} 및
-{@link android.provider.ContactsContract.RawContacts.DisplayPhoto}에 대한 참조 문서에
-사진 정보를 검색하는 예시가 들어있습니다. 원시 연락처에 대한 기본 미리 보기를 검색하는 데 쓰이는
-편의 클래스는 없습니다. 하지만
-{@link android.provider.ContactsContract.Data} 테이블에 쿼리를 보내 원시 연락처의
-{@code android.provider.BaseColumns#_ID},
+ {@link android.provider.ContactsContract.Contacts.Photo} 및
+{@link android.provider.ContactsContract.RawContacts.DisplayPhoto}에 대한 참조 문서에
+사진 정보를 검색하는 예시가 들어있습니다. 원시 연락처에 대한 기본 미리 보기를 검색하는 데 쓰이는
+편의 클래스는 없습니다. 하지만
+{@link android.provider.ContactsContract.Data} 테이블에 쿼리를 보내 원시 연락처의
+{@code android.provider.BaseColumns#_ID},
{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE
Photo.CONTENT_ITEM_TYPE}, 및 {@link android.provider.ContactsContract.Data#IS_PRIMARY}
열을 선택하면 해당 원시 연락처의 기본 사진 행을 찾을 수 있습니다.
- 한 사람의 소셜 스트림 데이터에도 사진이 포함되어 있을 수 있습니다. 이런 사진은
-{@code android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장되며, 이 내용은
+ 한 사람의 소셜 스트림 데이터에도 사진이 포함되어 있을 수 있습니다. 이런 사진은
+{@code android.provider.ContactsContract.StreamItemPhotos} 테이블에 저장되며, 이 내용은
소셜 스트림 사진에 더 자세하게 설명되어 있습니다.
diff --git a/docs/html-intl/intl/ko/guide/topics/providers/content-provider-basics.jd b/docs/html-intl/intl/ko/guide/topics/providers/content-provider-basics.jd
index 953f92ab3026c..68ed5683d731c 100644
--- a/docs/html-intl/intl/ko/guide/topics/providers/content-provider-basics.jd
+++ b/docs/html-intl/intl/ko/guide/topics/providers/content-provider-basics.jd
@@ -119,11 +119,11 @@ page.title=콘텐츠 제공자 기본 정보
- 콘텐츠 제공자는 데이터의 중앙 리포지토리로의 액세스를 관리합니다.
+ 콘텐츠 제공자는 데이터의 중앙 리포지토리로의 액세스를 관리합니다.
제공자는 Android 애플리케이션의 일부이며, 이는 종종 나름의 UI를 제공하여 데이터에 작용하도록 합니다.
- 그러나 콘텐츠 제공자는 기본적으로 다른 애플리케이션이 사용하도록 만들어진 것입니다.
-이들은 제공자 클라이언트 개체를 사용하여 제공자에 액세스합니다.
-제공자와 제공자 클라이언트가 결합되면 데이터에 하나의 일관적인 표준 인터페이스를 제공하여
+ 그러나 콘텐츠 제공자는 기본적으로 다른 애플리케이션이 사용하도록 만들어진 것입니다.
+이들은 제공자 클라이언트 개체를 사용하여 제공자에 액세스합니다.
+제공자와 제공자 클라이언트가 결합되면 데이터에 하나의 일관적인 표준 인터페이스를 제공하여
이것이 프로세스간 통신과 보안 데이터 액세스도 처리합니다.
@@ -139,14 +139,14 @@ page.title=콘텐츠 제공자 기본 정보
개요
- 콘텐츠 제공자는 외부 애플리케이션에 데이터를 표시하며, 이때 데이터는
-관계형 데이터베이스에서 찾을 수 있는 테이블과 유사한 하나 이상의 테이블로서 표시됩니다.
-한 행은 제공자가 수집하는 어떤 유형의 데이터 인스턴스를 나타내며,
+ 콘텐츠 제공자는 외부 애플리케이션에 데이터를 표시하며, 이때 데이터는
+관계형 데이터베이스에서 찾을 수 있는 테이블과 유사한 하나 이상의 테이블로서 표시됩니다.
+한 행은 제공자가 수집하는 어떤 유형의 데이터 인스턴스를 나타내며,
행 안의 각 열은 인스턴스에 대해 수집된 개별적인 데이터를 나타냅니다.
- 예를 들어 Android 플랫폼 안에 내장된 여러 제공자 중에 사용자 사전이라는 것이 있습니다.
-이것은 사용자가 보관하고 싶어하는 비표준 단어의 철자를 저장합니다. 표 1은 이 제공자의 테이블에서
+ 예를 들어 Android 플랫폼 안에 내장된 여러 제공자 중에 사용자 사전이라는 것이 있습니다.
+이것은 사용자가 보관하고 싶어하는 비표준 단어의 철자를 저장합니다. 표 1은 이 제공자의 테이블에서
데이터가 어떤 형태를 띨 수 있는지를 나타낸 것입니다.
@@ -197,39 +197,39 @@ page.title=콘텐츠 제공자 기본 정보
- 표 1에서, 각 행은 일반적인 사전에 나오지 않는 단어의 인스턴스를
-나타냅니다. 각 열은 해당 단어에 대한 일부 데이터를 나타냅니다. 예를 들어
+ 표 1에서, 각 행은 일반적인 사전에 나오지 않는 단어의 인스턴스를
+나타냅니다. 각 열은 해당 단어에 대한 일부 데이터를 나타냅니다. 예를 들어
단어가 처음 나온 로케일 등을 들 수 있습니다. 열 헤더는 제공자에 저장된
-열 이름입니다. 행의 로케일을 참조하려면 그 행의 locale 열을 참조합니다.
+열 이름입니다. 행의 로케일을 참조하려면 그 행의 locale 열을 참조합니다.
이 제공자의 경우, _ID 열은 제공자가 자동으로 유지하는 "기본 키" 열
역할을 합니다.
- 참고: 제공자에 기본 키가 꼭 있어야 하는 것은 아니고,
-기본 키가 있는 경우 _ID를 열 이름으로 사용하지 않아도 됩니다. 그러나 제공자의 데이터를
-{@link android.widget.ListView}에 바인딩하려면
+ 참고: 제공자에 기본 키가 꼭 있어야 하는 것은 아니고,
+기본 키가 있는 경우 _ID를 열 이름으로 사용하지 않아도 됩니다. 그러나 제공자의 데이터를
+{@link android.widget.ListView}에 바인딩하려면
열 이름 중 하나는_ID여야 합니다. 이 요구 사항은
쿼리 결과 표시 섹션에 자세히 설명되어 있습니다.
제공자 액세스
- 애플리케이션은 콘텐츠 제공자로부터의 데이터에
-{@link android.content.ContentResolver} 클라이언트 개체로 액세스합니다.
-이 개체에는 제공자 개체 내의 같은 이름을 가진 메서드를 호출하는 메서드가 있습니다.
-이는 {@link android.content.ContentProvider}의 구체적인 하위 클래스 중 하나의 인스턴스입니다.
-{@link android.content.ContentResolver} 메서드는
+ 애플리케이션은 콘텐츠 제공자로부터의 데이터에
+{@link android.content.ContentResolver} 클라이언트 개체로 액세스합니다.
+이 개체에는 제공자 개체 내의 같은 이름을 가진 메서드를 호출하는 메서드가 있습니다.
+이는 {@link android.content.ContentProvider}의 구체적인 하위 클래스 중 하나의 인스턴스입니다.
+{@link android.content.ContentResolver} 메서드는
영구적 저장소의 기본적인 "CRUD"(생성, 검색, 업데이트 및 삭제) 기능을 제공합니다.
클라이언트 애플리케이션의 프로세스 내에 있는 {@link android.content.ContentResolver} 개체와
- 제공자를 소유하는 애플리케이션 내의 {@link android.content.ContentProvider} 개체가
+ 제공자를 소유하는 애플리케이션 내의 {@link android.content.ContentProvider} 개체가
자동으로 프로세스간 통신을 처리합니다.
-{@link android.content.ContentProvider} 또한
+{@link android.content.ContentProvider} 또한
콘텐츠 제공자의 데이터 리포지토리와 외부에 테이블로 표시되는 데이터 모습 사이에서 추상화 계층 역할을 합니다.
- 참고: 제공자에 액세스하려면 보통은 애플리케이션이
-제공자의 매니페스트 파일에 있는 특정 권한을 요청해야 합니다. 이것은
+ 참고: 제공자에 액세스하려면 보통은 애플리케이션이
+제공자의 매니페스트 파일에 있는 특정 권한을 요청해야 합니다. 이것은
콘텐츠 제공자 권한 섹션에 더 자세히 설명되어 있습니다.
@@ -237,7 +237,7 @@ page.title=콘텐츠 제공자 기본 정보
{@link android.content.ContentResolver#query ContentResolver.query()}를 호출하면 됩니다.
{@link android.content.ContentResolver#query query()} 메서드는 사용자 사전 제공자가 정의한
{@link android.content.ContentProvider#query ContentProvider.query()} 메서드를
-호출합니다. 다음 몇 줄의 코드는
+호출합니다. 다음 몇 줄의 코드는
{@link android.content.ContentResolver#query ContentResolver.query()} 호출을 나타낸 것입니다.
@@ -292,26 +292,26 @@ query(Uri,projection,selection,selectionArgs,sortOrder)}에 대한 인수가 SQL
sortOrder
ORDER BY col,col,...
- sortOrder는 반환된
+ sortOrder는 반환된
{@link android.database.Cursor} 내에 행이 나타나는 순서를 지정합니다.
콘텐츠 URI
- 콘텐츠 URI는 제공자에서 데이터를 식별하는 URI입니다.
+ 콘텐츠 URI는 제공자에서 데이터를 식별하는 URI입니다.
콘텐츠 URI에는 전체 제공자의 상징적인 이름(제공자의 권한)과
-테이블을 가리키는 이름(경로)이 포함됩니다.
+테이블을 가리키는 이름(경로)이 포함됩니다.
제공자 내의 테이블에 액세스하기 위해 클라이언트 메서드를 호출하는 경우,
그 테이블에 대한 콘텐츠 URI는 인수 중 하나입니다.
앞선 몇 줄의 코드에서 상수
-{@link android.provider.UserDictionary.Words#CONTENT_URI}에
+{@link android.provider.UserDictionary.Words#CONTENT_URI}에
사용자 사전의 "단어" 테이블의 콘텐츠 URI가 들어있습니다. {@link android.content.ContentResolver}
개체가 이 URI의 권한을 구문 분석한 다음, 이를 이용해 제공자를 "확인"합니다. 즉 이 권한을 알려진 제공자로 이루어진 시스템 테이블과 비교하는 것입니다.
-
-그러면 {@link android.content.ContentResolver}가 쿼리 인수를
+
+그러면 {@link android.content.ContentResolver}가 쿼리 인수를
올바른 제공자에게 발송할 수 있습니다.
@@ -331,20 +331,20 @@ content://user_dictionary/words
이것을 콘텐츠 URI로 식별합니다.
- 대다수의 제공자에서는 URI의 맨 끝에 ID 값을 추가하면
-테이블 내 하나의 행에 액세스할 수 있게 해줍니다. 예를 들어 _ID가
+ 대다수의 제공자에서는 URI의 맨 끝에 ID 값을 추가하면
+테이블 내 하나의 행에 액세스할 수 있게 해줍니다. 예를 들어 _ID가
사용자 사전의 4인 행을 검색하려면, 이 콘텐츠 URI를 사용하면 됩니다.
Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
- 일련의 행을 검색한 다음 그 중 하나를 업데이트하거나 삭제하고자 하는 경우 종종 ID 값을
+ 일련의 행을 검색한 다음 그 중 하나를 업데이트하거나 삭제하고자 하는 경우 종종 ID 값을
이용하곤 합니다.
- 참고: {@link android.net.Uri}와
-{@link android.net.Uri.Builder} 클래스에는 문자열에서 잘 구성된(Well-Formed) URI 개체를 구성하기 위한 편의 메서드가 들어 있습니다.
+ 참고: {@link android.net.Uri}와
+{@link android.net.Uri.Builder} 클래스에는 문자열에서 잘 구성된(Well-Formed) URI 개체를 구성하기 위한 편의 메서드가 들어 있습니다.
{@link android.content.ContentUris}에는 URI에 ID 값을 추가하기 위한 편의 메서드가 들어 있습니다.
이전 조각은 {@link android.content.ContentUris#withAppendedId
withAppendedId()}를 사용하여 UserDictionary 콘텐츠 URI에 ID를 추가합니다.
@@ -358,10 +358,10 @@ withAppendedId()}를 사용하여 UserDictionary 콘텐츠 URI에 ID를 추가
방법을 설명합니다.
- 명확히 나타내기 위해 이 섹션의 코드 조각은
-{@link android.content.ContentResolver#query ContentResolver.query()}를 "UI 스레드"에서 호출합니다.
+ 명확히 나타내기 위해 이 섹션의 코드 조각은
+{@link android.content.ContentResolver#query ContentResolver.query()}를 "UI 스레드"에서 호출합니다.
그러나 실제 코드의 경우 쿼리는 별도의 스레드에서 비동기식으로 수행해야 합니다. 이를 위한 한 가지 방식으로
-{@link android.content.CursorLoader}
+{@link android.content.CursorLoader}
클래스를 쓰는 것을 들 수 있습니다. 이 내용은
로더 가이드에 더 자세히 설명되어 있습니다. 또한, 이 코드 줄은 조각일 뿐이며 애플리케이션을 전체적으로 표시한 것이 아닙니다.
@@ -380,32 +380,32 @@ withAppendedId()}를 사용하여 UserDictionary 콘텐츠 URI에 ID를 추가
읽기 액세스 권한 요청
제공자에서 데이터를 검색하려면 애플리케이션에 해당 제공자에 대한 "읽기 액세스 권한"이 필요합니다.
- 런타임에는 이 권한을 요청할 수 없습니다. 대신 이 권한이 필요하다는 것을 매니페스트에 나타내야 합니다. 이때,
+ 런타임에는 이 권한을 요청할 수 없습니다. 대신 이 권한이 필요하다는 것을 매니페스트에 나타내야 합니다. 이때,
<uses-permission>
요소와 제공자가 정의한 정확한 권한 이름을 사용하면 됩니다.
- 매니페스트에서 이 요소를 지정하는 것은 사실상 애플리케이션을 위해 이 권한을 "요청"하는 것과
+ 매니페스트에서 이 요소를 지정하는 것은 사실상 애플리케이션을 위해 이 권한을 "요청"하는 것과
같습니다. 사용자가 애플리케이션을 설치할 때면, 이 요청을 암시적으로 허용하게 됩니다.
- 사용 중인 제공자에 대한 읽기 액세스 권한의 정확한 이름과 해당 제공자가 사용하는
+ 사용 중인 제공자에 대한 읽기 액세스 권한의 정확한 이름과 해당 제공자가 사용하는
다른 액세스 권한의 이름을 찾아보려면 제공자의 문서를 살펴보십시오.
- 제공자에 액세스하는 데 있어 권한이 어떤 역할을 하는지는
+ 제공자에 액세스하는 데 있어 권한이 어떤 역할을 하는지는
콘텐츠 제공자 권한 섹션에 더 자세하게 설명되어 있습니다.
- 사용자 사전 제공자는
-android.permission.READ_USER_DICTIONARY 권한을 자신의 매니페스트 파일에 정의합니다. 따라서 해당 제공자에서
+ 사용자 사전 제공자는
+android.permission.READ_USER_DICTIONARY 권한을 자신의 매니페스트 파일에 정의합니다. 따라서 해당 제공자에서
읽기 작업을 하고자 하는 애플리케이션은 반드시 이 권한을 요청해야 합니다.
쿼리 구성
- 제공자에서 데이터를 검색할 때 다음 단계는 쿼리를 구성하는 것입니다. 다음의 첫 번째 조각은
+ 제공자에서 데이터를 검색할 때 다음 단계는 쿼리를 구성하는 것입니다. 다음의 첫 번째 조각은
사용자 사전 제공자에 액세스하는 데 필요한 몇 가지 변수를 정의한 것입니다.
- 다음 조각은 사용자 사전 제공자를 예시로 사용하여
+ 다음 조각은 사용자 사전 제공자를 예시로 사용하여
{@link android.content.ContentResolver#query ContentResolver.query()}를
- 사용하는 방법을 나타낸 것입니다. 제공자 클라이언트 쿼리는 SQL 쿼리와 비슷하며,
+ 사용하는 방법을 나타낸 것입니다. 제공자 클라이언트 쿼리는 SQL 쿼리와 비슷하며,
반환할 열 집합과 선택 기준 집합, 그리고 정렬 순서가 이 안에 들어 있습니다.
검색할 행을 나타내는 식은 선택 절과 선택 인수로 분할되어 있습니다.
선택 절은 논리와 부울 식, 열 이름과 값
-(변수 mSelectionClause)을 조합한 것입니다.
-값 대신 대체 가능한 매개변수 ?를 지정하면,
+(변수 mSelectionClause)을 조합한 것입니다.
+값 대신 대체 가능한 매개변수 ?를 지정하면,
쿼리 메서드가 그 값을 선택 인수 배열에서 검색합니다(변수 mSelectionArgs).
- 다음 조각의 경우, 사용자가 단어를 입력하지 않으면 선택 절이
-null로 설정되고, 쿼리는 제공자 안의 모든 단어를 반환합니다.
+ 다음 조각의 경우, 사용자가 단어를 입력하지 않으면 선택 절이
+null로 설정되고, 쿼리는 제공자 안의 모든 단어를 반환합니다.
사용자가 단어를 입력하면 선택 절은 UserDictionary.Words.WORD + " = ?"로 설정되며
선택 인수의 첫 번째 요소가 사용자가 입력한 단어로 설정됩니다.
@@ -514,7 +514,7 @@ SELECT _ID, word, locale FROM words WHERE word = <userinput> ORDER BY word
악의적인 입력에 대한 보호
- 콘텐츠 제공자가 관리하는 데이터가 SQL 데이터베이스에 있는 경우,
+ 콘텐츠 제공자가 관리하는 데이터가 SQL 데이터베이스에 있는 경우,
원시 SQL 문에 외부의 신뢰할 수 없는 데이터를 포함시키면 SQL 삽입을 초래할 수 있습니다.
이렇게 하면 사용자로 하여금 여러분의 SQL 문에 악의적인 SQL을 연결할 수 있도록 허용합니다.
- 예를 들어 사용자가 mUserInput에 대해 "nothing; DROP TABLE *;"을 입력할 수 있습니다.
-그러면 그 결과로 선택 절 var = nothing; DROP TABLE *;이 나옵니다.
-선택 절이 일종의 SQL 문으로 취급되었기 때문에 제공자가 기본 SQLite 데이터베이스에서 테이블을
-모두 삭제하는 결과를 낳을 수도 있습니다(제공자가 SQL 삽입
+ 예를 들어 사용자가 mUserInput에 대해 "nothing; DROP TABLE *;"을 입력할 수 있습니다.
+그러면 그 결과로 선택 절 var = nothing; DROP TABLE *;이 나옵니다.
+선택 절이 일종의 SQL 문으로 취급되었기 때문에 제공자가 기본 SQLite 데이터베이스에서 테이블을
+모두 삭제하는 결과를 낳을 수도 있습니다(제공자가 SQL 삽입
시도를 잡아내도록 설정된 경우는 예외입니다).
- 이 문제를 피하려면 ?를 대체 가능한 매개변수로 사용하는 선택 절과,
+ 이 문제를 피하려면 ?를 대체 가능한 매개변수로 사용하는 선택 절과,
별도의 선택 인수 배열을 사용하면 됩니다. 이렇게 하면, 사용자 입력이 SQL 문의 일부로 해석되기보다 쿼리에 직접 바인딩됩니다.
- 이것은 SQL로 취급되지 않기 때문에 사용자 입력이 악의적인 SQL을 삽입할 수 없습니다.
+ 이것은 SQL로 취급되지 않기 때문에 사용자 입력이 악의적인 SQL을 삽입할 수 없습니다.
사용자 입력을 포함하는 데 연결을 사용하는 대신 다음 선택 절을 사용합니다.
- ?를 대체 가능한 매개변수로 사용하는 선택 절과
-선택 인수 배열을 사용하는 것이 선택을 지정하는 데 선호되는 방법입니다.
+ ?를 대체 가능한 매개변수로 사용하는 선택 절과
+선택 인수 배열을 사용하는 것이 선택을 지정하는 데 선호되는 방법입니다.
이는 제공자가 SQL 데이터베이스 기반이 아닐 때에도 마찬가지입니다.
쿼리 결과 표시
- {@link android.content.ContentResolver#query ContentResolver.query()}
+ {@link android.content.ContentResolver#query ContentResolver.query()}
클라이언트 메서드는 언제나 쿼리 선택 기준과 일치하는 행에 대해 쿼리 프로젝션이 지정한 열을 포함하는
-{@link android.database.Cursor}를 반환합니다.
+{@link android.database.Cursor}를 반환합니다.
{@link android.database.Cursor} 개체가 자신이 포함한 행과 열에 무작위 읽기 액세스를 제공합니다.
- {@link android.database.Cursor} 메서드를 사용하면 행을 결과에서 반복할 수 있고,
+ {@link android.database.Cursor} 메서드를 사용하면 행을 결과에서 반복할 수 있고,
각 열의 데이터 유형을 결정하며 열에서 데이터를 꺼내거나 결과의 다른 속성을 검토할 수도 있습니다.
일부 {@link android.database.Cursor} 구현은 제공자의 데이터가 변경될 경우,
-{@link android.database.Cursor}가 변경될 때 관찰자 개체 내의 메서드를 트리거하는 경우
+{@link android.database.Cursor}가 변경될 때 관찰자 개체 내의 메서드를 트리거하는 경우
또는 두 가지가 한 번에 발생할 경우 자동으로 개체를 업데이트합니다.
- 참고: 제공자는 쿼리를 수행하는 개체의 성격을 근거로
-열에 대한 액세스를 제한할 수 있습니다. 예를 들어 연락처 제공자는 동기화 어댑터로의 몇몇 열에 대한 액세스를 제한합니다.
+ 참고: 제공자는 쿼리를 수행하는 개체의 성격을 근거로
+열에 대한 액세스를 제한할 수 있습니다. 예를 들어 연락처 제공자는 동기화 어댑터로의 몇몇 열에 대한 액세스를 제한합니다.
이렇게 해야 액티비티 또는 서비스에 열을 반환하지 않기 때문입니다.
- 선택 기준에 일치하는 행이 없으면, 제공자는
-{@link android.database.Cursor} 개체를 반환합니다. 이 개체의
+ 선택 기준에 일치하는 행이 없으면, 제공자는
+{@link android.database.Cursor} 개체를 반환합니다. 이 개체의
{@link android.database.Cursor#getCount Cursor.getCount()}는 0(빈 커서)입니다.
- 내부 오류가 발생하는 경우, 쿼리 결과는 특정 제공자에 따라 달라집니다.
+ 내부 오류가 발생하는 경우, 쿼리 결과는 특정 제공자에 따라 달라집니다.
null을 반환하기로 선택할 수도 있고, {@link java.lang.Exception}을 발생시킬 수도 있습니다.
@@ -595,9 +595,9 @@ selectionArgs[0] = mUserInput;
연결하는 것입니다.
- 다음 조각은 이전 조각으로부터 코드를 계속 이어가는 것입니다.
+ 다음 조각은 이전 조각으로부터 코드를 계속 이어가는 것입니다.
이는 해당 쿼리가 검색한 {@link android.database.Cursor}가 들어 있는
-{@link android.widget.SimpleCursorAdapter} 개체를 생성하며, 이 개체를
+{@link android.widget.SimpleCursorAdapter} 개체를 생성하며, 이 개체를
{@link android.widget.ListView}에 대한 어댑터로 설정합니다.
참고: {@link android.database.Cursor}로 {@link android.widget.ListView}를 뒷받침하려면,
커서에 _ID라는 열이 포함되어야 합니다.
- 이것 때문에 이전에 표시된 쿼리가 "단어" 테이블에 대하여 _ID 열을
+ 이것 때문에 이전에 표시된 쿼리가 "단어" 테이블에 대하여 _ID 열을
검색하며, {@link android.widget.ListView}가 이를 표시하지 않더라도 무관합니다.
이 제한은 대부분의 제공자에 각 테이블에 대한 _ID 열이 있는 이유를 설명해주기도 합니다.
@@ -635,7 +635,7 @@ mWordList.setAdapter(mCursorAdapter);
쿼리 결과에서 데이터 가져오기
- 쿼리 결과를 단순히 표시만 하는 것보다 이를 다른 작업에 사용할 수 있습니다.
+ 쿼리 결과를 단순히 표시만 하는 것보다 이를 다른 작업에 사용할 수 있습니다.
예를 들어, 사용자 사전에서 철자를 검색한 다음 이것을 다른 제공자 내에서 찾아볼 수 있습니다.
이렇게 하려면, {@link android.database.Cursor}에서 행을 계속 반복하면 됩니다.
@@ -672,10 +672,10 @@ if (mCursor != null) {
}
- {@link android.database.Cursor} 구현에는
-여러 개의 "가져오기" 메서드가 들어 있어 개체로부터 여러 가지 유형의 데이터를 검색합니다. 예를 들어 이전 조각에서는
-{@link android.database.Cursor#getString getString()}을 사용합니다.
-여기에는 해당 열의 데이터 유형을 나타내는 값을 반환하는
+ {@link android.database.Cursor} 구현에는
+여러 개의 "가져오기" 메서드가 들어 있어 개체로부터 여러 가지 유형의 데이터를 검색합니다. 예를 들어 이전 조각에서는
+{@link android.database.Cursor#getString getString()}을 사용합니다.
+여기에는 해당 열의 데이터 유형을 나타내는 값을 반환하는
{@link android.database.Cursor#getType getType()} 메서드도 있습니다.
@@ -683,33 +683,33 @@ if (mCursor != null) {
콘텐츠 제공자 권한
- 제공자의 애플리케이션은 해당 제공자의 데이터에 액세스하려면 다른 애플리케이션이 반드시 가지고 있어야 하는
-권한을 지정할 수 있습니다. 이와 같은 권한을 통해 사용자는 한 애플리케이션이 어느 데이터에 액세스하려 시도할지
-알 수 있습니다. 다른 애플리케이션은 제공자의 요구 사항을 근거로 해당 제공자에 액세스하기 위해 필요한
+ 제공자의 애플리케이션은 해당 제공자의 데이터에 액세스하려면 다른 애플리케이션이 반드시 가지고 있어야 하는
+권한을 지정할 수 있습니다. 이와 같은 권한을 통해 사용자는 한 애플리케이션이 어느 데이터에 액세스하려 시도할지
+알 수 있습니다. 다른 애플리케이션은 제공자의 요구 사항을 근거로 해당 제공자에 액세스하기 위해 필요한
권한을 요청합니다. 최종 사용자는 애플리케이션을 설치할 때 요청된 권한을 보게 됩니다.
- 제공자의 애플리케이션이 아무 권한도 지정하지 않은 경우, 다른 애플리케이션은 해당 제공자의
-데이터에 액세스할 수 없습니다. 그러나 제공자의 애플리케이션 내에 있는 구성 요소는
+ 제공자의 애플리케이션이 아무 권한도 지정하지 않은 경우, 다른 애플리케이션은 해당 제공자의
+데이터에 액세스할 수 없습니다. 그러나 제공자의 애플리케이션 내에 있는 구성 요소는
지정된 권한과 무관하게 항상 읽기 및 쓰기 액세스 권한을 모두 가지고 있습니다.
- 이전에 언급한 것과 같이 사용자 사전 제공자에서 데이터를 검색하려면
+ 이전에 언급한 것과 같이 사용자 사전 제공자에서 데이터를 검색하려면
android.permission.READ_USER_DICTIONARY 권한이 필요합니다.
이 제공자에게는 데이터 삽입, 업데이트 또는 삭제에 각각 별도의 android.permission.WRITE_USER_DICTIONARY
권한이 있습니다.
- 제공자에 액세스하는 데 필요한 권한을 얻으려면 애플리케이션은
+ 제공자에 액세스하는 데 필요한 권한을 얻으려면 애플리케이션은
자신의 매니페스트 파일에 있는 <uses-permission>
-으로 그러한 권한을 요청합니다. Android 패키지 관리자가 애플리케이션을 설치하는 경우,
+으로 그러한 권한을 요청합니다. Android 패키지 관리자가 애플리케이션을 설치하는 경우,
사용자는 애플리케이션이 요청하는 권한을 모두 승인해야 합니다. 사용자가 이를 모두 승인하면
패키지 관리자가 설치를 계속하지만, 사용자가 이를 승인하지 않으면 패키지 관리자는 설치를 중단합니다.
- 제공자 액세스 권한이 미치는 영향은
+ 제공자 액세스 권한이 미치는 영향은
보안 및 권한 가이드에 좀 더 자세히 설명되어 있습니다.
@@ -725,15 +725,15 @@ if (mCursor != null) {
데이터 삽입, 업데이트 및 삭제
- 제공자로부터 데이터를 검색하는 것과 같은 방식으로, 데이터를 수정할 때에도 제공자 클라이언트와 제공자의
+ 제공자로부터 데이터를 검색하는 것과 같은 방식으로, 데이터를 수정할 때에도 제공자 클라이언트와 제공자의
{@link android.content.ContentProvider} 사이의 상호작용을 사용합니다.
- {@link android.content.ContentResolver}의 메서드를 호출하면서
-{@link android.content.ContentProvider}의 상응하는 메서드로 전달된 인수를 사용합니다.
+ {@link android.content.ContentResolver}의 메서드를 호출하면서
+{@link android.content.ContentProvider}의 상응하는 메서드로 전달된 인수를 사용합니다.
제공자와 제공자의 클라이언트가 보안과 프로세스간 통신을 자동으로 처리합니다.
데이터 삽입
- 데이터를 제공자 안으로 삽입하려면,
+ 데이터를 제공자 안으로 삽입하려면,
{@link android.content.ContentResolver#insert ContentResolver.insert()}
메서드를 호출합니다. 이 메서드는 제공자에 새로운 행을 삽입하고 해당 열에 대한 콘텐츠 URI를 반환합니다.
이 조각은 사용자 사전 제공자에 새 단어를 삽입하는 방법을 나타낸 것입니다.
@@ -763,8 +763,8 @@ mNewUri = getContentResolver().insert(
새로운 행에 대한 데이터는 단일 행 커서와 형태가 유사한 단일 {@link android.content.ContentValues} 개체로
-이동합니다. 이 개체 내의 열은 모두 같은 데이터 유형을 가지지 않아도 됩니다.
-또한 아예 값을 지정하고 싶지 않은 경우라면 열을 null로 설정할 수 있습니다.
+이동합니다. 이 개체 내의 열은 모두 같은 데이터 유형을 가지지 않아도 됩니다.
+또한 아예 값을 지정하고 싶지 않은 경우라면 열을 null로 설정할 수 있습니다.
이때 {@link android.content.ContentValues#putNull ContentValues.putNull()}을 사용하면 됩니다.
- 행을 업데이트하려면 업데이트된 값과 함께 {@link android.content.ContentValues} 개체를 사용합니다.
+ 행을 업데이트하려면 업데이트된 값과 함께 {@link android.content.ContentValues} 개체를 사용합니다.
이때 값은 삽입할 때와 똑같고, 선택 기준은 쿼리할 때와 같습니다.
사용하는 클라이언트 메서드는
-{@link android.content.ContentResolver#update ContentResolver.update()}입니다.
-값을 추가하는 것은 업데이트 중인 열에 대한 {@link android.content.ContentValues} 개체에만 하면 됩니다.
+{@link android.content.ContentResolver#update ContentResolver.update()}입니다.
+값을 추가하는 것은 업데이트 중인 열에 대한 {@link android.content.ContentValues} 개체에만 하면 됩니다.
열의 콘텐츠를 삭제하려면, 값을 null로 설정하십시오.
-
+
{@link android.content.ContentResolver#update ContentResolver.update()}를 호출하는 경우에는 사용자 입력도 삭제해야 합니다. 이 내용에 관해 자세히 알아보려면
악의적인 입력에 대한 보호 섹션을 읽어 보십시오.
데이터 삭제
- 행을 삭제하는 것은 행 데이터를 검색하는 것과 비슷합니다. 즉, 삭제하고자 하는 행에 대한 선택 기준을 지정하면
+ 행을 삭제하는 것은 행 데이터를 검색하는 것과 비슷합니다. 즉, 삭제하고자 하는 행에 대한 선택 기준을 지정하면
클라이언트 메서드가 삭제된 행 수를 반환하는 식입니다.
다음 조각은 앱 ID가 "user"와 일치하는 행을 삭제합니다. 메서드가 삭제된 행 수를 반환합니다.
@@ -857,14 +857,14 @@ mRowsDeleted = getContentResolver().delete(
);
- {@link android.content.ContentResolver#delete ContentResolver.delete()}를
+ {@link android.content.ContentResolver#delete ContentResolver.delete()}를
호출하는 경우에는 사용자 입력도 삭제해야 합니다. 이 내용에 관해 자세히 알아보려면
악의적인 입력에 대한 보호 섹션을 읽어 보십시오.
제공자 데이터 유형
- 콘텐츠 제공자는 아주 다양한 데이터 유형을 제공할 수 있습니다.
+ 콘텐츠 제공자는 아주 다양한 데이터 유형을 제공할 수 있습니다.
사용자 사전 제공자는 텍스트만 제공하지만, 제공자는 다음과 같은 형식도 제공할 수 있습니다.
제공자가 종종 사용하는 또 다른 데이터 유형은 64KB 바이트 배열로 구현되는 BLOB(Binary Large OBject)입니다.
- 이용 가능한 데이터 유형을 확인하려면
+ 이용 가능한 데이터 유형을 확인하려면
{@link android.database.Cursor} 클래스 "가져오기" 메서드를 살펴보면 됩니다.
제공자 내의 각 열에 대한 데이터 유형은 보통 자신의 문서에 목록으로 나열되어 있습니다.
- 사용자 사전 제공자의 데이터 유형은 제공자의 계약 클래스
+ 사용자 사전 제공자의 데이터 유형은 제공자의 계약 클래스
{@link android.provider.UserDictionary.Words}의 참조 문서에 나열되어 있습니다(계약 클래스는
계약 클래스 섹션에 설명되어 있습니다).
@link android.database.Cursor#getType
Cursor.getType()}을 호출해서도 데이터 유형을 결정할 수 있습니다.
- 제공자는 스스로 정의하는 각 콘텐츠 URI의 MIME 데이터 유형 정보도 유지관리합니다.
-MIME 유형 정보를 사용하면 애플리케이션이 제공자가 제공하는 데이터를 처리할 수 있을지 알아낼 수도 있고,
-MIME 유형을 근거로 처리 유형을 선택할 수도 있습니다.
+ 제공자는 스스로 정의하는 각 콘텐츠 URI의 MIME 데이터 유형 정보도 유지관리합니다.
+MIME 유형 정보를 사용하면 애플리케이션이 제공자가 제공하는 데이터를 처리할 수 있을지 알아낼 수도 있고,
+MIME 유형을 근거로 처리 유형을 선택할 수도 있습니다.
MIME 유형이 필요한 시점은 주로 복잡한 데이터 구조 또는 파일이 들어 있는 제공자를 다룰 때입니다.
예를 들어 연락처 제공자 내의 {@link android.provider.ContactsContract.Data}
테이블은 MIME 유형을 사용하여 각 행에 저장된 연락처 데이터의 유형에 레이블을 붙입니다.
- 콘텐츠 URI에 상응하는 MIME 유형을 가져오려면
+ 콘텐츠 URI에 상응하는 MIME 유형을 가져오려면
{@link android.content.ContentResolver#getType ContentResolver.getType()}을 호출하십시오.
- MIME 유형 참조 섹션에서 표준 및 사용자 지정 MIME 유형의
+ MIME 유형 참조 섹션에서 표준 및 사용자 지정 MIME 유형의
두 가지를 모두 설명하고 있습니다.
@@ -922,13 +922,13 @@ MIME 유형이 필요한 시점은 주로 복잡한 데이터 구조 또는 파
{@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}로 이를 적용할 수 있습니다.
- 비동기식 쿼리: 쿼리는 별도의 스레드에서 수행해야 합니다. 이 작업을 수행하는 한 가지 방법으로
-{@link android.content.CursorLoader} 개체를 사용하는 것이 있습니다. 이 사용 방법은
+ 비동기식 쿼리: 쿼리는 별도의 스레드에서 수행해야 합니다. 이 작업을 수행하는 한 가지 방법으로
+{@link android.content.CursorLoader} 개체를 사용하는 것이 있습니다. 이 사용 방법은
로더 가이드에 있는 예시에서 설명합니다.
- 인텐트를 통한 데이터 액세스:
+ 인텐트를 통한 데이터 액세스:
인텐트를 제공자에 직접 보낼 수는 없지만, 인텐트를 제공자의 애플리케이션에 보낼 수는 있습니다.
보통은 이것이 제공자의 데이터를 수정하기에 가장 좋습니다.
@@ -938,23 +938,23 @@ MIME 유형이 필요한 시점은 주로 복잡한 데이터 구조 또는 파
일괄 액세스
- 제공자에 일괄 액세스를 하면 많은 수의 행을 삽입할 때, 같은 메서드 호출 내에서 여러 개의 테이블에 여러 행을 삽입할 때
+ 제공자에 일괄 액세스를 하면 많은 수의 행을 삽입할 때, 같은 메서드 호출 내에서 여러 개의 테이블에 여러 행을 삽입할 때
또는 전반적으로, 프로세스 경계를 가로질러 일련의 작업을 수행하는 경우(원자성 작업) 유용합니다.
"일괄 모드"로 제공자에 액세스하려면
-{@link android.content.ContentProviderOperation} 개체의 배열을 생성한 다음 이를 콘텐츠 제공자에게
+{@link android.content.ContentProviderOperation} 개체의 배열을 생성한 다음 이를 콘텐츠 제공자에게
{@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}로
- 발송하면 됩니다.
+ 발송하면 됩니다.
이 메서드에는 특정한 콘텐츠 URI보다는 콘텐츠 제공자의 권한을 전달합니다.
-이렇게 하면 배열 내의 각 {@link android.content.ContentProviderOperation} 개체가
+이렇게 하면 배열 내의 각 {@link android.content.ContentProviderOperation} 개체가
서로 다른 테이블에 대해 작용하도록 할 수 있습니다. {@link android.content.ContentResolver#applyBatch
ContentResolver.applyBatch()}를 호출하면 일련의 결과를 반환합니다.
{@link android.provider.ContactsContract.RawContacts} 계약 클래스의 설명에
- 일괄 삽입을 설명하는 코드 조각이 포함되어 있습니다.
+ 일괄 삽입을 설명하는 코드 조각이 포함되어 있습니다.
연락처 관리자
샘플 애플리케이션에는 ContactAdder.java
소스 파일의 일괄 액세스 예시가 포함되어 있습니다.
@@ -963,31 +963,31 @@ MIME 유형이 필요한 시점은 주로 복잡한 데이터 구조 또는 파
도우미 앱을 사용한 데이터 표시
- 애플리케이션에 액세스 권한이 있더라도
-다른 애플리케이션에 데이터를 표시할 인텐트를 사용하고자 할 수 있습니다. 예를 들어 캘린더 애플리케이션은
+ 애플리케이션에 액세스 권한이 있더라도
+다른 애플리케이션에 데이터를 표시할 인텐트를 사용하고자 할 수 있습니다. 예를 들어 캘린더 애플리케이션은
특정 날짜나 이벤트를 표시하는 {@link android.content.Intent#ACTION_VIEW}를 허용합니다.
이 때문에 나름의 UI를 직접 생성하지 않고도 캘린더 정보를 표시할 수 있습니다.
-이 기능에 대한 자세한 정보는
+이 기능에 대한 자세한 정보는
캘린더 제공자 가이드를 참조하십시오.
인텐트를 보낼 목적지인 애플리케이션은 제공자와 연관된 애플리케이션이 아니어도 됩니다.
- 예를 들어 연락처 제공자에서 연락처를 검색한 다음, 해당 연락처의 이미지에 대한 콘텐츠 URI가 들어 있는
-{@link android.content.Intent#ACTION_VIEW} 인텐트를
+ 예를 들어 연락처 제공자에서 연락처를 검색한 다음, 해당 연락처의 이미지에 대한 콘텐츠 URI가 들어 있는
+{@link android.content.Intent#ACTION_VIEW} 인텐트를
이미지 뷰어로 보낼 수 있습니다.
인텐트를 통한 데이터 액세스
- 인텐트는 콘텐츠 제공자에 간접 액세스를 제공할 수 있습니다. 애플리케이션에 액세스 권한이 없는데도
-사용자에게 제공자 내의 데이터에 액세스 권한을 허가하려면, 권한을 가지고 있는 애플리케이션에서 결과 인텐트를 다시 가져오거나
+ 인텐트는 콘텐츠 제공자에 간접 액세스를 제공할 수 있습니다. 애플리케이션에 액세스 권한이 없는데도
+사용자에게 제공자 내의 데이터에 액세스 권한을 허가하려면, 권한을 가지고 있는 애플리케이션에서 결과 인텐트를 다시 가져오거나
권한이 있는 애플리케이션을 활성화한 다음 사용자에게 그 애플리케이션에서 작업하도록 하면 됩니다.
임시 권한으로 액세스 얻기
- 적절한 액세스 권한이 없더라도 콘텐츠 제공자 내의 데이터에 액세스할 수는 있습니다.
+ 적절한 액세스 권한이 없더라도 콘텐츠 제공자 내의 데이터에 액세스할 수는 있습니다.
권한을 가지고 있는 애플리케이션에 인텐트를 보내 "URI" 권한이 들어 있는 결과 인텐트를 돌려받으면 됩니다.
이들 권한은 특정 콘텐츠 URI에 대한 권한으로, 이를 수신하는 액티비티가 완료될 때까지 유지됩니다.
@@ -1005,27 +1005,27 @@ MIME 유형이 필요한 시점은 주로 복잡한 데이터 구조 또는 파
- 참고: 이와 같은 플래그는 콘텐츠 URI에 권한이 들어 있는 제공자에 일반적인 읽기 또는 쓰기 액세스
+ 참고: 이와 같은 플래그는 콘텐츠 URI에 권한이 들어 있는 제공자에 일반적인 읽기 또는 쓰기 액세스
권한을 부여하지는 않습니다. 이 액세스는 URI 자체에만 해당됩니다.
- 제공자는 자신의 매니페스트 내의 콘텐츠 URI에 대한 URI 권한을 정의합니다. 이때
+ 제공자는 자신의 매니페스트 내의 콘텐츠 URI에 대한 URI 권한을 정의합니다. 이때
<provider>
- 요소의
+ 요소의
android:grantUriPermission
- 속성을 사용하며,
+ 속성을 사용하며,
<provider>
- 요소의
+ 요소의
<grant-uri-permission>
- 하위 요소도 사용합니다.
+ 하위 요소도 사용합니다.
URI 권한 메커니즘은 "URI 권한" 섹션의 보안 및 권한 가이드에
자세히 설명되어 있습니다.
예를 들어, {@link android.Manifest.permission#READ_CONTACTS} 권한이 없더라도
-연락처 제공자 내의 연락처에 대한 데이터를 검색할 수 있습니다.
-이 작업을 하면 좋은 예로, 연락처에 기재된 사람의 생일에 전자 축하 카드를 보내주는 애플리케이션을 들 수 있습니다.
-{@link android.Manifest.permission#READ_CONTACTS}를 요청하면
+연락처 제공자 내의 연락처에 대한 데이터를 검색할 수 있습니다.
+이 작업을 하면 좋은 예로, 연락처에 기재된 사람의 생일에 전자 축하 카드를 보내주는 애플리케이션을 들 수 있습니다.
+{@link android.Manifest.permission#READ_CONTACTS}를 요청하면
사용자의 연락처 전체와 해당 정보 일체에 대한 액세스를 부여하므로, 그 대신 애플리케이션에서 어느 연락처를 사용할지 사용자가 직접 제어하도록 해주는 편이 낫습니다.
이렇게 하려면, 다음 절차를 사용합니다.
@@ -1043,13 +1043,13 @@ startActivityForResult()} 메서드를 사용해서
선택 액티비티에서 사용자가 업데이트할 연락처를 선택합니다.
- 이렇게 되면 선택 액티비티가
+ 이렇게 되면 선택 액티비티가
{@link android.app.Activity#setResult setResult(resultcode, intent)}
-를 호출하여 애플리케이션에 돌려줄 인텐트를 설정합니다.
-이 인텐트에 사용자가 선택한 연락처의 콘텐츠 URI와 "추가" 플래그
-{@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}이 들어 있습니다.
-이러한 플래그가 URI에 앱으로의 권한을 허가하여 콘텐츠 URI가 가리킨 연락처에 대한 데이터를 읽을 수 있도록 합니다.
-그런 다음 선택 액티비티는 {@link android.app.Activity#finish()}를 호출하여
+를 호출하여 애플리케이션에 돌려줄 인텐트를 설정합니다.
+이 인텐트에 사용자가 선택한 연락처의 콘텐츠 URI와 "추가" 플래그
+{@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}이 들어 있습니다.
+이러한 플래그가 URI에 앱으로의 권한을 허가하여 콘텐츠 URI가 가리킨 연락처에 대한 데이터를 읽을 수 있도록 합니다.
+그런 다음 선택 액티비티는 {@link android.app.Activity#finish()}를 호출하여
애플리케이션에 제어를 반환합니다.
@@ -1067,7 +1067,7 @@ startActivityForResult()} 메서드를 사용해서
다른 애플리케이션 사용
- 개발자에게 액세스 권한이 없는 데이터를 사용자가 수정할 수 있도록 허용하는 간단한 방법은
+ 개발자에게 액세스 권한이 없는 데이터를 사용자가 수정할 수 있도록 허용하는 간단한 방법은
해당 권한을 가지고 있는 애플리케이션을 활성화한 다음 사용자에게 그곳에서 작업하도록 해주는 것입니다.
@@ -1082,18 +1082,18 @@ startActivityForResult()} 메서드를 사용해서
계약 클래스
계약 클래스는 애플리케이션이 콘텐츠 URI, 열 이름, 인텐트 작업 및 콘텐츠 제공자의 다른 기능과
-작업할 수 있게 도와주는 상수를 정의합니다. 계약 클래스는 제공자와 함께 자동으로 포함되지 않습니다.
+작업할 수 있게 도와주는 상수를 정의합니다. 계약 클래스는 제공자와 함께 자동으로 포함되지 않습니다.
해당 제공자의 개발자가 이를 정의한 다음 다른 개발자가 사용할 수 있도록 해야 합니다.
- Android 플랫폼 내에 포함된 제공자는 대부분 패키지
+ Android 플랫폼 내에 포함된 제공자는 대부분 패키지
{@link android.provider} 안에 상응하는 계약 클래스를 가지고 있습니다.
예를 들어, 사용자 사전 제공자에는 콘텐츠 URI와 열 이름 상수가 들어 있는
-{@link android.provider.UserDictionary} 계약 클래스가 있습니다.
+{@link android.provider.UserDictionary} 계약 클래스가 있습니다.
"단어" 테이블에 대한 콘텐츠 URI는 상수
{@link android.provider.UserDictionary.Words#CONTENT_URI UserDictionary.Words.CONTENT_URI}에 정의됩니다.
- {@link android.provider.UserDictionary.Words} 클래스에도
-열 이름 상수가 들어 있으며, 이는 이 가이드의 예시 조각에서 사용됩니다.
+ {@link android.provider.UserDictionary.Words} 클래스에도
+열 이름 상수가 들어 있으며, 이는 이 가이드의 예시 조각에서 사용됩니다.
예를 들어 쿼리 프로젝션은 다음과 같이 정의될 수 있습니다.
@@ -1106,7 +1106,7 @@ String[] mProjection =
또 다른 계약 클래스는 연락처 제공자의 {@link android.provider.ContactsContract}입니다.
- 이 클래스에 대한 참조 문서에는 예시 코드 조각이 포함되어 있습니다.
+ 이 클래스에 대한 참조 문서에는 예시 코드 조각이 포함되어 있습니다.
이것의 하위 클래스 중 하나인 {@link android.provider.ContactsContract.Intents.Insert}는
인텐트와 인텐트 데이터의 상수가 들어 있는 계약 클래스입니다.
@@ -1129,7 +1129,7 @@ String[] mProjection =
해당 URI를 사용하는 쿼리가 HTML 태그가 들어 있는 텍스트를 반환할 것이라는 뜻입니다.
- 사용자 지정 MIME 유형 문자열은 "공급업체별" MIME 유형이라고도 불리며
+ 사용자 지정 MIME 유형 문자열은 "공급업체별" MIME 유형이라고도 불리며
이쪽의 유형과 하위 유형 값이 더 복잡합니다. 유형 값은 경우에 따라 항상 다음과 같습니다.
- 대부분의 콘텐츠 제공자는 자신이 사용하는 MIME 유형에 대한 계약 클래스 상수를 정의합니다.
+ 대부분의 콘텐츠 제공자는 자신이 사용하는 MIME 유형에 대한 계약 클래스 상수를 정의합니다.
예를 들어, 연락처 제공자 계약 클래스 {@link android.provider.ContactsContract.RawContacts}는
단일 연락처 행의 MIME 유행에 대한
상수 {@link android.provider.ContactsContract.RawContacts#CONTENT_ITEM_TYPE}을
정의합니다.
- 한 행에 대한 콘텐츠 URI는
+ 한 행에 대한 콘텐츠 URI는
콘텐츠 URI 섹션에 설명되어 있습니다.
diff --git a/docs/html-intl/intl/ko/guide/topics/providers/content-provider-creating.jd b/docs/html-intl/intl/ko/guide/topics/providers/content-provider-creating.jd
index 6757194a9f288..af7b584c6257a 100644
--- a/docs/html-intl/intl/ko/guide/topics/providers/content-provider-creating.jd
+++ b/docs/html-intl/intl/ko/guide/topics/providers/content-provider-creating.jd
@@ -95,16 +95,16 @@ page.title= 콘텐츠 제공자 생성
- 콘텐츠 제공자는 데이터의 중앙 리포지토리로의 액세스를 관리합니다. Android 애플리케이션에서는
+ 콘텐츠 제공자는 데이터의 중앙 리포지토리로의 액세스를 관리합니다. Android 애플리케이션에서는
제공자를 하나 이상의 클래스로, 매니페스트 파일에 있는 요소와 함께 구현합니다.
- 클래스 중 하나가 하위 클래스
-{@link android.content.ContentProvider}를 구현하며,
-이것이 제공자와 다른 애플리케이션 사이의 인터페이스입니다. 콘텐츠 제공자는 다른 애플리케이션에 데이터를 사용할 수 있게 해주도록 만들어져 있지만,
-물론 애플리케이션 내에 사용자로 하여금 제공자가 관리하는 데이터를 쿼리하고 수정할 수 있게 허용하는
+ 클래스 중 하나가 하위 클래스
+{@link android.content.ContentProvider}를 구현하며,
+이것이 제공자와 다른 애플리케이션 사이의 인터페이스입니다. 콘텐츠 제공자는 다른 애플리케이션에 데이터를 사용할 수 있게 해주도록 만들어져 있지만,
+물론 애플리케이션 내에 사용자로 하여금 제공자가 관리하는 데이터를 쿼리하고 수정할 수 있게 허용하는
액티비티가 있을 수도 있습니다.
- 이 주제의 나머지 부분은 콘텐츠 제공자를 구축하기 위한 기본 단계 목록과
+ 이 주제의 나머지 부분은 콘텐츠 제공자를 구축하기 위한 기본 단계 목록과
사용할 API 목록으로 이루어져 있습니다.
@@ -124,12 +124,12 @@ page.title= 콘텐츠 제공자 생성
검색 프레임워크를 사용한 사용자 지정 검색 제안을 제공하고자 하는 경우
- 용도가 본인의 애플리케이션 안에서로 완전히 한정되어 있는 경우에는
+ 용도가 본인의 애플리케이션 안에서로 완전히 한정되어 있는 경우에는
제공자가 SQLite 데이터베이스를 사용하도록 하지 않아도 됩니다.
- 아직 읽지 않았다면, 지금 바로
+ 아직 읽지 않았다면, 지금 바로
콘텐츠 제공자 기본 정보를 읽고 제공자에 대해 자세히 알아보십시오.
@@ -146,8 +146,8 @@ page.title= 콘텐츠 제공자 생성
일반적으로 사진, 오디오 또는 동영상과 같은
-파일에 들어가는 데이터입니다. 이런 파일을 애플리케이션의 비공개
-공간에 저장합니다. 제공자는 다른 애플리케이션으로부터 온 파일 요청에 응답하여
+파일에 들어가는 데이터입니다. 이런 파일을 애플리케이션의 비공개
+공간에 저장합니다. 제공자는 다른 애플리케이션으로부터 온 파일 요청에 응답하여
해당 파일로의 핸들을 제공할 수 있습니다.
@@ -155,9 +155,9 @@ page.title= 콘텐츠 제공자 생성
일반적으로 데이터베이스, 배열 또는 유사 구조에 들어가는 데이터입니다.
- 이 데이터를 행과 열로 이루어진 테이블과 호환되는 형식으로 저장합니다.
-행은 사람이나 인벤토리의 항목과 같은 엔티티를 나타냅니다.
-열은 해당 엔티티에 대한 몇 가지 데이터, 예를 들어 사람 이름이나 항목 가격 등을 나타냅니다.
+ 이 데이터를 행과 열로 이루어진 테이블과 호환되는 형식으로 저장합니다.
+행은 사람이나 인벤토리의 항목과 같은 엔티티를 나타냅니다.
+열은 해당 엔티티에 대한 몇 가지 데이터, 예를 들어 사람 이름이나 항목 가격 등을 나타냅니다.
이 유형의 데이터를 저장하는 보편적인 방법은 SQLite 데이터베이스 안에 저장하는 것이지만,
모든 유형의 영구적인 저장소를 사용해도 됩니다. Android 시스템에서 사용할 수 있는 저장소 유형에 대해 자세히 알아보려면,
@@ -172,11 +172,11 @@ page.title= 콘텐츠 제공자 생성
ContentProvider 클래스 구현 섹션을 참조하십시오.
- 제공자의 권한 문자열, 그 콘텐츠 URI 및 열 이름을 정의합니다.
+ 제공자의 권한 문자열, 그 콘텐츠 URI 및 열 이름을 정의합니다.
제공자 애플리케이션이 인텐트를 처리하게 하려면, 인텐트 작업과 추가 데이터 및
-플래그도 정의합니다. 데이터에 액세스하기를 원하는 애플리케이션에 요구할 권한도
-정의합니다. 이 모든 값은 별도의 계약 클래스에서 상수로 정의하는 것을 고려해보는
-것이 좋습니다. 이 클래스를 나중에 다른 개발자에게 노출할 수 있습니다.
+플래그도 정의합니다. 데이터에 액세스하기를 원하는 애플리케이션에 요구할 권한도
+정의합니다. 이 모든 값은 별도의 계약 클래스에서 상수로 정의하는 것을 고려해보는
+것이 좋습니다. 이 클래스를 나중에 다른 개발자에게 노출할 수 있습니다.
콘텐츠 URI에 관한 자세한 정보는
콘텐츠 URI 설계 섹션을 참조하십시오.
인텐트에 관한 자세한 정보는
@@ -193,8 +193,8 @@ page.title= 콘텐츠 제공자 생성
데이터 저장소 설계
- 콘텐츠 제공자는 구조화된 형식으로 저장된 데이터로의 인터페이스입니다.
-인터페이스를 생성하기 전에 우선 데이터 저장 방식부터 결정해야 합니다.
+ 콘텐츠 제공자는 구조화된 형식으로 저장된 데이터로의 인터페이스입니다.
+인터페이스를 생성하기 전에 우선 데이터 저장 방식부터 결정해야 합니다.
데이터는 원하는 형식 아무 것으로나 저장할 수 있으며 그런 다음에 필요에 따라 해당 데이터를 읽고 쓸 인터페이스를 설계합니다.
@@ -203,26 +203,26 @@ page.title= 콘텐츠 제공자 생성
Android 시스템에는 Android 자체 제공자가 테이블 지향적 데이터를
-저장하는 데 사용하는 SQLite 데이터베이스 API가 포함됩니다.
+저장하는 데 사용하는 SQLite 데이터베이스 API가 포함됩니다.
{@link android.database.sqlite.SQLiteOpenHelper} 클래스는 데이터베이스를 생성할 수 있게 돕고,
{@link android.database.sqlite.SQLiteDatabase} 클래스는 데이터베이스 액세스를 위한
기본 클래스입니다.
- 리포지토리를 구현하기 위해 데이터베이스를 사용하지 않아도 된다는 점을 기억하십시오.
-제공자는 외부에 테이블 집합으로 나타나 관계적 데이터베이스와 비슷해 보이지만,
+ 리포지토리를 구현하기 위해 데이터베이스를 사용하지 않아도 된다는 점을 기억하십시오.
+제공자는 외부에 테이블 집합으로 나타나 관계적 데이터베이스와 비슷해 보이지만,
이것은 제공자의 내부 구현에 필요한 것은 아닙니다.
파일 데이터를 저장하는 데 있어 Android에는 다양한 파일 지향적 API가 있습니다.
파일 저장소에 관해 자세히 알아보려면
-데이터 저장소 주제를 읽어 보십시오.
-음악이나 동영상 등 미디어 관련 데이터를 제공하는 제공자를 설계하는 경우,
+데이터 저장소 주제를 읽어 보십시오.
+음악이나 동영상 등 미디어 관련 데이터를 제공하는 제공자를 설계하는 경우,
제공자가 테이블 데이터와 파일을 조합 할 수 있습니다.
- 네트워크 기반 데이터를 다루는 경우, {@link java.net} 및
-{@link android.net} 내의 클래스를 사용하십시오. 네트워크 기반 데이터를
+ 네트워크 기반 데이터를 다루는 경우, {@link java.net} 및
+{@link android.net} 내의 클래스를 사용하십시오. 네트워크 기반 데이터를
데이터베이스와 같은 로컬 데이터 스토어와 동기화한 다음, 해당 데이터를 테이블이나 파일로 제공할 수도 있습니다.
샘플 동기화 어댑터 샘플 애플리케이션이 이런 유형의 동기화를 보여줍니다.
@@ -237,7 +237,7 @@ page.title= 콘텐츠 제공자 생성
테이블 데이터는 언제나 제공자가 유지관리하는 "기본 키" 열을
-각 행의 고유한 숫자 값으로 보유하고 있어야 합니다. 이 값을 사용하여 해당 행을 다른 테이블의
+각 행의 고유한 숫자 값으로 보유하고 있어야 합니다. 이 값을 사용하여 해당 행을 다른 테이블의
관련 행에 연결시킬 수 있습니다(이를 "외래 키"로 사용). 이 열에는 어느 이름이든 사용할 수 있지만
{@link android.provider.BaseColumns#_ID BaseColumns._ID}를 사용하는 것이 가장 좋습니다.
왜냐하면 제공자 쿼리 결과를
@@ -246,8 +246,8 @@ page.title= 콘텐츠 제공자 생성
비트맵 이미지나 파일 지향적 데이터의 매우 큰 조각을 제공하려면
-테이블 안에 직접 저장하기보다는 파일에 데이터를 저장한 뒤
-간접적으로 제공합니다. 이렇게 하는 경우, 제공자의 사용자들에게 데이터에 액세스하려면
+테이블 안에 직접 저장하기보다는 파일에 데이터를 저장한 뒤
+간접적으로 제공합니다. 이렇게 하는 경우, 제공자의 사용자들에게 데이터에 액세스하려면
{@link android.content.ContentResolver} 파일 메서드를 사용해야 한다고 알려야 합니다.
@@ -256,12 +256,12 @@ page.title= 콘텐츠 제공자 생성
프로토콜 버퍼 또는
JSON 구조를 저장할 수 있습니다.
- BLOB를 사용하여 스키마에 종속되지 않은 테이블을 구현할 수도 있습니다.
+ BLOB를 사용하여 스키마에 종속되지 않은 테이블을 구현할 수도 있습니다.
이 유형의 테이블에서는, 기본 키 열, MIME 유형 열 및 하나 이상의 일반적인 열을 BLOB로 정의합니다.
-
-BLOB 열에 있는 데이터의 의미는 MIME 유형 열에 있는 값으로 나타냅니다.
-이렇게 하면 같은 테이블에 여러 가지 행 유형을 저장할 수 있습니다. 연락처 제공자의 "데이터" 테이블
-{@link android.provider.ContactsContract.Data}가
+
+BLOB 열에 있는 데이터의 의미는 MIME 유형 열에 있는 값으로 나타냅니다.
+이렇게 하면 같은 테이블에 여러 가지 행 유형을 저장할 수 있습니다. 연락처 제공자의 "데이터" 테이블
+{@link android.provider.ContactsContract.Data}가
스키마에 종속되지 않은 테이블의 한 가지 예입니다.
@@ -269,11 +269,11 @@ BLOB 열에 있는 데이터의 의미는 MIME 유형 열에 있는 값으로
콘텐츠 URI 설계
- 콘텐츠 URI는 제공자에서 데이터를 식별하는 URI입니다.
+ 콘텐츠 URI는 제공자에서 데이터를 식별하는 URI입니다.
콘텐츠 URI에는 전체 제공자의 상징적인 이름(제공자의 권한)과
-테이블 또는 파일을 가리키는 이름(경로)이 포함됩니다.
-선택 항목 ID 부분은 테이블 내의 개별적인 행을 가리킵니다.
-{@link android.content.ContentProvider}의 모든 데이터 액세스 메서드는
+테이블 또는 파일을 가리키는 이름(경로)이 포함됩니다.
+선택 항목 ID 부분은 테이블 내의 개별적인 행을 가리킵니다.
+{@link android.content.ContentProvider}의 모든 데이터 액세스 메서드는
콘텐츠 URI를 인수로 가집니다. 이를 통해 액세스할 테이블, 행 또는 파일을 결정할 수 있습니다.
@@ -283,9 +283,9 @@ BLOB 열에 있는 데이터의 의미는 MIME 유형 열에 있는 값으로
권한 설계
- 제공자에는 보통 하나의 권한이 있으며, 이것이 Android 내부 이름 역할을 합니다.
+ 제공자에는 보통 하나의 권한이 있으며, 이것이 Android 내부 이름 역할을 합니다.
다른 제공자와의 충돌을 피하려면, 제공자 권한의 기반으로 인터넷 도메인 소유권(역방향)을
-사용해야 합니다. 이 권장 사항은 Android 패키지 이름에도 적용되므로,
+사용해야 합니다. 이 권장 사항은 Android 패키지 이름에도 적용되므로,
제공자 권한을 제공자가 들어 있는 패키지의 이름 확장자로 정의해도 됩니다.
예를 들어, Android 패키지 이름이
com.example.<appname>라면, 제공자에게
@@ -293,40 +293,40 @@ BLOB 열에 있는 데이터의 의미는 MIME 유형 열에 있는 값으로
경로 구조 설계
- 개발자는 보통 권한으로부터 콘텐츠 URI를 생성할 때 개별적인 테이블을 가리키는
+ 개발자는 보통 권한으로부터 콘텐츠 URI를 생성할 때 개별적인 테이블을 가리키는
경로를 추가하는 방식을 사용합니다. 예를 들어, table1과
table2라는 테이블이 있다면, 이전 예시의 권한을 조합하여
-콘텐츠 URIcom.example.<appname>.provider/table1와
+콘텐츠 URIcom.example.<appname>.provider/table1와
com.example.<appname>.provider/table2를 도출합니다.
-
+
경로는 하나의 세그먼트에 국한되지 않으며, 경로의 각 수준에 대한 테이블이 아니어도 됩니다.
콘텐츠 URI ID 처리
- 규칙에 의하면, 제공자는 URI 맨 끝에서 행에 대한 ID 값이 있는 콘텐츠 URI를 허용하여
-테이블 내 하나의 행으로의 액세스를 제공합니다. 또한 규칙에 의해 제공자는
-이 ID 값을 테이블의 _ID 열에 일치시켜야 하며,
+ 규칙에 의하면, 제공자는 URI 맨 끝에서 행에 대한 ID 값이 있는 콘텐츠 URI를 허용하여
+테이블 내 하나의 행으로의 액세스를 제공합니다. 또한 규칙에 의해 제공자는
+이 ID 값을 테이블의 _ID 열에 일치시켜야 하며,
일치한 행에 대하여 요청된 액세스 허가를 수행해야 합니다.
- 이 규칙은 제공자에 액세스하는 앱을 위한 공통 설계 패턴을 세우는 데 유용합니다.
+ 이 규칙은 제공자에 액세스하는 앱을 위한 공통 설계 패턴을 세우는 데 유용합니다.
앱이 제공자에 대한 쿼리를 수행하고 그 결과로 나온 {@link android.database.Cursor}를
{@link android.widget.ListView}에 {@link android.widget.CursorAdapter}를 사용하여 표시합니다.
- {@link android.widget.CursorAdapter}의 정의에 따르면
+ {@link android.widget.CursorAdapter}의 정의에 따르면
{@link android.database.Cursor} 안의 열 중 하나는 _ID여야 합니다.
- 그러면 사용자가 데이터를 살펴보거나 수정하기 위하여
+ 그러면 사용자가 데이터를 살펴보거나 수정하기 위하여
UI에서 표시된 여러 행 중 하나를 선택합니다. 앱은 {@link android.widget.ListView}를 지원하는 {@link android.database.Cursor}에서 해당하는 열을 가져오고,
해당 열에 대한 _ID 값을 가져와서
-콘텐츠 URI에 추가하고, 제공자에 액세스 요청을 전송합니다. 그런 다음 제공자는
+콘텐츠 URI에 추가하고, 제공자에 액세스 요청을 전송합니다. 그런 다음 제공자는
사용자가 선택한 바로 그 행에 대해 쿼리 또는 수정 작업을 수행할 수 있습니다.
콘텐츠 URI 패턴
- 수신되는 콘텐츠 URI에 대해 어떤 조치를 취할지 선택하는 데 도움이 되도록 하기 위해 제공자 API에
-편의 클래스 {@link android.content.UriMatcher}가
-포함되어 있습니다. 이는 콘텐츠 URI "패턴"을 정수값으로 매핑합니다. 이 정수값은 특정 패턴에 일치하는
+ 수신되는 콘텐츠 URI에 대해 어떤 조치를 취할지 선택하는 데 도움이 되도록 하기 위해 제공자 API에
+편의 클래스 {@link android.content.UriMatcher}가
+포함되어 있습니다. 이는 콘텐츠 URI "패턴"을 정수값으로 매핑합니다. 이 정수값은 특정 패턴에 일치하는
콘텐츠 URI 또는 여러 URI에 대해 원하는 작업을 선택하는 데 switch 문에서 사용할 수 있습니다.
@@ -341,8 +341,8 @@ UI에서 표시된 여러 행 중 하나를 선택합니다. 앱은 {@link andro
- 콘텐츠 URI 처리의 설계와 코딩에 대한 예시로서 임의의 제공자를 들어 보겠습니다.
-이 제공자에는 권한 com.example.app.provider가 있고
+ 콘텐츠 URI 처리의 설계와 코딩에 대한 예시로서 임의의 제공자를 들어 보겠습니다.
+이 제공자에는 권한 com.example.app.provider가 있고
이 권한이 테이블을 가리키는 다음 콘텐츠 URI를 인식합니다.
@@ -350,11 +350,11 @@ UI에서 표시된 여러 행 중 하나를 선택합니다. 앱은 {@link andro
content://com.example.app.provider/table1: table1이라는 테이블입니다.
@@ -363,7 +363,7 @@ UI에서 표시된 여러 행 중 하나를 선택합니다. 앱은 {@link andro
제공자는 추가된 행 ID가 있으면 이런 콘텐츠 URI도 인식합니다.
-예를 들어, table3에서 1이 식별한 행에 대한
+예를 들어, table3에서 1이 식별한 행에 대한
content://com.example.app.provider/table3/1이 이에 해당됩니다.
@@ -385,7 +385,7 @@ UI에서 표시된 여러 행 중 하나를 선택합니다. 앱은 {@link andro
table3에 대한 콘텐츠 URI와 일치하지 않습니다.
- content://com.example.app.provider/table3/#:
+ content://com.example.app.provider/table3/#:
table3의 단일 행에 대한 콘텐츠 URI와 일치합니다. 예를 들어,
6이 식별한 행에 대한 content://com.example.app.provider/table3/6이 이에 해당됩니다.
@@ -393,8 +393,8 @@ UI에서 표시된 여러 행 중 하나를 선택합니다. 앱은 {@link andro
다음 코드 조각은 {@link android.content.UriMatcher} 작업에서 메서드의 작용 원리를 나타낸 것입니다.
- 이 코드는 테이블에 대한 콘텐츠 URI 패턴 content://<authority>/<path>와
-단일 행에 대한 콘텐츠 URI 패턴 content://<authority>/<path>/<id>를 사용하여
+ 이 코드는 테이블에 대한 콘텐츠 URI 패턴 content://<authority>/<path>와
+단일 행에 대한 콘텐츠 URI 패턴 content://<authority>/<path>/<id>를 사용하여
단일 행에 대한 URI와 전체 테이블에 대한 URI를 서로 다르게 처리합니다.
@@ -468,7 +468,7 @@ public class ExampleProvider extends ContentProvider {
}
- 또 다른 클래스, {@link android.content.ContentUris}가
+ 또 다른 클래스, {@link android.content.ContentUris}가
콘텐츠 URI의 id 부분을 다루기 위한 편의 메서드를 제공합니다. 클래스 {@link android.net.Uri}와
{@link android.net.Uri.Builder}에는
기존 {@link android.net.Uri} 개체를 구문 분석하고 새로운 개체를 구축하기 위한 편의 메서드가 포함되어 있습니다.
@@ -478,15 +478,15 @@ public class ExampleProvider extends ContentProvider {
ContentProvider 클래스 구현
{@link android.content.ContentProvider} 인스턴스는
-다른 애플리케이션으로부터의 요청을 처리하여 구조화된 데이터 세트로의 액세스를 관리합니다.
-모든 형태의 액세서가 궁극적으로 {@link android.content.ContentResolver}를 호출하며,
+다른 애플리케이션으로부터의 요청을 처리하여 구조화된 데이터 세트로의 액세스를 관리합니다.
+모든 형태의 액세서가 궁극적으로 {@link android.content.ContentResolver}를 호출하며,
그러면 이것이 액세스 권한을 얻기 위해 구체적인 {@link android.content.ContentProvider} 메서드를 호출합니다.
필수 메서드
- 추상 클래스 {@link android.content.ContentProvider}는
-개발자가 나름의 구체적인 하위 클래스의 일부분으로 구현해야만 하는 여섯 가지 추상 메서드를 정의합니다. 이와 같은 메서드는 모두
-({@link android.content.ContentProvider#onCreate() onCreate()}는 예외)
+ 추상 클래스 {@link android.content.ContentProvider}는
+개발자가 나름의 구체적인 하위 클래스의 일부분으로 구현해야만 하는 여섯 가지 추상 메서드를 정의합니다. 이와 같은 메서드는 모두
+({@link android.content.ContentProvider#onCreate() onCreate()}는 예외)
콘텐츠 제공자에 액세스하려 시도 중인 클라이언트 애플리케이션이 호출합니다.
- 제공자를 초기화합니다. Android 시스템은 제공자를 생성한 직후
-이 메서드를 호출합니다.
+ 제공자를 초기화합니다. Android 시스템은 제공자를 생성한 직후
+이 메서드를 호출합니다.
{@link android.content.ContentResolver} 개체가 제공자에 액세스하려고 시도할 때까지는 제공자가 생성된 것이 아니라는 점을 유의하십시오.
- 이와 같은 메서드에는 동일하게 이름 붙여진
+ 이와 같은 메서드에는 동일하게 이름 붙여진
{@link android.content.ContentResolver} 메서드와 같은 서명이 있다는 것을 눈여겨 보십시오.
@@ -548,8 +548,8 @@ update()}
이런 메서드는 모두({@link android.content.ContentProvider#onCreate() onCreate()}는 예외)
- 한꺼번에 여러 스레드가 호출할 수 있으므로, 스레드로부터 안전해야 합니다.
-다중 스레드에 대한 자세한 내용은
+ 한꺼번에 여러 스레드가 호출할 수 있으므로, 스레드로부터 안전해야 합니다.
+다중 스레드에 대한 자세한 내용은
프로세스 및 스레드 주제를 참조하십시오.
@@ -560,16 +560,16 @@ onCreate()}에서는 긴 작업을 수행하는 것을 삼가는 것이 좋습
섹션에서 더욱 자세히 논의합니다.
- 이와 같은 메서드는 반드시 구현해야 하는 것이지만,
-예상되는 데이터 유형을 반환하는 것 외에 달리 코드가 해야 할 일은 없습니다.
+ 이와 같은 메서드는 반드시 구현해야 하는 것이지만,
+예상되는 데이터 유형을 반환하는 것 외에 달리 코드가 해야 할 일은 없습니다.
예를 들어 몇몇 테이블에 다른 애플리케이션이 데이터를 삽입하지 못하도록 방지하려고 합니다. 이렇게 하려면,
-{@link android.content.ContentProvider#insert(Uri, ContentValues) insert()}로의
+{@link android.content.ContentProvider#insert(Uri, ContentValues) insert()}로의
호출을 무시하고 0을 반환하면 됩니다.
query() 메서드 구현
-
+
{@link android.content.ContentProvider#query(Uri, String[], String, String[], String)
ContentProvider.query()} 메서드는 {@link android.database.Cursor} 개체를 반환해야 하고, 그렇지 못할 경우
{@link java.lang.Exception}을 발생시킵니다. SQLite 데이터베이스를 데이터 저장소로 사용하는 경우,
@@ -587,7 +587,7 @@ ContentProvider.query()} 메서드는 {@link android.database.Cursor} 개체를
Android 시스템이 프로세스 경계를 가로질러 {@link java.lang.Exception}을
- 통신으로 전달할 수 있어야 한다는 점을 유의하십시오. Android가 이 작업을 할 수 있는 경우는
+ 통신으로 전달할 수 있어야 한다는 점을 유의하십시오. Android가 이 작업을 할 수 있는 경우는
쿼리 오류 처리에 유용할 수 있는 다음과 같은 예외에 해당될 때입니다.
- 이 메서드가 새 행에 대한 콘텐츠 URI를 반환하는 것이 정상입니다. 이것을 구성하려면 새 행의
-_ID(또는 다른 기본 키) 값을 테이블의 콘텐츠 URI에 추가하며, 이때
+ 이 메서드가 새 행에 대한 콘텐츠 URI를 반환하는 것이 정상입니다. 이것을 구성하려면 새 행의
+_ID(또는 다른 기본 키) 값을 테이블의 콘텐츠 URI에 추가하며, 이때
{@link android.content.ContentUris#withAppendedId(Uri, long) withAppendedId()}를 사용합니다.
delete() 메서드 구현
{@link android.content.ContentProvider#delete(Uri, String, String[]) delete()} 메서드의 경우
- 데이터 저장소에서 물리적으로 행을 삭제하지 않아도 됩니다.
-제공자와 동기화 어댑터를 함께 사용하고 있는 경우,
-삭제된 행을 완전히 제거하기보다는 "삭제" 플래그로 표시하는 방법을 고려해볼 만합니다.
+ 데이터 저장소에서 물리적으로 행을 삭제하지 않아도 됩니다.
+제공자와 동기화 어댑터를 함께 사용하고 있는 경우,
+삭제된 행을 완전히 제거하기보다는 "삭제" 플래그로 표시하는 방법을 고려해볼 만합니다.
동기화 어댑터가 삭제된 행을 확인한 다음, 이를 제공자에서 삭제하기 전에 우선 서버에서 제거합니다.
Update() 메서드 구현
@@ -633,20 +633,20 @@ ContentProvider.query()}가 사용하는 것과 같은 selection
onCreate() 메서드 구현
Android 시스템은 제공자를 시작할 때 {@link android.content.ContentProvider#onCreate()
-onCreate()}를 호출합니다. 이 메서드에서는 빠르게 실행되는 초기화만 수행해야 하며,
+onCreate()}를 호출합니다. 이 메서드에서는 빠르게 실행되는 초기화만 수행해야 하며,
데이터베이스 생성과 데이터 로딩은 제공자가 실제로 데이터에 대한 요청을 받을 때까지 미뤄두어야 합니다.
-
+
{@link android.content.ContentProvider#onCreate() onCreate()}에서 긴 작업을 수행하면
제공자의 시동 속도가 느려집니다. 이 때문에 제공자에서 다른 애플리케이션으로 전달되는 응답도 따라서 느려집니다.
예를 들어, SQLite 데이터베이스를 사용하는 경우
-{@link android.content.ContentProvider#onCreate() ContentProvider.onCreate()}에서
+{@link android.content.ContentProvider#onCreate() ContentProvider.onCreate()}에서
새로운 {@link android.database.sqlite.SQLiteOpenHelper} 개체를 생성하고,
그런 다음 데이터베이스를 처음 열 때 SQL 테이블을 생성할 수 있습니다. 이를 용이하게 하기 위해
{@link android.database.sqlite.SQLiteOpenHelper#getWritableDatabase
-getWritableDatabase()}를 처음 호출하면 이것이 자동으로
+getWritableDatabase()}를 처음 호출하면 이것이 자동으로
{@link android.database.sqlite.SQLiteOpenHelper#onCreate(SQLiteDatabase)
SQLiteOpenHelper.onCreate()} 메서드를 호출합니다.
@@ -776,7 +776,7 @@ protected static final class MainDatabaseHelper extends SQLiteOpenHelper {
텍스트, HTML 또는 JPEG와 같은 보편적인 유형의 데이터라면
-{@link android.content.ContentProvider#getType(Uri) getType()}이
+{@link android.content.ContentProvider#getType(Uri) getType()}이
해당 데이터에 대한 표준 MIME 유형을 반환하는 것이 정상입니다. 이러한 표준 유형의 전체 목록은
IANA MIME 미디어 유형
웹사이트에서 확인할 수 있습니다.
@@ -807,17 +807,17 @@ MIME 형식을 반환해야 합니다.
개발자가 <name>과 <type>을 제공합니다.
<name> 값은 전체적으로 고유해야 하고,
<type> 값은 상응하는 URI 패턴에 고유해야
-합니다. <name>으로 좋은 예는 회사 이름이나
-애플리케이션의 Android 패키지 이름을 들 수 있습니다.
-<type>으로 좋은 예는 URI와 연관된 테이블을 식별하는
+합니다. <name>으로 좋은 예는 회사 이름이나
+애플리케이션의 Android 패키지 이름을 들 수 있습니다.
+<type>으로 좋은 예는 URI와 연관된 테이블을 식별하는
문자열을 들 수 있습니다.
- 예를 들어 어떤 제공자의 권한이
-com.example.app.provider이고, 이것이
+ 예를 들어 어떤 제공자의 권한이
+com.example.app.provider이고, 이것이
table1이라는 테이블을 노출하는 경우, table1의 여러 행에 대한 MIME 유형은 다음과 같습니다.
제공자가 파일을 제공하는 경우,
{@link android.content.ContentProvider#getStreamTypes(Uri, String) getStreamTypes()}를 구현합니다.
- 이 메서드는 제공자가 주어진 콘텐츠 URI에 대해 반환할 수 있는 파일에 대한 MIME 유형의 {@link java.lang.String} 배열을 반환합니다.
-제공하는 MIME 유형을 MIME 유형 필터 인수 기준으로 필터링해야
+ 이 메서드는 제공자가 주어진 콘텐츠 URI에 대해 반환할 수 있는 파일에 대한 MIME 유형의 {@link java.lang.String} 배열을 반환합니다.
+제공하는 MIME 유형을 MIME 유형 필터 인수 기준으로 필터링해야
클라이언트가 처리하고자 하는 MIME 유형만 반환할 수 있습니다.
@@ -850,16 +850,16 @@ ContentProvider.getStreamTypes()} 메서드가 다음과 같은 배열을 반환
{ "image/jpeg", "image/png", "image/gif"}
- 앱이 .jpg 파일에만 관심이 있는 경우에는
+ 앱이 .jpg 파일에만 관심이 있는 경우에는
필터 문자열 *\/jpeg으로 {@link android.content.ContentResolver#getStreamTypes(Uri, String)
- ContentResolver.getStreamTypes()}를 호출할 수 있습니다. 그러면
+ ContentResolver.getStreamTypes()}를 호출할 수 있습니다. 그러면
{@link android.content.ContentProvider#getStreamTypes(Uri, String)
ContentProvider.getStreamTypes()}가 다음과 같이 반환하는 것이 정상입니다.
{"image/jpeg"}
- 제공자가 필터 문자열에서 요청한 MIME 유형 중 제공하는 것이 없는 경우,
+ 제공자가 필터 문자열에서 요청한 MIME 유형 중 제공하는 것이 없는 경우,
{@link android.content.ContentProvider#getStreamTypes(Uri, String) getStreamTypes()}가
null을 반환하는 것이 정상입니다.
@@ -868,76 +868,76 @@ ContentProvider.getStreamTypes()} 메서드가 다음과 같은 배열을 반환
계약 클래스 구현
- 계약 클래스는 public final 클래스로, 이 안에 URI, 열 이름, MIME 유형의
-상수 정의 및 제공자에 관련된 다른 메타 데이터가 들어 있습니다.
+ 계약 클래스는 public final 클래스로, 이 안에 URI, 열 이름, MIME 유형의
+상수 정의 및 제공자에 관련된 다른 메타 데이터가 들어 있습니다.
이 클래스는 URI, 열 이름 등의 실제 값에 변경된 내용이 있더라도
- 제공자에 올바르게 액세스할 수 있도록 보장하여 제공자와
+ 제공자에 올바르게 액세스할 수 있도록 보장하여 제공자와
다른 애플리케이션 사이의 계약을 확립합니다.
- 계약 클래스가 개발자에게 유용한 이유는 또 있습니다. 이 클래스는 보통 자신의 상수 이름으로
-니모닉 이름을 가지기 때문에 개발자가 열 이름 또는 URI에 잘못된 값을 사용할 가능성이 덜합니다.
-이것도 클래스의 일종이기 때문에 Javadoc 문서를 포함할 수 있습니다.
+ 계약 클래스가 개발자에게 유용한 이유는 또 있습니다. 이 클래스는 보통 자신의 상수 이름으로
+니모닉 이름을 가지기 때문에 개발자가 열 이름 또는 URI에 잘못된 값을 사용할 가능성이 덜합니다.
+이것도 클래스의 일종이기 때문에 Javadoc 문서를 포함할 수 있습니다.
Eclipse와 같은 통합 개발 환경은 계약 클래스의 상수 이름을 자동 완성하고
해당 상수에 대한 Javadoc을 표시할 수 있습니다.
- 개발자가 애플리케이션에서 계약 클래스의 클래스 파일에 액세스할 수는 없지만
+ 개발자가 애플리케이션에서 계약 클래스의 클래스 파일에 액세스할 수는 없지만
여러분이 제공하는 .jar 파일에서 이를 애플리케이션 안으로 정적으로 컴파일링할 수 있습니다.
- {@link android.provider.ContactsContract} 클래스와
+ {@link android.provider.ContactsContract} 클래스와
이에 중첩된 클래스가 계약 클래스의 예시입니다.
콘텐츠 제공자 권한 구현
Android 시스템의 모든 측면에 대한 권한과 액세스는
보안 및 권한 주제에 설명되어 있습니다.
- 데이터 저장소 주제에서도
+ 데이터 저장소 주제에서도
다양한 유형의 저장소에 적용되는 보안 및 권한을 설명하고 있습니다.
간략히 말해 요점은 다음과 같습니다.
- 기본적으로, 기기의 내부 저장소에 저장된 데이터 파일은
+ 기본적으로, 기기의 내부 저장소에 저장된 데이터 파일은
본인의 애플리케이션과 제공자 전용입니다.
- 본인이 생성한 {@link android.database.sqlite.SQLiteDatabase} 데이터베이스는
+ 본인이 생성한 {@link android.database.sqlite.SQLiteDatabase} 데이터베이스는
본인의 애플리케이션과 제공자만의 비공개 데이터입니다.
기본적으로 외부 저장소에 저장하는 데이터 파일은 공개이고
-누구나 읽을 수 있습니다. 외부 저장소에 있는 파일로의 액세스를 제공하는 데 콘텐츠 제공자를 쓸 수는
+누구나 읽을 수 있습니다. 외부 저장소에 있는 파일로의 액세스를 제공하는 데 콘텐츠 제공자를 쓸 수는
없습니다. 다른 애플리케이션이 다른 API 호출을 사용하여 해당 파일을 읽고 쓸 수 있기 때문입니다.
기기의 내부 저장소에 있는 파일 또는 SQLite 데이터베이스를 열거나 생성하기 위한 메서드 호출은
-다른 모든 애플리케이션에 읽기 및 쓰기 액세스 권한을 허가할 가능성이 있습니다.
+다른 모든 애플리케이션에 읽기 및 쓰기 액세스 권한을 허가할 가능성이 있습니다.
내부 파일이나 데이터베이스를 제공자의 리포지토리로 사용하고
-"누구나 읽을 수 있는" 또는 "누구나 쓸 수 있는" 액세스를 부여하면
-매니페스트에서 제공자에 대해 설정한 권한이 데이터를 보호하지 못합니다.
+"누구나 읽을 수 있는" 또는 "누구나 쓸 수 있는" 액세스를 부여하면
+매니페스트에서 제공자에 대해 설정한 권한이 데이터를 보호하지 못합니다.
내부 저장소 안에 있는 파일과 데이터베이스에 대한기본 액세스는 "비공개"이며, 제공자의 리포지토리가 이것을 변경하면 안 됩니다.
- 데이터로의 액세스를 제어하기 위해 콘텐츠 제공자 권한을 쓰고자 하는 경우,
-데이터를 내부 파일, SQLite 데이터베이스 또는 "클라우드"(예: 원격 서버) 안의
+ 데이터로의 액세스를 제어하기 위해 콘텐츠 제공자 권한을 쓰고자 하는 경우,
+데이터를 내부 파일, SQLite 데이터베이스 또는 "클라우드"(예: 원격 서버) 안의
내부 파일로 저장해야 하고, 파일과 데이터베이스를 애플리케이션만의 비공개로 유지해야 합니다.
권한 구현
- 기본 데이터가 비공개라고 하더라도 모든 애플리케이션이 제공자를 읽고 제공자에 쓸 수 있습니다.
+ 기본 데이터가 비공개라고 하더라도 모든 애플리케이션이 제공자를 읽고 제공자에 쓸 수 있습니다.
기본적으로 제공자에는 권한이 설정되어 있지 않기 때문입니다. 이를 변경하려면,
<provider> 요소의 속성이나 하위 요소를 사용하여
-매니페스트 파일에 있는 제공자의 권한을 설정합니다. 권한은 제공자 전체에 적용되도록 설정할 수도 있고,
+매니페스트 파일에 있는 제공자의 권한을 설정합니다. 권한은 제공자 전체에 적용되도록 설정할 수도 있고,
특정 테이블에, 또는 심지어 특정 레코드에 적용되게 할 수도 있고 세 가지 모두를 택할 수도 있습니다.
- 제공자에 대한 권한은 매니페스트 파일에 있는 하나 이상의
+ 제공자에 대한 권한은 매니페스트 파일에 있는 하나 이상의
- <permission> 요소로 정의합니다.
+ <permission> 요소로 정의합니다.
제공자에 고유한 권한을 설정하려면
android:name 속성에 Java 스타일 범위를 사용합니다. 예를 들어 읽기 권한의 이름을
@@ -945,7 +945,7 @@ Eclipse와 같은 통합 개발 환경은 계약 클래스의 상수 이름을
- 다음 목록은 제공자 권한의 범위를 설명한 것입니다.
+ 다음 목록은 제공자 권한의 범위를 설명한 것입니다.
제공자 전체에 적용되는 권한부터 시작하여 점차 세분화된 권한이 됩니다.
보다 세부화된 권한이 범위가 큰 것보다 우선합니다.
@@ -954,9 +954,9 @@ Eclipse와 같은 통합 개발 환경은 계약 클래스의 상수 이름을
단일 읽기-쓰기 제공자 수준 권한
- 제공자 전체로의 읽기와 쓰기 액세스 양쪽 모두를 제어하는 하나의 권한으로,
+ 제공자 전체로의 읽기와 쓰기 액세스 양쪽 모두를 제어하는 하나의 권한으로,
- <provider> 요소의
+ <provider> 요소의
android:permission 속성으로 지정됩니다.
@@ -978,14 +978,14 @@ Eclipse와 같은 통합 개발 환경은 계약 클래스의 상수 이름을
경로 수준 권한
- 제공자의 콘텐츠 URI에 대한 읽기, 쓰기 또는 읽기/쓰기 권한입니다. 제어하고자 하는 각 URI를 직접 지정하되,
-이때
+ 제공자의 콘텐츠 URI에 대한 읽기, 쓰기 또는 읽기/쓰기 권한입니다. 제어하고자 하는 각 URI를 직접 지정하되,
+이때
- <provider> 요소의
+ <provider> 요소의
- <path-permission> 하위 요소를 사용합니다. 지정하는 콘텐츠 URI마다
-읽기/쓰기 권한, 읽기 권한 또는 쓰기 권한을 하나씩 지정하거나 셋 모두를 지정할 수 있습니다.
-읽기 및 쓰기 권한이 읽기/쓰기 권한보다 우선합니다.
+ <path-permission> 하위 요소를 사용합니다. 지정하는 콘텐츠 URI마다
+읽기/쓰기 권한, 읽기 권한 또는 쓰기 권한을 하나씩 지정하거나 셋 모두를 지정할 수 있습니다.
+읽기 및 쓰기 권한이 읽기/쓰기 권한보다 우선합니다.
또한, 경로 수준 권한이 제공자 수준 권한보다 우선합니다.
@@ -993,18 +993,18 @@ Eclipse와 같은 통합 개발 환경은 계약 클래스의 상수 이름을
애플리케이션에 임시 액세스를 허용하는 권한 수준입니다.
-해당 애플리케이션에 일반적으로 요구되는 권한이 없더라도 무관합니다.
+해당 애플리케이션에 일반적으로 요구되는 권한이 없더라도 무관합니다.
임시 액세스 기능은 매니페스트에서 요청해야 하는
-권한과 애플리케이션 개수를 줄여줍니다. 임시 권한을 사용하는 경우,
-제공자에 대하여 "영구" 권한을 필요로하는 애플리케이션은
+권한과 애플리케이션 개수를 줄여줍니다. 임시 권한을 사용하는 경우,
+제공자에 대하여 "영구" 권한을 필요로하는 애플리케이션은
모든 데이터에 지속적으로 액세스하는 것들뿐입니다.
- 이메일 제공자와 앱을 구현할 때 필요한 권한을 예로 들어 보겠습니다.
-외부 이미지 뷰어 애플리케이션으로 하여금 제공자에서 보낸 사진 첨부 파일을
-표시하도록 허용하고자 한다고 가정합니다. 권한을 요구하지 않고 이미지 뷰어에 필수 액세스를 부여하려면,
-사진에 대한 콘텐츠 URI에 해단되는 임시 권한을 설정하십시오.
+ 이메일 제공자와 앱을 구현할 때 필요한 권한을 예로 들어 보겠습니다.
+외부 이미지 뷰어 애플리케이션으로 하여금 제공자에서 보낸 사진 첨부 파일을
+표시하도록 허용하고자 한다고 가정합니다. 권한을 요구하지 않고 이미지 뷰어에 필수 액세스를 부여하려면,
+사진에 대한 콘텐츠 URI에 해단되는 임시 권한을 설정하십시오.
사용자가 사진을 표시하기를 원할 때 앱이 사진의 콘텐츠 URI와 권한 플래그를 포함하는 인텐트를
-이미지 뷰어에 보내도록 이메일 앱을 설계합니다. 그러면 해당 이미지 뷰어가
+이미지 뷰어에 보내도록 이메일 앱을 설계합니다. 그러면 해당 이미지 뷰어가
이메일 제공자에 사진 검색을 쿼리할 수 있으며, 이 뷰어에 제공자에 대한 정상적인 읽기 권한이 없더라도 무방합니다.
@@ -1017,29 +1017,29 @@ Eclipse와 같은 통합 개발 환경은 계약 클래스의 상수 이름을
<grant-uri-permission> 하위 요소를
- <provider> 요소에 추가하면 됩니다. 임시 권한을 사용하는 경우,
+ <provider> 요소에 추가하면 됩니다. 임시 권한을 사용하는 경우,
제공자에서 콘텐츠 URI에 대한 지원을 제거할 때마다 {@link android.content.Context#revokeUriPermission(Uri, int)
- Context.revokeUriPermission()}을 호출해야 합니다.
+ Context.revokeUriPermission()}을 호출해야 합니다.
그러면 콘텐츠 URI가 임시 권한과 연관됩니다.
속성의 값에 따라 제공자에 액세스 가능한 정도가 결정됩니다.
- 속성이 true로 설정되어 있는 경우라면
-시스템이 제공자 전체에 임시 권한을 허용하며, 제공자 수준 또는
+ 속성이 true로 설정되어 있는 경우라면
+시스템이 제공자 전체에 임시 권한을 허용하며, 제공자 수준 또는
경로 수준 권한에서 요구하는 다른 모든 권한을 재정의합니다.
- 이 플래그가 false로 설정되면, 반드시
+ 이 플래그가 false로 설정되면, 반드시
<grant-uri-permission> 하위 요소를
- <provider> 요소에 추가해야 합니다. 각 하위 요소는 임시 권한을 허용한
+ <provider> 요소에 추가해야 합니다. 각 하위 요소는 임시 권한을 허용한
콘텐츠 URI(하나 또는 여러 개)를 나타냅니다.
애플리케이션에 임시 액세스를 위임하려면, 인텐트에
{@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION} 또는
-{@link android.content.Intent#FLAG_GRANT_WRITE_URI_PERMISSION} 플래그, 또는 둘 모두가 들어 있어야 합니다. 이들은
+{@link android.content.Intent#FLAG_GRANT_WRITE_URI_PERMISSION} 플래그, 또는 둘 모두가 들어 있어야 합니다. 이들은
{@link android.content.Intent#setFlags(int) setFlags()} 메서드로 설정됩니다.
@@ -1087,7 +1087,7 @@ android:authorities})
권한
- 제공자의 데이터에 액세스하기 위해 다른 애플리케이션이
+ 제공자의 데이터에 액세스하기 위해 다른 애플리케이션이
반드시 가지고 있어야 하는 권한을 나타내는 속성입니다.
@@ -1108,7 +1108,7 @@ android:authorities})
- 각종 권한과 그에 상응하는 속성은
+ 각종 권한과 그에 상응하는 속성은
콘텐츠 제공자 권한 구현 섹션에 자세히 설명되어 있습니다.
@@ -1117,7 +1117,7 @@ android:authorities})
시작 및 제어 속성
- 이와 같은 속성은 Android 시스템이 제공자를 시작하는 방법과 시점,
+ 이와 같은 속성은 Android 시스템이 제공자를 시작하는 방법과 시점,
제공자의 프로세스 특징과 기타 런타임 설정 등을 결정합니다.
@@ -1130,12 +1130,12 @@ android:authorities})
- android:initOrder: 같은 프로세스 내의 다른 제공자와 비교하여
+ android:initOrder: 같은 프로세스 내의 다른 제공자와 비교하여
이 제공자가 시작되어야 하는 순서입니다.
- android:multiProcess: 클라이언트를 호출하는 것과
+ android:multiProcess: 클라이언트를 호출하는 것과
같은 프로세스에서 시스템이 제공자를 시작할 수 있게 해주는 플래그입니다.
@@ -1145,7 +1145,7 @@ android:authorities})
- android:syncable: 제공자의 데이터가
+ android:syncable: 제공자의 데이터가
서버에 있는 데이터와 동기화될 예정임을 나타내는 플래그입니다.
@@ -1165,7 +1165,7 @@ android:authorities})
android:icon: 제공자의 아이콘이 들어 있는 드로어블 리소스입니다.
- 이 아이콘은
+ 이 아이콘은
설정 > 앱 > 모두에 있는 앱 목록에서 제공자의 레이블 옆에 표시됩니다.
@@ -1187,28 +1187,28 @@ android:authorities})
인텐트 및 데이터 액세스
애플리케이션이 콘텐츠 제공자에 간접적으로 액세스하려면 {@link android.content.Intent}를 사용하면 됩니다.
- 이 애플리케이션은 {@link android.content.ContentResolver} 또는
-{@link android.content.ContentProvider}의 메서드 중 어느 하나도 호출하지 않습니다.
-대신, 액티비티를 시작하는 인텐트를 전송합니다. 이 인텐트는 제공자가 소유한 애플리케이션의 일부인 경우가 많습니다.
-대상 액티비티가 데이터를 자체 UI에서 검색하고 표시하는 역할을 맡습니다.
+ 이 애플리케이션은 {@link android.content.ContentResolver} 또는
+{@link android.content.ContentProvider}의 메서드 중 어느 하나도 호출하지 않습니다.
+대신, 액티비티를 시작하는 인텐트를 전송합니다. 이 인텐트는 제공자가 소유한 애플리케이션의 일부인 경우가 많습니다.
+대상 액티비티가 데이터를 자체 UI에서 검색하고 표시하는 역할을 맡습니다.
인텐트의 동작에 따라 대상 액티비티가 사용자에게 프롬프트를 표시하여 제공자의 데이터를 수정하도록 할 수도 있습니다.
인텐트에는 대상 액티비티가 UI에 표시하는 "추가" 데이터가 들어 있을 수도 있습니다.
-그러면 사용자에게 이 데이터를 변경할 수 있는 옵션이 주어지고, 그런 다음 이를 사용하여
+그러면 사용자에게 이 데이터를 변경할 수 있는 옵션이 주어지고, 그런 다음 이를 사용하여
제공자 내의 데이터를 수정할 수 있습니다.
- 데이터 무결성을 보장하는 데 유용한 것을 원하면 인텐트 액세스를 사용하는 것이 좋습니다.
-엄격하게 정의된 비즈니스 논리에 따라 데이터가 삽입, 업데이트되고 삭제되는 것이 제공자를 크게 좌우할 수도 있습니다.
-이런 경우에 해당되면, 다른 애플리케이션에 데이터를 직접 수정하도록 허용하면 데이터가 잘못되는
+ 데이터 무결성을 보장하는 데 유용한 것을 원하면 인텐트 액세스를 사용하는 것이 좋습니다.
+엄격하게 정의된 비즈니스 논리에 따라 데이터가 삽입, 업데이트되고 삭제되는 것이 제공자를 크게 좌우할 수도 있습니다.
+이런 경우에 해당되면, 다른 애플리케이션에 데이터를 직접 수정하도록 허용하면 데이터가 잘못되는
결과를 초래할 수 있습니다. 개발자들에게 인텐트 액세스 사용을 허용하려면, 그 내용을 철저히 기록해두어야 합니다.
- 개발자들에게 자기 애플리케이션의 UI를 사용한 인텐트 액세스가
+ 개발자들에게 자기 애플리케이션의 UI를 사용한 인텐트 액세스가
코드로 데이터를 수정하려 시도하는 것보다 나은 이유를 설명해주십시오.
제공자의 데이터를 수정하고자 하는 수신되는 인텐트 처리도 다른 인텐트 처리와 다를 바가 없습니다.
- 인텐트 사용에 대한 자세한 내용은
+ 인텐트 사용에 대한 자세한 내용은
인텐트 및 인텐트 필터 주제를 읽으면 확인할 수 있습니다.
- 콘텐츠 제공자는 구조화된 데이터 세트로의 액세스를 관리합니다.
-데이터를 캡슐화하여 데이터 보안을 정의하는 데 필요한 메커니즘을 제공하기도 합니다.
+ 콘텐츠 제공자는 구조화된 데이터 세트로의 액세스를 관리합니다.
+데이터를 캡슐화하여 데이터 보안을 정의하는 데 필요한 메커니즘을 제공하기도 합니다.
콘텐츠 제공자는 한 프로세스의 데이터에 다른 프로세스에서 실행 중인 코드를 연결하는 표준 인터페이스입니다.
- 콘텐츠 제공자 내의 데이터에 액세스하고자 하는 경우,
+ 콘텐츠 제공자 내의 데이터에 액세스하고자 하는 경우,
애플리케이션의 {@link android.content.Context}에 있는
{@link android.content.ContentResolver} 개체를 사용하여 클라이언트로서 제공자와 통신을 주고받으면 됩니다.
- {@link android.content.ContentResolver} 개체가 제공자 개체와 통신하며, 이 개체는
-{@link android.content.ContentProvider}를 구현하는 클래스의 인스턴스입니다.
+ {@link android.content.ContentResolver} 개체가 제공자 개체와 통신하며, 이 개체는
+{@link android.content.ContentProvider}를 구현하는 클래스의 인스턴스입니다.
제공자 개체가 클라이언트로부터 데이터 요청을 받아 요청된 작업을 수행하며 결과를 반환합니다.
데이터를 다른 애플리케이션과 공유할 생각이 없으면 나름의 제공자를 개발하지 않아도 됩니다.
그러나, 자체 애플리케이션에서 사용자 지정 검색 제안을 제공하려면 나름의 제공자가 꼭 필요합니다.
- 또한, 복잡한 데이터나 파일을 자신의 애플리케이션에서 다른 애플리케이션으로 복사하여 붙여넣고자 하는 경우에도
+ 또한, 복잡한 데이터나 파일을 자신의 애플리케이션에서 다른 애플리케이션으로 복사하여 붙여넣고자 하는 경우에도
나름의 제공자가 필요합니다.
- Android 자체에 오디오, 동영상, 이미지 및 개인 연락처 정보 등의 데이터를 관리하는 콘텐츠 제공자가
-포함되어 있습니다. 그중 몇 가지를 목록으로 나열한 것을
+ Android 자체에 오디오, 동영상, 이미지 및 개인 연락처 정보 등의 데이터를 관리하는 콘텐츠 제공자가
+포함되어 있습니다. 그중 몇 가지를 목록으로 나열한 것을
android.provider
- 패키지에 대한 참조 문서에서 확인할 수 있습니다. 이와 같은 제공자는 몇 가지 제약이 있지만,
+ 패키지에 대한 참조 문서에서 확인할 수 있습니다. 이와 같은 제공자는 몇 가지 제약이 있지만,
어느 Android 애플리케이션에나 액세스할 수 있습니다.
다음 주제에서는 콘텐츠 제공자에 대해 좀 더 자세히 설명합니다.
diff --git a/docs/html-intl/intl/ko/guide/topics/providers/document-provider.jd b/docs/html-intl/intl/ko/guide/topics/providers/document-provider.jd
index e356e22d17c9b..665a72a755cfe 100644
--- a/docs/html-intl/intl/ko/guide/topics/providers/document-provider.jd
+++ b/docs/html-intl/intl/ko/guide/topics/providers/document-provider.jd
@@ -75,96 +75,96 @@ StorageClient
-
Android 4.4(API 레벨 19)에서는 저장소 액세스 프레임워크(SAF)를 처음 도입하게 되었습니다. SAF는
-사용자가 선호하는 문서 저장소 제공자 전체를 걸쳐 문서, 이미지 및 각종 다른 파일을
-탐색하고 여는 작업을 간편하게 만들어줍니다. 표준형의, 사용하기 쉬운 UI로
+
Android 4.4(API 레벨 19)에서는 저장소 액세스 프레임워크(SAF)를 처음 도입하게 되었습니다. SAF는
+사용자가 선호하는 문서 저장소 제공자 전체를 걸쳐 문서, 이미지 및 각종 다른 파일을
+탐색하고 여는 작업을 간편하게 만들어줍니다. 표준형의, 사용하기 쉬운 UI로
사용자가 각종 앱과 제공자에 걸쳐 일관된 방식으로 파일을 탐색하고 최근 내용에 액세스할 수 있게 해줍니다.
-
클라우드 또는 로컬 저장소 서비스가 이 에코시스템에 참가하려면 자신의 서비스를 캡슐화하는
-{@link android.provider.DocumentsProvider}를 구현하면 됩니다.
-제공자의 문서에 액세스해야 하는 클라이언트 앱의 경우 단 몇 줄의 코드만으로
+
클라우드 또는 로컬 저장소 서비스가 이 에코시스템에 참가하려면 자신의 서비스를 캡슐화하는
+{@link android.provider.DocumentsProvider}를 구현하면 됩니다.
+제공자의 문서에 액세스해야 하는 클라이언트 앱의 경우 단 몇 줄의 코드만으로
SAF와 통합할 수 있습니다.
SAF에는 다음과 같은 항목이 포함됩니다.
문서 제공자—일종의 콘텐츠 제공자로
-저장소 서비스(예: Google Drive 등)로 하여금 자신이 관리하는 파일을 드러내도록 허용합니다. 문서 제공자는
-{@link android.provider.DocumentsProvider} 클래스의 하위 클래스로 구현됩니다.
-문서 제공자 스키마는 기존의 파일 계층을 근거로 하지만,
-문서 제공자가 데이터를 저장하는 물리적인 방법은 개발자가 선택하기 나름입니다.
-Android 플랫폼에는 내장된 문서 제공자가 여러 개 있습니다.
+저장소 서비스(예: Google Drive 등)로 하여금 자신이 관리하는 파일을 드러내도록 허용합니다. 문서 제공자는
+{@link android.provider.DocumentsProvider} 클래스의 하위 클래스로 구현됩니다.
+문서 제공자 스키마는 기존의 파일 계층을 근거로 하지만,
+문서 제공자가 데이터를 저장하는 물리적인 방법은 개발자가 선택하기 나름입니다.
+Android 플랫폼에는 내장된 문서 제공자가 여러 개 있습니다.
예를 들어 다운로드, 이미지 및 비디오 등입니다.
클라이언트 앱—일종의 사용자 지정 앱으로
{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 및/또는
-{@link android.content.Intent#ACTION_CREATE_DOCUMENT} 인텐트를 호출하고,
+{@link android.content.Intent#ACTION_CREATE_DOCUMENT} 인텐트를 호출하고,
문서 제공자가 반환하는 파일을 수신합니다.
-
선택기—일종의 시스템 UI로 사용자가 클라이언트 앱의
+
선택기—일종의 시스템 UI로 사용자가 클라이언트 앱의
검색 기준을 만족하는 모든 문서 제공자에서 문서에 액세스할 수 있도록 해줍니다.
SAF가 제공하는 기능을 몇 가지 예로 들면 다음과 같습니다.
사용자들로 하여금 하나의 앱만이 아니라 모든 문서 제공자에서 콘텐츠를 탐색할 수 있게 해줍니다.
-
여러분의 앱이 문서 제공자가 소유한 문서에 대한 장기적, 영구적 액세스 권한을 가질 수 있도록
-해줍니다. 이 액세스 권한을 통해 사용자가 제공자에 있는 파일을 추가, 편집,
+
여러분의 앱이 문서 제공자가 소유한 문서에 대한 장기적, 영구적 액세스 권한을 가질 수 있도록
+해줍니다. 이 액세스 권한을 통해 사용자가 제공자에 있는 파일을 추가, 편집,
저장 및 삭제할 수 있습니다.
-
여러 개의 사용자 계정을 지원하며 USB 저장소 제공자와 같은 임시 루트도 지원합니다.
+
여러 개의 사용자 계정을 지원하며 USB 저장소 제공자와 같은 임시 루트도 지원합니다.
이는 드라이브가 연결되어 있을 때만 나타납니다.
개요
-
SAF는 {@link android.provider.DocumentsProvider} 클래스의
-하위 클래스인 콘텐츠 제공자를 중심으로 둘러싸고 있습니다. 데이터는 문서 제공자 내에서 일반적인 파일 계층으로
+
SAF는 {@link android.provider.DocumentsProvider} 클래스의
+하위 클래스인 콘텐츠 제공자를 중심으로 둘러싸고 있습니다. 데이터는 문서 제공자 내에서 일반적인 파일 계층으로
구조화됩니다.
-
그림 1. 문서 제공자 데이터 모델입니다. 루트 하나가 하나의 문서를 가리키며,
+
그림 1. 문서 제공자 데이터 모델입니다. 루트 하나가 하나의 문서를 가리키며,
이는 다시 트리 전체의 팬아웃을 시작합니다.
다음 내용을 참고하십시오.
-
각 문서 제공자는 하나 이상의 "루트"를 보고합니다.
+
각 문서 제공자는 하나 이상의 "루트"를 보고합니다.
이는 문서 트리 속을 탐색할 시작 지점입니다.
-각 루트에는 고유한 {@link android.provider.DocumentsContract.Root#COLUMN_ROOT_ID}가 있으며,
-이는 해당 루트 아래의 콘텐츠를 나타내는 문서(디렉터리)를
+각 루트에는 고유한 {@link android.provider.DocumentsContract.Root#COLUMN_ROOT_ID}가 있으며,
+이는 해당 루트 아래의 콘텐츠를 나타내는 문서(디렉터리)를
가리킵니다.
-루트는 설계상 동적으로 만들어져 있어 여러 개의 계정, 임시 USB 저장소 기기
+루트는 설계상 동적으로 만들어져 있어 여러 개의 계정, 임시 USB 저장소 기기
또는 사용자 로그인/로그아웃 등과 같은 경우를 지원하도록 되어 있습니다.
-
각 루트 아래에 문서가 하나씩 있습니다. 해당 문서는 1부터 N까지의 문서를 가리키는데,
+
각 루트 아래에 문서가 하나씩 있습니다. 해당 문서는 1부터 N까지의 문서를 가리키는데,
이는 각각 1부터 N의 문서를 가리킬 수 있습니다.
-
각 저장소의 백엔드가
-개별적인 파일과 디렉터리를 고유한
-{@link android.provider.DocumentsContract.Document#COLUMN_DOCUMENT_ID}로
-참조하여 드러냅니다.문서 ID는 고유해야 하며 한 번 발행되고 나면 변경되지 않습니다.
+
각 저장소의 백엔드가
+개별적인 파일과 디렉터리를 고유한
+{@link android.provider.DocumentsContract.Document#COLUMN_DOCUMENT_ID}로
+참조하여 드러냅니다.문서 ID는 고유해야 하며 한 번 발행되고 나면 변경되지 않습니다.
이들은 기기 재부팅을 통괄하여 영구적인 URI 허가에 사용되기 때문입니다.
-
문서는 열 수 있는 파일이거나(특정 MIME 유형으로),
+
문서는 열 수 있는 파일이거나(특정 MIME 유형으로),
추가 문서가 들어있는 디렉터리일 수 있습니다(
{@link android.provider.DocumentsContract.Document#MIME_TYPE_DIR} MIME 유형으로).
-
각 문서는 서로 다른 기능을 가지고 있을 수 있습니다. 이는
-{@link android.provider.DocumentsContract.Document#COLUMN_FLAGS COLUMN_FLAGS}에서 설명한 것과 같습니다.
- 예를 들어 {@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_WRITE},
-{@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_DELETE} 및
-{@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_THUMBNAIL} 등입니다.
-같은 {@link android.provider.DocumentsContract.Document#COLUMN_DOCUMENT_ID}가
+
각 문서는 서로 다른 기능을 가지고 있을 수 있습니다. 이는
+{@link android.provider.DocumentsContract.Document#COLUMN_FLAGS COLUMN_FLAGS}에서 설명한 것과 같습니다.
+ 예를 들어 {@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_WRITE},
+{@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_DELETE} 및
+{@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_THUMBNAIL} 등입니다.
+같은 {@link android.provider.DocumentsContract.Document#COLUMN_DOCUMENT_ID}가
여러 디렉터리에 포함되어 있을 수도 있습니다.
제어 흐름
-
위에서 언급한 바와 같이, 문서 제공자 데이터 모델은 일반적인
-파일 계층을 기반으로 합니다. 그러나, 데이터를 물리적으로 저장하는 방식은 마음대로 선택할 수 있습니다. 다만
-{@link android.provider.DocumentsProvider} API를 통해 액세스할 수 있기만 하면 됩니다.
+
위에서 언급한 바와 같이, 문서 제공자 데이터 모델은 일반적인
+파일 계층을 기반으로 합니다. 그러나, 데이터를 물리적으로 저장하는 방식은 마음대로 선택할 수 있습니다. 다만
+{@link android.provider.DocumentsProvider} API를 통해 액세스할 수 있기만 하면 됩니다.
예를 들어, 데이터를 저장하기 위해 태그 기반 클라우드 저장소를 사용해도 됩니다.
-
그림 2는 사진 앱이 SAF를 사용하여 저장된 데이터에 액세스할 수 있는 방법을
+
그림 2는 사진 앱이 SAF를 사용하여 저장된 데이터에 액세스할 수 있는 방법을
예시로 나타낸 것입니다.
@@ -174,31 +174,31 @@ Android 플랫폼에는 내장된 문서 제공자가 여러 개 있습니다.
SAF에서는 제공자와 클라이언트가 직접 상호 작용하지 않습니다.
- 클라이언트가 파일과 상호 작용하기 위한 권한을 요청합니다(다시 말해,
+ 클라이언트가 파일과 상호 작용하기 위한 권한을 요청합니다(다시 말해,
파일을 읽고, 편집하고 생성 또는 삭제할 권한을 말합니다).
-
상호 작용은 애플리케이션(이 예시에서는 주어진 사진 앱)이 인텐트
-{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 또는 {@link android.content.Intent#ACTION_CREATE_DOCUMENT}를 실행시키면 시작합니다. 이 인텐트에는
-기준을 한층 더 정밀하게 하기 위한 필터가 포함될 수 있습니다. 예를 들어, "열 수 있는 파일 중에서
+
상호 작용은 애플리케이션(이 예시에서는 주어진 사진 앱)이 인텐트
+{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 또는 {@link android.content.Intent#ACTION_CREATE_DOCUMENT}를 실행시키면 시작합니다. 이 인텐트에는
+기준을 한층 더 정밀하게 하기 위한 필터가 포함될 수 있습니다. 예를 들어, "열 수 있는 파일 중에서
'이미지' MIME 유형을 가진 파일을 모두 주세요"라고 할 수 있습니다.
-
인텐트가 실행되면 시스템 선택기가 각각의 등록된 제공자로 이동하여 사용자에게
+
인텐트가 실행되면 시스템 선택기가 각각의 등록된 제공자로 이동하여 사용자에게
일치하는 콘텐츠 루트를 보여줍니다.
-
선택기는 사용자에게 문서에 액세스하는 데 쓰는 표준 인터페이스를 부여합니다. 이는
-기본 문서 제공자 사이에 큰 차이가 있더라도 무관합니다. 예를 들어, 그림 2는
+
선택기는 사용자에게 문서에 액세스하는 데 쓰는 표준 인터페이스를 부여합니다. 이는
+기본 문서 제공자 사이에 큰 차이가 있더라도 무관합니다. 예를 들어, 그림 2는
Google Drive 제공자, USB 제공자와 클라우드 제공자를 나타낸 것입니다.
-
그림 3은 이미지를 검색 중인 사용자가 Google Drive 계정을 선택한
+
그림 3은 이미지를 검색 중인 사용자가 Google Drive 계정을 선택한
선택기를 나타낸 것입니다.
그림 3. 선택기
-
사용자가 Google Drive를 선택하면 이미지가 그림 4에 나타난 것처럼
-표시됩니다. 그때부터 사용자는 제공자와 클라이언트 앱이 지원하는 방식이라면 어떤 식으로든
+
사용자가 Google Drive를 선택하면 이미지가 그림 4에 나타난 것처럼
+표시됩니다. 그때부터 사용자는 제공자와 클라이언트 앱이 지원하는 방식이라면 어떤 식으로든
이들 이미지와 상호 작용할 수 있게 됩니다.
@@ -207,45 +207,45 @@ Google Drive 제공자, USB 제공자와 클라우드 제공자를 나타낸 것
클라이언트 앱 작성
-
Android 4.3 이하에서는 앱이 또 다른 앱에서 파일을 검색할 수 있도록 하려면
+
Android 4.3 이하에서는 앱이 또 다른 앱에서 파일을 검색할 수 있도록 하려면
{@link android.content.Intent#ACTION_PICK}
- 또는 {@link android.content.Intent#ACTION_GET_CONTENT}와 같은 인텐트를 호출해야만 했습니다. 그런 다음
-파일을 선택할 앱을 하나 선택하고, 선택한 앱이 사용자 인터페이스를 제공하여야 사용자가
+ 또는 {@link android.content.Intent#ACTION_GET_CONTENT}와 같은 인텐트를 호출해야만 했습니다. 그런 다음
+파일을 선택할 앱을 하나 선택하고, 선택한 앱이 사용자 인터페이스를 제공하여야 사용자가
이용 가능한 파일 중에서 탐색하고 선택할 수 있었습니다.
-
Android 4.4 이상에는
-{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 인텐트를 사용할 수 있다는 추가 옵션이 있습니다.
-이는 시스템이 제어하는 선택기를 표시하여 사용자가 다른 앱에서 이용할 수 있게 만든 파일을
-모두 탐색할 수 있게 해줍니다. 이 하나의 UI로부터
+
Android 4.4 이상에는
+{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 인텐트를 사용할 수 있다는 추가 옵션이 있습니다.
+이는 시스템이 제어하는 선택기를 표시하여 사용자가 다른 앱에서 이용할 수 있게 만든 파일을
+모두 탐색할 수 있게 해줍니다. 이 하나의 UI로부터
사용자는 지원되는 모든 앱에서 파일을 선택할 수 있는 것입니다.
{@link android.content.Intent#ACTION_OPEN_DOCUMENT}는
+{@link android.content.Intent#ACTION_GET_CONTENT}를
대체할 목적으로 만들어진 것이 아닙니다. 어느 것을 사용해야 할지는 각자의 앱에 필요한 것이 무엇인지에 좌우됩니다.
-
앱이 단순히 데이터를 읽고/가져오기만을 바란다면
-{@link android.content.Intent#ACTION_GET_CONTENT}를 사용하십시오.
+
앱이 단순히 데이터를 읽고/가져오기만을 바란다면
+{@link android.content.Intent#ACTION_GET_CONTENT}를 사용하십시오.
이 방식을 사용하면 앱은 이미지 파일과 같은 데이터 사본을 가져오게 됩니다.
-
앱이 문서 제공자가 보유한 문서에 장기적, 영구적 액세스 권한을 가지기를 바라는 경우
+
앱이 문서 제공자가 보유한 문서에 장기적, 영구적 액세스 권한을 가지기를 바라는 경우
{@link android.content.Intent#ACTION_OPEN_DOCUMENT}를 사용하십시오.
- 일례로 사용자들에게 문서 제공자에 저장된 이미지를 편집할 수 있게 해주는
+ 일례로 사용자들에게 문서 제공자에 저장된 이미지를 편집할 수 있게 해주는
사진 편집 앱을 들 수 있겠습니다.
-
이 섹션에서는
-{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 및
+
이 섹션에서는
+{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 및
{@link android.content.Intent#ACTION_CREATE_DOCUMENT} 인텐트를 근거로 클라이언트 앱을 작성하는 방법을 설명합니다.
문서 검색
-다음 조각에서는 {@link android.content.Intent#ACTION_OPEN_DOCUMENT}를
-사용하여 이미지 파일이 들어 있는 문서 제공자를
+다음 조각에서는 {@link android.content.Intent#ACTION_OPEN_DOCUMENT}를
+사용하여 이미지 파일이 들어 있는 문서 제공자를
검색합니다.
private static final int READ_REQUEST_CODE = 42;
@@ -277,7 +277,7 @@ public void performFileSearch() {
앱이 {@link android.content.Intent#ACTION_OPEN_DOCUMENT}
인텐트를 실행시키면 이는 일치하는 문서 제공자를 모두 표시하는 선택기를 시작합니다.
{@link android.content.Intent#CATEGORY_OPENABLE} 카테고리를
인텐트에 추가하면 결과를 필터링하여 이미지 파일 등 열 수 있는 문서만 표시합니다.
{@code intent.setType("image/*")} 문으로 한층 더 필터링을 수행하여
@@ -286,10 +286,10 @@ MIME 데이터 유형이 이미지인 문서만 표시하도록 합니다.
결과 처리
-
사용자가 선택기에서 문서를 선택하면
-{@link android.app.Activity#onActivityResult onActivityResult()}가 호출됩니다.
+
사용자가 선택기에서 문서를 선택하면
+{@link android.app.Activity#onActivityResult onActivityResult()}가 호출됩니다.
선택한 문서를 가리키는 URI는 {@code resultData}
-매개변수 안에 들어있습니다. 이 URI를 {@link android.content.Intent#getData getData()}를 사용하여 추출합니다.
+매개변수 안에 들어있습니다. 이 URI를 {@link android.content.Intent#getData getData()}를 사용하여 추출합니다.
일단 이것을 가지게 되면 이를 사용하여 사용자가 원하는 문서를 검색하면 됩니다. 예:
@@ -318,7 +318,7 @@ public void onActivityResult(int requestCode, int resultCode,
문서 메타데이터 살펴보기
-
문서의 URI를 얻은 다음에는 그 문서의 메타데이터에 액세스할 수 있습니다. 이
+
문서의 URI를 얻은 다음에는 그 문서의 메타데이터에 액세스할 수 있습니다. 이
조각은 해당 URI가 나타내는 문서의 메타데이터를 가져와 다음과 같이 기록합니다.
public void dumpImageMetaData(Uri uri) {
@@ -365,7 +365,7 @@ public void onActivityResult(int requestCode, int resultCode,
문서 열기
-
문서의 URI를 얻은 다음에는 문서를 열 수도 있고 원하는 대로 무엇이든
+
문서의 URI를 얻은 다음에는 문서를 열 수도 있고 원하는 대로 무엇이든
할 수 있습니다.
비트맵
@@ -382,14 +382,14 @@ public void onActivityResult(int requestCode, int resultCode,
}
-
이 작업을 UI 스레드에서 해서는 안 된다는 점을 유의하십시오. 이것은 배경에서 하되,
-{@link android.os.AsyncTask}를 사용합니다. 비트맵을 열고 나면 이를
+
이 작업을 UI 스레드에서 해서는 안 된다는 점을 유의하십시오. 이것은 배경에서 하되,
+{@link android.os.AsyncTask}를 사용합니다. 비트맵을 열고 나면 이를
{@link android.widget.ImageView}로 표시할 수 있습니다.
InputStream 가져오기
-
다음은 URI에서 {@link java.io.InputStream}을 가져오는 방법을 예시로 나타낸 것입니다. 이 조각에서
+
다음은 URI에서 {@link java.io.InputStream}을 가져오는 방법을 예시로 나타낸 것입니다. 이 조각에서
파일의 줄이 문자열로 읽히고 있습니다.
private String readTextFromUri(Uri uri) throws IOException {
@@ -409,9 +409,9 @@ public void onActivityResult(int requestCode, int resultCode,
새 문서 생성하기
-
개발자의 앱은 문서 제공자에서 새 문서를 생성할 수 있습니다. 이때
+
개발자의 앱은 문서 제공자에서 새 문서를 생성할 수 있습니다. 이때
{@link android.content.Intent#ACTION_CREATE_DOCUMENT}
- 인텐트를 사용하면 됩니다. 파일을 생성하려면 인텐트에 MIME 유형과 파일 이름을 부여하고,
+ 인텐트를 사용하면 됩니다. 파일을 생성하려면 인텐트에 MIME 유형과 파일 이름을 부여하고,
고유한 요청 코드로 이를 시작하면 됩니다. 나머지는 여러분 대신 알아서 해드립니다.
새 문서를 생성하고 나면
-{@link android.app.Activity#onActivityResult onActivityResult()}에서 URI를 가져와 거기에 계속해서
+
새 문서를 생성하고 나면
+{@link android.app.Activity#onActivityResult onActivityResult()}에서 URI를 가져와 거기에 계속해서
쓸 수 있습니다.
문서 삭제하기
-
어느 문서에 대한 URI가 있고 해당 문서의
+
어느 문서에 대한 URI가 있고 해당 문서의
{@link android.provider.DocumentsContract.Document#COLUMN_FLAGS Document.COLUMN_FLAGS}
-에
+에
{@link android.provider.DocumentsContract.Document#FLAG_SUPPORTS_DELETE SUPPORTS_DELETE}가 들어 있는 경우,
해당 문서를 삭제할 수 있습니다. 예:
준비된 텍스트 문서를 편집하는 데 SAF를 사용할 수 있습니다.
-이 조각은
-{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 인텐트를 실행하며
-{@link android.content.Intent#CATEGORY_OPENABLE} 카테고리를 사용해
+이 조각은
+{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 인텐트를 실행하며
+{@link android.content.Intent#CATEGORY_OPENABLE} 카테고리를 사용해
열 수 있는 문서만 표시하도록 합니다. 이것을 한층 더 필터링하여 텍스트 파일만 표시하게 하려면 다음과 같이 합니다.
@@ -486,10 +486,10 @@ private static final int EDIT_REQUEST_CODE = 44;
다음으로, {@link android.app.Activity#onActivityResult onActivityResult()}
-(결과 처리 참조)에서 코드를 호출하여 편집 작업을 수행하도록 하면 됩니다.
+(결과 처리 참조)에서 코드를 호출하여 편집 작업을 수행하도록 하면 됩니다.
다음 조각은 {@link android.content.ContentResolver}에서 {@link java.io.FileOutputStream}
-을 가져온 것입니다. 이것은 기본적으로 "쓰기" 모드를 사용합니다.
-필요한 최소 수량의 액세스만을 요청하는 것이 가장 좋으니 쓰기만 필요하다면
+을 가져온 것입니다. 이것은 기본적으로 "쓰기" 모드를 사용합니다.
+필요한 최소 수량의 액세스만을 요청하는 것이 가장 좋으니 쓰기만 필요하다면
읽기/쓰기를 요청하지 마십시오.
private void alterDocument(Uri uri) {
@@ -512,16 +512,16 @@ private static final int EDIT_REQUEST_CODE = 44;
권한 유지
-
앱이 읽기 또는 쓰기 작업에 대한 파일을 열면 시스템이 앱에 해당 파일에 대한 URI 권한 허가를
+
앱이 읽기 또는 쓰기 작업에 대한 파일을 열면 시스템이 앱에 해당 파일에 대한 URI 권한 허가를
부여합니다. 이것은 사용자의 장치를 다시 시작할 때까지 유지됩니다.
-하지만 만일 앱이 이미지 편집 앱이고, 사용자가 여러분의 앱에서 바로 편집한 5개의 이미지에
-액세스할 수 있도록 하고자 한다고 가정해봅시다. 사용자의 기기가 재시작되면
-여러분이 사용자에게 시스템 선택기를 다시 보내 해당 파일을 검색하도록 해야 할 텐데,
+하지만 만일 앱이 이미지 편집 앱이고, 사용자가 여러분의 앱에서 바로 편집한 5개의 이미지에
+액세스할 수 있도록 하고자 한다고 가정해봅시다. 사용자의 기기가 재시작되면
+여러분이 사용자에게 시스템 선택기를 다시 보내 해당 파일을 검색하도록 해야 할 텐데,
이것은 물론 이상적인 것과는 거리가 멉니다.
이런 일이 일어나지 않도록 방지하기 위해 시스템이 앱에 부여한 권한을 유지할 수 있습니다.
-여러분의 앱은 시스템이 제공하는 유지 가능한 URI 권한 허가를
-효율적으로 "받아들입니다". 이렇게 하면 사용자가 여러분의 앱을 통해 파일에 지속적인 액세스 권한을 가질 수 있으며,
+여러분의 앱은 시스템이 제공하는 유지 가능한 URI 권한 허가를
+효율적으로 "받아들입니다". 이렇게 하면 사용자가 여러분의 앱을 통해 파일에 지속적인 액세스 권한을 가질 수 있으며,
이는 기기가 다시 시작되더라도 관계 없습니다.
@@ -531,65 +531,65 @@ private static final int EDIT_REQUEST_CODE = 44;
// Check for the freshest data.
getContentResolver().takePersistableUriPermission(uri, takeFlags);
-
마지막 한 단계가 남았습니다. 여러분의 앱이 액세스한 가장 최근의 URI를
-저장해두었을 수 있지만, 이는 더 이상 유효하지 않을 수 있습니다. 또 다른 앱이 문서를
-삭제하거나 수정했을 수 있기 때문입니다. 따라서, 항상
-{@code getContentResolver().takePersistableUriPermission()}을
+
마지막 한 단계가 남았습니다. 여러분의 앱이 액세스한 가장 최근의 URI를
+저장해두었을 수 있지만, 이는 더 이상 유효하지 않을 수 있습니다. 또 다른 앱이 문서를
+삭제하거나 수정했을 수 있기 때문입니다. 따라서, 항상
+{@code getContentResolver().takePersistableUriPermission()}을
호출하여 최신 데이터를 확인해야 합니다.
사용자 지정 문서 제공자 작성하기
-파일용 저장소 서비스를 제공하는 앱을 개발 중인 경우(예를 들어
-클라우드 저장 서비스 등), SAF를 통해 파일을 사용할 수 있도록 하려면 사용자 지정 문서 제공자를
+파일용 저장소 서비스를 제공하는 앱을 개발 중인 경우(예를 들어
+클라우드 저장 서비스 등), SAF를 통해 파일을 사용할 수 있도록 하려면 사용자 지정 문서 제공자를
작성하면 됩니다. 이 섹션에서는 이렇게 하는 방법을 설명합니다.
매니페스트
-
사용자 지정 문서 제공자를 구현하려면 애플리케이션의 매니페스트에 다음과 같은 항목을
+
사용자 지정 문서 제공자를 구현하려면 애플리케이션의 매니페스트에 다음과 같은 항목을
추가하십시오.
API 레벨 19 이상의 대상.
-
사용자 지정 저장소 제공자를 선언하는 <provider>
+
사용자 지정 저장소 제공자를 선언하는 <provider>
요소.
-
제공자의 이름은 그 클래스 이름이며 여기에 패키지 이름도 포함됩니다.
+
제공자의 이름은 그 클래스 이름이며 여기에 패키지 이름도 포함됩니다.
예: com.example.android.storageprovider.MyCloudProvider
-
권한의 이름, 이는 패키지 이름과 같으며(이 예시에서는
+
권한의 이름, 이는 패키지 이름과 같으며(이 예시에서는
com.example.android.storageprovider)여기에 콘텐츠 제공자 유형을 더합니다
(documents). 예: {@code com.example.android.storageprovider.documents}
android:exported 속성을 "true"로 설정.
제공자를 내보내 다른 앱이 볼 수 있도록 해야 합니다.
-
android:grantUriPermissions 속성을
-"true"로 설정. 이렇게 설정하면 시스템이 여러분의 제공자 안에 있는 콘텐츠에 액세스하도록 다른 앱에
-권한을 허가할 수 있게 해줍니다. 특정 문서에 대한 권한 부여를 유지하는 방법에 대한 논의는
+
android:grantUriPermissions 속성을
+"true"로 설정. 이렇게 설정하면 시스템이 여러분의 제공자 안에 있는 콘텐츠에 액세스하도록 다른 앱에
+권한을 허가할 수 있게 해줍니다. 특정 문서에 대한 권한 부여를 유지하는 방법에 대한 논의는
권한 유지를 참조하십시오.
{@code MANAGE_DOCUMENTS} 권한. 기본적으로 제공자는 누구나 이용할 수 있습니다.
- 이 권한을 추가하면 여러분의 제공자를 시스템에 제한하게 됩니다.
+ 이 권한을 추가하면 여러분의 제공자를 시스템에 제한하게 됩니다.
이 제한은 보안상 매우 중요합니다.
-
{@code android:enabled} 속성을 리소스 파일에서 정의한 부울 값으로
-설정합니다. 이 속성의 목적은 Android 4.3 이하에서 실행되는 기기에서 제공자를 비활성화하는 데 있습니다.
-예를 들어 {@code android:enabled="@bool/atLeastKitKat"} 등입니다. 이 속성을
+
{@code android:enabled} 속성을 리소스 파일에서 정의한 부울 값으로
+설정합니다. 이 속성의 목적은 Android 4.3 이하에서 실행되는 기기에서 제공자를 비활성화하는 데 있습니다.
+예를 들어 {@code android:enabled="@bool/atLeastKitKat"} 등입니다. 이 속성을
매니페스트에 추가하는 것 이외에도 다음과 같은 작업을 해야 합니다.
-
{@code res/values/} 아래의 {@code bool.xml} 리소스 파일에
+
{@code res/values/} 아래의 {@code bool.xml} 리소스 파일에
이 라인을 추가합니다.
<bool name="atLeastKitKat">false</bool>
-
{@code res/values-v19/} 아래의 {@code bool.xml} 리소스 파일에
+
{@code res/values-v19/} 아래의 {@code bool.xml} 리소스 파일에
이 라인을 추가합니다.
<bool name="atLeastKitKat">true</bool>
-{@code android.content.action.DOCUMENTS_PROVIDER} 동작을 포함한 인텐트 필터가 있어야
+{@code android.content.action.DOCUMENTS_PROVIDER} 동작을 포함한 인텐트 필터가 있어야
시스템이 제공자를 검색할 때 여러분의 제공자가 선택기에 나타날 수 있습니다.
-{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 인텐트는
-Android 4.4 이상에서 실행되는 기기에서만 사용할 수 있습니다.
-애플리케이션이 {@link android.content.Intent#ACTION_GET_CONTENT}를 지원하도록 하여
-Android 4.3 이하에서 실행되는 기기에도 적용되도록 하려면 Android 4.4 이상에서 실행되는 기기용 매니페스트에 있는
+{@link android.content.Intent#ACTION_OPEN_DOCUMENT} 인텐트는
+Android 4.4 이상에서 실행되는 기기에서만 사용할 수 있습니다.
+애플리케이션이 {@link android.content.Intent#ACTION_GET_CONTENT}를 지원하도록 하여
+Android 4.3 이하에서 실행되는 기기에도 적용되도록 하려면 Android 4.4 이상에서 실행되는 기기용 매니페스트에 있는
{@link android.content.Intent#ACTION_GET_CONTENT}
- 인텐트 필터를 비활성화해야 합니다.
-문서 제공자와 {@link android.content.Intent#ACTION_GET_CONTENT}는 상호 배타적인 것으로
-간주해야 합니다. 둘을 모두 동시에 지원하는 경우, 앱이 시스템 선택기 UI에
+ 인텐트 필터를 비활성화해야 합니다.
+문서 제공자와 {@link android.content.Intent#ACTION_GET_CONTENT}는 상호 배타적인 것으로
+간주해야 합니다. 둘을 모두 동시에 지원하는 경우, 앱이 시스템 선택기 UI에
두 번 나타나 저장된 데이터에 액세스할 두 가지 서로 다른 방법을 제안하게 됩니다.
이렇게 되면 사용자에게 혼동을 주게 되겠죠.
-
다음은 Android 버전 4.4 이상에서 실행되는 기기용
-{@link android.content.Intent#ACTION_GET_CONTENT} 인텐트 필터를
+
다음은 Android 버전 4.4 이상에서 실행되는 기기용
+{@link android.content.Intent#ACTION_GET_CONTENT} 인텐트 필터를
비활성화하는 데 권장되는 방법입니다.
-
{@code res/values/} 아래의 {@code bool.xml} 리소스 파일에
+
{@code res/values/} 아래의 {@code bool.xml} 리소스 파일에
이 라인을 추가합니다.
<bool name="atMostJellyBeanMR2">true</bool>
-
{@code res/values-v19/} 아래의 {@code bool.xml} 리소스 파일에
+
{@code res/values-v19/} 아래의 {@code bool.xml} 리소스 파일에
이 라인을 추가합니다.
<bool name="atMostJellyBeanMR2">false</bool>
-액티비티
-별칭을 추가하여 버전 4.4(API 레벨 19) 이상을 대상으로 한 {@link android.content.Intent#ACTION_GET_CONTENT}
+액티비티
+별칭을 추가하여 버전 4.4(API 레벨 19) 이상을 대상으로 한 {@link android.content.Intent#ACTION_GET_CONTENT}
인텐트 필터를 비활성화합니다. 예:
사용자 지정 제공자를 작성할 때면 일반적으로 수반되는 작업 중 하나가
-계약 클래스를 구현하는 것입니다. 이는
+
사용자 지정 제공자를 작성할 때면 일반적으로 수반되는 작업 중 하나가
+계약 클래스를 구현하는 것입니다. 이는
-콘텐츠 제공자 개발자 가이드에서 설명한 것과 같습니다. 계약 클래스는 {@code public final} 클래스로,
-이 안에 URI에 대한 상수 정의, 열 이름, MIME 유형 및 제공자에 관련된
-다른 메타 데이터가 들어 있습니다. SAF가
-이와 같은 계약 클래스를 대신 제공해주므로 직접 쓰지 않아도
+콘텐츠 제공자 개발자 가이드에서 설명한 것과 같습니다. 계약 클래스는 {@code public final} 클래스로,
+이 안에 URI에 대한 상수 정의, 열 이름, MIME 유형 및 제공자에 관련된
+다른 메타 데이터가 들어 있습니다. SAF가
+이와 같은 계약 클래스를 대신 제공해주므로 직접 쓰지 않아도
됩니다.
꼭 구현해야만 하는 메서드는 이들뿐이지만, 개발자 여러분이 구현하고자 하는 메서드는 이보다
-훨씬 많을 수도 있습니다. 자세한 내용은{@link android.provider.DocumentsProvider}
+
꼭 구현해야만 하는 메서드는 이들뿐이지만, 개발자 여러분이 구현하고자 하는 메서드는 이보다
+훨씬 많을 수도 있습니다. 자세한 내용은{@link android.provider.DocumentsProvider}
를 참조하십시오.
QueryRoots 구현
{@link android.provider.DocumentsProvider#queryRoots
-queryRoots()} 구현은 반드시 {@link android.database.Cursor}를 반환해야 하며,
-이는 문서 제공자의 모든 루트 디렉터리를 가리켜야 합니다. 이때
+queryRoots()} 구현은 반드시 {@link android.database.Cursor}를 반환해야 하며,
+이는 문서 제공자의 모든 루트 디렉터리를 가리켜야 합니다. 이때
{@link android.provider.DocumentsContract.Root}에서 정의한 열을 사용합니다.
-
다음 조각에서 {@code projection} 매개변수는
+
다음 조각에서 {@code projection} 매개변수는
발신자가 돌려받고자 하는 특정 필드를 나타냅니다. 이 조각은 새 커서를 생성하며
-그에 하나의 행을 추가합니다. 하나의 루트,
-다운로드 또는 이미지와 같은 최상위 레벨 디렉터리가 해당됩니다. 대부분의 제공자에는 루트가 하나뿐입니다. 하나 이상이 있을 수도 있습니다.
-예를 들어 사용자 계정이 여러 개인 경우가 있습니다. 그런 경우에는 커서에 두 번째 행을
+그에 하나의 행을 추가합니다. 하나의 루트,
+다운로드 또는 이미지와 같은 최상위 레벨 디렉터리가 해당됩니다. 대부분의 제공자에는 루트가 하나뿐입니다. 하나 이상이 있을 수도 있습니다.
+예를 들어 사용자 계정이 여러 개인 경우가 있습니다. 그런 경우에는 커서에 두 번째 행을
추가하면 됩니다.
{@link android.provider.DocumentsProvider#queryChildDocuments queryChildDocuments()}
- 구현은 반드시 {@link android.database.Cursor}를 반환해야 하며,
-이는 지정된 디렉터리 내의 모든 파일을 가리켜야 합니다. 이때
+ 구현은 반드시 {@link android.database.Cursor}를 반환해야 하며,
+이는 지정된 디렉터리 내의 모든 파일을 가리켜야 합니다. 이때
{@link android.provider.DocumentsContract.Document}에서 정의한 열을 사용합니다.
-
이 메서드는 선택기 UI에서 애플리케이션 루트를 선택하는 경우 호출됩니다.
-이는 해당 루트 아래 디렉터리의 하위 문서를 가져옵니다. 이것은 루트에서뿐만 아니라 파일 계층의 어느 레벨에서나
-호출할 수 있습니다. 이 조각은 요청한 열로 새 커서를 만든 다음,
+
이 메서드는 선택기 UI에서 애플리케이션 루트를 선택하는 경우 호출됩니다.
+이는 해당 루트 아래 디렉터리의 하위 문서를 가져옵니다. 이것은 루트에서뿐만 아니라 파일 계층의 어느 레벨에서나
+호출할 수 있습니다. 이 조각은 요청한 열로 새 커서를 만든 다음,
상위 디렉터리에 있는 모든 직속 하위에 대한 정보를 커서에 추가합니다.
하위는 이미지, 또 다른 디렉터리가 될 수도 있고
어느 파일이라도 될 수 있습니다.
@@ -808,13 +808,13 @@ public Cursor queryChildDocuments(String parentDocumentId, String[] projection,
{@link android.provider.DocumentsProvider#queryDocument queryDocument()}
- 구현은 반드시 {@link android.database.Cursor}를 반환해야 하며,
+ 구현은 반드시 {@link android.database.Cursor}를 반환해야 하며,
이는 지정된 파일을 가리켜야 합니다. 이때 {@link android.provider.DocumentsContract.Document}에서 정의한 열을 사용합니다.
{@link android.provider.DocumentsProvider#queryDocument queryDocument()}
- 메서드는
-{@link android.provider.DocumentsProvider#queryChildDocuments queryChildDocuments()}에서
+ 메서드는
+{@link android.provider.DocumentsProvider#queryChildDocuments queryChildDocuments()}에서
전달된 것과 같은 정보를 반환하지만, 특정한 파일에만 해당됩니다.
지정된 파일을 나타내는
{@link android.os.ParcelFileDescriptor}를 반환하려면 {@link android.provider.DocumentsProvider#openDocument
openDocument()}를 구현해야 합니다. 다른 앱들이 반환된 {@link android.os.ParcelFileDescriptor}를
- 사용하여 데이터를 스트리밍할 수 있습니다. 시스템은 사용자가 파일을 선택하고
-클라이언트 앱이 이에 대한 액세스를 요청하면서
-{@link android.content.ContentResolver#openFileDescriptor openFileDescriptor()}를 사용할 때 이 메서드를 호출합니다.
+ 사용하여 데이터를 스트리밍할 수 있습니다. 시스템은 사용자가 파일을 선택하고
+클라이언트 앱이 이에 대한 액세스를 요청하면서
+{@link android.content.ContentResolver#openFileDescriptor openFileDescriptor()}를 사용할 때 이 메서드를 호출합니다.
예를 들면 다음과 같습니다.
@Override
@@ -885,8 +885,8 @@ public ParcelFileDescriptor openDocument(final String documentId,
보안
여러분의 문서 제공자가 암호로 보호된 클라우드 저장소 서비스이고
-여러분은 사용자가 파일을 공유하기 전에 우선 로그인부터 하도록 확실히 해두고 싶다고 가정합니다.
-사용자가 로그인되지 않은 경우 앱은 어떻게 해야 합니까? 해법은
+여러분은 사용자가 파일을 공유하기 전에 우선 로그인부터 하도록 확실히 해두고 싶다고 가정합니다.
+사용자가 로그인되지 않은 경우 앱은 어떻게 해야 합니까? 해법은
{@link android.provider.DocumentsProvider#queryRoots
queryRoots()} 구현에서 루트를 반환하지 않는 것입니다. 다시 말해, 텅 빈 루트 커서를 반환하는 것입니다.
또 다른 단계는 {@code getContentResolver().notifyChange()}를 호출하는 것입니다.
-{@link android.provider.DocumentsContract}를 기억하십니까? 이것을 사용하는 이유는
-바로 이 URI를 만들기 위해서입니다. 다음 조각은 사용자의 로그인 상태가 변경될 때마다
-시스템이 문서 제공자의 루트를 쿼리하도록 지시하고 있습니다. 사용자가 로그인되어 있지 않은 상태에서
-{@link android.provider.DocumentsProvider#queryRoots queryRoots()}를 호출하면
-위에서 나타낸 것과 같이 빈 커서를 반환합니다. 이렇게 하면 사용자가 제공자에 로그인되었을 때만
+{@link android.provider.DocumentsContract}를 기억하십니까? 이것을 사용하는 이유는
+바로 이 URI를 만들기 위해서입니다. 다음 조각은 사용자의 로그인 상태가 변경될 때마다
+시스템이 문서 제공자의 루트를 쿼리하도록 지시하고 있습니다. 사용자가 로그인되어 있지 않은 상태에서
+{@link android.provider.DocumentsProvider#queryRoots queryRoots()}를 호출하면
+위에서 나타낸 것과 같이 빈 커서를 반환합니다. 이렇게 하면 사용자가 제공자에 로그인되었을 때만
제공자의 문서를 사용할 수 있도록 보장할 수 있습니다.
리소스는 {@code R.java}의 정수를 사용하는 코드, 예를 들어
{@code R.drawable.myimage}에서 참조할 수 있습니다.
리소스는 특수 XML 구문을 사용하는 리소스, 예를 들어 {@code
@drawable/myimage}에서 참조할 수 있습니다.
@@ -42,25 +42,25 @@ parent.link=index.html
-
일단 어떤 리소스를 애플리케이션에 제공한 다음에는(리소스 제공에서 논의),
-해당 리소스의 리소스 ID를 참조함으로써 이를 적용할 수 있습니다. 모든 리소스 ID는
+
일단 어떤 리소스를 애플리케이션에 제공한 다음에는(리소스 제공에서 논의),
+해당 리소스의 리소스 ID를 참조함으로써 이를 적용할 수 있습니다. 모든 리소스 ID는
{@code aapt} 도구가 자동으로 생성하는 프로젝트의 {@code R} 클래스에서 정의됩니다.
애플리케이션이 컴파일링되면, {@code aapt}가 {@code R} 클래스를 생성하며, 이 클래스 안에 {@code
-res/} 디렉터리에 있는 모든 리소스의
-리소스 ID가 들어있습니다. 각 리소스 유형에는 {@code R} 하위 클래스가 있고(예: 모든 드로어블 리소스에 대한
+res/} 디렉터리에 있는 모든 리소스의
+리소스 ID가 들어있습니다. 각 리소스 유형에는 {@code R} 하위 클래스가 있고(예: 모든 드로어블 리소스에 대한
{@code R.drawable}), 해당 유형의 각 리소스에는 정적
-정수가 있습니다(예: {@code R.drawable.icon}). 이 정수가
+정수가 있습니다(예: {@code R.drawable.icon}). 이 정수가
리소스를 검색하는 데 사용할 수 있는 리소스 ID입니다.
-
{@code R} 클래스가 리소스 ID가 지정되는 곳이기는 하지만, 리소스 ID를 찾기 위해
+
{@code R} 클래스가 리소스 ID가 지정되는 곳이기는 하지만, 리소스 ID를 찾기 위해
이곳을 볼 필요는 전혀 없습니다. 하나의 리소스 ID는 항상 다음과 같이 구성됩니다.
리소스 유형: 각 리소스는 "유형"으로 그룹화됩니다. 예: {@code
string}, {@code drawable} 및 {@code layout} 다양한 유형에 관한 자세한 정보는 리소스 유형을 참조하십시오.
-
리소스 이름:
-리소스가 단순 값(예: 문자열 등)일 경우,
+
리소스 이름:
+리소스가 단순 값(예: 문자열 등)일 경우,
확장자를 제외한 파일 이름이나 XML {@code android:name} 속성 값 중 하나입니다.
@@ -69,14 +69,14 @@ string}, {@code drawable} 및 {@code layout} 다양한 유형에 관한 자세
코드 내부에서: {@code R}
클래스의 하위 클래스에서 정적 정수를 사용합니다. 예:
R.string.hello
-
{@code string}은 리소스 유형이고 {@code hello}는 리소스 이름입니다. 리소스 ID를 이 형식으로 제공하면 리소스에 액세스할 수 있는
-Android API가 많습니다.
+
{@code string}은 리소스 유형이고 {@code hello}는 리소스 이름입니다. 리소스 ID를 이 형식으로 제공하면 리소스에 액세스할 수 있는
+Android API가 많습니다.
코드 내 리소스 액세스를 참조하십시오.
-
XML 내부에서: {@code R} 클래스에서 정의된
+
XML 내부에서: {@code R} 클래스에서 정의된
리소스 ID에 상응하기도 하는 특수 XML 구문을 사용합니다. 예:
@string/hello
-
{@code string}은 리소스 유형이고 {@code hello}는 리소스 이름입니다. 이
+
{@code string}은 리소스 유형이고 {@code hello}는 리소스 이름입니다. 이
구문은 리소스로 값을 제공할 것으로 예상되는 어느 곳에서나 XML 리소스 형태로 사용할 수 있습니다. XML에서 리소스 액세스를 참조하십시오.
{@link
-android.content.res.Resources}에서 메서드를 사용하는 개별 리소스를 검색할 수도 있으며, 이는
+android.content.res.Resources}에서 메서드를 사용하는 개별 리소스를 검색할 수도 있으며, 이는
{@link android.content.Context#getResources()}로 인스턴스를 가져올 수 있습니다.
원본 파일에 액세스
-
흔한 일은 아니지만, 원본 파일과 디렉터리에 액세스해야 하는 경우가 있습니다. 이 경우에는
-{@code res/}에 파일을 저장하더라도 소용이 없습니다.
-{@code res/}에서 리소스를 읽는 방법은 리소스 ID를 사용하는 것뿐이기 때문입니다. 그 대신 리소스를
+
흔한 일은 아니지만, 원본 파일과 디렉터리에 액세스해야 하는 경우가 있습니다. 이 경우에는
+{@code res/}에 파일을 저장하더라도 소용이 없습니다.
+{@code res/}에서 리소스를 읽는 방법은 리소스 ID를 사용하는 것뿐이기 때문입니다. 그 대신 리소스를
{@code assets/} 디렉터리에 저장하면 됩니다.
{@code assets/} 디렉터리에 저장된 파일은 리소스
-ID가 부여되지 않으므로, 이와 같은 리소스는 {@code R} 클래스나 XML 리소스에서 참조할 수 없습니다. 그 대신
-일반 파일 시스템처럼 {@code assets/} 디렉터리에 파일을 쿼리하고
+ID가 부여되지 않으므로, 이와 같은 리소스는 {@code R} 클래스나 XML 리소스에서 참조할 수 없습니다. 그 대신
+일반 파일 시스템처럼 {@code assets/} 디렉터리에 파일을 쿼리하고
{@link android.content.res.AssetManager}를 사용하여 원시 데이터를 읽을 수 있습니다.
하지만 필요한 것이 원시 데이터(동영상 또는 오디오 파일 등)를 읽는 능력뿐인 경우라면,
파일을 {@code res/raw/} 디렉터리에 저장한 다음 일련의 바이트 스트림을 {@link
@@ -184,10 +184,10 @@ R.java} 파일을 수정해서는 안 됩니다.—이것은 프로젝트가
XML에서 리소스 액세스
기존 리소스에 대한 참조를 사용하여
-일부 XML 속성과 요소의 값을 정의할 수 있습니다. 이 작업은 레이아웃 파일을 생성할 때 위젯에 문자열과 이미지를 제공하기 위해
+일부 XML 속성과 요소의 값을 정의할 수 있습니다. 이 작업은 레이아웃 파일을 생성할 때 위젯에 문자열과 이미지를 제공하기 위해
자주 하게 됩니다.
-
예를 들어, 레이아웃에 {@link android.widget.Button}을 추가하면
+
예를 들어, 레이아웃에 {@link android.widget.Button}을 추가하면
해당 버튼 텍스트에 문자열 리소스를 사용해야 합니다.
@@ -209,7 +209,7 @@ R.java} 파일을 수정해서는 안 됩니다.—이것은 프로젝트가
{@code <package_name>}은(는) 리소스가 위치한 패키지의 이름입니다(
같은 패키지의 리소스를 참조할 경우에는 필요하지 않습니다).
-
{@code <resource_type>}은(는) 해당 리소스 유형의
+
{@code <resource_type>}은(는) 해당 리소스 유형의
{@code R} 하위 클래스입니다.
{@code <resource_name>}은(는) 확장자가 없는 리소스 파일 이름이거나
XML 요소의 {@code android:name} 속성 값입니다(단순
@@ -234,7 +234,7 @@ XML 요소의 {@code android:name} 속성 값입니다(단순
</resources>
-
텍스트 색상과
+
텍스트 색상과
텍스트 문자열을 설정하는 데 이와 같은 리소스를 다음의 레이아웃 파일에서 사용할 수 있습니다.
@@ -247,7 +247,7 @@ XML 요소의 {@code android:name} 속성 값입니다(단순
이 경우, 리소스를 자체 패키지에서 가져왔으므로 리소스 참조에 패키지 이름을
-지정하지 않아도 됩니다.
+지정하지 않아도 됩니다.
시스템 리소스를 참조하려면 패키지 이름을 포함해야 합니다. 예:
@@ -260,13 +260,13 @@ XML 요소의 {@code android:name} 속성 값입니다(단순
참고: 항상 문자열 리소스를 사용해야
-사용자의 애플리케이션이 다른 언어에 맞게 지역화될 수 있습니다.
+사용자의 애플리케이션이 다른 언어에 맞게 지역화될 수 있습니다.
대체
리소스(예: 지역화된 문자열) 생성에 관한 자세한 정보는 대체
리소스 제공을 참조하십시오. 다른 언어로 애플리케이션을 지역화하기 위한 전체 지침은
지역화를 참조하십시오.
-
XML의 리소스를 사용하여 별명을 생성할 수도 있습니다. 예를 들어, 드로어블 리소스이면서
+
XML의 리소스를 사용하여 별명을 생성할 수도 있습니다. 예를 들어, 드로어블 리소스이면서
또 다른 드로어블 리소스의 별명인 것을 생성할 수 있습니다.
이것은 일견 중복되는 것처럼 들리지만, 대체 리소스를 사용할 때 매우 유용하게 쓰일 수 있습니다.
+
이것은 일견 중복되는 것처럼 들리지만, 대체 리소스를 사용할 때 매우 유용하게 쓰일 수 있습니다.
별명 리소스 생성에 관해 자세히 알아보십시오.
@@ -283,20 +283,20 @@ XML 요소의 {@code android:name} 속성 값입니다(단순
스타일 속성 참조
스타일 속성 리소스는 현재 적용된 테마의 속성 값을
-참조할 수 있게 해줍니다. 스타일 속성을 참조하면
-하드 코드로 작성된 값을 제공하는 것 대신에 UI 요소의 외관을 사용자 지정하여
-현재 테마에서 제공한 표준 변형에 맞춰 스타일링할 수 있습니다. 스타일 속성을 참조하는 것은
+참조할 수 있게 해줍니다. 스타일 속성을 참조하면
+하드 코드로 작성된 값을 제공하는 것 대신에 UI 요소의 외관을 사용자 지정하여
+현재 테마에서 제공한 표준 변형에 맞춰 스타일링할 수 있습니다. 스타일 속성을 참조하는 것은
기본적으로 "이 속성이 정의한 스타일을 현재 테마로 사용하라"는 말과 같습니다.
-
스타일 속성을 참조하는 경우, 이름 구문은 보통
-리소스와 거의 똑같습니다. 다만 앳 기호({@code @})를 사용하는 대신 물음표({@code ?})를 사용하며,
+
스타일 속성을 참조하는 경우, 이름 구문은 보통
+리소스와 거의 똑같습니다. 다만 앳 기호({@code @})를 사용하는 대신 물음표({@code ?})를 사용하며,
리소스 유형 부분이 선택 사항이라는 점만이 다릅니다. 예:
여기서 {@code android:textColor} 속성이 주어진 스타일 속성의 이름을 현재 테마대로
+
여기서 {@code android:textColor} 속성이 주어진 스타일 속성의 이름을 현재 테마대로
지정합니다. Android는 이제 {@code android:textColorSecondary}
스타일 속성에 적용된 값을 이 위젯의 {@code android:textColor}에 대한 값으로 사용합니다. 시스템
리소스 도구는 속성 리소스가 이 컨텍스트에서 예상된다는 것을 알기 때문에
@@ -319,9 +319,9 @@ XML 요소의 {@code android:name} 속성 값입니다(단순
플랫폼 리소스 액세스
-
Android에는 스타일, 테마 및 레이아웃 등 여러 가지 표준 리소스가 포함되어 있습니다.
-이와 같은 리소스에 액세스하려면
-android 패키지 이름으로 리소스 참조를 한정합니다. 예를 들어 Android는
+
Android에는 스타일, 테마 및 레이아웃 등 여러 가지 표준 리소스가 포함되어 있습니다.
+이와 같은 리소스에 액세스하려면
+android 패키지 이름으로 리소스 참조를 한정합니다. 예를 들어 Android는
{@link android.widget.ListAdapter}의 목록 항목으로 사용할 수 있는 레이아웃 리소스를 제공합니다.
이 예시에서 {@link android.R.layout#simple_list_item_1}은
-{@link android.widget.ListView}의 항목에 대해 플랫폼이 정의한 레이아웃 리소스입니다. 목록 항목에 대해 나름의 레이아웃을
-만드는 대신 이것을 사용해도 됩니다. 자세한 내용은
+
이 예시에서 {@link android.R.layout#simple_list_item_1}은
+{@link android.widget.ListView}의 항목에 대해 플랫폼이 정의한 레이아웃 리소스입니다. 목록 항목에 대해 나름의 레이아웃을
+만드는 대신 이것을 사용해도 됩니다. 자세한 내용은
목록 보기 개발자 가이드를 참조하십시오.
이미지나 문자열 같은 리소스는 항상 애플리케이션 코드에서
-외부화하여 독립적으로 유지해야 합니다. 리소스를 외부화하면
+
이미지나 문자열 같은 리소스는 항상 애플리케이션 코드에서
+외부화하여 독립적으로 유지해야 합니다. 리소스를 외부화하면
다양한 언어나 화면 크기와 같은 특정 기기 구성을 지원하는
대체 리소스를 제공할 수 있습니다. 이러한 기능은 Android 구동 장치를
-다양한 구성에서 이용하게 되면서 점점 더 중요해지고 있습니다. 여러 가지 구성에
-호환성을 제공하려면 프로젝트의
-{@code res/} 디렉터리 안에 리소스를 정리해야 합니다. 이때 여러 가지 하위 디렉터리를 사용하여 리소스를 유형과 구성
+다양한 구성에서 이용하게 되면서 점점 더 중요해지고 있습니다. 여러 가지 구성에
+호환성을 제공하려면 프로젝트의
+{@code res/} 디렉터리 안에 리소스를 정리해야 합니다. 이때 여러 가지 하위 디렉터리를 사용하여 리소스를 유형과 구성
기준으로 그룹화하면 좋습니다.
@@ -38,7 +38,7 @@ page.title=리소스 개요
-그림 2. 서로 다른 두 개의 기기로, 각각 다른 화면 크기에 맞게 제공된 서로 다른
+그림 2. 서로 다른 두 개의 기기로, 각각 다른 화면 크기에 맞게 제공된 서로 다른
레이아웃을 사용하고 있습니다.
@@ -46,42 +46,42 @@ page.title=리소스 개요
대체 리소스를 지정할 수 있습니다.
기본 리소스는 기기 구성에 관계없이 항상 사용하거나
-기존 구성에 일치하는 대체 리소스가 없을 때
+기존 구성에 일치하는 대체 리소스가 없을 때
사용합니다.
-
대체 리소스는 특정 구성에서 사용하기 위해 개발자가 특별히 디자인한 것을
-말합니다. 리소스 그룹을 특정 구성용으로 지정하려면,
+
대체 리소스는 특정 구성에서 사용하기 위해 개발자가 특별히 디자인한 것을
+말합니다. 리소스 그룹을 특정 구성용으로 지정하려면,
디렉터리 이름에 적절한 구성 한정자를 추가하십시오.
-
예를 들어 기본 UI 레이아웃은
-{@code res/layout/} 디렉터리에 저장되어 있더라도 화면이 가로 방향일 때 사용할
+
예를 들어 기본 UI 레이아웃은
+{@code res/layout/} 디렉터리에 저장되어 있더라도 화면이 가로 방향일 때 사용할
다른 레이아웃을 지정할 수도 있습니다. 이를 {@code res/layout-land/}
디렉터리에 저장하면 됩니다. Android는
기기의 현재 구성을 리소스 디렉터리 이름과 일치시켜서 적절한 리소스를 적용합니다.
-
그림 1은 이용 가능한 대체 리소스가 없을 경우 시스템이 서로 다른 두 개의 기기에
-같은 레이아웃을 적용하는 방법을 보여줍니다. 그림 2는
+
그림 1은 이용 가능한 대체 리소스가 없을 경우 시스템이 서로 다른 두 개의 기기에
+같은 레이아웃을 적용하는 방법을 보여줍니다. 그림 2는
같은 애플리케이션에 큰 화면용 레이아웃 리소스를 추가한 모습을 나타낸 것입니다.
-
다음 문서는 대체 리소스를 체계화하고,
+
다음 문서는 대체 리소스를 체계화하고,
대체 리소스를 지정하고, 애플리케이션에 액세스 하는 등의 방법에 관한 완전한 지침을 제공합니다.
이미지나 문자열과 같은 애플리케이션 리소스는 항상 코드에서 외부화해야 합니다.
-그래야 이들을 독립적으로 유지관리할 수 있습니다. 특정 기기 구성에 대한 대체 리소스도
-제공해야 합니다. 이것은 특별하게 명명한 리소스 디렉터리에 그룹화하는 방법을 씁니다. Android는
-런타임에 현재 구성을 근거로 적절한 리소스를 사용합니다. 예를 들어
-여러 가지 화면 크기에 따라 여러 가지 UI 레이아웃을 제공하거나 언어 설정에 따라
+
이미지나 문자열과 같은 애플리케이션 리소스는 항상 코드에서 외부화해야 합니다.
+그래야 이들을 독립적으로 유지관리할 수 있습니다. 특정 기기 구성에 대한 대체 리소스도
+제공해야 합니다. 이것은 특별하게 명명한 리소스 디렉터리에 그룹화하는 방법을 씁니다. Android는
+런타임에 현재 구성을 근거로 적절한 리소스를 사용합니다. 예를 들어
+여러 가지 화면 크기에 따라 여러 가지 UI 레이아웃을 제공하거나 언어 설정에 따라
각기 다른 문자열을 제공하고자 할 수 있습니다.
애플리케이션 리소스를 외부화하면
프로젝트 {@code R} 클래스에서 발생하는 리소스 ID로 액세스할 수 있습니다. 애플리케이션에서
리소스를 사용하는 방법은 리소스
-액세스에서 설명합니다. 이 문서에서는 Android 프로젝트에서 리소스를 그룹화하는 방법과 특정 기기 구성에 대한
+액세스에서 설명합니다. 이 문서에서는 Android 프로젝트에서 리소스를 그룹화하는 방법과 특정 기기 구성에 대한
대체 리소스를 제공하는 법을 보여드립니다.
@@ -75,10 +75,10 @@ MyProject/
) 포함하는 것을 볼 수 있습니다. 리소스 디렉터리 이름은
중요하며 표1에 설명되어 있습니다.
-
tween
애니메이션을 정의하는 XML 파일입니다 (속성 애니메이션도 이 디렉터리에 저장할 수 있지만
두 가지 유형을 구분하기 위해 속성 애니메이션에는 {@code animator/} 디렉터리가 기본 설정됩니다
).
@@ -126,8 +126,8 @@ MyProject/
mipmap/
-
각기 다른 시작 관리자 아이콘 밀도에 대한 드로어블 파일입니다.
-{@code mipmap/} 폴더로 시작 관리자 아이콘을 관리하는 자세한 방법은
+
각기 다른 시작 관리자 아이콘 밀도에 대한 드로어블 파일입니다.
+{@code mipmap/} 폴더로 시작 관리자 아이콘을 관리하는 자세한 방법은
프로젝트 관리 개요를 참조하십시오.
@@ -139,32 +139,32 @@ MyProject/
menu/
-
옵션 메뉴, 컨텍스트 메뉴 또는 하위
+
옵션 메뉴, 컨텍스트 메뉴 또는 하위
메뉴 등과 같은 애플리케이션 메뉴를 정의하는 XML입니다. 메뉴 리소스를 참조하십시오.
raw/
-
원시 형태로 저장하기 위한 임의의 파일입니다. 원시
+
원시 형태로 저장하기 위한 임의의 파일입니다. 원시
{@link java.io.InputStream}으로 이런 리소스를 열려면 리소스 ID, {@code R.raw.filename}으로 {@link android.content.res.Resources#openRawResource(int)
Resources.openRawResource()}를 호출합니다.
-
그러나 원본 파일 이름과 파일 계층에 액세스해야 하는 경우,
+
그러나 원본 파일 이름과 파일 계층에 액세스해야 하는 경우,
({@code res/raw/}가 아니라) {@code
-assets/} 디렉터리에 몇몇 리소스를 저장해두는 것을 고려해 볼 수 있습니다. {@code assets/}에 있는 파일에는
+assets/} 디렉터리에 몇몇 리소스를 저장해두는 것을 고려해 볼 수 있습니다. {@code assets/}에 있는 파일에는
리소스 ID가 주어지지 않으므로, 이들을 읽는 유일한 방법은 {@link android.content.res.AssetManager}를 사용하는 것뿐입니다.
values/
문자열, 정수 및 색과 같은 단순 값이 들어있는 XML 파일입니다.
-
다른 {@code res/} 하위 디렉터리에 있는 XML 리소스 파일은 XML 파일 이름을 근거로
+
다른 {@code res/} 하위 디렉터리에 있는 XML 리소스 파일은 XML 파일 이름을 근거로
하나의 리소스를 정의하는 반면, {@code values/} 디렉터리에 있는 파일은 여러 개의 리소스를 설명합니다.
-이 디렉터리 안에 있는 파일의 경우, {@code <resources>} 요소의 각 하위 요소가 리소스를 하나씩
-정의합니다. 예를 들어 {@code <string>} 요소는
+이 디렉터리 안에 있는 파일의 경우, {@code <resources>} 요소의 각 하위 요소가 리소스를 하나씩
+정의합니다. 예를 들어 {@code <string>} 요소는
{@code R.string} 리소스를 생성하고 {@code <color>} 요소는 {@code R.color}
리소스를 생성합니다.
각 리소스가 자체 XML 요소로 정의되므로, 원하는 대로 파일을 정의하고 하나의 파일에 여러 가지 리소스 유형을
-배정할 수 있습니다. 하지만 명확히 하려면 여러 가지 파일에
+배정할 수 있습니다. 하지만 명확히 하려면 여러 가지 파일에
각기 고유한 리소스를 배치하는 것이 좋을 수도 있습니다. 예를 들어, 다음은 이 디렉터리에서 생성할 수 있는 리소스를 위한
파일 이름 명명법입니다.
@@ -176,7 +176,7 @@ assets/} 디렉터리에 몇몇 리소스를 저장해두는 것을 고려해
@@ -184,21 +184,21 @@ assets/} 디렉터리에 몇몇 리소스를 저장해두는 것을 고려해
xml/
런타임에 읽을 수 있는 임의의 XML 파일로, 이때 {@link
-android.content.res.Resources#getXml(int) Resources.getXML()}을 호출하는 방법을 씁니다. 다양한 XML 구성 파일을 여기에 저장해야 합니다. 예를 들어
+android.content.res.Resources#getXml(int) Resources.getXML()}을 호출하는 방법을 씁니다. 다양한 XML 구성 파일을 여기에 저장해야 합니다. 예를 들어
검색 가능한 구성 등이 이에 해당됩니다.
-
주의: 리소스 파일을
+
주의: 리소스 파일을
{@code res/} 디렉터리에 직접 저장하면 절대로 안 됩니다. 컴파일러 오류를 초래하게 됩니다.
표1에 정의된 하위 디렉터리에 저장하는 리소스는 "기본"
-리소스입니다. 다시 말해, 이러한 리소스가 애플리케이션의 기본 디자인과 콘텐츠를 정의한다는 뜻입니다.
+리소스입니다. 다시 말해, 이러한 리소스가 애플리케이션의 기본 디자인과 콘텐츠를 정의한다는 뜻입니다.
그러나, 여러 가지 유형의 Android 구동 기기는 각기 다른 유형의 리소스를 호출할 수도 있습니다.
-예를 들어 어느 기기의 화면이 보통보다 큰 편이라면, 추가적인 화면 공간의 이점을 활용할 수 있는
+예를 들어 어느 기기의 화면이 보통보다 큰 편이라면, 추가적인 화면 공간의 이점을 활용할 수 있는
다른 레이아웃 리소스를 제공해야 합니다. 또는, 기기에 다른 언어 설정이 있을 경우
해당 텍스트를 사용자 인터페이스에 번역하는 다른 문자열 리소스를
제공해야 합니다. 여러 가지 기기 구성에 여러 가지 리소스를 제공하려면,
@@ -215,10 +215,10 @@ android.content.res.Resources#getXml(int) Resources.getXML()}을 호출하는
그림 1. 서로 다른 두 개의 기기로, 서로 다른 레이아웃 리소스를 사용합니다.
-
거의 모든 애플리케이션이 특정 기기 구성을 지원하는
-대체 리소스를 제공해야 합니다. 예를 들어 여러 가지 화면 밀도에 맞는 대체 드로어블 리소스를
-포함시켜야 하며 여러 가지 언어에 맞게 대체 문자열 리소스도 포함시켜야 합니다. Android는 런타임에
-현재 기기 구성을 감지하고 애플리케이션에 대해 적절한 리소스를
+
거의 모든 애플리케이션이 특정 기기 구성을 지원하는
+대체 리소스를 제공해야 합니다. 예를 들어 여러 가지 화면 밀도에 맞는 대체 드로어블 리소스를
+포함시켜야 하며 여러 가지 언어에 맞게 대체 문자열 리소스도 포함시켜야 합니다. Android는 런타임에
+현재 기기 구성을 감지하고 애플리케이션에 대해 적절한 리소스를
로드합니다.
{@code <qualifier>}는 리소스를 사용할 개별 구성을 지정하는
이름입니다(표2에 정의).
-
하나 이상의 {@code <qualifier>}를 추가할 수 있습니다. 각기 대시로
+
하나 이상의 {@code <qualifier>}를 추가할 수 있습니다. 각기 대시로
구분합니다.
주의: 여러 한정자를 추가할 때는
-표2에 나열된 것과 같은 순서로 배치해야 합니다. 한정자의 순서가 잘못 지정되면
+표2에 나열된 것과 같은 순서로 배치해야 합니다. 한정자의 순서가 잘못 지정되면
해당 리소스가 무시됩니다.
-
해당되는 각 대체 리소스를 이 새 디렉터리에 저장하십시오. 이 리소스 파일은 기본 리소스 파일과
+
해당되는 각 대체 리소스를 이 새 디렉터리에 저장하십시오. 이 리소스 파일은 기본 리소스 파일과
똑같은 이름을 지정해야 합니다.
@@ -254,21 +254,21 @@ res/
{@code hdpi} 한정자는 해당 디렉터리의 리소스가
-고화질 화면 기기용이라는 것을 나타냅니다. 각 드로어블 디렉터리의 이미지는 특정 화면 화질에 맞추어
+고화질 화면 기기용이라는 것을 나타냅니다. 각 드로어블 디렉터리의 이미지는 특정 화면 화질에 맞추어
크기가 지정되었으나 파일 이름은
똑같습니다. 이렇게 하면 {@code icon.png} 또는 {@code
-background.png} 이미지를 참조하는 데 사용하는 리소스 ID는 항상 같지만 Android가 각 리소스 중에서 현재 기기에 가장 잘 일치하는
-버전을 선택하게 됩니다. 이때 리소스 디렉터리 이름의 한정자를 기기 구성 정보와
+background.png} 이미지를 참조하는 데 사용하는 리소스 ID는 항상 같지만 Android가 각 리소스 중에서 현재 기기에 가장 잘 일치하는
+버전을 선택하게 됩니다. 이때 리소스 디렉터리 이름의 한정자를 기기 구성 정보와
비교하는 방법을 씁니다.
-
Android는 여러 가지 구성 한정자를 지원하며 한 디렉터리 이름에
-여러 개의 한정자를 추가할 수 있습니다. 각 한정자를 대시로 구분하면 됩니다. 표 2는
-유효한 구성 한정자를 우선 순위대로 나열한 것입니다. 리소스 디렉터리에 여러 개의
-한정자를 사용하는 경우, 해당 한정자를 디렉터리 이름에 추가할 때 이 표에 나열된 것과 같은
+
Android는 여러 가지 구성 한정자를 지원하며 한 디렉터리 이름에
+여러 개의 한정자를 추가할 수 있습니다. 각 한정자를 대시로 구분하면 됩니다. 표 2는
+유효한 구성 한정자를 우선 순위대로 나열한 것입니다. 리소스 디렉터리에 여러 개의
+한정자를 사용하는 경우, 해당 한정자를 디렉터리 이름에 추가할 때 이 표에 나열된 것과 같은
순서로 추가해야 합니다.
-
표 2. 구성 한정자
+
표 2. 구성 한정자
이름입니다.
@@ -285,7 +285,7 @@ background.png} 이미지를 참조하는 데 사용하는 리소스 ID는 항
등.
-
이동통신 국가 코드(MCC)에 선택적으로 이동통신 네트워크 코드(MNC)가 이어지는 형태로,
+
이동통신 국가 코드(MCC)에 선택적으로 이동통신 네트워크 코드(MNC)가 이어지는 형태로,
기기의 SIM 카드에서 가져옵니다. 예를 들어, mcc310은 모든 이동통신사를 포함한 미국이고,
mcc310-mnc004는 Verizon을 사용하는 미국, mcc208-mnc00은 Orange를 사용하는
프랑스입니다.
@@ -293,11 +293,11 @@ background.png} 이미지를 참조하는 데 사용하는 리소스 ID는 항
SIM 카드에서 가져옵니다.
MCC만 단독으로 사용할 수도 있습니다(예를 들어, 애플리케이션에 국가별 합법적 리소스를
포함하는 경우). 언어에 기초해서만 지정해야 할 경우,
-언어 및 지역 한정자를 대신 사용합니다(아래에 설명). MCC와
+언어 및 지역 한정자를 대신 사용합니다(아래에 설명). MCC와
MNC 한정자를 사용할 경우, 조심해서 사용하고 예상한 대로 작동하는지 테스트해야 합니다.
또한, 구성 필드 {@link
android.content.res.Configuration#mcc}와 {@link
-android.content.res.Configuration#mnc}를 참조하십시오. 이 구성 필드는 각각 이동통신 국가 코드와
+android.content.res.Configuration#mnc}를 참조하십시오. 이 구성 필드는 각각 이동통신 국가 코드와
이동통신 네트워크 코드를 나타냅니다.
@@ -312,19 +312,19 @@ android.content.res.Configuration#mnc}를 참조하십시오. 이 구성 필드
등.
언어는 두 글자의 ISO
-639-1 언어 코드로 정의되고,
+639-1 언어 코드로 정의되고,
뒤이어 두 글자의 ISO
3166-1-alpha-2 지역 코드가 선택적으로 따라옵니다(소문자 "{@code r}" 뒤에 붙음).
- 코드는 대소문자를 구별하지 않습니다. {@code r} 접두사는
+ 코드는 대소문자를 구별하지 않습니다. {@code r} 접두사는
지역 부분을 구별하기 위해 사용합니다.
지역만 지정할 수는 없습니다.
-
사용자가 시스템 설정에서 언어를 변경할 경우
+
사용자가 시스템 설정에서 언어를 변경할 경우
애플리케이션 수명 중에 변경될 수 있습니다. 런타임에서 애플리케이션에 어떤 영향을 미치는지 자세히 알아보려면 런타임 변경 처리를 참조하십시오.
속성과
기기의 smallestWidth 값을 보유한 {@link
-android.content.res.Configuration#smallestScreenWidthDp}
+android.content.res.Configuration#smallestScreenWidthDp}
구성 필드도 참조하십시오.
-
여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
+
여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
다중 화면
지원 개발자 가이드를 참조하십시오.
리소스를 사용해야 하는 {@code dp} 단위에서 최소 이용 가능한 화면 너비를 지정합니다.
-이는 <N> 값이 정의합니다. 이 구성
-값은 현재 실제 너비에 맞추기 위해 화면 방향이 가로와 세로 사이를 오가며 바뀔 때
+
리소스를 사용해야 하는 {@code dp} 단위에서 최소 이용 가능한 화면 너비를 지정합니다.
+이는 <N> 값이 정의합니다. 이 구성
+값은 현재 실제 너비에 맞추기 위해 화면 방향이 가로와 세로 사이를 오가며 바뀔 때
변경됩니다.
애플리케이션이 이 구성에 대해 서로 다른 값이 포함된 여러 개의 리소스 디렉터리를 제공하면,
-시스템은 기기의 현재 화면 너비에 가장 가까운(그러나 이를 초과하지 않는)
-값을 사용합니다. 이 값은
-화면 장식을 감안한 것이므로, 기기의 왼쪽이나 오른쪽 가장자리에
-영구 UI 요소가 있을 경우, 기기는
+시스템은 기기의 현재 화면 너비에 가장 가까운(그러나 이를 초과하지 않는)
+값을 사용합니다. 이 값은
+화면 장식을 감안한 것이므로, 기기의 왼쪽이나 오른쪽 가장자리에
+영구 UI 요소가 있을 경우, 기기는
이러한 UI 요소를 감안하여 애플리케이션의 이용 가능한 공간을 줄여서
실제 화면 크기보다 작은 너비 값을 사용합니다.
API 레벨 13에서 추가되었습니다.
현재 화면 너비를 보유한 {@link android.content.res.Configuration#screenWidthDp}
구성 필드도 참조하십시오.
-
여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
+
여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
다중 화면
지원 개발자 가이드를 참조하십시오.
리소스가 사용되어야 하는 최소한의 사용 가능한 화면 높이를 "dp" 단위로 나타냅니다.
-이는 <N> 값이 정의합니다. 이 구성
-값은 현재 실제 높이에 맞추기 위해 화면 방향이 가로와 세로 사이를 오가며 바뀔 때
+
리소스가 사용되어야 하는 최소한의 사용 가능한 화면 높이를 "dp" 단위로 나타냅니다.
+이는 <N> 값이 정의합니다. 이 구성
+값은 현재 실제 높이에 맞추기 위해 화면 방향이 가로와 세로 사이를 오가며 바뀔 때
변경됩니다.
애플리케이션이 이 구성에 대해 서로 다른 값이 포함된 여러 개의 리소스 디렉터리를 제공하면,
-시스템은 기기의 현재 화면 높이에 가장 가까운(그러나 이를 초과하지 않는)
-값을 사용합니다. 이 값은
-화면 장식을 감안한 것이므로, 기기의 상단이나 하단 가장자리에
-영구 UI 요소가 있을 경우, 기기는
+시스템은 기기의 현재 화면 높이에 가장 가까운(그러나 이를 초과하지 않는)
+값을 사용합니다. 이 값은
+화면 장식을 감안한 것이므로, 기기의 상단이나 하단 가장자리에
+영구 UI 요소가 있을 경우, 기기는
이러한 UI 요소를 감안하여 애플리케이션의 이용 가능한 공간을 줄여서
- 실제 화면 크기보다 작은 높이 값을 사용합니다.
-상태 표시줄에 고정되지 않은 화면 장식(예를 들어
-전화 상태 표시줄은 전체 화면에서 숨길 수 있음)은 여기에서 감안하지 않았고,
-제목 표시줄이나 작업 모음 등의 창 장식도 감안되지 않았으므로, 애플리케이션 입장에서는 자신이 지정한 것보다 어느 정도 작은 공간을
+ 실제 화면 크기보다 작은 높이 값을 사용합니다.
+상태 표시줄에 고정되지 않은 화면 장식(예를 들어
+전화 상태 표시줄은 전체 화면에서 숨길 수 있음)은 여기에서 감안하지 않았고,
+제목 표시줄이나 작업 모음 등의 창 장식도 감안되지 않았으므로, 애플리케이션 입장에서는 자신이 지정한 것보다 어느 정도 작은 공간을
받아들일 대비를 해야 합니다.
API 레벨 13에서 추가되었습니다.
현재 화면 너비를 보유한 {@link android.content.res.Configuration#screenHeightDp}
구성 필드도 참조하십시오.
-
여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
+
여러 가지 화면에 맞는 디자인과 한정자 사용에 관한 자세한 정보는
다중 화면
지원 개발자 가이드를 참조하십시오.
{@code small}: 저밀도 QVGA 화면과 비슷한
크기의 화면입니다. 작은 화면의 최소 레이아웃 크기는
-약 320x426 dp단위입니다. 이 화면의 예시로는 QVGA 저밀도 및 VGA 고밀도가
+약 320x426 dp단위입니다. 이 화면의 예시로는 QVGA 저밀도 및 VGA 고밀도가
있습니다.
-
{@code normal}: 중밀도 HVGA 화면과
+
{@code normal}: 중밀도 HVGA 화면과
비슷한 크기의 화면입니다. 정상 화면의
- 최소 레이아웃 크기는 약 320x470 dp 단위입니다. 이 화면의 예로는
+ 최소 레이아웃 크기는 약 320x470 dp 단위입니다. 이 화면의 예로는
WQVGA 저밀도, HVGA 중밀도, WVGA 고밀도 등이 있습니다.
-
{@code large}: 중밀도 VGA 화면과
+
{@code large}: 중밀도 VGA 화면과
비슷한 크기의 화면입니다.
큰 화면의 최소 레이아웃 크기는 약 480x640 dp 단위입니다.
이 화면의 예시로는 VGA 및 WVGA 중밀도 화면이 있습니다.
-
{@code xlarge}: 일반적인 중밀도 HVGA 화면보다 상당히 큰 화면을
+
{@code xlarge}: 일반적인 중밀도 HVGA 화면보다 상당히 큰 화면을
말합니다. 초대형 화면의
- 최소 레이아웃 크기는 약 720x960 dp 단위입니다. 대부분의 경우, 초대형 화면 기기는
-주머니에 넣어 다니기에 너무 큽니다. 따라서 태블릿 스타일의 기기일 가능성이
+ 최소 레이아웃 크기는 약 720x960 dp 단위입니다. 대부분의 경우, 초대형 화면 기기는
+주머니에 넣어 다니기에 너무 큽니다. 따라서 태블릿 스타일의 기기일 가능성이
높습니다. API 레벨 9에서 추가되었습니다.
-
참고: 크기 한정자를 사용하더라도 해당 리소스가 그 크기의 화면
-전용이라는 뜻은 아닙니다. 현재 기기 구성과 더욱 잘 맞는 한정자가 포함된 대체 리소스를
-제공하지 않으면,
+
참고: 크기 한정자를 사용하더라도 해당 리소스가 그 크기의 화면
+전용이라는 뜻은 아닙니다. 현재 기기 구성과 더욱 잘 맞는 한정자가 포함된 대체 리소스를
+제공하지 않으면,
시스템이 가장 잘 일치하는 리소스를 사용합니다.
주의: 모든 리소스가 현재 화면보다
큰 크기 한정자를 사용하는 경우, 시스템은 리소스를 사용하지 않으며 애플리케이션은 런타임에 작동이 중단됩니다(예를 들어, 모든 레이아웃 리소스에 {@code
xlarge} 한정자가 태그되어 있지만 기기는 일반 크기 화면일 경우
).
이것은 사용자가 기기를 도크에 놓는 경우 애플리케이션 수명 중에
변경될 수 있습니다. 이러한 모드 중 몇 가지는 {@link
-android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
+android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
참조하십시오.
@@ -599,9 +599,9 @@ android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수
{@code notnight}: 주간
API 레벨 8에서 추가되었습니다.
-
이것은 야간 모드가 자동 모드인 상태(기본)에서 애플리케이션의 수명 중에
-변경될 수 있습니다. 이 경우 모드는 하루 중 시간대를 기반으로 변경됩니다. 이 모드는
-{@link android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수 있습니다. 이것이 런타임 중 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
+
이것은 야간 모드가 자동 모드인 상태(기본)에서 애플리케이션의 수명 중에
+변경될 수 있습니다. 이 경우 모드는 하루 중 시간대를 기반으로 변경됩니다. 이 모드는
+{@link android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수 있습니다. 이것이 런타임 중 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
참조하십시오.
@@ -623,33 +623,33 @@ android.app.UiModeManager}를 사용하여 활성화 또는 비활성화할 수
{@code mdpi}: 중밀도(일반적인 HVGA에서) 화면, 약
160dpi.
{@code hdpi}: 고밀도 화면, 약 240dpi.
-
{@code xhdpi}: 초고밀도 화면, 약 320dpi. API 레벨 8에서
+
{@code xhdpi}: 초고밀도 화면, 약 320dpi. API 레벨 8에서
추가되었습니다.
-
{@code xxhdpi}: 슈퍼 초고밀도 화면, 약 480dpi. API 레벨 16에서
+
{@code xxhdpi}: 슈퍼 초고밀도 화면, 약 480dpi. API 레벨 16에서
추가되었습니다.
-
{@code xxxhdpi}: 울트라 슈퍼 초고밀도 화면 사용(시작 관리자 아이콘만 해당,
-다중 화면 지원의
-참고를 참조하십시오), 약 640dpi. API 레벨 18에서
+
{@code xxxhdpi}: 울트라 슈퍼 초고밀도 화면 사용(시작 관리자 아이콘만 해당,
+다중 화면 지원의
+참고를 참조하십시오), 약 640dpi. API 레벨 18에서
추가되었습니다.
-
{@code nodpi}: 이것은 기기 밀도에 일치하도록 크기를 조정하고자 하지 않는 비트맵 리소스에
+
{@code nodpi}: 이것은 기기 밀도에 일치하도록 크기를 조정하고자 하지 않는 비트맵 리소스에
사용할 수 있습니다.
-
{@code tvdpi}: Mdpi와 hdpi 사이 어딘가에 해당되는 화면, 약 213dpi. 이것은
-"기본" 밀도 그룹으로 간주되지 않습니다. 이는 대체로 텔레비전용으로 만들어진 것이며
-대부분의 앱에는 필요하지 않는 것이 정상입니다. mdpi 및 hdpi만 제공하면 대부분의 앱에는 충분하고
+
{@code tvdpi}: Mdpi와 hdpi 사이 어딘가에 해당되는 화면, 약 213dpi. 이것은
+"기본" 밀도 그룹으로 간주되지 않습니다. 이는 대체로 텔레비전용으로 만들어진 것이며
+대부분의 앱에는 필요하지 않는 것이 정상입니다. mdpi 및 hdpi만 제공하면 대부분의 앱에는 충분하고
시스템이 필요에 따라 크기를 조정해줍니다. 이 한정자는 API 레벨 13과 함께 도입되었습니다.
-
여섯 가지 기본 밀도간에 3:4:6:8:12:16 비율 척도가 있습니다(tvdpi 밀도는
+
여섯 가지 기본 밀도간에 3:4:6:8:12:16 비율 척도가 있습니다(tvdpi 밀도는
무시). 그러므로 ldpi의 9x9 비트맵은 mdpi에서 12x12이고, hdpi에서 18x18, xhdpi에서 24x24 등, 이런 식으로 적용됩니다.
-
이미지 리소스가 텔레비전이나 특정 기기에서 제대로 보이지 않는다고 결정하고
+
이미지 리소스가 텔레비전이나 특정 기기에서 제대로 보이지 않는다고 결정하고
tvdpi 리소스를 사용하려 할 경우, 배율은 1.33*mdpi입니다. 예를 들어,
mdpi 화면의 100px x 100px 이미지는 tvdpi에서 133px x 133px가 되어야 합니다.
-
참고: 밀도 한정자를 사용하더라도 해당 리소스가 그 밀도의 화면
-전용이라는 뜻은 아닙니다. 현재 기기 구성과 더욱 잘 맞는 한정자가 포함된 대체 리소스를
-제공하지 않으면,
+
참고: 밀도 한정자를 사용하더라도 해당 리소스가 그 밀도의 화면
+전용이라는 뜻은 아닙니다. 현재 기기 구성과 더욱 잘 맞는 한정자가 포함된 대체 리소스를
+제공하지 않으면,
시스템이 가장 잘 일치하는 리소스를 사용합니다.
-
다양한 화질을 처리하는 방법과
-Android가 현재 화질에 맞춰 비트맵을 축소하는 방법에 관한 자세한 정보는 다중 화면
+
@@ -662,10 +662,10 @@ Android가 현재 화질에 맞춰 비트맵을 축소하는 방법에 관한
{@code notouch}: 기기에 터치 스크린이 없습니다.
-
{@code finger}: 기기에 터치 스크린이 있으며 이를
+
{@code finger}: 기기에 터치 스크린이 있으며 이를
사용자의 손가락을 사용한 방향 지시 상호 작용을 통해 쓰도록 되어 있습니다.
-
{@link android.content.res.Configuration#touchscreen} 구성 필드도 참조하십시오.
+
{@link android.content.res.Configuration#touchscreen} 구성 필드도 참조하십시오.
이는 기기에서 사용되는 터치 스크린의 유형을 나타냅니다.
@@ -678,25 +678,25 @@ Android가 현재 화질에 맞춰 비트맵을 축소하는 방법에 관한
-
{@code keysexposed}: 기기에서 키보드를 사용할 수 있습니다. 키보드에
-소프트웨어 키보드가 활성화되어 있으면(이럴 가능성이 큽니다), 하드웨어 키보드가 사용자에게 노출되어 있지
-않거나 기기에 하드웨어 키보드가 없더라도 이 리소스를 사용할 수 있습니다. 소프트웨어
-키보드가 제공되어 있지 않거나 비활성화되어 있는 경우 이것은 하드웨어 키보드가 노출되어 있을 때에만
+
{@code keysexposed}: 기기에서 키보드를 사용할 수 있습니다. 키보드에
+소프트웨어 키보드가 활성화되어 있으면(이럴 가능성이 큽니다), 하드웨어 키보드가 사용자에게 노출되어 있지
+않거나 기기에 하드웨어 키보드가 없더라도 이 리소스를 사용할 수 있습니다. 소프트웨어
+키보드가 제공되어 있지 않거나 비활성화되어 있는 경우 이것은 하드웨어 키보드가 노출되어 있을 때에만
사용할 수 있습니다.
-
{@code keyshidden}: 기기에서 하드웨어 키보드를 사용할 수 있지만
+
{@code keyshidden}: 기기에서 하드웨어 키보드를 사용할 수 있지만
숨겨져 있고 이에 더하여 기기에 소프트웨어 키보드가 활성화되어 있지 않습니다.
-
{@code keyssoft}: 기기에 활성화된 소프트웨어 키보드가 있습니다(표시 여부는
+
{@code keyssoft}: 기기에 활성화된 소프트웨어 키보드가 있습니다(표시 여부는
무관).
keysexposed 리소스를 제공하지만 keyssoft
-리소스는 제공하지 않는다면, 시스템은 소프트웨어 키보드가 활성화되어 있는 동안은 키보드가 보이는지 여부와 관계없이 keysexposed
+리소스는 제공하지 않는다면, 시스템은 소프트웨어 키보드가 활성화되어 있는 동안은 키보드가 보이는지 여부와 관계없이 keysexposed
리소스를 사용합니다.
-
이것은 사용자가 하드웨어 키보드를 여는 경우 애플리케이션 수명 중에
-변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
+
이것은 사용자가 하드웨어 키보드를 여는 경우 애플리케이션 수명 중에
+변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
참조하십시오.
또한, 구성 필드 {@link
android.content.res.Configuration#hardKeyboardHidden}과 {@link
-android.content.res.Configuration#keyboardHidden}을 참조하십시오. 이 필드는 각각 하드웨어 키보드의 가시성과
+android.content.res.Configuration#keyboardHidden}을 참조하십시오. 이 필드는 각각 하드웨어 키보드의 가시성과
모든 종류의 키보드(소프트웨어 포함)의 가시성을 나타냅니다.
@@ -710,13 +710,13 @@ android.content.res.Configuration#keyboardHidden}을 참조하십시오. 이 필
{@code nokeys}: 기기에 텍스트 입력을 위한 하드웨어 키가 없습니다.
-
{@code qwerty}: 기기에 하드웨어 쿼티 키보드가 있습니다(이것이
+
{@code qwerty}: 기기에 하드웨어 쿼티 키보드가 있습니다(이것이
사용자
에게 표시되는지 여부는 무관).
-
{@code 12key}: 기기에 하드웨어 12-키 키보드가 있습니다(이것이 사용자에게 표시되는지 여부는
+
{@code 12key}: 기기에 하드웨어 12-키 키보드가 있습니다(이것이 사용자에게 표시되는지 여부는
무관).
-
{@link android.content.res.Configuration#keyboard} 구성 필드도 참조하십시오.
+
{@link android.content.res.Configuration#keyboard} 구성 필드도 참조하십시오.
이는 기본 텍스트 입력 메서드를 사용할 수 있는지 여부를 나타냅니다.
@@ -729,13 +729,13 @@ android.content.res.Configuration#keyboardHidden}을 참조하십시오. 이 필
{@code navexposed}: 사용자가 탐색 키를 사용할 수 있습니다.
-
{@code navhidden}: 탐색 키를 사용할 수 없습니다(예: 닫힌 뚜껑 뒤에 있는
+
{@code navhidden}: 탐색 키를 사용할 수 없습니다(예: 닫힌 뚜껑 뒤에 있는
경우).
-
이것은 사용자가 탐색 키를 드러내는 경우 애플리케이션 수명 중에
-변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
+
이것은 사용자가 탐색 키를 드러내는 경우 애플리케이션 수명 중에
+변경될 수 있습니다. 이것이 런타임에 애플리케이션에 어떤 영향을 미치는지 알아보려면 런타임 변경 처리를
참조하십시오.
-
{@link android.content.res.Configuration#navigationHidden} 구성
+
{@link android.content.res.Configuration#navigationHidden} 구성
필드도 참조하십시오. 이는 탐색 키가 숨겨져 있는지 여부를 나타냅니다.
@@ -749,13 +749,13 @@ android.content.res.Configuration#keyboardHidden}을 참조하십시오. 이 필
-
{@code nonav}: 기기에 터치 스크린을 제외하고 다른 탐색 기능이
+
{@code nonav}: 기기에 터치 스크린을 제외하고 다른 탐색 기능이
없습니다.
{@code dpad}: 기기에 탐색용 방향 패드(d-pad)가 있습니다.
{@code trackball}: 기기에 탐색용 트랙볼이 있습니다.
{@code wheel}: 기기에 탐색용 방향 휠이 있습니다.
-
{@link android.content.res.Configuration#navigation} 구성 필드도 참조하십시오.
+
{@link android.content.res.Configuration#navigation} 구성 필드도 참조하십시오.
이는 사용 가능한 탐색 메서드의 유형을 나타냅니다.
@@ -792,11 +792,11 @@ orientation" described above.
참고: 일부 구성 한정자는 Android
-1.0 이후부터 추가되었으므로 모든 Android 버전이 모든 한정자를 지원하는 것은 아닙니다. 새로운 한정자를 사용하면 암시적으로
-플랫폼 버전 한정자도 추가하므로 구형 기기가 이를 무시하게 됩니다. 예를 들어
-w600dp 한정자를 사용하면 자동적으로 v13 한정자를 포함합니다.
-사용 가능한 너비 한정자가 API 레벨 13부터 새로 도입되었기 때문입니다. 문제를 애초에 피하려면, 항상
-기본 리소스를 한 세트 포함하세요(한정자 없는 리소스 한 세트). 자세한 정보는
+1.0 이후부터 추가되었으므로 모든 Android 버전이 모든 한정자를 지원하는 것은 아닙니다. 새로운 한정자를 사용하면 암시적으로
+플랫폼 버전 한정자도 추가하므로 구형 기기가 이를 무시하게 됩니다. 예를 들어
+w600dp 한정자를 사용하면 자동적으로 v13 한정자를 포함합니다.
+사용 가능한 너비 한정자가 API 레벨 13부터 새로 도입되었기 때문입니다. 문제를 애초에 피하려면, 항상
+기본 리소스를 한 세트 포함하세요(한정자 없는 리소스 한 세트). 자세한 정보는
리소스와 연관된 최선의 기기 호환성 제공
을 참조하십시오.
@@ -808,7 +808,7 @@ orientation" described above.
한 가지 리소스 세트에 여러 개의 한정자를 사용할 수 있으며, 이를 대시로 구분하면 됩니다. 예를 들어,
-drawable-en-rUS-land는 수평 방향의
+drawable-en-rUS-land는 수평 방향의
US-English 기기에 적용합니다.
대체 리소스 디렉터리는 중첩될 수 없습니다. 예를 들어,
res/drawable/drawable-en/는 있을 수 없습니다.
-
값은 대소문자를 구분하지 않습니다. 리소스 컴파일러가 처리 전에 디렉터리 이름을
-소문자로 바꿔 대소문자를 구분하지 않는
+
값은 대소문자를 구분하지 않습니다. 리소스 컴파일러가 처리 전에 디렉터리 이름을
+소문자로 바꿔 대소문자를 구분하지 않는
파일 시스템에서 문제를 일으키지 않도록 방지합니다. 이름에 대문자가 있는 것은 오로지 가독성을 향상하기 위해서입니다.
-
각 한정자 유형마다 한 개의 값만 지원됩니다. 예를 들어, 스페인과 프랑스에
-같은 드로어블 파일을 사용하고자 하는 경우 디렉터리 이름이
-drawable-rES-rFR/이면 안 됩니다. 대신
+
각 한정자 유형마다 한 개의 값만 지원됩니다. 예를 들어, 스페인과 프랑스에
+같은 드로어블 파일을 사용하고자 하는 경우 디렉터리 이름이
+drawable-rES-rFR/이면 안 됩니다. 대신
drawable-rES/와 drawable-rFR/ 같이 적절한 파일이 포함된 두 개의 리소스 디렉터리가 필요합니다.
-그러나 두 위치에서 같은 파일을 실제로 복제할 필요는 없습니다. 대신
+그러나 두 위치에서 같은 파일을 실제로 복제할 필요는 없습니다. 대신
리소스에 별명을 만들면 됩니다. 아래의 별명 리소스
생성을 참조하십시오.
-
이런 한정자로 이름을 지은 디렉터리에 대체 리소스를 저장하고 나면
+
이런 한정자로 이름을 지은 디렉터리에 대체 리소스를 저장하고 나면
Android가 현재 기기 구성에 기초하여 애플리케이션에 자동으로 리소스를 적용합니다.
리소스가 요청될 때마다 Android가 요청한 리소스 파일이 들어있는
-대체 리소스 디렉터리를 확인하고, 그런 다음 가장 잘 일치하는
-리소스를 찾습니다(아래에서 논함). 특정 기기 구성에 일치하는 대체 리소스가 없는 경우,
+대체 리소스 디렉터리를 확인하고, 그런 다음 가장 잘 일치하는
+리소스를 찾습니다(아래에서 논함). 특정 기기 구성에 일치하는 대체 리소스가 없는 경우,
Android는 상응하는 기본 리소스(구성 한정자를 포함하지 않는
특정 리소스 유형에 대한 리소스 세트
)를 사용합니다.
@@ -844,31 +844,31 @@ Android는 상응하는 기본 리소스(구성 한정자를 포함하지 않는
별명 리소스 생성
-
어떤 리소스를 하나 이상의 기기 구성에서 사용하고자 하는 경우(그렇지만
-이를 기본 리소스를 제공하는 것은 원치 않는 경우), 같은 리소스를 하나 이상의 대체 리소스 디렉터리에
-넣지 않아도 됩니다. 대신, 기본 리소스 디렉터리에 저장된 리소스에 대해 별명 역할을 하는
-대체
+
어떤 리소스를 하나 이상의 기기 구성에서 사용하고자 하는 경우(그렇지만
+이를 기본 리소스를 제공하는 것은 원치 않는 경우), 같은 리소스를 하나 이상의 대체 리소스 디렉터리에
+넣지 않아도 됩니다. 대신, 기본 리소스 디렉터리에 저장된 리소스에 대해 별명 역할을 하는
+대체
리소스를 만들면 됩니다(경우에 따라).
-
참고: 모든 리소스가 다른 리소스에 대한
-별명을 생성할 수 있는 메커니즘을 제공하는 것은 아닙니다. 특히, {@code xml/} 디렉터리의 애니메이션, 메뉴, 원시 및 기타 지정되지 않은
+
참고: 모든 리소스가 다른 리소스에 대한
+별명을 생성할 수 있는 메커니즘을 제공하는 것은 아닙니다. 특히, {@code xml/} 디렉터리의 애니메이션, 메뉴, 원시 및 기타 지정되지 않은
리소스는 이 기능을 제공하지 않습니다.
-
예를 들어, 애플리케이션 아이콘 {@code icon.png}이 있고 서로 다른 로케일에서 이 아이콘의 고유 버전이
-필요한 경우가 있습니다. 그러나 두 로케일, English-Canadian과 French-Canadian은 같은 버전을
-사용해야 합니다. 같은 이미지를 English-Canadian과 French-Canadian 양쪽
-모두에 대한 리소스 디렉터리에 복사해야 한다고 생각할 수 있지만, 실은
+
예를 들어, 애플리케이션 아이콘 {@code icon.png}이 있고 서로 다른 로케일에서 이 아이콘의 고유 버전이
+필요한 경우가 있습니다. 그러나 두 로케일, English-Canadian과 French-Canadian은 같은 버전을
+사용해야 합니다. 같은 이미지를 English-Canadian과 French-Canadian 양쪽
+모두에 대한 리소스 디렉터리에 복사해야 한다고 생각할 수 있지만, 실은
그렇지 않습니다. 대신, 두 로케일에서 사용하는 이미지를 {@code icon_ca.png}(
-{@code icon.png} 이외에 어떤 이름이든 가능)로 저장하고 이를
+{@code icon.png} 이외에 어떤 이름이든 가능)로 저장하고 이를
기본 {@code res/drawable/} 디렉터리에 넣으면 됩니다. 그런 다음 {@code icon.xml} 파일을 {@code icon_ca.png}
리소스를 참조하는 {@code
-res/drawable-en-rCA/} 및 {@code res/drawable-fr-rCA/}로 생성합니다. 이때, {@code <bitmap>} 요소를 사용하면 됩니다. 이렇게 하면
+res/drawable-en-rCA/} 및 {@code res/drawable-fr-rCA/}로 생성합니다. 이때, {@code <bitmap>} 요소를 사용하면 됩니다. 이렇게 하면
PNG 파일 버전 하나와 그것을 가리키는 작은 XML 파일 두 개만 저장할 수 있습니다. (XML 파일 예시는 아래와 같습니다.)
드로어블
-
기존 드로어블에 별명을 생성하려면 {@code <bitmap>} 요소를 사용합니다.
+
기존 드로어블에 별명을 생성하려면 {@code <bitmap>} 요소를 사용합니다.
예를 들면 다음과 같습니다.
애플리케이션이 여러 기기 구성을 지원하게 하려면,
언제나 애플리케이션이 사용하는 각 유형의 리소스에 기본 리소스를 제공하는 것이 매우 중요합니다.
예를 들어 애플리케이션이 여러 언어를 지원할 경우, 항상 언어 및 지역 한정자없이 {@code
-values/} 디렉터리(여기에 문자열 저장)를 포함시켜야 합니다. 그렇게 하지 않고 언어와 지역 한정자가 있는 디렉터리에
-모든 문자열을 넣으면, 문자열이 지원하지 않는 언어로 설정된 기기에서 애플리케이션을
-실행하면 작동이 중단됩니다. 그러나 기본
-{@code values/} 리소스를 제공하는 한은 애플리케이션이 제대로 실행됩니다(사용자가 이해하지 못하는
+values/} 디렉터리(여기에 문자열 저장)를 포함시켜야 합니다. 그렇게 하지 않고 언어와 지역 한정자가 있는 디렉터리에
+모든 문자열을 넣으면, 문자열이 지원하지 않는 언어로 설정된 기기에서 애플리케이션을
+실행하면 작동이 중단됩니다. 그러나 기본
+{@code values/} 리소스를 제공하는 한은 애플리케이션이 제대로 실행됩니다(사용자가 이해하지 못하는
언어로라도 작동합니다. 작동 중단보다 낫습니다.)
-
마찬가지로 화면 방향에 기초하여 여러 가지 레이아웃 리소스를 제공하는 경우
+
마찬가지로 화면 방향에 기초하여 여러 가지 레이아웃 리소스를 제공하는 경우
하나의 방향을 기본값으로 선택해야 합니다. 예를 들어 가로 방향에는 {@code
-layout-land/}로, 세로 방향에는 {@code layout-port/}로 레이아웃 리소스를 제공하는 대신 하나를 기본으로 남겨두십시오.
+layout-land/}로, 세로 방향에는 {@code layout-port/}로 레이아웃 리소스를 제공하는 대신 하나를 기본으로 남겨두십시오.
가로 방향에 {@code layout/}, 세로 방향에 {@code layout-port/}와 같은 식으로 하면 됩니다.
-
애플리케이션이 예상치 못한 구성에서 실행될 수 있을 뿐만 아니라
-Android의 새 버전에서 이전 버전에서는 지원하지 않는 구성 한정자를 추가할 수도 있으므로,
-기본 리소스를 제공하는 것이 중요합니다. 새 리소스 한정자를 사용하지만,
+
애플리케이션이 예상치 못한 구성에서 실행될 수 있을 뿐만 아니라
+Android의 새 버전에서 이전 버전에서는 지원하지 않는 구성 한정자를 추가할 수도 있으므로,
+기본 리소스를 제공하는 것이 중요합니다. 새 리소스 한정자를 사용하지만,
Android 이전 버전과 코드 호환성은 유지한 경우, 그 후 Android 이전 버전이
-애플리케이션을 실행하면 새로운 한정자로 이름을 지정한 리소스를 사용할 수 없으므로 기본 리소스를 제공하지 않으면
+애플리케이션을 실행하면 새로운 한정자로 이름을 지정한 리소스를 사용할 수 없으므로 기본 리소스를 제공하지 않으면
애플리케이션 작동이 중단됩니다. 예를 들어, {@code
-minSdkVersion}이 4로 설정되고 야간 모드(API 레벨 8에서 추가된 {@code night} 또는 {@code notnight})를 사용하는 모든 드로어블 리소스를 한정할 경우, API 레벨 4 기기는
-드로어블 리소스에 액세스하지 못하고 사용이 중단됩니다. 이 경우,
-{@code notnight}를 기본 리소스로 제공하는 것이 좋습니다. 그래야 해당 한정자를 배제하고
+minSdkVersion}이 4로 설정되고 야간 모드(API 레벨 8에서 추가된 {@code night} 또는 {@code notnight})를 사용하는 모든 드로어블 리소스를 한정할 경우, API 레벨 4 기기는
+드로어블 리소스에 액세스하지 못하고 사용이 중단됩니다. 이 경우,
+{@code notnight}를 기본 리소스로 제공하는 것이 좋습니다. 그래야 해당 한정자를 배제하고
드로어블 리소스가 {@code drawable/} 또는 {@code drawable-night/}이 됩니다.
-
그러므로 최선의 기기 호환성을 제공하려면 언제나
-애플리케이션에서 반드시 제대로 수행해야 하는 리소스에 대해 기본 리소스를 제공하십시오. 그런 다음 구성 한정자를 사용하여
+
그러므로 최선의 기기 호환성을 제공하려면 언제나
+애플리케이션에서 반드시 제대로 수행해야 하는 리소스에 대해 기본 리소스를 제공하십시오. 그런 다음 구성 한정자를 사용하여
특정 기기 구성에 대해 대체 리소스를 생성하면 됩니다.
-
이 규칙에는 한 가지 예외가 있습니다. 애플리케이션의 {@code minSdkVersion} 이 4 이상이면
-화면 밀도 한정자로 대체 드로어블 리소스를 제공할 때 기본 드로어블
-리소스가 없어도 됩니다. 기본
-드로어블 리소스가 없더라도 Android가 대체 화면 화질 중에서 가장 잘 맞는 리소스를 찾고
-필요에 따라 비트맵을 축소합니다. 그러나 모든 유형의 기기에서 최상의 경험을 제공하려면,
+
이 규칙에는 한 가지 예외가 있습니다. 애플리케이션의 {@code minSdkVersion} 이 4 이상이면
+화면 밀도 한정자로 대체 드로어블 리소스를 제공할 때 기본 드로어블
+리소스가 없어도 됩니다. 기본
+드로어블 리소스가 없더라도 Android가 대체 화면 화질 중에서 가장 잘 맞는 리소스를 찾고
+필요에 따라 비트맵을 축소합니다. 그러나 모든 유형의 기기에서 최상의 경험을 제공하려면,
모든 세 가지 유형의 밀도에 대해 대체 드로어블을 제공해야 합니다.
Android가 가장 잘 일치하는 리소스를 찾는 방법
-
개발자가 자신이 대체를 제공하는 리소스를 요청하면 Android가 런타임에 어느 대체 리소스를
-사용할지 현대 기기 구성에 따라 여러 가지로 선택합니다. Android가
-대체 리소스를 선택하는 방법을 보여주기 위해 다음 드로어블 디렉터리에 각각 같은 이미지의
+
개발자가 자신이 대체를 제공하는 리소스를 요청하면 Android가 런타임에 어느 대체 리소스를
+사용할지 현대 기기 구성에 따라 여러 가지로 선택합니다. Android가
+대체 리소스를 선택하는 방법을 보여주기 위해 다음 드로어블 디렉터리에 각각 같은 이미지의
서로 다른 버전이 들어있다고 가정하겠습니다.
@@ -997,16 +997,16 @@ drawable-port-notouch-12key/
기본 텍스트 입력 메서드 = 12key
-
Android는 기기 구성을 이용 가능한 대체 리소스와 비교하여,
+
Android는 기기 구성을 이용 가능한 대체 리소스와 비교하여,
{@code drawable-en-port}에서 드로어블을 선택합니다.
예외: 화면 픽셀 밀도 한정자 하나만은 충돌을 이유로 제거되지
-않습니다. 기기의 화면 밀도가 hdpi라도,
+
예외: 화면 픽셀 밀도 한정자 하나만은 충돌을 이유로 제거되지
+않습니다. 기기의 화면 밀도가 hdpi라도,
현 시점에서는 모든 화면 밀도가 일치로 간주되므로 drawable-port-ldpi/를 제거하지 않습니다.
- 자세한 정보는 다중 화면
+ 자세한 정보는 다중 화면
지원 문서에서 이용하실 수 있습니다.
목록(표2)에서 (그 다음으로) 우선 순위가 가장 높은 한정자를 선택합니다
(MCC부터 시작하여 아래로 내려가십시오).
리소스 디렉터리 중에 이 한정자를 포함한 것이 있나요?
-
없는 경우, 2단계로 돌아가 다음 한정자를 살펴보십시오 (이 예시의 경우
+
없는 경우, 2단계로 돌아가 다음 한정자를 살펴보십시오 (이 예시의 경우
언어 한정자에 도달할 때까지 답은 "없습니다"입니다).
있는 경우, 4단계로 계속 진행합니다.
-
이 한정자를 포함하지 않는 디렉터리를 제거합니다. 이 예시에서는 시스템이
+
이 한정자를 포함하지 않는 디렉터리를 제거합니다. 이 예시에서는 시스템이
언어 한정자를 포함하지 않는 디렉터리를 모두 제거합니다.
예외: 문제의 한정자가 화면 픽셀 밀도라면,
-Android는 기기 화면 밀도와 가장 가깝게 일치하는 옵션을 선택합니다.
+
예외: 문제의 한정자가 화면 픽셀 밀도라면,
+Android는 기기 화면 밀도와 가장 가깝게 일치하는 옵션을 선택합니다.
일반적으로, Android는 작은 원본 이미지를 확대하는 것보다
-큰 원본 이미지를 축소하는 것을 선호합니다. 다중 화면
+큰 원본 이미지를 축소하는 것을 선호합니다. 다중 화면
지원을 참조하십시오.
-
뒤로 돌아가 디렉터리가 한 개만 남을 때까지 2, 3 및 4단계를 반복합니다. 이 예시에서, 일치하는 것이 있는 다음 한정자는
-화면 방향입니다.
+
뒤로 돌아가 디렉터리가 한 개만 남을 때까지 2, 3 및 4단계를 반복합니다. 이 예시에서, 일치하는 것이 있는 다음 한정자는
+화면 방향입니다.
그러므로 화면 방향을 지정하지 않는 리소스가 제거됩니다.
이 절차는 요청된 각 리소스에 대해 실행하지만, 시스템이 몇 가지 측면을 추가로
-최적화합니다. 그러한 최적화 가운데에는 일단 기기 구성을 알게 되고 나면 절대 일치할 가능성이 없는
-대체 리소스를 시스템이 제거할 수 있다는 점도 있습니다. 예를 들어, 구성 언어가
-영어("en")이고 영어 이외의 다른 언어 한정자로 설정된 리소스 디렉터리는
+
이 절차는 요청된 각 리소스에 대해 실행하지만, 시스템이 몇 가지 측면을 추가로
+최적화합니다. 그러한 최적화 가운데에는 일단 기기 구성을 알게 되고 나면 절대 일치할 가능성이 없는
+대체 리소스를 시스템이 제거할 수 있다는 점도 있습니다. 예를 들어, 구성 언어가
+영어("en")이고 영어 이외의 다른 언어 한정자로 설정된 리소스 디렉터리는
절대 확인된 리소스 풀에 포함되지 않습니다(
언어 한정자가 포함되지 않는 리소스 디렉터리는 여전히 포함됩니다).
화면 크기 한정자에 기초하여 리소스를 선택할 때 시스템은 가장 잘 일치하는 리소스가 없다면
현재 화면보다 작은 화면에 지정된 리소스를 사용합니다
-(예를 들어, 큰 화면은 필요에 따라 일반 크기 화면 리소스를 사용합니다). 그러나
+(예를 들어, 큰 화면은 필요에 따라 일반 크기 화면 리소스를 사용합니다). 그러나
이용 가능한 리소스가 현재 화면보다 큰 리소스뿐이라면, 시스템은
이를 사용하지 않고, 기기 구성에 일치하는 리소스가 없으면 애플리케이션 사용이 중단됩니다
(예를 들어 모든 레이아웃 리소스가 {@code xlarge} 한정자에 태그되어 있지만,
기기가 보통 크기 화면일 경우).
-
참고: 한정자의 우선 순위(표 2 참조)가 기기와 정확하게 일치하는
-한정자 수보다 더 중요합니다. 예를 들어 위의 4단계에서
+
참고: 한정자의 우선 순위(표 2 참조)가 기기와 정확하게 일치하는
+한정자 수보다 더 중요합니다. 예를 들어 위의 4단계에서
목록의 마지막 선택에 기기와 정확히 일치하는 한정자가 세 개 포함되어 있지만(방향, 터치 스크린
-유형 및 입력 메서드), drawable-en에는 일치하는 매개변수가
-하나뿐입니다(언어). 다만, 언어가 이러한 다른 한정자보다 우선 순위가 높기 때문에
+유형 및 입력 메서드), drawable-en에는 일치하는 매개변수가
+하나뿐입니다(언어). 다만, 언어가 이러한 다른 한정자보다 우선 순위가 높기 때문에
drawable-port-notouch-12key는 탈락합니다.
애플리케이션에서 리소스를 사용하는 것에 대한 자세한 정보는 리소스 액세스로 계속 진행하여 알아보십시오.
diff --git a/docs/html-intl/intl/ko/guide/topics/resources/runtime-changes.jd b/docs/html-intl/intl/ko/guide/topics/resources/runtime-changes.jd
index a5e7f5bbad883..720601fb999a3 100644
--- a/docs/html-intl/intl/ko/guide/topics/resources/runtime-changes.jd
+++ b/docs/html-intl/intl/ko/guide/topics/resources/runtime-changes.jd
@@ -22,41 +22,41 @@ page.tags=액티비티, 수명 주기
몇몇 기기 구성은 런타임 중에 변경될 수 있습니다
-(예: 화면 방향, 키보드 가용성 및 언어 등). 그러한 변경이 일어나는 경우,
-Android는 실행 중인
+(예: 화면 방향, 키보드 가용성 및 언어 등). 그러한 변경이 일어나는 경우,
+Android는 실행 중인
{@link android.app.Activity}를 다시 시작합니다({@link android.app.Activity#onDestroy()} 호출, 뒤이어 {@link
-android.app.Activity#onCreate(Bundle) onCreate()} 호출). 이런 동작은 여러분이 제공한
+android.app.Activity#onCreate(Bundle) onCreate()} 호출). 이런 동작은 여러분이 제공한
대체 리소스로 애플리케이션을 자동으로 다시 로딩함으로써 새로운 기기 구성에 애플리케이션이 적응하는 것을 돕도록
설계되었습니다(예: 다양한 화면 방향과 크기에 대한 다양한 레이아웃).
-
다시 시작을 적절히 처리하려면 액티비티가 정상적인
+
다시 시작을 적절히 처리하려면 액티비티가 정상적인
액티비티
-수명 주기를 통해 이전 상태를 복원하는 것이 중요합니다. 여기에서 Android는
-{@link android.app.Activity#onSaveInstanceState(Bundle) onSaveInstanceState()}를 호출한 다음에 액티비티를 소멸시켜
-애플리케이션 상태에 대한 데이터를 저장할 수 있습니다. 그러면
+수명 주기를 통해 이전 상태를 복원하는 것이 중요합니다. 여기에서 Android는
+{@link android.app.Activity#onSaveInstanceState(Bundle) onSaveInstanceState()}를 호출한 다음에 액티비티를 소멸시켜
+애플리케이션 상태에 대한 데이터를 저장할 수 있습니다. 그러면
{@link android.app.Activity#onCreate(Bundle) onCreate()} 또는 {@link
android.app.Activity#onRestoreInstanceState(Bundle) onRestoreInstanceState()} 중에 상태를 복원할 수 있습니다.
-
애플리케이션이 애플리케이션 상태를 그대로 유지한 채 스스로 다시 시작할 수 있는지 시험해 보려면,
-구성 변경을 일으켜보아야 합니다(예를 들어 화면 방향 변경 등). 이는 애플리케이션에서 여러 가지 작업을 수행하는
-동안 해봅니다. 애플리케이션이 언제든 사용자 데이터나 상태를 손실하지 않고
-다시 시작할 수 있어야 합니다. 그래야 구성 변경과 같은 이벤트를 처리할 수 있기 때문입니다. 그렇지 않으면
-사용자가 걸려오는 전화를 받은 다음 한참 후에 애플리케이션으로 돌아오면 애플리케이션 프로세스가 이미
+
애플리케이션이 애플리케이션 상태를 그대로 유지한 채 스스로 다시 시작할 수 있는지 시험해 보려면,
+구성 변경을 일으켜보아야 합니다(예를 들어 화면 방향 변경 등). 이는 애플리케이션에서 여러 가지 작업을 수행하는
+동안 해봅니다. 애플리케이션이 언제든 사용자 데이터나 상태를 손실하지 않고
+다시 시작할 수 있어야 합니다. 그래야 구성 변경과 같은 이벤트를 처리할 수 있기 때문입니다. 그렇지 않으면
+사용자가 걸려오는 전화를 받은 다음 한참 후에 애플리케이션으로 돌아오면 애플리케이션 프로세스가 이미
소멸되어 있을 수 있습니다. 액티비티 상태를 복원하는 방법을 배우려면, 액티비티 수명 주기에 관해 읽어보십시오.
-
하지만, 애플리케이션을 다시 시작하고 상당량의 데이터를 복원하면 비용도 많이 들고
-불량한 사용자 환경이 만들어지는 상황에 직면할 수도 있습니다. 그러한 상황이라면,
+
하지만, 애플리케이션을 다시 시작하고 상당량의 데이터를 복원하면 비용도 많이 들고
+불량한 사용자 환경이 만들어지는 상황에 직면할 수도 있습니다. 그러한 상황이라면,
두 가지 다른 옵션이 있습니다.
액티비티를 다시 시작하려면 많은 수의 데이터 세트를 복구해야 하는 경우, 네트워크 연결을
-다시 설정하거나 다른 집약적 작업을 수행한 다음 완전히 다시 시작하십시오.
-구성 변경 때문에 사용자 환경이 느려질 수 있습니다. 또한, 액티비티 상태를 완전히 복원하려면
+
액티비티를 다시 시작하려면 많은 수의 데이터 세트를 복구해야 하는 경우, 네트워크 연결을
+다시 설정하거나 다른 집약적 작업을 수행한 다음 완전히 다시 시작하십시오.
+구성 변경 때문에 사용자 환경이 느려질 수 있습니다. 또한, 액티비티 상태를 완전히 복원하려면
{@link android.os.Bundle}을 사용할 수도 있습니다. 이것은 시스템이 개발자 대신 {@link
-android.app.Activity#onSaveInstanceState(Bundle) onSaveInstanceState()} 콜백으로 저장해두는 것입니다. 이것은 대형 객체(예: 비트맵)를 담도록
-디자인된 것이 아니며 이 안의 데이터는 반드시 직렬화했다가 다시 역직렬화해야 합니다. 이렇게 하면
-메모리를 아주 많이 소모할 수 있으며 구성 변경이 느려질 수 있습니다. 이와 같은 상황에서는
+android.app.Activity#onSaveInstanceState(Bundle) onSaveInstanceState()} 콜백으로 저장해두는 것입니다. 이것은 대형 객체(예: 비트맵)를 담도록
+디자인된 것이 아니며 이 안의 데이터는 반드시 직렬화했다가 다시 역직렬화해야 합니다. 이렇게 하면
+메모리를 아주 많이 소모할 수 있으며 구성 변경이 느려질 수 있습니다. 이와 같은 상황에서는
액티비티를 다시 초기화해야 한다는 부담을 해결하기 위해 액티비티가 구성 변경으로 인해 다시 시작되었을 때 {@link
-android.app.Fragment}를 보존하면 됩니다. 이 프래그먼트에는
+android.app.Fragment}를 보존하면 됩니다. 이 프래그먼트에는
보존하고자 하는 상태 저장 객체에 대한 참조를 담을 수 있습니다.
-
Android 시스템이 구성 변경으로 인하여 액티비티를 종료시킬 때, 액티비티에서 보존하기로 표시해둔
-프래그먼트는 소멸되지 않습니다. 그러한 프래그먼트를 액티비티에 추가하면
+
Android 시스템이 구성 변경으로 인하여 액티비티를 종료시킬 때, 액티비티에서 보존하기로 표시해둔
+프래그먼트는 소멸되지 않습니다. 그러한 프래그먼트를 액티비티에 추가하면
상태 저장 객체를 보존할 수 있습니다.
런타임 구성 변경 중에 상태 저장 객체를 프래그먼트에 보존해두는 방법은 다음과 같습니다.
-
{@link android.app.Fragment} 클래스를 확장하고 상태 저장
+
{@link android.app.Fragment} 클래스를 확장하고 상태 저장
객체에 참조를 선언합니다.
{@link android.app.FragmentManager}를 사용하여 액티비티가 다시 시작될 때 프래그먼트를
+
{@link android.app.FragmentManager}를 사용하여 액티비티가 다시 시작될 때 프래그먼트를
검색합니다.
@@ -117,16 +117,16 @@ public class RetainedFragment extends Fragment {
}
-
주의: 어느 객체든 저장할 수 있지만,
+
주의: 어느 객체든 저장할 수 있지만,
{@link android.app.Activity}에 묶여 있는 객체는 절대로 전달하면 안 됩니다. 예를 들어 {@link
android.graphics.drawable.Drawable}, {@link android.widget.Adapter}, {@link android.view.View}
- 또는 {@link android.content.Context}와 연관된 기타 모든 객체가 이에 해당됩니다. 이런 것을 전달하면,
-원래 액티비티 인스턴스의 모든 보기와 리소스를 몽땅 누출시킵니다. (리소스 누출이란
-애플리케이션이 리소스에 대한 보유권을 유지하고 있어 가비지 수집의 대상이 될 수 없고, 따라서 엄청난 양의 메모리가
+ 또는 {@link android.content.Context}와 연관된 기타 모든 객체가 이에 해당됩니다. 이런 것을 전달하면,
+원래 액티비티 인스턴스의 모든 보기와 리소스를 몽땅 누출시킵니다. (리소스 누출이란
+애플리케이션이 리소스에 대한 보유권을 유지하고 있어 가비지 수집의 대상이 될 수 없고, 따라서 엄청난 양의 메모리가
손실된다는 뜻입니다.)
-
그런 다음 {@link android.app.FragmentManager}를 사용하여 프래그먼트를 액티비티에 추가합니다.
-프래그먼트에서 데이터 객체를 가져오려면 런타임 구성 변경 중에 액티비티가 다시 시작될 때
+
그런 다음 {@link android.app.FragmentManager}를 사용하여 프래그먼트를 액티비티에 추가합니다.
+프래그먼트에서 데이터 객체를 가져오려면 런타임 구성 변경 중에 액티비티가 다시 시작될 때
가져오면 됩니다. 예를 들어, 액티비티를 다음과 같이 정의합니다.
@@ -165,10 +165,10 @@ public class MyActivity extends Activity {
}
-
이 예시에서 {@link android.app.Activity#onCreate(Bundle) onCreate()}는 프래그먼트를 추가하거나
-이에 대한 참조를 복원합니다. {@link android.app.Activity#onCreate(Bundle) onCreate()} 또한
-프래그먼트 인스턴스 안에 상태 저장 객체를 저장합니다.
-{@link android.app.Activity#onDestroy() onDestroy()}는 보존된
+
이 예시에서 {@link android.app.Activity#onCreate(Bundle) onCreate()}는 프래그먼트를 추가하거나
+이에 대한 참조를 복원합니다. {@link android.app.Activity#onCreate(Bundle) onCreate()} 또한
+프래그먼트 인스턴스 안에 상태 저장 객체를 저장합니다.
+{@link android.app.Activity#onDestroy() onDestroy()}는 보존된
프래그먼트 인스턴스 내부의 상태 저장 객체를 업데이트합니다.
@@ -177,26 +177,26 @@ public class MyActivity extends Activity {
구성 변경 직접 처리하기
-
애플리케이션이 특정 구성 변경 중에 리소스를 업데이트하지 않아도 되고
-그와 동시에 성능 한계가 있어 액티비티 다시 시작을 피해야 하는 경우,
-액티비티가 구성 변경을 알아서 처리한다고 선언하면 됩니다.
+
애플리케이션이 특정 구성 변경 중에 리소스를 업데이트하지 않아도 되고
+그와 동시에 성능 한계가 있어 액티비티 다시 시작을 피해야 하는 경우,
+액티비티가 구성 변경을 알아서 처리한다고 선언하면 됩니다.
이렇게 하면 시스템이 액티비티를 다시 시작하지 않도록 방지할 수 있습니다.
-
참고: 구성 변경을 직접 처리하면 대체 리소스를 사용하는 것이
-훨씬 더 까다로워질 수 있습니다. 시스템이 개발자 대신 자동으로 이를 적용해주지 않기
-때문입니다. 이 기법은 구성 변경으로 인한 재시작을 반드시 피해야만 하는 경우 최후의 수단으로서만
+
참고: 구성 변경을 직접 처리하면 대체 리소스를 사용하는 것이
+훨씬 더 까다로워질 수 있습니다. 시스템이 개발자 대신 자동으로 이를 적용해주지 않기
+때문입니다. 이 기법은 구성 변경으로 인한 재시작을 반드시 피해야만 하는 경우 최후의 수단으로서만
고려해야 하며 대부분의 애플리케이션에는 권장하지 않습니다.
-
액티비티가 구성 변경을 직접 처리한다고 선언하려면, 매니페스트 파일의 적절한 {@code <activity>} 요소를 편집하여
+
액티비티가 구성 변경을 직접 처리한다고 선언하려면, 매니페스트 파일의 적절한 {@code <activity>} 요소를 편집하여
처리하고자 하는 구성을 나타내는 값이 있는 {@code
-android:configChanges} 속성을 포함하도록
+android:configChanges} 속성을 포함하도록
합니다. 가능한 값은 {@code
-android:configChanges} 속성에 대한 관련 문서에 목록으로 나열되어 있습니다(가장 보편적으로 사용되는 값은 화면 방향이 변경될 때 다시 시작을 방지하는 {@code "orientation"}과
+android:configChanges} 속성에 대한 관련 문서에 목록으로 나열되어 있습니다(가장 보편적으로 사용되는 값은 화면 방향이 변경될 때 다시 시작을 방지하는 {@code "orientation"}과
키보드 가용성이 변경될 때 다시 시작을 방지하는 {@code "keyboardHidden"}
-입니다). 이 속성에는 여러 개의 구성 값을 선언할 수 있습니다. 각각을
+입니다). 이 속성에는 여러 개의 구성 값을 선언할 수 있습니다. 각각을
파이프 {@code |} 문자로 구분하면 됩니다.
-
예를 들어 다음 매니페스트 코드는 화면 방향 변경과 키보드 가용성 변경을 둘 다
+
예를 들어 다음 매니페스트 코드는 화면 방향 변경과 키보드 가용성 변경을 둘 다
처리하는 액티비티를 선언하는 것입니다.
@@ -205,29 +205,29 @@ android:configChanges} 속성에 대한 관련 문서에 목록으로 나열
android:label="@string/app_name">
-
이제 이러한 구성 중 하나가 변경되어도 {@code MyActivity}는 다시 시작하지 않습니다.
+
이제 이러한 구성 중 하나가 변경되어도 {@code MyActivity}는 다시 시작하지 않습니다.
그 대신, {@code MyActivity}가 {@link
-android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()}로의 호출을 받습니다. 이 메서드는
-{@link android.content.res.Configuration} 객체로 전달되며, 이는 새 기기 구성을
-나타냅니다. {@link android.content.res.Configuration}의 필드를 읽어보면
-새 구성을 판별할 수 있고 적절한 변경을 할 수 있습니다. 그러려면 인터페이스에 사용된 리소스를
-업데이트하면 됩니다. 이 메서드가
-호출되면, 액티비티의 {@link android.content.res.Resources} 객체가
-업데이트되어 새 구성에 기반한 리소스를 반환하며, 따라서 시스템이 액티비티를 다시 시작하지 않아도
+android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()}로의 호출을 받습니다. 이 메서드는
+{@link android.content.res.Configuration} 객체로 전달되며, 이는 새 기기 구성을
+나타냅니다. {@link android.content.res.Configuration}의 필드를 읽어보면
+새 구성을 판별할 수 있고 적절한 변경을 할 수 있습니다. 그러려면 인터페이스에 사용된 리소스를
+업데이트하면 됩니다. 이 메서드가
+호출되면, 액티비티의 {@link android.content.res.Resources} 객체가
+업데이트되어 새 구성에 기반한 리소스를 반환하며, 따라서 시스템이 액티비티를 다시 시작하지 않아도
UI의 요소를 손쉽게 재설정할 수 있게 됩니다.
-
주의: Android 3.2(API 레벨 13)부터 기기가
-세로 방향 및 가로 방향 사이를 전환할 때 "화면 크기"도
-같이 변경됩니다. 따라서,
+
주의: Android 3.2(API 레벨 13)부터 기기가
+세로 방향 및 가로 방향 사이를 전환할 때 "화면 크기"도
+같이 변경됩니다. 따라서,
API 레벨 13 이상({@code minSdkVersion} 및 {@code targetSdkVersion}
속성에서 선언한 내용에 따름)을 대상으로 개발하는 경우 방향 변경으로 인한 런타임 다시 시작을 방지하고자 하면, {@code
"orientation"} 값 외에 {@code "screenSize"} 값도 포함시켜야 합니다. 다시 말해, {@code
-android:configChanges="orientation|screenSize"}를 선언해야 합니다. 하지만, 애플리케이션이 API 레벨 12 이하를
-대상으로 하는 경우라면 애플리케이션이 언제든 이 구성 변경을 알아서 처리합니다(이 구성 변경은
+android:configChanges="orientation|screenSize"}를 선언해야 합니다. 하지만, 애플리케이션이 API 레벨 12 이하를
+대상으로 하는 경우라면 애플리케이션이 언제든 이 구성 변경을 알아서 처리합니다(이 구성 변경은
액티비티를 다시 시작하지 않습니다. 이는 Android 3.2 이상 기기에서 실행되는 경우에도 마찬가지입니다).
예를 들어, 다음 {@link
-android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()} 구현은
+android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()} 구현은
현재 기기의 방향을 확인합니다.
@@ -244,36 +244,36 @@ public void onConfigurationChanged(Configuration newConfig) {
}
-
{@link android.content.res.Configuration} 객체는 변경된 것만이 아니라 현재
-구성 전체를 나타냅니다. 대부분의 경우에는 구성이 정확히 어떻게
-변경되었는지에는 관심이 없고 처리 중인 구성에 대체 리소스를 제공하는 모든 리소스를 그저
+
{@link android.content.res.Configuration} 객체는 변경된 것만이 아니라 현재
+구성 전체를 나타냅니다. 대부분의 경우에는 구성이 정확히 어떻게
+변경되었는지에는 관심이 없고 처리 중인 구성에 대체 리소스를 제공하는 모든 리소스를 그저
재할당하기만 하면 됩니다. 예를 들어 이제 {@link
android.content.res.Resources} 객체가 업데이트되었으니 {@link android.widget.ImageView#setImageResource(int)
-setImageResource()}가 있는 모든
-{@link android.widget.ImageView}와
+setImageResource()}가 있는 모든
+{@link android.widget.ImageView}와
새 구성에 대한 적절한 리소스를 재설정할 수 있습니다(리소스 제공에 설명된 바와 같음).
{@link
-android.content.res.Configuration} 필드에서 가져온 값이
-{@link android.content.res.Configuration} 클래스에서 가져온 특정 상수와 일치하는 정수라는 점을 눈여겨 보십시오. 각 필드에
+android.content.res.Configuration} 필드에서 가져온 값이
+{@link android.content.res.Configuration} 클래스에서 가져온 특정 상수와 일치하는 정수라는 점을 눈여겨 보십시오. 각 필드에
어느 상수를 써야 하는지에 대한 관련 문서는 {@link
android.content.res.Configuration} 참조에 있는 적절한 필드를 참조하십시오.
-
명심할 점: 액티비티가 직접 구성 변경을 처리한다고 선언하는 경우,
-대체를 제공하는 모든 요소에 대해 본인이 직접 책임을 지게 됩니다. 액티비티가 직접
-방향 변경을 처리하고 가로 및 세로 방향 사이에서 바뀌어야 하는 이미지가 있는 경우,
+
명심할 점: 액티비티가 직접 구성 변경을 처리한다고 선언하는 경우,
+대체를 제공하는 모든 요소에 대해 본인이 직접 책임을 지게 됩니다. 액티비티가 직접
+방향 변경을 처리하고 가로 및 세로 방향 사이에서 바뀌어야 하는 이미지가 있는 경우,
각 리소스를 각 요소에 재할당해야 하며 이를 {@link
android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()} 중에 수행해야 합니다.
-
이러한 구성 변경을 기반으로 애플리케이션을 업데이트하지 않아도 되는 경우,
+
이러한 구성 변경을 기반으로 애플리케이션을 업데이트하지 않아도 되는 경우,
대신 {@link
-android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()}를 구현하지 않으면 됩니다. 이런
-경우, 구성 변경 전에 쓰였던 리소스가 모두 그대로 사용되고 액티비티의 다시 시작만
-피한 것이 됩니다. 그러나, 애플리케이션은
-언제든 종료되고 이전 상태를 그대로 유지한 채 다시 시작될 수 있어야 합니다 정상적인 액티비티
-수명 주기 중에 상태 유지에서의 탈출 방안으로 이 기법을 고려해서는 안 됩니다. 이는 애플리케이션이
-다시 시작되지 않도록 방지할 수 없는, 다른 구성 변경도 여럿 있어서일뿐만 아니라, 사용자가
-애플리케이션을 떠났을 경우 해당 사용자가 다시 돌아오기 전에 소멸되는 것과 같은 이벤트를 처리해야 하기 때문이라는
+android.app.Activity#onConfigurationChanged(Configuration) onConfigurationChanged()}를 구현하지 않으면 됩니다. 이런
+경우, 구성 변경 전에 쓰였던 리소스가 모두 그대로 사용되고 액티비티의 다시 시작만
+피한 것이 됩니다. 그러나, 애플리케이션은
+언제든 종료되고 이전 상태를 그대로 유지한 채 다시 시작될 수 있어야 합니다 정상적인 액티비티
+수명 주기 중에 상태 유지에서의 탈출 방안으로 이 기법을 고려해서는 안 됩니다. 이는 애플리케이션이
+다시 시작되지 않도록 방지할 수 없는, 다른 구성 변경도 여럿 있어서일뿐만 아니라, 사용자가
+애플리케이션을 떠났을 경우 해당 사용자가 다시 돌아오기 전에 소멸되는 것과 같은 이벤트를 처리해야 하기 때문이라는
이유도 있습니다.
UI에 입력 제어를 추가하려면 단순히 XML 레이아웃에 XML 요소를 하나 추가하기만 하면 됩니다.
다음은 텍스트 필드와 버튼이 있는 레이아웃을 예시로 나타낸 것입니다.
@@ -33,16 +33,16 @@ UI에서 사용할 수 있도록 매우 다양한 제어를 제공합니다.
</LinearLayout>
-
각 입력 제어는 특정한 입력 이벤트를 지원하므로, 사용자가 텍스트를 입력할 때 또는 버튼을 터치할 때
+
각 입력 제어는 특정한 입력 이벤트를 지원하므로, 사용자가 텍스트를 입력할 때 또는 버튼을 터치할 때
이벤트를 처리할 수 있게 해줍니다.
보편적인 제어
-
다음은 앱에서 사용할 수 있는 몇 가지 보편적인 제어를 목록으로 나열한 것입니다. 링크를 따라가면 각 제어에 대해
+
다음은 앱에서 사용할 수 있는 몇 가지 보편적인 제어를 목록으로 나열한 것입니다. 링크를 따라가면 각 제어에 대해
좀 더 자세히 알아볼 수 있습니다.
참고: Android는 여기에 나열된 것보다 몇 가지 더 많은 제어를 제공합니다.
- 더 많은 내용을 알아보려면 {@link android.widget} 패키지를 탐색해보십시오.
+ 더 많은 내용을 알아보려면 {@link android.widget} 패키지를 탐색해보십시오.
앱에 특정한 종류의 입력 제어가 필요한 경우, 나름의 사용자 지정 구성 요소를 직접 구축해도 됩니다.
@@ -69,7 +69,7 @@ UI에서 사용할 수 있도록 매우 다양한 제어를 제공합니다.
레이아웃은 사용자 인터페이스에 대한 시각적 구조를 정의합니다. 예컨대 액티비티 또는 앱 위젯에 대한 UI가 이에 해당됩니다.
레이아웃을 선언하는 데에는 다음과 같은 두 가지 방법이 있습니다.
-
UI 요소를 XML로 선언. Android가 위젯과 레이아웃 등과 같이
+
UI 요소를 XML로 선언. Android가 위젯과 레이아웃 등과 같이
보기 클래스와 하위 클래스에 상응하는 간단한 XML 어휘를 제공합니다.
런타임에 레이아웃 요소를 인스턴트화. 애플리케이션이
프로그래밍 방법으로 보기 및 ViewGroup객체를 만들 수 있습니다(그리고 그 속성을 조작하기도 합니다).
@@ -55,26 +55,26 @@ page.tags=view,viewgroup
Eclipse용 ADT
플러그인이 XML의 레이아웃 미리보기를 제공합니다. —
XML 파일이 열린 상태에서 레이아웃 탭을 선택하십시오.
-
또한,
-계층 뷰어 도구로
-레이아웃 디버깅도 시도해 보아야 합니다.—이것은 레이아웃 속성 값을 드러내고,
-내부 여백/여백 표시기가 있는 와이어프레임을 그리며 개발자가 에뮬레이터 또는 기기에서 디버깅하는 동안
+
또한,
+계층 뷰어 도구로
+레이아웃 디버깅도 시도해 보아야 합니다.—이것은 레이아웃 속성 값을 드러내고,
+내부 여백/여백 표시기가 있는 와이어프레임을 그리며 개발자가 에뮬레이터 또는 기기에서 디버깅하는 동안
완전히 렌더링된 보기를 제공합니다.
layoutopt 도구를
사용하면 레이아웃과 계층을 비효율성 또는 다른 문제에 대하여 재빨리 분석할 수 있게 해줍니다.
-
UI를 XML로 선언하는 것의 이점은 이렇게 하면 애플리케이션을 그 행동을 제어하는 코드로부터 따로 표시하기가 더 좋다는 것입니다. UI 설명은 애플리케이션 코드의 외부에 있습니다. 이는 다시 말해 소스 코드를 수정하고 다시 컴파일링하지 않아도 이를 수정 또는 변경할 수 있다는 뜻입니다. 예를 들어, 서로 다른 화면 방향, 사로 다른 기기 화면 크기 및 서로 다른 언어에 대해 XML 레이아웃을 생성할 수 있습니다. 이외에도 레이아웃을 XML로 선언하면 UI의 구조를 시각화하기가 더 쉬우므로 문제를 디버깅하기도 더 쉽습니다. 따라서, 이 문서는 레이아웃을 XML로 선언하는 방법을 가르치는 데 주안점을 두고 있습니다. 런타임에 보기 객체를 인스턴트화하는 것에 흥미가 있는 경우,
-{@link android.view.ViewGroup} 및
+
UI를 XML로 선언하는 것의 이점은 이렇게 하면 애플리케이션을 그 행동을 제어하는 코드로부터 따로 표시하기가 더 좋다는 것입니다. UI 설명은 애플리케이션 코드의 외부에 있습니다. 이는 다시 말해 소스 코드를 수정하고 다시 컴파일링하지 않아도 이를 수정 또는 변경할 수 있다는 뜻입니다. 예를 들어, 서로 다른 화면 방향, 사로 다른 기기 화면 크기 및 서로 다른 언어에 대해 XML 레이아웃을 생성할 수 있습니다. 이외에도 레이아웃을 XML로 선언하면 UI의 구조를 시각화하기가 더 쉬우므로 문제를 디버깅하기도 더 쉽습니다. 따라서, 이 문서는 레이아웃을 XML로 선언하는 방법을 가르치는 데 주안점을 두고 있습니다. 런타임에 보기 객체를 인스턴트화하는 것에 흥미가 있는 경우,
+{@link android.view.ViewGroup} 및
{@link android.view.View} 클래스 참조를 참조하십시오.
-
일반적으로 UI 요소를 선언하는 데 쓰이는 XML 어휘는 클래스와 메서드 명명을 충실히 따릅니다. 여기에서 요소 이름은 클래스 이름에 상응하며 속성 이름은 메서드에 상응합니다. 사실 이러한 일치성은 아주 직접적인 경우가 잦아 어느 XML 속성이 클래스 메서드에 상응하는지를 추측할 수 있고, 어느 클래스가 주어진 XML 요소에 상응하는지도 추측할 수 있습니다. 다만 모든 어휘가 다 같지는 않다는 점을 유의하십시오. 몇몇 경우에는 명명에 약간의 차이점이 있습니다. 예를 들어,
-EditText 요소에는 text 속성이 있으며 이는
+
일반적으로 UI 요소를 선언하는 데 쓰이는 XML 어휘는 클래스와 메서드 명명을 충실히 따릅니다. 여기에서 요소 이름은 클래스 이름에 상응하며 속성 이름은 메서드에 상응합니다. 사실 이러한 일치성은 아주 직접적인 경우가 잦아 어느 XML 속성이 클래스 메서드에 상응하는지를 추측할 수 있고, 어느 클래스가 주어진 XML 요소에 상응하는지도 추측할 수 있습니다. 다만 모든 어휘가 다 같지는 않다는 점을 유의하십시오. 몇몇 경우에는 명명에 약간의 차이점이 있습니다. 예를 들어,
+EditText 요소에는 text 속성이 있으며 이는
EditText.setText()에 상응합니다.
팁: 여러 가지 레이아웃 유형에 대해서는 보편적인
-레이아웃 객체를 참조하십시오. 여러 가지 레이아웃을 구축하는 데 대한 튜토리얼 모음도 있습니다.
+레이아웃 객체
를 참조하십시오. 여러 가지 레이아웃을 구축하는 데 대한 튜토리얼 모음도 있습니다.
Hello 보기 튜토리얼 가이드를 참조하십시오.
XML 쓰기
@@ -100,20 +100,20 @@ EditText 요소에는 text 속성이 있으며 이는
</LinearLayout>
-
레이아웃을 XML로 선언하고 나면 그 파일을 Android 프로젝트의 res/layout/ 디렉터리 내에
+
레이아웃을 XML로 선언하고 나면 그 파일을 Android 프로젝트의 res/layout/ 디렉터리 내에
.xml 확장자로 저장하여 적절하게 컴파일링되도록 합니다.
레이아웃 XML 파일의 구문에 대한 자세한 정보는 레이아웃 리소스 문서에서 확인할 수 있습니다.
XML 리소스 로딩
-
애플리케이션을 컴파일링하는 경우, 각 XML 레이아웃 파일이
-{@link android.view.View} 리소스 안에 컴파일링됩니다. 애플리케이션 코드로부터 가져온 레이아웃 리소스는
-{@link android.app.Activity#onCreate(android.os.Bundle) Activity.onCreate()} 콜백
+
애플리케이션을 컴파일링하는 경우, 각 XML 레이아웃 파일이
+{@link android.view.View} 리소스 안에 컴파일링됩니다. 애플리케이션 코드로부터 가져온 레이아웃 리소스는
+{@link android.app.Activity#onCreate(android.os.Bundle) Activity.onCreate()} 콜백
구현에 로딩해야 합니다.
-이렇게 하려면 {@link android.app.Activity#setContentView(int) setContentView()}를 호출한 다음, 이를
+이렇게 하려면 {@link android.app.Activity#setContentView(int) setContentView()}를 호출한 다음, 이를
R.layout.layout_file_name 형태로 레이아웃 리소스의 참조에 전달합니다.
- 예를 들어, XML 레이아웃이 main_layout.xml로 저장된 경우, 이것을 액티비티에 대해 로딩하려면
+ 예를 들어, XML 레이아웃이 main_layout.xml로 저장된 경우, 이것을 액티비티에 대해 로딩하려면
다음과 같이 하면 됩니다.
public void onCreate(Bundle savedInstanceState) {
@@ -122,8 +122,8 @@ public void onCreate(Bundle savedInstanceState) {
}
-
액티비티 내의 onCreate() 콜백 메서드는 액티비티가 시작될 때
-Android 프레임워크가 호출합니다(수명 주기에 대한 논의는
+
액티비티 내의 onCreate() 콜백 메서드는 액티비티가 시작될 때
+Android 프레임워크가 호출합니다(수명 주기에 대한 논의는
액티비티
문서에서 확인하십시오).
@@ -134,24 +134,24 @@ Android 프레임워크가 호출합니다(수명 주기에 대한 논의는
몇몇 속성은 보기 객체에만 특화되어 있지만(예를 들어, TextView는 textSize
속성을 지원), 이와 같은 속성은 이 클래스를 확장할 수 있는 모든 보기 객체가 상속하기도 합니다.
모든 보기 객체에 공통으로 쓰이는 것도 몇 가지 있습니다. 왜냐하면 이들은 루트 보기 클래스에서 상속된 것이기 때문입니다(예:
-id 속성). 그리고 나머지 속성은 "레이아웃 매개변수"로 간주됩니다.
-이들은 보기 객체의 특정한 레이아웃 방향을 설명하는 것으로, 이는 해당 객체의 상위 VeiwGroup 객체에서
+id 속성). 그리고 나머지 속성은 "레이아웃 매개변수"로 간주됩니다.
+이들은 보기 객체의 특정한 레이아웃 방향을 설명하는 것으로, 이는 해당 객체의 상위 VeiwGroup 객체에서
정의된 바에 따릅니다.
ID
모든 보기 객체에는 연관된 정수 ID가 있을 수 있습니다. 이는 트리 내에서 해당 보기를 고유하게 식별하기 위한 것입니다.
-애플리케이션이 컴파일링되면 이 ID가 정수로 참조되지만, ID는
-일반적으로 레이아웃 XML 파일에 문자열로 할당되며, id 속성으로 쓰입니다.
+애플리케이션이 컴파일링되면 이 ID가 정수로 참조되지만, ID는
+일반적으로 레이아웃 XML 파일에 문자열로 할당되며, id 속성으로 쓰입니다.
이것은 모든 보기 객체에 공통적인 XML 속성으로
({@link android.view.View} 클래스가 정의) 이것을 매우 자주 사용하게 됩니다.
ID에 대한, XML 태그 내에 있는 구문은 다음과 같습니다.
android:id="@+id/my_button"
-
문자열 시작 부분에 있는 앳 기호(@)는 XML 파서가 ID 문자열의 나머지를 구문 분석하고 확장하여
-ID 리소스로 식별해야 한다는 것을 나타냅니다. 더하기 기호(+)는 이것이 새 리소스 이름이며,
-이것을 반드시 생성하여 우리 리소스에 추가해야 한다는 것을 뜻합니다(R.java 파일에서). Android 프레임워크는 다른 ID 리소스도 아주 많이
-제공합니다. Android 리소스 ID를 참조할 때에는 더하기 기호는 필요하지 않지만
+
문자열 시작 부분에 있는 앳 기호(@)는 XML 파서가 ID 문자열의 나머지를 구문 분석하고 확장하여
+ID 리소스로 식별해야 한다는 것을 나타냅니다. 더하기 기호(+)는 이것이 새 리소스 이름이며,
+이것을 반드시 생성하여 우리 리소스에 추가해야 한다는 것을 뜻합니다(R.java 파일에서). Android 프레임워크는 다른 ID 리소스도 아주 많이
+제공합니다. Android 리소스 ID를 참조할 때에는 더하기 기호는 필요하지 않지만
android 패키지 네임스페이스를 다음과 같이 반드시 추가해야 합니다.
{@link android.widget.RelativeLayout}을 생성할 때에는 보기 객체의 ID를 정의하는 것이 중요합니다.
-관계 레이아웃에서는 형제 보기가 또 다른 형제 보기와 관련된 자신의 레이아웃을 정의할 수 있으며,
+
{@link android.widget.RelativeLayout}을 생성할 때에는 보기 객체의 ID를 정의하는 것이 중요합니다.
+관계 레이아웃에서는 형제 보기가 또 다른 형제 보기와 관련된 자신의 레이아웃을 정의할 수 있으며,
이를 고유한 ID로 참조하게 됩니다.
-
ID는 트리 전체를 통틀어 고유할 필요는 없지만, 트리에서 검색하고 있는 부분 내에서는
-고유해야 합니다(이것이 트리 전체인 경우가 잦으므로, 가급적이면 완전히
+
ID는 트리 전체를 통틀어 고유할 필요는 없지만, 트리에서 검색하고 있는 부분 내에서는
+고유해야 합니다(이것이 트리 전체인 경우가 잦으므로, 가급적이면 완전히
고유한 것을 쓰는 것이 가장 좋습니다).
레이아웃 매개변수
-
layout_something이라는 XML 레이아웃 속성이
+
layout_something이라는 XML 레이아웃 속성이
보기가 상주하는 ViewGroup에 대해 적절한 보기의 레이아웃 매개변수를 정의합니다.
모든 ViewGroup 클래스가 중첩된 클래스를 하나씩 구현하며 이것이 {@link
-android.view.ViewGroup.LayoutParams}를 확장합니다. 이 하위 클래스에는
-각 하위 보기의 크기와 위치를 보기 그룹에 적절한 방식으로 정의하는
-속성 유형이 들어 있습니다. 그림 1에서 볼 수 있듯이, 상위 보기 그룹이
+android.view.ViewGroup.LayoutParams}를 확장합니다. 이 하위 클래스에는
+각 하위 보기의 크기와 위치를 보기 그룹에 적절한 방식으로 정의하는
+속성 유형이 들어 있습니다. 그림 1에서 볼 수 있듯이, 상위 보기 그룹이
각 하위 보기의 레이아웃 매개변수를 정의합니다(하위 보기 그룹 포함).
-
그림 1. 각 보기와 연관된 레이아웃 매개변수가
+
그림 1. 각 보기와 연관된 레이아웃 매개변수가
있는 보기 계층을 시각화한 것입니다.
-
모든 LayoutParams 하위 클래스에는 설정 값에 대한 각기 자신만의 구문이 있다는 점을
-눈여겨 보십시오. 각 하위 요소는 자신의 상위에 적합한 LayoutParams를 정의해야 합니다.
+
모든 LayoutParams 하위 클래스에는 설정 값에 대한 각기 자신만의 구문이 있다는 점을
+눈여겨 보십시오. 각 하위 요소는 자신의 상위에 적합한 LayoutParams를 정의해야 합니다.
다만 이것은 자신의 하위에 대해 각기 다른 LayoutParams도 정의할 수 있습니다.
-
모든 보기 그룹에는 너비와 높이가 포함되며(layout_width 및
-layout_height), 각 보기는 이들을 반드시 정의해야 합니다. 선택 사항으로
+
모든 보기 그룹에는 너비와 높이가 포함되며(layout_width 및
+layout_height), 각 보기는 이들을 반드시 정의해야 합니다. 선택 사항으로
여백과 테두리도 포함하는 LayoutParams도 많습니다.
-
너비와 높이는 정확한 치수로 지정할 수 있습니다. 다만 이것은 자주 하지
-않는 것이 좋습니다. 그보다는 다음과 같은 상수 중 하나를 사용하여 너비 또는 높이를 설정하는 경우가
+
너비와 높이는 정확한 치수로 지정할 수 있습니다. 다만 이것은 자주 하지
+않는 것이 좋습니다. 그보다는 다음과 같은 상수 중 하나를 사용하여 너비 또는 높이를 설정하는 경우가
더 많습니다.
-
wrap_content 보기에 콘텐츠에 필요한 치수대로 알아서
+
wrap_content 보기에 콘텐츠에 필요한 치수대로 알아서
크기를 조정하라고 합니다.
match_parent (다른 이름은 fill_parent 로, API 레벨 8 이전에 해당)
보기에 상위 보기 그룹이 허용하는 한 최대한으로 커지라고 합니다.
-
일반적으로 픽셀과 같이 절대적인 단위를 사용하여 레이아웃 너비와 높이를 지정하는 것은
-권장하지 않습니다. 그 대신, 밀도 독립적인 픽셀 단위와 같이 상대적인 측정치를
+
일반적으로 픽셀과 같이 절대적인 단위를 사용하여 레이아웃 너비와 높이를 지정하는 것은
+권장하지 않습니다. 그 대신, 밀도 독립적인 픽셀 단위와 같이 상대적인 측정치를
사용하는 것(dp), wrap_content, 또는
-match_parent등이 더 낫습니다. 이렇게 하면
+match_parent등이 더 낫습니다. 이렇게 하면
애플리케이션이 다양한 기기 화면 크기에 걸쳐서도 적절하게 표시되도록 보장하는 데 도움이 되기 때문입니다.
-허용된 측정 유형은
+허용된 측정 유형은
사용 가능한 리소스에 정의되어 있습니다.
@@ -229,23 +229,23 @@ android.view.ViewGroup.LayoutParams}를 확장합니다. 이 하위 클래스에
레이아웃 위치
보기의 모양은 직사각형입니다. 보기에는 위치가 있으며, 이는
- 한 쌍의 왼쪽 및 상단 좌표, 그리고 두 개의 치수가 너비와 높이를 나타내는
+ 한 쌍의 왼쪽 및 상단 좌표, 그리고 두 개의 치수가 너비와 높이를 나타내는
형식으로 표현됩니다. 위치와 치수의 단위는 픽셀입니다.
- 보기의 위치를 검색할 수 있습니다.
-{@link android.view.View#getLeft()} 및 {@link android.view.View#getTop()} 메서드를 호출하면 됩니다. 전자는 보기를
-나타내는 직사각형의 왼쪽, 즉 X 좌표를 반환합니다. 후자는 보기를
-나타내는 직사각형의 상단, 즉 Y 좌표를 반환합니다. 이들 메서드는 둘 다
-보기의 위치를 해당 보기의 상위와 관련지어 반환합니다. 예를 들어,
-getLeft()가 20을 반환하는 경우 이는 해당 보기가 그 보기의 바로 상위의 왼쪽 가장자리에서
+ 보기의 위치를 검색할 수 있습니다.
+{@link android.view.View#getLeft()} 및 {@link android.view.View#getTop()} 메서드를 호출하면 됩니다. 전자는 보기를
+나타내는 직사각형의 왼쪽, 즉 X 좌표를 반환합니다. 후자는 보기를
+나타내는 직사각형의 상단, 즉 Y 좌표를 반환합니다. 이들 메서드는 둘 다
+보기의 위치를 해당 보기의 상위와 관련지어 반환합니다. 예를 들어,
+getLeft()가 20을 반환하는 경우 이는 해당 보기가 그 보기의 바로 상위의 왼쪽 가장자리에서
오른쪽으로 20픽셀 떨어진 곳에 있다는 뜻입니다.
- 이외에도 불필요한 계산을 피하기 위해 여러 가지 편의 메서드가 제공됩니다.
+ 이외에도 불필요한 계산을 피하기 위해 여러 가지 편의 메서드가 제공됩니다.
구체적으로 {@link android.view.View#getRight()} 및 {@link android.view.View#getBottom()}을 들 수 있습니다.
이들 메서드는 해당 보기를 나타내는 직사각형의 오른쪽과 하단 가장자리의 좌표를 반환합니다.
예를 들어 {@link android.view.View#getRight()}를
@@ -255,46 +255,46 @@ android.view.ViewGroup.LayoutParams}를 확장합니다. 이 하위 클래스에
크기, 안쪽 여백 및 여백
- 보기의 크기는 너비와 높이로 표현됩니다. 사실 하나의 보기는
+ 보기의 크기는 너비와 높이로 표현됩니다. 사실 하나의 보기는
두 쌍의 너비 및 높이 값을 소유합니다.
- 첫 번째 쌍을 측정된 너비 및
-측정된 높이라고 합니다. 이들 치수는 보기가
-상위 내에서 얼마나 커지고자 하는지를 정의합니다. 측정된
+ 첫 번째 쌍을 측정된 너비 및
+측정된 높이라고 합니다. 이들 치수는 보기가
+상위 내에서 얼마나 커지고자 하는지를 정의합니다. 측정된
치수를 가져오려면 {@link android.view.View#getMeasuredWidth()}
및 {@link android.view.View#getMeasuredHeight()}를 호출하면 됩니다.
- 두 번째 쌍은 단순히 너비 및 높이라고 일컬으며,
-때로는 그리기 너비 및 그리기 높이로 부를 때도 있습니다. 이러한
-치수는 그리기 시간 및 레이아웃 후에 보기가 화면에 표시되는 실제 크기를
-정의합니다. 이들 값은 측정된 너비 및 높이와 달라도 되지만
-꼭 달라야 하는 것은 아닙니다. 너비와 높이를 가져오려면
+ 두 번째 쌍은 단순히 너비 및 높이라고 일컬으며,
+때로는 그리기 너비 및 그리기 높이로 부를 때도 있습니다. 이러한
+치수는 그리기 시간 및 레이아웃 후에 보기가 화면에 표시되는 실제 크기를
+정의합니다. 이들 값은 측정된 너비 및 높이와 달라도 되지만
+꼭 달라야 하는 것은 아닙니다. 너비와 높이를 가져오려면
{@link android.view.View#getWidth()} 및 {@link android.view.View#getHeight()}를 호출하면 됩니다.
- 보기의 치수를 측정하려면 보기는 자신의 안쪽 여백을 감안합니다. 안쪽 여백은
+ 보기의 치수를 측정하려면 보기는 자신의 안쪽 여백을 감안합니다. 안쪽 여백은
보기의 왼쪽, 상단, 오른쪽 및 하단 부분에 대해 픽셀로 표시됩니다.
- 안쪽 여백은 정해진 픽셀 수를 사용하여 보기의 콘텐츠를 오프셋하는 데 쓰일 수도
-있습니다. 예를 들어 왼쪽 안쪽 여백을 2로 설정하면 해당 보기의 콘텐츠를 왼쪽 가장자리에서
-오른쪽으로 2픽셀 밀어냅니다. 안쪽 여백을 설정할 때에는
-{@link android.view.View#setPadding(int, int, int, int)} 메서드를 사용하면 되고, 이를 쿼리하려면
-{@link android.view.View#getPaddingLeft()}, {@link android.view.View#getPaddingTop()},
+ 안쪽 여백은 정해진 픽셀 수를 사용하여 보기의 콘텐츠를 오프셋하는 데 쓰일 수도
+있습니다. 예를 들어 왼쪽 안쪽 여백을 2로 설정하면 해당 보기의 콘텐츠를 왼쪽 가장자리에서
+오른쪽으로 2픽셀 밀어냅니다. 안쪽 여백을 설정할 때에는
+{@link android.view.View#setPadding(int, int, int, int)} 메서드를 사용하면 되고, 이를 쿼리하려면
+{@link android.view.View#getPaddingLeft()}, {@link android.view.View#getPaddingTop()},
{@link android.view.View#getPaddingRight()} 및 {@link android.view.View#getPaddingBottom()}을 사용하면 됩니다.
- 보기가 안쪽 여백을 정의할 수는 있지만, 여백에 대한 지원은 전혀 제공하지
-않습니다. 다만 보기 그룹이 그와 같은 지원을 제공합니다. 자세한 정보는
-{@link android.view.ViewGroup} 및
+ 보기가 안쪽 여백을 정의할 수는 있지만, 여백에 대한 지원은 전혀 제공하지
+않습니다. 다만 보기 그룹이 그와 같은 지원을 제공합니다. 자세한 정보는
+{@link android.view.ViewGroup} 및
{@link android.view.ViewGroup.MarginLayoutParams}를 참조하십시오.
{@link android.view.ViewGroup} 클래스의 각 하위 클래스는 각기 고유한 방식으로 자신 안에
-중첩한 보기를 표시합니다. 아래는 Android 플랫폼에서 기본 제공되는, 보다 보편적인 레이아웃 유형을
+
{@link android.view.ViewGroup} 클래스의 각 하위 클래스는 각기 고유한 방식으로 자신 안에
+중첩한 보기를 표시합니다. 아래는 Android 플랫폼에서 기본 제공되는, 보다 보편적인 레이아웃 유형을
몇 가지 나타낸 것입니다.
-
참고: 하나 이상의 레이아웃을 또 다른 레이아웃에 중첩하여
-UI 디자인을 이룰 수도 있지만, 레이아웃 계층을 가능한 한 얕게 유지하도록
-애써야 합니다. 중첩된 레이아웃이 적을수록 레이아웃이 더욱 빠르게 그려집니다(가로로 넓은 보기 계층이
+
참고: 하나 이상의 레이아웃을 또 다른 레이아웃에 중첩하여
+UI 디자인을 이룰 수도 있지만, 레이아웃 계층을 가능한 한 얕게 유지하도록
+애써야 합니다. 중첩된 레이아웃이 적을수록 레이아웃이 더욱 빠르게 그려집니다(가로로 넓은 보기 계층이
깊은 보기 계층보다 낫습니다).
알림 우선 순위
- 원한다면, 알림에 우선 순위를 설정할 수 있습니다. 우선 순위는
+ 원한다면, 알림에 우선 순위를 설정할 수 있습니다. 우선 순위는
기기 UI에 알림 표시 방식을 암시하는 역할을 합니다.
알림 우선 순위를 설정하려면, {@link
android.support.v4.app.NotificationCompat.Builder#setPriority(int)
NotificationCompat.Builder.setPriority()}를 호출하고 {@link
-android.support.v4.app.NotificationCompat} 우선 순위 상수 중 하나에 전달합니다.
+android.support.v4.app.NotificationCompat} 우선 순위 상수 중 하나에 전달합니다.
우선 순위 수준은 {@link
android.support.v4.app.NotificationCompat#PRIORITY_MIN}(-2)에서 {@link
android.support.v4.app.NotificationCompat#PRIORITY_MAX}(2)까지 다섯 개가 있습니다. 별도의 설정이 없을 경우,
@@ -185,10 +185,10 @@ android.support.v4.app.NotificationCompat#PRIORITY_DEFAULT}(0)으로 설정됩
단순 알림 만들기
- 다음 조각은 사용자가 알림을 클릭하면 알리는
+ 다음 조각은 사용자가 알림을 클릭하면 알리는
액티비티를 지정하는 단순한 알림을 나타냅니다. 이 코드는
-{@link android.support.v4.app.TaskStackBuilder} 객체를 생성하고 이를 사용하여
-해당 작업의 {@link android.app.PendingIntent}를 생성합니다. 이 패턴은
+{@link android.support.v4.app.TaskStackBuilder} 객체를 생성하고 이를 사용하여
+해당 작업의 {@link android.app.PendingIntent}를 생성합니다. 이 패턴은
액티비티를 시작할 때 탐색 보존 섹션에서 자세히 설명합니다.
- 확장된 보기에 알림을 나타나게 하려면,
+ 확장된 보기에 알림을 나타나게 하려면,
먼저 원하는 일반 보기 옵션으로 {@link android.support.v4.app.NotificationCompat.Builder} 객체를
생성합니다. 다음에는 확장된 레이아웃 객체의 인수로 {@link android.support.v4.app.NotificationCompat.Builder#setStyle
Builder.setStyle()}을 호출합니다.
- 확장 알림은 Android 4.1 이전 플랫폼에서 사용할 수 없다는 것을 명심하십시오.
+ 확장 알림은 Android 4.1 이전 플랫폼에서 사용할 수 없다는 것을 명심하십시오.
Android 4.1 이하 플랫폼에서 알림을 처리하는 방법은
처리 호환성 섹션을 참조하십시오.
-
+
알림 기능을 설정하는 메서드가
지원 라이브러리 클래스 {@link android.support.v4.app.NotificationCompat.Builder NotificationCompat.Builder}에 있더라도 모든 알림 기능을 특정 버전에서 사용할 수 있는 것은 아닙니다.
예를 들어, 확장 알림에 따라 달라지는 작업 버튼은 Android
@@ -294,13 +294,13 @@ NotificationCompat.Builder}를 이용해서 알림을 생성합니다. 또한,
사용자가 알림을 클릭하면 알림을 시작시키는 방식으로 모든 사용자에게 {@link android.app.Activity}에서 알림 기능을
사용할 수 있게 합니다. 이를 위해,
-{@link android.app.Activity}를 위한 {@link android.app.PendingIntent}를 생성합니다.
+{@link android.app.Activity}를 위한 {@link android.app.PendingIntent}를 생성합니다.
{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent
setContentIntent()}를 호출하여 알림에 {@link android.app.PendingIntent}를 추가합니다.
이제 알림에서 사용하고자 하는 확장 알림 기능을 추가합니다. 또한, 사용자가 알림을 클릭하면 시작되는
-{@link android.app.Activity}에서 개발자가 추가한 모든 기능을
+{@link android.app.Activity}에서 개발자가 추가한 모든 기능을
사용할 수 있어야 합니다.
- 같은 유형의 이벤트에서 알림을 여러 번 발행해야 할 경우,
+ 같은 유형의 이벤트에서 알림을 여러 번 발행해야 할 경우,
완전히 새로운 알림을 만드는 것은 삼가야 합니다. 대신, 일부 값을 변경하거나 추가하거나, 두 가지 조치를 모두 취하여
이전 알림을 업데이트하는 것이 좋습니다.
예를 들어, Gmail은 읽지 않은 메시지 개수를 올리고 각 이메일의 요약을 알림에 추가하여
-새 이메일 도착을 알립니다. 이것을 일명
-알림을 "쌓는다"고 하며, 이는
+새 이메일 도착을 알립니다. 이것을 일명
+알림을 "쌓는다"고 하며, 이는
알림 디자인 가이드에 자세히 설명되어 있습니다.
- 참고: 이 Gmail 기능에는 "받은편지함" 확장 레이아웃이 필요한데,
+ 참고: 이 Gmail 기능에는 "받은편지함" 확장 레이아웃이 필요한데,
이것은 Android 4.1부터 이용할 수 있는 확장 알림 기능의 일부입니다.
알림이 업데이트되도록 설정하려면,
{@link android.app.NotificationManager#notify(int, android.app.Notification) NotificationManager.notify()}를 호출하여 알림 ID와 함께 발행합니다.
- 알림을 발행한 후에 업데이트하려면,
-{@link android.support.v4.app.NotificationCompat.Builder} 객체를 업데이트하거나 생성하고,
-{@link android.app.Notification} 객체를 구축하고,
-이전에 사용한 것과 같은 ID로 {@link android.app.Notification}을 발행합니다. 이전 알림이
+ 알림을 발행한 후에 업데이트하려면,
+{@link android.support.v4.app.NotificationCompat.Builder} 객체를 업데이트하거나 생성하고,
+{@link android.app.Notification} 객체를 구축하고,
+이전에 사용한 것과 같은 ID로 {@link android.app.Notification}을 발행합니다. 이전 알림이
여전히 표시되는 경우, 시스템은
-{@link android.app.Notification} 객체의 콘텐츠에서 알림을 업데이트합니다. 이전 알림을 무시할 경우,
+{@link android.app.Notification} 객체의 콘텐츠에서 알림을 업데이트합니다. 이전 알림을 무시할 경우,
대신 새로운 알림이 생성됩니다.
- 다음 코드 조각은 발생한 이벤트 개수를 반영하여
+ 다음 코드 조각은 발생한 이벤트 개수를 반영하여
업데이트된 알림을 나타낸 것입니다. 이것은 알림을 쌓아 요약을 표시합니다.
@@ -385,7 +385,7 @@ numMessages = 0;
이 메서드도 현재 진행 중인 알림을 삭제합니다.
- {@link android.app.NotificationManager#cancelAll() cancelAll()}을 호출합니다.
+ {@link android.app.NotificationManager#cancelAll() cancelAll()}을 호출합니다.
이것은 이전에 발행한 알림을 모두 제거합니다.
@@ -393,9 +393,9 @@ numMessages = 0;
액티비티를 시작할 때 탐색 보존
- 알림에서 {@link android.app.Activity}를 시작할 때는 사용자의 예상 탐색 경험을
-보존해야 합니다. '뒤로'를 클릭하면 사용자를 애플리케이션의 정상 작업 흐름을 거쳐 메인 스크린으로 보내고,
- '최근'을 클릭하면
+ 알림에서 {@link android.app.Activity}를 시작할 때는 사용자의 예상 탐색 경험을
+보존해야 합니다. '뒤로'를 클릭하면 사용자를 애플리케이션의 정상 작업 흐름을 거쳐 메인 스크린으로 보내고,
+ '최근'을 클릭하면
{@link android.app.Activity}를 별개의 작업으로 표시합니다. 탐색 경험을 보존하려면
새 작업에서 {@link android.app.Activity}를 시작해야 합니다. 새로운 작업을 부여하기 위한
{@link android.app.PendingIntent} 설정 방법은 시작하는
@@ -406,19 +406,19 @@ numMessages = 0;
정규 액티비티
- 애플리케이션의 정상적 작업 흐름의 일부인 {@link android.app.Activity}를
+ 애플리케이션의 정상적 작업 흐름의 일부인 {@link android.app.Activity}를
시작합니다. 이 상황에서 {@link android.app.PendingIntent}를 설정하여
새 작업을 시작하고 애플리케이션의
정상적인 '뒤로' 동작을 재현하는 백 스택으로 {@link android.app.PendingIntent}를 제공합니다.
- Gmail 앱에서 보낸 알림이 이것을 잘 보여줍니다. 하나의 이메일 메시지에 대한
-알림을 클릭하면 메시지 자체를 보게 됩니다. 뒤로를 터치하면
+ Gmail 앱에서 보낸 알림이 이것을 잘 보여줍니다. 하나의 이메일 메시지에 대한
+알림을 클릭하면 메시지 자체를 보게 됩니다. 뒤로를 터치하면
알림에서 들어간 것이 아니라 메인 스크린에서
Gmail에 들어간 것처럼 Gmail을 통해 메인 스크린으로 돌아갑니다.
- 이것은 알림을 터치하기만 하면 어느 애플리케이션에 있든 관계 없이 발생하는
-일입니다. 예를 들어, Gmail에서 메시지를 작성하다가
+ 이것은 알림을 터치하기만 하면 어느 애플리케이션에 있든 관계 없이 발생하는
+일입니다. 예를 들어, Gmail에서 메시지를 작성하다가
한 이메일에 대한 알림을 클릭하면 해당 이메일로 바로 이동합니다. 뒤로
를 터치하면
작성 중인 메시지가 아니라 받은편지함과 메인 스크린으로 돌아갑니다.
@@ -429,18 +429,18 @@ Gmail에 들어간 것처럼 Gmail을 통해 메인 스크린으로 돌아갑니
{@link android.app.Activity}가 알림에서 시작될 경우 사용자에게는 이것만 보입니다.
- {@link android.app.Activity}는 알림 자체에서 표시하기 어려운 정보를 제공하므로
-어떤 면에서는 알림을 확장하는 셈입니다. 이 상황에서는,
-{@link android.app.PendingIntent}를 설정하고 새로운 작업에서 시작합니다.
-시작된 {@link android.app.Activity}는
-애플리케이션 액티비티 흐름의 일부가 아니므로 백 스택을 생성하지 않아도 됩니다. 뒤로를 클릭하면 사용자는 여전히
+ {@link android.app.Activity}는 알림 자체에서 표시하기 어려운 정보를 제공하므로
+어떤 면에서는 알림을 확장하는 셈입니다. 이 상황에서는,
+{@link android.app.PendingIntent}를 설정하고 새로운 작업에서 시작합니다.
+시작된 {@link android.app.Activity}는
+애플리케이션 액티비티 흐름의 일부가 아니므로 백 스택을 생성하지 않아도 됩니다. 뒤로를 클릭하면 사용자는 여전히
메인 스크린으로 돌아갑니다.
정규 액티비티 PendingIntent 설정
- 직접 진입
+ 직접 진입
{@link android.app.Activity}를 시작하는 {@link android.app.PendingIntent}를 설정하려면 다음과 같은 단계를 따르십시오.
@@ -448,7 +448,7 @@ Gmail에 들어간 것처럼 Gmail을 통해 메인 스크린으로 돌아갑니
매니페스트에서 애플리케이션의 {@link android.app.Activity} 계층을 정의합니다.
- Android 4.0.3 이전에 대한 지원을 추가합니다. 이렇게 하려면
+ Android 4.0.3 이전에 대한 지원을 추가합니다. 이렇게 하려면
<meta-data>
요소를
@@ -506,39 +506,39 @@ Gmail에 들어간 것처럼 Gmail을 통해 메인 스크린으로 돌아갑니
TaskStackBuilder.create()}를 호출하여 스택 빌더를 생성합니다.
-
+
{@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()}을 호출하여 스택 빌더를 백 스택에 추가합니다.
매니페스트에서 정의한 계층의 각 {@link android.app.Activity}의 경우,
백 스택에
-{@link android.app.Activity}를 시작하는 {@link android.content.Intent} 객체가 포함됩니다. 이 메서드는 새로운 작업에서
+{@link android.app.Activity}를 시작하는 {@link android.content.Intent} 객체가 포함됩니다. 이 메서드는 새로운 작업에서
스택을 시작하는 플래그도 추가합니다.
- 참고:
+ 참고:
{@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()}에 대한 인수가
-시작된 {@link android.app.Activity}의 참조이기는 하지만, 이 메서드 호출은
+시작된 {@link android.app.Activity}의 참조이기는 하지만, 이 메서드 호출은
{@link android.app.Activity}를 시작하는 {@link android.content.Intent}를 추가하지 않습니다. 대신, 그 부분은 다음 단계에서 해결합니다.
-
-{@link android.support.v4.app.TaskStackBuilder#addNextIntent addNextIntent()}를 호출하여 {@link android.app.Activity}를 시작하는 {@link android.content.Intent}를
+
+{@link android.support.v4.app.TaskStackBuilder#addNextIntent addNextIntent()}를 호출하여 {@link android.app.Activity}를 시작하는 {@link android.content.Intent}를
추가합니다.
첫 번째 단계에서 생성한 {@link android.content.Intent}를
{@link android.support.v4.app.TaskStackBuilder#addNextIntent addNextIntent()}에 대한 인수로 전달합니다.
- 필요할 경우
+ 필요할 경우
{@link android.support.v4.app.TaskStackBuilder#editIntentAt
TaskStackBuilder.editIntentAt()}을 호출하여 스택에서{@link android.content.Intent} 객체에 대한 인수를 추가합니다. 이것은 사용자가
'뒤로'를 사용하여 탐색할 때 대상{@link android.app.Activity}가 의미 있는 데이터를 표시하도록 보장하기 위해 때때로 필요한 절차입니다.
- 이 백 스택에 대한 {@link android.app.PendingIntent}를 가져옵니다. 이때
+ 이 백 스택에 대한 {@link android.app.PendingIntent}를 가져옵니다. 이때
{@link android.support.v4.app.TaskStackBuilder#getPendingIntent getPendingIntent()}를 호출하는 방법을 씁니다.
- 그러면 이 {@link android.app.PendingIntent}를
+ 그러면 이 {@link android.app.PendingIntent}를
{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent
setContentIntent()}에 대한 인수로 사용할 수 있습니다.
- 다음 섹션에서는 특수 액티비티
+ 다음 섹션에서는 특수 액티비티
{@link android.app.PendingIntent}를 설정하는 법을 설명합니다.
- 특수 {@link android.app.Activity}에는 백 스택이 필요하지 않습니다. 따라서 매니페스트에서 이것의
-{@link android.app.Activity} 계층을 정의하지 않아도 되고,
-백 스택을 구축하기 위해
-{@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()}을
-호출하지 않아도 됩니다. 대신 매니페스트를 사용하여 {@link android.app.Activity} 작업 옵션을 설정하고,
-{@link android.app.PendingIntent}를 생성하십시오. 이때
+ 특수 {@link android.app.Activity}에는 백 스택이 필요하지 않습니다. 따라서 매니페스트에서 이것의
+{@link android.app.Activity} 계층을 정의하지 않아도 되고,
+백 스택을 구축하기 위해
+{@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()}을
+호출하지 않아도 됩니다. 대신 매니페스트를 사용하여 {@link android.app.Activity} 작업 옵션을 설정하고,
+{@link android.app.PendingIntent}를 생성하십시오. 이때
{@link android.app.PendingIntent#getActivity getActivity()}를 호출하는 방법을 씁니다.
- 매니페스트에서 다음 속성을 {@link android.app.Activity}에 대한
+ 매니페스트에서 다음 속성을 {@link android.app.Activity}에 대한
<activity>
요소에 추가합니다.
- 이것은 개발자가 코드에서 설정하는
-{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK} 플래그와 더불어
-이 {@link android.app.Activity}가
-애플리케이션의 기본 작업으로 들어가지 않게 보장합니다. 애플리케이션의 기본 유사성을
+ 이것은 개발자가 코드에서 설정하는
+{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK} 플래그와 더불어
+이 {@link android.app.Activity}가
+애플리케이션의 기본 작업으로 들어가지 않게 보장합니다. 애플리케이션의 기본 유사성을
가지고 있는 기존 작업은 모두 영향을 받지 않습니다.
@@ -629,23 +629,23 @@ mNotificationManager.notify(id, builder.build());
알림을 구축 및 발행합니다.
-
+
{@link android.app.Activity}를 시작하는 {@link android.content.Intent}를 생성합니다.
- {@link android.app.Activity}가 새로운, 빈 작업에서 시작되도록 설정합니다. 이때
-{@link android.content.Intent#setFlags setFlags()}를
+ {@link android.app.Activity}가 새로운, 빈 작업에서 시작되도록 설정합니다. 이때
+{@link android.content.Intent#setFlags setFlags()}를
{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK}
- 및
+ 및
{@link android.content.Intent#FLAG_ACTIVITY_CLEAR_TASK FLAG_ACTIVITY_CLEAR_TASK} 플래그와 함께 호출하면 됩니다.
{@link android.content.Intent}에 필요한 다른 모든 옵션을 설정합니다.
- {@link android.app.PendingIntent}를 {@link android.content.Intent}로부터
+ {@link android.app.PendingIntent}를 {@link android.content.Intent}로부터
생성합니다. 이때 {@link android.app.PendingIntent#getActivity getActivity()}를 호출하면 됩니다.
- 그러면 이 {@link android.app.PendingIntent}를
+ 그러면 이 {@link android.app.PendingIntent}를
{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent
setContentIntent()}에 대한 인수로 사용할 수 있습니다.
- 알림에는 사용자에게 진행 중인 작업의 상태를 보여주는
-애니메이션 진행 표시기를 포함할 수 있습니다. 작업이 얼마나 걸릴지, 주어진 시점에 어느 정도 완료되었는지를 추정할 수 있는 경우
-표시기의 "확정적" 형태(진행률 표시줄)를
-사용하십시오. 작업의 길이를 추정할 수 없으면, 표시기의
+ 알림에는 사용자에게 진행 중인 작업의 상태를 보여주는
+애니메이션 진행 표시기를 포함할 수 있습니다. 작업이 얼마나 걸릴지, 주어진 시점에 어느 정도 완료되었는지를 추정할 수 있는 경우
+표시기의 "확정적" 형태(진행률 표시줄)를
+사용하십시오. 작업의 길이를 추정할 수 없으면, 표시기의
"비확정적" 형태(액티비티 표시기)를 사용하십시오.
- 진행 상태 표시기는
+ 진행 상태 표시기는
{@link android.widget.ProgressBar} 클래스의 플랫폼 구현으로 표시됩니다.
- Android 4.0부터 시작되는 플랫폼에서 진행 상태 표시기를 사용하려면,
-{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}를 호출하십시오. 이전
-버전의 경우, 개발자 나름의 사용자 지정 알림 레이아웃을 생성해야 하며 여기에
+ Android 4.0부터 시작되는 플랫폼에서 진행 상태 표시기를 사용하려면,
+{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}를 호출하십시오. 이전
+버전의 경우, 개발자 나름의 사용자 지정 알림 레이아웃을 생성해야 하며 여기에
{@link android.widget.ProgressBar} 보기가 포함되어 있어야 합니다.
- 다음 섹션은
+ 다음 섹션은
{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}를 사용하여 알림의 진행 상태를 표시하는 법을 설명합니다.
확정적인 진행률 표시줄을 표시하려면
{@link android.support.v4.app.NotificationCompat.Builder#setProgress
-setProgress(max, progress, false)}를 호출하여 표시줄을 알림에 추가하고, 그 다음에 알림을 발행합니다. 작업이 진행되는 동안
-progress를 증가시키고 알림을 업데이트합니다. 작업이 끝날 무렵
-progress가 max와 같아야 합니다.
+setProgress(max, progress, false)}를 호출하여 표시줄을 알림에 추가하고, 그 다음에 알림을 발행합니다. 작업이 진행되는 동안
+progress를 증가시키고 알림을 업데이트합니다. 작업이 끝날 무렵
+progress가 max와 같아야 합니다.
{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}를 호출하는 보편적인 방법은
max를 100에 설정하고 작업에 대한 "완료 비율" 값에 따라 progress를
증가시키는 것입니다.
- 작업이 완료되면 진행률 표시줄이 표시되는 상태로 둘 수도 있고, 제거할 수도 있습니다. 어느 경우를 택하더라도
+ 작업이 완료되면 진행률 표시줄이 표시되는 상태로 둘 수도 있고, 제거할 수도 있습니다. 어느 경우를 택하더라도
알림 텍스트를 업데이트하여 작업이 완료되었다고 표시하는 것을 잊지 마십시오.
진행률 표시줄을 제거하려면,
{@link android.support.v4.app.NotificationCompat.Builder#setProgress
@@ -773,15 +773,15 @@ new Thread(
비확정적 액티비티 표시기를 표시하려면,
{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress(0, 0, true)}으로 알림에 표시기를 추가하고(처음의 인수 두 개는 무시합니다)
-, 알림을 발행합니다. 그 결과로
+, 알림을 발행합니다. 그 결과로
진행률 표시줄과 같은 스타일의 표시기가 나타납니다. 다만 이것은 애니메이션이 계속 진행 중입니다.
- 작업을 시작할 때 알림을 발행합니다. 애니메이션은
-알림을 수정할 때까지 실행됩니다. 작업이 완료되면,
+ 작업을 시작할 때 알림을 발행합니다. 애니메이션은
+알림을 수정할 때까지 실행됩니다. 작업이 완료되면,
{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress(0, 0, false)}를 호출하고
알림을 업데이트하여 액티비티 표시기를 제거합니다.
- 이 작업은 항상 해야 합니다. 하지 않으면, 작업이 완료되더라도 애니메이션이 계속 실행됩니다. 또한,
+ 이 작업은 항상 해야 합니다. 하지 않으면, 작업이 완료되더라도 애니메이션이 계속 실행됩니다. 또한,
알림 텍스트를 변경하여 작업이 완료되었음을 나타내는 것을 잊지 마십시오.
{@link android.support.v4.app.NotificationCompat.Builder#setCategory(java.lang.String) setCategory()}는
기기가 우선 순위 모드일 때 앱 알림을 처리하는 방법을 시스템에 전달합니다
(예를 들어, 알림이 수신 전화나 채팅 메시지, 알람 등을 나타낼 경우).
-
{@link android.support.v4.app.NotificationCompat.Builder#setPriority(int) setPriority()}는
-우선 순위 필드가 포함된 알림을 {@code PRIORITY_MAX} 또는 {@code PRIORITY_HIGH}로 설정하고,
+
{@link android.support.v4.app.NotificationCompat.Builder#setPriority(int) setPriority()}는
+우선 순위 필드가 포함된 알림을 {@code PRIORITY_MAX} 또는 {@code PRIORITY_HIGH}로 설정하고,
알림에 소리나 진동이 포함되어 있을 경우 작은 부동 창에 나타나게 합니다.
-
{@link android.support.v4.app.NotificationCompat.Builder#addPerson(java.lang.String) addPerson()}을
-사용하면 알림에 사람 목록을 추가할 수 있게 해줍니다. 개발자의 앱은 이 신호를 사용하여
-시스템에 지정된 사람들로부터 받은 알림을 함께 그룹화해야 한다고 알리거나, 이런 사람들로부터 받은 알림을
+
{@link android.support.v4.app.NotificationCompat.Builder#addPerson(java.lang.String) addPerson()}을
+사용하면 알림에 사람 목록을 추가할 수 있게 해줍니다. 개발자의 앱은 이 신호를 사용하여
+시스템에 지정된 사람들로부터 받은 알림을 함께 그룹화해야 한다고 알리거나, 이런 사람들로부터 받은 알림을
더욱 중요한 것으로 순위를 높일 수 있습니다.
Android 5.0(API 레벨 21)에서는 알림을 작은 부동 창에 나타낼 수 있습니다
-(다른 말로 헤드업 알림이라고 부릅니다). 이것은 기기가 활성 상태일 때(즉,
-기기가 잠금 해제 상태이며 화면에 켜져 있는 경우) 해당됩니다. 이와 같은 알림은
-외견상 일반적인 알림의 소형 형태와 비슷해 보이지만,
-해드업 알림에서는 작업 버튼도 표시한다는 점이 다릅니다. 사용자는 현재 앱을 떠나지 않고도
+(다른 말로 헤드업 알림이라고 부릅니다). 이것은 기기가 활성 상태일 때(즉,
+기기가 잠금 해제 상태이며 화면에 켜져 있는 경우) 해당됩니다. 이와 같은 알림은
+외견상 일반적인 알림의 소형 형태와 비슷해 보이지만,
+해드업 알림에서는 작업 버튼도 표시한다는 점이 다릅니다. 사용자는 현재 앱을 떠나지 않고도
헤드업 알림에 조치를 취하거나 이를 무시할 수 있습니다.
사용자 액티비티가 전체 화면 모드이거나(앱이
{@link android.app.Notification#fullScreenIntent}를 사용할 경우)
-
알림의 우선 순위가 높고
+
알림의 우선 순위가 높고
벨소리나 진동을 사용할 경우
잠금 화면 알림
-
Android 5.0 (API 레벨 21) 릴리스부터 알림이 잠금 화면에도
-나타날 수 있게 되었습니다. 앱은 이 기능을 사용하면 미디어 재생 제어와 다른 보편적인 작업을
-제공할 수 있습니다. 사용자는 설정을 통해 잠금 화면에 알림 표시 여부를 선택할 수 있고,
+
Android 5.0 (API 레벨 21) 릴리스부터 알림이 잠금 화면에도
+나타날 수 있게 되었습니다. 앱은 이 기능을 사용하면 미디어 재생 제어와 다른 보편적인 작업을
+제공할 수 있습니다. 사용자는 설정을 통해 잠금 화면에 알림 표시 여부를 선택할 수 있고,
개발자는 앱의 알림이 잠금 화면에 표시될지 여부를 지정할 수 있습니다.
가시성 설정
-
보안 잠금 화면에 알림이 얼마나 상세하게 표시될 것인지 그 수준을 앱이 제어할 수
-있습니다. {@link android.support.v4.app.NotificationCompat.Builder#setVisibility(int) setVisibility()}를 호출하고
+
보안 잠금 화면에 알림이 얼마나 상세하게 표시될 것인지 그 수준을 앱이 제어할 수
+있습니다. {@link android.support.v4.app.NotificationCompat.Builder#setVisibility(int) setVisibility()}를 호출하고
다음 값 중 하나를 지정합니다.
{@link android.support.v4.app.NotificationCompat#VISIBILITY_PRIVATE}은
알림 아이콘과 콘텐츠 제목 등의 기본 정보는 표시하지만 알림의 전체 콘텐츠는 숨깁니다.
{@link android.support.v4.app.NotificationCompat#VISIBILITY_PRIVATE}으로 설정하면 ,
-알림 콘텐츠의 대체 버전을 제공할 수도 있습니다. 이렇게 하면 특정 세부 사항만 숨깁니다. 예를 들어,
-SMS 앱에서 3개의 새 문자 메시지가 있습니다.라고 표시하면서도
-문자 메시지의 내용과 발신자는 숨길 수 있습니다. 이 대체 알림을 제공하려면, 우선 대체 알림을 생성합니다. 이때
-{@link android.support.v4.app.NotificationCompat.Builder}를 사용합니다. 비공개 알림 객체를
-생성하는 경우, 대체 알림을 이에 첨부할 때
+알림 콘텐츠의 대체 버전을 제공할 수도 있습니다. 이렇게 하면 특정 세부 사항만 숨깁니다. 예를 들어,
+SMS 앱에서 3개의 새 문자 메시지가 있습니다.라고 표시하면서도
+문자 메시지의 내용과 발신자는 숨길 수 있습니다. 이 대체 알림을 제공하려면, 우선 대체 알림을 생성합니다. 이때
+{@link android.support.v4.app.NotificationCompat.Builder}를 사용합니다. 비공개 알림 객체를
+생성하는 경우, 대체 알림을 이에 첨부할 때
{@link android.support.v4.app.NotificationCompat.Builder#setPublicVersion(android.app.Notification) setPublicVersion()}
메서드를 통합니다.
잠금 화면에서 미디어 재생 제어
-
Android 5.0(API 레벨 21)의 잠금 화면에서는 더 이상
-{@link android.media.RemoteControlClient}를 기반으로 한 미디어 제어를 표시하지 않습니다. 이는 사용되지 않고 있기 때문입니다. 대신,
-{@link android.app.Notification.MediaStyle} 템플릿을
+
Android 5.0(API 레벨 21)의 잠금 화면에서는 더 이상
+{@link android.media.RemoteControlClient}를 기반으로 한 미디어 제어를 표시하지 않습니다. 이는 사용되지 않고 있기 때문입니다. 대신,
+{@link android.app.Notification.MediaStyle} 템플릿을
{@link android.app.Notification.Builder#addAction(android.app.Notification.Action) addAction()}
메서드와 함께 사용하십시오. 이 메서드는 작업을 클릭할 수 있는 아이콘으로 변환해줍니다.
-
참고: 이 템플릿과 {@link android.app.Notification.Builder#addAction(android.app.Notification.Action) addAction()}
-메서드는 지원 라이브러리에 포함되어 있지 않으므로 이 기능은 Android 5.0 이상에서만
+
참고: 이 템플릿과 {@link android.app.Notification.Builder#addAction(android.app.Notification.Action) addAction()}
+메서드는 지원 라이브러리에 포함되어 있지 않으므로 이 기능은 Android 5.0 이상에서만
실행됩니다.
-
Android 5.0의 잠금 화면에서 미디어 재생 제어를 표시하려면,
-위에 설명한 바와 같이 가시성을 {@link android.support.v4.app.NotificationCompat#VISIBILITY_PUBLIC}으로 설정합니다. 그런 다음 다음 샘플 코드에서 설명한 바와 같이 작업을 추가하고
+
Android 5.0의 잠금 화면에서 미디어 재생 제어를 표시하려면,
+위에 설명한 바와 같이 가시성을 {@link android.support.v4.app.NotificationCompat#VISIBILITY_PUBLIC}으로 설정합니다. 그런 다음 다음 샘플 코드에서 설명한 바와 같이 작업을 추가하고
{@link android.app.Notification.MediaStyle} 템플릿을 설정합니다.
참고: {@link android.media.RemoteControlClient}를
사용하지 않게 된 것은 미디어 제어에 이외에도 더 많은 영향을 미칩니다. 미디어 세션을 관리하고 재생을 제어하기 위한 새 API에 관한 자세한 정보는
미디어 재생 제어를
참조하십시오.
@@ -923,57 +923,57 @@ Notification notification = new Notification.Builder(context)
사용자 지정 알림 레이아웃
- 알림 프레임워크를 사용하면 사용자 지정 레이아웃을 정의할 수 있습니다.
+ 알림 프레임워크를 사용하면 사용자 지정 레이아웃을 정의할 수 있습니다.
사용자 지정 레이아웃은 {@link android.widget.RemoteViews} 객체에서 알림의 외관을 정의합니다.
사용자 지정 레이아웃 알림은 일반적인 알림과 비슷하지만, 이들은 XML 레이아웃 파일에서
정의한 {@link android.widget.RemoteViews}에 기초합니다.
- 사용자 지정 알림 레이아웃에 사용할 수 있는 높이는 알림 보기에 따라 다릅니다. 일반
+ 사용자 지정 알림 레이아웃에 사용할 수 있는 높이는 알림 보기에 따라 다릅니다. 일반
보기 레이아웃은 64dp로 제한되어 있으며 확장 보기 레이아웃은 256dp로 제한되어 있습니다.
- 사용자 지정 레이아웃을 정의하려면
-XML 레이아웃 파일을 팽창하는 {@link android.widget.RemoteViews} 객체를 인스턴트화하는 것부터 시작합니다. 그런 다음,
+ 사용자 지정 레이아웃을 정의하려면
+XML 레이아웃 파일을 팽창하는 {@link android.widget.RemoteViews} 객체를 인스턴트화하는 것부터 시작합니다. 그런 다음,
-{@link android.support.v4.app.NotificationCompat.Builder#setContentTitle setContentTitle()}과 같은 메서드를 호출하는 대신
-{@link android.support.v4.app.NotificationCompat.Builder#setContent setContent()}를 호출합니다. 사용자 지정 알림에서
+{@link android.support.v4.app.NotificationCompat.Builder#setContentTitle setContentTitle()}과 같은 메서드를 호출하는 대신
+{@link android.support.v4.app.NotificationCompat.Builder#setContent setContent()}를 호출합니다. 사용자 지정 알림에서
콘텐츠 세부 정보를 설정하려면
{@link android.widget.RemoteViews}의 메서드를 사용하여 보기의 하위 요소에 대한 값을 설정합니다.
- 알림에 대한 XML 레이아웃은 별도의 파일에 생성하십시오. 파일 이름은 원하는 대로
+ 알림에 대한 XML 레이아웃은 별도의 파일에 생성하십시오. 파일 이름은 원하는 대로
아무 것이나 사용해도 좋지만, 확장자는 .xml을 사용해야 합니다.
- 앱에서 {@link android.widget.RemoteViews} 메서드를 사용하여 알림의 아이콘과 텍스트를
-정의합니다. 이 {@link android.widget.RemoteViews} 객체를
-{@link android.support.v4.app.NotificationCompat.Builder} 안에 넣으십시오.
-{@link android.support.v4.app.NotificationCompat.Builder#setContent setContent()}를 호출하면 됩니다. 배경
-{@link android.graphics.drawable.Drawable}을
+ 앱에서 {@link android.widget.RemoteViews} 메서드를 사용하여 알림의 아이콘과 텍스트를
+정의합니다. 이 {@link android.widget.RemoteViews} 객체를
+{@link android.support.v4.app.NotificationCompat.Builder} 안에 넣으십시오.
+{@link android.support.v4.app.NotificationCompat.Builder#setContent setContent()}를 호출하면 됩니다. 배경
+{@link android.graphics.drawable.Drawable}을
{@link android.widget.RemoteViews} 객체에서 설정하는 것은 삼가하십시오. 텍스트 색상을 읽을 수 없게 될 수도 있습니다.
- {@link android.widget.RemoteViews} 클래스에도 개발자가 손쉽게 사용할 수 있는 여러 가지 메서드가 포함되어 있습니다. 이를 이용해
-{@link android.widget.Chronometer} 또는 {@link android.widget.ProgressBar}를
+ {@link android.widget.RemoteViews} 클래스에도 개발자가 손쉽게 사용할 수 있는 여러 가지 메서드가 포함되어 있습니다. 이를 이용해
+{@link android.widget.Chronometer} 또는 {@link android.widget.ProgressBar}를
알림의 레이아웃에 추가하면 됩니다. 알림의 사용자 지정 레이아웃 생성에 관한 자세한 정보는
{@link android.widget.RemoteViews} 참조 문서를 참조하십시오.
- 주의: 사용자 지정 레이아웃을 사용하는 경우,
-사용자 지정 레이아웃이 다양한 기기 방향과 해상도에서 작동하는지 각별히 주의를 기울여 확인하십시오. 이 조언은
-모든 보기 레이아웃에 공통적으로 적용되지만, 특히 알림에 중요한 의미를 지닙니다.
-알림 창에서는 공간이 굉장히 제한되어 있기 때문입니다. 사용자 지정 레이아웃을 너무 복잡하게 만들지 마시고,
+ 주의: 사용자 지정 레이아웃을 사용하는 경우,
+사용자 지정 레이아웃이 다양한 기기 방향과 해상도에서 작동하는지 각별히 주의를 기울여 확인하십시오. 이 조언은
+모든 보기 레이아웃에 공통적으로 적용되지만, 특히 알림에 중요한 의미를 지닙니다.
+알림 창에서는 공간이 굉장히 제한되어 있기 때문입니다. 사용자 지정 레이아웃을 너무 복잡하게 만들지 마시고,
여러 가지 구성에서 테스트하는 것을 잊지 마십시오.
사용자 지정 알림 텍스트에 스타일 리소스 사용
- 사용자 지정 알림의 텍스트에는 항상 스타일 리소스를 사용하십시오. 알림의 배경 색상은 기기와 버전별로 다를 수 있습니다.
-스타일 리소스를 사용하면 이러한 차이를
-감안하는 데 도움이 됩니다. Android 2.3부터 시스템은
-표준 알림 레이아웃 텍스트의 스타일을 정의했습니다. Android 2.3 이상을 대상으로 하는
+ 사용자 지정 알림의 텍스트에는 항상 스타일 리소스를 사용하십시오. 알림의 배경 색상은 기기와 버전별로 다를 수 있습니다.
+스타일 리소스를 사용하면 이러한 차이를
+감안하는 데 도움이 됩니다. Android 2.3부터 시스템은
+표준 알림 레이아웃 텍스트의 스타일을 정의했습니다. Android 2.3 이상을 대상으로 하는
애플리케이션에서와 같은 스타일을 사용하면 텍스트가 디스플레이 배경에서도 잘 보이도록 할 수 있습니다.
Android 앱의 모든 사용자 인터페이스 요소는 {@link android.view.View}와
-{@link android.view.ViewGroup} 개체를 사용하여 구축합니다. {@link android.view.View}는 사용자가 상호 작용할 수 있는 무언가를
-화면에 그리는 객체입니다. {@link android.view.ViewGroup}은
-인터페이스 레이아웃을 정의하기 위해 다른 {@link android.view.View}(및{@link android.view.ViewGroup}) 객체를
+{@link android.view.ViewGroup} 개체를 사용하여 구축합니다. {@link android.view.View}는 사용자가 상호 작용할 수 있는 무언가를
+화면에 그리는 객체입니다. {@link android.view.ViewGroup}은
+인터페이스 레이아웃을 정의하기 위해 다른 {@link android.view.View}(및{@link android.view.ViewGroup}) 객체를
보유하는 객체입니다.
Android는 공통 입력 제어(버튼 및 텍스트 필드)와 다양한 레이아웃 모델(선형 또는 관계 레이아웃)을 제공하는 {@link android.view.View}와 {@link
@@ -16,30 +16,30 @@ android.view.ViewGroup} 하위 클래스의
사용자 인터페이스 레이아웃
앱의 각 구성 요소에 대한 사용자 인터페이스는 그림 1에서 나타난 바와 같이 {@link
-android.view.View}와 {@link android.view.ViewGroup} 객체의 계층으로 정의됩니다. 각 보기 그룹은
-하위 보기를 체계화하는 투명한 컨테이너이고,
-하위 보기는 UI의 일부분을 그리는 제어나 다른 위젯일 수 있습니다.
-이 계층 트리는 개발자에게 필요한 만큼 단순하거나 복잡하게
+android.view.View}와 {@link android.view.ViewGroup} 객체의 계층으로 정의됩니다. 각 보기 그룹은
+하위 보기를 체계화하는 투명한 컨테이너이고,
+하위 보기는 UI의 일부분을 그리는 제어나 다른 위젯일 수 있습니다.
+이 계층 트리는 개발자에게 필요한 만큼 단순하거나 복잡하게
만들 수 있습니다(다만 단순한 것이 성능에는 가장 좋습니다).
-
그림 1. 보기 계층을 나타낸 것으로, 이것이
+
그림 1. 보기 계층을 나타낸 것으로, 이것이
UI 레이아웃을 정의합니다.
-
레이아웃을 선언하려면 코드의 {@link android.view.View} 객체를 인스턴트화하고 트리를 구축하기 시작하면 되지만,
-레이아웃을 정의하는 가장 쉽고 효과적인 방법은 XML 파일을 사용하는 것입니다.
+
레이아웃을 선언하려면 코드의 {@link android.view.View} 객체를 인스턴트화하고 트리를 구축하기 시작하면 되지만,
+레이아웃을 정의하는 가장 쉽고 효과적인 방법은 XML 파일을 사용하는 것입니다.
XML은 HTML과 유사한, 인간이 읽을 수 있는 레이아웃 구조를 제공합니다.
-
보기의 XML 요소 이름은 해당 요소가 나타내는 각각의 Android 클래스를 따릅니다. 말하자면
+
보기의 XML 요소 이름은 해당 요소가 나타내는 각각의 Android 클래스를 따릅니다. 말하자면
<TextView> 요소가 UI에서 {@link android.widget.TextView} 위젯을 생성하고,
-<LinearLayout> 요소는 {@link android.widget.LinearLayout} 보기
+<LinearLayout> 요소는 {@link android.widget.LinearLayout} 보기
그룹을 생성하는 것입니다.
예를 들어, 텍스트 보기와 버튼 하나가 있는 단순한 수직 레이아웃은 이런 모습을 띱니다.
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
- android:layout_width="fill_parent"
+ android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical" >
<TextView android:id="@+id/text"
@@ -53,19 +53,19 @@ XML은 HTML과 유사한, 인간이 읽을 수 있는 레이아웃 구조를 제
</LinearLayout>
-
앱에 레이아웃 리소스를 로드하면 Android가 레이아웃의 각 노드를 초기화하여
-추가 동작을 정의하거나, 객체 상태를 쿼리 또는 레이아웃을 수정하는 데 쓸 수 있는 런타임 객체로
+
앱에 레이아웃 리소스를 로드하면 Android가 레이아웃의 각 노드를 초기화하여
+추가 동작을 정의하거나, 객체 상태를 쿼리 또는 레이아웃을 수정하는 데 쓸 수 있는 런타임 객체로
초기화합니다.
UI를 구축할 때 모두 {@link android.view.View} 및 {@link
-android.view.ViewGroup} 객체를 사용해야 하는 것은 아닙니다. Android가 표준형 UI 레이아웃을 제공하는 앱 구성 요소를 여러 개 제공하고 있으니,
-개발자 여러분은 이에 대한 콘텐츠만 정의하면 됩니다. 이와 같은 UI 구성 요소에는 각각
+android.view.ViewGroup} 객체를 사용해야 하는 것은 아닙니다. Android가 표준형 UI 레이아웃을 제공하는 앱 구성 요소를 여러 개 제공하고 있으니,
+개발자 여러분은 이에 대한 콘텐츠만 정의하면 됩니다. 이와 같은 UI 구성 요소에는 각각
고유한 API 세트가 있습니다. 이들은 작업 모음, 대화 및 상태 알림 등 각각 다른 문서에서 설명하였습니다.
애플리케이션에는 종종 설정이 포함되어 있어 사용자가 앱 기능과 행동을 수정할 수 있게 해줍니다. 예를 들어
-몇몇 앱은 사용자에게 알림을 활성화할지 여부를 지정하거나 애플리케이션이
+
애플리케이션에는 종종 설정이 포함되어 있어 사용자가 앱 기능과 행동을 수정할 수 있게 해줍니다. 예를 들어
+몇몇 앱은 사용자에게 알림을 활성화할지 여부를 지정하거나 애플리케이션이
클라우드와 데이터를 동기화할 빈도를 지정할 수 있게 해줍니다.
-
자신의 앱에 설정을 제공하고자 하는 경우, Android의
-{@link android.preference.Preference} API를 사용하여 다른 Android 앱(시스템 설정 포함)의 사용자 환경과
-일관성을 유지하는 인터페이스를 구축할 수 있게 해야 합니다. 이 문서에서는
+
자신의 앱에 설정을 제공하고자 하는 경우, Android의
+{@link android.preference.Preference} API를 사용하여 다른 Android 앱(시스템 설정 포함)의 사용자 환경과
+일관성을 유지하는 인터페이스를 구축할 수 있게 해야 합니다. 이 문서에서는
{@link android.preference.Preference} API를 사용하여 앱 설정을 구축하는 방법을 설명합니다.
사용자 인터페이스를 구축할 때에는 {@link android.view.View} 객체를 사용하지만, 설정은 그 대신
-{@link android.preference.Preference} 클래스의 다양한 하위 클래스를 사용하여 구축합니다.
+
사용자 인터페이스를 구축할 때에는 {@link android.view.View} 객체를 사용하지만, 설정은 그 대신
+{@link android.preference.Preference} 클래스의 다양한 하위 클래스를 사용하여 구축합니다.
이와 같은 하위 클래스는 XML 파일에서 선언합니다.
-
{@link android.preference.Preference} 객체는 하나의 설정을 이루는 기본
-단위입니다. 각각의 {@link android.preference.Preference}는 목록의 항목으로
+
{@link android.preference.Preference} 객체는 하나의 설정을 이루는 기본
+단위입니다. 각각의 {@link android.preference.Preference}는 목록의 항목으로
나타나며 사용자가 설정을 수정하기에 적절한 UI를 제공합니다. 예를 들어 {@link
android.preference.CheckBoxPreference}는 확인란을 표시하는 목록 항목을 만들고, {@link
android.preference.ListPreference}는 선택 목록이 있는 대화를 여는 항목을 만듭니다.
-
각각의 {@link android.preference.Preference}를 추가할 때마다 상응하는 키-값 쌍이 있어
+
각각의 {@link android.preference.Preference}를 추가할 때마다 상응하는 키-값 쌍이 있어
시스템이 이를 사용하여 해당 설정을 앱의 설정에 대한 기본 {@link android.content.SharedPreferences}
-파일에 저장합니다. 사용자가 설정을 변경하면 시스템이
-{@link android.content.SharedPreferences} 파일에 있는 상응하는 값을 개발자 대신 업데이트합니다. 개발자가 직접
-연관된 {@link android.content.SharedPreferences} 파일과 상호 작용을 해야 하는 경우는
+파일에 저장합니다. 사용자가 설정을 변경하면 시스템이
+{@link android.content.SharedPreferences} 파일에 있는 상응하는 값을 개발자 대신 업데이트합니다. 개발자가 직접
+연관된 {@link android.content.SharedPreferences} 파일과 상호 작용을 해야 하는 경우는
사용자의 설정을 기반으로 앱의 동작을 결정하기 위해 값을 읽어야 할 때뿐입니다.
-
각 설정에 대하여 {@link android.content.SharedPreferences}에 저장된 값은 다음과 같은
+
각 설정에 대하여 {@link android.content.SharedPreferences}에 저장된 값은 다음과 같은
데이터 유형 중 한 가지를 취할 수 있습니다.
@@ -119,31 +119,31 @@ android.preference.ListPreference}는 선택 목록이 있는 대화를 여는
String {@link java.util.Set}
-
앱의 설정 UI는
-{@link android.view.View} 객체 대신
-{@link android.preference.Preference} 객체를 사용하여 구축되기 때문에, 목록 설정을 표시하려면 특수 {@link android.app.Activity} 또는
+
앱의 설정 UI는
+{@link android.view.View} 객체 대신
+{@link android.preference.Preference} 객체를 사용하여 구축되기 때문에, 목록 설정을 표시하려면 특수 {@link android.app.Activity} 또는
{@link android.app.Fragment} 하위 클래스를 사용해야 합니다.
-
앱이 Android 3.0 이전 버전(API 레벨 10 이하)을 지원하는 경우, 액티비티를 구축할 때
+
앱이 Android 3.0 이전 버전(API 레벨 10 이하)을 지원하는 경우, 액티비티를 구축할 때
{@link android.preference.PreferenceActivity} 클래스의 확장으로 구축해야 합니다.
-
Android 3.0 이후의 경우에는 대신 기존의 {@link android.app.Activity}를
-사용해야 합니다. 이것은 앱 설정을 표시하는 {@link android.preference.PreferenceFragment}를 호스팅합니다.
-하지만, 여러 개의 설정 그룹이 있는 경우 {@link android.preference.PreferenceActivity}를 사용하여
+
Android 3.0 이후의 경우에는 대신 기존의 {@link android.app.Activity}를
+사용해야 합니다. 이것은 앱 설정을 표시하는 {@link android.preference.PreferenceFragment}를 호스팅합니다.
+하지만, 여러 개의 설정 그룹이 있는 경우 {@link android.preference.PreferenceActivity}를 사용하여
대형 화면에 맞는 창 두 개짜리 레이아웃을 만들 수도 있습니다.
앱에 대한 설정은 모두 {@link
-android.preference.Preference} 클래스의 특정 하위 클래스로 표현됩니다. 각 하위 클래스에 핵심 속성이 한 세트씩 포함되어 있어
-설정의 제목과 기본 값 등과 같은 것을 지정할 수 있게 해줍니다. 각 하위 클래스는 또한 자신만의
-특수 속성과 사용자 인터페이스도 제공합니다. 예를 들어, 그림 1에서는 메시지 앱의 설정에서
+android.preference.Preference} 클래스의 특정 하위 클래스로 표현됩니다. 각 하위 클래스에 핵심 속성이 한 세트씩 포함되어 있어
+설정의 제목과 기본 값 등과 같은 것을 지정할 수 있게 해줍니다. 각 하위 클래스는 또한 자신만의
+특수 속성과 사용자 인터페이스도 제공합니다. 예를 들어, 그림 1에서는 메시지 앱의 설정에서
가져온 스크린샷을 나타낸 것입니다. 설정 화면에 있는 각 목록 항목은 각기 서로 다른 {@link
android.preference.Preference} 객체로 지원됩니다.
활성화되었거나 비활성화된 설정에 대한 확인란이 있는 항목을 표시합니다. 저장된 값은
부울입니다(확인란이 선택된 경우 true).
{@link android.preference.ListPreference}
-
무선 버튼 목록이 있는 대화를 엽니다. 저장된 값은
+
무선 버튼 목록이 있는 대화를 엽니다. 저장된 값은
지원되는 값 유형(위에 목록으로 나열) 중 어느 것이라도 될 수 있습니다.
{@link android.preference.EditTextPreference}
@@ -166,36 +166,36 @@ java.lang.String}입니다.
다른 모든 하위 클래스와 이에 상응하는 속성의 목록을 보려면 {@link android.preference.Preference}
클래스를 참조하십시오.
-
물론 기본 제공 클래스만으로는 필요한 것을 모두 충족할 수 없고 앱에 무언가 좀 더 특수한 것이
+
물론 기본 제공 클래스만으로는 필요한 것을 모두 충족할 수 없고 앱에 무언가 좀 더 특수한 것이
필요할 수도 있습니다. 예를 들어 플랫폼은 현재 숫자나 날짜를 선택할 수 있는 {@link
-android.preference.Preference} 클래스를 제공하지 않습니다. 따라서 개발자 나름대로
+android.preference.Preference} 클래스를 제공하지 않습니다. 따라서 개발자 나름대로
{@link android.preference.Preference} 하위 클래스를 정의해야 할 수도 있습니다. 이 작업을 수행하는 데 유용한 내용인 사용자 지정 기본 설정 구축하기에 관한 섹션을 참조하십시오.
XML로 기본 설정 정의하기
-
새로운 {@link android.preference.Preference} 객체를 런타임에 인스턴트화하는 것도 가능하지만,
+
새로운 {@link android.preference.Preference} 객체를 런타임에 인스턴트화하는 것도 가능하지만,
설정 목록을 정의할 때에는 {@link android.preference.Preference}
-객체의 계층과 함께 XML을 사용해야 합니다. 설정 컬렉션을 정의하는 데 XM 파일을 사용하는 것이 선호되는 이유는 이 파일이
-읽기 쉬운 구조를 제공하여 업데이트가 단순하기 때문입니다. 또한, 앱의 설정은 보통
+객체의 계층과 함께 XML을 사용해야 합니다. 설정 컬렉션을 정의하는 데 XM 파일을 사용하는 것이 선호되는 이유는 이 파일이
+읽기 쉬운 구조를 제공하여 업데이트가 단순하기 때문입니다. 또한, 앱의 설정은 보통
미리 정의되어 있습니다. 다만 개발자도 여전히 런타임에 설정 컬렉션을 수정할 수 있습니다.
-
각 {@link android.preference.Preference} 하위 클래스는 클래스 이름에 일치하는 XML 요소로
+
각 {@link android.preference.Preference} 하위 클래스는 클래스 이름에 일치하는 XML 요소로
선언하면 됩니다. 예를 들면 {@code <CheckBoxPreference>}가 이에 해당됩니다.
-
이 XML 파일은 반드시 {@code res/xml/} 디렉터리에 저장해야 합니다. 파일의 이름은 무엇이든 원하는 대로 지정할 수 있지만,
-일반적으로는 {@code preferences.xml}이라고 명명합니다. 파일은 하나만 필요한 것이 보통입니다.
-왜냐하면 계층에 있는 분기(자신만의 설정 목록을 엶)는
+
이 XML 파일은 반드시 {@code res/xml/} 디렉터리에 저장해야 합니다. 파일의 이름은 무엇이든 원하는 대로 지정할 수 있지만,
+일반적으로는 {@code preferences.xml}이라고 명명합니다. 파일은 하나만 필요한 것이 보통입니다.
+왜냐하면 계층에 있는 분기(자신만의 설정 목록을 엶)는
{@link android.preference.PreferenceScreen}의 중첩된 인스턴스를 사용하여 선언되기 때문입니다.
-
참고: 설정에 다중 창 레이아웃을 만들고자 하는 경우,
+
참고: 설정에 다중 창 레이아웃을 만들고자 하는 경우,
각 프래그먼트에 대해 별도의 XML 파일이 필요합니다.
XML 파일의 루트 노드는 반드시 {@link android.preference.PreferenceScreen
<PreferenceScreen>} 요소여야 합니다. 바로 이 요소 내에 각 {@link
-android.preference.Preference}를 추가하는 것입니다.
-{@link android.preference.PreferenceScreen <PreferenceScreen>} 요소 내에 추가하는 각 하위는 설정 목록에서
+android.preference.Preference}를 추가하는 것입니다.
+{@link android.preference.PreferenceScreen <PreferenceScreen>} 요소 내에 추가하는 각 하위는 설정 목록에서
각기 항목 하나씩으로 나타납니다.
예:
@@ -224,11 +224,11 @@ android.preference.ListPreference}가 하나씩 있습니다. 두 항목 모두
{@code android:key}
-
이 속성은 데이터 값을 유지하는 기본 설정에 필수입니다. 이것은 고유키(문자)를
+
이 속성은 데이터 값을 유지하는 기본 설정에 필수입니다. 이것은 고유키(문자)를
나타내며, 시스템이 이것을 사용하여 이 설정의 값을 {@link
-android.content.SharedPreferences}에 저장합니다.
-
이 속성이 필요하지 않은 인스턴스는 기본 설정이
-{@link android.preference.PreferenceCategory} 또는 {@link android.preference.PreferenceScreen}인 경우, 또는
+android.content.SharedPreferences}에 저장합니다.
+
이 속성이 필요하지 않은 인스턴스는 기본 설정이
+{@link android.preference.PreferenceCategory} 또는 {@link android.preference.PreferenceScreen}인 경우, 또는
기본 설정이 {@link android.content.Intent}를 호출할 것을 나타내거나({@code <intent>} 요소로) {@link android.app.Fragment}를 표시하도록 지정하는 경우({@code
android:fragment} 속성으로)뿐입니다.
@@ -236,7 +236,7 @@ android:fragment} 속성으로)뿐입니다.
이것은 설정에 대하여 사용자가 볼 수 있는 이름을 제공합니다.
{@code android:defaultValue}
이것은 시스템이 {@link
-android.content.SharedPreferences} 파일에 설정해야 하는 초기 값을 나타냅니다. 모든 설정에 기본 값을 제공해야
+android.content.SharedPreferences} 파일에 설정해야 하는 초기 값을 나타냅니다. 모든 설정에 기본 값을 제공해야
합니다.
@@ -248,21 +248,21 @@ android.preference.Preference}(및 각각의 하위 클래스) 관련 문서를
그림 2. 제목이 있는 설정
카테고리입니다. 1. 카테고리는 {@link
-android.preference.PreferenceCategory <PreferenceCategory>} 요소가 지정합니다. 2. 제목은
+android.preference.PreferenceCategory <PreferenceCategory>} 요소가 지정합니다. 2. 제목은
{@code android:title} 속성으로 지정합니다.
-
설정 목록이 약 10개 항목을 초과하면 제목을 추가하여
-설정 그룹을 정의하거나, 해당 그룹을 별도의
+
설정 목록이 약 10개 항목을 초과하면 제목을 추가하여
+설정 그룹을 정의하거나, 해당 그룹을 별도의
화면에 표시하는 것이 좋을 수도 있습니다. 이러한 옵션은 다음 섹션에 설명되어 있습니다.
설정 그룹 만들기
-
10개 이상의 설정 목록을 제시하는 경우, 사용자가
-이들을 둘러보고 이해하며 처리하는 데 어려움을 겪을 수 있습니다. 이 문제를 해결하려면
-설정의 일부 또는 모두를 그룹으로 나누어 사실상 하나의 긴 목록을 여러 개의 더 짧은 목록으로
+
10개 이상의 설정 목록을 제시하는 경우, 사용자가
+이들을 둘러보고 이해하며 처리하는 데 어려움을 겪을 수 있습니다. 이 문제를 해결하려면
+설정의 일부 또는 모두를 그룹으로 나누어 사실상 하나의 긴 목록을 여러 개의 더 짧은 목록으로
바꿔주면 됩니다. 관련된 설정 그룹 하나를 나타낼 때에는 다음과 같은 두 가지 방식 중 하나를 택하면 됩니다.
@@ -270,14 +270,14 @@ android.preference.PreferenceCategory <PreferenceCategory>} 요소가 지
이와 같은 그룹화 기법 중 하나 또는 둘 모두를 사용하여 앱의 설정을 조직화할 수 있습니다. 어느 것을
-사용할지, 설정을 어떻게 나눌지 결정할 때에는 Android
+
이와 같은 그룹화 기법 중 하나 또는 둘 모두를 사용하여 앱의 설정을 조직화할 수 있습니다. 어느 것을
+사용할지, 설정을 어떻게 나눌지 결정할 때에는 Android
디자인의 설정 가이드에 있는 지침을 따라야 합니다.
제목 사용하기
-
여러 개의 설정 그룹 사이에 구분선과 제목을 제공하고자 하는 경우(그림 2에 표시된 것과 같이),
+
여러 개의 설정 그룹 사이에 구분선과 제목을 제공하고자 하는 경우(그림 2에 표시된 것과 같이),
각 {@link android.preference.Preference} 객체 그룹을 {@link
android.preference.PreferenceCategory} 내부에 배치합니다.
@@ -285,7 +285,7 @@ android.preference.PreferenceCategory} 내부에 배치합니다.
설정 그룹 여러 개를 보조 화면에 배치하고자 하는 경우(그림 3에 표시된 것과 같이), 해당
+
설정 그룹 여러 개를 보조 화면에 배치하고자 하는 경우(그림 3에 표시된 것과 같이), 해당
{@link android.preference.Preference} 객체 그룹을 {@link
android.preference.PreferenceScreen} 안에 배치합니다.
그림 3. 설정 보조 화면입니다. {@code
-<PreferenceScreen>} 요소가
+<PreferenceScreen>} 요소가
항목을 만들며, 이 항목이 선택되면 별도의 목록이 열려 중첩된 설정을 표시합니다.
예:
@@ -352,7 +352,7 @@ android.preference.PreferenceScreen} 안에 배치합니다.
인텐트 사용하기
-
어떤 경우에는 기본 설정 항목을 사용하여 설정 화면 대신 여러 가지 액티비티를
+
어떤 경우에는 기본 설정 항목을 사용하여 설정 화면 대신 여러 가지 액티비티를
열고자 할 수도 있습니다. 예를 들어 웹 브라우저를 열어 웹 페이지를 보는 것이 이에 해당됩니다. 사용자가 기본 설정 항목을 선택할 때 {@link
android.content.Intent}를 호출하도록 하려면, {@code <intent>}
요소를 상응하는 {@code <Preference>} 요소의 하위로 추가하면 됩니다.
@@ -392,18 +392,18 @@ android.content.Intent#setComponent setComponent()} 메서드를 따릅니다.설정을 액티비티에서 표시하려면 {@link
android.preference.PreferenceActivity} 클래스를 확장하면 됩니다. 이것은 일반적인 {@link
android.app.Activity} 클래스 확장의 일종입니다. 이는 {@link
-android.preference.Preference} 객체의 계층에 기반한 설정 목록을 표시합니다. {@link android.preference.PreferenceActivity}는
+android.preference.Preference} 객체의 계층에 기반한 설정 목록을 표시합니다. {@link android.preference.PreferenceActivity}는
사용자가 변경 작업을 하면 각 {@link
android.preference.Preference}와 연관된 설정을 유지합니다.
-
참고: Android 3.0 이상에 맞춰 애플리케이션을 개발하는 경우,
-대신 {@link android.preference.PreferenceFragment}를 사용해야 합니다. 다음 섹션의
+
참고: Android 3.0 이상에 맞춰 애플리케이션을 개발하는 경우,
+대신 {@link android.preference.PreferenceFragment}를 사용해야 합니다. 다음 섹션의
기본 설정 프래그먼트 사용하기 관련 내용을 참조하십시오.
여기서 기억해야 할 가장 중요한 점은 {@link
android.preference.PreferenceActivity#onCreate onCreate()} 콜백 중에 보기 레이아웃을 로딩해서는 안 된다는 것입니다. 그 대신 {@link
-android.preference.PreferenceActivity#addPreferencesFromResource addPreferencesFromResource()}를 호출하여
-XML 파일에서 선언한 기본 설정을 액티비티에 추가합니다. 예를 들어 다음은 기능적인
+android.preference.PreferenceActivity#addPreferencesFromResource addPreferencesFromResource()}를 호출하여
+XML 파일에서 선언한 기본 설정을 액티비티에 추가합니다. 예를 들어 다음은 기능적인
{@link android.preference.PreferenceActivity}에 필요한 가장 최소한의 코드를 나타낸 것입니다.
@@ -416,11 +416,11 @@ public class SettingsActivity extends PreferenceActivity {
}
-
사실 이 코드만으로 몇몇 앱에는 충분합니다. 사용자가 기본 설정을 수정하자마자
-시스템이 해당 변경을 기본 {@link android.content.SharedPreferences} 파일에 저장하여,
-사용자의 설정을 확인해야 할 때 다른 애플리케이션 구성 요소가 이를 읽을 수 있도록 하기 때문입니다. 하지만
+
사실 이 코드만으로 몇몇 앱에는 충분합니다. 사용자가 기본 설정을 수정하자마자
+시스템이 해당 변경을 기본 {@link android.content.SharedPreferences} 파일에 저장하여,
+사용자의 설정을 확인해야 할 때 다른 애플리케이션 구성 요소가 이를 읽을 수 있도록 하기 때문입니다. 하지만
대다수의 앱은 기본 설정에 일어나는 변경을 수신 대기하기 위해 약간의 코드가 더 필요합니다.
-{@link android.content.SharedPreferences} 파일에 일어나는 변경을 수신 대기하는 데 관한
+{@link android.content.SharedPreferences} 파일에 일어나는 변경을 수신 대기하는 데 관한
자세한 정보는 기본 설정 읽기에 관한 섹션을 참조하십시오.
@@ -430,17 +430,17 @@ public class SettingsActivity extends PreferenceActivity {
Android 3.0(API 레벨 11) 이상에 맞춰 개발하는 경우, {@link
android.preference.PreferenceFragment}를 사용하여 {@link android.preference.Preference}
-객체 목록을 표시해야 합니다. {@link android.preference.PreferenceFragment}는 모든 액티비티에 추가할 수 있습니다. 즉,
+객체 목록을 표시해야 합니다. {@link android.preference.PreferenceFragment}는 모든 액티비티에 추가할 수 있습니다. 즉,
{@link android.preference.PreferenceActivity}를 사용하지 않아도 됩니다.
-
프래그먼트는 액티비티만
-사용하는 것에 비해 애플리케이션에 보다 유연한 아키텍처를 제공하며, 이는 구축하는
+
프래그먼트는 액티비티만
+사용하는 것에 비해 애플리케이션에 보다 유연한 아키텍처를 제공하며, 이는 구축하는
액티비티의 종류와 무관하게 적용됩니다. 따라서 설정 표시를 제어하는 데에는 {@link
android.preference.PreferenceFragment}를 {@link
android.preference.PreferenceActivity} 대신 사용하는 방안을 권장합니다(가능한 경우).
{@link android.preference.PreferenceFragment} 구현은 매우 간단합니다.
-{@link android.preference.PreferenceFragment#onCreate onCreate()} 메서드를 정의하여 기본 설정 파일을
+{@link android.preference.PreferenceFragment#onCreate onCreate()} 메서드를 정의하여 기본 설정 파일을
{@link android.preference.PreferenceFragment#addPreferencesFromResource
addPreferencesFromResource()}로 로딩하도록 하기만 하면 됩니다. 예:
@@ -457,7 +457,7 @@ public static class SettingsFragment extends PreferenceFragment {
}
-
그런 다음 이 프래그먼트를 {@link android.app.Activity}에 추가하기만 하면 되고, 이는 다른 모든
+
그런 다음 이 프래그먼트를 {@link android.app.Activity}에 추가하기만 하면 되고, 이는 다른 모든
{@link android.app.Fragment}에서와 마찬가지입니다. 예:
@@ -474,24 +474,24 @@ public class SettingsActivity extends Activity {
}
-
참고: {@link android.preference.PreferenceFragment}에는 자신만의
+
참고: {@link android.preference.PreferenceFragment}에는 자신만의
{@link android.content.Context} 객체가 없습니다. {@link android.content.Context}
-객체가 필요한 경우, {@link android.app.Fragment#getActivity()}를 호출하면 됩니다. 하지만,
-{@link android.app.Fragment#getActivity()}를 호출하는 것은 프래그먼트가 액티비티에 첨부되어 있는 경우만으로 국한시켜야 한다는 점을 유의하십시오. 프래그먼트가
+객체가 필요한 경우, {@link android.app.Fragment#getActivity()}를 호출하면 됩니다. 하지만,
+{@link android.app.Fragment#getActivity()}를 호출하는 것은 프래그먼트가 액티비티에 첨부되어 있는 경우만으로 국한시켜야 한다는 점을 유의하십시오. 프래그먼트가
아직 첨부되지 않았거나 수명 주기가 끝날 무렵 분리된 경우, {@link
android.app.Fragment#getActivity()}가 null을 반환합니다.
설정 기본 값
-
여러분이 만드는 기본 설정은 애플리케이션에 중요한 동작을 정의하는 경우가 많을 것입니다. 따라서
-연관된 {@link android.content.SharedPreferences} 파일을
-각 {@link android.preference.Preference}에 대한 기본 값으로 초기화하여 사용자가 애플리케이션을 처음 열 때
+
여러분이 만드는 기본 설정은 애플리케이션에 중요한 동작을 정의하는 경우가 많을 것입니다. 따라서
+연관된 {@link android.content.SharedPreferences} 파일을
+각 {@link android.preference.Preference}에 대한 기본 값으로 초기화하여 사용자가 애플리케이션을 처음 열 때
적용하는 것이 중요합니다.
가장 먼저 해야 할 일은 XML 파일 내의 각 {@link
android.preference.Preference}
-객체에 대해 기본 값을 지정하는 것입니다. 이때 {@code android:defaultValue} 속성을 사용합니다. 이 값은 상응하는
+객체에 대해 기본 값을 지정하는 것입니다. 이때 {@code android:defaultValue} 속성을 사용합니다. 이 값은 상응하는
{@link android.preference.Preference} 객체에 대해 적절한 어느 데이터 유형이라도 될 수 있습니다. 예:
그런 다음, 애플리케이션의 기본 액티비티에 있는 {@link android.app.Activity#onCreate onCreate()}
-메서드로부터—또한 사용자가 애플리케이션에 처음으로 들어올 통로가 될 수 있는
+
그런 다음, 애플리케이션의 기본 액티비티에 있는 {@link android.app.Activity#onCreate onCreate()}
+메서드로부터—또한 사용자가 애플리케이션에 처음으로 들어올 통로가 될 수 있는
다른 모든 액티비티도 포함—{@link android.preference.PreferenceManager#setDefaultValues
setDefaultValues()}를 호출합니다.
이것을 {@link android.app.Activity#onCreate onCreate()} 중에 호출하면
-애플리케이션이 기본 설정으로 적절히 초기화되도록 보장할 수 있습니다. 이것은 애플리케이션이
-몇 가지 동작을 결정하기 위해 읽어야 할 수도 있습니다(예를 들어 셀룰러 네트워크에서 데이터를
+
이것을 {@link android.app.Activity#onCreate onCreate()} 중에 호출하면
+애플리케이션이 기본 설정으로 적절히 초기화되도록 보장할 수 있습니다. 이것은 애플리케이션이
+몇 가지 동작을 결정하기 위해 읽어야 할 수도 있습니다(예를 들어 셀룰러 네트워크에서 데이터를
다운로드할지 여부 등).
false인 경우, 시스템은 이 메서드가 전에 한 번도 호출된 적이 없을 경우에만
기본 값을 설정합니다(아니면 기본 값을 공유한 기본 설정 파일에 있는 {@link android.preference.PreferenceManager#KEY_HAS_SET_DEFAULT_VALUES}
가 안전합니다).
-
세 번째 인수를 false로 설정해 두는 한 이 메서드를 액티비티가 시작될 때마다
-안전하게 호출할 수 있으며, 그렇게 해도 사용자의 저장된 기본 설정을 기본값으로 초기화하여
-재정의하지 않습니다. 하지만 이를 true로 설정하면, 이전의 모든 값을
+
세 번째 인수를 false로 설정해 두는 한 이 메서드를 액티비티가 시작될 때마다
+안전하게 호출할 수 있으며, 그렇게 해도 사용자의 저장된 기본 설정을 기본값으로 초기화하여
+재정의하지 않습니다. 하지만 이를 true로 설정하면, 이전의 모든 값을
기본 값으로 재정의하게 됩니다.
기본 설정 헤더 사용하기
-
드문 경우지만 설정을 디자인할 때 첫 화면에는
-보조 화면 목록만 표시하도록 하고자 할 수도 있습니다(예: 시스템 설정 앱,
-그림 4와 5 참조). 그러한 디자인을 Android 3.0 이상을 대상으로 개발하는 경우, Android 3.0에 있는
-새로운 "헤더" 기능을 사용해야 합니다. 이것이 중첩된
+
드문 경우지만 설정을 디자인할 때 첫 화면에는
+보조 화면 목록만 표시하도록 하고자 할 수도 있습니다(예: 시스템 설정 앱,
+그림 4와 5 참조). 그러한 디자인을 Android 3.0 이상을 대상으로 개발하는 경우, Android 3.0에 있는
+새로운 "헤더" 기능을 사용해야 합니다. 이것이 중첩된
{@link android.preference.PreferenceScreen} 요소를 사용하여 보조 화면을 구축하는 방안을 대신합니다.
헤더를 사용하여 설정을 구축하려면 다음과 같이 해야 합니다.
각 설정 그룹을 별개의 {@link
-android.preference.PreferenceFragment} 인스턴스로 구분합니다. 다시 말해, 설정 그룹마다 별도의 XML 파일이 하나씩 있어야 한다는
+android.preference.PreferenceFragment} 인스턴스로 구분합니다. 다시 말해, 설정 그룹마다 별도의 XML 파일이 하나씩 있어야 한다는
뜻입니다.
-
각 설정 그룹을 목록으로 나열하는 XML 헤더 파일을 생성하고 어느 프래그먼트에
+
각 설정 그룹을 목록으로 나열하는 XML 헤더 파일을 생성하고 어느 프래그먼트에
상응하는 설정 목록이 들어있는지 선언합니다.
{@link android.preference.PreferenceActivity} 클래스를 확장하여 설정을 호스팅하도록 합니다.
{@link
-android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()} 콜백을 구현하여 헤더 파일을
+android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()} 콜백을 구현하여 헤더 파일을
나타냅니다.
-
이 디자인을 사용하는 데 있어 커다란 이점은 {@link android.preference.PreferenceActivity}가
+
이 디자인을 사용하는 데 있어 커다란 이점은 {@link android.preference.PreferenceActivity}가
(앱이) 대형 화면에서 실행될 때 그림 4에서 나타낸 것과 같이 창 두 개짜리 레이아웃을 자동으로 표시한다는 것입니다.
-
애플리케이션이 Android 3.0 이전 버전을 지원한다 하더라도 애플리케이션이
-{@link android.preference.PreferenceFragment}를 사용하여
-신형 기기에서 창 두 개짜리 표시를 지원하도록 하면서도 구형 기기에서는 일반적인 다중 화면 계층을
-여전히 지원하도록 할 수도 있습니다(기본 설정 헤더로
+
그림 4. 헤더가 있는 창 두 개짜리 레이아웃입니다. 1. 헤더는
-XML 헤더 파일로 정의됩니다. 2. 각 설정 그룹은
-{@link android.preference.PreferenceFragment}가 정의하며, 이는 헤더 파일에 있는 {@code <header>} 요소가
+
그림 4. 헤더가 있는 창 두 개짜리 레이아웃입니다. 1. 헤더는
+XML 헤더 파일로 정의됩니다. 2. 각 설정 그룹은
+{@link android.preference.PreferenceFragment}가 정의하며, 이는 헤더 파일에 있는 {@code <header>} 요소가
지정합니다.
-
그림 5. 설정 헤더가 있는 핸드셋 기기입니다. 항목을 선택하면
-연관된 {@link android.preference.PreferenceFragment}가 헤더를
+
그림 5. 설정 헤더가 있는 핸드셋 기기입니다. 항목을 선택하면
+연관된 {@link android.preference.PreferenceFragment}가 헤더를
대체합니다.
헤더 파일 만들기
-
헤더 목록에 있는 각 설정 그룹은 루트 {@code <preference-headers>}
+
헤더 목록에 있는 각 설정 그룹은 루트 {@code <preference-headers>}
요소 안에 있는 {@code <header>} 요소 하나로 나타냅니다. 예:
<?xml version="1.0" encoding="utf-8"?>
<preference-headers xmlns:android="http://schemas.android.com/apk/res/android">
- <header
+ <header
android:fragment="com.example.prefs.SettingsActivity$SettingsFragmentOne"
android:title="@string/prefs_category_one"
android:summary="@string/prefs_summ_category_one" />
- <header
+ <header
android:fragment="com.example.prefs.SettingsActivity$SettingsFragmentTwo"
android:title="@string/prefs_category_two"
android:summary="@string/prefs_summ_category_two" >
@@ -607,12 +607,12 @@ android.preference.PreferenceFragment} 예를 선언하며 이는 사용자가
{@code <extras>} 요소를 사용하면 키-값 쌍을 {@link
android.os.Bundle} 내의 프래그먼트에 전달할 수 있게 해줍니다. 이 프래그먼트가 인수를 검색하려면 {@link
-android.app.Fragment#getArguments()}를 호출하면 됩니다. 인수를 프래그먼트에 전달하는 데에는 여러 가지 이유가 있을 수 있지만,
+android.app.Fragment#getArguments()}를 호출하면 됩니다. 인수를 프래그먼트에 전달하는 데에는 여러 가지 이유가 있을 수 있지만,
한 가지 중요한 이유를 예로 들면 각 그룹에 대해 {@link
-android.preference.PreferenceFragment}의 같은 하위 클래스를 재사용하고, 이 인수를 사용하여 해당 프래그먼트가 로딩해야 하는
+android.preference.PreferenceFragment}의 같은 하위 클래스를 재사용하고, 이 인수를 사용하여 해당 프래그먼트가 로딩해야 하는
기본 설정 XML 파일이 무엇인지 나타낼 수 있다는 점입니다.
-
예를 들어 다음은 여러 가지 설정 그룹에 재사용할 수 있는 프래그먼트입니다. 이것은
+
예를 들어 다음은 여러 가지 설정 그룹에 재사용할 수 있는 프래그먼트입니다. 이것은
각 헤더가 {@code "settings"} 키로 {@code <extra>} 인수를 정의하는 경우를 나타낸 것입니다.
@@ -636,7 +636,7 @@ public static class SettingsFragment extends PreferenceFragment {
참고: 기본 설정 헤더를 사용하는 경우, {@link
android.preference.PreferenceActivity}의 하위 클래스가 {@link
-android.preference.PreferenceActivity#onCreate onCreate()} 메서드를 구현하지 않아도 됩니다. 액티비티에 대한 필수 작업은
+android.preference.PreferenceActivity#onCreate onCreate()} 메서드를 구현하지 않아도 됩니다. 액티비티에 대한 필수 작업은
헤더를 로딩하는 것뿐이기 때문입니다.
기본 설정 헤더로 이전 버전 지원하기
-
애플리케이션이 Android 3.0 이전 버전을 지원하는 경우에도 여전히 헤더를 사용하여
-Android 3.0 이상에서 창 두 개짜리 레이아웃을 제공하도록 할 수 있습니다. 개발자가 해야 할 일은 추가로 기본 설정 XML 파일을
+
애플리케이션이 Android 3.0 이전 버전을 지원하는 경우에도 여전히 헤더를 사용하여
+Android 3.0 이상에서 창 두 개짜리 레이아웃을 제공하도록 할 수 있습니다. 개발자가 해야 할 일은 추가로 기본 설정 XML 파일을
생성하는 것뿐입니다. 이 파일은 마치 헤더 항목처럼 동작하는 기본적인 {@link android.preference.Preference
-<Preference>} 요소를 사용합니다(이것을 이전 Android 버전이 사용하도록
+<Preference>} 요소를 사용합니다(이것을 이전 Android 버전이 사용하도록
할 예정).
하지만 새로운 {@link android.preference.PreferenceScreen}을 여는 대신 각 {@link
-android.preference.Preference <Preference>} 요소가 {@link android.content.Intent}를 하나씩
-{@link android.preference.PreferenceActivity}에 전송합니다. 이것이 로딩할 XML 파일이 무엇인지를
+android.preference.Preference <Preference>} 요소가 {@link android.content.Intent}를 하나씩
+{@link android.preference.PreferenceActivity}에 전송합니다. 이것이 로딩할 XML 파일이 무엇인지를
나타냅니다.
-
예를 들어 다음은 Android 3.0 이상에서 사용되는 기본 설정 헤더에 대한
-XML 파일입니다({@code res/xml/preference_headers.xml}).
+
예를 들어 다음은 Android 3.0 이상에서 사용되는 기본 설정 헤더에 대한
+XML 파일입니다({@code res/xml/preference_headers.xml}).
{@code <preference-headers>}에 대한 지원이 Android 3.0에서 추가되었기 때문에 시스템이
+
{@code <preference-headers>}에 대한 지원이 Android 3.0에서 추가되었기 때문에 시스템이
{@link android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()}를 {@link
-android.preference.PreferenceActivity}에서 호출하는 것은 Android 3.0 이상에서 실행될 때뿐입니다. "레거시" 헤더 파일을
-로딩하려면({@code preference_headers_legacy.xml}) 반드시 Android
+android.preference.PreferenceActivity}에서 호출하는 것은 Android 3.0 이상에서 실행될 때뿐입니다. "레거시" 헤더 파일을
+로딩하려면({@code preference_headers_legacy.xml}) 반드시 Android
버전을 확인해야 하며, 해당 버전이 Android 3.0 이전인 경우({@link
android.os.Build.VERSION_CODES#HONEYCOMB}), {@link
-android.preference.PreferenceActivity#addPreferencesFromResource addPreferencesFromResource()}를 호출하여
+android.preference.PreferenceActivity#addPreferencesFromResource addPreferencesFromResource()}를 호출하여
레거시 헤더 파일을 로딩해야 합니다. 예:
@@ -739,8 +739,8 @@ public void onBuildHeaders(List<Header> target) {
}
-
이제 남은 할 일이라고는 {@link android.content.Intent}를 처리하는 것뿐입니다. 이것은
-액티비티로 전달되어 어느 기본 설정 파일을 로딩해야 하는지 식별하는 데 쓰입니다. 그럼 이제 인텐트의 작업을 검색하여 기본 설정 XML의
+
이제 남은 할 일이라고는 {@link android.content.Intent}를 처리하는 것뿐입니다. 이것은
+액티비티로 전달되어 어느 기본 설정 파일을 로딩해야 하는지 식별하는 데 쓰입니다. 그럼 이제 인텐트의 작업을 검색하여 기본 설정 XML의
{@code <intent>} 태그에서 사용한 알려진 작업 문자열에 비교해보겠습니다.
@@ -765,8 +765,8 @@ public void onCreate(Bundle savedInstanceState) {
{@link
-android.preference.PreferenceActivity#addPreferencesFromResource addPreferencesFromResource()}를 연이어 호출하면
-모든 기본 설정을 하나의 목록에 쌓게 된다는 점을 유의하십시오. 따라서 이것은 'Else-if' 문이 있는 조건을 변경하여 딱 한 번만
+android.preference.PreferenceActivity#addPreferencesFromResource addPreferencesFromResource()}를 연이어 호출하면
+모든 기본 설정을 하나의 목록에 쌓게 된다는 점을 유의하십시오. 따라서 이것은 'Else-if' 문이 있는 조건을 변경하여 딱 한 번만
호출하도록 주의해야 합니다.
기본적으로 앱의 기본 설정은 모두
애플리케이션 내의 어디서든 정적 메서드 {@link
android.preference.PreferenceManager#getDefaultSharedPreferences
PreferenceManager.getDefaultSharedPreferences()}를 호출하면 액세스할 수 있는 파일에 저장됩니다. 이것은 {@link
android.content.SharedPreferences} 객체를 반환하며, 여기에 {@link
-android.preference.PreferenceActivity}에서 사용한 {@link android.preference.Preference} 객체와
+android.preference.PreferenceActivity}에서 사용한 {@link android.preference.Preference} 객체와
연관된 모든 키-값 쌍이 들어있습니다.
-
예를 들어 다음은 기본 설정 값 중 하나를 애플리케이션 내의 다른 모든 액티비티에서 읽는 방법을
+
예를 들어 다음은 기본 설정 값 중 하나를 애플리케이션 내의 다른 모든 액티비티에서 읽는 방법을
나타낸 것입니다.
사용자가 기본 설정 중 하나를 변경하자마자 이에 대해 알림을 받는 것이 좋은 데에는 몇 가지
-이유가 있습니다. 기본 설정 중 어느 하나에라도 변경이 발생했을 때 콜백을 받으려면,
+
사용자가 기본 설정 중 하나를 변경하자마자 이에 대해 알림을 받는 것이 좋은 데에는 몇 가지
+이유가 있습니다. 기본 설정 중 어느 하나에라도 변경이 발생했을 때 콜백을 받으려면,
{@link android.content.SharedPreferences.OnSharedPreferenceChangeListener
-SharedPreference.OnSharedPreferenceChangeListener} 인터페이스를 구현하고
+SharedPreference.OnSharedPreferenceChangeListener} 인터페이스를 구현하고
{@link android.content.SharedPreferences} 객체에 대한 수신기를 등록합니다. 이때 {@link
android.content.SharedPreferences#registerOnSharedPreferenceChangeListener
registerOnSharedPreferenceChangeListener()}를 호출하면 됩니다.
이 인터페이스에는 콜백 메서드가 {@link
android.content.SharedPreferences.OnSharedPreferenceChangeListener#onSharedPreferenceChanged
-onSharedPreferenceChanged()} 하나뿐이며, 인터페이스를 액티비티의 일부분으로 구현하는 것이
+onSharedPreferenceChanged()} 하나뿐이며, 인터페이스를 액티비티의 일부분으로 구현하는 것이
가장 쉬운 방법일 공산이 큽니다. 예:
@@ -825,19 +825,19 @@ public class SettingsActivity extends PreferenceActivity
}
-
이 예시에서 메서드는 변경된 설정이 알려진 기본 설정 키에 대한 것인지 여부를 확인합니다. 이것은
-{@link android.preference.PreferenceActivity#findPreference findPreference()}를 호출하여
-변경된 {@link android.preference.Preference} 객체를 가져오는데, 이렇게 해야 항목의 요약을 수정하여
+
이 예시에서 메서드는 변경된 설정이 알려진 기본 설정 키에 대한 것인지 여부를 확인합니다. 이것은
+{@link android.preference.PreferenceActivity#findPreference findPreference()}를 호출하여
+변경된 {@link android.preference.Preference} 객체를 가져오는데, 이렇게 해야 항목의 요약을 수정하여
사용자의 선택에 대한 설명이 되도록 할 수 있습니다. 다시 말해, 설정이 {@link
android.preference.ListPreference} 또는 다른 다중 선택 설정인 경우, 설정이 변경되어 현재 상태를 표시하도록 하면 {@link
-android.preference.Preference#setSummary setSummary()}를 호출해야 한다는 뜻입니다(예를 들어
+android.preference.Preference#setSummary setSummary()}를 호출해야 한다는 뜻입니다(예를 들어
그림 5에 표시된 절전 모드 설정과 같음).
-
참고: Android 디자인 문서의 설정 관련 내용에서 설명한 바와 같이, 사용자가 기본 설정을 변경할 때마다
-{@link android.preference.ListPreference}의 요약을 업데이트하는 것을 권장합니다. 이렇게 하여 현재 설정을
+
참고: Android 디자인 문서의 설정 관련 내용에서 설명한 바와 같이, 사용자가 기본 설정을 변경할 때마다
+{@link android.preference.ListPreference}의 요약을 업데이트하는 것을 권장합니다. 이렇게 하여 현재 설정을
나타내는 것입니다.
-
액티비티에서 적절한 수명 주기 관리를 수행하려면
+
액티비티에서 적절한 수명 주기 관리를 수행하려면
{@link android.content.SharedPreferences.OnSharedPreferenceChangeListener}를 등록하고 등록 해제하는 작업은 각각 {@link
android.app.Activity#onResume} 및 {@link android.app.Activity#onPause} 콜백 중에 수행하는 것을 권장합니다.
@@ -859,14 +859,14 @@ protected void onPause() {
주의: {@link
android.content.SharedPreferences#registerOnSharedPreferenceChangeListener
-registerOnSharedPreferenceChangeListener()}를 호출하면
-현재의 경우, 기본 설정 관리자가 수신기에 대한 강력한 참조를 저장하지 않습니다. 반드시 수신기에 대한 강력한
-참조를 저장해야 합니다. 그렇지 않으면 가비지 수집의 대상이 될 가능성이 높습니다. 권장 사항으로는
-수신기를 객체의 인스턴스 데이터 안에 보관하는 것을 추천합니다. 이 객체는
+registerOnSharedPreferenceChangeListener()}를 호출하면
+현재의 경우, 기본 설정 관리자가 수신기에 대한 강력한 참조를 저장하지 않습니다. 반드시 수신기에 대한 강력한
+참조를 저장해야 합니다. 그렇지 않으면 가비지 수집의 대상이 될 가능성이 높습니다. 권장 사항으로는
+수신기를 객체의 인스턴스 데이터 안에 보관하는 것을 추천합니다. 이 객체는
수신기를 필요로 하는 기간만큼 오래 존재할 것이 확실해야 합니다.
-
예를 들어 다음 코드에서 발신자는 수신기에 대한 참조를
-보관하지 않습니다. 그 결과 해당 수신기가 가비지 수집의 대상이 되며
+
예를 들어 다음 코드에서 발신자는 수신기에 대한 참조를
+보관하지 않습니다. 그 결과 해당 수신기가 가비지 수집의 대상이 되며
향후 언젠가 알 수 없는 시점에 고장을 일으키게 될 것입니다.
Android 4.0부터 시스템의 설정 애플리케이션을 사용하면 사용자가
-애플리케이션이 전경과 배경에 있는 동안 각각 얼마나 많은 네트워크 데이터를 사용하는지 알아볼 수 있게 되었습니다. 그런 다음
-사용자는 각각의 앱에 대해 배경 데이터 사용을 비활성화할 수 있습니다. 사용자가 여러분의 앱이 배경에서
-데이터에 액세스하는 기능을 비활성화하는 사태를 피하려면 데이터 연결을 효율적으로 사용하고
+
Android 4.0부터 시스템의 설정 애플리케이션을 사용하면 사용자가
+애플리케이션이 전경과 배경에 있는 동안 각각 얼마나 많은 네트워크 데이터를 사용하는지 알아볼 수 있게 되었습니다. 그런 다음
+사용자는 각각의 앱에 대해 배경 데이터 사용을 비활성화할 수 있습니다. 사용자가 여러분의 앱이 배경에서
+데이터에 액세스하는 기능을 비활성화하는 사태를 피하려면 데이터 연결을 효율적으로 사용하고
사용자가 애플리케이션 설정을 통하여 앱의 데이터 사용량을 미세 조정할 수 있도록 허용해야 합니다.
-
예를 들어 사용자에게 앱의 데이터 동기화 빈도를 제어하도록 허용할 수 있습니다. 앱이 Wi-Fi에 있을 때에만
-업로드/다운로드를 수행하도록 할지 여부, 앱이 로밍 중에 데이터를 사용하도록 할지 여부 등을 이렇게 조절합니다. 사용자가
-이러한 제어 기능을 사용할 수 있게 되면 시스템 설정에서 설정한 한도에 가까워지고
-있을 때 앱의 데이터 액세스를 비활성화할 가능성이 낮아집니다. 그 대신 앱이 사용하는 데이터 양을
+
예를 들어 사용자에게 앱의 데이터 동기화 빈도를 제어하도록 허용할 수 있습니다. 앱이 Wi-Fi에 있을 때에만
+업로드/다운로드를 수행하도록 할지 여부, 앱이 로밍 중에 데이터를 사용하도록 할지 여부 등을 이렇게 조절합니다. 사용자가
+이러한 제어 기능을 사용할 수 있게 되면 시스템 설정에서 설정한 한도에 가까워지고
+있을 때 앱의 데이터 액세스를 비활성화할 가능성이 낮아집니다. 그 대신 앱이 사용하는 데이터 양을
정밀하게 제어할 수 있기 때문입니다.
-
일단 필요한 기본 설정을 {@link android.preference.PreferenceActivity}에
+
일단 필요한 기본 설정을 {@link android.preference.PreferenceActivity}에
추가하여 앱의 데이터 습관을 제어하도록 했으면, 다음으로 매니페스트 파일에 있는 {@link
android.content.Intent#ACTION_MANAGE_NETWORK_USAGE}에 대한 인텐트 필터를 추가해야 합니다. 예:
@@ -920,10 +920,10 @@ android.content.Intent#ACTION_MANAGE_NETWORK_USAGE}에 대한 인텐트 필터
</activity>
-
이 인텐트 필터는 이것이 애플리케이션의 데이터 사용량을 제어하는 액티비티라는
-사실을 시스템에 나타내는 역할을 합니다. 따라서, 사용자가 시스템의 설정 앱에서 여러분의 앱이
-얼마나 많은 데이터를 사용하는지 알아볼 때면 애플리케이션 설정 보기 버튼을 사용할 수 있어
-{@link android.preference.PreferenceActivity}를 시작하게 됩니다. 그러면 사용자는
+
이 인텐트 필터는 이것이 애플리케이션의 데이터 사용량을 제어하는 액티비티라는
+사실을 시스템에 나타내는 역할을 합니다. 따라서, 사용자가 시스템의 설정 앱에서 여러분의 앱이
+얼마나 많은 데이터를 사용하는지 알아볼 때면 애플리케이션 설정 보기 버튼을 사용할 수 있어
+{@link android.preference.PreferenceActivity}를 시작하게 됩니다. 그러면 사용자는
앱이 사용할 데이터 양을 미세하게 조정할 수 있습니다.
@@ -934,22 +934,22 @@ android.content.Intent#ACTION_MANAGE_NETWORK_USAGE}에 대한 인텐트 필터
사용자 지정 기본 설정 구축하기
-
Android 프레임워크에는 다양한 {@link android.preference.Preference} 하위 클래스가 포함되어 있어
-여러 가지 설정 유형에 맞게 UI를 구축할 수 있습니다.
-하지만, 기본 제공 솔루션이 없는 설정이 필요하게 되는 경우도 있습니다. 예를 들어 숫자 선택기 또는
-날짜 선택기 등이 이에 해당됩니다. 그러한 경우에는 사용자 지정 기본 설정을 만들어야 합니다. 이때
+
Android 프레임워크에는 다양한 {@link android.preference.Preference} 하위 클래스가 포함되어 있어
+여러 가지 설정 유형에 맞게 UI를 구축할 수 있습니다.
+하지만, 기본 제공 솔루션이 없는 설정이 필요하게 되는 경우도 있습니다. 예를 들어 숫자 선택기 또는
+날짜 선택기 등이 이에 해당됩니다. 그러한 경우에는 사용자 지정 기본 설정을 만들어야 합니다. 이때
{@link android.preference.Preference} 클래스 또는 다른 하위 클래스 중 하나를 확장하는 방법을 씁니다.
-
{@link android.preference.Preference} 클래스를 확장하는 경우, 다음과 같이
+
{@link android.preference.Preference} 클래스를 확장하는 경우, 다음과 같이
몇 가지 중요한 해야 할 일이 있습니다.
사용자가 설정을 선택하면 나타나는 사용자 인터페이스를 지정합니다.
필요에 따라 설정의 값을 저장합니다.
-
{@link android.preference.Preference}가 보이게 되면
+
{@link android.preference.Preference}가 보이게 되면
이를 현재(또는 기본) 값으로 초기화합니다.
시스템이 요청하는 경우 기본 값을 제공합니다.
-
{@link android.preference.Preference}가 나름의 UI(예: 대화)를 제공하는 경우, 상태를
+
{@link android.preference.Preference}가 나름의 UI(예: 대화)를 제공하는 경우, 상태를
저장하고 복원하여 수명 주기 변경을 처리할 수 있도록 합니다(예: 사용자가 화면을 돌리는 경우).
@@ -959,27 +959,27 @@ android.content.Intent#ACTION_MANAGE_NETWORK_USAGE}에 대한 인텐트 필터
사용자 인터페이스 지정하기
-
{@link android.preference.Preference} 클래스를 직접 확장하는 경우,
-{@link android.preference.Preference#onClick()}을 구현하여 사용자가
-항목을 선택할 때 일어날 동작을 정의해야 합니다. 그러나, 대부분의 사용자 지정 설정은 {@link android.preference.DialogPreference}를 확장하여
+
{@link android.preference.Preference} 클래스를 직접 확장하는 경우,
+{@link android.preference.Preference#onClick()}을 구현하여 사용자가
+항목을 선택할 때 일어날 동작을 정의해야 합니다. 그러나, 대부분의 사용자 지정 설정은 {@link android.preference.DialogPreference}를 확장하여
대화를 표시하도록 합니다. 이렇게 하면 절차가 단순해집니다. {@link
android.preference.DialogPreference}를 확장하는 경우에는 클래스 생성자 중에 반드시 {@link
-android.preference.DialogPreference#setDialogLayoutResource setDialogLayoutResourcs()}를 호출하여
+android.preference.DialogPreference#setDialogLayoutResource setDialogLayoutResourcs()}를 호출하여
대화에 대한 레이아웃을 지정해야 합니다.
예를 들어 다음은 레이아웃을 선언하는 사용자 지정 {@link
-android.preference.DialogPreference}와 기본
+android.preference.DialogPreference}와 기본
긍정적 및 부정적 대화 버튼에 대한 텍스트를 지정하는 생성자입니다.
public class NumberPickerPreference extends DialogPreference {
public NumberPickerPreference(Context context, AttributeSet attrs) {
super(context, attrs);
-
+
setDialogLayoutResource(R.layout.numberpicker_dialog);
setPositiveButtonText(android.R.string.ok);
setNegativeButtonText(android.R.string.cancel);
-
+
setDialogIcon(null);
}
...
@@ -992,21 +992,21 @@ public class NumberPickerPreference extends DialogPreference {
설정에 대한 값은 언제든 저장할 수 있습니다. {@link
android.preference.Preference} 클래스의 {@code persist*()} 메서드 중 하나를 호출하기만 하면 됩니다. 예를 들어 설정의 값이 정수인 경우 {@link
-android.preference.Preference#persistInt persistInt()}를, 부울을 저장하려면
+android.preference.Preference#persistInt persistInt()}를, 부울을 저장하려면
{@link android.preference.Preference#persistBoolean persistBoolean()}을 호출하십시오.
-
참고: 각각의 {@link android.preference.Preference}는 데이터 유형 하나씩만
-저장할 수 있으므로, 사용자 지정
+
참고: 각각의 {@link android.preference.Preference}는 데이터 유형 하나씩만
+저장할 수 있으므로, 사용자 지정
{@link android.preference.Preference}에서 사용한 데이터 유형에 적절한 {@code persist*()} 메서드를 사용해야 합니다.
설정을 유지하기로 선택하는 시점은 확장하는 지점이 {@link
android.preference.Preference} 클래스인지에 좌우될 수 있습니다. {@link
-android.preference.DialogPreference}를 확장하면 값을 유지하는 것은 대화가 긍정적인 결과로 인해
+android.preference.DialogPreference}를 확장하면 값을 유지하는 것은 대화가 긍정적인 결과로 인해
닫히는 경우만으로 국한해야 합니다(사용자가 "확인(OK)" 버튼을 선택하는 경우).
{@link android.preference.DialogPreference}가 닫히면 시스템이 {@link
-android.preference.DialogPreference#onDialogClosed onDialogClosed()} 메서드를 호출합니다. 이 메서드에는
-부울 인수가 포함되어 있어 사용자의 결과가 "긍정적"인지 아닌지를 나타냅니다. 이 값이
+android.preference.DialogPreference#onDialogClosed onDialogClosed()} 메서드를 호출합니다. 이 메서드에는
+부울 인수가 포함되어 있어 사용자의 결과가 "긍정적"인지 아닌지를 나타냅니다. 이 값이
true인 경우, 사용자가 긍정적 버튼을 선택한 것이고 새 값을 저장해야 합니다. 예:
이 예시에서 mNewValue는 설정의 현재 값을 보유한 클래스
-구성원입니다. {@link android.preference.Preference#persistInt persistInt()}를 호출하면
-{@link android.content.SharedPreferences} 파일에 대한 값을 저장합니다(이
+
이 예시에서 mNewValue는 설정의 현재 값을 보유한 클래스
+구성원입니다. {@link android.preference.Preference#persistInt persistInt()}를 호출하면
+{@link android.content.SharedPreferences} 파일에 대한 값을 저장합니다(이
{@link android.preference.Preference}에 대하여 XML 파일에 지정된 키를 자동으로 사용합니다).
현재 값 초기화하기
-
시스템이 {@link android.preference.Preference}를 화면에 추가하는 경우, 이는
-{@link android.preference.Preference#onSetInitialValue onSetInitialValue()}를 호출하여
-설정에 유지된 값이 있는지 없는지를 알립니다. 유지된 값이 없는 경우, 이 호출은 기본 값을
+
시스템이 {@link android.preference.Preference}를 화면에 추가하는 경우, 이는
+{@link android.preference.Preference#onSetInitialValue onSetInitialValue()}를 호출하여
+설정에 유지된 값이 있는지 없는지를 알립니다. 유지된 값이 없는 경우, 이 호출은 기본 값을
제공합니다.
-
{@link android.preference.Preference#onSetInitialValue onSetInitialValue()} 메서드는
-부울 값 restorePersistedValue를 전달하여 해당 설정에 대해 이미 어떤 값이 유지되었는지
-아닌지를 나타냅니다. 만일 이것이 true라면, 유지된 값을 검색하되
+
{@link android.preference.Preference#onSetInitialValue onSetInitialValue()} 메서드는
+부울 값 restorePersistedValue를 전달하여 해당 설정에 대해 이미 어떤 값이 유지되었는지
+아닌지를 나타냅니다. 만일 이것이 true라면, 유지된 값을 검색하되
{@link
android.preference.Preference} 클래스의 {@code getPersisted*()} 메서드 중 하나를 호출하는 방법을 써야 합니다. 예를 들어 정수 값이라면 {@link
-android.preference.Preference#getPersistedInt getPersistedInt()}를 사용합니다. 보통은
-유지된 값을 검색하여, UI에 이전에 저장된 값을 반영하여 이를 적절하게 업데이트할 수
+android.preference.Preference#getPersistedInt getPersistedInt()}를 사용합니다. 보통은
+유지된 값을 검색하여, UI에 이전에 저장된 값을 반영하여 이를 적절하게 업데이트할 수
있도록 하는 것이 좋습니다.
-
restorePersistedValue가 false인 경우,
+
restorePersistedValue가 false인 경우,
두 번째 인수로 전달된 기본 값을 사용해야 합니다.
각 {@code getPersisted*()} 메서드는 기본 값을 나타내는 인수를 취하여
-사실은 유지된 값이 전혀 없거나 키 자체가 존재하지 않는 경우 사용하도록 합니다. 위의
+
각 {@code getPersisted*()} 메서드는 기본 값을 나타내는 인수를 취하여
+사실은 유지된 값이 전혀 없거나 키 자체가 존재하지 않는 경우 사용하도록 합니다. 위의
예시에서는 혹시 {@link
android.preference.Preference#getPersistedInt getPersistedInt()}가 유지된 값을 반환할 수 없는 경우에 사용하도록 기본 값을 나타내는 데 로컬 상수를 사용하였습니다.
-
주의: {@code getPersisted*()} 메서드에서는
-defaultValue를 기본 값으로 사용하면 안 됩니다. 이것의 값은
+
주의: {@code getPersisted*()} 메서드에서는
+defaultValue를 기본 값으로 사용하면 안 됩니다. 이것의 값은
restorePersistedValue가 true이면 항상 null이기 때문입니다.
기본 값 제공하기
{@link android.preference.Preference} 클래스의 인스턴스가 기본 값을 나타내는 경우
-({@code android:defaultValue} 속성으로), 시스템은
+({@code android:defaultValue} 속성으로), 시스템은
값을 검색하기 위해 객체를 인스턴트화할 때 {@link android.preference.Preference#onGetDefaultValue
-onGetDefaultValue()}를 호출합니다. 이 메서드를 구현해야
+onGetDefaultValue()}를 호출합니다. 이 메서드를 구현해야
시스템이 {@link
android.content.SharedPreferences}에 있는 기본 값을 저장할 수 있습니다. 예:
@@ -1085,9 +1085,9 @@ protected Object onGetDefaultValue(TypedArray a, int index) {
}
-
이 메서드 인수가 여러분에게 필요한 모든 것을 제공합니다. 즉 속성 배열과
-{@code android:defaultValue}의 위치로, 이는 반드시 검색해야 합니다. 이 메서드를
-반드시 구현하여 속성에서 기본 값을 추출해야만 하는 이유는 값이 정의되지 않은 경우, 속성에 대한
+
이 메서드 인수가 여러분에게 필요한 모든 것을 제공합니다. 즉 속성 배열과
+{@code android:defaultValue}의 위치로, 이는 반드시 검색해야 합니다. 이 메서드를
+반드시 구현하여 속성에서 기본 값을 추출해야만 하는 이유는 값이 정의되지 않은 경우, 속성에 대한
로컬 기본 값을 꼭 지정해야 하기 때문입니다.
@@ -1095,25 +1095,25 @@ protected Object onGetDefaultValue(TypedArray a, int index) {
기본 설정의 상태 저장 및 복원하기
레이아웃에서의 {@link android.view.View}와 마찬가지로 {@link android.preference.Preference}
-하위 클래스가 액티비티 또는 프래그먼트가 재시작했을 때
-그 상태를 저장하고 복원하는 역할을 맡습니다(예를 들어 사용자가 화면을 돌리는 경우 등).
-{@link android.preference.Preference} 클래스의 상태를 적절하게 저장하고 복원하려면,
+하위 클래스가 액티비티 또는 프래그먼트가 재시작했을 때
+그 상태를 저장하고 복원하는 역할을 맡습니다(예를 들어 사용자가 화면을 돌리는 경우 등).
+{@link android.preference.Preference} 클래스의 상태를 적절하게 저장하고 복원하려면,
수명 주기 콜백 메서드 {@link android.preference.Preference#onSaveInstanceState
onSaveInstanceState()} 및 {@link
android.preference.Preference#onRestoreInstanceState onRestoreInstanceState()}를 구현해야 합니다.
-
{@link android.preference.Preference}의 상태를 정의하는 것은
-{@link android.os.Parcelable} 인터페이스를 구현하는 객체입니다. Android 프레임워크는
+
{@link android.preference.Preference}의 상태를 정의하는 것은
+{@link android.os.Parcelable} 인터페이스를 구현하는 객체입니다. Android 프레임워크는
그러한 객체를 제공하여 상태 객체를 정의하는 데 일종의 시작 지점으로 사용하도록 하고 있습니다. 즉 {@link
android.preference.Preference.BaseSavedState} 클래스가 이에 해당됩니다.
-
{@link android.preference.Preference} 클래스가 자신의 상태를 저장하는 방법을 정의하려면
-{@link android.preference.Preference.BaseSavedState} 클래스를 확장해야 합니다. 아주 약간의 메서드를 재정의하고
+
{@link android.preference.Preference} 클래스가 자신의 상태를 저장하는 방법을 정의하려면
+{@link android.preference.Preference.BaseSavedState} 클래스를 확장해야 합니다. 아주 약간의 메서드를 재정의하고
{@link android.preference.Preference.BaseSavedState#CREATOR}
객체를 정의해야 합니다.
-
대부분의 앱에서는 다음과 같은 구현을 복사한 다음,
-{@code value}를 처리하는 줄만 변경하면 됩니다. 이는 {@link android.preference.Preference} 하위 클래스가 정수보다는 데이터
+
대부분의 앱에서는 다음과 같은 구현을 복사한 다음,
+{@code value}를 처리하는 줄만 변경하면 됩니다. 이는 {@link android.preference.Preference} 하위 클래스가 정수보다는 데이터
유형을 저장하는 경우 해당됩니다.
위의 {@link android.preference.Preference.BaseSavedState} 구현을 앱에
-추가하고 나면(주로 {@link android.preference.Preference} 하위 클래스의 하위 클래스로), 이제
+
위의 {@link android.preference.Preference.BaseSavedState} 구현을 앱에
+추가하고 나면(주로 {@link android.preference.Preference} 하위 클래스의 하위 클래스로), 이제
{@link android.preference.Preference#onSaveInstanceState
onSaveInstanceState()} 및 {@link
-android.preference.Preference#onRestoreInstanceState onRestoreInstanceState()} 메서드를 구현해야 합니다. 이것은
+android.preference.Preference#onRestoreInstanceState onRestoreInstanceState()} 메서드를 구현해야 합니다. 이것은
{@link android.preference.Preference} 하위 클래스를 위한 것입니다.
예:
@@ -1194,7 +1194,7 @@ protected void onRestoreInstanceState(Parcelable state) {
// Cast state to custom BaseSavedState and pass to superclass
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
-
+
// Set this Preference's widget to reflect the restored state
mNumberPicker.setValue(myState.value);
}
diff --git a/docs/html-intl/intl/ko/guide/topics/ui/ui-events.jd b/docs/html-intl/intl/ko/guide/topics/ui/ui-events.jd
index b059bd24de48a..427051c8ac24b 100644
--- a/docs/html-intl/intl/ko/guide/topics/ui/ui-events.jd
+++ b/docs/html-intl/intl/ko/guide/topics/ui/ui-events.jd
@@ -16,67 +16,67 @@ parent.link=index.html
-
Android에는 사용자와 애플리케이션의 상호 작용으로부터 이벤트를 가로채는 방법이 여러 가지 있습니다.
-사용자 인터페이스 내의 이벤트가 관련된 경우, 이러한 방식은 이벤트를 사용자가 상호 작용하는
+
Android에는 사용자와 애플리케이션의 상호 작용으로부터 이벤트를 가로채는 방법이 여러 가지 있습니다.
+사용자 인터페이스 내의 이벤트가 관련된 경우, 이러한 방식은 이벤트를 사용자가 상호 작용하는
특정 보기 객체로부터 캡처하는 것입니다. 이에 필요한 수단은 보기 클래스가 제공합니다.
-
레이아웃을 작성하는 데 사용하게 되는 여러 가지 보기 클래스 안을 보면 UI 이벤트에 유용해 보이는 공개 콜백
-메서드가 여러 개 있는 것이 눈에 띕니다. 이러한 메서드는 해당 객체에서 각각의 작업이 발생할 때 Android 프레임워크가
-호출하는 것입니다. 예를 들어 보기(예: 버튼)를 하나 터치하면
-해당 객체에서 onTouchEvent() 메서드가 호출됩니다. 그러나 이것을 가로채려면 클래스를 확장하고
-메서드를 재정의해야 합니다. 다만 그런 이벤트를 처리하기 위해 모든 보기 객체를
-다 확장하는 것은 타당성이 없습니다. 이 때문에 보기 클래스에
-일련의 중첩된 인터페이스가 있고 거기에 훨씬 쉽게 정의할 수 있는 콜백에 있습니다. 이와 같은
+
레이아웃을 작성하는 데 사용하게 되는 여러 가지 보기 클래스 안을 보면 UI 이벤트에 유용해 보이는 공개 콜백
+메서드가 여러 개 있는 것이 눈에 띕니다. 이러한 메서드는 해당 객체에서 각각의 작업이 발생할 때 Android 프레임워크가
+호출하는 것입니다. 예를 들어 보기(예: 버튼)를 하나 터치하면
+해당 객체에서 onTouchEvent() 메서드가 호출됩니다. 그러나 이것을 가로채려면 클래스를 확장하고
+메서드를 재정의해야 합니다. 다만 그런 이벤트를 처리하기 위해 모든 보기 객체를
+다 확장하는 것은 타당성이 없습니다. 이 때문에 보기 클래스에
+일련의 중첩된 인터페이스가 있고 거기에 훨씬 쉽게 정의할 수 있는 콜백에 있습니다. 이와 같은
인터페이스를 일명 이벤트 수신기라고 하는데, 이것이 UI와 사용자 상호 작용을 캡처하는 데 아주 적합합니다.
-
사용자 상호 작용을 수신 대기하는 데에는 이벤트 수신기를 사용하는 것이 좀 더 보편적이지만, 사용자 지정
-구성 요소를 구축하기 위해 보기 클래스를 확장하고자 하는 상황이 올 수도 있습니다.
+
사용자 상호 작용을 수신 대기하는 데에는 이벤트 수신기를 사용하는 것이 좀 더 보편적이지만, 사용자 지정
+구성 요소를 구축하기 위해 보기 클래스를 확장하고자 하는 상황이 올 수도 있습니다.
어쩌면 {@link android.widget.Button}
-클래스를 확장하여 무언가 더 복잡한 것을 만들고자 할 수도 있습니다. 이런 경우, 클래스에 대한 기본 이벤트 행동을 클래스
+클래스를 확장하여 무언가 더 복잡한 것을 만들고자 할 수도 있습니다. 이런 경우, 클래스에 대한 기본 이벤트 행동을 클래스
이벤트 처리기를 사용하여 정의할 수 있습니다.
이벤트 수신기
-
이벤트 수신기란 {@link android.view.View} 클래스 내에 있는 일종의 인터페이스로, 이 안에 하나의
-콜백 메서드가 들어있습니다. 이러한 메서드는 수신기가 등록된 보기가 UI 안의 항목과 사용자의 상호 작용으로 인하여 트리거되었을 때
+
이벤트 수신기란 {@link android.view.View} 클래스 내에 있는 일종의 인터페이스로, 이 안에 하나의
+콜백 메서드가 들어있습니다. 이러한 메서드는 수신기가 등록된 보기가 UI 안의 항목과 사용자의 상호 작용으로 인하여 트리거되었을 때
Android 프레임워크가 호출하는 것입니다.
이벤트 수신기 인터페이스에 포함된 콜백 메서드는 다음과 같습니다.
onClick()
-
{@link android.view.View.OnClickListener}에서 온 것입니다.
+
{@link android.view.View.OnClickListener}에서 온 것입니다.
이것이 호출되는 것은 사용자가 항목을 터치하거나
-(터치 모드에 있을 때), 탐색 키 또는 트랙볼을 사용하여 해당 항목에 초점을 맞추고 있으면서
+(터치 모드에 있을 때), 탐색 키 또는 트랙볼을 사용하여 해당 항목에 초점을 맞추고 있으면서
적절한 "엔터" 키를 누르거나 트랙볼을 꾹 누를 때입니다.
onLongClick()
-
{@link android.view.View.OnLongClickListener}에서 온 것입니다.
-이것이 호출되는 것은 사용자가 항목을 길게 누르거나(터치 모드에 있을 때),
-탐색 키 또는 트랙볼을 사용하여 해당 항목에 초점을 맞추고 있으면서
+
{@link android.view.View.OnLongClickListener}에서 온 것입니다.
+이것이 호출되는 것은 사용자가 항목을 길게 누르거나(터치 모드에 있을 때),
+탐색 키 또는 트랙볼을 사용하여 해당 항목에 초점을 맞추고 있으면서
적절한 "엔터" 키를 누르거나 트랙볼을 꾹 누를 때입니다(일 초간).
onFocusChange()
-
{@link android.view.View.OnFocusChangeListener}에서 온 것입니다.
+
{@link android.view.View.OnFocusChangeListener}에서 온 것입니다.
이것이 호출되는 것은 사용자가 탐색 키 또는 트랙볼을 사용하여 항목 쪽으로 이동하거나 항목에서 멀어질 때입니다.
onKey()
-
{@link android.view.View.OnKeyListener}에서 온 것입니다.
+
{@link android.view.View.OnKeyListener}에서 온 것입니다.
이것이 호출되는 것은 사용자가 항목에 초점을 맞추고 있으면서 기기에 있는 하드웨어 키를 누르거나 키에서 손을 떼는 경우입니다.
onTouch()
-
{@link android.view.View.OnTouchListener}에서 온 것입니다.
-이것이 호출되는 것은 사용자가 터치 이벤트로서의 자격을 만족하는 작업을 수행하는 경우로, 여기에
+
{@link android.view.View.OnTouchListener}에서 온 것입니다.
+이것이 호출되는 것은 사용자가 터치 이벤트로서의 자격을 만족하는 작업을 수행하는 경우로, 여기에
누르기, 손 떼기와 화면에서 이루어지는 모든 움직임 동작(항목의 경계 내에서)이 포함됩니다.
onCreateContextMenu()
-
{@link android.view.View.OnCreateContextMenuListener}에서 온 것입니다.
-이것을 호출하는 것은 컨텍스트 메뉴가 구축되는 중일 때입니다(정체된 "롱 클릭"의 결과로).
+
{@link android.view.View.OnCreateContextMenuListener}에서 온 것입니다.
+이것을 호출하는 것은 컨텍스트 메뉴가 구축되는 중일 때입니다(정체된 "롱 클릭"의 결과로).
메뉴
개발자 가이드에 있는 컨텍스트 메뉴 관련 논의를 참조하십시오.
-
이러한 메서드는 각자의 인터페이스 안에 거주하는 유일한 주민입니다. 이러한 메서드 중 하나를
-정의하고 이벤트를 처리하려면 액티비티 내의 중첩된 인터페이스를 구현하거나 익명의 클래스로 정의하면 됩니다.
-그런 다음 구현의 인스턴스 하나를
-각각의 View.set...Listener() 메서드에 전달하십시오 (예:
-{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}를
+
이러한 메서드는 각자의 인터페이스 안에 거주하는 유일한 주민입니다. 이러한 메서드 중 하나를
+정의하고 이벤트를 처리하려면 액티비티 내의 중첩된 인터페이스를 구현하거나 익명의 클래스로 정의하면 됩니다.
+그런 다음 구현의 인스턴스 하나를
+각각의 View.set...Listener() 메서드에 전달하십시오 (예:
+{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}를
호출한 다음 이를 {@link android.view.View.OnClickListener OnClickListener}의 구현에 전달합니다).
아래의 예시는 버튼에 대하여 온-클릭 수신기를 등록하는 방법을 나타낸 것입니다.
@@ -117,57 +117,57 @@ public class ExampleActivity extends Activity implements OnClickListener {
}
-
위의 예시에서 onClick() 콜백에는
-반환 값이 없지만 다른 이벤트 수신기 메서드 중에는 부울 값을 반환해야만 하는 것도 있다는 점을 유의하십시오. 그 이유는 이벤트에 따라
+
위의 예시에서 onClick() 콜백에는
+반환 값이 없지만 다른 이벤트 수신기 메서드 중에는 부울 값을 반환해야만 하는 것도 있다는 점을 유의하십시오. 그 이유는 이벤트에 따라
다릅니다. 이런 필수 사항이 적용되는 몇몇 메서드의 경우, 이유는 다음과 같습니다.
-
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} -
-이것은 부울 값을 반환하여 이벤트를 완전히 사용하였으며 더 이상 이를 담지 않아도 되는지 여부를 나타냅니다.
-다시 말해, 참을 반환하면 이벤트를 처리했으며 여기에서 중단해야 한다는 것을 의미하며
-거짓을 반환하면 이벤트가 아직 미처리 상태이며/거나 이 이벤트를 다른
-온-클릭 수신기로 계속 진행해야 할지 나타내는 것입니다.
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} -
이것은 부울 값을 반환하여 이벤트를 완전히 사용하였으며 더 이상 이를 담지 않아도 되는지 여부를 나타냅니다.
- 다시 말해, 참을 반환하면 이벤트를 처리했으며 여기에서 중단해야 한다는 것을 의미하며
-거짓을 반환하면 이벤트가 아직 미처리 상태이며/거나 이 이벤트를 다른
+다시 말해, 참을 반환하면 이벤트를 처리했으며 여기에서 중단해야 한다는 것을 의미하며
+거짓을 반환하면 이벤트가 아직 미처리 상태이며/거나 이 이벤트를 다른
+온-클릭 수신기로 계속 진행해야 할지 나타내는 것입니다.
+
{@link android.view.View.OnKeyListener#onKey(View,int,KeyEvent) onKey()} -
+이것은 부울 값을 반환하여 이벤트를 완전히 사용하였으며 더 이상 이를 담지 않아도 되는지 여부를 나타냅니다.
+ 다시 말해, 참을 반환하면 이벤트를 처리했으며 여기에서 중단해야 한다는 것을 의미하며
+거짓을 반환하면 이벤트가 아직 미처리 상태이며/거나 이 이벤트를 다른
온-키 수신기로 계속 진행해야 할지 나타내는 것입니다.
-
{@link android.view.View.OnTouchListener#onTouch(View,MotionEvent) onTouch()} -
-이것은 부울 값을 반환하여 수신기가 이 이벤트를 사용하는지 아닌지를 나타냅니다. 여기서 중요한 점은
-이 이벤트에는 서로 연달아 발생하는 여러 개의 작업이 있을 수 있다는 것입니다. 그러므로 '아래로' 작업 이벤트를 수신했을 때 거짓을 반환하면,
-해당 이벤트를 사용하지 않았으며 이 이벤트로부터 이어지는 이후의 작업에
-흥미가 없음을 나타내는 것이 됩니다. 따라서 이 이벤트 내의 다른 모든 작업에 대해
+
{@link android.view.View.OnTouchListener#onTouch(View,MotionEvent) onTouch()} -
+이것은 부울 값을 반환하여 수신기가 이 이벤트를 사용하는지 아닌지를 나타냅니다. 여기서 중요한 점은
+이 이벤트에는 서로 연달아 발생하는 여러 개의 작업이 있을 수 있다는 것입니다. 그러므로 '아래로' 작업 이벤트를 수신했을 때 거짓을 반환하면,
+해당 이벤트를 사용하지 않았으며 이 이벤트로부터 이어지는 이후의 작업에
+흥미가 없음을 나타내는 것이 됩니다. 따라서 이 이벤트 내의 다른 모든 작업에 대해
호출되지 않습니다(예: 손가락 동작 또는 최종적인 '위로' 작업 이벤트 등).
-
하드웨어 키 이벤트는 항상 현재 초점의 중심에 있는 보기로 전달된다는 점을 명심하십시오. 이들은 보기 계층의 맨 위에서 시작하여
-아래 방향으로 발송되어 적절한 목적지에 도달할 때까지 계속합니다. 보기(또는 보기의 하위)에
+
하드웨어 키 이벤트는 항상 현재 초점의 중심에 있는 보기로 전달된다는 점을 명심하십시오. 이들은 보기 계층의 맨 위에서 시작하여
+아래 방향으로 발송되어 적절한 목적지에 도달할 때까지 계속합니다. 보기(또는 보기의 하위)에
현재 초점이 맞춰져 있으면, 이벤트가 {@link android.view.View#dispatchKeyEvent(KeyEvent)
-dispatchKeyEvent()} 메서드를 통과하여 이동하는 것을 확인할 수 있습니다. 보기를 통해 키 이벤트를 캡처하는 대신, 액티비티 내부의 모든 이벤트를 {@link android.app.Activity#onKeyDown(int,KeyEvent) onKeyDown()}및
+dispatchKeyEvent()} 메서드를 통과하여 이동하는 것을 확인할 수 있습니다. 보기를 통해 키 이벤트를 캡처하는 대신, 액티비티 내부의 모든 이벤트를 {@link android.app.Activity#onKeyDown(int,KeyEvent) onKeyDown()}및
{@link android.app.Activity#onKeyUp(int,KeyEvent) onKeyUp()}을 사용하여 수신할 수도 있습니다.
-
또한, 애플리케이션에 대한 텍스트 입력의 경우 대다수의 기기에는 소프트웨어 입력 메서드만 있다는 사실을
-명심하십시오. 그러한 메서드는 반드시 키 기반이 아니어도 됩니다. 음성 입력, 손글씨 등을 사용하는 것도 있습니다. 입력
-메서드가 키보드 같은 인터페이스를 표시하더라도 일반적으로
-{@link android.app.Activity#onKeyDown(int,KeyEvent) onKeyDown()} 이벤트군을 트리거하지는 않습니다. 특정 키 누름을
-제어해야만 하는 UI는 절대 구축하면 안 됩니다. 이렇게 하면 애플리케이션이 하드웨어 키보드가 있는
-기기에만 한정됩니다. 특히, 사용자가 리턴 키를 누르면 입력의 유효성을 검사하는 데 이와 같은 메서드에
-의존해서는 안 됩니다. 대신, {@link android.view.inputmethod.EditorInfo#IME_ACTION_DONE}과 같은 작업을 사용하여 애플리케이션이 반응할 것으로 기대되는 방식에 해당되는
-입력 메서드를 신호하여 의미 있는 방식으로 UI를 변경할 수 있게 하는 것이 좋습니다. 소프트웨어 입력 메서드가
+
또한, 애플리케이션에 대한 텍스트 입력의 경우 대다수의 기기에는 소프트웨어 입력 메서드만 있다는 사실을
+명심하십시오. 그러한 메서드는 반드시 키 기반이 아니어도 됩니다. 음성 입력, 손글씨 등을 사용하는 것도 있습니다. 입력
+메서드가 키보드 같은 인터페이스를 표시하더라도 일반적으로
+{@link android.app.Activity#onKeyDown(int,KeyEvent) onKeyDown()} 이벤트군을 트리거하지는 않습니다. 특정 키 누름을
+제어해야만 하는 UI는 절대 구축하면 안 됩니다. 이렇게 하면 애플리케이션이 하드웨어 키보드가 있는
+기기에만 한정됩니다. 특히, 사용자가 리턴 키를 누르면 입력의 유효성을 검사하는 데 이와 같은 메서드에
+의존해서는 안 됩니다. 대신, {@link android.view.inputmethod.EditorInfo#IME_ACTION_DONE}과 같은 작업을 사용하여 애플리케이션이 반응할 것으로 기대되는 방식에 해당되는
+입력 메서드를 신호하여 의미 있는 방식으로 UI를 변경할 수 있게 하는 것이 좋습니다. 소프트웨어 입력 메서드가
어떻게 작동할지 임의로 추정하지 마시고, 이미 서식 지정된 텍스트를 애플리케이션에 제공해줄 것이라 믿으면 됩니다.
-
참고: Androids는 우선 이벤트 처리기부터 호출하고, 그 다음에 클래스 정의로부터 가져온
-적절한 기본 처리기를 두 번째로 호출합니다. 따라서, 이와 같은 이벤트 수신기에서 참을 반환하면 이벤트가
-다른 이벤트 수신기로 전파되는 것을 중지시킬 뿐만 아니라 보기에 있는
+
참고: Androids는 우선 이벤트 처리기부터 호출하고, 그 다음에 클래스 정의로부터 가져온
+적절한 기본 처리기를 두 번째로 호출합니다. 따라서, 이와 같은 이벤트 수신기에서 참을 반환하면 이벤트가
+다른 이벤트 수신기로 전파되는 것을 중지시킬 뿐만 아니라 보기에 있는
기본 이벤트 처리기로의 콜백도 차단하게 됩니다. 따라서 참을 반환하는 경우 해당 이벤트를 종료하고 싶은 것인지 확신해야 합니다.
이벤트 처리기
-
보기에서 사용자 지정 구성 요소를 구축하는 경우, 기본 이벤트 처리기로 사용될 콜백 메서드를
+
보기에서 사용자 지정 구성 요소를 구축하는 경우, 기본 이벤트 처리기로 사용될 콜백 메서드를
여러 개 정의할 수 있게 됩니다.
사용자 지정
-구성 요소에 대한 문서를 보면 이벤트 처리에 사용되는 몇 가지 보편적인 콜백을 확인할 수 있습니다.
+구성 요소에 대한 문서를 보면 이벤트 처리에 사용되는 몇 가지 보편적인 콜백을 확인할 수 있습니다.
다음은 그 몇 가지 예입니다.
{@link android.view.View#onKeyDown} - 새로운 키 이벤트가 발생하면 호출합니다.
@@ -176,68 +176,68 @@ dispatchKeyEvent()} 메서드를 통과하여 이동하는 것을 확인
{@link android.view.View#onTouchEvent} - 터치 스크린 동작 이벤트가 발생하면 호출합니다.
{@link android.view.View#onFocusChanged} - 보기가 초점을 취하거나 이를 잃으면 호출합니다.
-
개발자 여러분이 알아두어야 하는 다른 메서드가 몇 가지 더 있습니다. 이들은 보기 클래스의 일부분이 아니지만,
-이벤트를 처리할 수 있는 방식에 직접적으로 영향을 미칠 수 있는 것들입니다. 그러니, 레이아웃 안에서 좀 더 복잡한 이벤트를 관리하는 경우,
+
개발자 여러분이 알아두어야 하는 다른 메서드가 몇 가지 더 있습니다. 이들은 보기 클래스의 일부분이 아니지만,
+이벤트를 처리할 수 있는 방식에 직접적으로 영향을 미칠 수 있는 것들입니다. 그러니, 레이아웃 안에서 좀 더 복잡한 이벤트를 관리하는 경우,
이와 같은 다른 메서드도 고려하십시오.
{@link android.app.Activity#dispatchTouchEvent(MotionEvent)
- Activity.dispatchTouchEvent(MotionEvent)} - 이것을 사용하면 {@link
+ Activity.dispatchTouchEvent(MotionEvent)} - 이것을 사용하면 {@link
android.app.Activity}로 하여금 모든 터치 이벤트가 창으로 발송되기 전에 이들을 가로채도록 할 수 있습니다.
{@link android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)
ViewGroup.onInterceptTouchEvent(MotionEvent)} - 이것을 사용하면 {@link
android.view.ViewGroup}으로 하여금 이벤트가 하위 보기로 발송되는 것을 지켜보도록 할 수 있습니다.
{@link android.view.ViewParent#requestDisallowInterceptTouchEvent(boolean)
- ViewParent.requestDisallowInterceptTouchEvent(boolean)} - 이것을
-호출하는 것은 상위 보기에 {@link
+ ViewParent.requestDisallowInterceptTouchEvent(boolean)} - 이것을
+호출하는 것은 상위 보기에 {@link
android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)}가 있는 터치 이벤트를 가로채면 안 된다고 나타낼 때입니다.
터치 모드
-사용자가 방향 키 또는 트랙볼을 사용하여 사용자 인터페이스를 탐색하고 있는 경우,
-조치 가능한 항목(예: 버튼)에 초점을 맞춰 어느 것이 입력을 허용할지 사용자가
-볼 수 있도록 해야 합니다. 하지만 기기에 터치 기능이 있고 사용자가
-인터페이스를 터치하여 인터페이스와의 상호 작용을 시작하는 경우라면, 더 이상 항목을 강조 표시하거나
-특정 보기에 초점을 맞추지 않아도 됩니다. 따라서 "터치 모드"라고 불리는 상호 작용에 대한
-모드가 따로 있습니다.
+사용자가 방향 키 또는 트랙볼을 사용하여 사용자 인터페이스를 탐색하고 있는 경우,
+조치 가능한 항목(예: 버튼)에 초점을 맞춰 어느 것이 입력을 허용할지 사용자가
+볼 수 있도록 해야 합니다. 하지만 기기에 터치 기능이 있고 사용자가
+인터페이스를 터치하여 인터페이스와의 상호 작용을 시작하는 경우라면, 더 이상 항목을 강조 표시하거나
+특정 보기에 초점을 맞추지 않아도 됩니다. 따라서 "터치 모드"라고 불리는 상호 작용에 대한
+모드가 따로 있습니다.
-터치 기능이 있는 기기의 경우, 사용자가 화면을 터치하면 기기가 터치 모드에
-진입하게 됩니다. 이 시점부터는
-{@link android.view.View#isFocusableInTouchMode}가 참인 보기에만 초점을 맞출 수 있습니다. 예를 들어 텍스트 편집 위젯이 이에 해당됩니다.
-버튼처럼 터치할 수 있는 다른 보기의 경우 터치해도 주의를 끌 수 없으며 이를 누르면 그저
+터치 기능이 있는 기기의 경우, 사용자가 화면을 터치하면 기기가 터치 모드에
+진입하게 됩니다. 이 시점부터는
+{@link android.view.View#isFocusableInTouchMode}가 참인 보기에만 초점을 맞출 수 있습니다. 예를 들어 텍스트 편집 위젯이 이에 해당됩니다.
+버튼처럼 터치할 수 있는 다른 보기의 경우 터치해도 주의를 끌 수 없으며 이를 누르면 그저
온-클릭 수신기를 실행시키기만 합니다.
-사용자가 방향 키를 누르거나 트랙볼로 스크롤 동작을 할 때마다 기기가
-터치 모드를 종료하고 초점을 맞출 보기를 찾습니다. 이제 사용자는 사용자 인터페이스와
+사용자가 방향 키를 누르거나 트랙볼로 스크롤 동작을 할 때마다 기기가
+터치 모드를 종료하고 초점을 맞출 보기를 찾습니다. 이제 사용자는 사용자 인터페이스와
상호 작용을 재개해도 되며, 화면을 터치하지 않아도 됩니다.
-터치 모드 상태는 시스템 전체를 통틀어 유지됩니다(모든 창과 액티비티 포함).
-현재 상태를 쿼리하려면
+터치 모드 상태는 시스템 전체를 통틀어 유지됩니다(모든 창과 액티비티 포함).
+현재 상태를 쿼리하려면
{@link android.view.View#isInTouchMode}를 호출하여 기기가 현재 터치 모드에 있는지 확인하면 됩니다.
초점 처리하기
-
프레임워크가 사용자 입력에 응답하여 일상적인 초점 이동을 처리합니다.
-여기에는 보기가 제거되거나 숨겨지는 것, 또는 새 보기를 사용할 수 있게 됨에 따라
-초점을 변경하는 것이 포함됩니다. 보기는 초점을 취하고자 하는 의향을
-{@link android.view.View#isFocusable()} 메서드를 통해 나타냅니다. 보기가 초점을 취할 수 있는지 여부를 변경하려면
-{@link android.view.View#setFocusable(boolean) setFocusable()}을 호출합니다. 터치 모드에 있는 경우,
-어느 보기가 {@link android.view.View#isFocusableInTouchMode()}로 초점을 취하는 것을 허용하는지 여부를 쿼리할 수 있습니다.
+
프레임워크가 사용자 입력에 응답하여 일상적인 초점 이동을 처리합니다.
+여기에는 보기가 제거되거나 숨겨지는 것, 또는 새 보기를 사용할 수 있게 됨에 따라
+초점을 변경하는 것이 포함됩니다. 보기는 초점을 취하고자 하는 의향을
+{@link android.view.View#isFocusable()} 메서드를 통해 나타냅니다. 보기가 초점을 취할 수 있는지 여부를 변경하려면
+{@link android.view.View#setFocusable(boolean) setFocusable()}을 호출합니다. 터치 모드에 있는 경우,
+어느 보기가 {@link android.view.View#isFocusableInTouchMode()}로 초점을 취하는 것을 허용하는지 여부를 쿼리할 수 있습니다.
이것은 {@link android.view.View#setFocusableInTouchMode(boolean) setFocusableInTouchMode()}로 변경하면 됩니다.
-
초점 이동은 주어진 방향에서 가장 가까운 이웃을 찾아내는 알고리즘을 기반으로
-합니다. 드문 일이지만 기본 알고리즘이 개발자가 의도한 행동과 일치하지 않는
-경우도 있습니다. 이러한 상황이라면, 레이아웃 파일에서 다음과 같은 XML 속성을
+
초점 이동은 주어진 방향에서 가장 가까운 이웃을 찾아내는 알고리즘을 기반으로
+합니다. 드문 일이지만 기본 알고리즘이 개발자가 의도한 행동과 일치하지 않는
+경우도 있습니다. 이러한 상황이라면, 레이아웃 파일에서 다음과 같은 XML 속성을
사용하여 명시적 재정의를 제공하면 됩니다.
nextFocusDown, nextFocusLeft, nextFocusRight, 및
-nextFocusUp입니다. 이와 같은 속성 중 한 가지를 초점이 떠나고 있는 보기에
-추가합니다. 속성의 값을 초점을
+nextFocusUp입니다. 이와 같은 속성 중 한 가지를 초점이 떠나고 있는 보기에
+추가합니다. 속성의 값을 초점을
맞춰야 할 보기의 ID가 되도록 정의합니다. 예:
<LinearLayout
@@ -252,18 +252,18 @@ dispatchKeyEvent()} 메서드를 통과하여 이동하는 것을 확인
</LinearLayout>
-
보통은 이런 수직 레이아웃에서 첫 버튼부터 위로 이동하면 아무 데도 갈 수 없고,
-두 번째 버튼에서 아래로 이동해도 마찬가지입니다. 이제 맨 위 버튼이 맨 아래 버튼을 다음과 같이
-정의했습니다. nextFocusUp (반대쪽도 마찬가지) 따라서 이동 초점은 위에서 아래로 갔다가
+
보통은 이런 수직 레이아웃에서 첫 버튼부터 위로 이동하면 아무 데도 갈 수 없고,
+두 번째 버튼에서 아래로 이동해도 마찬가지입니다. 이제 맨 위 버튼이 맨 아래 버튼을 다음과 같이
+정의했습니다. nextFocusUp (반대쪽도 마찬가지) 따라서 이동 초점은 위에서 아래로 갔다가
아래에서 위로 순환하게 됩니다.
-
보기를 UI에서 초점을 맞출 수 있는 것으로 선언하고자 하는 경우(일반적으로는 그렇지 않음),
-보기에 레이아웃 선언에서 android:focusable XML 속성을 추가합니다.
-이 값을 참으로 설정합니다. 터치 모드에 있을 때에도 보기를 초점을 맞출 수 있는 것으로
+
보기를 UI에서 초점을 맞출 수 있는 것으로 선언하고자 하는 경우(일반적으로는 그렇지 않음),
+보기에 레이아웃 선언에서 android:focusable XML 속성을 추가합니다.
+이 값을 참으로 설정합니다. 터치 모드에 있을 때에도 보기를 초점을 맞출 수 있는 것으로
선언할 수 있습니다. android:focusableInTouchMode를 사용하면 됩니다.
특정 보기에 초점을 맞추기를 요청하려면, {@link android.view.View#requestFocus()}를 호출하십시오.
-
초점 이벤트를 수신 대기하려면(어떤 보기에 초점이 맞춰지거나 이를 잃는 경우 알림을 받으려면),
-{@link android.view.View.OnFocusChangeListener#onFocusChange(View,boolean) onFocusChange()}를 사용하면 됩니다.
+
초점 이벤트를 수신 대기하려면(어떤 보기에 초점이 맞춰지거나 이를 잃는 경우 알림을 받으려면),
+{@link android.view.View.OnFocusChangeListener#onFocusChange(View,boolean) onFocusChange()}를 사용하면 됩니다.
이는 위의 이벤트 수신기 섹션에서 이야기한 바와 같습니다.
@@ -282,7 +282,7 @@ dispatchKeyEvent()} 메서드를 통과하여 이동하는 것을 확인
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/ko/preview/api-overview.jd b/docs/html-intl/intl/ko/preview/api-overview.jd
index fdae40619bd14..5cffdfb235727 100644
--- a/docs/html-intl/intl/ko/preview/api-overview.jd
+++ b/docs/html-intl/intl/ko/preview/api-overview.jd
@@ -311,7 +311,7 @@ Data Saver 기본 설정을 검색하고 Vulkan API
- Android N은 새로운 3D 렌더링 API인 Vulkan™을 플랫폼에 통합합니다.
+ Android N은 새로운 3D 렌더링 API인 Vulkan™을 플랫폼에 통합합니다.
OpenGL™
ES와 마찬가지로, Vulkan은 Khronos Group에 의해 관리되는 3D 그래픽 및 렌더링을 위한
공개 표준입니다.
@@ -502,7 +502,7 @@ API를 사용하여 사용자의 로케일을 가져온
이모티콘에 대한 시각적 표시를 제공해야 하며, 사용자가 선호하는 피부 색조를 선택하도록
허용해야 합니다. 어떤 시스템 이모티콘에 피부 색조
한정자가 있는지 확인하려면 {@link android.graphics.Paint#hasGlyph(String)}
-메서드를 사용하세요.
+메서드를 사용하세요.
유니코드 설명서를 읽어보면 어떤 이모티콘에서 피부 색조가 사용되는지 확인할 수 있습니다.
@@ -857,7 +857,7 @@ Android N에서는 사용자가 "Alt + /" 키를 눌러 Keyboard Shortcuts
diff --git a/docs/html-intl/intl/ko/preview/behavior-changes.jd b/docs/html-intl/intl/ko/preview/behavior-changes.jd
index 709ccfc2f0793..5d325e1b41dbe 100644
--- a/docs/html-intl/intl/ko/preview/behavior-changes.jd
+++ b/docs/html-intl/intl/ko/preview/behavior-changes.jd
@@ -167,7 +167,7 @@ CPU 및 네트워크 제한의 하위 세트를 적용하여 잠자기 모드를
Android N 기기를 올바로 대상으로 삼을 수 있도록 이들 인텐트에 대한 종속성을 최대한 빨리 제거해야 합니다.
Android 프레임워크는 이러한 암시적 브로드캐스트의
필요성을 줄이기 위한 여러 가지 해결책을 제공합니다. 예를 들어, {@link
- android.app.job.JobScheduler} API는 지정된 조건(예:
+ android.app.job.JobScheduler} API는 지정된 조건(예:
고정 요금제 네트워크에 연결)이 충족될 경우 네트워크 운영을 예약할 수 있는
강력한 메커니즘을 제공합니다. 심지어 {@link
android.app.job.JobScheduler}를 사용하여 콘텐츠 공급자의 변경 사항에 대응할 수도 있습니다.
@@ -224,7 +224,7 @@ API 또는 {@link java.io.File File} API를 사용하여 개인 디렉터리에
대상으로 하는 앱은 {@link android.app.DownloadManager#COLUMN_LOCAL_FILENAME}에 액세스할 때 {@link java.lang.SecurityException}을
트리거합니다.
-
+
{@link
android.app.DownloadManager.Request#setDestinationInExternalFilesDir
DownloadManager.Request.setDestinationInExternalFilesDir()} 또는
@@ -562,7 +562,7 @@ TCP 소켓에 대한 쓰기를 엄격 모드 위반으로서 플래그하지 못
-{@code Debug.startMethodTracing()} 계열에 속하는 메서드는,
+{@code Debug.startMethodTracing()} 계열에 속하는 메서드는,
SD 카드의 최상위 레벨에 저장하는 것이 아니라, 이제 공유 저장소의
패키지별 디렉터리에 출력을 기본적으로
저장합니다. 즉, 앱은 이들 API를 사용하기 위해 {@code WRITE_EXTERNAL_STORAGE} 권한을 요청할 필요가 더 이상 없습니다.
diff --git a/docs/html-intl/intl/ko/preview/features/direct-boot.jd b/docs/html-intl/intl/ko/preview/features/direct-boot.jd
index 981c3e0808989..2674481181a48 100644
--- a/docs/html-intl/intl/ko/preview/features/direct-boot.jd
+++ b/docs/html-intl/intl/ko/preview/features/direct-boot.jd
@@ -18,7 +18,7 @@ page.image=images/cards/card-nyc_2x.jpg
-
기기에 전원이 들어와 있지만 사용자가 기기의 잠금을 해제하지 않았을 경우 Android N은 안전한
+
기기에 전원이 들어와 있지만 사용자가 기기의 잠금을 해제하지 않았을 경우 Android N은 안전한
직접 부팅
모드에서 실행됩니다. 이를 지원하기 위해 시스템에서 다음과 같은 두 가지 데이터 저장소 위치를 제공합니다.
@@ -125,7 +125,7 @@ ACTION_BOOT_COMPLETED} 메시지를 수신할 수 있습니다. 이 메시지는
기존 데이터 마이그레이션
직접 부팅 모드를 사용하도록 사용자가 자신의 기기를 업데이트하는 경우,
-여러분이 기존 데이터를 기기 암호화 저장소로 마이그레이션해야 할 수도 있습니다.
+여러분이 기존 데이터를 기기 암호화 저장소로 마이그레이션해야 할 수도 있습니다.
Context.moveSharedPreferencesFrom()과
Context.moveDatabaseFrom()을 사용하여 자격 증명 암호화 저장소와 기기 암호화 저장소 간에
기본 설정과 데이터베이스 데이터를 마이그레이션합니다.
diff --git a/docs/html-intl/intl/ko/preview/features/icu4j-framework.jd b/docs/html-intl/intl/ko/preview/features/icu4j-framework.jd
index f626bff6bde95..921873d8e6f21 100644
--- a/docs/html-intl/intl/ko/preview/features/icu4j-framework.jd
+++ b/docs/html-intl/intl/ko/preview/features/icu4j-framework.jd
@@ -50,7 +50,7 @@ Android 프레임워크에서 ICU4J API를 사용하는 방법을 설명합니
Android N은
-com.ibm.icu가 아니라 android.icu 패키지를 통해 ICU4J API의 하위 세트를 노출합니다.
+com.ibm.icu가 아니라 android.icu 패키지를 통해 ICU4J API의 하위 세트를 노출합니다.
Android 프레임워크는 여러 가지 이유로
ICU4J API를 노출하지 않을 수 있습니다. 예컨대 Android N은
일부 사용 중단된 API나 ICU 팀에서 안정적이라고 선언하지 않은 API를
diff --git a/docs/html-intl/intl/ko/preview/features/tv-recording-api.jd b/docs/html-intl/intl/ko/preview/features/tv-recording-api.jd
index f353cc6a4e677..fa557bcf14fdd 100644
--- a/docs/html-intl/intl/ko/preview/features/tv-recording-api.jd
+++ b/docs/html-intl/intl/ko/preview/features/tv-recording-api.jd
@@ -81,7 +81,7 @@ page.image=images/cards/card-nyc_2x.jpg
전송하는 역할을 담당합니다.
시스템이 RecordingSession.onTune()을 호출하면
-채널 URI에 전달되고, URI가 지정하는 채널에 맞춰 조정됩니다.
+채널 URI에 전달되고, URI가 지정하는 채널에 맞춰 조정됩니다.
notifyTuned()를 호출해서 앱이 원하는 채널에 맞춰졌음을 시스템에 알리거나
앱이 적절한 채널에 맞출 수 없으면
notifyError()를 호출합니다.
사용자가 앱을 탐색하고, 앱에서 나가고, 앱으로 다시 돌아가면, 앱의
-{@link android.app.Activity} 인스턴스는
+{@link android.app.Activity} 인스턴스는
수명 주기 안에서 서로 다른 상태 간에 전환됩니다. 예를 들어
액티비티가 처음 시작되는 경우, 시스템의 전면에 표시되어 사용자의
포커스를 받습니다. 이 과정에서 Android 시스템은 사용자 인터페이스 및 다른 구성요소에 설정된
-액티비티에 대해 일련의 수명 주기 메서드를 호출합니다. 사용자가 다른 액티비티를 시작하거나 다른 앱으로 전환하는
+액티비티에 대해 일련의 수명 주기 메서드를 호출합니다. 사용자가 다른 액티비티를 시작하거나 다른 앱으로 전환하는
작업을 수행하면, 백그라운드(액티비티가 더
이상 보이지 않지만 인스턴스와 해당 상태는 그대로 유지되는 상태)로 전환되면서 시스템은 액티비티에 대해 또 다른
수명 주기 메서드 세트를 호출합니다.
@@ -55,7 +55,7 @@ android.app.Activity} 인스턴스가 수신하는 중요한 수명 주기 콜
사용자가 원하는 작업을 하고, 액티비티가 필요로 하지 않을 때 시스템 리소스 소비를 방지하는 방법에 대해서도 설명합니다.
일반적인 앱 사용 중에 가끔 다른
비주얼 구성요소로 인해 전면의 액티비티가 일시정지되는 경우가 있습니다. 예를 들어, 대화 상자 스타일과 같은 반투명
액티비티가 열리면, 그 이전 액티비티는 일시정지됩니다. 액티비티가
부분적으로 보이지만 현재 포커스 내에 있지 않는 한 일시정지된 상태로 유지됩니다.
@@ -59,7 +59,7 @@ android.app.Activity#onPause()}에 대한 호출을 수신하는 경우, 이는
액티비티 일지정지하기
-
+
시스템이 액티비티에 대해 {@link android.app.Activity#onPause()}를 호출하면, 이는
엄밀해 말해 액티비티가 여전히 부분적으로 보일 수 있음을 의미하지만,
대개의 경우 사용자가 액티비티를 떠나 곧 정지 상태로 전환될 것임을 나타냅니다. 일반적으로 다음 작업을 수행할 때
diff --git a/docs/html-intl/intl/ko/training/basics/activity-lifecycle/recreating.jd b/docs/html-intl/intl/ko/training/basics/activity-lifecycle/recreating.jd
index 79fb92bbdc7d9..2408cac248bb1 100644
--- a/docs/html-intl/intl/ko/training/basics/activity-lifecycle/recreating.jd
+++ b/docs/html-intl/intl/ko/training/basics/activity-lifecycle/recreating.jd
@@ -8,13 +8,13 @@ trainingnavtop=true
매니페스트 내에 선언했던 브로드캐스트 리시버는 현재 기기 상태에서 필요 없는 것을 사용 중지하도록 런타임 때 전환될 수 있습니다. 기기가 특정 상태에 도달할 때까지 상태 변화 리시버 및 지연 액션을 전환 및 단계적으로 연결하여 효율성을 향상하는 법을 알아보세요.
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ko/training/monitoring-device-state/manifest-receivers.jd b/docs/html-intl/intl/ko/training/monitoring-device-state/manifest-receivers.jd
index c5c311b75f6bd..0eefe08501827 100644
--- a/docs/html-intl/intl/ko/training/monitoring-device-state/manifest-receivers.jd
+++ b/docs/html-intl/intl/ko/training/monitoring-device-state/manifest-receivers.jd
@@ -9,7 +9,7 @@ previous.link=connectivity-monitoring.html
@jd:body
-
기기 상태 변경을 모니터링하는 가장 간단한 방법은 모니터링하는 각 상태에 대해 {@link android.content.BroadcastReceiver}를 만들어 각각을 애플리케이션 매니페스트에 등록하는 것입니다. 그러면 각 리시버 내에서 현재 기기 상태를 기반으로 반복 알람의 일정을 간단히 변경할 수 있습니다.
현재 애플리케이션이 표시하는 레이아웃에 따라 UI 플로가 달라질 수 있습니다. 예를 들어 애플리케이션이 이중 창 모드로 되어 있는 경우에는 왼쪽 창에 있는 항목을 클릭하면 오른쪽 창에 콘텐츠가 표시되고, 단일 창 모드로 되어 있는 경우에는 콘텐츠가 해당 창에 표시됩니다(다른 액티비티에서).
@@ -56,7 +56,7 @@ public class NewsReaderActivity extends FragmentActivity {
setContentView(R.layout.main_layout);
View articleView = findViewById(R.id.article);
- mIsDualPane = articleView != null &&
+ mIsDualPane = articleView != null &&
articleView.getVisibility() == View.VISIBLE;
}
}
@@ -116,7 +116,7 @@ public void onCreate(Bundle savedInstanceState) {
else {
/* use list navigation (spinner) */
actionBar.setNavigationMode(android.app.ActionBar.NAVIGATION_MODE_LIST);
- SpinnerAdapter adap = new ArrayAdapter(this,
+ SpinnerAdapter adap = new ArrayAdapter(this,
R.layout.headline_item, CATEGORIES);
actionBar.setListNavigationCallbacks(adap, handler);
}
@@ -168,7 +168,7 @@ public class HeadlinesFragment extends ListFragment {
public class HeadlinesFragment extends ListFragment {
...
@Override
- public void onItemClick(AdapterView<?> parent,
+ public void onItemClick(AdapterView<?> parent,
View view, int position, long id) {
if (null != mHeadlineSelectedListener) {
mHeadlineSelectedListener.onHeadlineSelected(position);
diff --git a/docs/html-intl/intl/ko/training/multiscreen/index.jd b/docs/html-intl/intl/ko/training/multiscreen/index.jd
index dd152aea410aa..0a30f92abaab5 100644
--- a/docs/html-intl/intl/ko/training/multiscreen/index.jd
+++ b/docs/html-intl/intl/ko/training/multiscreen/index.jd
@@ -7,10 +7,10 @@ next.link=screensizes.html
@jd:body
-
Android는 소형 휴대전화에서부터 대형 TV에 이르기까지 다양한 화면 크기의 수많은 기기 유형을 지원합니다. 따라서 애플리케이션이 모든 화면 크기와 호환되어 최대한 많은 사용자가 사용할 수 있도록 디자인하는 것이 중요합니다.
하지만 다양한 기기 유형과 호환되는 것만으로는 충분하지 않습니다. 각 화면 크기에 따라 사용자 상호작용에 유리한 점과 불리한 점이 다릅니다. 따라서 사용자에게 만족을 주고 깊은 인상을 심어주려면 애플리케이션이 단지 여러 화면을 지원하는 데 그치지 않고 화면 구성별로 사용자 환경을 최적화해야 합니다.
참고: 이 강의 및 강의와 관련된 샘플은 호환성 라이브러리를 사용하며 이는 Android 3.0 이하 버전에서 {@link android.app.Fragment} API를 사용하기 위해서입니다. 이 강의에서 API를 모두 사용하려면 라이브러리를 다운로드하여 애플리케이션에 추가해야 합니다.
레이아웃이 다양한 화면 크기에 따라 유연하게 조정되도록 하려면 일부 뷰 구성요소의 너비와 높이에 "wrap_content" 및 "match_parent"를 사용해야 합니다. "wrap_content"를 사용하면 뷰의 너비와 높이가 해당 뷰 내에 콘텐츠가 들어가는데 필요한 최소 크기로 설정되는 반면, "match_parent"(API 수준 8 이전에는 "fill_parent"라고도 함)를 사용하면 구성요소가 확장되어 부모뷰의 크기와 일치하게 됩니다.
@@ -65,7 +65,7 @@ next.link=screendensities.html
그림 1. 세로 모드(왼쪽) 및 가로 모드(오른쪽)에서의 뉴스 리더 샘플 앱
-
RelativeLayout 사용
+
RelativeLayout 사용
비교적 복잡한 레이아웃을 만들려면 {@link android.widget.LinearLayout}의 중첩 인스턴스와"wrap_content" 및 "match_parent" 크기의 조합을 사용합니다. 하지만 {@link android.widget.LinearLayout} 을 사용하면 자식뷰의 여백 관계를 정확하게 제어할 수 없으며 {@link android.widget.LinearLayout} 단순히 나란하게 표시됩니다. 자식뷰를 일직선이 아닌 다양한 방향으로 표시해야 하는 경우 구성요소 사이의 여백 관계를 중심으로 레이아웃을 지정할 수 있는 {@link android.widget.RelativeLayout}을 사용하는 것이 더 좋은 방법일 수 있습니다. 예를 들어 화면 왼쪽에 하나의 자식뷰를, 오른쪽에 다른 자식뷰를 정렬할 수 있습니다.
구성요소의 크기가 변하더라도 여백 관계가 {@link android.widget.RelativeLayout.LayoutParams}.
-
-
크기 한정자 사용
+
+
크기 한정자 사용
이전 섹션에서 다룬 유연한 레이아웃이나 상대적 레이아웃으로는 한계가 있습니다. 이러한 레이아웃이 구성요소 내부 및 주위의 여백을 확장하여 다양한 화면에 맞게 조정되긴 하지만 화면 크기별로 최적의 사용자 환경을 제공하지는 못할 수 있습니다. 따라서 애플리케이션은 유연한 레이아웃을 구현할 뿐 아니라 다양한 화면 구성을 타겟팅할 수 있도록 다양한 대체 레이아웃을 제공해야 합니다. 그 방법은 런타임이 현재 기기의 구성에 따라 적합한 리소스(예: 화면 크기별로 다른 레이아웃 디자인)를 자동으로 선택하도록 해 주는 구성 한정자를 사용하는 것입니다.
하지만 Android 3.2 이전 기기는 sw600dp를 크기 한정자로 인식하지 않기 때문에 최소 너비 한정자가 제대로 작동하지 않으며 따라서 large 한정자도 계속 사용해야 합니다. 따라서 res/layout-large/main.xml라는 이름의 파일이 있어야 하며 이 파일은 res/layout-sw600dp/main.xml과 동일한 파일입니다. 다음 섹션에서는 이런 식으로 레이아웃 파일이 중복되지 않게 하는 기술을 살펴보겠습니다.
-
레이아웃 별칭 사용
+
레이아웃 별칭 사용
최소 너비 한정자는 Android 3.2 이상 버전에서만 사용할 수 있습니다. 따라서 이전 버전과 호환되도록 하려면 추상화 크기 빈(소형, 보통, 대형 및 초대형)을 계속 사용해야 합니다. 예를 들어 휴대전화에서는 단일 창 UI가 표시되고 7인치 태블릿, TV 및 기타 대형 기기에서는 다중 창 UI가 표시되도록 UI를 디자인하려면 다음 파일을 제공해야 합니다.
@@ -202,7 +202,7 @@ next.link=screendensities.html
{@code large},3.2 이후 버전은 sw600dp와 일치).
-
방향 한정자 사용
+
방향 한정자 사용
일부 레이아웃은 가로 및 세로 방향 모두에서 잘 작동하지만 대부분의 레이아웃은 조정을 통해 많은 이점을 누릴 수 있습니다. 다음은 뉴스 리더 샘플 앱에서 화면 크기와 방향별로 레이아웃이 어떻게 작동하는지 보여줍니다.
Quando o sistema detectar uma rede adequada, ele se conectará à rede e chamará a chamada de retorno {@link android.net.ConnectivityManager.NetworkCallback#onAvailable(android.net.Network) onAvailable()}. É possível usar o objeto {@link android.net.Network} da chamada de retorno a fim de receber mais informações sobre a rede ou direcionar o tráfego para que a rede selecionada seja usada.
Bluetooth Low Energy
-
O Android 4.3 apresentou o suporte de plataforma para o Bluetooth Low Energy(Bluetooth LE) na função central. No Android 5.0, um dispositivo Android agora pode agir como um dispositivo periférico de Bluetooth LE. Os apps podem usar esse recurso para fazer com que sua presença seja percebida pelos dispositivos vizinhos. É possível, por exemplo, criar apps que permitem que um dispositivo funcione como um pedômetro ou um monitor de integridade de dados e envie seus dados para outro dispositivo Bluetooth LE.
+
O Android 4.3 apresentou o suporte de plataforma para o Bluetooth Low Energy(Bluetooth LE) na função central. No Android 5.0, um dispositivo Android agora pode agir como um dispositivo periférico de Bluetooth LE. Os apps podem usar esse recurso para fazer com que sua presença seja percebida pelos dispositivos vizinhos. É possível, por exemplo, criar apps que permitem que um dispositivo funcione como um pedômetro ou um monitor de integridade de dados e envie seus dados para outro dispositivo Bluetooth LE.
As novas APIs de {@link android.bluetooth.le} permitem que seus apps divulguem anúncios, verifiquem respostas e formem conexões com dispositivos Bluetooth LE vizinhos. Para usar os novos recursos de publicidade e varredura, adicione a permissão {@link android.Manifest.permission#BLUETOOTH_ADMIN BLUETOOTH_ADMIN} no manifesto. Quando os usuários atualizam ou fazem o download do seu app a partir da Play Store, eles são solicitados a conceder a seguinte permissão para seu app: "Informações da conexão Bluetooth: permite que o app controle o Bluetooth, incluindo a divulgação para dispositivos Bluetooth vizinhos ou a busca de informações sobre esses dispositivos."
Para começar a publicidade de Bluetooth LE para que outros dispositivos possam descobrir seu app, chame {@link android.bluetooth.le.BluetoothLeAdvertiser#startAdvertising(android.bluetooth.le.AdvertiseSettings, android.bluetooth.le.AdvertiseData, android.bluetooth.le.AdvertiseCallback) startAdvertising()} e passe uma implementação da classe {@link android.bluetooth.le.AdvertiseCallback}. O objeto de chamada de retorno recebe um relatório do sucesso ou da falha da operação de publicidade.
diff --git a/docs/html-intl/intl/pt-br/design/get-started/principles.jd b/docs/html-intl/intl/pt-br/design/get-started/principles.jd
index 82e28cccfe10c..81b3524130e0e 100644
--- a/docs/html-intl/intl/pt-br/design/get-started/principles.jd
+++ b/docs/html-intl/intl/pt-br/design/get-started/principles.jd
@@ -8,7 +8,7 @@ definir as diretrizes de projeto mais detalhadas para diferentes
tipos de dispositivo.
-Considere estes princípios ao aplicar
+Considere estes princípios ao aplicar
sua criatividade e sua mentalidade de projeto. Desvie-se de forma objetiva.
@@ -18,7 +18,7 @@ sua criatividade e sua mentalidade de projeto. Desvie-se de forma objetiva.
Agrade-me de formas surpreendentes
-
Uma bela superfície, uma animação cuidadosamente posicionada ou um efeito sonoro no momento certo
+
Uma bela superfície, uma animação cuidadosamente posicionada ou um efeito sonoro no momento certo
contribui para a boa experiência. Efeitos sutis contribuem para uma sensação de facilidade e de que algo
poderoso está à mão.
O Material Design é um guia abrangente para design visual, de movimento e de
+
O Material Design é um guia abrangente para design visual, de movimento e de
interação para diversas plataformas e dispositivos. O Android agora é compatível com
-aplicativos do Material Design. Para usar o Material Design nos aplicativos Android, siga as orientações definidas
-nas especificações do Material Design e use os novos
+aplicativos do Material Design. Para usar o Material Design nos aplicativos Android, siga as orientações definidas
+nas especificações do Material Design e use os novos
componentes e funcionalidades disponíveis no Android 5.0 (API de nível 21) e em posteriores.
O Android fornece os seguintes elementos para criar aplicativos do Material Design:
@@ -59,7 +59,7 @@ componentes e funcionalidades disponíveis no Android 5.0 (API de nível 21) e e
Tema do Material
-
O tema do Material fornece um novo estilo para o seu aplicativo, widgets de sistema que permitem
+
O tema do Material fornece um novo estilo para o seu aplicativo, widgets de sistema que permitem
definir a paleta de cores e as animações padrão para feedback de toque e transições de atividades.
@@ -79,13 +79,13 @@ definir a paleta de cores e as animações padrão para feedback de toque e tran
@@ -165,7 +165,7 @@ Exibir animações em desenháveis da lista de estado entre mud
Animações de feedback de toque são integradas em várias vistas padrão, como botões. As novas APIs
permitem personalizar essas animações e adicioná-las às vistas personalizadas.
diff --git a/docs/html-intl/intl/pt-br/design/patterns/compatibility.jd b/docs/html-intl/intl/pt-br/design/patterns/compatibility.jd
index 775af0c312a0e..bd4ec30ab1ed7 100644
--- a/docs/html-intl/intl/pt-br/design/patterns/compatibility.jd
+++ b/docs/html-intl/intl/pt-br/design/patterns/compatibility.jd
@@ -57,7 +57,7 @@ de ações resultante tem o mesmo estilo que no exemplo anterior, mas é exibida
Aplicativos legados em telefones com controles de navegação virtuais
-
Ao executar um aplicativo que foi desenvolvido para Android 2.3 ou anterior em um telefone com controles de
+
Ao executar um aplicativo que foi desenvolvido para Android 2.3 ou anterior em um telefone com controles de
navegação virtuais, um controle de ações adicionais é exibido no lado direito da barra de navegação virtual. É possível
tocar no controle para exibir as ações do aplicativo no estilo tradicional de menu do Android.
diff --git a/docs/html-intl/intl/pt-br/design/patterns/navigation.jd b/docs/html-intl/intl/pt-br/design/patterns/navigation.jd
index 8ed12f71b60b7..89eab9a4a19ee 100644
--- a/docs/html-intl/intl/pt-br/design/patterns/navigation.jd
+++ b/docs/html-intl/intl/pt-br/design/patterns/navigation.jd
@@ -66,7 +66,7 @@ estará no mesmo lugar dentro da hierarquia do aplicativo e nenhum histórico de
Mudar características de exibição (como mudar o zoom)
Navegação entre telas de mesmo nível
-
Quando o aplicativo suporta navegação de uma lista de itens para uma vista de detalhes de um desses itens,
+
Quando o aplicativo suporta navegação de uma lista de itens para uma vista de detalhes de um desses itens,
frequentemente é desejável dar suporte à navegação de direção daquele item para outro anterior ou
posterior a ele na lista. Por exemplo, no Gmail, é fácil deslizar para a esquerda ou para a direita em uma
conversa para visualizar uma mais nova ou mais antiga na mesma Caixa de entrada. Assim como ao mudar a vista dentro de uma tela, tal
@@ -82,9 +82,9 @@ ignorar essas telas relacionadas e navegar para a tela do contêiner visualizada
-
Você tem a capacidade de deixar o comportamento de Para Cima ainda mais inteligente com base em seu conhecimento da
+
Você tem a capacidade de deixar o comportamento de Para Cima ainda mais inteligente com base em seu conhecimento da
vista de detalhe. Estendendo o exemplo da Play Store acima, imagine que o usuário navegou do último
-Livro visualizado para os detalhes da adaptação do Filme. Nesse caso, Para Cima pode retornar a um contêiner
+Livro visualizado para os detalhes da adaptação do Filme. Nesse caso, Para Cima pode retornar a um contêiner
(filmes) pelo qual o usuário não navegou anteriormente.
@@ -116,7 +116,7 @@ botão Voltar continua até a Tela inicial.
Notificações indiretas
-
Quando o aplicativo precisa apresentar simultaneamente informações sobre vários eventos, ele pode usar
+
Quando o aplicativo precisa apresentar simultaneamente informações sobre vários eventos, ele pode usar
uma única notificação que direcione o usuário a uma tela intersticial. Essa tela resume esses
eventos e fornece caminhos para que o usuário mergulhe profundamente no aplicativo. Notificações desse estilo são
chamadas de notificações indiretas.
@@ -128,7 +128,7 @@ tela intersticial, Para Cima e Voltar se comportam como em notificações padrã
navegando dentro do aplicativo em vez de voltar à tela intersticial.
Por exemplo, suponha que um usuário no Gmail receba uma notificação indireta do Agenda. Tocar nessa
-notificação abrirá a tela intersticial, que exibirá lembretes para vários
+notificação abrirá a tela intersticial, que exibirá lembretes para vários
eventos. Tocar em Voltar na tela intersticial retornará o usuário ao Gmail. Tocar em um determinado evento
levará o usuário da tela intersticial ao aplicativo completo do Agenda para exibir detalhes do
evento. Dos detalhes do evento, Para Cima e Voltar navegam para a vista de nível superior do Agenda.
@@ -169,7 +169,7 @@ informações e todas as ações associadas que o usuário pode executar. Seu ap
atividades, consistindo em atividades que você cria e naquelas que reutiliza de outros aplicativos.
Uma tarefa é a sequência de atividades que um usuário segue para atingir um objetivo. Uma
-única tarefa pode usar atividades apenas de um aplicativo ou pode retirar atividades de uma série
+única tarefa pode usar atividades apenas de um aplicativo ou pode retirar atividades de uma série
de outros aplicativos.
Uma intenção é um mecanismo para que um aplicativo sinalize que gostaria a assistência de outro
@@ -188,7 +188,7 @@ que foram registradas para tratar a intenção Compartilhar.
-
Quando o usuário seleciona o compartilhamento via Gmail, a atividade de composição do Gmail é adicionada como uma continuação da
+
Quando o usuário seleciona o compartilhamento via Gmail, a atividade de composição do Gmail é adicionada como uma continuação da
Tarefa A — nenhuma tarefa nova é criada. Se o Gmail tivesse a própria tarefa em execução em segundo plano, ela não
seria afetada.
@@ -209,5 +209,5 @@ Recentes). Se o Gmail já tivesse a própria tarefa em execução em segundo pla
pela Tarefa B — o contexto anterior é abandonado em favor do novo objetivo do usuário.
diff --git a/docs/html-intl/intl/pt-br/design/patterns/notifications.jd b/docs/html-intl/intl/pt-br/design/patterns/notifications.jd
index efea6104638c4..5560e85f5c2eb 100644
--- a/docs/html-intl/intl/pt-br/design/patterns/notifications.jd
+++ b/docs/html-intl/intl/pt-br/design/patterns/notifications.jd
@@ -43,12 +43,12 @@ atenção — e que é sincronizado conforme apropriado em todos os disposit
funcionais:
-
As notificações passaram por mudanças visuais consistentes com o novo
+
As notificações passaram por mudanças visuais consistentes com o novo
tema do Material Design.
As notificações agora estão disponíveis na tela de bloqueio do dispositivo, enquanto que
o conteúdo sensível ainda pode
ficar oculto atrás dela.
-
Notificações de alta prioridade recebidas enquanto o dispositivo está em uso agora usam um novo formato, chamado de
+
Notificações de alta prioridade recebidas enquanto o dispositivo está em uso agora usam um novo formato, chamado de
notificações heads-up.
Notificações sincronizadas na nuvem: descartar uma notificação em um dos
dispositivos Android a descarta
@@ -62,7 +62,7 @@ anteriores, consulte Notificações no Android
para versões anteriores da plataforma têm a mesma aparência e o mesmo funcionamento no Android
5.0, com apenas mudanças menores de estilo que o sistema
entrega a você. Para obter mais informações sobre notificações em versões
-anteriores do Android, consulte
+anteriores do Android, consulte
Notificações no Android 4.4 ou em anteriores.
@@ -92,7 +92,7 @@ anteriores do Android, consulte
- Layout básico de uma notificação em dispositivo portátil (à esquerda) e a mesma notificação em Wear (à direita),
+ Layout básico de uma notificação em dispositivo portátil (à esquerda) e a mesma notificação em Wear (à direita),
com uma foto do usuário e um ícone de notificação
@@ -110,8 +110,8 @@ pinçar para aproximar ou afastar a vista ou realizar deslizamento de um dedo pa
compacto e expandido.
Para notificações de um evento, o Android fornece três modelos de layout
expandido (texto, caixa de entrada e
- imagem) para usar em seu aplicativo. As imagens a seguir mostram como
-se parecem notificações de um evento em
+ imagem) para usar em seu aplicativo. As imagens a seguir mostram como
+se parecem notificações de um evento em
dispositivos portáteis (à esquerda) e usados junto ao corpo (à direita).
Torne-a pessoal
Para notificações de itens enviados por outra pessoa (como uma mensagem ou
-atualização de status), inclua a imagem da pessoa usando
+atualização de status), inclua a imagem da pessoa usando
{@link android.app.Notification.Builder#setLargeIcon setLargeIcon()}. Anexe também informações sobre
a pessoa nos metadados da notificação (consulte {@link android.app.Notification#EXTRA_PEOPLE}).
@@ -235,8 +235,8 @@ o usuário possa pressionar o botão Voltar do sistema para voltar ao nível sup
Navegação para o seu aplicativo pelos widgets de página inicial e notificações no padrão de projeto de Navegação.
-
Definição e gerenciamento
-corretos da prioridade das
+
Definição e gerenciamento
+corretos da prioridade das
notificações
O Android tem suporte para um sinalizador de prioridade para notificações. Esse sinalizador permite
@@ -311,11 +311,11 @@ as descobre expandindo a sombra da notificação.
-
Como escolher uma prioridade
+
Como escolher uma prioridade
adequada
-
DEFAULT, HIGH e MAX são níveis de prioridade de interrupção e arriscam
+
DEFAULT, HIGH e MAX são níveis de prioridade de interrupção e arriscam
interromper a atividade
do usuário. Para evitar irritar os usuários de seu aplicativo, reserve níveis de prioridade de interrupção para
notificações que:
@@ -359,7 +359,7 @@ de notificação), podem usar essas informações para tomar decisões de classi
href="/reference/android/app/Notification.html#CATEGORY_CALL">CATEGORY_CALL
-
Chamada recebida (voz ou vídeo) ou solicitação similar de
+
Chamada recebida (voz ou vídeo) ou solicitação similar de
comunicação síncrona
@@ -508,7 +508,7 @@ de um determinado tipo estão pendentes.
Você pode fornecer
mais detalhes sobre as notificações individuais que compõem um
-resumo usando o layout resumido expandido. Essa abordagem permite que os usuários
+resumo usando o layout resumido expandido. Essa abordagem permite que os usuários
entendam melhor quais
notificações estão pendentes e decidam se estão interessados o suficiente para lê-las
em detalhes dentro
@@ -525,13 +525,13 @@ opcionais
Os usuários devem sempre controlar as notificações. Permita que o usuário
desative as notificações
-de seu aplicativo ou altere as propriedades de alerta, como som de alerta e
+de seu aplicativo ou altere as propriedades de alerta, como som de alerta e
se a vibração será usada,
adicionando um item de configuração da notificação nas configurações do aplicativo.
Use ícones distintos
Ao olhar para a área de notificação, o usuário deverá ser capaz de discernir
-que tipos de
+que tipos de
notificações estão atualmente pendentes.
@@ -545,7 +545,7 @@ aplicativo que tenham aparência suficientemente distinta.
Use cores para distinguir o seu aplicativo dos outros. Ícones de notificação devem
+
Use cores para distinguir o seu aplicativo dos outros. Ícones de notificação devem
somente ser uma imagem com fundo branco sobre transparente.
@@ -599,7 +599,7 @@ aplicativo exige. Portanto, use notificações de forma cuidadosa.
Para criar um aplicativo que as pessoas gostem de usar, é importante
reconhecer que a atenção e o foco
-do usuário são recursos que devem ser protegidos. Apesar de o sistema de
+do usuário são recursos que devem ser protegidos. Apesar de o sistema de
notificação do Android ter
sido projetado para minimizar o impacto das notificações na atenção do usuário,
ainda é
@@ -617,7 +617,7 @@ alguma outra coisa.
Exemplos de notificação que depende de tempo
-
Apesar de aplicativos bem comportados geralmente se manifestarem apenas quando ocorre interação com eles, alguns
+
Apesar de aplicativos bem comportados geralmente se manifestarem apenas quando ocorre interação com eles, alguns
casos justificam que o aplicativo interrompa o usuário com uma notificação não solicitada.
Use notificações principalmente para eventos que dependam de tempo, especialmente
@@ -625,11 +625,11 @@ casos justificam que o aplicativo interrompa o usuário com uma notificação n
exemplo, um bate-papo recebido
é uma forma síncrona em tempo real de comunicação: outro usuário
espera ativamente a resposta. Eventos de calendário são outro exemplo bom de quando usar uma
-notificação e atrair a
+notificação e atrair a
atenção do usuário, pois o evento é iminente e eventos de calendário frequentemente
envolvem outras pessoas.
-
Quando não exibir
+
Quando não exibir
uma notificação
@@ -646,8 +646,8 @@ assíncronas e não direcionadas
que fluem por uma rede social geralmente não justificam uma interrupção
em tempo real. Para os usuários que se importam
com elas, deixe que decidam recebê-las.
-
Não crie uma notificação se as informações novas relevantes estiverem
-atualmente na tela. Em vez disso,
+
Não crie uma notificação se as informações novas relevantes estiverem
+atualmente na tela. Em vez disso,
use a IU do próprio aplicativo para notificar o usuário das novas informações
diretamente no contexto.
Por exemplo, um aplicativo de bate-papo não deve criar notificações de sistema enquanto o
@@ -655,12 +655,12 @@ usuário estiver conversando ativamente com outro usuário.
Não interrompa o usuário para realizar operações técnicas de baixo nível, como salvar
ou sincronizar informações, nem atualize um aplicativo se o aplicativo ou o sistema puder resolver
o problema sem envolver o usuário.
-
Não interrompa o usuário para informar um erro se o aplicativo
-puder se recuperar dele por conta própria, sem que o usuário
+
Não interrompa o usuário para informar um erro se o aplicativo
+puder se recuperar dele por conta própria, sem que o usuário
tome qualquer ação.
Não crie notificações que não tenham conteúdo real de notificação e
que meramente anunciem o seu
-aplicativo. Uma notificação deve fornecer informações úteis, oportunas e novas e
+aplicativo. Uma notificação deve fornecer informações úteis, oportunas e novas e
não deve ser usada
meramente para executar um aplicativo.
Não crie notificações supérfluas apenas para colocar sua marca na frente
@@ -673,7 +673,7 @@ com o seu
tela inicial.
-
Interação com
+
Interação com
notificações
Notificações são indicadas por ícones na barra de status e podem ser acessadas
@@ -692,7 +692,7 @@ Deslizar à esquerda ou à direita em uma notificação a remove da gaveta.
Notificações contínuas mantêm os usuários informados sobre um processo em andamento em
-segundo plano.
+segundo plano.
Por exemplo, reprodutores de música anunciam a faixa em reprodução no
sistema de notificação e
continuam a fazer isso até que o usuário interrompa a reprodução. Notificações contínuas também podem
@@ -701,7 +701,7 @@ feedback sobre tarefas mais longas, como o download de um arquivo ou a codifica
manualmente uma notificação contínua da gaveta de notificações.
Reprodução de mídia
-
No Android 5.0, a tela de bloqueio não mostra controles de transporte por causa da classe
+
No Android 5.0, a tela de bloqueio não mostra controles de transporte por causa da classe
{@link android.media.RemoteControlClient} obsoleta. Mas ela mostra notificações, portanto, a notificação de reprodução
de cada aplicativo agora é a forma
principal para que os usuários controlem a reprodução em um estado bloqueado. Esse comportamento dá aos aplicativos mais
@@ -724,12 +724,12 @@ Para obter orientação adicional sobre o uso de caixas de diálogo e avisos, co
Notificações são notícias e, portanto, são essencialmente exibidas
em ordem cronológica inversa, com
-consideração especial para a
+consideração especial para a
prioridade da notificação declarada no aplicativo.
Notificações são uma parte importante da tela de bloqueio e são exibidas proeminentemente
sempre
-que a tela do dispositivo é exibida. O espaço na tela de bloqueio é restrito, portanto,
+que a tela do dispositivo é exibida. O espaço na tela de bloqueio é restrito, portanto,
é mais importante
do que nunca identificar as notificações mais urgentes ou relevantes. Por esse
motivo, o Android tem um
@@ -762,14 +762,14 @@ recebem
Na tela de bloqueio
-
Como as notificações são visíveis na tela de bloqueio, a privacidade do usuário é uma consideração
+
Como as notificações são visíveis na tela de bloqueio, a privacidade do usuário é uma consideração
especialmente
- importante. Notificações frequentemente contêm informações sensíveis e
+ importante. Notificações frequentemente contêm informações sensíveis e
não devem necessariamente estar visíveis
para qualquer pessoa que ligar a tela do dispositivo.
-
Para dispositivos que têm uma tela de bloqueio segura (PIN, padrão ou senha), a interface tem
+
Para dispositivos que têm uma tela de bloqueio segura (PIN, padrão ou senha), a interface tem
partes públicas e privadas. A interface pública pode ser exibida em uma tela de bloqueio segura e,
portanto, vista por qualquer pessoa. A interface privada é o mundo atrás da tela de bloqueio e
só é revelada depois que o usuário faz login no dispositivo.
@@ -828,7 +828,7 @@ Os desenvolvedores podem controlar que notificações são enviadas do
celular ao relógio
e vice-versa. Os desenvolvedores também podem controlar quais ações são transmitidas. Se o
seu aplicativo inclui
-ações que não podem ser executadas com um toque, oculte essas ações
+ações que não podem ser executadas com um toque, oculte essas ações
na sua notificação do Wear
ou considere colocá-las em um aplicativo do Wear, permitindo que o usuário
termine a ação
diff --git a/docs/html-intl/intl/pt-br/guide/components/bound-services.jd b/docs/html-intl/intl/pt-br/guide/components/bound-services.jd
index aa024943160f9..032950eb962bb 100644
--- a/docs/html-intl/intl/pt-br/guide/components/bound-services.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/bound-services.jd
@@ -334,7 +334,7 @@ que o serviço realize vários encadeamentos, deve-se usar a estendendo a classe Binder para que tudo que ele tenha que fazer seja lançar
o {@link android.os.IBinder} retornado para a classe {@code LocalService} e solicitar a instância de {@code
LocalService}:
@@ -637,7 +637,7 @@ android.content.Context#stopService stopService()}, independente de vínculo
com qualquer cliente.
Além disso, se o serviço for iniciado e aceitar vínculos, quando o sistema chamar
-o método {@link android.app.Service#onUnbind onUnbind()}, será possível retornar
+o método {@link android.app.Service#onUnbind onUnbind()}, será possível retornar
{@code true} opcionalmente se você quiser receber uma chamada de {@link android.app.Service#onRebind
onRebind()} na próxima vez em que um cliente vincular-se ao serviço (em vez de receber uma chamada de {@link
android.app.Service#onBind onBind()}). {@link android.app.Service#onRebind
diff --git a/docs/html-intl/intl/pt-br/guide/components/fragments.jd b/docs/html-intl/intl/pt-br/guide/components/fragments.jd
index 7b1acf9e3439c..74f3dfe2d15b3 100644
--- a/docs/html-intl/intl/pt-br/guide/components/fragments.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/fragments.jd
@@ -36,7 +36,7 @@ parent.link=activities.html
Para ver uma atividade de exemplo que usa um fragmento como um trabalhador de segundo plano, sem uma IU, consulte o exemplo de {@code
-FragmentRetainInstance.java}, incluso nos exemplos do SDK (disponibilizados pelo
-Android SDK Manager) e localizado no sistema como
+FragmentRetainInstance.java}, incluso nos exemplos do SDK (disponibilizados pelo
+Android SDK Manager) e localizado no sistema como
<sdk_root>/APIDemos/app/src/main/java/com/example/android/apis/app/FragmentRetainInstance.java.
@@ -378,7 +378,7 @@ chame {@link android.app.Activity#getFragmentManager()} a partir da atividade.Adquirir fragmentos existentes na atividade, com {@link
android.app.FragmentManager#findFragmentById findFragmentById()} (para fragmentos que forneçam uma IU
no layout da atividade) ou {@link android.app.FragmentManager#findFragmentByTag
-findFragmentByTag()} (para fragmentos que forneçam ou não uma IU).
+findFragmentByTag()} (para fragmentos que forneçam ou não uma IU).
Retire os fragmentos da pilha de retorno com {@link
android.app.FragmentManager#popBackStack()} (simulando um comando de Voltar do usuário).
Registre uma escuta para as alterações na pilha de retorno com {@link
@@ -600,7 +600,7 @@ como usar o provedor de conteúdo estão disponíveis na documentação Adição de itens à barra de ação
-
Os fragmentos podem contribuir com itens de menu para o menu de opções da atividade (e, consequentemente, para a barra de ação) implementando
{@link android.app.Fragment#onCreateOptionsMenu(Menu,MenuInflater) onCreateOptionsMenu()}. Para que este método
receba chamadas, no entanto, você deve chamar {@link
android.app.Fragment#setHasOptionsMenu(boolean) setHasOptionsMenu()} durante {@link
@@ -785,7 +785,7 @@ android.widget.FrameLayout}), ou iniciar uma nova atividade (onde o fragmento po
O segundo fragmento, {@code DetailsFragment}, exibe o resumo da peça para o item selecionado
na lista de {@code TitlesFragment}:
Uma nova chamada da classe {@code TitlesFragment}, ou seja, se o usuário clicar em um item de lista
@@ -798,7 +798,7 @@ o resumo da peça selecionada quando a tela está na orientação de retrato:
Observe que esta atividade finaliza-se se a configuração for de paisagem,
pois a atividade principal pode tomar o controle e exibir {@code DetailsFragment} juntamente com {@code TitlesFragment}.
Isto pode acontecer se o usuário iniciar {@code DetailsActivity} enquanto estiver na orientação de retrato,
diff --git a/docs/html-intl/intl/pt-br/guide/components/fundamentals.jd b/docs/html-intl/intl/pt-br/guide/components/fundamentals.jd
index 47b98458e6429..2fb85531de8a6 100644
--- a/docs/html-intl/intl/pt-br/guide/components/fundamentals.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/fundamentals.jd
@@ -379,7 +379,7 @@ mas serviços externos, como o Google Play, as leem para oferecer uma filtragem
aos usuários quando buscam esses aplicativos para seu dispositivo.
Por exemplo: se o aplicativo exige uma câmera e usa APIs introduzidas no Android 2.1 (API de nível 7),
-deve-se declarar esses requisitos no arquivo de manifesto da seguinte forma:
+deve-se declarar esses requisitos no arquivo de manifesto da seguinte forma:
<manifest ... >
@@ -393,7 +393,7 @@ deve-se declarar esses requisitos no arquivo de manifesto da seguinte forma:
Assim, dispositivos que não tenham câmera e tenham
versão Android anterior a 2.1 não poderão instalar o aplicativo a partir do Google Play.
-
No entanto, também é possível declarar que o aplicativo usa a câmera como recurso
+
No entanto, também é possível declarar que o aplicativo usa a câmera como recurso
não obrigatório. Nesse caso, o aplicativo precisa definir o atributo {@code required}
como {@code "false"} e verificar em tempo de execução
se o dispositivo tem câmera e desativar os recursos da câmera conforme o necessário.
diff --git a/docs/html-intl/intl/pt-br/guide/components/index.jd b/docs/html-intl/intl/pt-br/guide/components/index.jd
index 02fcaa63c63a7..5131ead2239c3 100644
--- a/docs/html-intl/intl/pt-br/guide/components/index.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/index.jd
@@ -1,7 +1,7 @@
page.title=Componentes do aplicativo
page.landing=true
-page.landing.intro=A estrutura de aplicativo do Android permite criar aplicativos ricos e inovadores usando um conjunto de componentes reutilizáveis. Esta seção explica como criar os componentes que definem os blocos de construção do aplicativo e como conectá-los usando intenções.
-page.metaDescription=A estrutura de aplicativo do Android permite criar aplicativos ricos e inovadores usando um conjunto de componentes reutilizáveis. Esta seção mostra como criar os componentes que definem os blocos de construção do aplicativo e como conectá-los usando intenções.
+page.landing.intro=A estrutura de aplicativo do Android permite criar aplicativos ricos e inovadores usando um conjunto de componentes reutilizáveis. Esta seção explica como criar os componentes que definem os blocos de construção do aplicativo e como conectá-los usando intenções.
+page.metaDescription=A estrutura de aplicativo do Android permite criar aplicativos ricos e inovadores usando um conjunto de componentes reutilizáveis. Esta seção mostra como criar os componentes que definem os blocos de construção do aplicativo e como conectá-los usando intenções.
page.landing.image=images/develop/app_components.png
page.image=images/develop/app_components.png
@@ -11,7 +11,7 @@ page.image=images/develop/app_components.png
quando são recriados após uma alteração de configuração. Portanto, eles não precisam reconsultar
os dados.
-
+
Resumo da API de carregador
Há várias classes e interfaces que podem ser envolvidas no uso
@@ -68,7 +68,7 @@ de carregadores em um aplicativo. Elas são resumidas nesta tabela:
{@link android.app.Fragment} para gerenciar uma ou mais instâncias de {@link
android.content.Loader}. Isto ajuda um aplicativo a gerenciar
operações executadas por longos períodos juntamente com o ciclo de vida de {@link android.app.Activity}
-ou {@link android.app.Fragment}; o uso mais comum disto é com
+ou {@link android.app.Fragment}; o uso mais comum disto é com
{@link android.content.CursorLoader}. No entanto, os aplicativos têm a liberdade de criar
os próprios carregadores para outros tipos de dados.
@@ -129,7 +129,7 @@ de {@link android.content.Loader} ou {@link android.content.AsyncTaskLoader}
para carregar dados de outra origem.
Uma implementação de {@link android.app.LoaderManager.LoaderCallbacks}.
É aqui que é possível criar novos carregadores e gerenciar as referências
-a carregadores existentes.
+a carregadores existentes.
Uma maneira de exibir os dados do carregador, como um {@link
android.widget.SimpleCursorAdapter}.
Uma origem de dados, como um {@link android.content.ContentProvider}, ao usar
@@ -140,7 +140,7 @@ android.widget.SimpleCursorAdapter}.
O {@link android.app.LoaderManager} gerencia uma ou mais instâncias de {@link
android.content.Loader} dentro de uma {@link android.app.Activity}
ou um {@link android.app.Fragment}. Há apenas um {@link
-android.app.LoaderManager} por atividade ou fragmento.
+android.app.LoaderManager} por atividade ou fragmento.
Geralmente,
inicializa-se um {@link android.content.Loader} dentro do método {@link
@@ -157,13 +157,13 @@ recebe os seguintes parâmetros:
Um ID único que identifica o carregador. Neste exemplo, o ID é 0.
Argumentos opcionais para fornecer ao carregador
-em construção (null neste exemplo).
+em construção (null neste exemplo).
Uma implementação de {@link android.app.LoaderManager.LoaderCallbacks},
que {@link android.app.LoaderManager} chama para relatar eventos do carregador. Nesse exemplo,
a classe local implementa a interface de {@link
android.app.LoaderManager.LoaderCallbacks}, para que ela passe uma referência
-para si, {@code this}.
+para si, {@code this}.
A chamada de {@link android.app.LoaderManager#initLoader initLoader()} garante que o carregador
foi inicializado e que está ativo. Ela possui dois possíveis resultados:
@@ -193,7 +193,7 @@ a vida do carregador automaticamente. O {@link android.app.LoaderManager}
inicia e interrompe o carregamento quando necessário, além de manter o estado do carregador
e do conteúdo associado. À medida que isso ocorre, você raramente interage com os carregadores
diretamente (para ver um exemplo de métodos para aprimorar o comportamento
-de um carregador, consulte o exemplo de LoaderThrottle).
+de um carregador, consulte o exemplo de LoaderThrottle).
Geralmente, usam-se os métodos {@link
android.app.LoaderManager.LoaderCallbacks} para intervir no processo de carregamento
quando determinados eventos ocorrem. Para obter mais informações sobre este assunto, consulte Uso dos retornos de chamada de LoaderManager.
@@ -245,7 +245,7 @@ instancia e retorna um novo {@link android.content.Loader} para o ID fornecido.
— chamado quando um carregador anteriormente criado termina o seu carregamento.
{@link android.app.LoaderManager.LoaderCallbacks#onLoaderReset onLoaderReset()}
— chamado quando um carregador anteriormente criado é reiniciado,
tornando os dados indisponíveis.
Este método é chamado quando um carregador anteriormente criado é reiniciado,
tornando os dados indisponíveis. Este retorno de chamada permite que você descubra quando os dados
estão prestes a serem liberados para que seja possível remover a referência a eles.
-
Esta implementação chama
+
Esta implementação chama
{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}
com um valor de null:
@@ -366,7 +366,7 @@ public void onLoaderReset(Loader<Cursor> loader) {
android.app.Fragment} que exibe uma {@link android.widget.ListView} contendo
os resultados de uma consulta aos provedores de conteúdo de contatos. Ela usa um {@link
android.content.CursorLoader} para gerenciar a consulta no provedor.
-
+
Para um aplicativo acessar os contatos de um usuário, como neste exemplo,
o manifesto deverá incluir a permissão
{@link android.Manifest.permission#READ_CONTACTS READ_CONTACTS}.
diff --git a/docs/html-intl/intl/pt-br/guide/components/processes-and-threads.jd b/docs/html-intl/intl/pt-br/guide/components/processes-and-threads.jd
index c8e636dacce83..9bd335d98e8fd 100644
--- a/docs/html-intl/intl/pt-br/guide/components/processes-and-threads.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/processes-and-threads.jd
@@ -120,7 +120,7 @@ o dispositivo atingiu o estado de paginação de memória. Portanto, eliminar al
Se ele hospedar um {@link android.app.Activity} que não esteja em primeiro plano,
-mas ainda seja visível para o usuário (o seu método {@link android.app.Activity#onPause onPause()} tiver sido chamado).
+mas ainda seja visível para o usuário (o seu método {@link android.app.Activity#onPause onPause()} tiver sido chamado).
Isto poderá ocorrer, por exemplo, se a atividade em primeiro plano iniciar um diálogo, o que permitirá
que a atividade anterior seja vista por trás dela.
@@ -319,7 +319,7 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
protected Bitmap doInBackground(String... urls) {
return loadImageFromNetwork(urls[0]);
}
-
+
/** The system calls this to perform work in the UI thread and delivers
* the result from doInBackground() */
protected void onPostExecute(Bitmap result) {
diff --git a/docs/html-intl/intl/pt-br/guide/components/recents.jd b/docs/html-intl/intl/pt-br/guide/components/recents.jd
index 467f62067a546..9f7588593bba4 100644
--- a/docs/html-intl/intl/pt-br/guide/components/recents.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/recents.jd
@@ -41,7 +41,7 @@ page.tags="recents","overview"
atividades e tarefas acessadas recentemente. O
usuário pode navegar pela lista e selecionar uma tarefa a retomar ou remover uma tarefa da
lista deslizando-a para fora. Com a versão 5.0 do Android (API de nível 21), várias instâncias da
-mesma atividade contendo diferentes documentos podem aparecer como tarefas na tela de visão geral. Por exemplo, o
+mesma atividade contendo diferentes documentos podem aparecer como tarefas na tela de visão geral. Por exemplo, o
Google Drive pode ter uma tarefa para cada um dos vários documentos do Google. Cada documento aparece como uma
tarefa na tela de visão geral.
@@ -158,8 +158,8 @@ efeitos quando o usuário abre um documento com o aplicativo:
"{@code intoExisting}"
A atividade reutiliza uma tarefa existente para o documento. Isso é o mesmo que configurar o
- sinalizador {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} sem configurar
- o sinalizador {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}, como descrito em
+ sinalizador {@link android.content.Intent#FLAG_ACTIVITY_NEW_DOCUMENT} sem configurar
+ o sinalizador {@link android.content.Intent#FLAG_ACTIVITY_MULTIPLE_TASK}, como descrito em
Uso do sinalizador Intent para adicionar uma tarefa acima.
"{@code always}"
@@ -169,7 +169,7 @@ efeitos quando o usuário abre um documento com o aplicativo:
"{@code none”}"
A atividade não cria uma nova tarefa para o documento. A tela de visão geral trata a
- atividade como aconteceria por padrão: ela exibe uma tarefa para o aplicativo, que
+ atividade como aconteceria por padrão: ela exibe uma tarefa para o aplicativo, que
retoma a atividade invocada por último pelo usuário.
"{@code never}"
@@ -205,7 +205,7 @@ recentemente é removida da tela de visão geral. O valor máximo de {@code andr
Uso da classe AppTask para remover tarefas
-
Na atividade que cria uma nova tarefa na tela de visão geral, é possível
+
Na atividade que cria uma nova tarefa na tela de visão geral, é possível
especificar quando remover a tarefa e terminar todas as atividades associadas a ela chamando
o método {@link android.app.ActivityManager.AppTask#finishAndRemoveTask() finishAndRemoveTask()}.
diff --git a/docs/html-intl/intl/pt-br/guide/components/services.jd b/docs/html-intl/intl/pt-br/guide/components/services.jd
index 123d90ac9cb32..564ac80d3506c 100644
--- a/docs/html-intl/intl/pt-br/guide/components/services.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/services.jd
@@ -185,7 +185,7 @@ usá-los a partir de outros componentes do aplicativo.
Como atividades (e outros componentes), você deve declarar todos os serviços no arquivo de manifesto
do aplicativo.
É possível iniciar um dispositivo de uma atividade ou outro componente do aplicativo passando uma
+
É possível iniciar um dispositivo de uma atividade ou outro componente do aplicativo passando uma
{@link android.content.Intent} a {@link
android.content.Context#startService startService()}. O sistema Android chama o método {@link
android.app.Service#onStartCommand onStartCommand()} do serviço e passa a ele a {@link
diff --git a/docs/html-intl/intl/pt-br/guide/components/tasks-and-back-stack.jd b/docs/html-intl/intl/pt-br/guide/components/tasks-and-back-stack.jd
index d309c6704f376..8e485b0fc939d 100644
--- a/docs/html-intl/intl/pt-br/guide/components/tasks-and-back-stack.jd
+++ b/docs/html-intl/intl/pt-br/guide/components/tasks-and-back-stack.jd
@@ -77,7 +77,7 @@ android.app.Fragment} class documentation.
-->
-
A tela inicial do dispositivo é o ponto de partida para a maioria das tarefas. Quando o usuário toca em um ícone no inicializador do
+
A tela inicial do dispositivo é o ponto de partida para a maioria das tarefas. Quando o usuário toca em um ícone no inicializador do
aplicativo
(ou em um atalho na tela inicial), essa tarefa do aplicativo acontece em primeiro plano. Se não
existir nenhuma tarefa para o aplicativo (se o aplicativo não tiver sido usado recentemente), uma nova tarefa
@@ -85,7 +85,7 @@ será criada e a atividade "principal" daquele aplicativo abrirá como a ativida
Quando a atividade atual inicia outra, a nova atividade é colocada no topo da pilha
e recebe foco. A atividade anterior permanece na pilha, mas é interrompida. Quando uma atividade
-para, o sistema retém o estado atual da interface do usuário. Quando o usuário pressiona o botão
+para, o sistema retém o estado atual da interface do usuário. Quando o usuário pressiona o botão
Voltar
, a atividade atual é retirada do topo da pilha (a atividade é destruída)
e a atividade anterior reinicia (o estado anterior da IU é restaurado). Atividades na pilha nunca
@@ -103,7 +103,7 @@ a atividade atual é
destruída e a atividade anterior reinicia.
-
Se o usuário continua pressionando Voltar, cada atividade na pilha é retirada para
+
Se o usuário continua pressionando Voltar, cada atividade na pilha é retirada para
revelar
a anterior até que o usuário retorne à tela inicial (ou a qualquer atividade que estivesse em execução
no começo da tarefa). Quando todas as atividades forem removidas da pilha, a tarefa não existirá mais.
@@ -295,7 +295,7 @@ launchMode} do elemento
O atributo {@code
launchMode} especifica uma instrução sobre como a atividade deve ser inicializada
-em uma tarefa. Há quatro modos diferentes de inicialização que podem ser designados ao atributo
+em uma tarefa. Há quatro modos diferentes de inicialização que podem ser designados ao atributo
launchMode:
@@ -334,7 +334,7 @@ Entretanto, se uma instância da atividade já existir em uma tarefa separada, o
a intenção àquela instância por meio de uma chamada do método {@link
android.app.Activity#onNewIntent onNewIntent()} em vez de criar uma nova instância. Somente
uma instância da atividade pode existir por vez.
-
Observação: embora a atividade inicie em uma nova tarefa, o botão
+
Observação: embora a atividade inicie em uma nova tarefa, o botão
Voltar ainda direciona o usuário à atividade anterior.
{@code "singleInstance"}.
Igual à {@code "singleTask"}, exceto que o sistema não inicializa nenhuma outra atividade
@@ -505,7 +505,7 @@ A tarefa reterá todas as atividades em sua pilha mesmo após um longo período.
href="{@docRoot}guide/topics/manifest/activity-element.html#clear">clearTaskOnLaunch
Se esse atributo for definido como {@code "true"} na atividade raiz de uma tarefa,
a pilha será apagada da atividade raiz sempre que o usuário sair da tarefa
-e retornar a ela. Em outras palavras, é o oposto de
+e retornar a ela. Em outras palavras, é o oposto de
{@code alwaysRetainTaskState}. O usuário sempre retorna à tarefa
no estado inicial, mesmo ao retirar-se da tarefa somente por um momento.
@@ -557,13 +557,13 @@ nova tarefa, e o usuário perderia algum tempo trabalhando nessa tarefa. O usuá
Página inicial. A tarefa é enviada para segundo plano e não fica mais visível. O usuário não tem como voltar
à tarefa porque ela não é representada no inicializador do aplicativo.
-
Para esses casos em que se deseja que o usuário não seja capaz de retornar a uma atividade, defina
+
Para esses casos em que se deseja que o usuário não seja capaz de retornar a uma atividade, defina
{@code finishOnTaskLaunch}
- do elemento
+ do elemento
<activity>
como {@code "true"} (consulte Apagar a pilha).
-
Veja mais informações sobre a representação e o gerenciamento de atividades
+
Veja mais informações sobre a representação e o gerenciamento de atividades
na tela de visão geral em
Tela de visão geral.
diff --git a/docs/html-intl/intl/pt-br/guide/index.jd b/docs/html-intl/intl/pt-br/guide/index.jd
index ab396477e2506..74151ccd26ba6 100644
--- a/docs/html-intl/intl/pt-br/guide/index.jd
+++ b/docs/html-intl/intl/pt-br/guide/index.jd
@@ -29,7 +29,7 @@ tela para a interface de usuário e um serviço realiza trabalho
em segundo plano de forma independente.
De um componente, é possível executar outro componente usando uma intenção. É possível até mesmo
-iniciar um componente em um aplicativo diferente, como uma atividade em um aplicativo de mapas para mostrar um endereço. Esse modelo
+iniciar um componente em um aplicativo diferente, como uma atividade em um aplicativo de mapas para mostrar um endereço. Esse modelo
fornece vários pontos de entrada para um único aplicativo e permite que qualquer aplicativo se comporte como o "padrão" de um usuário
para uma ação que outros aplicativos podem invocar.
@@ -53,7 +53,7 @@ diferentes configurações de dispositivos. Por exemplo, é possível criar dife
de layout para diversos tamanhos de tela e o sistema
determina qual layout deverá aplicar com base no tamanho da tela do dispositivo atual.
-
Você pode consultar a disponibilidade dos recursos do dispositivo em tempo de execução se qualquer recurso do
+
Você pode consultar a disponibilidade dos recursos do dispositivo em tempo de execução se qualquer recurso do
aplicativo exigir hardware específico, como uma câmera. Se necessário, também é possível declarar recursos que o aplicativo exige,
para que mercados como a Google Play Store não permitam a instalação em dispositivos que não sejam compatíveis
com aquele recurso.
diff --git a/docs/html-intl/intl/pt-br/guide/topics/manifest/manifest-intro.jd b/docs/html-intl/intl/pt-br/guide/topics/manifest/manifest-intro.jd
index e33779684a5c0..639b6dbf4bf13 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/manifest/manifest-intro.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/manifest/manifest-intro.jd
@@ -34,14 +34,14 @@ O nome do pacote serve como identificador exclusivo para o aplicativo.
Descrever os componentes do aplicativo — as atividades,
os serviços, os receptores de transmissão e os provedores de conteúdo que compõem
o aplicativo. Nomear as classes que implementam os componentes
-e publicam seus recursos (por exemplo, que mensagens {@link android.content.Intent
+e publicam seus recursos (por exemplo, que mensagens {@link android.content.Intent
Intent} eles podem tratar). Essas declarações permitem ao sistema Android
saber quais são os componentes e em que condições eles podem ser iniciados.
-
Determinar que processos hospedarão componentes de aplicativo.
+
Determinar que processos hospedarão componentes de aplicativo.
Declarar as permissões que o aplicativo deve ter para acessar
-partes protegidas da API e interagir com outros aplicativos.
+partes protegidas da API e interagir com outros aplicativos.
Declarar também as permissões que outros devem ter
para interagir com os componentes do aplicativo.
@@ -66,7 +66,7 @@ elemento que ele pode conter. Cada elemento e seus atributos
são documentados na totalidade em um arquivo separado. Para exibir informações detalhadas
sobre cada elemento, clique no nome do elemento no diagrama,
na lista de elementos em ordem alfabética que acompanha o diagrama
-ou em qualquer outra menção ao nome do elemento.
+ou em qualquer outra menção ao nome do elemento.
@@ -128,7 +128,7 @@ ou em qualquer outra menção ao nome do elemento.
Todos os elementos que podem aparecer no arquivo de manifesto estão
relacionados abaixo em ordem alfabética. Estes são os únicos elementos legais. Não é possível
-adicionar elementos ou atributos próprios.
+adicionar elementos ou atributos próprios.
@@ -158,7 +158,7 @@ adicionar elementos ou atributos próprios.
-
+
Convenções de arquivos
@@ -172,25 +172,25 @@ no manifesto:
Somente os elementos
<manifest>
e <application>
-são necessários — eles devem estar presentes e ocorrer somente uma vez.
+são necessários — eles devem estar presentes e ocorrer somente uma vez.
A maioria dos outros pode ocorrer diversas vezes ou nunca — embora
pelo menos alguns deles devam estar presentes para que o manifesto
realize algo significativo.
-Se um elemento contiver qualquer coisa, ele conterá outros elementos.
+Se um elemento contiver qualquer coisa, ele conterá outros elementos.
Todos os valores são definidos por meio de atributos, e não como dados de caracteres dentro de um elemento.
Elementos de mesmo nível geralmente não são ordenados. Por exemplo: os elementos
-<activity>,
+<activity>,
<provider>
-e <service>
-podem ser combinados entre si em qualquer sequência. (O elemento
+e <service>
+podem ser combinados entre si em qualquer sequência. (O elemento
<activity-alias>
-é uma exceção a essa regra: ele deve seguir o
-<activity>
+é uma exceção a essa regra: ele deve seguir o
+<activity>
para o qual é alias.)
@@ -200,32 +200,32 @@ devem ser especificados para um elemento para cumprir a sua finalidade. Use
a documentação como guia. Para atributos verdadeiramente opcionais, ele menciona
um valor padrão ou declara o que acontece na ausência de uma especificação.
-
Exceto por alguns atributos do elemento
+
Exceto por alguns atributos do elemento
<manifest>
-raiz, todos os nomes de atributo têm um prefixo {@code android:} —
+raiz, todos os nomes de atributo têm um prefixo {@code android:} —
por exemplo, {@code android:alwaysRetainTaskState}. Como o prefixo é universal,
a documentação geralmente o omite ao referir-se a atributos
pelo nome.
Declaração de nomes de classe
Muitos elementos correspondem a objetos Java, inclusive elementos do próprio
-aplicativo (o elemento
-<application>
-) e seus componentes principais — atividades
-(<activity>),
-serviços
-(<service>),
-receptores de transmissão
-(<receiver>)
-e provedores de conteúdo
-(<provider>).
+aplicativo (o elemento
+<application>
+) e seus componentes principais — atividades
+(<activity>),
+serviços
+(<service>),
+receptores de transmissão
+(<receiver>)
+e provedores de conteúdo
+(<provider>).
-Se uma subclasse for definida, como quase sempre acontece para classes de componentes
-({@link android.app.Activity}, {@link android.app.Service},
-{@link android.content.BroadcastReceiver} e {@link android.content.ContentProvider}),
+Se uma subclasse for definida, como quase sempre acontece para classes de componentes
+({@link android.app.Activity}, {@link android.app.Service},
+{@link android.content.BroadcastReceiver} e {@link android.content.ContentProvider}),
a subclasse será declarada por meio de um atributo {@code name}. O nome deve conter
-toda a designação do pacote.
+toda a designação do pacote.
Por exemplo: uma subclasse {@link android.app.Service} pode ser declarada assim:
@@ -240,11 +240,11 @@ Por exemplo: uma subclasse {@link android.app.Service} pode ser declarada assim:
No entanto, para encurtar, se o primeiro caractere da string for um ponto,
-a string será acrescentada ao nome do pacote do aplicativo (conforme especificado pelo atributo
-package
- do elemento
-<manifest>
-). A seguinte atribuição é igual à atribuição acima:
+a string será acrescentada ao nome do pacote do aplicativo (conforme especificado pelo atributo
+package
+ do elemento
+<manifest>
+). A seguinte atribuição é igual à atribuição acima:
<manifest package="com.example.project" . . . >
@@ -257,13 +257,13 @@ a string será acrescentada ao nome do pacote do aplicativo (conforme especifica
</manifest>
-Ao iniciar um componente, o Android cria uma instância da subclasse nomeada.
+Ao iniciar um componente, o Android cria uma instância da subclasse nomeada.
Se nenhuma subclasse for especificada, ele criará uma instância da classe base.
Vários valores
Se for especificado mais de um valor, o elemento sempre será repetido
-em vez de listar os vários valores dentro de um único elemento.
+em vez de listar os vários valores dentro de um único elemento.
Por exemplo, um filtro de intenção pode listar algumas ações:
<intent-filter . . . >
@@ -276,22 +276,22 @@ Por exemplo, um filtro de intenção pode listar algumas ações:
Valores de recurso
Alguns atributos têm valores que podem ser exibidos aos usuários — por exemplo,
uma etiqueta e um ícone de uma atividade. Os valores desses atributos
-devem ser localizados e, por tanto, definidos a partir de um recurso ou tema. Os valores
+devem ser localizados e, por tanto, definidos a partir de um recurso ou tema. Os valores
de recurso são expressos no formato a seguir:
{@code @[pacote:]tipo:nome}
em que o nome do pacote pode ser omitido se o recurso estiver no mesmo pacote
-que o aplicativo tipo é um tipo de recurso — como uma "string" ou
-"drawable" (desenhável) — e nome é o nome que identifica o recurso específico.
+que o aplicativo tipo é um tipo de recurso — como uma "string" ou
+"drawable" (desenhável) — e nome é o nome que identifica o recurso específico.
Por exemplo:
-Os valores de um tema são expressos de forma semelhante, mas, com um '{@code ?}'
+Os valores de um tema são expressos de forma semelhante, mas, com um '{@code ?}'
em vez de '{@code @}':
@@ -299,8 +299,8 @@ em vez de '{@code @}':
Valores de string
-
Quando o valor de um atributo é uma string, devem-se usar duas barras invertidas ('{@code \\}')
-para caracteres de escape — por exemplo, '{@code \\n}' para
+
Quando o valor de um atributo é uma string, devem-se usar duas barras invertidas ('{@code \\}')
+para caracteres de escape — por exemplo, '{@code \\n}' para
uma nova linha ou '{@code \\uxxxx}' para um caractere Unicode.
@@ -320,7 +320,7 @@ Os componentes fundamentais de um aplicativo (suas atividades, serviços e recep
de transmissão) são ativados por intenções. Intenções são
pacotes de informações (objetos {@link android.content.Intent}) que descrevem
uma ação desejada — inclusive os dados usados em ações, a categoria
-do componente que deve executar a ação e outras instruções pertinentes.
+do componente que deve executar a ação e outras instruções pertinentes.
O Android localiza um componente adequado para responder à intenção, inicia
uma nova instância do componente se necessário e passa-o
ao objeto da intenção.
@@ -330,7 +330,7 @@ ao objeto da intenção.
Os componentes anunciam seus recursos — os tipos de intenção aos quais eles podem
responder — por meio de filtros de intenções. Como o sistema Android
precisa saber que intenções um componente pode tratar antes de iniciá-lo, os filtros
-de intenções são especificados no manifesto como elementos
+de intenções são especificados no manifesto como elementos
<intent-filter>
. Os componentes podem ter qualquer quantidade de filtros, em que cada um descreve
um recurso diferente.
@@ -345,8 +345,8 @@ do componente.
@@ -355,41 +355,41 @@ e filtros de intenções em separado.
Alguns elementos têm atributos {@code icon} e {@code label} de um pequeno ícone
-e uma etiqueta de texto que pode ficar visível para os usuários. Alguns deles também têm um atributo
-{@code description} para um texto explicativo mais longo que também pode ser
-exibido na tela. Por exemplo: o elemento
+e uma etiqueta de texto que pode ficar visível para os usuários. Alguns deles também têm um atributo
+{@code description} para um texto explicativo mais longo que também pode ser
+exibido na tela. Por exemplo: o elemento
<permission>
-tem todos os três atributos; assim, quando o usuário é consultado para dar
-permissão a um aplicativo que a solicitou, serão apresentados ao usuário um ícone
-que representa a permissão, o nome da permissão e uma descrição
+tem todos os três atributos; assim, quando o usuário é consultado para dar
+permissão a um aplicativo que a solicitou, serão apresentados ao usuário um ícone
+que representa a permissão, o nome da permissão e uma descrição
de tudo o que está envolvido.
-Em todo caso, o ícone e a etiqueta definidos em um elemento recipiente se tornam as configurações
-{@code icon} e {@code label} padrão de todos os subelementos do contêiner.
-Assim, o ícone e a etiqueta definidos no elemento
-<application>
-são o ícone e a etiqueta padrão para cada um dos componentes do aplicativo.
-Da mesma forma, o ícone e a etiqueta definidos para um componente — por exemplo, um elemento
-<activity>
- — são as configurações padrão para cada um dos elementos
-<intent-filter>
+Em todo caso, o ícone e a etiqueta definidos em um elemento recipiente se tornam as configurações
+{@code icon} e {@code label} padrão de todos os subelementos do contêiner.
+Assim, o ícone e a etiqueta definidos no elemento
+<application>
+são o ícone e a etiqueta padrão para cada um dos componentes do aplicativo.
+Da mesma forma, o ícone e a etiqueta definidos para um componente — por exemplo, um elemento
+<activity>
+ — são as configurações padrão para cada um dos elementos
+<intent-filter>
do componente. Se um elemento
-<application>
-define uma etiqueta, mas uma atividade e seu filtro de intenção não definem,
-a etiqueta do aplicativo é tratada como a etiqueta de atividade
+<application>
+define uma etiqueta, mas uma atividade e seu filtro de intenção não definem,
+a etiqueta do aplicativo é tratada como a etiqueta de atividade
e do filtro de intenção.
-O ícone e a etiqueta definidos para um filtro de intenção são usados para representar um componente
+O ícone e a etiqueta definidos para um filtro de intenção são usados para representar um componente
apresentado para o usuário para preencher a função
-anunciada pelo filtro. Por exemplo: um filtro com as configurações
-"{@code android.intent.action.MAIN}" e
-"{@code android.intent.category.LAUNCHER}" anuncia uma atividade
+anunciada pelo filtro. Por exemplo: um filtro com as configurações
+"{@code android.intent.action.MAIN}" e
+"{@code android.intent.category.LAUNCHER}" anuncia uma atividade
como uma que inicia um aplicativo — ou seja,
-que deve ser exibida no inicializador do aplicativo. O ícone e a etiqueta
+que deve ser exibida no inicializador do aplicativo. O ícone e a etiqueta
definidos no filtro são, portanto, as exibidas no inicializador.
@@ -397,14 +397,14 @@ definidos no filtro são, portanto, as exibidas no inicializador.
Permissões
-As permissões são restrições que limitam o acesso a parte do código
-ou aos dados de um dispositivo. A limitação é imposta para proteger dados
-essenciais que podem sofrer mau uso e distorções ou prejudicar a experiência do usuário.
+As permissões são restrições que limitam o acesso a parte do código
+ou aos dados de um dispositivo. A limitação é imposta para proteger dados
+essenciais que podem sofrer mau uso e distorções ou prejudicar a experiência do usuário.
-Cada permissão é identificada por uma etiqueta exclusiva. Geralmente a etiqueta indica
-a ação que foi restringida. A seguir há alguns exemplos de permissões definidas
+Cada permissão é identificada por uma etiqueta exclusiva. Geralmente a etiqueta indica
+a ação que foi restringida. A seguir há alguns exemplos de permissões definidas
pelo Android:
@@ -418,25 +418,25 @@ Um recurso pode ser protegido por, no máximo, uma permissão.
-Se um aplicativo precisar de acesso a um recurso protegido por uma permissão,
-ele deve declarar que precisa da permissão com um elemento
-<uses-permission>
-no manifesto. Assim, quando o aplicativo é instalado
-no dispositivo, o instalador determina se concederá ou não a permissão
-solicitada, marcando as autoridades que assinaram os certificados
-do aplicativo e, em alguns casos, perguntando ao usuário.
-Se a permissão for concedida, o aplicativo será capaz de usar os recursos
-protegidos. Caso contrário, sua tentativa de acessar esses recursos simplesmente falhará
-sem nenhuma notificação ao usuário.
+Se um aplicativo precisar de acesso a um recurso protegido por uma permissão,
+ele deve declarar que precisa da permissão com um elemento
+<uses-permission>
+no manifesto. Assim, quando o aplicativo é instalado
+no dispositivo, o instalador determina se concederá ou não a permissão
+solicitada, marcando as autoridades que assinaram os certificados
+do aplicativo e, em alguns casos, perguntando ao usuário.
+Se a permissão for concedida, o aplicativo será capaz de usar os recursos
+protegidos. Caso contrário, sua tentativa de acessar esses recursos simplesmente falhará
+sem nenhuma notificação ao usuário.
-Um aplicativo também pode proteger seus componentes (atividades, serviços,
-receptores de transmissão e provedores de conteúdo) com permissões. Ele pode empregar
-qualquer uma das permissões definidas pelo Android (listadas em
-{@link android.Manifest.permission android.Manifest.permission}) ou declaradas
-por outros aplicativos. Ou então, ele pode definir as suas próprias. As novas permissões são declaradas
-com o elemento
+Um aplicativo também pode proteger seus componentes (atividades, serviços,
+receptores de transmissão e provedores de conteúdo) com permissões. Ele pode empregar
+qualquer uma das permissões definidas pelo Android (listadas em
+{@link android.Manifest.permission android.Manifest.permission}) ou declaradas
+por outros aplicativos. Ou então, ele pode definir as suas próprias. As novas permissões são declaradas
+com o elemento
<permission>.
Por exemplo: uma atividade pode ser protegida da seguinte forma:
@@ -458,41 +458,41 @@ com o elemento
Observe que, nesse exemplo, a permissão {@code DEBIT_ACCT}, além de declarada
-com o elemento
+com o elemento
<permission>
-, tem seu uso solicitado com o elemento
+, tem seu uso solicitado com o elemento
<uses-permission>.
Ela deve ser solicitada para que outros componentes do aplicativo
-iniciem a atividade protegida, mesmo que a proteção
-seja imposta pelo próprio aplicativo.
+iniciem a atividade protegida, mesmo que a proteção
+seja imposta pelo próprio aplicativo.
Se, no mesmo exemplo, o atributo {@code permission} fosse definido
-como uma permissão declarada em outro lugar
+como uma permissão declarada em outro lugar
(como {@code android.permission.CALL_EMERGENCY_NUMBERS}), não seria
-necessário declará-la novamente com um elemento
+necessário declará-la novamente com um elemento
<permission>.
- No entanto, ainda seria necessário solicitar seu uso com
-<uses-permission>.
+ No entanto, ainda seria necessário solicitar seu uso com
+<uses-permission>.
-O elemento
-<permission-tree>
-declara um espaço de nome de um grupo de permissões que será definido
-no código. E
+O elemento
+<permission-tree>
+declara um espaço de nome de um grupo de permissões que será definido
+no código. E
<permission-group>
-define um etiqueta de um conjunto de permissões (os dois declarados no manifesto com elementos
-<permission>
-e as declaradas em outro lugar). Ele afeta somente a forma com que as permissões estão
-agrupadas quando apresentadas ao usuário. O elemento
+define um etiqueta de um conjunto de permissões (os dois declarados no manifesto com elementos
+<permission>
+e as declaradas em outro lugar). Ele afeta somente a forma com que as permissões estão
+agrupadas quando apresentadas ao usuário. O elemento
<permission-group>
-não especifica que permissões pertencem ao grupo;
+não especifica que permissões pertencem ao grupo;
ele só dá um nome ao grupo. Para incluir uma permissão no grupo,
-designa-se o nome do grupo ao atributo
-permissionGroup
- do elemento
+designa-se o nome do grupo ao atributo
+permissionGroup
+ do elemento
<permission>.
@@ -501,17 +501,17 @@ designa-se o nome do grupo ao atributo
Bibliotecas
-Todo aplicativo está vinculado à biblioteca Android padrão, que
-contém os pacotes básicos para programar aplicativos (com classes comuns
+Todo aplicativo está vinculado à biblioteca Android padrão, que
+contém os pacotes básicos para programar aplicativos (com classes comuns
tais como Activity, Service, Intent, View, Button, Application, ContentProvider
etc.).
-No entanto, alguns pacotes residem em suas próprias bibliotecas. Se o aplicativo
-usar código de algum desses pacotes, ele deve receber solicitação explícita para ser
-vinculado a eles. O manifesto deve conter um elemento
+No entanto, alguns pacotes residem em suas próprias bibliotecas. Se o aplicativo
+usar código de algum desses pacotes, ele deve receber solicitação explícita para ser
+vinculado a eles. O manifesto deve conter um elemento
<uses-library>
- separado para nomear cada uma das bibliotecas (o nome da biblioteca se encontra
+ separado para nomear cada uma das bibliotecas (o nome da biblioteca se encontra
na documentação do pacote).
diff --git a/docs/html-intl/intl/pt-br/guide/topics/providers/calendar-provider.jd b/docs/html-intl/intl/pt-br/guide/topics/providers/calendar-provider.jd
index ce72b7db5cff0..42a517b73783f 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/providers/calendar-provider.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/providers/calendar-provider.jd
@@ -42,7 +42,7 @@ page.title=Provedor de agenda
Essa tabela contém
as informações específicas da agenda. Cada linha nessa tabela contém os detalhes
de uma única agenda, como nome, cor, informações de sincronização etc.
{@link android.provider.CalendarContract.Events}
-
+
Essa tabela contém
as informações específicas do evento. Cada linha nessa tabela tem as informações de um único
evento — por exemplo: título do evento, local, horário de início, horário
de término etc. O evento pode ocorrer uma vez ou diversas vezes. Os participantes,
-lembretes e propriedades estendidas são armazenados em tabelas separadas.
+lembretes e propriedades estendidas são armazenados em tabelas separadas.
Cada um deles tem um {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
que referencia o {@link android.provider.BaseColumns#_ID} na tabela de eventos.
Essa tabela contém os
horários de início e término para cada ocorrência em um evento. Cada linha nessa tabela
representa uma única ocorrência do evento. Para eventos de ocorrência única, há um mapeamento 1:1
@@ -141,7 +141,7 @@ a diversas ocorrências daquele evento são geradas automaticamente.
Essa tabela contém
as informações dos participantes (convidados) do evento. Cada linha representa um único convidado
de um evento. Ela especifica o tipo de convidado e a resposta quanto à participação do convidado
@@ -149,7 +149,7 @@ no evento.
Essa tabela contém os
dados de alerta/notificação. Cada linha representa um único alerta de um evento. Um evento
pode ter vários lembretes. O número máximo de lembretes por evento
@@ -159,7 +159,7 @@ que é definido pelo adaptador de sincronização
que possui a agenda fornecida. Os lembretes são especificados em minutos antes do evento
e têm um método que determina a forma de alertar o usuário.
-
+
A API do Provedor de Agenda é projetada para ser flexível e poderosa. Ao mesmo tempo,
@@ -211,7 +211,7 @@ para excluir, inserir ou atualizar dados da agenda:
A tabela {@link android.provider.CalendarContract.Calendars} contém detalhes
de agendas individuais. As colunas
-Agendas a seguir são graváveis tanto por aplicativos quanto por adaptadores de sincronização.
+Agendas a seguir são graváveis tanto por aplicativos quanto por adaptadores de sincronização.
Para obter uma lista completa de campos compatíveis, consulte
a referência {@link android.provider.CalendarContract.Calendars}
@@ -229,7 +229,7 @@ a referência {@link android.provider.CalendarContract.Calendars}
Um booleano indicando se a agenda foi selecionada para ser exibida. Um valor
de 0 indica que eventos associados a essa agenda não devem ser
exibidos. Um valor de 1 indica que eventos associados a essa agenda devem
@@ -240,7 +240,7 @@ android.provider.CalendarContract.Instances}.
Um booleano que indica se a agenda deve ser sincronizada e ter
os eventos armazenados no dispositivo. Um valor de 0 indica a não sincronização dessa agenda
e o não armazenamento dos eventos no dispositivo. Um valor de 1 indica a sincronização dos eventos dessa agenda
@@ -253,7 +253,7 @@ e o armazenamento dos eventos no dispositivo.
A seguir há um exemplo que mostra como obter as agendas de propriedade de determinado
usuário. Para simplificar o exemplo, a operação de consulta é exibida no
encadeamento da interface do usuário ("encadeamento principal"). Na prática, isso deve ser feito em um encadeamento
-assíncrono em vez de no encadeamento principal. Para ver mais discussões, consulte
+assíncrono em vez de no encadeamento principal. Para ver mais discussões, consulte
Carregadores. Se você não estiver somente
lendo dados, mas modificando-os, consulte {@link android.content.AsyncQueryHandler}.
@@ -268,13 +268,13 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
Por que incluir
ACCOUNT_TYPE?
Ao consultar um {@link
@@ -289,7 +289,7 @@ o {@link android.accounts.AccountManager}. Há também um tipo especial de conta
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} para agendas
não associadas a nenhuma conta do dispositivo. Contas {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} não são
-sincronizadas.
+sincronizadas.
Na próxima parte do exemplo, você construirá a consulta. A seleção
@@ -308,38 +308,38 @@ consulte Prove
A tabela {@link android.provider.CalendarContract.Events} contém detalhes
de eventos individuais. Para adicionar, atualizar ou excluir eventos, um aplicativo deve
-conter a permissão {@link android.Manifest.permission#WRITE_CALENDAR}
+conter a permissão {@link android.Manifest.permission#WRITE_CALENDAR}
no arquivo de manifesto.
As colunas de Eventos a seguir são graváveis tanto por um aplicativo quanto por um adaptador
@@ -434,7 +434,7 @@ android.provider.CalendarContract.Events}.
A duração do evento em formato RCF5545.
Por exemplo, um valor de "PT1H" indica que o evento
deve durar uma hora, e um valor de "P2W" indica
@@ -444,39 +444,39 @@ uma duração de 2 semanas.
Um valor de 1 indica que esse evento ocupa o dia inteiro, como definido
pelo fuso horário local. Um valor de 0 indica que é um evento comum que pode iniciar
e terminar a qualquer momento durante um dia.
As datas de recorrência do evento.
- Normalmente, usa-se {@link android.provider.CalendarContract.EventsColumns#RDATE}
- em conjunto com {@link android.provider.CalendarContract.EventsColumns#RRULE}
+
As datas de recorrência do evento.
+ Normalmente, usa-se {@link android.provider.CalendarContract.EventsColumns#RDATE}
+ em conjunto com {@link android.provider.CalendarContract.EventsColumns#RRULE}
para definir um conjunto agregado
de ocorrências repetidas. Para ver mais discussões, consulte Especificação RFC5545.
@@ -514,11 +514,11 @@ java.util.TimeZone#getAvailableIDs()}. Observe que essa regra não se aplica
a inserções de evento pela intenção {@link
android.content.Intent#ACTION_INSERT INSERT} descrita em Uso de uma intenção para inserir um evento — nesta
situação, é fornecido um fuso horário padrão.
-
+
Para eventos não recorrentes, é preciso incluir {@link
android.provider.CalendarContract.EventsColumns#DTEND}.
O minuto inicial da instância calculado a partir de meia-noite, relativo
-ao fuso horário do Agenda.
+ao fuso horário do Agenda.
-
+
@@ -840,7 +840,7 @@ ao fuso horário do Agenda.
na URI. Neste exemplo, {@link android.provider.CalendarContract.Instances}
obtém acesso ao campo {@link
android.provider.CalendarContract.EventsColumns#TITLE} por meio
-da sua implementação da interface {@link android.provider.CalendarContract.EventsColumns}.
+da sua implementação da interface {@link android.provider.CalendarContract.EventsColumns}.
Em outras palavras, {@link
android.provider.CalendarContract.EventsColumns#TITLE} é retornado por uma
vista do banco de dados, não pela consulta da tabela {@link
@@ -853,7 +853,7 @@ public static final String[] INSTANCE_PROJECTION = new String[] {
Instances.BEGIN, // 1
Instances.TITLE // 2
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_BEGIN_INDEX = 1;
@@ -868,7 +868,7 @@ long startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2011, 10, 24, 8, 0);
long endMillis = endTime.getTimeInMillis();
-
+
Cursor cur = null;
ContentResolver cr = getContentResolver();
@@ -883,28 +883,28 @@ ContentUris.appendId(builder, startMillis);
ContentUris.appendId(builder, endMillis);
// Submit the query
-cur = cr.query(builder.build(),
- INSTANCE_PROJECTION,
- selection,
- selectionArgs,
+cur = cr.query(builder.build(),
+ INSTANCE_PROJECTION,
+ selection,
+ selectionArgs,
null);
-
+
while (cur.moveToNext()) {
String title = null;
long eventID = 0;
- long beginVal = 0;
-
+ long beginVal = 0;
+
// Get the field values
eventID = cur.getLong(PROJECTION_ID_INDEX);
beginVal = cur.getLong(PROJECTION_BEGIN_INDEX);
title = cur.getString(PROJECTION_TITLE_INDEX);
-
- // Do something with the values.
- Log.i(DEBUG_TAG, "Event: " + title);
+
+ // Do something with the values.
+ Log.i(DEBUG_TAG, "Event: " + title);
Calendar calendar = Calendar.getInstance();
- calendar.setTimeInMillis(beginVal);
+ calendar.setTimeInMillis(beginVal);
DateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
- Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
+ Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
}
}
@@ -923,8 +923,8 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_VIEW VIEW}
Também pode-se consultar a URI com
-{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
-Para ver um exemplo do uso dessa intenção, consulte Uso de intenções para exibir dados de calendários.
+{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
+Para ver um exemplo do uso dessa intenção, consulte Uso de intenções para exibir dados de calendários.
Abre a agenda no horário especificado por <ms_since_epoch>.
@@ -996,7 +996,7 @@ Para ver um exemplo do uso dessa intenção, consulte arquivo de manifesto.
-
+
Quando usuários executam um aplicativo que usa essa abordagem, ele os direciona
ao Agenda para finalizar a adição do evento. A intenção {@link
android.content.Intent#ACTION_INSERT INSERT} usa campos extras para
pré-preencher um formulário com os detalhes do evento na Agenda. Os usuários podem,
então, cancelar o evento, editar o formulário conforme o necessário ou salvar o evento nas suas
agendas.
-
+
A seguir há um fragmento de código que agenda um evento em 19 de janeiro de 2012, que acontece
@@ -1075,7 +1075,7 @@ das 7h30 às 8h30. Observe o exposto a seguir sobre esse fragmento de código:
Ele especifica {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
como a URI.
-
+
Ele usa os campos extras {@link
android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME
CalendarContract.EXTRA_EVENT_BEGIN_TIME} e {@link
@@ -1083,10 +1083,10 @@ android.provider.CalendarContract#EXTRA_EVENT_END_TIME
CalendarContract.EXTRA_EVENT_END_TIME} para pré-preencher o formulário
com o horário do evento. Os valores desses horários devem estar em milissegundos UTC
da época.
-
+
Ele usa o campo extra {@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}
para fornecer uma lista de termos separados por vírgula de convidados, especificados por endereço de e-mail.
-
+
Calendar beginTime = Calendar.getInstance();
@@ -1158,12 +1158,12 @@ via aplicativo e via adaptador de sincronização:
Um adaptador de sincronização precisa especificar que é um adaptador de sincronização que define {@link android.provider.CalendarContract#CALLER_IS_SYNCADAPTER} como true.
-
-
+
+
Os adaptadores de sincronização precisam fornecer um {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_NAME} e um {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} como parâmetros da consulta na URI.
-
+
Os adaptadores de sincronização têm acesso de gravação a mais colunas do que um aplicativo ou widget.
Por exemplo: um aplicativo só pode modificar algumas características de uma agenda,
como nome, nome de exibição, configurações de visibilidade e se a agenda está
@@ -1180,5 +1180,5 @@ e ao ACCOUNT_TYPE que especificou.
Para obter uma implementação de exemplo de um adaptador de sincronização (não especificamente relacionada ao Agenda), consulte
+
Para obter uma implementação de exemplo de um adaptador de sincronização (não especificamente relacionada ao Agenda), consulte
SampleSyncAdapter.
diff --git a/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd
index 0d42d2daed530..f3b7c58523af7 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/providers/contacts-provider.jd
@@ -113,14 +113,14 @@ o Provedor de Contatos.
Este guia considera que o leitor conhece os preceitos dos provedores de conteúdo do Android. Para saber mais
sobre provedores de conteúdo do Android, leia o guia
- Preceitos do provedor de conteúdo.
+ Preceitos do provedor de conteúdo.
O aplicativo Exemplo de adaptador de sincronização
é um exemplo de uso de um adaptador de sincronização que transfere dados entre o Provedor
de contatos e um aplicativo de amostra hospedado pelo Google Web Services.
Organização do Provedor de Contatos
- O Provedor de Contatos é um componente do provedor de conteúdo do Android. Ele mantém três tipos de
+ O Provedor de Contatos é um componente do provedor de conteúdo do Android. Ele mantém três tipos de
dados sobre uma pessoa, sendo cada um deles correspondente a uma tabela fornecida pelo provedor, como
ilustrado na figura 1:
@@ -199,7 +199,7 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa
{@link android.provider.ContactsContract.SyncColumns#ACCOUNT_TYPE}.
- O formato desse nome é específico deste tipo de conta.
+ O formato desse nome é específico deste tipo de conta.
Não se trata necessariamente de um endereço de e-mail.
@@ -239,7 +239,7 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa
O nome de um contato bruto não é armazenado em sua linha em
- {@link android.provider.ContactsContract.RawContacts}. Em vez disso, é armazenado na
+ {@link android.provider.ContactsContract.RawContacts}. Em vez disso, é armazenado na
tabela {@link android.provider.ContactsContract.Data}, em uma
linha {@link android.provider.ContactsContract.CommonDataKinds.StructuredName}. Os contatos brutos
têm apenas uma linha desse tipo na tabela {@link android.provider.ContactsContract.Data}.
@@ -275,7 +275,7 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa
Configurações da conta.
- Suponhamos que Emily Dickinson abra uma janela do navegador, acesse o Gmail como
+ Suponhamos que Emily Dickinson abra uma janela do navegador, acesse o Gmail como
emily.dickinson@gmail.com, abra
Contatos e adicione "Thomas Higginson". Mais tarde, ela acessa o Gmail como
emilyd@gmail.com e envia um e-mail para "Thomas Higginson", o que automaticamente
@@ -309,7 +309,7 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa
tipo de dados, como endereços de e-mail ou números de telefone. Por exemplo: se
"Thomas Higginson" para {@code emilyd@gmail.com} (a linha do contato bruto de Thomas Higginson
associada à conta Google emilyd@gmail.com) tem um endereço de e-mail pessoal
- thigg@gmail.com e um de trabalho
+ thigg@gmail.com e um de trabalho
thomas.higginson@gmail.com, o Provedor de Contatos armazena as duas linhas de endereço de e-mail
e vincula ambas ao contato bruto.
@@ -490,7 +490,7 @@ de dados de uma pessoa, ele permite diversos contatos brutos para a mesma pessoa
{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY} do contato continuará
apontado para a linha do contato para permitir o uso de
{@code android.provider.ContactsContract.ContactsColumns#LOOKUP_KEY}
- e manter ligações com contatos "favoritos" e assim por diante. Essa coluna tem o próprio formato, que
+ e manter ligações com contatos "favoritos" e assim por diante. Essa coluna tem o próprio formato, que
não tem nenhuma relação com o formato da coluna {@code android.provider.BaseColumns#_ID}.
@@ -981,7 +981,7 @@ public Loader<Cursor> onCreateLoader(int id, Bundle args) {
{@code android.provider.BaseColumns#_ID} do contato bruto como
o valor {@link android.provider.ContactsContract.DataColumns#RAW_CONTACT_ID}. Contudo, esse
valor não está disponível ao criar a {@link android.content.ContentProviderOperation}
- para a linha de dados porque
+ para a linha de dados porque
{@link android.content.ContentProviderOperation} ainda não foi aplicada à linha de contato bruto. Para trabalhar com isso,
a classe {@link android.content.ContentProviderOperation.Builder} tem o método
{@link android.content.ContentProviderOperation.Builder#withValueBackReference(String, int) withValueBackReference()}.
@@ -1403,7 +1403,7 @@ StructuredPostal.CONTENT_URI},
RawContacts.CONTENT_TYPE}, tipo MIME para um grupo de contatos brutos.
- Exibe a tela Adicionar contato do aplicativo de contatos do dispositivo.
+ Exibe a tela Adicionar contato do aplicativo de contatos do dispositivo.
São exibidos os valores extras adicionados à intenção. Se enviada com
{@link android.app.Activity#startActivityForResult(Intent, int) startActivityForResult()},
a URI de conteúdo do contato bruto recentemente adicionado é passada de volta
@@ -1636,7 +1636,7 @@ startActivity(insertIntent);
a disponibilidade dos dados dos contatos mesmo quando o dispositivo não está conectado à rede.
- Embora seja possível implementar a sincronização de diversos modos, o sistema Android fornece
+ Embora seja possível implementar a sincronização de diversos modos, o sistema Android fornece
uma estrutura de sincronização de extensão que automatiza as seguintes tarefas:
Para usar essa estrutura, deve-se fornecer uma extensão do adaptador de sincronização. Cada adaptador de sincronização é exclusivo
- de um serviço e um provedor de conteúdo, mas pode tratar diversos nomes de conta do mesmo serviço.
+ de um serviço e um provedor de conteúdo, mas pode tratar diversos nomes de conta do mesmo serviço.
A estrutura também permite diversos adaptadores de sincronização para o mesmo serviço e provedor.
-
+
Recurso desenhável do Android
que o aplicativo de contatos exibe próximo aos dados. Use isso para indicar
ao usuário que os dados são advindos do seu serviço.
{@code android:summaryColumn}
- O nome de coluna do primeiro de dois valores recuperados da linha de dados.
+ O nome de coluna do primeiro de dois valores recuperados da linha de dados.
O valor é exibido como a primeira linha da entrada para essa linha de dados. A primeira linha
destina-se ao uso como um resumo dos dados, mas isso é opcional. Veja também
android:detailColumn.
diff --git a/docs/html-intl/intl/pt-br/guide/topics/providers/content-provider-basics.jd b/docs/html-intl/intl/pt-br/guide/topics/providers/content-provider-basics.jd
index 5005f9208bfe7..7bbca94bd937e 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/providers/content-provider-basics.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/providers/content-provider-basics.jd
@@ -216,7 +216,7 @@ page.title=Preceitos do provedor de conteúdo
Os aplicativos acessam dados a partir de um provedor de conteúdo
com um objeto cliente {@link android.content.ContentResolver}. Esse objeto tem métodos que chamam
métodos de nome idêntico no objeto do provedor, uma instância de uma das subclasses
- concretas de {@link android.content.ContentProvider}.
+ concretas de {@link android.content.ContentProvider}.
Os métodos {@link android.content.ContentResolver} fornecem as funções básicas
do "CRUD" (criar, recuperar, atualizar e excluir) de armazenamento persistente.
A tabela 2 mostra como os argumentos para
- {@link android.content.ContentResolver#query
+ {@link android.content.ContentResolver#query
query(Uri,projection,selection,selectionArgs,sortOrder)} correspondem a uma declaração SQL SELECT:
@@ -310,7 +310,7 @@ mCursor = getContentResolver().query(
{@link android.provider.UserDictionary.Words#CONTENT_URI} contém a URI de conteúdo
da tabela de "palavras" do dicionário do usuário. O objeto {@link android.content.ContentResolver}
analisa a autoridade da URI e usa-na para "determinar" o provedor
- comparando a autoridade a uma tabela de provedores conhecidos do sistema.
+ comparando a autoridade a uma tabela de provedores conhecidos do sistema.
O {@link android.content.ContentResolver} pode, então, enviar os argumentos da consulta ao provedor
correto.
@@ -344,7 +344,7 @@ Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
Observação: as classes {@link android.net.Uri} e {@link android.net.Uri.Builder}
- contêm métodos convenientes para a construção de objetos de URI bem formados a partir de strings.
+ contêm métodos convenientes para a construção de objetos de URI bem formados a partir de strings.
As {@link android.content.ContentUris} contêm métodos conveniente para anexar valores de ID
a uma URI. O fragmento anterior usa {@link android.content.ContentUris#withAppendedId
withAppendedId()} para anexar um ID à URI de conteúdo UserDictionary.
@@ -359,7 +359,7 @@ Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
Por uma questão de clareza, os fragmentos de código nesta seção chamam
- {@link android.content.ContentResolver#query ContentResolver.query()} no "encadeamento da IU".
+ {@link android.content.ContentResolver#query ContentResolver.query()} no "encadeamento da IU".
No código atual, contudo, deve-se realizar consultas assincronamente em um encadeamento separado. Um modo de fazê-lo
é usar a classe {@link android.content.CursorLoader}, descrita
com mais detalhes no guia
@@ -567,7 +567,7 @@ selectionArgs[0] = mUserInput;
O sistema Android contém uma API de banco de dados SQLite que os provedores do Android usam
- para armazenar dados orientados a tabela.
+ para armazenar dados orientados a tabela.
A classe {@link android.database.sqlite.SQLiteOpenHelper} ajuda a criar bancos de dados
e a classe {@link android.database.sqlite.SQLiteDatabase} é a classe de base para acessar
banco de dados.
@@ -539,7 +539,7 @@ public class ExampleProvider extends ContentProvider {
- Observe que esses métodos têm a mesma assinatura dos métodos
+ Observe que esses métodos têm a mesma assinatura dos métodos
{@link android.content.ContentResolver} de mesmo nome.
@@ -569,7 +569,7 @@ public class ExampleProvider extends ContentProvider {
Implementação do método query()
-
+
O método {@link android.content.ContentProvider#query(Uri, String[], String, String[], String)
ContentProvider.query()} precisa retornar um objeto {@link android.database.Cursor} ou, se
falhar, gerar uma {@link java.lang.Exception}. Se você estiver usando um banco de dados SQLite
@@ -778,7 +778,7 @@ protected static final class MainDatabaseHelper extends SQLiteOpenHelper {
Para tipos de dados comuns como texto, HTML ou JPEG,
{@link android.content.ContentProvider#getType(Uri) getType()} deve retornar o tipo MIME
padrão daqueles dados. Há uma lista completa desse tipos de padrão
- no site de
+ no site de
Tipos de mídia MIME IANA.
@@ -981,7 +981,7 @@ vnd.android.cursor.item/vnd.com.example.provider.table1
Permissão de leitura, gravação ou leitura/gravação para uma URI de conteúdo no provedor. Especifica-se
cada URI que se deseja controlar
com um elemento filho
- <path-permission>
+ <path-permission>
do elemento
<provider>. Para cada URI de conteúdo, pode-se especificar
uma permissão de leitura/gravação, uma permissão de leitura, uma permissão de gravação ou as três. As permissões
diff --git a/docs/html-intl/intl/pt-br/guide/topics/providers/content-providers.jd b/docs/html-intl/intl/pt-br/guide/topics/providers/content-providers.jd
index c9574f6b90c6e..48f4cd49843d6 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/providers/content-providers.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/providers/content-providers.jd
@@ -52,12 +52,12 @@ dados e fornecem mecanismos para definir a segurança dos dados. Provedores de c
padrão que conecta dados em um processo com código em execução em outro processo.
- Quando desejar acessar dados em um provedor de conteúdo, você usa o
- objeto {@link android.content.ContentResolver} no
+ Quando desejar acessar dados em um provedor de conteúdo, você usa o
+ objeto {@link android.content.ContentResolver} no
{@link android.content.Context} do aplicativo para se comunicar com o provedor como cliente.
O objeto {@link android.content.ContentResolver} se comunica com o objeto provedor, uma
instância de uma classe que implementa {@link android.content.ContentProvider}. O objeto
- provedor recebe solicitações de dados de clientes, realiza a ação solicitada e
+ provedor recebe solicitações de dados de clientes, realiza a ação solicitada e
devolve os resultados.
@@ -68,10 +68,10 @@ dados e fornecem mecanismos para definir a segurança dos dados. Provedores de c
O Android propriamente dito inclui provedores de conteúdo que gerenciam dados como áudio, vídeo, imagens e
- informações de contato pessoais. Alguns deles estão listados na documentação de
- referência do
+ informações de contato pessoais. Alguns deles estão listados na documentação de
+ referência do
pacote android.provider
- . Com algumas restrições, esses provedores podem ser acessados por qualquer aplicativo
+ . Com algumas restrições, esses provedores podem ser acessados por qualquer aplicativo
Android.
Os tópicos a seguir descrevem provedores de conteúdo em mais detalhes:
diff --git a/docs/html-intl/intl/pt-br/guide/topics/providers/document-provider.jd b/docs/html-intl/intl/pt-br/guide/topics/providers/document-provider.jd
index 25aab7aa7a9d2..b2e040ecefa55 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/providers/document-provider.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/providers/document-provider.jd
@@ -139,7 +139,7 @@ dispositivos de armazenamento USB transitórios ou login/logout do usuário.N documentos.
Cada back-end de armazenamento apresenta
-arquivos e diretórios individuais referenciando-os com um
+arquivos e diretórios individuais referenciando-os com um
{@link android.provider.DocumentsContract.Document#COLUMN_DOCUMENT_ID} exclusivo.
IDs de documentos devem ser exclusivos e não podem mudar depois de emitidos, pois são usados para concessões persistentes
da URI em reinicializações do dispositivo.
@@ -236,7 +236,7 @@ imagens armazenadas em um provedor de documentos.
-
Esta seção descreve como programar aplicativos clientes com base nas intenções
+
Esta seção descreve como programar aplicativos clientes com base nas intenções
{@link android.content.Intent#ACTION_OPEN_DOCUMENT}
e {@link android.content.Intent#ACTION_CREATE_DOCUMENT}.
@@ -521,7 +521,7 @@ os arquivos, o que, obviamente, não é o ideal.
Para evitar que isso aconteça, você pode manter as permissões que o sistema
forneceu ao aplicativo. Efetivamente, o aplicativo "toma" a concessão de permissão da URI persistente
-que o sistema está oferecendo. Isso concede ao usuário um acesso contínuo aos arquivos
+que o sistema está oferecendo. Isso concede ao usuário um acesso contínuo aos arquivos
por meio do aplicativo mesmo se o dispositivo for reiniciado:
@@ -624,7 +624,7 @@ em dispositivos que executam o Android 4.4 ou posteriores.
Se você deseja que o aplicativo seja compatível com {@link android.content.Intent#ACTION_GET_CONTENT}
para adaptar-se a dispositivos que executam o Android 4.3 ou versões anteriores, é necessário
desativar o filtro de intenção {@link android.content.Intent#ACTION_GET_CONTENT}
-no manifesto para dispositivos que executam Android 4.4 ou versões posteriores.
+no manifesto para dispositivos que executam Android 4.4 ou versões posteriores.
Um provedor de documentos e {@link android.content.Intent#ACTION_GET_CONTENT} devem ser avaliados
de forma mutuamente exclusiva. Se houver compatibilidade com ambos simultaneamente, o aplicativo
aparecerá duas vezes na IU do seletor do sistema, oferecendo dois meios de acesso
diff --git a/docs/html-intl/intl/pt-br/guide/topics/resources/accessing-resources.jd b/docs/html-intl/intl/pt-br/guide/topics/resources/accessing-resources.jd
index f196dfeae779f..de8b5df5e4868 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/resources/accessing-resources.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/resources/accessing-resources.jd
@@ -11,7 +11,7 @@ parent.link=index.html
{@code R.drawable.myimage}
Recursos podem ser referenciados de recursos usando uma sintaxe XML especial, como {@code
@drawable/myimage}
-
Também é possível acessar os recursos do aplicativo com métodos em
+
Também é possível acessar os recursos do aplicativo com métodos em
{@link android.content.res.Resources}
@@ -43,10 +43,10 @@ parent.link=index.html
Depois de fornecer um recurso no aplicativo (discutido em Fornecimento de recursos), é possível aplicá-lo
-referenciando seu ID de recurso. Todos os IDs de recursos são definidos na classe {@code R} do projeto, que
+referenciando seu ID de recurso. Todos os IDs de recursos são definidos na classe {@code R} do projeto, que
a ferramenta {@code aapt} gera automaticamente.
-
Quando o aplicativo é compilado, {@code aapt} gera a classe {@code R}, que contém
+
Quando o aplicativo é compilado, {@code aapt} gera a classe {@code R}, que contém
IDs de recursos para todos os recursos no diretório {@code
res/}. Para cada tipo de recurso, há uma subclasse {@code R} (por exemplo,
{@code R.drawable} para todos os recursos desenháveis) e, para cada recurso daquele tipo, há um número inteiro
@@ -60,7 +60,7 @@ verificá-la para descobrir um ID de recurso. Ele é sempre composto de:
string}, {@code drawable} e {@code layout}. Para saber mais sobre os diferentes tipos, consulte Tipos de recursos.
O nome do recurso, que é: o nome do arquivo,
-excluindo a extensão; ou o valor no atributo {@code android:name} do XML, se o
+excluindo a extensão; ou o valor no atributo {@code android:name} do XML, se o
recurso for um valor simples (como uma string).
@@ -101,7 +101,7 @@ com {@link android.content.Context#getResources()}.
Acesso aos arquivos originais
-
Apesar de ser incomum, pode ser necessário acessar os arquivos e os diretórios originais. Nesse caso,
+
Apesar de ser incomum, pode ser necessário acessar os arquivos e os diretórios originais. Nesse caso,
salvar os arquivos em {@code res/} não funcionará, pois a única forma de ler um recurso de
{@code res/} é com o ID do recurso. Em vez disso, é possível salvar os recursos no
diretório {@code assets/}.
@@ -139,7 +139,7 @@ obter mais informações sobre cada tipo de recurso e como referenciá-los.
Casos de uso
-
Há muitos métodos que aceitam um parâmetro de ID de recurso e você pode recuperar recursos usando
+
Há muitos métodos que aceitam um parâmetro de ID de recurso e você pode recuperar recursos usando
métodos em {@link android.content.res.Resources}. É possível obter uma instância de {@link
android.content.res.Resources} com {@link android.content.Context#getResources
Context.getResources()}.
Atenção: nunca modifique o arquivo {@code
-R.java} manualmente — ele é gerado pela ferramenta {@code aapt} quando o projeto é
+R.java} manualmente — ele é gerado pela ferramenta {@code aapt} quando o projeto é
compilado. As alterações serão sobrepostas na próxima compilação.
{@code <package_name>} é o nome do pacote no qual o recurso está localizado (não
é obrigatório ao referenciar recursos do mesmo pacote).
-
{@code <resource_type>} é a subclasse
+
{@code <resource_type>} é a subclasse
{@code R} do tipo de recurso.
{@code <resource_name>} é o nome do arquivo do recurso
sem a extensão ou o valor do atributo {@code android:name} no elemento XML (para valores
@@ -260,10 +260,10 @@ referenciar um recurso do sistema, é preciso incluir o nome do pacote. Por exem
Observação: você deve usar recursos de string
-o tempo inteiro para que o seu aplicativo possa ser localizado para outros idiomas.
+o tempo inteiro para que o seu aplicativo possa ser localizado para outros idiomas.
Para obter informações sobre a criação de recursos
-alternativos (como strings localizadas), consulte Fornecimento de recursos
-alternativos. Para obter um guia completo para localizar o aplicativo para outros idiomas,
+alternativos (como strings localizadas), consulte Fornecimento de recursos
+alternativos. Para obter um guia completo para localizar o aplicativo para outros idiomas,
consulte Localização.
Você pode até mesmo usar recursos em XML para criar alias. Por exemplo, é possível criar um recurso
@@ -289,14 +289,14 @@ tema atual, em vez de fornecer um valor codificado. Referenciar um atributo de e
essencialmente significa "usar o estilo que é definido por esse atributo no tema atual".
Para referenciar um atributo de estilo, a sintaxe do nome é quase idêntica ao formato normal de recurso,
-mas, em vez de o símbolo arroba ({@code @}), use um ponto de interrogação ({@code ?}). Além disso,
+mas, em vez de o símbolo arroba ({@code @}), use um ponto de interrogação ({@code ?}). Além disso,
a parte do tipo de recurso é opcional. Por exemplo:
Por exemplo, abaixo apresenta-se como você pode referenciar um atributo para definir a cor do texto para que corresponda à
+
Por exemplo, abaixo apresenta-se como você pode referenciar um atributo para definir a cor do texto para que corresponda à
cor "principal" do texto do tema do sistema:
@@ -320,7 +320,7 @@ não é preciso declarar explicitamente o tipo (que seria
Acesso aos recursos da plataforma
O Android contém uma série de recursos padrão, como estilos, temas e layouts. Para
-acessá-los, qualifique a referência de recurso com o
+acessá-los, qualifique a referência de recurso com o
nome do pacote android. Por exemplo, o Android fornece um recurso de layout que pode ser usado para
listar itens em um {@link android.widget.ListAdapter}:
diff --git a/docs/html-intl/intl/pt-br/guide/topics/resources/overview.jd b/docs/html-intl/intl/pt-br/guide/topics/resources/overview.jd
index 5bf37e691376c..b34c01b540810 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/resources/overview.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/resources/overview.jd
@@ -24,8 +24,8 @@ para que você possa mantê-los independentemente. Exteriorizar os recursos
também permite fornecer recursos alternativos que sejam compatíveis com configurações
de dispositivos específicos, como idiomas ou tamanhos de tela diferentes, que se tornam cada vez
mais importantes à medida que mais dispositivos com Android são disponibilizados com configurações diferentes. Para fornecer
-compatibilidade com diferentes configurações, é preciso organizar recursos no
-diretório {@code res/} de seu projeto usando vários subdiretórios que agrupem recursos por tipo e
+compatibilidade com diferentes configurações, é preciso organizar recursos no
+diretório {@code res/} de seu projeto usando vários subdiretórios que agrupem recursos por tipo e
configuração.
Como pode ver neste exemplo, o diretório {@code res/} contém todos os recursos (em subdiretórios):
-um recurso de imagem, dois recursos de layout, diretórios {@code mipmap/} para ícones de
+um recurso de imagem, dois recursos de layout, diretórios {@code mipmap/} para ícones de
inicialização e um arquivo de recurso de string. Os nomes dos diretórios
de recursos são importantes e são descritos na tabela 1.
@@ -161,7 +161,7 @@ então é possível lê-los usando apenas o {@link android.content.res.AssetMana
com base no nome do arquivo XML, os arquivos no diretório {@code values/} descrevem vários recursos.
Para cada arquivo neste diretório, cada filho do elemento {@code <resources>} define um único
recurso. Por exemplo, um elemento {@code <string>} cria
-um recurso {@code R.string} e um elemento {@code <color>} cria um recurso
+um recurso {@code R.string} e um elemento {@code <color>} cria um recurso
{@code R.color}.
Consulte também o campo de configuração {@link android.content.res.Configuration#screenLayout},
@@ -627,8 +627,8 @@ sobre como isto pode afetar o aplicativo em tempo de execução.
nível 8
{@code xxhdpi}: Telas de densidade extra-extra-alta, aproximadamente 480 dpi. Adicionado à API de
nível 16
-
{@code xxxhdpi}: Usos de densidade extra-extra-extra-alta (somente ícone do inicializador, consulte a
- observação
+
{@code xxxhdpi}: Usos de densidade extra-extra-extra-alta (somente ícone do inicializador, consulte a
+ observação
em Compatibilidade com várias telas), aproximadamente 640 dpi. Adicionado à API de
nível 18
{@code nodpi}: Isto pode ser usado para recursos de bitmap que você não deseja dimensionar
@@ -823,7 +823,7 @@ exemplo:
para letras minúsculas antes de processar para evitar problemas nos sistemas de arquivo
que não diferenciam maiúsculas e minúsculas. Qualquer letra maiúscula nos nomes é apenas para o benefício da leitura.
Somente um valor para cada tipo de qualificador é suportado. Por exemplo, se quiser usar
-os mesmos arquivos desenháveis para Espanha e França, não é possível ter um diretório chamado
+os mesmos arquivos desenháveis para Espanha e França, não é possível ter um diretório chamado
drawable-rES-rFR/. Em vez disso, você precisa de dois diretórios de recursos, como
drawable-rES/ e drawable-rFR/, que contenham arquivos adequados.
No entanto, não é necessário duplicar os mesmos arquivos em ambos os locais. Em vez disso,
@@ -1088,7 +1088,7 @@ mas o dispositivo tiver uma tela de tamanho normal).
do que o número de qualificadores que correspondem exatamente ao dispositivo. Por exemplo, na etapa 4 acima, a última
escolha na lista inclui três qualificadores que correspondem exatamente ao dispositivo (orientação, tipo de
tela sensível ao toque e método de entrada), enquanto que drawable-en possui apenas um parâmetro que corresponde
-(idioma). No entanto, o idioma tem uma precedência maior que esses outros qualificadores, então
+(idioma). No entanto, o idioma tem uma precedência maior que esses outros qualificadores, então
drawable-port-notouch-12key está fora.
Para obter mais informações sobre como usar os recursos no aplicativo, acesse Acesso aos recursos.
diff --git a/docs/html-intl/intl/pt-br/guide/topics/resources/runtime-changes.jd b/docs/html-intl/intl/pt-br/guide/topics/resources/runtime-changes.jd
index 366ce0d2c0728..416bce98e4ab7 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/resources/runtime-changes.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/resources/runtime-changes.jd
@@ -125,7 +125,7 @@ ele vazará todas as vistas e recursos da instância da atividade original (vaza
significa que o aplicativo mantém a retenção deles, que não podem ser recolhidos, o que
causa perda de memória).
-
Em seguida, use {@link android.app.FragmentManager} para adicionar o fragmento à atividade.
+
Em seguida, use {@link android.app.FragmentManager} para adicionar o fragmento à atividade.
É possível obter o objeto de dados do fragmento quando a atividade reiniciar durante as alterações
de configuração em tempo de execução. Por exemplo: defina a atividade da seguinte forma:
diff --git a/docs/html-intl/intl/pt-br/guide/topics/ui/controls.jd b/docs/html-intl/intl/pt-br/guide/topics/ui/controls.jd
index 58a4fcdbe5a06..1cd6d52ef4d37 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/ui/controls.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/ui/controls.jd
@@ -69,7 +69,7 @@ de um tipo específico de controle de entrada, você pode criar os próprios
Declarar elementos da IU em XML. O Android fornece um vocabulário XML
direto que corresponde às classes e subclasses de View, como as de widgets e layouts.
-
Instanciar elementos do layout em tempo de execução.
+
Instanciar elementos do layout em tempo de execução.
O aplicativo pode criar objetos de View e ViewGroup (e manipular suas propriedades) programaticamente.
@@ -123,7 +123,7 @@ public void onCreate(Bundle savedInstanceState) {
O método de retorno de chamada onCreate() na Atividade é chamado pela estrutura do Android quando
-ela é inicializada (veja a discussão sobre ciclos de vida no documento
+ela é inicializada (veja a discussão sobre ciclos de vida no documento
Atividades
).
@@ -201,7 +201,7 @@ de layout associados a cada uma delas.
valores. Cada elemento filho deve definir LayoutParams apropriados para seu pai,
embora possa também definir diferentes LayoutParams para os próprios filhos.
-
Todos os grupos de vistas contêm largura e altura (layout_width e
+
Todos os grupos de vistas contêm largura e altura (layout_width e
layout_height) e cada vista é obrigatória para defini-las. Muitos
LayoutParams também contêm margens e bordas opcionais.
@@ -229,7 +229,7 @@ Recursos disponíveis.
Posição do layout
A geometria de uma vista de um retângulo. As vistas têm uma localização,
- expressa como um par de coordenadas esquerda e topo
+ expressa como um par de coordenadas esquerda e topo
e duas dimensões, expressas como largura e altura. A unidade de localização
e de dimensões é o pixel.
O primeiro par é conhecido como largura medida
e altura medida. Essas dimensões definem o tamanho que a vista terá
- dentro da vista pai.
+ dentro da vista pai.
Para obter as dimensões medidas, chamam-se {@link android.view.View#getMeasuredWidth()}
e {@link android.view.View#getMeasuredHeight()}.
@@ -368,7 +368,7 @@ partially or totally obscuring them (unless the newer object is transparent).
Criação de layouts com um adaptador
Quando o conteúdo do layout é dinâmico ou não predeterminado, é possível usar um layout que
-torne {@link android.widget.AdapterView} uma subclasse para preencher o layout com vistas em tempo de execução.
+torne {@link android.widget.AdapterView} uma subclasse para preencher o layout com vistas em tempo de execução.
Uma subclasse da classe {@link android.widget.AdapterView} usa um {@link android.widget.Adapter}
para agrupar dados ao seu layout. O {@link android.widget.Adapter} se comporta como um intermediário entre a fonte
dos dados e o layout do {@link android.widget.AdapterView} — o {@link android.widget.Adapter}
@@ -399,7 +399,7 @@ a um {@link android.widget.Adapter}, o que recupera dados de uma fonte externa e
android.view.View} que representa cada entrada de dados.
O Android oferece diversas subclasses de {@link android.widget.Adapter} que são úteis para
-recuperar diferentes tipos de dados e criar vistas de um {@link android.widget.AdapterView}.
+recuperar diferentes tipos de dados e criar vistas de um {@link android.widget.AdapterView}.
Os dois adaptadores mais comuns são:
@@ -438,7 +438,7 @@ getView()} para retornar o tipo de vista que deseja para cada item.
{@link android.widget.SimpleCursorAdapter}
-
Use este adaptador quando os dados vierem de um {@link android.database.Cursor}.
+
Use este adaptador quando os dados vierem de um {@link android.database.Cursor}.
Ao usar {@link android.widget.SimpleCursorAdapter}, é necessário especificar um layout a usar para cada
linha no {@link android.database.Cursor} e que colunas no {@link android.database.Cursor}
devem ser inseridas em determinadas vistas do layout. Por exemplo: se você deseja criar uma lista
@@ -466,7 +466,7 @@ fromColumns} na vista {@code toViews} correspondente..
-
Se durante o curso de vida do aplicativo, você mudar os dados subjacentes lidos
+
Se durante o curso de vida do aplicativo, você mudar os dados subjacentes lidos
pelo adaptador, chame {@link android.widget.ArrayAdapter#notifyDataSetChanged()}. Isso
notificará à vista anexada que os dados foram alterados e que ela deve se atualizar.
Os métodos set...Button() exigem um título para o botão (fornecido
-por um recurso de string) e um
-{@link android.content.DialogInterface.OnClickListener} que defina a ação a realizar
+por um recurso de string) e um
+{@link android.content.DialogInterface.OnClickListener} que defina a ação a realizar
quando o usuário pressionar o botão.
Há três botões de ação diferente que podem ser adicionados:
@@ -248,7 +248,7 @@ quando o usuário pressionar o botão.
Neutro
É o que se deve usar quando houver a opção de o usuário não querer continuar a ação,
mas não necessariamente cancelá-la. Ele aparece entre os botões positivo
- e negativo. Por exemplo: a ação pode ser "Notifique-me mais tarde".
+ e negativo. Por exemplo: a ação pode ser "Notifique-me mais tarde".
É possível adicionar somente um de cada tipo de botão a uma {@link
@@ -271,7 +271,7 @@ Caixa de diálogo com um título e uma lista.
Lista de escolhas múltiplas persistentes (caixas de seleção)
-
Para criar uma lista de escolha única como a da figura 3,
+
Para criar uma lista de escolha única como a da figura 3,
use o método {@link android.app.AlertDialog.Builder#setItems setItems()}:
@@ -291,7 +291,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Como a lista aparece na área do conteúdo da caixa de diálogo,
a caixa não pode exibir uma mensagem e uma lista, e será preciso definir um título
-para ela com {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
+para ela com {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
Para especificar os itens da lista, chame {@link
android.app.AlertDialog.Builder#setItems setItems()} passando uma matriz.
Alternativamente, é possível especificar uma lista com {@link
@@ -320,8 +320,8 @@ Lista de itens de múltipla escolha.
Para adicionar uma lista de itens de múltipla escolha (caixas de seleção)
ou itens de escolha única (botões de rádio), use os métodos
{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
-DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} ou
-{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} ou
+{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} respectivamente.
Por exemplo, a seguir apresenta-se como criar uma lista de múltipla escolha como
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -373,7 +373,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Embora a lista tradicional e uma lista com botões de opção
forneçam uma ação de "escolha única", deve-se usar {@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} se você desejar manter a escolha do usuário.
Ou seja, se a caixa de diálogo abrir novamente mais tarde, deve indicar qual é a escolha atual do usuário,
portanto deve-se criar uma lista com botões de opção.
@@ -442,7 +442,7 @@ deve-se alterar a família da fonte para {@code "sans-serif"} para que os campos
um estilo de fonte compatível.
Para inflar o layout no {@link android.support.v4.app.DialogFragment},
-obtenha um {@link android.view.LayoutInflater} com
+obtenha um {@link android.view.LayoutInflater} com
{@link android.app.Activity#getLayoutInflater()} e chame
{@link android.view.LayoutInflater#inflate inflate()}, em que o primeiro parâmetro
é o ID de recurso do layout e o segundo é uma vista pai do layout.
@@ -470,7 +470,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -505,7 +505,7 @@ uma interface por meio da qual entrega os eventos de volta à atividade do host:
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ dela por meio de uma implementação da interface {@code NoticeDialogListener}:<
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ ou como uma IU de tela cheia com base no tamanho da tela:
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
@@ -695,7 +695,7 @@ public void showDialog() {
}
-
Para obter mais informações sobre a realização de operações de fragmentos, consulte o guia
+
Para obter mais informações sobre a realização de operações de fragmentos, consulte o guia
Fragmentos.
Nesse exemplo, o booleano mIsLargeLayout especifica se o dispositivo atual
@@ -721,7 +721,7 @@ versões de recurso bool para diferentes tamanhos de tela:
</resources>
-
Assim, é possível inicializar o valor {@code mIsLargeLayout} durante o método
+
Assim, é possível inicializar o valor {@code mIsLargeLayout} durante o método
{@link android.app.Activity#onCreate onCreate()} da atividade:
@@ -776,7 +776,7 @@ android.support.v4.app.DialogFragment#onDismiss onDismiss()} no {@link
android.support.v4.app.DialogFragment}.
Também é possível cancelar uma caixa de diálogo. Trata-se de um evento especial que indica que o usuário
-se retirou explicitamente da caixa de diálogo sem concluir a tarefa. Isso ocorre se o usuário pressionar o botão
+se retirou explicitamente da caixa de diálogo sem concluir a tarefa. Isso ocorre se o usuário pressionar o botão
Voltar, tocar na tela fora da área da caixa de diálogo
ou se você chamar {@link android.app.Dialog#cancel()} explicitamente no {@link
android.app.Dialog} (como em resposta a um botão "Cancelar" na caixa de diálogo).
diff --git a/docs/html-intl/intl/pt-br/guide/topics/ui/menus.jd b/docs/html-intl/intl/pt-br/guide/topics/ui/menus.jd
index 833f8966b4391..6bdb370740d30 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/ui/menus.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/ui/menus.jd
@@ -83,9 +83,9 @@ não têm), então você deve migrar usando a barra de ação para fornecer aces
e outras opções.
Um menu de contexto é um menu flutuante que aparece quando
o usuário realiza um clique longo em um elemento. Ele fornece ações que afetam o conteúdo selecionado
ou a estrutura do contexto.
@@ -94,7 +94,7 @@ que afetam o conteúdo selecionado em uma barra no topo da tela e permite que o
selecione vários itens.
Um menu pop-up exibe itens em uma lista vertical ancorada à vista
que apresentou o menu. É bom para fornecer um estouro de ações relacionado a conteúdo específico
@@ -135,7 +135,7 @@ do projeto e crie o menu com os seguintes elementos:
<item>
Cria um {@link android.view.MenuItem}, que representa um único item em um menu. Este
elemento pode conter um elemento <menu> aninhado para criar um submenu.
-
+
<group>
Um recipiente invisível e opcional para os elementos {@code <item>}. Ele permite que você categorize
itens de menu para que eles compartilhem propriedades como estado ativo e visibilidade. Para obter mais informações,
@@ -218,7 +218,7 @@ para o contexto de atividade atual, como "Buscar", "Escrever e-mail" e "Configur
foi desenvolvido:
-
Caso tenha desenvolvido o aplicativo para Android 2.3.x (API de nível 10) ou
+
Caso tenha desenvolvido o aplicativo para Android 2.3.x (API de nível 10) ou
inferior, os conteúdos do menu de opções aparecerão na parte inferior da tela, quando o usuário
pressionar o botão Menu, como exibido na figura 1. Quando aberto, a primeira parte visível é
o menu
@@ -363,7 +363,7 @@ são apresentados na barra de ação. Quando um evento ocorre e você quer reali
você deve chamar {@link android.app.Activity#invalidateOptionsMenu invalidateOptionsMenu()} para pedir
que o sistema chame {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}.
-
Observação:
+
Observação:
você nunca deve alterar os itens no menu de opções com base no {@link android.view.View} atualmente
em foco. Quando estiver no modo de toque (quando o usuário não está usando cursor de bola ou um teclado), as vistas
não podem ter foco, então você nunca deve usar o foco como base para modificar
@@ -742,8 +742,8 @@ que exibe um menu pop-up:
<ImageButton
- android:layout_width="wrap_content"
- android:layout_height="wrap_content"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
android:src="@drawable/ic_overflow_holo_dark"
android:contentDescription="@string/descr_overflow_button"
android:onClick="showPopup" />
@@ -901,7 +901,7 @@ android.view.MenuItem#setChecked(boolean) setChecked()}.
(como {@link android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}). É aqui
que você deve definir o estado da caixa de seleção, pois a caixa de seleção ou o botão de rádio
não altera o seu estado automaticamente. É possível consultar o estado do item (como ele era antes
-do usuário selecioná-lo) com {@link android.view.MenuItem#isChecked()} e, em seguida, definir o estado marcado com
+do usuário selecioná-lo) com {@link android.view.MenuItem#isChecked()} e, em seguida, definir o estado marcado com
{@link android.view.MenuItem#setChecked(boolean) setChecked()}. Por exemplo:
@@ -1023,9 +1023,9 @@ do filtro de intenção. Por exemplo:
</intent-filter>
-
Leia mais sobre a criação de filtros de intenção no documento
+
Para obter um exemplo de aplicativo que usa esta técnica, consulte o código de exemplo do
+
Para obter um exemplo de aplicativo que usa esta técnica, consulte o código de exemplo do
Bloco
de notas.
diff --git a/docs/html-intl/intl/pt-br/guide/topics/ui/notifiers/notifications.jd b/docs/html-intl/intl/pt-br/guide/topics/ui/notifiers/notifications.jd
index 42563ace22482..d3fb4cfab2962 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/ui/notifiers/notifications.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/ui/notifiers/notifications.jd
@@ -92,7 +92,7 @@ A classe {@link android.app.Notification.Builder Notification.Builder} foi adici
As notificações, como parte importante da interface do usuário do Android, possuem as próprias diretrizes de projeto.
As alterações do Material Design introduzidas no Android 5.0 (API de nível 21) são de importância
específica e, por isso, recomenda-se revisar o treinamento do Material Design
- para obter mais informações. Para saber como projetar notificações e suas interações, leia o guia de projeto
+ para obter mais informações. Para saber como projetar notificações e suas interações, leia o guia de projeto
Notificações.
Criação de uma notificação
@@ -451,14 +451,14 @@ todas as notificações emitidas anteriormente.
Adicione compatibilidade com Android 4.0.3 e mais antigos. Para fazer isto, especifique o pai
da {@link android.app.Activity} que está iniciando adicionando um elemento
<meta-data>
- como o filho de
+ como o filho de
<activity>.
- Para este elemento, defina
+ Para este elemento, defina
android:name="android.support.PARENT_ACTIVITY".
Defina
android:value="<parent_activity_name>",
- onde <parent_activity_name> é o valor de
+ onde <parent_activity_name> é o valor de
android:name
para o elemento
<activity>
diff --git a/docs/html-intl/intl/pt-br/guide/topics/ui/overview.jd b/docs/html-intl/intl/pt-br/guide/topics/ui/overview.jd
index d12bfe5fac8b5..d82ecf7aa8fa7 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/ui/overview.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/ui/overview.jd
@@ -4,12 +4,12 @@ page.title=Visão geral da IU
Todos os elementos da interface do usuário em um aplicativo para Android são criados usando objetos {@link android.view.View} e
{@link android.view.ViewGroup}. Uma {@link android.view.View} é um objeto que desenha
-algo na tela com o qual o usuário pode interagir. Um {@link android.view.ViewGroup} é um
+algo na tela com o qual o usuário pode interagir. Um {@link android.view.ViewGroup} é um
objeto que contém outros objetos {@link android.view.View} (e {@link android.view.ViewGroup}) para
definir o layout da interface.
O Android fornece uma coleção de subclasses {@link android.view.View} e {@link
-android.view.ViewGroup} que oferecem controles de entrada comuns (como botões e campos de
+android.view.ViewGroup} que oferecem controles de entrada comuns (como botões e campos de
texto) e vários modelos de layout (como um layout linear ou relativo).
@@ -30,7 +30,7 @@ de uma IU.
criar uma árvore. Mas a forma mais fácil e efetiva de definir o layout é com um arquivo XML.
O XML oferece uma estrutura legível por humanos para o layout, similar a HTML.
-
O nome de um elemento XML para uma vista é respectivo à classe do Android que ele representa. Portanto, um elemento
+
O nome de um elemento XML para uma vista é respectivo à classe do Android que ele representa. Portanto, um elemento
<TextView> cria um widget {@link android.widget.TextView} na IU
e um elemento <LinearLayout> cria um grupo de vistas de {@link android.widget.LinearLayout}
.
@@ -39,7 +39,7 @@ e um elemento <LinearLayout> cria um grupo de vistas de {@lin
Para obter um guia completo para criar um layout de IU, consulte Layouts
XML.
-
+
Componentes da interface do usuário
Você não precisa criar toda a IU usando objetos {@link android.view.View} e {@link
diff --git a/docs/html-intl/intl/pt-br/guide/topics/ui/settings.jd b/docs/html-intl/intl/pt-br/guide/topics/ui/settings.jd
index f95966c37578d..c00b461499d4f 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/ui/settings.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/ui/settings.jd
@@ -82,7 +82,7 @@ como programar as configurações do aplicativo por meio de APIs {@link android.
Figura 1. Capturas de tela das configurações do aplicativo Mensagens
-do Android. A seleção de um item definido por uma {@link android.preference.Preference}
+do Android. A seleção de um item definido por uma {@link android.preference.Preference}
abre uma interface para alterar a configuração.
@@ -120,8 +120,8 @@ um dos seguintes tipos de dados:
Como a IU de configurações do aplicativo é criada com objetos {@link android.preference.Preference}
- em vez de objetos
-{@link android.view.View}, é preciso usar uma subclasse {@link android.app.Activity} ou
+ em vez de objetos
+{@link android.view.View}, é preciso usar uma subclasse {@link android.app.Activity} ou
{@link android.app.Fragment} especializada para exibir as configurações de lista:
@@ -226,8 +226,8 @@ android.preference.ListPreference}. Os dois itens contêm estes três atributos:
{@code android:key}
Esse atributo é necessário para preferências que persistem a um valor de dados. Ele especifica a chave
exclusiva (uma string) que o sistema usa ao salvar o valor dessa configuração em {@link
-android.content.SharedPreferences}.
-
As únicas instâncias em que esse atributo é dispensável ocorrem quando a preferência é um
+android.content.SharedPreferences}.
+
As únicas instâncias em que esse atributo é dispensável ocorrem quando a preferência é um
{@link android.preference.PreferenceCategory} ou {@link android.preference.PreferenceScreen},
ou quando a preferência especifica um {@link android.content.Intent} para invocar (com um elemento {@code <intent>}) ou um {@link android.app.Fragment} para exibir (com um atributo {@code
android:fragment}).
Para usar grupos de configurações em uma subtela (como ilustrado na figura 3), coloque o grupo
+
Para usar grupos de configurações em uma subtela (como ilustrado na figura 3), coloque o grupo
de objetos {@link android.preference.Preference} dentro de {@link
android.preference.PreferenceScreen}.
@@ -588,11 +588,11 @@ dentro de um elemento raiz {@code <preference-headers>}. Por exemplo:
Para exibir os cabeçalhos de preferência, é preciso implementar o método de retorno de chamada {@link
-android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()} e chamar
+android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()} e chamar
{@link android.preference.PreferenceActivity#loadHeadersFromResource
loadHeadersFromResource()}. Por exemplo:
@@ -672,15 +672,15 @@ ao {@link android.preference.PreferenceActivity} que especifica que arquivo XML
carregar.
Por exemplo, abaixo há um arquivo XML de cabeçalhos de preferência usado no Android 3.0
-e posterior ({@code res/xml/preference_headers.xml}):
<preference-headers xmlns:android="http://schemas.android.com/apk/res/android">
- <header
+ <header
android:fragment="com.example.prefs.SettingsFragmentOne"
android:title="@string/prefs_category_one"
android:summary="@string/prefs_summ_category_one" />
- <header
+ <header
android:fragment="com.example.prefs.SettingsFragmentTwo"
android:title="@string/prefs_category_two"
android:summary="@string/prefs_summ_category_two" />
@@ -692,18 +692,18 @@ mais antigas que a 3.0 ({@code res/xml/preference_headers_legacy.xml}):
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
- <Preference
+ <Preference
android:title="@string/prefs_category_one"
android:summary="@string/prefs_summ_category_one" >
- <intent
+ <intent
android:targetPackage="com.example.prefs"
android:targetClass="com.example.prefs.SettingsActivity"
android:action="com.example.prefs.PREFS_ONE" />
</Preference>
- <Preference
+ <Preference
android:title="@string/prefs_category_two"
android:summary="@string/prefs_summ_category_two" >
- <intent
+ <intent
android:targetPackage="com.example.prefs"
android:targetClass="com.example.prefs.SettingsActivity"
android:action="com.example.prefs.PREFS_TWO" />
@@ -975,11 +975,11 @@ da caixa de diálogo positiva e negativa:
public class NumberPickerPreference extends DialogPreference {
public NumberPickerPreference(Context context, AttributeSet attrs) {
super(context, attrs);
-
+
setDialogLayoutResource(R.layout.numberpicker_dialog);
setPositiveButtonText(android.R.string.ok);
setNegativeButtonText(android.R.string.cancel);
-
+
setDialogIcon(null);
}
...
@@ -1194,7 +1194,7 @@ protected void onRestoreInstanceState(Parcelable state) {
// Cast state to custom BaseSavedState and pass to superclass
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
-
+
// Set this Preference's widget to reflect the restored state
mNumberPicker.setValue(myState.value);
}
diff --git a/docs/html-intl/intl/pt-br/guide/topics/ui/ui-events.jd b/docs/html-intl/intl/pt-br/guide/topics/ui/ui-events.jd
index e0ace1d4b3cac..2f88248b3eb20 100644
--- a/docs/html-intl/intl/pt-br/guide/topics/ui/ui-events.jd
+++ b/docs/html-intl/intl/pt-br/guide/topics/ui/ui-events.jd
@@ -30,7 +30,7 @@ uma coleção de interfaces aninhadas com retornos de chamada que podem ser defi
chamadas de escutas de evento, são a sua passagem para capturar a interação do usuário com a IU.
Geralmente, as escutas de evento são usadas para escutar a interação do usuário.
-No entanto, há casos em que você pode querer estender uma classe View para criar um componente personalizado.
+No entanto, há casos em que você pode querer estender uma classe View para criar um componente personalizado.
Talvez você queira estender a classe {@link android.widget.Button}
para deixar algo mais extravagante. Neste caso, você poderá definir os comportamentos de evento padrão
para a classe usando manipuladores de evento.
@@ -46,27 +46,27 @@ estiver registrada for ativada pela interação do usuário com o item na IU.
onClick()
-
De {@link android.view.View.OnClickListener}.
+
De {@link android.view.View.OnClickListener}.
Isto é chamado quando o usuário toca no item
(no modo de toque), ou atribui foco ao item com as teclas de navegação ou cursor de bola
e pressiona a tecla "enter" adequada ou pressiona o cursor de bola.
onLongClick()
-
De {@link android.view.View.OnLongClickListener}.
+
De {@link android.view.View.OnLongClickListener}.
Isto é chamado quando o usuário toca e mantém o item pressionado (no modo de toque),
ou atribui foco ao item com as teclas de navegação ou cursor de bola
e mantém pressionada a tecla "enter" adequada ou o cursor de bola (por um segundo).
onFocusChange()
-
De {@link android.view.View.OnFocusChangeListener}.
+
De {@link android.view.View.OnFocusChangeListener}.
Isto é chamado quando o usuário navega no ou do item, usando as teclas de navegação ou cursor de bola.
onKey()
-
De {@link android.view.View.OnKeyListener}.
+
De {@link android.view.View.OnKeyListener}.
Isto é chamado quando o usuário está com foco no item ou solta uma tecla de hardware no dispositivo.
onTouch()
-
De {@link android.view.View.OnTouchListener}.
+
De {@link android.view.View.OnTouchListener}.
Isto é chamado quando o usuário realiza uma ação qualificada como um toque de evento, incluindo o pressionamento, a liberação,
ou qualquer outro gesto de movimento na tela (dentro dos limites do item).
onCreateContextMenu()
-
De {@link android.view.View.OnCreateContextMenuListener}.
+
De {@link android.view.View.OnCreateContextMenuListener}.
Isto é chamado quando um menu de contexto está sendo construído (como resultado de um "clique longo"). Consulte a discussão
sobre menus de contexto no guia do desenvolvedor Menus
.
@@ -75,8 +75,8 @@ estiver registrada for ativada pela interação do usuário com o item na IU.Esses métodos são os únicos habitantes de suas respectivas interfaces. Para definir um desses métodos
e lidar com seus eventos, implemente a interface aninhada na atividade ou defina-a como uma classe anônima.
Em seguida, passe uma instância da implementação
-para o respectivo método View.set...Listener(). (Ex.:, chame
-{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}
+para o respectivo método View.set...Listener(). (Ex.:, chame
+{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}
e passe-o à implementação de {@link android.view.View.OnClickListener OnClickListener}.)
O exemplo abaixo mostra como registrar uma escuta de clique para um botão.
@@ -121,17 +121,17 @@ public class ExampleActivity extends Activity implements OnClickListener {
não tem valor de retorno, mas outros métodos de escuta de evento podem retornar um booleano. O motivo
depende do evento. Para os poucos que retornam, apresenta-se a razão:
-
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} -
- Isto retorna um booleano para indicar se você consumiu o evento e se ele deve ser levado adiante.
- Ou seja, ele retorna verdadeiro para indicar que você lidou com o evento e não deve seguir adiante;
+
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} -
+ Isto retorna um booleano para indicar se você consumiu o evento e se ele deve ser levado adiante.
+ Ou seja, ele retorna verdadeiro para indicar que você lidou com o evento e não deve seguir adiante;
ou retorna falso caso você não tenha lidado com ele e/ou o evento deva continuar para qualquer
outra escuta de clique.
{@link android.view.View.OnKeyListener#onKey(View,int,KeyEvent) onKey()} -
Isto retorna um booleano para indicar se você consumiu o evento e se ele deve ser levado adiante.
- Ou seja, ele retorna verdadeiro para indicar que você lidou com o evento e não deve seguir adiante;
+ Ou seja, ele retorna verdadeiro para indicar que você lidou com o evento e não deve seguir adiante;
ou retorna falso caso você não tenha lidado com ele e/ou o evento deva continuar para qualquer
outra escuta de tecla.
{@link android.view.View.OnTouchListener#onTouch(View,MotionEvent) onTouch()} -
Isto retorna um booleano para indicar se a escuta consome este evento. O importante é que este evento
pode possuir várias ações que se seguem mutuamente. Portanto, se retornar falso quando
o evento de ação inferior for recebido, você indicará que não consumiu o evento e que não está
@@ -181,14 +181,14 @@ mas podem ter impacto direto na maneira de lidar com os eventos. Portanto, ao ge
dentro de um layout, considere esses outros métodos:
{@link android.app.Activity#dispatchTouchEvent(MotionEvent)
- Activity.dispatchTouchEvent(MotionEvent)} - Isto permite que {@link
+ Activity.dispatchTouchEvent(MotionEvent)} - Isto permite que {@link
android.app.Activity} intercepte todos os evento de toque antes de serem enviados à janela.
{@link android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)
ViewGroup.onInterceptTouchEvent(MotionEvent)} - Isto permite que {@link
android.view.ViewGroup} assista aos eventos à medida que são enviados para as vistas filho.
{@link android.view.ViewParent#requestDisallowInterceptTouchEvent(boolean)
ViewParent.requestDisallowInterceptTouchEvent(boolean)} - Chame isto
- sobre uma Vista pai para indicar que ela não deve interceptar eventos de toque com {@link
+ sobre uma Vista pai para indicar que ela não deve interceptar eventos de toque com {@link
android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)}.
@@ -199,7 +199,7 @@ Quando um usuário está navegando em uma interface do usuário com teclas direc
ver o que aceitará entrada. Se o dispositivo tiver capacidades de toque, no entanto, e o usuário
começar a interagir com a interface por meio de toque, então não é mais necessário
destacar itens ou fornecer foco para uma vista específica. Contudo, há um modo
-de interação chamado "modo de toque".
+de interação chamado "modo de toque".
Para dispositivos com capacidades de toque, quando o usuário toca na tela, o dispositivo
@@ -214,7 +214,7 @@ sairá do modo de toque e encontrará uma vista para atribuir foco. Agora, o usu
com a interface do usuário sem tocar na tela.
-O estado de modo de toque é mantido em todo o sistema (todas as janelas e atividades).
+O estado de modo de toque é mantido em todo o sistema (todas as janelas e atividades).
Para consultar o estado atual, é possível chamar
{@link android.view.View#isInTouchMode} para ver se o dispositivo está no modo de toque no momento.
@@ -282,7 +282,7 @@ como discutido na seção Escutas de evento acima.
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/pt-br/preview/api-overview.jd b/docs/html-intl/intl/pt-br/preview/api-overview.jd
index c16d84701d114..d638e71fc53c6 100644
--- a/docs/html-intl/intl/pt-br/preview/api-overview.jd
+++ b/docs/html-intl/intl/pt-br/preview/api-overview.jd
@@ -48,7 +48,7 @@ page.image=images/cards/card-n-apis_2x.png
-
O Android N ainda está em desenvolvimento ativo, mas agora você já pode testá-lo
+
O Android N ainda está em desenvolvimento ativo, mas agora você já pode testá-lo
como parte do N Developer Preview. As seções a seguir destacam alguns dos
novos recursos para desenvolvedores.
@@ -62,7 +62,7 @@ novos recursos para desenvolvedores.
Suporte a várias janelas
-
No Android N, introduzimos um recurso de multitarefa novo e muito solicitado
+
No Android N, introduzimos um recurso de multitarefa novo e muito solicitado
na plataforma — o suporte a várias janelas.
Agora os usuários podem abrir dois aplicativos na tela ao mesmo tempo.
@@ -85,9 +85,9 @@ interage com outros aplicativos.
-
O suporte a várias janelas oferece novas formas de envolver os usuários,
-particularmente em tablets e outros dispositivos com telas maiores. Você pode até ativar o recurso de arrastar e soltar
-no aplicativo para permitir que os usuários arrastem conteúdo de ou para o aplicativo — uma ótima
+
O suporte a várias janelas oferece novas formas de envolver os usuários,
+particularmente em tablets e outros dispositivos com telas maiores. Você pode até ativar o recurso de arrastar e soltar
+no aplicativo para permitir que os usuários arrastem conteúdo de ou para o aplicativo — uma ótima
maneira de aprimorar a experiência do usuário.
É muito fácil adicionar suporte a várias janelas a seu aplicativo e configurar como ele
@@ -103,7 +103,7 @@ deste tamanho. Você também pode desativar a exibição de várias janelas para
Aprimoramentos de notificações
-
Reformulamos as notificações no Android N para facilitar e agilizar o
+
Reformulamos as notificações no Android N para facilitar e agilizar o
uso. Entre as alterações estão:
@@ -158,7 +158,7 @@ e a visualização de conteúdo.
Figura 2. Notificações empacotadas e resposta direta.
-
Para saber como implementar os novos recursos, consulte o
+
Para saber como implementar os novos recursos, consulte o
guia Notificações
.
O Project Svelte é um esforço contínuo para minimizar o uso de RAM pelo sistema e pelos aplicativos
-nos dispositivos Android existentes no ecossistema. No Android N, o Project
+
O Project Svelte é um esforço contínuo para minimizar o uso de RAM pelo sistema e pelos aplicativos
+nos dispositivos Android existentes no ecossistema. No Android N, o Project
Svelte se concentra em otimizar a forma de execução dos aplicativos em segundo plano.
-
O processamento em segundo plano é parte essencial da maioria dos aplicativos. Quando executado corretamente, a experiência
-do usuário pode ficar incrível — imediata, rápida e sensível ao contexto.
-Quando executado incorretamente, o processamento em segundo plano pode consumir desnecessariamente RAM (e
+
O processamento em segundo plano é parte essencial da maioria dos aplicativos. Quando executado corretamente, a experiência
+do usuário pode ficar incrível — imediata, rápida e sensível ao contexto.
+Quando executado incorretamente, o processamento em segundo plano pode consumir desnecessariamente RAM (e
bateria) e afetar o desempenho do sistema para os outros aplicativos.
-
Desde o Android 5.0, {@link android.app.job.JobScheduler} é a forma
-preferencial para execução de trabalho em segundo plano de uma maneira que beneficia
-os usuários. Os aplicativos podem agendar trabalhos e permitir que o sistema execute otimizações com base em
+
Desde o Android 5.0, {@link android.app.job.JobScheduler} é a forma
+preferencial para execução de trabalho em segundo plano de uma maneira que beneficia
+os usuários. Os aplicativos podem agendar trabalhos e permitir que o sistema execute otimizações com base em
condições de memória, energia e conectividade. O JobScheduler oferece controle e
simplicidade, e queremos que seja usado por todos os aplicativos.
@@ -253,23 +253,23 @@ simplicidade, e queremos que seja usado por todos os aplicativos.
Android.
-
Continuamos a expandir o JobScheduler e o
-GCMNetworkManager para atender a mais
-casos de uso — por exemplo, no Android N, você já pode agendar trabalhos
-em segundo plano de acordo com mudanças nos provedores de conteúdo. Ao mesmo tempo, começamos a
-substituir alguns padrões mais antigos que podem reduzir o desempenho do sistema,
+
Continuamos a expandir o JobScheduler e o
+GCMNetworkManager para atender a mais
+casos de uso — por exemplo, no Android N, você já pode agendar trabalhos
+em segundo plano de acordo com mudanças nos provedores de conteúdo. Ao mesmo tempo, começamos a
+substituir alguns padrões mais antigos que podem reduzir o desempenho do sistema,
particularmente em dispositivos com pouca memória.
No Android N, estamos removendo três transmissões implícitas de uso comum —
{@link android.net.ConnectivityManager#CONNECTIVITY_ACTION}, {@link
android.hardware.Camera#ACTION_NEW_PICTURE} e {@link
- android.hardware.Camera#ACTION_NEW_VIDEO} —, pois podem despertar simultaneamente
-processos em segundo plano de vários aplicativos, aumentando o consumo de memória e bateria. Se
+ android.hardware.Camera#ACTION_NEW_VIDEO} —, pois podem despertar simultaneamente
+processos em segundo plano de vários aplicativos, aumentando o consumo de memória e bateria. Se
o seu aplicativo receber essas transmissões, aproveite o N Developer Preview para
migrar para o JobScheduler e as APIs relacionadas.
@@ -284,27 +284,27 @@ em segundo plano para obter mais detalhes.
-
Normalmente, o custo de um plano de dados de celular ao longo da vida útil do dispositivo móvel
-excede o custo do próprio dispositivo. Para muitos usuários, os dados de celular
+
Normalmente, o custo de um plano de dados de celular ao longo da vida útil do dispositivo móvel
+excede o custo do próprio dispositivo. Para muitos usuários, os dados de celular
são um recurso caro que querem economizar.
-
O Android N introduz o modo de Economia de dados, um novo serviço do sistema que ajuda a reduzir
-o uso de dados de celular pelos aplicativos em situações de roaming, perto do final do ciclo de cobrança
-ou em pacotes de dados pré-pagos pequenos. A Economia de dados permite que os usuários controlem o
-uso de dados de celular e possibilita que os desenvolvedores ofereçam serviços mais eficientes quando o modo de Economia
+
O Android N introduz o modo de Economia de dados, um novo serviço do sistema que ajuda a reduzir
+o uso de dados de celular pelos aplicativos em situações de roaming, perto do final do ciclo de cobrança
+ou em pacotes de dados pré-pagos pequenos. A Economia de dados permite que os usuários controlem o
+uso de dados de celular e possibilita que os desenvolvedores ofereçam serviços mais eficientes quando o modo de Economia
de dados estiver ativado.
-
Quando um usuário ativa a Economia de dados em Settings e o dispositivo está
-em uma rede tarifada, o sistema bloqueia o uso de dados em segundo plano e avisa aos aplicativos
-para reduzir o uso de dados no primeiro plano sempre que possível — como, por exemplo, limitar a
-taxa de bits de streaming, reduzir a qualidade de imagens, adiar o armazenamento prévio otimista em cache
+
Quando um usuário ativa a Economia de dados em Settings e o dispositivo está
+em uma rede tarifada, o sistema bloqueia o uso de dados em segundo plano e avisa aos aplicativos
+para reduzir o uso de dados no primeiro plano sempre que possível — como, por exemplo, limitar a
+taxa de bits de streaming, reduzir a qualidade de imagens, adiar o armazenamento prévio otimista em cache
e assim por diante. Os usuários podem autorizar aplicativos específicos a usar dados tarifados
em segundo plano, mesmo com a Economia de dados ativada.
@@ -364,16 +364,16 @@ de dados e tentar limitar o uso de dados em primeiro e segundo plano.
-
As Configurações rápidas são uma forma popular e simples de expor as principais configurações e ações
-diretamente na aba de notificações. No Android N, ampliamos o escopo das
+
As Configurações rápidas são uma forma popular e simples de expor as principais configurações e ações
+diretamente na aba de notificações. No Android N, ampliamos o escopo das
Configurações rápidas para aumentar ainda mais a utilidade e a conveniência.
-
Adicionamos mais espaço para os blocos de Configurações rápidas, que os usuários podem
-acessar em uma área de exibição paginada deslizando à direita ou à esquerda. Além disso,
-permitimos que os usuários controlem quais blocos de Configurações rápidas são exibidos, bem como o local
+
Adicionamos mais espaço para os blocos de Configurações rápidas, que os usuários podem
+acessar em uma área de exibição paginada deslizando à direita ou à esquerda. Além disso,
+permitimos que os usuários controlem quais blocos de Configurações rápidas são exibidos, bem como o local
em que são exibidos — para adicionar ou mover blocos, os usuários simplesmente arrastam e soltam os blocos.
-
Para desenvolvedores, o Android N também adiciona uma API nova que permite definir os próprios
+
Para desenvolvedores, o Android N também adiciona uma API nova que permite definir os próprios
blocos de Configurações rápidas para que os usuários possam acessar facilmente os principais controles e ações do seu aplicativo.
@@ -396,25 +396,25 @@ blocos de Configurações rápidas para que os usuários possam acessar facilmen
Bloqueio de número
-
O Android N agora oferece suporte a bloqueio de números na plataforma e disponibiliza uma
+
O Android N agora oferece suporte a bloqueio de números na plataforma e disponibiliza uma
API de estrutura para permitir que provedores de serviço mantenham uma lista de números bloqueados. O
- aplicativo padrão de SMS, o aplicativo padrão de telefone e os aplicativos de provedor podem ler e gravar
+ aplicativo padrão de SMS, o aplicativo padrão de telefone e os aplicativos de provedor podem ler e gravar
a lista de números bloqueados. A lista não está acessível para outros aplicativos.
-
Ao oferecer o bloqueio de número como recurso padrão da plataforma, o Android oferece
-uma forma consistente de bloqueio de números em uma grande variedade de
+
Ao oferecer o bloqueio de número como recurso padrão da plataforma, o Android oferece
+uma forma consistente de bloqueio de números em uma grande variedade de
dispositivos. Alguns benefícios que podem ser aproveitados pelos aplicativos são:
Números bloqueados para chamadas também são bloqueados para mensagens de texto
-
Números bloqueados podem persistir entre várias redefinições e dispositivos por meio do
+
Números bloqueados podem persistir entre várias redefinições e dispositivos por meio do
recurso Backup e restauração
Vários aplicativos podem usar a mesma lista de números bloqueados
-
Além disso, a integração de aplicativos da operadora por meio do Android significa que as operadoras podem
-ler a lista de números bloqueados no dispositivo e executar um bloqueio do lado do servidor
-para o usuário, impedindo que chamadas e textos indesejados cheguem a ele
+
Além disso, a integração de aplicativos da operadora por meio do Android significa que as operadoras podem
+ler a lista de números bloqueados no dispositivo e executar um bloqueio do lado do servidor
+para o usuário, impedindo que chamadas e textos indesejados cheguem a ele
por qualquer meio, como terminais de VOIP ou encaminhamento de telefones.
@@ -449,23 +449,23 @@ da API, disponível para download.
O Android N agora permite que os usuários selecionem diversas localidades em Settings
-para oferecer melhor suporte a casos de uso bilíngue. Os aplicativos podem usar
-uma API nova para obter as localidades selecionadas pelo usuário e oferecer
-experiências de usuário mais sofisticadas para usuários com diversas localidades — como, por exemplo, mostrar resultados de pesquisa em
-diversos idiomas e não oferecer a tradução de páginas da web que usam
+para oferecer melhor suporte a casos de uso bilíngue. Os aplicativos podem usar
+uma API nova para obter as localidades selecionadas pelo usuário e oferecer
+experiências de usuário mais sofisticadas para usuários com diversas localidades — como, por exemplo, mostrar resultados de pesquisa em
+diversos idiomas e não oferecer a tradução de páginas da web que usam
um idioma conhecido pelo usuário.
-
Juntamente com o suporte a várias localidades, o Android N também amplia o número de idiomas
-disponíveis aos usuários. Ele oferece mais de 25 variantes para cada um dos idiomas
+
Juntamente com o suporte a várias localidades, o Android N também amplia o número de idiomas
+disponíveis aos usuários. Ele oferece mais de 25 variantes para cada um dos idiomas
mais comuns, como inglês, espanhol, francês e árabe. Além disso, adiciona suporte parcial
a mais de 100 novos idiomas.
Os aplicativos podem obter a lista de localidades definida pelo usuário chamando
LocaleList.GetDefault(). Para oferecer suporte ao maior número de localidades, o Android N está
-alterando a forma como resolve recursos. Não deixe de testar e verificar se seus aplicativos
+alterando a forma como resolve recursos. Não deixe de testar e verificar se seus aplicativos
funcionam da forma esperada com a nova lógica de resolução de recursos.
-
Para saber mais sobre o novo comportamento de resolução de recursos e sobre as práticas recomendadas que você deve
+
Para saber mais sobre o novo comportamento de resolução de recursos e sobre as práticas recomendadas que você deve
seguir, consulte Suporte a vários idiomas.
A API da estrutura do OpenGL ES 3.2 no Android N é fornecida pela classe
-GLES32. Ao usar o OpenGL ES 3.2, não deixe de declarar o
-requisito no arquivo manifesto usando o rótulo <uses-feature> e o
+GLES32. Ao usar o OpenGL ES 3.2, não deixe de declarar o
+requisito no arquivo manifesto usando o rótulo <uses-feature> e o
atributo android:glEsVersion.
-
Para obter mais informações sobre como usar o OpenGL ES, incluindo como verificar a versão do
+
Para obter mais informações sobre como usar o OpenGL ES, incluindo como verificar a versão do
OpenGL ES compatível do dispositivo no tempo de execução, consulte o guia da OpenGL ES API.
Gravação do Android TV
-
O Android N adiciona a capacidade de gravar e reproduzir conteúdo de serviços de entrada
-do Android TV por meio de novas APIs de gravação. Criados usando as APIs atuais de time-shifting,
-os serviços de entrada de TV podem controlar quais dados de canal são gravados e como
+
O Android N adiciona a capacidade de gravar e reproduzir conteúdo de serviços de entrada
+do Android TV por meio de novas APIs de gravação. Criados usando as APIs atuais de time-shifting,
+os serviços de entrada de TV podem controlar quais dados de canal são gravados e como
as sessões gravadas são salvas, bem como gerenciar a interação do usuário com o conteúdo gravado.
@@ -589,8 +589,8 @@ para desbloquear o perfil) usandosetPasswordQuality(),
Desativar o trabalho
-
Os usuários podem alternar o modo de trabalho em dispositivos com um perfil de trabalho. Quando o modo de trabalho está
-desativado, o usuário gerenciado é encerrado temporariamente, o que desativa
+
Os usuários podem alternar o modo de trabalho em dispositivos com um perfil de trabalho. Quando o modo de trabalho está
+desativado, o usuário gerenciado é encerrado temporariamente, o que desativa
os aplicativos, a sincronização em segundo plano e as notificações do perfil de trabalho. Isso inclui o aplicativo do
dono do perfil. Quando o modo de trabalho está desativado, o sistema exibe um ícone de status persistente
para lembrar ao usuário que não é possível iniciar aplicativos de trabalho. A tela de início
@@ -598,7 +598,7 @@ indica que os aplicativos e widgets de trabalho não podem ser acessados.
Always on VPN
-
Os donos de dispositivo e perfil podem garantir que os aplicativos de trabalho se conectem sempre
+
Os donos de dispositivo e perfil podem garantir que os aplicativos de trabalho se conectem sempre
por meio de uma VPN especificada. O sistema inicia automaticamente a VPN após a
inicialização do dispositivo.
@@ -608,7 +608,7 @@ por meio de uma VPN especificada. O sistema inicia automaticamente a VPN após a
getAlwaysOnVpnPackage().
-
Como os serviços de VPN podem ser vinculados diretamente pelo sistema sem interação com
+
Como os serviços de VPN podem ser vinculados diretamente pelo sistema sem interação com
aplicativos, os clientes de VPN precisam processar novos pontos de entrada para o Always on VPN. Da
mesma forma que antes, os serviços são indicados ao sistema por um filtro de intenção
correspondente à ação android.net.VpnService.
@@ -631,17 +631,17 @@ aplicativos, os clientes de VPN precisam processar novos pontos de entrada para
Aprimoramentos na acessibilidade
-
O Android N agora oferece Configurações de visão diretamente na tela de boas-vindas na instalação
+
O Android N agora oferece Configurações de visão diretamente na tela de boas-vindas na instalação
de novos dispositivos. Isso permite que os usuários descubram e configurem recursos de acessibilidade
em seus dispositivos de forma muito mais fácil, incluindo gesto de ampliação, tamanho
da fonte, tamanho da tela e TalkBack.
-
Com o posicionamento mais proeminente desses recursos de acessibilidade, os usuários
+
Com o posicionamento mais proeminente desses recursos de acessibilidade, os usuários
ficarão mais propensos a experimentar o aplicativo com os recursos ativados. Não deixe de testar antecipadamente os aplicativos
com essas configurações ativadas. Você pode ativá-las em Settings >
Accessibility.
-
Além disso, os serviços de acessibilidade no Android N podem ajudar usuários com deficiências
+
Além disso, os serviços de acessibilidade no Android N podem ajudar usuários com deficiências
motoras a tocar na tela. A nova API permite criar serviços com recursos
como acompanhamento de face, acompanhamento de olho e varredura de pontos, entre outros, para atender
às necessidades desses usuários.
@@ -652,22 +652,22 @@ como acompanhamento de face, acompanhamento de olho e varredura de pontos, entre
Inicialização direta
-
A inicialização direta reduz os tempos de inicialização dos dispositivos e permite que aplicativos
-registrados tenham funcionalidade limitada, mesmo após uma reinicialização inesperada.
-Por exemplo, se um dispositivo criptografado reinicializar durante o sono do usuário,
-alarmes registrados, mensagens e chamadas recebidas podem agora continuar notificando
+
A inicialização direta reduz os tempos de inicialização dos dispositivos e permite que aplicativos
+registrados tenham funcionalidade limitada, mesmo após uma reinicialização inesperada.
+Por exemplo, se um dispositivo criptografado reinicializar durante o sono do usuário,
+alarmes registrados, mensagens e chamadas recebidas podem agora continuar notificando
o usuário normalmente. Isso também significa que serviços de acessibilidade podem ser
disponibilizados imediatamente após um reinício.
-
A inicialização direita aproveita a criptografia baseada em arquivo do Android N
-para ativar políticas de criptografia detalhadas para dados de sistema e aplicativos.
-O sistema usa um armazenamento criptografado pelo dispositivo para determinados dados de sistema e dados
+
A inicialização direita aproveita a criptografia baseada em arquivo do Android N
+para ativar políticas de criptografia detalhadas para dados de sistema e aplicativos.
+O sistema usa um armazenamento criptografado pelo dispositivo para determinados dados de sistema e dados
de aplicativos registrados explicitamente. Por padrão, um armazenamento criptografado por credencial é usado para todos
os outros dados de sistema, dados de usuário, aplicativos e dados de aplicativos.
-
Na inicialização, o sistema inicia em um modo restrito que permite
-acessar apenas dados criptografados pelo dispositivo, sem acesso geral a aplicativos ou dados.
-Se você deseja executar componentes nesse modo, pode registrá-los
+
Na inicialização, o sistema inicia em um modo restrito que permite
+acessar apenas dados criptografados pelo dispositivo, sem acesso geral a aplicativos ou dados.
+Se você deseja executar componentes nesse modo, pode registrá-los
definindo um sinalizador no manifesto. Após a reinicialização, o sistema ativa
componentes registrados transmitindo a intenção LOCKED_BOOT_COMPLETED
. O sistema garante que dados de aplicativos registrados criptografados pelos dispositivos sejam disponibilizados
@@ -680,26 +680,26 @@ Para obter mais informações, consulte Confirmação de chaves
-
autoridades de certificado (CA) são confiáveis para as conexões seguras. Por
exemplo, confiar em certificados autoassinados privados ou um restrito conjunto de CAs públicas.
-
Substituições apenas em depuração. Permite que um desenvolvedor de aplicativos depure
-conexões seguras do aplicativo com segurança, sem adicionar riscos à base
+
Substituições apenas em depuração. Permite que um desenvolvedor de aplicativos depure
+conexões seguras do aplicativo com segurança, sem adicionar riscos à base
instalada.
-
Cancelamento do uso de tráfego de texto simples. Permite que um aplicativo seja protegido contra
+
Cancelamento do uso de tráfego de texto simples. Permite que um aplicativo seja protegido contra
o uso acidental de tráfego de texto simples.
Fixação de certificados. Um recurso avançado que permite que os aplicativos
limitem quais chaves de servidor são confiáveis para conexões seguras.
Por padrão, os aplicativos direcionados ao Android N confiam apenas em certificados fornecidos pelo sistema
-e não confiam mais em Autoridades de certificado (CA) adicionadas pelo usuário. Os aplicativos direcionados ao Android
-N que querem confiar em CAs adicionadas pelo usuário devem usar a
-Configuração de segurança de rede para
+
Por padrão, os aplicativos direcionados ao Android N confiam apenas em certificados fornecidos pelo sistema
+e não confiam mais em Autoridades de certificado (CA) adicionadas pelo usuário. Os aplicativos direcionados ao Android
+N que querem confiar em CAs adicionadas pelo usuário devem usar a
+Configuração de segurança de rede para
especificar como confiar nas CAs de usuário.
Esquema de assinatura de APK v2
@@ -804,18 +804,18 @@ o arquivo de programação para assinar aplicativos usando o plug-in do Andr
No Android N, os aplicativos podem usar novas APIs para solicitar acesso a determinados diretórios de armazenamento
externo, incluindo diretórios em mídias removíveis, tais como cartões
SD. As novas APIs simplificam consideravelmente como o aplicativo acessa os
-diretórios de armazenamento externo padrão, tais como o diretórioPictures. Os aplicativos,
-como aplicativos de fotografia, podem usar essas APIs em vez de
-READ_EXTERNAL_STORAGE, que concede acesso a todos os diretórios de
-armazenamento, ou da Estrutura de acesso ao armazenamento, que faz o usuário navegar até
+diretórios de armazenamento externo padrão, tais como o diretórioPictures. Os aplicativos,
+como aplicativos de fotografia, podem usar essas APIs em vez de
+READ_EXTERNAL_STORAGE, que concede acesso a todos os diretórios de
+armazenamento, ou da Estrutura de acesso ao armazenamento, que faz o usuário navegar até
o diretório.
-
Além disso, as novas APIs simplificam as etapas executadas pelo usuário para conceder ao aplicativo
+
Além disso, as novas APIs simplificam as etapas executadas pelo usuário para conceder ao aplicativo
acesso ao armazenamento externo. Quando você usa as novas APIs, o sistema usa uma IU de permissões simples
que detalha claramente a qual diretório o aplicativo
está solicitando acesso.
-
Para obter mais informações, consulte a documentação para desenvolvedores
+
@@ -846,7 +846,7 @@ limite de temperatura. Esta flutuação representa um desafio para desenvolvedor
-Para tratar estas limitações, o Android N inclui compatibilidade opcional para
+Para tratar estas limitações, o Android N inclui compatibilidade opcional para
modo de desempenho sustentado, permitindo que OEMs ofereçam dicas sobre
capacidades de desempenho em dispositivo para aplicativos de longa duração. Os desenvolvedores de aplicativos
podem usar essas dicas para ajustar os aplicativos para um nível de desempenho do dispositivo previsível
@@ -869,8 +869,8 @@ O Android N adiciona compatibilidade de plataformas e otimizações para um novo
desenvolvedores a capacidade de projetar experiências de RV móveis de alta qualidade para os usuários. Há diversas melhorias de desempenho
, incluindo acesso a um núcleo exclusivo da CPU para aplicativos de RV.
Dentro dos aplicativos, é possível tirar vantagem do rastreamento inteligente da cabeça
-e de notificações estéreo que funcionam para RV. Mais importante, o Android N oferece
-gráficos de latência muito baixa. Para obter informações completas sobre a criação de aplicativos de RV para Android N,
+e de notificações estéreo que funcionam para RV. Mais importante, o Android N oferece
+gráficos de latência muito baixa. Para obter informações completas sobre a criação de aplicativos de RV para Android N,
consulte o Google VR SDK para Android.
- Junto com novos recursos e funcionalidades, o Android N
+ Junto com novos recursos e funcionalidades, o Android N
inclui uma variedade de mudanças de comportamento do sistema e da API. Este documento
destaca algumas das principais mudanças que você deve entender e considerar
nos aplicativos.
@@ -88,7 +88,7 @@ recursos do sistema, bem como a forma como ele interage com outros aplicativos p
período, o dispositivo entrará no modo de soneca e aplicará o primeiro subconjunto de restrições: o
acesso do aplicativo à rede será desativado e os trabalhos e sincronizações serão adiados. Se o dispositivo permanecer
estacionário por um determinado período após entrar no modo soneca, o sistema aplicará
-as demais restrições de soneca a {@link android.os.PowerManager.WakeLock}, aos alarmes
+as demais restrições de soneca a {@link android.os.PowerManager.WakeLock}, aos alarmes
{@link android.app.AlarmManager} e às verificações de GPS e Wi-Fi. Independentemente
de as restrições de soneca serem aplicadas parcial ou totalmente, o sistema despertará o
dispositivo para breves janelas de manutenção, quando os aplicativos
@@ -151,7 +151,7 @@ do dispositivo e a experiência do usuário.
Os aplicativos direcionados ao Android N não receberão transmissões {@link
android.net.ConnectivityManager#CONNECTIVITY_ACTION}, mesmo
- se tiverem entradas no manifesto solicitando notificação desses eventos. Os aplicativos em execução
+ se tiverem entradas no manifesto solicitando notificação desses eventos. Os aplicativos em execução
ainda poderão escutar {@code CONNECTIVITY_CHANGE} no encadeamento principal
se solicitarem a notificação com {@link android.content.BroadcastReceiver}.
@@ -175,7 +175,7 @@ android.app.job.JobScheduler} para reagir a mudanças em provedores de conteúdo
Para aplicativos direcionados ao Android N, a estrutura do Android cumpre com
-a política de API {@link android.os.StrictMode} que proíbe a exposição de URIs {@code file://}
+a política de API {@link android.os.StrictMode} que proíbe a exposição de URIs {@code file://}
fora do aplicativo. Se uma intenção que contenha o URI de um arquivo deixar o aplicativo, ele falhará
com uma exceção {@code FileUriExposedException}.
Para compartilhar arquivos entre aplicativos, você deve enviar um URI {@code content://}
-e conceder uma permissão de acesso temporária ao URI. A forma mais fácil de conceder essa permissão é
+e conceder uma permissão de acesso temporária ao URI. A forma mais fácil de conceder essa permissão é
usar a classe {@link android.support.v4.content.FileProvider}. Para obter mais informações
sobre permissões e compartilhamento de arquivos,
consulte Compartilhamento de Arquivos.
@@ -334,7 +334,7 @@ sw320dp, que é a largura do Nexus 4, um telefone comum de tamanho médio.
rede. Verifique a ocorrência de alterações de configuração quando o aplicativo sair do estado pausado e retomar
a execução.
- Observação: se você armazenar em cache dados dependentes de configuração,
+ Observação: se você armazenar em cache dados dependentes de configuração,
recomendamos incluir metadados relevantes, como o tamanho de tela
adequado ou a densidade de pixels desses dados. Salvar esses dados permitirá que você
decida se será necessário atualizar os dados armazenados em cache após uma mudança
@@ -373,7 +373,7 @@ configurações ativadas. As configurações podem ser encontradas em Se
Para alertar sobre o uso de APIs não públicas, os aplicativos executados em um dispositivo
Android N geram um erro na saída logcat quando um aplicativo chama uma API não pública.
- Esse erro também é exibido na tela do dispositivo como mensagem para que o usuário
+ Esse erro também é exibido na tela do dispositivo como mensagem para que o usuário
fique ciente da situação. Revise o código do seu aplicativo para
remover o uso de APIs de plataformas não públicas e faça testes completos do aplicativo usando
um dispositivo de visualização ou um emulador.
@@ -384,7 +384,7 @@ fique ciente da situação. Revise o código do seu aplicativo para
para obter soluções usuais de substituição de APIs privadas comuns por APIs públicas equivalentes.
Também é possível que você esteja vinculando bibliotecas de plataforma sem perceber,
particularmente se o aplicativo usar uma biblioteca que faz parte da plataforma (como
- libpng), mas não faz parte do NDK. Nesse caso, verifique se
+ libpng), mas não faz parte do NDK. Nesse caso, verifique se
o APK contém todos os arquivos .so que você pretende vincular.
@@ -398,9 +398,9 @@ o APK contém todos os arquivos .so que você pretende vincular.
Os aplicativos não devem depender de nem usar bibliotecas nativas não incluídas
no NDK, pois elas podem ser alteradas ou removidas entre uma versão do Android
e outra. A mudança de OpenSSL para BoringSSL é um exemplo dessas alterações.
- Além disso, dispositivos diferentes podem oferecer níveis distintos de compatibilidade, pois
- não há requisitos de compatibilidade para bibliotecas de plataforma não incluídas
-no NDK. Se você precisar acessar bibliotecas que não são do NDK em dispositivos mais antigos, torne o carregamento
+ Além disso, dispositivos diferentes podem oferecer níveis distintos de compatibilidade, pois
+ não há requisitos de compatibilidade para bibliotecas de plataforma não incluídas
+no NDK. Se você precisar acessar bibliotecas que não são do NDK em dispositivos mais antigos, torne o carregamento
dependente do nível da Android API.
@@ -528,28 +528,28 @@ Se o seu aplicativo se baseou neste comportamento, adicione uma política de ret
Quando um aplicativo for executado no Android N, mas for direcionado a um nível da API menor
- e o usuário alterar o tamanho da tela, o processo do aplicativo será eliminado. O aplicativo
-deverá ser capaz de processar corretamente esse cenário. Caso contrário, ele falhará
+ e o usuário alterar o tamanho da tela, o processo do aplicativo será eliminado. O aplicativo
+deverá ser capaz de processar corretamente esse cenário. Caso contrário, ele falhará
quando o usuário restaurá-lo usando Recents.
-Você deve testar o aplicativo para verificar
-se esse comportamento não ocorre.
-Isso pode ser feito causando uma falha idêntica
+Você deve testar o aplicativo para verificar
+se esse comportamento não ocorre.
+Isso pode ser feito causando uma falha idêntica
eliminando o aplicativo manualmente usando o DDMS.
-Aplicativos direcionados ao Android N e versões posteriores não serão eliminados automaticamente em mudanças de densidade.
+Aplicativos direcionados ao Android N e versões posteriores não serão eliminados automaticamente em mudanças de densidade.
No entanto, podem continuar a responder a alterações de configurações de forma não ideal.
-Os aplicativos no Android N devem ser capazes de processar corretamente mudanças de configuração
-e não devem falhar em inicializações subsequentes. Você pode verificar o comportamento do aplicativo
+Os aplicativos no Android N devem ser capazes de processar corretamente mudanças de configuração
+e não devem falhar em inicializações subsequentes. Você pode verificar o comportamento do aplicativo
alterando o tamanho da fonte (Setting >
-Display > Font size) e depois restaurando
+Display > Font size) e depois restaurando
o aplicativo em Recents.
@@ -557,12 +557,12 @@ o aplicativo em Recents.
Devido a um erro em versões anteriores do Android, o sistema não sinaliza gravações
em um soquete TCP no encadeamento principal como violações do modo estrito. O Android N corrigiu esse erro.
Agora, os aplicativos que exibirem este comportamento gerarão uma{@code android.os.NetworkOnMainThreadException}.
-Geralmente, a realização de operações de rede no encadeamento principal é uma má ideia porque essas operações
+Geralmente, a realização de operações de rede no encadeamento principal é uma má ideia porque essas operações
geralmente têm alta latência no final, causando ANRs e problemas.
-Agora, por padrão, a família de métodos {@code Debug.startMethodTracing()} armazena
+Agora, por padrão, a família de métodos {@code Debug.startMethodTracing()} armazena
os resultados no diretório específico do pacote no armazenamento compartilhado,
e não no nível mais alto
do cartão SD. Isso significa que os aplicativos não precisam mais solicitar a permissão {@code WRITE_EXTERNAL_STORAGE} para usar estas APIs.
@@ -583,9 +583,9 @@ que faz com que {@code ActivityThread.StopInfo} gere uma
Se um aplicativo publica tarefas {@link java.lang.Runnable} para uma {@link android.view.View} e
esta {@link android.view.View}
não está anexada a uma janela, o sistema
-coloca a tarefa {@link java.lang.Runnable} em fila com a {@link android.view.View}.
-A tarefa {@link java.lang.Runnable} não é executada até que a
-{@link android.view.View} esteja anexada
+coloca a tarefa {@link java.lang.Runnable} em fila com a {@link android.view.View}.
+A tarefa {@link java.lang.Runnable} não é executada até que a
+{@link android.view.View} esteja anexada
a uma janela. Este comportamento corrige os seguintes erros:
Se um aplicativo publicasse em uma {@link android.view.View} de um encadeamento que não fosse o encadeamento de IU da janela pretendida
diff --git a/docs/html-intl/intl/pt-br/preview/features/afw.jd b/docs/html-intl/intl/pt-br/preview/features/afw.jd
index c16cff9f97e0c..977d2a0f968a0 100644
--- a/docs/html-intl/intl/pt-br/preview/features/afw.jd
+++ b/docs/html-intl/intl/pt-br/preview/features/afw.jd
@@ -101,7 +101,7 @@ ao dispositivo.
Donos de perfis podem exigir que os usuários especifiquem um desafio de segurança para aplicativos
em execução no perfil de trabalho. O sistema mostra o desafio de segurança quando o
usuário tenta abrir qualquer aplicativo de trabalho. Se o usuário preencher corretamente o
- desafio de segurança, o sistema desbloqueará e, se necessário, descriptografará o
+ desafio de segurança, o sistema desbloqueará e, se necessário, descriptografará o
perfil de trabalho.
@@ -126,14 +126,14 @@ android.app.admin.DevicePolicyManager#setPasswordMinimumLength
setPasswordMinimumLength()}. O dono de perfil também pode definir o bloqueio de dispositivo
usando a instância de {@link android.app.admin.DevicePolicyManager} retornada
pelo novo método DevicePolicyManager.getParentProfileInstance()
-. Além disso, donos de perfil podem personalizar a tela de credenciais do
+. Além disso, donos de perfil podem personalizar a tela de credenciais do
desafio de trabalho usando os novos métodos setOrganizationColor() e
setOrganizationName() da classe {@link android.app.admin.DevicePolicyManager}
.
- Para obter detalhes sobre os novos métodos e constantes, consulte a
+ Para obter detalhes sobre os novos métodos e constantes, consulte a
página de referência DevicePolicyManager na referência do N Preview SDK.
@@ -149,7 +149,7 @@ página de referência DevicePolicyManager na tela de visão geral é ocultada.
Os pacotes suspensos não são exibidos na tela de visão geral e não
- podem mostrar caixas de diálogo (incluindo avisos e snackbars). Também não conseguem reproduzir
+ podem mostrar caixas de diálogo (incluindo avisos e snackbars). Também não conseguem reproduzir
áudio nem vibrar o dispositivo.
@@ -175,13 +175,13 @@ de trabalho. A tela de início indica que os aplicativos e widgets de trabalho n
Always-On VPN
- Os donos de dispositivo e perfil podem exigir que os aplicativos de trabalho se conectem sempre
+ Os donos de dispositivo e perfil podem exigir que os aplicativos de trabalho se conectem sempre
por meio de uma VPN especificada. Se os donos definirem este requisito, o
dispositivo iniciará a VPN automaticamente na inicialização.
- Os donos podem exigir o uso de uma VPN chamando o novo
+ Os donos podem exigir o uso de uma VPN chamando o novo
método DevicePolicyManager.setAlwaysOnVpnPackage(). Para descobrir
se o dono definiu um requisito de VPN, chame o novo
método DevicePolicyManager.GetAlwaysOnVpnPackage().
@@ -319,7 +319,7 @@ o registro no dispositivo usando DevicePolicyManager.setSecurityLoggingEna
- O Android N inclui as seguintes adições de API para dar suporte a este recurso. Para
+ O Android N inclui as seguintes adições de API para dar suporte a este recurso. Para
obter detalhes, consulte a Referência do N
Preview SDK.
O Android N é executado em um modo seguro de inicialização direta
+
O Android N é executado em um modo seguro de inicialização direta
quando o dispositivo é ligado, mas o usuário não o
desbloqueia. Para isso, o sistema oferece dois locais de armazenamento para dados:
Se você compilar o aplicativo com o N Preview SDK, poderá configurar como o aplicativo
- processa a exibição de várias janelas. Por exemplo, você pode especificar as dimensões
+ processa a exibição de várias janelas. Por exemplo, você pode especificar as dimensões
mínimas permitidas para a atividade. Você também pode desativar a exibição de várias janelas para
- o aplicativo, garantindo que o sistema mostre o aplicativo apenas
+ o aplicativo, garantindo que o sistema mostre o aplicativo apenas
em modo de tela inteira.
diff --git a/docs/html-intl/intl/pt-br/preview/features/multilingual-support.jd b/docs/html-intl/intl/pt-br/preview/features/multilingual-support.jd
index 072e55b58cd8f..c00eb9b9a798d 100644
--- a/docs/html-intl/intl/pt-br/preview/features/multilingual-support.jd
+++ b/docs/html-intl/intl/pt-br/preview/features/multilingual-support.jd
@@ -29,7 +29,7 @@ se seu aplicativo oferecer suporte a vários idiomas, você deverá garantir que
esperada. Por fim, garanta que seu aplicativo possa lidar corretamente
com idiomas que ele não tenha sido explicitamente projetado para suportar.
-
Este documento começa explicando a estratégia de resolução de recursos anterior ao
+
Este documento começa explicando a estratégia de resolução de recursos anterior ao
Android N. Em seguida, ele descreve a estratégia
de resolução de recursos aprimorada do Android N. Por fim, ele explica como aproveitar as vantagens
do maior número de localidades para oferecer suporte a usuários multilíngues.
@@ -215,7 +215,7 @@ não deixe de usar formatadores em vez de strings no código para números e dat
Um bom exemplo é o árabe, cujo suporte no Android N foi expandido de
uma {@code ar_EG} para 27 localidades de árabe. Essas localidades podem compartilhar a maioria dos recursos,
mas algumas preferem dígitos ASCII, enquanto outras preferem dígitos nativos. Por exemplo,
-quando você quer criar uma frase com uma variável em dígito, como
+quando você quer criar uma frase com uma variável em dígito, como
“Choose a 4 digit pin”, use formatadores como mostrado abaixo:
format(locale, "Choose a %d-digit PIN", 4)
diff --git a/docs/html-intl/intl/pt-br/preview/features/notification-updates.jd b/docs/html-intl/intl/pt-br/preview/features/notification-updates.jd
index 72c2fe6185220..36988da09ea50 100644
--- a/docs/html-intl/intl/pt-br/preview/features/notification-updates.jd
+++ b/docs/html-intl/intl/pt-br/preview/features/notification-updates.jd
@@ -212,7 +212,7 @@ anexar a resposta do usuário ao histórico da entrada remota.
Notificações empacotadas
O Android N oferece aos desenvolvedores uma nova forma de representar
- uma fila de notificações: notificações empacotadas. Essa forma é semelhante ao recurso
+ uma fila de notificações: notificações empacotadas. Essa forma é semelhante ao recurso
Pilhas
de Notificações no Android Wear. Por exemplo, se o aplicativo criar notificações
para mensagens recebidas, quando mais de uma mensagem for recebida, empacote as
@@ -243,8 +243,8 @@ Builder.setGroup()} para empacotar notificações semelhantes.
sistema as agrupará automaticamente.
-
Para saber como adicionar notificações a um grupo, consulte
-Adicionar
+
Os exemplos de casos em que uma única notificação é preferível
incluem mensagens individuais de uma única pessoa ou uma representação em lista
- de itens de texto com uma única linha. Você pode usar
+ de itens de texto com uma única linha. Você pode usar
({@link android.app.Notification.InboxStyle InboxStyle} ou
{@link android.app.Notification.BigTextStyle BigTextStyle}) para
isso.
@@ -354,7 +354,7 @@ Os exemplos de casos em que uma única notificação é preferível
Para usar essa nova API, chame o método {@code setStyle()}, passando o
estilo de visualização personalizada desejado.
-
O snippet mostra como construir um objeto de notificação personalizada com o método
+
O snippet mostra como construir um objeto de notificação personalizada com o método
{@code DecoratedCustomViewStyle()}.
@@ -370,7 +370,7 @@ Notification notification = new Notification.Builder()
Estilo de mensagens
O Android N traz uma nova API para personalização do estilo de uma notificação.
- Usando a classe MessageStyle, você pode alterar vários
+ Usando a classe MessageStyle, você pode alterar vários
rótulos exibidos na notificação, incluindo o título da conversa,
mensagens adicionais e a visualização de conteúdo para a notificação.
Alternar a atividade para o modo de imagem em imagem
Quando precisar colocar a atividade no modo de PIP, chame
-Activity.enterPictureInPictureMode(). O exemplo a seguir
+Activity.enterPictureInPictureMode(). O exemplo a seguir
entra no modo de PIP quando o usuário seleciona um botão dedicado ao PIP na barra de controle de
uma mídia:
@@ -146,7 +146,7 @@ public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode) {
}
-
Continuar reprodução de vídeo no modo de
+
Continuar reprodução de vídeo no modo de
imagem em imagem
Quando a atividade entra no modo de PIP, o sistema a considera
@@ -177,11 +177,11 @@ imagem em imagem
Ao navegar pelo conteúdo
da tela principal de seu aplicativo, um usuário pode selecionar um novo vídeo enquanto uma atividade de reprodução de vídeo estiver em modo de PIP. Reproduza o novo
- vídeo na atividade de reprodução existente em modo de tela cheia em vez de
+ vídeo na atividade de reprodução existente em modo de tela cheia em vez de
lançar uma nova atividade que pode confundir o usuário.
Para que uma única atividade seja usada para solicitações de reprodução de vídeo e
-com o modo de PIP ativado ou desativado, conforme necessário, configure o
+com o modo de PIP ativado ou desativado, conforme necessário, configure o
android:launchMode da atividade para singleTask em seu manifesto.
@@ -194,7 +194,7 @@ com o modo de PIP ativado ou desativado, conforme necessário, configure o
Na atividade, modifique {@link android.app.Activity#onNewIntent
-Activity.onNewIntent()} e processe o novo vídeo, interrompendo qualquer
+Activity.onNewIntent()} e processe o novo vídeo, interrompendo qualquer
reprodução existente, caso necessário.
Práticas recomendadas
diff --git a/docs/html-intl/intl/pt-br/preview/features/scoped-folder-access.jd b/docs/html-intl/intl/pt-br/preview/features/scoped-folder-access.jd
index ef9ba6596189b..6a58d7656646b 100644
--- a/docs/html-intl/intl/pt-br/preview/features/scoped-folder-access.jd
+++ b/docs/html-intl/intl/pt-br/preview/features/scoped-folder-access.jd
@@ -25,7 +25,7 @@ acesso direcionado a diretórios para esses tipos de aplicativos. Por exemplo:
-
Usar a
+
Usar a
Estrutura de
acesso ao armazenamento geralmente faz com que o usuário selecione diretórios
por meio de uma IU de sistema, o que é desnecessário se seu aplicativo sempre acessa o mesmo
@@ -54,7 +54,7 @@ o diretório de armazenamento externo para o arquivo.
Em volumes secundários, como cartões SD externos, passe nulo ao chamar
StorageVolume.createAccessIntent() para solicitar acesso ao
volume todo em vez de um diretório específico.
-StorageVolume.createAccessIntent() retornará nulo se você passar
+StorageVolume.createAccessIntent() retornará nulo se você passar
nulo no volume principal ou se passar um nome de diretório inválido.
@@ -80,7 +80,7 @@ acesso ao diretório Pictures.
onActivityResult() com um código de resultado de
Activity.RESULT_OK e os dados de intenção que contêm o URI. Use
o URI fornecido para acessar as informações do diretório, o que é semelhante a usar URIs
-retornados pela
+retornados pela
Estrutura de
acesso ao armazenamento.
diff --git a/docs/html-intl/intl/pt-br/preview/features/tv-recording-api.jd b/docs/html-intl/intl/pt-br/preview/features/tv-recording-api.jd
index 15d22d1a8d4ff..890e1403793b8 100644
--- a/docs/html-intl/intl/pt-br/preview/features/tv-recording-api.jd
+++ b/docs/html-intl/intl/pt-br/preview/features/tv-recording-api.jd
@@ -123,7 +123,7 @@ os aplicativos de canais com recursos de gravação na tabela de provedor de con
RecordedPrograms.Uri. Use APIs de provedores de conteúdo para
ler, adicionar e excluir entradas dessa tabela.
-
Para saber mais sobre como trabalhar com dados de provedores de conteúdo, consulte
+
Para começar a usar esses recursos, primeiro faça o download e instale o Android
-Studio 2.1 e o Android N Preview SDK, que inclui a
+Studio 2.1 e o Android N Preview SDK, que inclui a
cadeia de ferramentas Jack obrigatória e o Android Plugin for Gradle atualizado. Se você ainda não
instalou o Android N Preview SDK, consulte Preparação para desenvolver para o Android N.
- Informe problemas e dê-nos feedback usando o
+ Informe problemas e dê-nos feedback usando o
issue tracker. Conecte-se a outros
desenvolvedores na
Comunidade N Developer.
@@ -262,7 +262,7 @@ page.tags="preview", "developer", "android"
Exemplo de código que
@@ -333,7 +333,7 @@ suporte para várias janelas, notificações agrupadas, suporte para vários idi
Referência da API para download
- Durante as primeiras atualizações do Preview, você pode fazer o download da
+ Durante as primeiras atualizações do Preview, você pode fazer o download da
referência da API
mais recente para a plataforma Android N como um arquivo zip separado. Esse download
também inclui um relatório de diferenças que ajuda você a identificar as mudanças da API em relação à
@@ -357,7 +357,7 @@ suporte para várias janelas, notificações agrupadas, suporte para vários idi
O Issue
Tracker do N Developer Preview é o canal principal de feedback. É possível informar erros,
- problemas de desempenho e feedback geral pelo issue tracker. Também é possível verificar os
+ problemas de desempenho e feedback geral pelo issue tracker. Também é possível verificar os
erros conhecidos e
encontrar etapas de resolução. Manteremos você atualizado sobre seu problema conforme ele seja avaliado e
enviado para a equipe de engenharia do Android para análise.
@@ -374,7 +374,7 @@ suporte para várias janelas, notificações agrupadas, suporte para vários idi
O N Developer Preview fornece um sistema apenas para desenvolvimento e uma biblioteca Android
que não tem um nível da API padrão. Caso opte
pelos comportamentos de compatibilidade para testar o aplicativo (o que é muito
- recomendado), é possível destinar a versão de prévia do Android N
+ recomendado), é possível destinar a versão de prévia do Android N
configurando o targetSdkVersion do aplicativo
para “N”.
diff --git a/docs/html-intl/intl/pt-br/preview/setup-sdk.jd b/docs/html-intl/intl/pt-br/preview/setup-sdk.jd
index 6db456cba6bc5..9c1f035226036 100644
--- a/docs/html-intl/intl/pt-br/preview/setup-sdk.jd
+++ b/docs/html-intl/intl/pt-br/preview/setup-sdk.jd
@@ -41,7 +41,7 @@ compilar seu aplicativo. Caso contrário, não será preciso usar o Jack, mas ai
necessário atualizar para o JDK 8 para desenvolver para a plataforma Android N,
conforme descrito abaixo.
-
Se você já instalou o Android Studio, verifique se tem o Android
+
Se você já instalou o Android Studio, verifique se tem o Android
Studio 2.1 ou superior clicando em Help > Check for Update
(no Mac, Android Studio > Check for Updates).
@@ -51,7 +51,7 @@ Studio 2.1 aqui
.
Obter o N Preview SDK
-
Para começar a desenvolver com as APIs do Android N, instale o
+
Para começar a desenvolver com as APIs do Android N, instale o
Android N Preview SDK no Android Studio da seguinte maneira:
@@ -77,7 +77,7 @@ Android N Preview SDK no Android Studio da seguinte maneira:
Informações detalhadas sobre as APIs do Android N são disponibilizadas na documentação de referência do N Preview
, que pode ser baixada pela tabela a seguir.
- Este pacote contém uma versão off-line resumida do site de desenvolvedores do Android
+ Este pacote contém uma versão off-line resumida do site de desenvolvedores do Android
e inclui uma referência de API atualizada para as APIs do Android N, além de um relatório
das diferenças entre as APIs.
@@ -92,7 +92,7 @@ Android N Preview SDK no Android Studio da seguinte maneira:
n-preview-3-docs.zip
@@ -131,7 +131,7 @@ não tiver a versão mais recente, baixe o JDK 8 agora mesmo.
Para usar as APIs do Android N, seu projeto deve ser configurado da maneira apropriada.
-
Se planeja usar os recursos de linguagem do Java 8, consulte
+
Se planeja usar os recursos de linguagem do Java 8, consulte
Recursos de linguagem do Java 8
para saber mais sobre os recursos do Java 8 com suporte e
como configurar seu projeto com o compilador Jack.
diff --git a/docs/html-intl/intl/pt-br/preview/support.jd b/docs/html-intl/intl/pt-br/preview/support.jd
index 4580887b7a8b9..9ae32c89fd250 100644
--- a/docs/html-intl/intl/pt-br/preview/support.jd
+++ b/docs/html-intl/intl/pt-br/preview/support.jd
@@ -101,7 +101,7 @@ page.image=images/cards/card-n-support_2x.png
desenvolvedores a capacidade de projetar experiências de RV móveis de alta qualidade para os usuários. Há
diversas melhorias de desempenho, incluindo o acesso a um núcleo exclusivo da CPU
para aplicativos de RV. Dentro dos aplicativos, é possível aproveitar o rastreamento inteligente
- da cabeça e notificações estéreo que funcionam para RV. Mais importante,
+ da cabeça e notificações estéreo que funcionam para RV. Mais importante,
o Android N oferece gráficos de latência muito baixa.
@@ -112,7 +112,7 @@ o Android N oferece gráficos de latência muito baixa.
Modo de desempenho sustentado
- O Android N inclui compatibilidade opcional para modo de desempenho
+ O Android N inclui compatibilidade opcional para modo de desempenho
sustentado, permitindo que OEMs ofereçam dicas sobre
capacidades de desempenho do dispositivo para aplicativos de longa duração. Desenvolvedores de aplicativos podem usar
essas dicas para ajustar os aplicativos para um nível de
@@ -143,7 +143,7 @@ sustentado, permitindo que OEMs ofereçam dicas sobre
No Android N, o usuário pode pressionar Meta+/ para acionar uma tela de atalhos
de teclado que exibe todos os atalhos disponíveis do
sistema e do aplicativo em questão. Os desenvolvedores podem adicionar os próprios atalhos ou
- ativar a tela de atalhos nos aplicativos. Consulte o Auxiliar de
+ ativar a tela de atalhos nos aplicativos. Consulte o Auxiliar de
atalhos de teclado para saber mais.
@@ -223,7 +223,7 @@ API
Agora o sistema usa os metadados da atividade para decidir o modo do bloco.
(Anteriormente, o modo do bloco era determinado pelo valor de retorno do
- TileService.onTileAdded().) Para obter mais informações, consulte
+ TileService.onTileAdded().) Para obter mais informações, consulte
TileService.META_DATA_ACTIVE_TILE na Referência da API, disponível para download.
@@ -604,7 +604,7 @@ issue tracker.
problemas podem aumentar com o uso prolongado.
-
A vida útil da bateria pode regredir nesta versão em casos de uso de ligar e
+
A vida útil da bateria pode regredir nesta versão em casos de uso de ligar e
desligar a tela.
@@ -857,7 +857,7 @@ issue tracker.
problemas podem aumentar com o uso prolongado.
-
A vida útil da bateria pode regredir nesta versão em casos de uso de ligar e
+
A vida útil da bateria pode regredir nesta versão em casos de uso de ligar e
desligar a tela.
@@ -885,7 +885,7 @@ issue tracker.
problemas podem aumentar com o uso prolongado.
-
A vida útil da bateria pode regredir nesta versão em casos de uso de ligar e
+
A vida útil da bateria pode regredir nesta versão em casos de uso de ligar e
desligar a tela.
@@ -966,7 +966,7 @@ issue tracker.
Always on VPN
Se o modo Always on VPN estiver ativado, mas uma VPN não estiver disponível, os aplicativos
- não especificados como exceções na política Always on se conectarão via
+ não especificados como exceções na política Always on se conectarão via
rede comum. Exceto quando especificados como exceções na política Always on,
os aplicativos deverão ficar off-line se não houver nenhuma conexão VPN disponível.
@@ -1124,7 +1124,7 @@ issue tracker.
desenvolvedor do aplicativo.
-
Quando o aplicativo é destinado para uma versão da plataforma Android anterior ao N,
+
Quando o aplicativo é destinado para uma versão da plataforma Android anterior ao N,
ele pode não funcionar com avisos de tela dividida que aparecem diversas vezes.
diff --git a/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/index.jd b/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/index.jd
index 59120589f3f6e..ff226429e7ee1 100644
--- a/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/index.jd
+++ b/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/index.jd
@@ -45,7 +45,7 @@ métodos do ciclo de vida em sua atividade conforme ela fica em segundo plano (o
está visível, mas a instância e seu estado permanecem intactos).
Dentro dos métodos de retorno de chamada do ciclo de vida, você pode declarar como a atividade deve se comportar quando o
-usuário sai e retorna da atividade. Por exemplo, se estiver construindo um reprodutor de vídeos de transmissão em sequência,
+usuário sai e retorna da atividade. Por exemplo, se estiver construindo um reprodutor de vídeos de transmissão em sequência,
você pode pausar o vídeo e encerrar a conexão da rede quando o usuário alternar para outro
aplicativo. Quando o usuário retornar, será possível reconectar a rede e permitir que ele reinicie o vídeo
de onde parou.
@@ -55,7 +55,7 @@ android.app.Activity} recebe e como utilizá-los para que a atividade faça o qu
usuário espera e não consuma recursos do sistema quando não estiver em uso.
Aprenda os fundamentos sobre ciclo de vida da atividade, como o usuário pode iniciar seu aplicativo e como
@@ -68,5 +68,5 @@ fazer durante essas mudanças de estados.
Durante o uso normal do aplicativo, a atividade em primeiro plano as vezes é obstruída por outros
+
Durante o uso normal do aplicativo, a atividade em primeiro plano as vezes é obstruída por outros
componentes visuais que causam a pausa. Por exemplo, quando uma atividade
- semitransparente é aberta (como uma no estilo de um diálogo), a atividade anterior pausa. Enquanto a
+ semitransparente é aberta (como uma no estilo de um diálogo), a atividade anterior pausa. Enquanto a
atividade estiver parcialmente visível, mas não for o foco da atividade, ela permanecerá pausada.
-
No entanto, se a atividade estiver completamente obstruída e não visível, ela para (o que será
+
No entanto, se a atividade estiver completamente obstruída e não visível, ela para (o que será
discutido na próxima lição).
Conforme a atividade entra no estado pausado, o sistema chama o método {@link
@@ -59,7 +59,7 @@ aguarda no estado Pausa (1). Se o usuário retornar à atividade enquanto ainda
Pausar sua atividade
-
+
Quando o sistema chama {@link android.app.Activity#onPause()} para sua atividade, teoricamente
significa que a atividade ainda está parcialmente visível, mas geralmente é um indício
de que o usuário está saindo da atividade e logo entrará em estado Interrompido. Use
diff --git a/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/recreating.jd b/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/recreating.jd
index 7cb122f713efe..9746a65ceeb03 100644
--- a/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/recreating.jd
+++ b/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/recreating.jd
@@ -8,13 +8,13 @@ trainingnavtop=true
@@ -105,7 +105,7 @@ public void onSaveInstanceState(Bundle savedInstanceState) {
// Save the user's current game state
savedInstanceState.putInt(STATE_SCORE, mCurrentScore);
savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel);
-
+
// Always call the superclass so it can save the view hierarchy state
super.onSaveInstanceState(savedInstanceState);
}
@@ -138,7 +138,7 @@ onCreate()}:
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); // Always call the superclass first
-
+
// Check whether we're recreating a previously destroyed instance
if (savedInstanceState != null) {
// Restore value of members from saved state
@@ -157,12 +157,12 @@ android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}, que o sis
depois do método {@link android.app.Activity#onStart()}. O sistema chama {@link
android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} se houver um estado
salvo para ser restaurado. Portanto, não é necessário verificar se {@link android.os.Bundle} é null:
-
+
public void onRestoreInstanceState(Bundle savedInstanceState) {
// Always call the superclass so it can restore the view hierarchy
super.onRestoreInstanceState(savedInstanceState);
-
+
// Restore state members from saved instance
mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
diff --git a/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/starting.jd b/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/starting.jd
index efe2badc149fe..4c1a9b846cc7f 100644
--- a/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/starting.jd
+++ b/docs/html-intl/intl/pt-br/training/basics/activity-lifecycle/starting.jd
@@ -9,7 +9,7 @@ trainingnavtop=true
Фрагменты могут добавлять пункты меню в Меню вариантов операции (и, следовательно, в Строку действий), реализовав
{@link android.app.Fragment#onCreateOptionsMenu(Menu,MenuInflater) onCreateOptionsMenu()}. Однако, чтобы этот метод мог
принимать вызовы, необходимо вызывать {@link
android.app.Fragment#setHasOptionsMenu(boolean) setHasOptionsMenu()} во время выполнения метода {@link
@@ -639,7 +639,7 @@ android.app.Fragment#onContextItemSelected(MenuItem) onContextItemSelected()}.
-
Управление жизненным циклом фрагмента во многом аналогично управлению жизненным циклом операции. Как и
+
Управление жизненным циклом фрагмента во многом аналогично управлению жизненным циклом операции. Как и
операция, фрагмент может существовать в одном из трех состояний:
@@ -677,7 +677,7 @@ android.app.Fragment#onActivityCreated onActivityCreated()}. Дополните
android.app.FragmentTransaction#addToBackStack(String) addToBackStack()} во время транзакции,
удаляющей фрагмент.
-
В остальном управление жизненным циклом фрагмента очень похоже на управление жизненным циклом
+
В остальном управление жизненным циклом фрагмента очень похоже на управление жизненным циклом
операции. Поэтому практические рекомендации по управлению жизненным циклом
операций применимы и к фрагментам. При этом разработчику необходимо понимать, как жизненный цикл
операции влияет на жизненный цикл фрагмента.
@@ -722,7 +722,7 @@ android.app.Activity#onCreate onCreate()}, фрагмент внутри это
{@link android.app.Fragment#onActivityCreated onActivityCreated()}.
Когда операция переходит в состояние «возобновлена», можно свободно добавлять в нее фрагменты и удалять
-их. Таким образом, жизненный цикл фрагмента может быть независимо изменен, только пока операция остается
+их. Таким образом, жизненный цикл фрагмента может быть независимо изменен, только пока операция остается
в состоянии «возобновлена».
Однако, когда операция выходит из этого состояния, продвижение фрагмента по его
@@ -785,7 +785,7 @@ android.widget.FrameLayout}), либо запускается новая опе
Второй фрагмент, {@code DetailsFragment}, отображает краткое содержание пьесы, выбранной в
списке {@code TitlesFragment}:
Вспомним код класса {@code TitlesFragment}: если пользователь нажимает на пункт списка, а
@@ -798,7 +798,7 @@ android.widget.FrameLayout}), либо запускается новая опе
{@sample development/samples/ApiDemos/src/com/example/android/apis/app/FragmentLayout.java
details_activity}
-
+
Обратите внимание, что в альбомной конфигурации эта операция самостоятельно завершается, чтобы главная
операция могла принять управление и отобразить фрагмент {@code DetailsFragment} рядом с фрагментом{@code TitlesFragment}.
Это может произойти, если пользователь запустит операцию {@code DetailsActivity} в книжной ориентации экрана, а
diff --git a/docs/html-intl/intl/ru/guide/components/fundamentals.jd b/docs/html-intl/intl/ru/guide/components/fundamentals.jd
index 181cbbdfb1077..07f001a545ad8 100644
--- a/docs/html-intl/intl/ru/guide/components/fundamentals.jd
+++ b/docs/html-intl/intl/ru/guide/components/fundamentals.jd
@@ -165,7 +165,7 @@ android.provider.ContactsContract.Data}), для чтения и записи с
Уникальной особенностью системы Android является то, что любое приложение может запустить компонент
другого приложения. Например, если вы хотите дать пользователю возможность фотографировать, используя
-камеру устройства, то, поскольку наверняка имеется другое приложение, которое может выполнить это действие, вместо того чтобы разработать операцию фотографирования в своем приложении, вы можете вызвать
+камеру устройства, то, поскольку наверняка имеется другое приложение, которое может выполнить это действие, вместо того чтобы разработать операцию фотографирования в своем приложении, вы можете вызвать
такое приложение. Вам не
нужно внедрять код из приложения для камеры или даже устанавливать на него ссылку.
Вместо этого вы можете просто запустить операцию фотографирования
@@ -212,7 +212,7 @@ URI, указывающий на выбранный контакт).
содержит только строку "аккумулятор разряжен").
Компоненты четвертого типа – поставщики контента – сообщениями Intent не активируются. Они
-активируются по запросу от {@link android.content.ContentResolver}. Процедура определения
+активируются по запросу от {@link android.content.ContentResolver}. Процедура определения
контента (content resolver) обрабатывает все прямые транзакции с поставщиком контента, с тем чтобы этого не пришлось делать компоненту, который
выполняет транзакции с поставщиком. Вместо этого он вызывает методы для объекта {@link
android.content.ContentResolver}. Это формирует слой, абстрагирующий (в целях безопасности) поставщика
@@ -224,7 +224,7 @@ android.content.ContentResolver}. Это формирует слой, абстр
передав объект {@link android.content.Intent} методу {@link android.content.Context#startActivity
startActivity()} или {@link android.app.Activity#startActivityForResult startActivityForResult()}
(если требуется, чтобы операция вернула результат).
-
Можно запустить службу (либо выдать работающей службе новые инструкции),
+
Можно запустить службу (либо выдать работающей службе новые инструкции),
передав объект {@link android.content.Intent} методу {@link android.content.Context#startService
startService()}. Либо можно установить привязку к службе, передав объект{@link android.content.Intent} методу
{@link android.content.Context#bindService bindService()}.
@@ -236,7 +236,7 @@ android.content.Context#sendStickyBroadcast sendStickyBroadcast()}.
android.content.ContentProvider#query query()} для объекта {@link android.content.ContentResolver}.
-
Подробные сведения об использовании объектов Intent приведены в документе Объекты Intent и
+
Подробные сведения о структуризации файла манифеста для приложения см. в документе Файл AndroidManifest.xml
@@ -331,7 +331,7 @@ href="{@docRoot}guide/topics/manifest/provider-element.html"><provider>
-
Система определяет компоненты, которые могут ответить на сообщение Intent, путем сравнения
+
Система определяет компоненты, которые могут ответить на сообщение Intent, путем сравнения
полученного сообщения Intent с фильтрами объектов Intent, указанными в файле манифеста других приложений, имеющихся
на устройстве.
@@ -373,13 +373,13 @@ startActivity()}, система сможет запустить вашу опе
Существует огромное количество устройств, работающих под управлением Android, и не все они имеют
одинаковые функциональные возможности. Чтобы ваше приложение не могло быть установлено на устройствах,
в которых отсутствуют функции, необходимые приложению, важно четко определить профиль для
-типов устройств, поддерживаемых вашим приложением, указав требования к аппаратному и программному обеспечению в
+типов устройств, поддерживаемых вашим приложением, указав требования к аппаратному и программному обеспечению в
файле манифеста. Эти объявления по большей части носят информационный характер, система их не
читает. Однако их читают внешние службы, например Google Play, с целью обеспечения
фильтрации для пользователей, которые ищут приложения для своих устройств.
Например, если вашему приложению требуется камера и оно использует API-интерфейсы из Android 2.1 (уровень API 7),
-эти параметры следует объявить в файле манифеста в качестве требований следующим образом:
+эти параметры следует объявить в файле манифеста в качестве требований следующим образом:
<manifest ... >
@@ -390,7 +390,7 @@ startActivity()}, система сможет запустить вашу опе
</manifest>
-
Теперь ваше приложение нельзя будет установить из Google Play на устройствах, в которых нет камеры, а также на устройствах, работающих под управлением
+
Теперь ваше приложение нельзя будет установить из Google Play на устройствах, в которых нет камеры, а также на устройствах, работающих под управлением
Android версии ниже 2.1.
Однако можно также объявить, что приложение использует камеру, но для его работы она не является
@@ -430,7 +430,7 @@ logo.png} (сохраненный в папке {@code res/drawable/}), инст
соответствующем языке.
Android поддерживает разные квалификаторы для соответствующих ресурсов. Квалификатор
- представляет собой короткую строку, которая включается в имена каталогов ресурсов с целью
+ представляет собой короткую строку, которая включается в имена каталогов ресурсов с целью
определения конфигурации устройства, для которой эти ресурсы следует использовать. В качестве другого
примера можно сказать, что для своих операций следует создавать разные макеты, которые будут соответствовать
размеру и ориентации экрана устройства. Например, когда экран устройства имеет книжную
@@ -469,7 +469,7 @@ logo.png} (сохраненный в папке {@code res/drawable/}), инст
Сведения о том, каким образом система Android работает на устройствах разных типов, и общие сведения о том,
- как оптимизировать свое приложение для каждого устройства или ограничить круг устройств, на которых может быть установлено
+ как оптимизировать свое приложение для каждого устройства или ограничить круг устройств, на которых может быть установлено
приложение.
Сведения о том, как система Android ограничивает доступ приложений к определенным API-интерфейсам с помощью системы
diff --git a/docs/html-intl/intl/ru/guide/components/index.jd b/docs/html-intl/intl/ru/guide/components/index.jd
index 41d5a3491bf2e..13050f262b79d 100644
--- a/docs/html-intl/intl/ru/guide/components/index.jd
+++ b/docs/html-intl/intl/ru/guide/components/index.jd
@@ -1,7 +1,7 @@
page.title=Компоненты приложения
page.landing=true
-page.landing.intro=Платформа приложений системы Android позволяет создавать функциональные и инновационные приложения с помощью набора компонентов, которые можно использовать многократно. В этом разделе рассказывается о том, как создавать компоненты, определяющие элементы структуры вашего приложения, и как связывать их воедино с помощью объектов Intent.
-page.metaDescription=Платформа приложений системы Android позволяет создавать функциональные и инновационные приложения с помощью набора компонентов, которые можно использовать многократно. В этом разделе рассказывается о том, как создавать компоненты, определяющие элементы структуры вашего приложения, и как связывать их воедино с помощью объектов Intent.
+page.landing.intro=Платформа приложений системы Android позволяет создавать функциональные и инновационные приложения с помощью набора компонентов, которые можно использовать многократно. В этом разделе рассказывается о том, как создавать компоненты, определяющие элементы структуры вашего приложения, и как связывать их воедино с помощью объектов Intent.
+page.metaDescription=Платформа приложений системы Android позволяет создавать функциональные и инновационные приложения с помощью набора компонентов, которые можно использовать многократно. В этом разделе рассказывается о том, как создавать компоненты, определяющие элементы структуры вашего приложения, и как связывать их воедино с помощью объектов Intent.
page.landing.image=images/develop/app_components.png
page.image=images/develop/app_components.png
@@ -11,7 +11,7 @@ page.image=images/develop/app_components.png
воссоздании после изменения конфигурации. Таким образом, им не требуется повторно запрашивать свои
данные.
-
+
Сводная информация об API-интерфейсе загрузчика
Имеется несколько классов и интерфейсов, которые могут использовать
@@ -68,7 +68,7 @@ android.app.Fragment}.
{@link android.app.Fragment} для управления одним или несколькими интерфейсами {@link
android.content.Loader}. Это позволяет приложению управлять
длительно выполняющимися операциями вместе с жизненным циклом {@link android.app.Activity}
-или {@link android.app.Fragment}; чаще всего этот класс используется с
+или {@link android.app.Fragment}; чаще всего этот класс используется с
{@link android.content.CursorLoader}, однако приложения могут писать
свои собственные загрузчики для работы с другими типами данных.
@@ -129,10 +129,10 @@ android.content.ContentProvider}. Вы также можете реализов
загрузки данных из другого источника;
реализация для {@link android.app.LoaderManager.LoaderCallbacks}.
Именно здесь создаются новые загрузчики и ведется управление ссылками на существующие
-загрузчики;
+загрузчики;
способ отображения данных загрузчика, например {@link
android.widget.SimpleCursorAdapter};
-
источник данных, например {@link android.content.ContentProvider}, когда используется
+
источник данных, например {@link android.content.ContentProvider}, когда используется
{@link android.content.CursorLoader}.
{@link android.app.LoaderManager} управляет одним или несколькими экземплярами {@link
android.content.Loader} в {@link android.app.Activity} или
{@link android.app.Fragment}. Имеется только один {@link
-android.app.LoaderManager} на каждую операцию или каждый фрагмент.
+android.app.LoaderManager} на каждую операцию или каждый фрагмент.
{@link android.content.Loader} обычно
инициализируется в методе {@link
-android.app.Activity#onCreate onCreate()} операции или в методе фрагмента
+android.app.Activity#onCreate onCreate()} операции или в методе фрагмента
{@link android.app.Fragment#onActivityCreated onActivityCreated()}. Делается
это следующим образом:
уникальный идентификатор, обозначающий загрузчик. В данном примере идентификатором является 0;
необязательные аргументы, которые передаются загрузчику при
-построении (в данном примере это null);
+построении (в данном примере это null);
реализация {@link android.app.LoaderManager.LoaderCallbacks}, которая
вызывает класс {@link android.app.LoaderManager} для выдачи событий загрузчика. В данном
примере локальный класс реализует интерфейс {@link
android.app.LoaderManager.LoaderCallbacks}, поэтому он передает ссылку
-самому себе: {@code this}.
+самому себе: {@code this}.
Вызов {@link android.app.LoaderManager#initLoader initLoader()} обеспечивает инициализацию
загрузчика. Возможен один из двух результатов:
@@ -193,7 +193,7 @@ onLoadFinished.
начинает загрузку и заканчивает ее при необходимости, а также поддерживает состояние загрузчика
и связанного с ним контента. А это подразумевает, что вы будете редко взаимодействовать с загрузчиками
напрямую (однако пример использования методов загрузчика для тонкой настройки его
-поведения см. в образце кода LoaderThrottle).
+поведения см. в образце кода LoaderThrottle).
Для вмешательства в процесс загрузки при возникновении определенных событий обычно используются методы {@link
android.app.LoaderManager.LoaderCallbacks}
. Более подробные сведения об этом см. в разделе Использование обратных вызовов LoaderManager.
@@ -343,8 +343,8 @@ public void onLoadFinished(Loader<Cursor> loader, Cursor data) {
Этот метод вызывается, когда состояние созданного ранее загрузчика сбрасывается, в результате чего
его данные теряются. Этот обратный вызов позволяет узнать, когда данные
вот-вот будут высвобождены, с тем чтобы можно было удалить свою ссылку на них.
-
Данная реализация вызывает
-{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}
+
Данная реализация вызывает
+{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}
со значением null:
@@ -366,7 +366,7 @@ public void onLoaderReset(Loader<Cursor> loader) {
android.app.Fragment}, который отображает {@link android.widget.ListView} с
результатами запроса к поставщику такого контента, как контакты. Для управления запросом к поставщику используется класс {@link
android.content.CursorLoader}.
-
+
Чтобы приложение могло обращаться к контактам пользователя, как показано в этом примере, в его
манифесте должно присутствовать разрешение
{@link android.Manifest.permission#READ_CONTACTS READ_CONTACTS}.
Он содержит действие {@link android.app.Activity}, которое не находится на переднем плане, но
-видно пользователю (вызван метод {@link android.app.Activity#onPause onPause()}).
+видно пользователю (вызван метод {@link android.app.Activity#onPause onPause()}).
Например, это может происходить, если действие на переднем плане запустило диалоговое окно, которое позволяет видеть
предыдущее действие позади него.
@@ -142,7 +142,7 @@ android.content.Context#startService startService()}, и не попадает
Фоновый процесс
-
Процесс, содержащий действия, которые не видны пользователю в настоящее время (вызван метод
+
Процесс, содержащий действия, которые не видны пользователю в настоящее время (вызван метод
{@link android.app.Activity#onStop onStop()} действия). Эти процессы не оказывают непосредственного
воздействия на работу пользователя, и система может удалить их в любой момент, чтобы освободить память для
процессов переднего плана,
@@ -168,7 +168,7 @@ LRU (недавно использованные), чтобы процессы,
компонентов, активных в процессе в текущее время. Например, если процесс содержит служебное и видимое действие,
процесс считается видимым, а не служебным процессом.
-
Кроме того, уровень процесса может быть повышен, поскольку имеются другие процессы, зависимые от него.
+
Кроме того, уровень процесса может быть повышен, поскольку имеются другие процессы, зависимые от него.
Например, процесс, обслуживающий другой процесс, не может иметь уровень ниже уровня обслуживаемого
процесса. Например, если поставщик контента в процессе A обслуживает клиента в процессе B или
служебный процесс A связан с компонентом в процессе B, процесс A всегда считается не менее
@@ -319,7 +319,7 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
protected Bitmap doInBackground(String... urls) {
return loadImageFromNetwork(urls[0]);
}
-
+
/** The system calls this to perform work in the UI thread and delivers
* the result from doInBackground() */
protected void onPostExecute(Bitmap result) {
diff --git a/docs/html-intl/intl/ru/guide/components/services.jd b/docs/html-intl/intl/ru/guide/components/services.jd
index 62a6a7ef9d15a..28e9daa4edb30 100644
--- a/docs/html-intl/intl/ru/guide/components/services.jd
+++ b/docs/html-intl/intl/ru/guide/components/services.jd
@@ -291,7 +291,7 @@ android.app.Service#onStartCommand onStartCommand()}, отдельно от ос
Создает рабочую очередь, которая передает намерения по одному в вашу реализацию метода {@link
android.app.IntentService#onHandleIntent onHandleIntent()}, поэтому вы не должны беспокоиться
относительно многопоточности.
-
Останавливает службу после обработки всех запросов запуска, поэтому вам никогда не требуется вызывать
+
Останавливает службу после обработки всех запросов запуска, поэтому вам никогда не требуется вызывать
{@link android.app.Service#stopSelf}.
Предоставляет реализацию метода {@link android.app.IntentService#onBind onBind()} по умолчанию, которая
возвращает null.
@@ -668,7 +668,7 @@ android.app.Service#stopForeground stopForeground()}. Этот метод сод
уделить пристальное внимание тому, как ваша служба создается и уничтожается, так как служба
может работать в фоновом режиме без ведома пользователя.
-
Жизненный цикл службы от создания до уничтожения может следовать двум
+
Жизненный цикл службы от создания до уничтожения может следовать двум
разным путям:
@@ -43,7 +43,7 @@ parent.link=activities.html
Когда пользователь выбирает сообщение, открывается новая операция для просмотра этого сообщения.
Операция может даже запускать операции, существующие в других приложениях на устройстве. Например,
-если ваше приложение хочет отправить сообщение электронной почты, вы можете определить намерение для выполнения
+если ваше приложение хочет отправить сообщение электронной почты, вы можете определить намерение для выполнения
действия «отправить» и включить в него некоторые данные, например, адрес электронной почты и текст сообщения. После этого открывается операция из другого
приложения, которая объявила, что она обрабатывает намерения такого типа. В этом случае намерение состоит в том, чтобы
отправить сообщение электронной почты, поэтому в приложении электронной почты запускается операция «составить сообщение» (если одно намерение
@@ -127,7 +127,7 @@ class="img-caption">Рисунок 3. Создается нес
в своем стеке — две операции под текущей операцией. Пользователь нажимает кнопку Домой,
затем запускает
новое приложение из средства запуска приложений. Когда появляется главный экран, Задача A переходит
-в фоновый режим. Когда запускается новое приложение, система запускает задачу для этого приложения
+в фоновый режим. Когда запускается новое приложение, система запускает задачу для этого приложения
(Задачу B) со своим собственным стеком операций. После взаимодействия с этим
приложением пользователь снова возвращается на главный экран и выбирает изначально запущенную
Задачу A. Теперь Задача A переходит на передний
@@ -290,7 +290,7 @@ class="img-caption">Рисунок 3. Создается нес
При объявлении операции в вашем файле манифеста вы можете указать, как операция должна
быть связана с задачей посредством атрибута {@code
-launchMode}
+launchMode}
элемента {@code <activity>}.
И при запуске операции в новой задаче, и при запуске операции в существующей задаче,
+
И при запуске операции в новой задаче, и при запуске операции в существующей задаче,
кнопка Назад всегда возвращает пользователя к предыдущей операции. Однако, если вы
запускаете операцию, которая указывает режим запуска {@code singleTask}, вся задача переводится на передний план, если экземпляр
этой операции существует в фоновой задаче. В этот момент
@@ -505,7 +505,7 @@ href="{@docRoot}guide/topics/manifest/activity-element.html#always">alwaysRetain
href="{@docRoot}guide/topics/manifest/activity-element.html#clear">clearTaskOnLaunch
Если для этого атрибута установлено значение {@code "true"} в корневой операции задачи,
стек очищается до корневой операции каждый раз, когда пользователь выходит из задачи
-и возвращается в нее. Другими словами, этот атрибут противоположен атрибуту
+и возвращается в нее. Другими словами, этот атрибут противоположен атрибуту
{@code alwaysRetainTaskState}. Пользователь всегда возвращается в задачу в ее
исходном состоянии, даже после кратковременного выхода из нее.
Вы можете сделать операцию точкой входа, назначая ей фильтр намерений со значением
+
Вы можете сделать операцию точкой входа, назначая ей фильтр намерений со значением
{@code "android.intent.action.MAIN"} в качестве указанного действия и
{@code "android.intent.category.LAUNCHER"}
в качестве указанной категории. Например:
diff --git a/docs/html-intl/intl/ru/guide/index.jd b/docs/html-intl/intl/ru/guide/index.jd
index b0732722e1b85..703700b064753 100644
--- a/docs/html-intl/intl/ru/guide/index.jd
+++ b/docs/html-intl/intl/ru/guide/index.jd
@@ -4,7 +4,7 @@ page.title=Общие сведения о платформе Android
-
Чтобы узнать, как работают приложения, начните с раздела
+
Он задает имя пакета Java для приложения.
Это имя пакета служит уникальным идентификатором приложения.
-
Он описывает компоненты приложения — операции,
+
Он описывает компоненты приложения — операции,
службы, приемники широковещательных сообщений и поставщиков контента, из которых состоит
-приложение. Он содержит имена классов, которые реализуют каждый компонент, и
-публикует их возможности (указывает, например, какие сообщения {@link android.content.Intent
-Intent} они могут принимать). На основании этих деклараций система Android
+приложение. Он содержит имена классов, которые реализуют каждый компонент, и
+публикует их возможности (указывает, например, какие сообщения {@link android.content.Intent
+Intent} они могут принимать). На основании этих деклараций система Android
может определить, из каких компонентов состоит приложение и при каких условиях их можно запускать.
-
Он определяет, в каких процессах будут размещаться компоненты приложения.
+
Он определяет, в каких процессах будут размещаться компоненты приложения.
-
Он объявляет, какие разрешения должны быть выданы приложению, чтобы оно могло получить
-доступ к защищенным частям API-интерфейса и взаимодействовать с другими приложениями.
+
Он объявляет, какие разрешения должны быть выданы приложению, чтобы оно могло получить
+доступ к защищенным частям API-интерфейса и взаимодействовать с другими приложениями.
-
Он также объявляет разрешения, требуемые для
+
Он также объявляет разрешения, требуемые для
взаимодействия с компонентами данного приложения.
-
Он содержит список классов {@link android.app.Instrumentation}, которые при выполнении приложения предоставляют
-сведения о профиле и прочую информацию. Эти объявления
-присутствуют в файле манифеста только во время разработки и отладки
+
Он содержит список классов {@link android.app.Instrumentation}, которые при выполнении приложения предоставляют
+сведения о профиле и прочую информацию. Эти объявления
+присутствуют в файле манифеста только во время разработки и отладки
приложения и удаляются перед его публикацией.
-
Он объявляет минимальный уровень API-интерфейса Android, который требуется
+
Он объявляет минимальный уровень API-интерфейса Android, который требуется
приложению.
Он содержит список библиотек, с которыми должно быть связано приложение.
@@ -61,12 +61,12 @@ Intent} они могут принимать). На основании этих
Структура файла манифеста
-Приведенная далее схема позволяет ознакомиться с общей структурой файла манифеста и
-всеми элементами, которые могут в нем содержаться. Каждый элемент вместе со всеми своими
-атрибутами, полностью описывается в отдельном файле. Для просмотра подробных
-сведений о любом элементе, щелкните имя элемента на схеме,
-в алфавитном списке элементов, приведенном после схемы, или
-в любом другом месте, где этот элемент упоминается.
+Приведенная далее схема позволяет ознакомиться с общей структурой файла манифеста и
+всеми элементами, которые могут в нем содержаться. Каждый элемент вместе со всеми своими
+атрибутами, полностью описывается в отдельном файле. Для просмотра подробных
+сведений о любом элементе, щелкните имя элемента на схеме,
+в алфавитном списке элементов, приведенном после схемы, или
+в любом другом месте, где этот элемент упоминается.
@@ -126,9 +126,9 @@ Intent} они могут принимать). На основании этих
-Далее приведен список всех элементов, расположенных в алфавитном порядке, которые могут
+Далее приведен список всех элементов, расположенных в алфавитном порядке, которые могут
присутствовать в файле манифеста. Там могут находиться только эти элементы, а никакие другие
-элементы или атрибуты добавлять нельзя.
+элементы или атрибуты добавлять нельзя.
@@ -158,74 +158,74 @@ Intent} они могут принимать). На основании этих
-
+
Соглашения о компонентах файла
-Ко всем элементам и атрибутам
+Ко всем элементам и атрибутам
из файла манифеста применяется рад соглашений и правил:
Элементы
-
Обязательными
+
Обязательными
являются только элементы<manifest> и
-<application>
-. Оба они должны присутствовать в файле манифеста, при этом указать их можно только один раз.
-Большинство других элементов можно указывать по нескольку раз или не указывать вовсе — хотя по
-крайней мере некоторые из них нужны, чтобы файл манифеста был сколько-нибудь
+<application>
+. Оба они должны присутствовать в файле манифеста, при этом указать их можно только один раз.
+Большинство других элементов можно указывать по нескольку раз или не указывать вовсе — хотя по
+крайней мере некоторые из них нужны, чтобы файл манифеста был сколько-нибудь
информативным.
-Если в элементе и есть какое-то содержимое, то это другие элементы.
+Если в элементе и есть какое-то содержимое, то это другие элементы.
Все значения задаются с помощью атрибутов, а не как символьные данные в элементе.
Элементы, находящиеся на одном уровне, обычно не упорядочиваются. Например,
- элементы <activity>,
-<provider> и
-<service>
-можно указать в любой последовательности. (Элемент
+ элементы <activity>,
+<provider> и
+<service>
+можно указать в любой последовательности. (Элемент
<activity-alias>
-является исключением из этого правила. Он должен следовать за элементом
-<activity>,
+является исключением из этого правила. Он должен следовать за элементом
+<activity>,
псевдонимом которого он является.)
Атрибуты
-
Формально все атрибуты являются необязательными. Однако некоторые их них
+
Формально все атрибуты являются необязательными. Однако некоторые их них
указывать необходимо, чтобы файл мог выполнять свое предназначение. В качестве руководства используйте эту
-документацию. В отношении атрибутов, которые являются и вправду необязательными, в ней указывается значение,
+документацию. В отношении атрибутов, которые являются и вправду необязательными, в ней указывается значение,
используемое по умолчанию, или говорится, что произойдет, если такой атрибут не будет указан.
-
За исключением некоторых атрибутов корневого элемента
-<manifest>
-, имена всех атрибутов должны начинаться с префикса {@code android:} —
-например, {@code android:alwaysRetainTaskState}. Поскольку этот префикс является
-универсальным, в документации при указании атрибутов по имени
+
За исключением некоторых атрибутов корневого элемента
+<manifest>
+, имена всех атрибутов должны начинаться с префикса {@code android:} —
+например, {@code android:alwaysRetainTaskState}. Поскольку этот префикс является
+универсальным, в документации при указании атрибутов по имени
он обычно опускается.
Объявление имен классов
-
Многие элементы соответствуют объектам Java, в том числе элементы для самого
-приложения (элемент
+
Многие элементы соответствуют объектам Java, в том числе элементы для самого
+приложения (элемент
<application>
-) и основных его компонентов — операций
-(<activity>),
-служб
-(<service>),
-приемников широковещательных сообщений
-(<receiver>)
-и поставщиков контента
-(<provider>).
+) и основных его компонентов — операций
+(<activity>),
+служб
+(<service>),
+приемников широковещательных сообщений
+(<receiver>)
+и поставщиков контента
+(<provider>).
-Если вы определяете подкласс, а это практически всегда делается для классов компонентов
-({@link android.app.Activity}, {@link android.app.Service},
-{@link android.content.BroadcastReceiver} и {@link android.content.ContentProvider}),
-выполняется это с помощью атрибута {@code name}. В состав имени должно входить
-полное обозначение пакета.
+Если вы определяете подкласс, а это практически всегда делается для классов компонентов
+({@link android.app.Activity}, {@link android.app.Service},
+{@link android.content.BroadcastReceiver} и {@link android.content.ContentProvider}),
+выполняется это с помощью атрибута {@code name}. В состав имени должно входить
+полное обозначение пакета.
Например, подкласс {@link android.app.Service} можно объявить следующим образом:
@@ -239,12 +239,12 @@ Intent} они могут принимать). На основании этих
</manifest>
-Однако его можно укоротить. Если первым символом в строке указать точку, эта
-строка будет добавляться к имени пакета приложения (указанного атрибутом
-package
-элемента
-package
-). Следующее назначение является таким же, как приведенное выше:
+Однако его можно укоротить. Если первым символом в строке указать точку, эта
+строка будет добавляться к имени пакета приложения (указанного атрибутом
+package
+элемента
+package
+). Следующее назначение является таким же, как приведенное выше:
<manifest package="com.example.project" . . . >
@@ -257,13 +257,13 @@ Intent} они могут принимать). На основании этих
</manifest>
-При запуске компонента Android создает экземпляр подкласса, указанного по имени.
+При запуске компонента Android создает экземпляр подкласса, указанного по имени.
Если подкласс не указан, система создает экземпляр базового класса.
Несколько значений
-
Если можно указать несколько значений, элемент почти всегда
-приводится повторно. Делается это вместо перечисления нескольких значений в одном элементе.
+
Если можно указать несколько значений, элемент почти всегда
+приводится повторно. Делается это вместо перечисления нескольких значений в одном элементе.
Например, в фильтре Intent может быть перечислено несколько действий:
<intent-filter . . . >
@@ -274,24 +274,24 @@ Intent} они могут принимать). На основании этих
</intent-filter>
Значения ресурсов
-
Значения некоторых атрибутов могут отображаться на экране — например,
-метка и значок операции. Значения этих атрибутов
-следует локализовать, поэтому они должны задаваться в ресурсе или теме. Значения
+
Значения некоторых атрибутов могут отображаться на экране — например,
+метка и значок операции. Значения этих атрибутов
+следует локализовать, поэтому они должны задаваться в ресурсе или теме. Значения
ресурсов выражаются в следующем формате:
{@code @[пакет:]тип:имя}
-где имя пакета можно опустить, если ресурс находится в одном пакете
-с приложением, тип — это тип ресурса, — например "string" или
-"drawable", — а имя — это имя, определяющее ресурс.
+где имя пакета можно опустить, если ресурс находится в одном пакете
+с приложением, тип — это тип ресурса, — например "string" или
+"drawable", — а имя — это имя, определяющее ресурс.
Например:
-Значения из темы выражаются схожим образом, только в начале у них идет "{@code ?}",
+Значения из темы выражаются схожим образом, только в начале у них идет "{@code ?}",
а не "{@code @}":
@@ -299,8 +299,8 @@ Intent} они могут принимать). На основании этих
Строковые значения
-
Когда значением атрибута является строка, следует использовать двойную обратную косую черту ("{@code \\}")
-для выделения управляющей последовательности символов, — например "{@code \\n}" для
+
Когда значением атрибута является строка, следует использовать двойную обратную косую черту ("{@code \\}")
+для выделения управляющей последовательности символов, — например "{@code \\n}" для
новой строки или "{@code \\uxxxx}" для символа Юникода.
@@ -308,7 +308,7 @@ Intent} они могут принимать). На основании этих
Отображение функций в файле
-В следующих разделах описано, как некоторые функции Android отображаются
+В следующих разделах описано, как некоторые функции Android отображаются
в файле манифеста.
@@ -316,37 +316,37 @@ Intent} они могут принимать). На основании этих
Фильтры объектов Intent
-Базовые компоненты приложения (его операции, службы и
-приемники широковещательных сообщений) активируются объектами Intent. Intent —
-это совокупность информации (объект {@link android.content.Intent}), описывающей
-требуемое действие, — в том числе в ней указаны данные, с которыми следует выполнить это действие, категория
-компонентов, которые должны выполнять это действие, и другие уместные инструкции.
-Система Android находит компонент, который отреагирует на объект Intent, запускает
-новый экземпляр компонента, если он требуется, и передает ему
+Базовые компоненты приложения (его операции, службы и
+приемники широковещательных сообщений) активируются объектами Intent. Intent —
+это совокупность информации (объект {@link android.content.Intent}), описывающей
+требуемое действие, — в том числе в ней указаны данные, с которыми следует выполнить это действие, категория
+компонентов, которые должны выполнять это действие, и другие уместные инструкции.
+Система Android находит компонент, который отреагирует на объект Intent, запускает
+новый экземпляр компонента, если он требуется, и передает ему
объект Intent.
-Компоненты объявляют свои возможности — виды объектов Intent, на которые они могут
-реагировать, — с помощью фильтров Intent. Поскольку система Android
-должна узнать, какие объекты Intent может обрабатывать тот или иной компонент, до того как она его запустит,
-фильтры Intent указываются в файле манифеста как
-элементы <intent-filter>
-. Компонент может иметь любое количество фильтров, каждый из которых описывает
+Компоненты объявляют свои возможности — виды объектов Intent, на которые они могут
+реагировать, — с помощью фильтров Intent. Поскольку система Android
+должна узнать, какие объекты Intent может обрабатывать тот или иной компонент, до того как она его запустит,
+фильтры Intent указываются в файле манифеста как
+элементы <intent-filter>
+. Компонент может иметь любое количество фильтров, каждый из которых описывает
отдельную возможность компонента.
-Объект Intent, в котором целевой компонент явно указан по имени, активирует этот компонент,
-и фильтр при этом не учитывается. Но объект Intent, в котором имя целевого
-компонента не указано, может активировать компонент, только если он может пройти через один из фильтров
+Объект Intent, в котором целевой компонент явно указан по имени, активирует этот компонент,
+и фильтр при этом не учитывается. Но объект Intent, в котором имя целевого
+компонента не указано, может активировать компонент, только если он может пройти через один из фильтров
компонента.
@@ -354,42 +354,42 @@ Intent} они могут принимать). На основании этих
Значки и метки
-У ряда элементов есть атрибуты {@code icon} и {@code label} для
-небольшого значка и текстовой метки, которые могут отображаться на экране. У некоторых из них также есть атрибут
-{@code description} для более длинного описательного текста, который также может
-отображаться на экране. Например, элемент
+У ряда элементов есть атрибуты {@code icon} и {@code label} для
+небольшого значка и текстовой метки, которые могут отображаться на экране. У некоторых из них также есть атрибут
+{@code description} для более длинного описательного текста, который также может
+отображаться на экране. Например, элемент
<permission>
-имеет все три таких атрибута, поэтому, когда пользователю задается вопрос, предоставить ли
-разрешение запросившему его приложению, на экране может отображаться значок,
-представляющий разрешение, имя разрешения и описание того, что оно
+имеет все три таких атрибута, поэтому, когда пользователю задается вопрос, предоставить ли
+разрешение запросившему его приложению, на экране может отображаться значок,
+представляющий разрешение, имя разрешения и описание того, что оно
за собой влечет.
-В любом случае значок и метка, заданные в элементе-контейнере, становятся параметрами
-{@code icon} и {@code label}, используемыми по умолчанию для всех вложенных в этот контейнер дочерних элементов.
-Так, значок и метка, заданные в элементе
-<application>,
-являются значком и меткой, используемыми по умолчанию для каждого компонента приложения.
-Точно так же, значок и метка, заданные для компонента, — например элемента
-<activity>, —
-являются параметрами, используемыми по умолчанию для каждого элемента
-<intent-filter>
- компонента. Если в элементе
-<application>
-задана метка, а в операции и ее фильтре Intent — нет,
-метка приложения будет считаться меткой и для операции, и для
+В любом случае значок и метка, заданные в элементе-контейнере, становятся параметрами
+{@code icon} и {@code label}, используемыми по умолчанию для всех вложенных в этот контейнер дочерних элементов.
+Так, значок и метка, заданные в элементе
+<application>,
+являются значком и меткой, используемыми по умолчанию для каждого компонента приложения.
+Точно так же, значок и метка, заданные для компонента, — например элемента
+<activity>, —
+являются параметрами, используемыми по умолчанию для каждого элемента
+<intent-filter>
+ компонента. Если в элементе
+<application>
+задана метка, а в операции и ее фильтре Intent — нет,
+метка приложения будет считаться меткой и для операции, и для
фильтра Intent.
-Значок и метка, заданные для фильтра Intent, используются для обозначения компонента,
+Значок и метка, заданные для фильтра Intent, используются для обозначения компонента,
когда он представляется пользователю, для указания функции,
-которую анонсирует фильтр. Например, фильтр с параметрами
-"{@code android.intent.action.MAIN}" и
-"{@code android.intent.category.LAUNCHER}" сообщает, что эта операция
+которую анонсирует фильтр. Например, фильтр с параметрами
+"{@code android.intent.action.MAIN}" и
+"{@code android.intent.category.LAUNCHER}" сообщает, что эта операция
инициирует приложение, — то есть он обозначает ее как
- операцию, которая должна быть отображена в средстве запуска приложений. Отсюда следует, что значок и метка,
+ операцию, которая должна быть отображена в средстве запуска приложений. Отсюда следует, что значок и метка,
заданные в фильтре, отображаются в средстве запуска.
@@ -397,14 +397,14 @@ Intent} они могут принимать). На основании этих
Разрешения
-Разрешение представляет собой ограничение на доступ к части кода
-или к данным, имеющимся на устройстве. Это ограничение накладывается для защиты важных
-данных и кода, ненадлежащее использование которых может пагубно сказаться на работе приложения.
+Разрешение представляет собой ограничение на доступ к части кода
+или к данным, имеющимся на устройстве. Это ограничение накладывается для защиты важных
+данных и кода, ненадлежащее использование которых может пагубно сказаться на работе приложения.
-Каждое разрешение обозначается уникальной меткой. Зачастую метка обозначает
-действие, выполнение которого ограничивается. Например, вот некоторые разрешения, определенные
+Каждое разрешение обозначается уникальной меткой. Зачастую метка обозначает
+действие, выполнение которого ограничивается. Например, вот некоторые разрешения, определенные
системой Android:
@@ -418,25 +418,25 @@ Intent} они могут принимать). На основании этих
-Если приложению требуется доступ к функции, защищенной разрешением,
-оно должно объявить, что ему необходимо это разрешение, с помощью элемента
-<uses-permission>
-в файле манифеста. Затем, когда приложение устанавливается на
-устройство, установщик определяет, выдать ли запрошенное
-разрешение, проверяя полномочия органов, подписавших сертификаты
-приложения, а также, в некоторых случаях, спрашивая об этом пользователя.
-Если разрешение предоставляется, приложение сможет использовать защищенные
+Если приложению требуется доступ к функции, защищенной разрешением,
+оно должно объявить, что ему необходимо это разрешение, с помощью элемента
+<uses-permission>
+в файле манифеста. Затем, когда приложение устанавливается на
+устройство, установщик определяет, выдать ли запрошенное
+разрешение, проверяя полномочия органов, подписавших сертификаты
+приложения, а также, в некоторых случаях, спрашивая об этом пользователя.
+Если разрешение предоставляется, приложение сможет использовать защищенные
функции. В противном случае его попытки доступа к этим функциям будут безуспешными,
-причем пользователь не получит никакого уведомления об этом.
+причем пользователь не получит никакого уведомления об этом.
-Приложение также может защищать с помощью разрешений собственные компоненты (операции, службы,
-приемники широковещательных сообщений и поставщиков контента). Оно может использовать
-любые разрешения, определенные системой Android (они приведены в объекте
-{@link android.Manifest.permission android.Manifest.permission}) или объявленные
-другими приложениями. Либо оно может определить разрешения самостоятельно. Новое разрешение объявляется
-с помощью элемента
+Приложение также может защищать с помощью разрешений собственные компоненты (операции, службы,
+приемники широковещательных сообщений и поставщиков контента). Оно может использовать
+любые разрешения, определенные системой Android (они приведены в объекте
+{@link android.Manifest.permission android.Manifest.permission}) или объявленные
+другими приложениями. Либо оно может определить разрешения самостоятельно. Новое разрешение объявляется
+с помощью элемента
<permission>
. Например, операцию можно защитить следующим образом:
@@ -457,43 +457,43 @@ Intent} они могут принимать). На основании этих
-Обратите внимание, что в этом примере разрешение {@code DEBIT_ACCT} не только
-объявляется с помощью элемента
+Обратите внимание, что в этом примере разрешение {@code DEBIT_ACCT} не только
+объявляется с помощью элемента
<permission>
-, его использование также запрашивается с помощью элемента
+, его использование также запрашивается с помощью элемента
<uses-permission>
. Чтобы другие компоненты приложения запускали защищенную
-операцию, ее использование должно быть запрошено, даже несмотря на то, что защита
-наложена самим приложением.
+операцию, ее использование должно быть запрошено, даже несмотря на то, что защита
+наложена самим приложением.
-В этом же примере: если атрибут {@code permission} был бы задан как
-разрешение, объявленное где-то еще
-(например, {@code android.permission.CALL_EMERGENCY_NUMBERS}), его бы не
-нужно было объявлять еще раз с помощью элемента
+В этом же примере: если атрибут {@code permission} был бы задан как
+разрешение, объявленное где-то еще
+(например, {@code android.permission.CALL_EMERGENCY_NUMBERS}), его бы не
+нужно было объявлять еще раз с помощью элемента
<permission>
-. Однако все равно нужно было бы запрашивать его использование с помощью
-<uses-permission>.
+. Однако все равно нужно было бы запрашивать его использование с помощью
+<uses-permission>.
-Элемент
-<permission-tree>
-объявляет пространство имен для группы разрешений, которые будут определены в
-коде. А элемент
+Элемент
+<permission-tree>
+объявляет пространство имен для группы разрешений, которые будут определены в
+коде. А элемент
<permission-group>
-определяет метку для набора разрешений (как для разрешений, объявленных в файле манифеста с помощью элементов
+определяет метку для набора разрешений (как для разрешений, объявленных в файле манифеста с помощью элементов
<permission>
-, так и для объявленных где-то еще). Это влияет только на то, каким образом разрешения
-группируются, когда отображаются пользователю. Элемент
+, так и для объявленных где-то еще). Это влияет только на то, каким образом разрешения
+группируются, когда отображаются пользователю. Элемент
<permission-group>
-не указывает, какие разрешения относятся к группе.
+не указывает, какие разрешения относятся к группе.
Он просто дает группе имя. Чтобы включить разрешение в группу,
-атрибуту
-permissionGroup
- его элемента
-<permission>
+атрибуту
+permissionGroup
+ его элемента
+<permission>
необходимо присвоить имя группы.
@@ -501,17 +501,17 @@ Intent} они могут принимать). На основании этих
Библиотеки
-Каждое приложение связывается с используемой по умолчанию библиотекой Android, в которой
-имеются базовые пакеты для построения приложений (со стандартными классами,
-например Activity, Service, Intent, View, Button, Application, ContentProvider
+Каждое приложение связывается с используемой по умолчанию библиотекой Android, в которой
+имеются базовые пакеты для построения приложений (со стандартными классами,
+например Activity, Service, Intent, View, Button, Application, ContentProvider
и так далее).
-Однако некоторые пакеты находятся в собственных библиотеках. Если ваше приложение
-использует код из одного из таких пакетов, оно должно в явном виде потребовать, чтобы его связали
-с этим пакетом. Файл манифеста должен содержать отдельный элемент
-<uses-library>
-для указания имени каждой библиотеки. (Имя библиотеки можно найти в
+Однако некоторые пакеты находятся в собственных библиотеках. Если ваше приложение
+использует код из одного из таких пакетов, оно должно в явном виде потребовать, чтобы его связали
+с этим пакетом. Файл манифеста должен содержать отдельный элемент
+<uses-library>
+для указания имени каждой библиотеки. (Имя библиотеки можно найти в
документации по пакету.)
В этой таблице находится
информация о календарях. В каждой строке этой таблицы представлены сведения
об отдельном календаре, например, его название, цвет, информация о синхронизации и т. д.
{@link android.provider.CalendarContract.Events}
-
+
В этой таблице находится
информация о событиях. В каждой строке этой таблицы содержится информация об отдельном
событии —например, заголовок события, место проведения, время начала, время
завершения и т. д. Событие может быть однократным или повторяющимся. Сведения об участниках,
-напоминаниях и расширенные свойства хранятся в отдельных таблицах.
+напоминаниях и расширенные свойства хранятся в отдельных таблицах.
В каждой из них имеется целочисленная переменная {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID},
которая ссылается на объект {@link android.provider.BaseColumns#_ID} в таблице событий.
В этой таблице содержатся данные о времени
начала и окончания каждого повторения события. В каждой строке этой таблицы
представлено одно повторение события. Однократные события сопоставляются с повторениями
@@ -141,7 +141,7 @@ URI имеют формат <class>.CONTENT_URI. Н
В этой таблице находится
информация об участниках (гостях). В каждой строке этой таблицы указан один
гость. В ней указываются тип гостя и информация о том,
@@ -149,7 +149,7 @@ URI имеют формат <class>.CONTENT_URI. Н
В этой таблице находятся
данные уведомлений или оповещений. В каждой строке этой таблицы указано одно уведомление или оповещение. Для одного
события можно создать несколько напоминаний. Максимальное количество таких напоминаний для события
@@ -159,7 +159,7 @@ URI имеют формат <class>.CONTENT_URI. Н
указанным календарем. Напоминания задаются в минутах до начала события и
имеют метод, который определяет порядок уведомления пользователя.
-
+
API поставщика календаря обеспечивает достаточную гибкость и эффективность. В то же время
@@ -211,7 +211,7 @@ android.Manifest.permission#READ_CALENDAR}. Также в него
В таблице {@link android.provider.CalendarContract.Calendars} содержатся подробные сведения
о каждом отдельном календаре. Выполнять запись в указанные ниже столбцы
-этой таблицы могут и приложение, и адаптер синхронизации.
+этой таблицы могут и приложение, и адаптер синхронизации.
Полный список поддерживаемых полей представлен в справке по классу
{@link android.provider.CalendarContract.Calendars}.
@@ -229,7 +229,7 @@ android.Manifest.permission#READ_CALENDAR}. Также в него
Логическое значение, обозначающее, выбран ли календарь для отображения. Значение
«0» указывает на то, что события, связанные с
этим календарем, не отображаются. Значение «1» указывает на то, что события, связанные с
@@ -240,7 +240,7 @@ android.provider.CalendarContract.Instances}.
Логическое значение, обозначающее, следует ли синхронизировать календарь и хранить имеющиеся в нем события
на устройстве. Значение «0» указывает, что не следует синхронизировать этот календарь или
хранить имеющиеся в нем события на устройстве. Значение «1» указывает, что этот календарь следует синхронизировать и
@@ -268,13 +268,13 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
Зачем необходимо указывать параметр
ACCOUNT_TYPE?
При создании запроса {@link
@@ -289,7 +289,7 @@ Calendars.ACCOUNT_NAME} необходимо также
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}. Он используется для календарей,
которые не связаны с аккаунтом устройства. Аккаунты {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} не
-синхронизируются.
+синхронизируются.
В следующей части примера создается запрос. С помощью выбора определяются
@@ -308,38 +308,38 @@ android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} не
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
В следующем разделе кода выполняется пошаговый обзор набора результатов с помощью курсора. В нем
используются константы, которые были заданы в начале примера, для получения значений
для каждого из полей.
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
-
+
Изменение календаря
Чтобы обновить календарь, можно указать {@link
@@ -350,7 +350,7 @@ android.provider.BaseColumns#_ID} календаря: либо в виде ид
либо в качестве первого элемента выделения. Выделение
должно начинаться с "_id=?", а первым аргументом
selectionArg должен быть {@link
-android.provider.BaseColumns#_ID} календаря.
+android.provider.BaseColumns#_ID} календаря.
Также для выполнения обновлений можно закодировать идентификатор в URI. В этом примере для
изменения отображаемого имени календаря используется
подход
@@ -387,7 +387,7 @@ android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}.
в файл манифеста
приложения необходимо включить разрешение {@link android.Manifest.permission#WRITE_CALENDAR}.
-
Выполнять запись в указанные ниже столбцы этой таблицы могут и приложение, и
+
Выполнять запись в указанные ниже столбцы этой таблицы могут и приложение, и
адаптер синхронизации. Полный список поддерживаемых полей представлен в справке по классу {@link
android.provider.CalendarContract.Events}.
Продолжительность события в формате RFC5545.
Например, значение "PT1H" обозначает, что событие
должно длиться один час, а значение "P2W" указывает на продолжительность
@@ -444,39 +444,39 @@ android.provider.CalendarContract.Events}.
Значение «1» обозначает, что это событие занимает весь день по
местному часовому поясу. Значение «0» указывает на то, что это регулярное событие, которое может начаться
и завершиться в любое время в течение дня.
Даты повторения события.
Обычно {@link android.provider.CalendarContract.EventsColumns#RDATE}
используется вместе с {@link android.provider.CalendarContract.EventsColumns#RRULE}
для определения агрегированного набора
повторяющихся событий. Дополнительные сведения представлены в спецификации RFC5545.
@@ -514,11 +514,11 @@ java.util.TimeZone#getAvailableIDs()}. Обратите внимание, что
вставке события с помощью намерения {@link
android.content.Intent#ACTION_INSERT INSERT}, как описано в разделе Использование намерения для вставки события, — в этом
случае используется часовой пояс по умолчанию.
-
+
Для однократных событий необходимо указать {@link
android.provider.CalendarContract.EventsColumns#DTEND}.
-
-
+
+
Для повторяющихся событий необходимо указать {@link
android.provider.CalendarContract.EventsColumns#DURATION} в дополнение к {@link
android.provider.CalendarContract.EventsColumns#RRULE} или {@link
@@ -528,7 +528,7 @@ android.content.Intent#ACTION_INSERT INSERT}, как описано в разд
случае можно использовать {@link
android.provider.CalendarContract.EventsColumns#RRULE} в сочетании с {@link android.provider.CalendarContract.EventsColumns#DTSTART} и {@link android.provider.CalendarContract.EventsColumns#DTEND}; кроме того, приложение «Календарь»
автоматически преобразует указанный период в продолжительность.
-
+
Ниже представлен пример вставки события. Для простоты все это выполняется в потоке
@@ -539,8 +539,8 @@ android.provider.CalendarContract.EventsColumns#RRULE} в сочетании с
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -561,7 +561,7 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
@@ -598,7 +598,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -625,7 +625,7 @@ ContentValues values = new ContentValues();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().delete(deleteUri, null, null);
-Log.i(DEBUG_TAG, "Rows deleted: " + rows);
+Log.i(DEBUG_TAG, "Rows deleted: " + rows);
Таблица участников
@@ -634,10 +634,10 @@ Log.i(DEBUG_TAG, "Rows deleted: " + rows);
указан один участник или гость события. При вызове метода
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
возвращается список участников для события
-с заданным {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}.
+с заданным {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}.
Этот {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
должен соответствовать {@link
-android.provider.BaseColumns#_ID} определенного события.
+android.provider.BaseColumns#_ID} определенного события.
В таблице ниже указаны
поля, доступные для записи. При вставке нового участника необходимо указать все эти поля, кроме
@@ -720,7 +720,7 @@ Uri uri = cr.insert(Attendees.CONTENT_URI, values);
В каждой строке таблицы {@link android.provider.CalendarContract.Reminders}
указано одно напоминание о событии. При вызове метода
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}возвращается список напоминаний для события
-с заданным
+с заданным
{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}.
@@ -780,9 +780,9 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
возможность запрашивать повторения событий.
В таблице ниже перечислены некоторые из полей, которые можно запросить для экземпляра. Обратите внимание,
-что часовой пояс задается параметрами
-{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
-и
+что часовой пояс задается параметрами
+{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
+и
{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_INSTANCES}.
@@ -801,18 +801,18 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
Минута начала экземпляра, вычисленная от полуночи по часовому поясу
-приложения «Календарь».
+приложения «Календарь».
-
+
Запрос таблицы экземпляров
-
Чтобы запросить таблицу экземпляров, необходимо указать промежуток времени для запроса в
+
Чтобы запросить таблицу экземпляров, необходимо указать промежуток времени для запроса в
URI. В этом примере {@link android.provider.CalendarContract.Instances}
получает доступ к полю {@link
android.provider.CalendarContract.EventsColumns#TITLE} посредством своей реализации
-интерфейса {@link android.provider.CalendarContract.EventsColumns}.
+интерфейса {@link android.provider.CalendarContract.EventsColumns}.
Другими словами, {@link
android.provider.CalendarContract.EventsColumns#TITLE}
возвращается посредством обращения к базе данных, а не путем запроса таблицы {@link
@@ -853,7 +853,7 @@ public static final String[] INSTANCE_PROJECTION = new String[] {
Instances.BEGIN, // 1
Instances.TITLE // 2
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_BEGIN_INDEX = 1;
@@ -868,7 +868,7 @@ long startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2011, 10, 24, 8, 0);
long endMillis = endTime.getTimeInMillis();
-
+
Cursor cur = null;
ContentResolver cr = getContentResolver();
@@ -883,28 +883,28 @@ ContentUris.appendId(builder, startMillis);
ContentUris.appendId(builder, endMillis);
// Submit the query
-cur = cr.query(builder.build(),
- INSTANCE_PROJECTION,
- selection,
- selectionArgs,
+cur = cr.query(builder.build(),
+ INSTANCE_PROJECTION,
+ selection,
+ selectionArgs,
null);
-
+
while (cur.moveToNext()) {
String title = null;
long eventID = 0;
- long beginVal = 0;
-
+ long beginVal = 0;
+
// Get the field values
eventID = cur.getLong(PROJECTION_ID_INDEX);
beginVal = cur.getLong(PROJECTION_BEGIN_INDEX);
title = cur.getString(PROJECTION_TITLE_INDEX);
-
- // Do something with the values.
- Log.i(DEBUG_TAG, "Event: " + title);
+
+ // Do something with the values.
+ Log.i(DEBUG_TAG, "Event: " + title);
Calendar calendar = Calendar.getInstance();
- calendar.setTimeInMillis(beginVal);
+ calendar.setTimeInMillis(beginVal);
DateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
- Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
+ Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
}
}
@@ -923,8 +923,8 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_VIEW VIEW}
Сослаться на URI также можно с помощью
-{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
-Пример использования этого намерения представлен в разделе Использование намерений для просмотра данных календаря.
+{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
+Пример использования этого намерения представлен в разделе Использование намерений для просмотра данных календаря.
Открытие календаря во время, заданное параметром <ms_since_epoch>.
@@ -935,11 +935,11 @@ while (cur.moveToNext()) {
content://com.android.calendar/events/<event_id>
-
+
Сослаться на URI также можно с помощью
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
Пример использования этого намерения представлен в разделе Использование намерений для просмотра данных календаря.
-
+
Просмотр события, указанного с помощью <event_id>.
@@ -952,12 +952,12 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_EDIT EDIT}
content://com.android.calendar/events/<event_id>
-
+
Сослаться на URI также можно с помощью
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
Пример использования этого намерения представлен в разделе Использование намерения для редактирования события.
-
-
+
+
Редактирование события, указанного с помощью <event_id>.
@@ -972,11 +972,11 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_INSERT INSERT}
content://com.android.calendar/events
-
+
Сослаться на URI также можно с помощью
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
Пример использования этого намерения представлен в разделе Использование намерения для редактирования события.
-
+
Если событие считается как занятое или как свободное время, доступное для планирования.
-
-
+
+
В разделах ниже указан порядок использования этих намерений.
@@ -1059,14 +1059,14 @@ Events.AVAILABILITY}
Благодаря этому в файл манифеста вашего приложения не нужно включать разрешение {@link
android.Manifest.permission#WRITE_CALENDAR}.
-
+
Когда пользователи работают с приложением, в котором используется такой подход, приложение отправляет
их в «Календарь» для завершения добавления события. Намерение {@link
android.content.Intent#ACTION_INSERT INSERT} использует дополнительные поля
для предварительного указания в форме сведений о событии в приложении «Календарь». После этого пользователи
могут отменить событие, отредактировать форму или сохранить событие в своем
календаре.
-
+
Ниже представлен фрагмент кода, в котором на 19 января 2012 г. планируется событие, которое будет проходить с
@@ -1075,7 +1075,7 @@ android.content.Intent#ACTION_INSERT INSERT} использует дополни
В качестве URI в нем задается
{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
-
+
В нем используются дополнительные поля {@link
android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME
CalendarContract.EXTRA_EVENT_BEGIN_TIME} и {@link
@@ -1083,10 +1083,10 @@ android.provider.CalendarContract#EXTRA_EVENT_END_TIME
CalendarContract.EXTRA_EVENT_END_TIME} для предварительного указания в форме
сведений о времени события. Значения времени должны быть указаны в формате UTC и в миллисекундах от
эпохи.
-
+
В нем используется дополнительное поле {@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}
для предоставления списка участников, разделенных запятыми (их адреса эл. почты).
Адаптеру синхронизации необходимо указать, что он является таковым, задав для параметра {@link android.provider.CalendarContract#CALLER_IS_SYNCADAPTER} значение true.
-
-
+
+
Адаптеру синхронизации необходимо предоставить {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_NAME} и {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} в качестве параметров запроса в URI.
-
+
Адаптер синхронизации имеет доступ на запись к большему числу столбцов, чем приложение или виджет.
Например, приложение может изменять только некоторые характеристики календаря,
такие как название, отображаемое имя, настройки видимости и
diff --git a/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd
index 4d07856f250ed..151f75bc7e833 100644
--- a/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd
+++ b/docs/html-intl/intl/ru/guide/topics/providers/contacts-provider.jd
@@ -467,7 +467,7 @@ Email.CONTENT_ITEM_TYPE}, в которой в столбце
При добавлении нового необработанного контакта,
-который не соответствует ни одному из существующих контактов, поставщик контактов создает новый контакт. Поставщик поступает аналогично в случае, если
+который не соответствует ни одному из существующих контактов, поставщик контактов создает новый контакт. Поставщик поступает аналогично в случае, если
данные в строке существующего необработанного контакта изменяются таким образом, что они больше не соответствуют контакту,
с которым они ранее были связаны. При создании приложением или адаптером синхронизации нового контакта,
который соответствует существующему контакту, то новый контакт объединяется с
@@ -543,7 +543,7 @@ Email.CONTENT_ITEM_TYPE}, в которой в столбце
Если необходимо передать данные из службы в поставщик контактов, необходимо создать
-собственный адаптер синхронизации. Дополнительные сведения об этом представлены в разделе
+собственный адаптер синхронизации. Дополнительные сведения об этом представлены в разделе
Адаптеры синхронизации поставщика контактов.
@@ -672,7 +672,7 @@ mProfileCursor =
Android.
Адаптеры синхронизации, которые вносят изменения в необработанные контакты или таблицы данных, должны всегда добавлять к используемому ими URI
-контента строку
+контента строку
{@link android.provider.ContactsContract#CALLER_IS_SYNCADAPTER}. Это позволяет предотвратить пометку таких строк поставщиком как «грязных».
В противном случае изменения, внесенные адаптером синхронизации, будут рассматриваться как локальные изменения,
которые подлежат отправке на сервер, даже если источником таких изменений был сам сервер.
@@ -1809,7 +1809,7 @@ URI веб-службы для синхронизации с поставщик
Необязательно: элемент
<meta-data>
-для структуры проверки подлинности указывает на файл XML
+для структуры проверки подлинности указывает на файл XML
res/xml/authenticator.xml. В свою очередь, в этом файле задается
тип аккаунта, который поддерживает структура проверки подлинности, а также ресурсы пользовательского интерфейса,
которые отображаются в процессе аутентификации. Тип аккаунта, указанный в этом
@@ -2022,7 +2022,7 @@ openAssetFileDescriptor()}, передав в него этот URI, чтобы
Регулярная синхронизация элементов потока с помощью поставщика контактов выполняется так же,
-как и любая другая синхронизация. Дополнительные сведения о синхронизации представлены в разделе
+как и любая другая синхронизация. Дополнительные сведения о синхронизации представлены в разделе
Адаптеры синхронизации поставщика контактов. Регистрация уведомлений
и приглашение контактов рассматриваются в следующих двух разделах.
@@ -2092,7 +2092,7 @@ openAssetFileDescriptor()}, передав в него этот URI, чтобы
Взаимодействие со службой социальной сети
Пользователям не обязательно выходить из приложения для работы с контактами, которое имеется на устройстве, чтобы пригласить контакт на сайт
-социальной сети. Вместо этого приложение для работы с контактами может отправить намерение для приглашения
+социальной сети. Вместо этого приложение для работы с контактами может отправить намерение для приглашения
контакта в одну из ваших операций. Для этого выполните указанные ниже действия.
В таблице 2 указано соответствие аргументов для метода
-{@link android.content.ContentResolver#query
+{@link android.content.ContentResolver#query
query(Uri,projection,selection,selectionArgs,sortOrder)} SQL-инструкции SELECT.
@@ -701,7 +701,7 @@ if (mCursor != null) {
для вставки, обновления или удаления данных.
- Чтобы получить разрешения, необходимые для доступа к поставщику, приложение запрашивает их с помощью элемента
+ Чтобы получить разрешения, необходимые для доступа к поставщику, приложение запрашивает их с помощью элемента
<uses-permission>
в файле манифеста. При установке менеджером пакетов Android приложения пользователю необходимо
утвердить все разрешения, запрашиваемые приложением. В случае утверждения всех разрешений
diff --git a/docs/html-intl/intl/ru/guide/topics/providers/content-provider-creating.jd b/docs/html-intl/intl/ru/guide/topics/providers/content-provider-creating.jd
index d8f787393eaad..d6697579b4a40 100644
--- a/docs/html-intl/intl/ru/guide/topics/providers/content-provider-creating.jd
+++ b/docs/html-intl/intl/ru/guide/topics/providers/content-provider-creating.jd
@@ -485,7 +485,7 @@ public class ExampleProvider extends ContentProvider {
Необходимые методы
В абстрактном классе {@link android.content.ContentProvider} определены шесть абстрактных методов,
-которые необходимо реализовать в рамках вашего собственного конкретного подкласса. Все указанные ниже методы, кроме
+которые необходимо реализовать в рамках вашего собственного конкретного подкласса. Все указанные ниже методы, кроме
{@link android.content.ContentProvider#onCreate() onCreate()}, вызываются клиентским приложением,
которое пытается получить доступ к вашему поставщику контента.
@@ -777,7 +777,7 @@ URI контента. Аргумент {@link android.net.Uri} может выс
Для общих типов данных, таких как текст, HTML или JPEG, метод
{@link android.content.ContentProvider#getType(Uri) getType()} должен возвращать стандартный тип
-MIME. Полный список стандартных типов представлен на
+MIME. Полный список стандартных типов представлен на
веб-сайте
IANA MIME Media Types.
@@ -870,8 +870,8 @@ ContentProvider.getStreamTypes()} при этом должен возвраща
Класс-контракт представляет собой класс public final, в котором содержатся определения констант для
URI, имен столбцов, типов MIME и других метаданных поставщика. Класс
-устанавливает контрактные отношения между поставщиком и другими приложениями путем обеспечения
-прямого доступа к поставщику даже в случае изменения фактических значений URI, имен столбцов и
+устанавливает контрактные отношения между поставщиком и другими приложениями путем обеспечения
+прямого доступа к поставщику даже в случае изменения фактических значений URI, имен столбцов и
т. д.
@@ -928,7 +928,7 @@ Eclipse, могут автоматически заполнять имена к
Реализация разрешений
Любое приложение может выполнять чтение данных в поставщике или записывать их, даже если соответствующие данные
-являются закрытыми, поскольку по умолчанию для поставщика не заданы разрешения. Чтобы изменить эти настройки,
+являются закрытыми, поскольку по умолчанию для поставщика не заданы разрешения. Чтобы изменить эти настройки,
задайте разрешения для поставщика в файле манифеста с помощью атрибутов элемента
<provider> или его дочерних элементов. Можно задать разрешения, которые применяются ко всему поставщику
diff --git a/docs/html-intl/intl/ru/guide/topics/providers/document-provider.jd b/docs/html-intl/intl/ru/guide/topics/providers/document-provider.jd
index c594968490d4b..c394e60cbcb3c 100644
--- a/docs/html-intl/intl/ru/guide/topics/providers/document-provider.jd
+++ b/docs/html-intl/intl/ru/guide/topics/providers/document-provider.jd
@@ -567,7 +567,7 @@ SAF, написав собственный поставщик документо
Атрибут android:exported, установленный в значение "true".
Необходимо экспортировать поставщик, чтобы он был виден другим приложениям.
-
Атрибут android:grantUriPermissions, установленный в значение
+
Атрибут android:grantUriPermissions, установленный в значение
"true". Этот параметр позволяет системе предоставлять другим приложениям доступ
к контенту поставщика. Обсуждение того, как следует удерживать права доступа
к конкретному документу см. в разделе Удержание прав доступа.
Реализация метода
{@link android.provider.DocumentsProvider#queryChildDocuments queryChildDocuments()}
должна возвращать объект{@link android.database.Cursor}, указывающий на все файлы в
заданном каталоге, используя столбцы, определенные в
diff --git a/docs/html-intl/intl/ru/guide/topics/resources/accessing-resources.jd b/docs/html-intl/intl/ru/guide/topics/resources/accessing-resources.jd
index 3d59ceb292a24..ccb7ad8f46f02 100644
--- a/docs/html-intl/intl/ru/guide/topics/resources/accessing-resources.jd
+++ b/docs/html-intl/intl/ru/guide/topics/resources/accessing-resources.jd
@@ -209,7 +209,7 @@ R.java} вручную — этот файл создается инстр
{@code <package_name>} — это имя пакета, в котором находится ресурс (не
требуется при создании ссылок на ресурсы из одного и того же пакета).
-
{@code <resource_type>} — это подкласс
+
{@code <resource_type>} — это подкласс
{@code R} для типа ресурса.
{@code <resource_name>} — это либо имя файла
ресурса (без расширения), либо значение атрибута {@code android:name} в элементе XML (для простых
@@ -222,7 +222,7 @@ R.java} вручную — этот файл создается инстр
Примеры использования
-
В некоторых случаях ресурс необходимо использовать в качестве значения в элементе XML (например, чтобы применить графическое изображение к
+
В некоторых случаях ресурс необходимо использовать в качестве значения в элементе XML (например, чтобы применить графическое изображение к
виджету), однако вы также можете использовать ресурс в любом фрагменте XML, где ожидается простое значение. Например,
если имеется следующий файл ресурса, включающий цветовой ресурс и строковый ресурс:
Примечание. Всегда используйте строковые ресурсы,
-поскольку ваше приложение может потребоваться перевести на другие языки.
+поскольку ваше приложение может потребоваться перевести на другие языки.
Сведения о создании альтернативных
ресурсов (например, локализованных строк) представлены в разделе Предоставление альтернативных
ресурсов. В разделе Локализация приведено полное руководство по локализации
приложения.
-
Вы даже можете использовать ресурсы в XML для создания псевдонимов. Например, можно создать
+
Вы даже можете использовать ресурсы в XML для создания псевдонимов. Например, можно создать
элемент дизайна, который будет служить псевдонимом для другого элемента дизайна:
diff --git a/docs/html-intl/intl/ru/guide/topics/resources/providing-resources.jd b/docs/html-intl/intl/ru/guide/topics/resources/providing-resources.jd
index be0af952896e4..6a287b8972aaf 100644
--- a/docs/html-intl/intl/ru/guide/topics/resources/providing-resources.jd
+++ b/docs/html-intl/intl/ru/guide/topics/resources/providing-resources.jd
@@ -495,7 +495,7 @@ android.content.res.Configuration#smallestScreenWidthDp}, которое сод
экрану VGA средней плотности.
Минимальный размер макета для большого экрана составляет приблизительно 480x640 пикселов.
Примерами являются экраны VGA и WVGA средней плотности.
-
{@code xlarge}: Экраны значительно крупнее обычного
+
{@code xlarge}: Экраны значительно крупнее обычного
экрана HVGA средней плотности. Минимальный размер макета для очень большого экрана составляет
приблизительно 720x960 пикселов. В большинстве случаев устройства с очень большими
экранами слишком велики для карманного использования и, скорее всего,
@@ -510,7 +510,7 @@ android.content.res.Configuration#smallestScreenWidthDp}, которое сод
аварийно завершится во время выполнения (например, если все ресурсы макета отмечены квалификатором {@code
xlarge}, но устройство оснащено экраном нормального размера).
См. также поле конфигурации {@link android.content.res.Configuration#screenLayout}, которое
@@ -1088,7 +1088,7 @@ drawable-en-port/
чем число квалификаторов, которые точно соответствуют устройству. Например, на шаге 4 выше, последний
вариант в списке содержит три квалификатора, которые точно соответствуют устройству (ориентация, тип
сенсорного экрана и способ ввода), в то время как drawable-en содержит только один подходящий параметр
-(язык). Однако язык имеет более высокий приоритет, чем эти остальные квалификаторы, поэтому
+(язык). Однако язык имеет более высокий приоритет, чем эти остальные квалификаторы, поэтому
drawable-port-notouch-12key вычеркивается.
Для получения более подробной информации об использовании ресурсов в приложении перейдите к разделу Доступ к ресурсам.
diff --git a/docs/html-intl/intl/ru/guide/topics/resources/runtime-changes.jd b/docs/html-intl/intl/ru/guide/topics/resources/runtime-changes.jd
index 5dc59c81559ff..51337514566b4 100644
--- a/docs/html-intl/intl/ru/guide/topics/resources/runtime-changes.jd
+++ b/docs/html-intl/intl/ru/guide/topics/resources/runtime-changes.jd
@@ -125,7 +125,7 @@ android.graphics.drawable.Drawable}, {@link android.widget.Adapter}, {@link andr
означает, что приложение удерживает их, и система не может очистить от них память, поэтому
может теряться значительный объем памяти).
-
Затем используйте {@link android.app.FragmentManager} для добавления фрагмента в операцию.
+
Затем используйте {@link android.app.FragmentManager} для добавления фрагмента в операцию.
Можно получить объект данных из фрагмента, когда операция повторно запускается в результате изменения конфигурации
в режиме выполнения. В качестве примера операция определена следующим образом:
@@ -168,7 +168,7 @@ public class MyActivity extends Activity {
В этом примере {@link android.app.Activity#onCreate(Bundle) onCreate()} добавляет фрагмент
или восстанавливает ссылку на него. Метод {@link android.app.Activity#onCreate(Bundle) onCreate()} также
хранит объект, сохраняющий состояние, внутри экземпляра фрагмента.
-Метод {@link android.app.Activity#onDestroy() onDestroy()} обновляет объект, сохраняющий состояние, внутри
+Метод {@link android.app.Activity#onDestroy() onDestroy()} обновляет объект, сохраняющий состояние, внутри
сохраненного экземпляра фрагмента.
diff --git a/docs/html-intl/intl/ru/guide/topics/ui/controls.jd b/docs/html-intl/intl/ru/guide/topics/ui/controls.jd
index 62f4c76686f5e..7e15a72c3e958 100644
--- a/docs/html-intl/intl/ru/guide/topics/ui/controls.jd
+++ b/docs/html-intl/intl/ru/guide/topics/ui/controls.jd
@@ -69,7 +69,7 @@ Android. Все они имеются в пакете {@link android.widget}. Е
diff --git a/docs/html-intl/intl/ru/guide/topics/ui/declaring-layout.jd b/docs/html-intl/intl/ru/guide/topics/ui/declaring-layout.jd
index 71428f6e1cdd4..b5db656d0e603 100644
--- a/docs/html-intl/intl/ru/guide/topics/ui/declaring-layout.jd
+++ b/docs/html-intl/intl/ru/guide/topics/ui/declaring-layout.jd
@@ -219,9 +219,9 @@ LayoutParams также включают дополнительные парам
Как правило, не рекомендуется задавать абсолютные значения ширины и высоты макета
(например, в пикселах). Вместо этого используйте относительные единицы измерения, такие как
пикселы, не зависящие от разрешения экрана (dp), wrap_contentили
-match_parentЭто гарантирует одинаковое отображение
+match_parentЭто гарантирует одинаковое отображение
вашего приложения на устройствах с экранами разных размеров.
-Принятые типы измерения определены в
+Принятые типы измерения определены в
документе
Доступные ресурсы.
@@ -325,7 +325,7 @@ div.layout.first {
Android.
Примечание. Несмотря на то, что для формирования пользовательского интерфейса один
-макет может содержать один или несколько вложенных макетов, рекомендуется использовать как можно более простую
+макет может содержать один или несколько вложенных макетов, рекомендуется использовать как можно более простую
иерархию макетов. Чем меньше в макете вложенных элементов, тем быстрее выполняется его отрисовка (горизонтальная иерархия
представлений намного лучше вертикальной).
Методы set...Button() предполагают заголовок для кнопки (реализуемый
-через строковый ресурс) и
-{@link android.content.DialogInterface.OnClickListener}, который определяет действие,
+через строковый ресурс) и
+{@link android.content.DialogInterface.OnClickListener}, который определяет действие,
следующее за нажатием кнопки пользователем.
Реализована возможность добавлять три различных вида кнопок действий:
Используются в случаях, когда пользователь может не желать продолжить действие,
но при этом необязательно хочет его отменить. Появляется между положительными и отрицательнымиI
- кнопками. Примером такого действия может быть «Напомнить позже».
+ кнопками. Примером такого действия может быть «Напомнить позже».
Можно добавлять только одну кнопку каждого вида в {@link
@@ -271,7 +271,7 @@ android.app.AlertDialog}. Это означает, что нельзя испо
Интерактивный список с выбором нескольких вариантов (флажки)
-
Для создания списка с выбором одного варианта, как на рисунке 3,
+
Для создания списка с выбором одного варианта, как на рисунке 3,
используйте метод{@link android.app.AlertDialog.Builder#setItems setItems()}:
@@ -289,9 +289,9 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
}
-
Поскольку список отображается в области содержимого диалогового окна,
+
Поскольку список отображается в области содержимого диалогового окна,
диалоговое окно не может показать одновременно сообщение и список, поэтому необходимо задать заголовок
-диалогового окна с помощью {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
+диалогового окна с помощью {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
Для указания элементов списка необходимо вызвать {@link
android.app.AlertDialog.Builder#setItems setItems()}, передающий указатель.
В качестве другого варианта можно указать список с помощью {@link
@@ -320,8 +320,8 @@ android.app.AlertDialog.Builder#setAdapter setAdapter()}. Наполнение
Для добавления списка с несколькими вариантами ответов (флажки) или
списка с одним вариантом ответа (переключатели) используйте методы
{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
-DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} или
-{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} или
+{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} соответственно.
Например, таким образом можно создать список с несколькими вариантами ответов, как на
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -371,9 +371,9 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
}
-
Несмотря на то, что и традиционный список, и список с переключателями
+
Несмотря на то, что и традиционный список, и список с переключателями
предполагают действие по выбору одного элемента, вам необходимо использовать {@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()}, чтобы сохранить выбор пользователя.
Это значит, что при повторном открытии диалогового окна будет отображаться текущий выбор пользователя,
а затем создается список с переключателями.
Для применения макета в вашем {@link android.support.v4.app.DialogFragment}
-вам понадобится {@link android.view.LayoutInflater} с
+вам понадобится {@link android.view.LayoutInflater} с
{@link android.app.Activity#getLayoutInflater()} и вызов
{@link android.view.LayoutInflater#inflate inflate()}, где первым параметром будет являться
ID ресурса макета, а вторым параметром — исходный вид макета.
@@ -470,7 +470,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -505,7 +505,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ public class NoticeDialogFragment extends DialogFragment {
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -638,7 +638,7 @@ android.support.v4.app.Fragment}.
Тем не менее, в этом случае нельзя использовать{@link android.app.AlertDialog.Builder AlertDialog.Builder}
или другие объекты {@link android.app.Dialog} для построения диалогового окна. Если
-необходимо сделать {@link android.support.v4.app.DialogFragment}
+необходимо сделать {@link android.support.v4.app.DialogFragment}
встраиваемым, нужно определить пользовательский интерфейс диалогового окна в макете методом обратного вызова
{@link android.support.v4.app.DialogFragment#onCreateView
onCreateView()}.
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ public class CustomDialogFragment extends DialogFragment {
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
@@ -695,12 +695,12 @@ public void showDialog() {
}
-
Подробные сведения о выполнении операций с фрагментами приведены в руководстве
+
Подробные сведения о выполнении операций с фрагментами приведены в руководстве
Фрагменты.
В приведенном примере mIsLargeLayout булеан указывает, должно ли текущее устройство использовать
большой макет приложения (и отображать фрагмент как диалоговое окно, а не
-в полноэкранном режиме). Лучшим способом установить такой вид булеана является объявление
+в полноэкранном режиме). Лучшим способом установить такой вид булеана является объявление
значения булевой переменной
с альтернативным значением для других размеров экранов. В качестве примера приведены два
варианта булевых ресурсов для различных размеров экранов:
@@ -776,7 +776,7 @@ android.support.v4.app.DialogFragment#onDismiss onDismiss()} в {@link
android.support.v4.app.DialogFragment}.
Также можно отменить диалоговое окно. Это особое событие, возникающее, когда пользователь
-покинул диалоговое окно, не завершив задачу. Так происходит, когда пользователь нажимает кнопку
+покинул диалоговое окно, не завершив задачу. Так происходит, когда пользователь нажимает кнопку
Назад, касается экрана за областью диалогового окна,
либо когда задано {@link android.app.Dialog#cancel()} в {@link
android.app.Dialog} (например, в качестве отклика на нажатие кнопки «Отмена» в диалоговом окне).
Несмотря на то что оформление и поведение некоторых пунктов меню изменились, семантика для определения
набора действий и вариантов по-прежнему основана на API-интерфейсах класса {@link android.view.Menu}. В этом
-руководстве рассказывается, как создавать три основополагающих типа меню или представлений действий в системе
+руководстве рассказывается, как создавать три основополагающих типа меню или представлений действий в системе
Android всех версий:
Меню параметров и строка действий
Пункты меню параметров представляют собой основные варианты выбора действий в пределах
-операции. Именно здесь следует размещать действия, которые затрагивают приложение в целом, например:
+операции. Именно здесь следует размещать действия, которые затрагивают приложение в целом, например:
"Поиск", "Составить сообщение эл. почты" и "Настройки".
При разработке приложений для версии Android 2.3 или более ранних версий пользователи могут
открыть панель меню параметров нажатием кнопки Меню.
@@ -83,9 +83,9 @@ Android всех версий:
строки действий.
Контекстное меню ― это плавающее меню, которое открывается, когда
пользователь длительно нажимает на элемент. В нем содержатся действия, которые затрагивают выбранный контент или
контекстный кадр.
@@ -94,11 +94,11 @@ Android всех версий:
выбрать сразу несколько элементов.
Во всплывающем меню отображается вертикальный список пунктов, который привязан к представлению,
вызвавшему меню. Он хорошо подходит для предоставления возможности дополнительных вариантов действий, относящихся к определенному контенту или
-для выдачи вариантов для второй части команды. Действия во всплывающем меню
+для выдачи вариантов для второй части команды. Действия во всплывающем меню
не должны напрямую затрагивать соответствующий контент — для этого предназначены контекстные
действия. Всплывающее меню предназначено для расширенных действий, относящихся к областям контента в вашей
операции.
@@ -135,7 +135,7 @@ Android всех версий:
<item>
Создает класс {@link android.view.MenuItem}, который представляет один пункт меню. Этот
элемент может содержать вложенный элемент <menu> для создания вложенных меню.
-
+
<group>
Необязательный, невидимый контейнер для элементов {@code <item>}. Он позволяет
разделять пункты меню на категории и назначать им одинаковые свойства, такие как активное состояние и видимость. Подробные
@@ -322,7 +322,7 @@ android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()} д
должен быть общедоступным и принимать один параметр {@link android.view.MenuItem}, — когда система
вызывает этот метод, она передает ему выбранный пункт меню. Подробные сведения и пример см. в документе Ресурс меню.
-
Совет. Если в приложении предусмотрено несколько операций и
+
Совет. Если в приложении предусмотрено несколько операций и
в некоторых из них имеются одинаковые меню параметров, рассмотрите возможность создания
операции, которая будет использовать исключительно методы {@link android.app.Activity#onCreateOptionsMenu(Menu)
onCreateOptionsMenu()} и {@link android.app.Activity#onOptionsItemSelected(MenuItem)
@@ -346,7 +346,7 @@ onCreateOptionsMenu()}, она сохранит заполненный вами
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} следует использовать только для создания начального
состояния меню, а не для внесения в него изменений в течение жизненного цикла операции.
-
Если вам требуется изменять меню параметров в зависимости от
+
Если вам требуется изменять меню параметров в зависимости от
событий, которые возникают в течение жизненного цикла операции, сделать это можно в
методе{@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}. Этот
метод передает объект {@link android.view.Menu} в том виде, в котором он в данный момент существует. Его-то и можно изменить
@@ -363,7 +363,7 @@ onPrepareOptionsMenu()} каждый раз, когда пользователь
вызвать метод {@link android.app.Activity#invalidateOptionsMenu invalidateOptionsMenu()}, чтобы запросить у
системы вызов метода {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}.
-
Примечание.
+
Примечание.
Никогда не следует изменять пункты меню параметров с учетом класса {@link android.view.View}, действующего
в данный момент. В сенсорном режиме (когда пользователь не использует трекбол или кнопки направления движения) фокус
не может переводиться на представления, поэтому никогда не следует использовать фокус в качестве основы для изменения
@@ -525,7 +525,7 @@ android.widget.ListView} или {@link android.widget.GridView} (что позв
представления, то вам следует:
Реализовать интерфейс {@link android.view.ActionMode.Callback}. В его методах обратного вызова вы
-можете указать действия для строки контекстных действий, реагировать на нажатия пунктов действий и
+можете указать действия для строки контекстных действий, реагировать на нажатия пунктов действий и
обрабатывать другие события жизненного цикла для режима действий.
Вызывайте {@link android.app.Activity#startActionMode startActionMode()}, когда требуется показать
строку (например, когда пользователь выполняет длительное нажатие представления).
@@ -582,12 +582,12 @@ android.view.ActionMode} можно вносить различные измен
android.view.ActionMode#setSubtitle setSubtitle()} (удобно для указания количества выбранных
элементов).
-
Также обратите внимание, что приведенный выше образец кода задает для переменной {@code mActionMode} значение null, когда
+
Также обратите внимание, что приведенный выше образец кода задает для переменной {@code mActionMode} значение null, когда
режим действия прекращает свое существование. Далее вы узнаете, каким образом он инициализируется и чем может быть
полезно сохранение составной переменной в операции или фрагменте.
-
Для включения режима контекстных действий, когда это необходимо,
+
Для включения режима контекстных действий, когда это необходимо,
например, в ответ на длительное нажатие {@link
android.view.View}, вызывайте {@link android.app.Activity#startActionMode startActionMode()}:
@@ -727,7 +727,7 @@ android.widget.AbsListView.MultiChoiceModeListener#onCreateActionMode onCreateAc
Создайте экземпляр класса {@link android.widget.PopupMenu} с помощью его конструктора, принимающий
+
Создайте экземпляр класса {@link android.widget.PopupMenu} с помощью его конструктора, принимающий
текущие {@link android.content.Context} и {@link android.view.View} приложения, к которым
должно быть привязано меню.
С помощью {@link android.view.MenuInflater} загрузите свой ресурс меню в объект {@link
@@ -742,8 +742,8 @@ android.widget.PopupMenu#getMenu() PopupMenu.getMenu()}. На API уровня 1
<ImageButton
- android:layout_width="wrap_content"
- android:layout_height="wrap_content"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
android:src="@drawable/ic_overflow_holo_dark"
android:contentDescription="@string/descr_overflow_button"
android:onClick="showPopup" />
@@ -901,7 +901,7 @@ android.view.MenuItem#setChecked(boolean) setChecked()}.
(например {@link android.app.Activity#onOptionsItemSelected(MenuItem) onOptionsItemSelected()}). Именно
здесь необходимо задать состояние флажка, поскольку флажок или переключатель не
изменяет свое состояние автоматически. Запросить текущее состояние пункта (в котором он находился до того, как был
-выбран пользователем) можно с помощью{@link android.view.MenuItem#isChecked()}, а затем задать помеченное состояние с помощью
+выбран пользователем) можно с помощью{@link android.view.MenuItem#isChecked()}, а затем задать помеченное состояние с помощью
{@link android.view.MenuItem#setChecked(boolean) setChecked()}. Например:
Поскольку уведомления являются как важной составной частью пользовательского интерфейса Android, для них имеются собственные инструкции по проектированию.
Появившиеся в Android 5.0 (уровень API 21) значительные изменения дизайна имеют особо важное
значение, поэтому для получения более подробной информации вам следует ознакомиться с учебником по интерфейсу Material Design
-. Чтобы узнать, как проектировать уведомления и взаимодействие с ними, прочитайте руководство по проектированию
+. Чтобы узнать, как проектировать уведомления и взаимодействие с ними, прочитайте руководство по проектированию
Уведомления.
Создание уведомления
@@ -294,7 +294,7 @@ mBuilder.setStyle(inBoxStyle);
Обеспечьте доступ к этой функции операции {@link android.app.Activity} всех пользователей,
сделав так, чтобы эта операция запускалась, когда пользователь нажимает уведомление. Для этого
создайте объект {@link android.app.PendingIntent}
- для операции {@link android.app.Activity}. Вызовите
+ для операции {@link android.app.Activity}. Вызовите
{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent
setContentIntent()}, чтобы добавить объект {@link android.app.PendingIntent} в уведомление.
@@ -333,7 +333,7 @@ mBuilder.setStyle(inBoxStyle);
вызова метода {@link android.app.NotificationManager#notify(int, android.app.Notification) NotificationManager.notify()}.
Чтобы изменить это уведомление, после того как оно выдано,
обновите или создайте объект {@link android.support.v4.app.NotificationCompat.Builder},
- постройте на его основе объект {@link android.app.Notification} и выдайте
+ постройте на его основе объект {@link android.app.Notification} и выдайте
объект {@link android.app.Notification} с тем же идентификатором, который использовался ранее. Если
предыдущее уведомление все еще отображается на экране, система обновит его с использованием содержимого
объекта{@link android.app.Notification}. Если предыдущее уведомление было закрыто, то
@@ -451,14 +451,14 @@ numMessages = 0;
Добавьте поддержку для версии Android 4.0.3 и более ранних версий. Для этого укажите родительский объект операции
{@link android.app.Activity}, которую запускаете, добавив элемент
<meta-data>
- в качестве дочернего для элемента
+ в качестве дочернего для элемента
<activity>.
Для этого элемента задайте
android:name="android.support.PARENT_ACTIVITY".
Задайте
android:value="<parent_activity_name>",
- где <parent_activity_name> ― это значение
+ где <parent_activity_name> ― это значение
android:name
для родительского элемента
<activity>
@@ -466,7 +466,7 @@ numMessages = 0;
- Также добавьте поддержку для версии Android 4.1 и более поздних версий. Для этого добавьте атрибут
+ Также добавьте поддержку для версии Android 4.1 и более поздних версий. Для этого добавьте атрибут
android:parentActivityName
в элемент
<activity>
@@ -513,7 +513,7 @@ numMessages = 0;
запускает {@link android.app.Activity}. Этот метод также добавляет флаги, которые запускают
стек в новой задаче.
- Примечание. Несмотря на то что аргумент
+ Примечание. Несмотря на то что аргумент
{@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()}
является ссылкой на запускаемую операцию {@link android.app.Activity}, при вызове этого метода
не добавляется объект {@link android.content.Intent}, который запускает операцию
@@ -536,7 +536,7 @@ numMessages = 0;
в нее с помощью действия "Назад".
- Получите объект {@link android.app.PendingIntent} для этого стека переходов назад путем вызова метода
+ Получите объект {@link android.app.PendingIntent} для этого стека переходов назад путем вызова метода
{@link android.support.v4.app.TaskStackBuilder#getPendingIntent getPendingIntent()}.
Затем этот объект {@link android.app.PendingIntent} можно будет использовать в качестве аргумента для метода
{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent
@@ -576,7 +576,7 @@ mNotificationManager.notify(id, builder.build());
Особой операции {@link android.app.Activity} не требуется стек перехода назад, поэтому не нужно
определять иерархию объектов {@link android.app.Activity} в файле манифеста и
вызывать
- метод {@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()} для построения
+ метод {@link android.support.v4.app.TaskStackBuilder#addParentStack addParentStack()} для построения
стека перехода назад. Вместо этого в файле манифеста задайте параметры задачи {@link android.app.Activity}
и создайте объект {@link android.app.PendingIntent} путем вызова метода
{@link android.app.PendingIntent#getActivity getActivity()}:
@@ -597,7 +597,7 @@ mNotificationManager.notify(id, builder.build());
android:taskAffinity=""
- В сочетании с
+ В сочетании с
флагом {@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK},
который вы задали в коде, это гарантирует, что данная операция {@link android.app.Activity} не
перейдет в задачу приложения, используемую по умолчанию. Любые существующие задачи, имеющие
@@ -629,11 +629,11 @@ mNotificationManager.notify(id, builder.build());
Построение и выдача уведомления:
- Создайте объект {@link android.content.Intent}, который запускает операцию
+ Создайте объект {@link android.content.Intent}, который запускает операцию
{@link android.app.Activity}.
- Настройте операцию {@link android.app.Activity}, запускаемую в новой пустой задаче, путем вызова метода
+ Настройте операцию {@link android.app.Activity}, запускаемую в новой пустой задаче, путем вызова метода
{@link android.content.Intent#setFlags setFlags()} с флагами
{@link android.content.Intent#FLAG_ACTIVITY_NEW_TASK FLAG_ACTIVITY_NEW_TASK}
и
@@ -714,7 +714,7 @@ mNotificationManager.notify(id, builder.build());
{@link android.support.v4.app.NotificationCompat.Builder#setProgress
setProgress(max, progress, false)}, а затем выдайте уведомление. По мере выполнения
увеличивайте значение progress и обновляйте уведомление. По окончании операции
- progress должен быть равен max. Стандартный способ вызова метода
+ progress должен быть равен max. Стандартный способ вызова метода
{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}
заключается в следующем: задать значение max равным 100 с последующим увеличением progress в виде
величины "процента выполнения" операции.
@@ -841,7 +841,7 @@ mNotifyManager.notify(0, mBuilder.build());
Примеры ситуаций, в которых могут быть вызваны уведомления heads-up:
-
операция пользователя выполняется в полноэкранном режиме (приложение использует
+
операция пользователя выполняется в полноэкранном режиме (приложение использует
{@link android.app.Notification#fullScreenIntent}) или;
уведомление имеет высокий приоритет и использует рингтоны или
вибрацию.
@@ -915,7 +915,7 @@ Notification notification = new Notification.Builder(context)
Примечание. Прекращение использования класса {@link android.media.RemoteControlClient}
-имеет и другие последствия для управления мультимедиа. Подробные сведения о новых API-интерфейсах для управления сеансами воспроизведения мультимедиа см. в разделе
+имеет и другие последствия для управления мультимедиа. Подробные сведения о новых API-интерфейсах для управления сеансами воспроизведения мультимедиа см. в разделе
Управление воспроизведением мультимедиа
.
diff --git a/docs/html-intl/intl/ru/guide/topics/ui/overview.jd b/docs/html-intl/intl/ru/guide/topics/ui/overview.jd
index 0e9628b6d0162..8bb953f80d016 100644
--- a/docs/html-intl/intl/ru/guide/topics/ui/overview.jd
+++ b/docs/html-intl/intl/ru/guide/topics/ui/overview.jd
@@ -39,7 +39,7 @@ XML позволяет создавать удобочитаемую струк
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
- android:layout_width="fill_parent"
+ android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical" >
<TextView android:id="@+id/text"
@@ -60,7 +60,7 @@ XML позволяет создавать удобочитаемую струк
Полное руководство по созданию макета пользовательского интерфейса см. в документе Макеты
XML.
-
+
Компоненты пользовательского интерфейса
Не обязательно создавать все элементы пользовательского интерфейса с помощью объектов {@link android.view.View} и {@link
diff --git a/docs/html-intl/intl/ru/guide/topics/ui/settings.jd b/docs/html-intl/intl/ru/guide/topics/ui/settings.jd
index 4325439721deb..9adfd62305151 100644
--- a/docs/html-intl/intl/ru/guide/topics/ui/settings.jd
+++ b/docs/html-intl/intl/ru/guide/topics/ui/settings.jd
@@ -82,7 +82,7 @@ API-интерфейсы {@link android.preference.Preference} системы An
Рисунок 1. Снимки экранов настроек приложения Android
-для обмена сообщениями. Выбор элемента, заданного посредством {@link android.preference.Preference},
+для обмена сообщениями. Выбор элемента, заданного посредством {@link android.preference.Preference},
открывает интерфейс для изменения значения.
При разработке приложений для Android 3.0 (API уровня 11) и более поздних версий необходимо использовать {@link
android.preference.PreferenceFragment} для отображения списка
-объектов {@link android.preference.Preference}. Вы можете добавить {@link android.preference.PreferenceFragment} в любую операцию, при этом
+объектов {@link android.preference.Preference}. Вы можете добавить {@link android.preference.PreferenceFragment} в любую операцию, при этом
необязательно использовать {@link android.preference.PreferenceActivity}.
Фрагменты обеспечивают более
@@ -588,11 +588,11 @@ android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()}, чтоб
Чтобы отобразить заголовки предпочтений, вы должны реализовать метод обратного вызова {@link
-android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()} и вызвать
+android.preference.PreferenceActivity#onBuildHeaders onBuildHeaders()} и вызвать
{@link android.preference.PreferenceActivity#loadHeadersFromResource
loadHeadersFromResource()}. Например:
@@ -672,38 +672,38 @@ android.preference.Preference <Preference>} отправляет наме
для загрузки.
В качестве примера приведен XML-файл для заголовков предпочтений, который используется в Android версии 3.0
-и более поздних версий ({@code res/xml/preference_headers.xml}):
+и более поздних версий ({@code res/xml/preference_headers.xml}):
А здесь представлен файл предпочтений, который содержит те же самые заголовки для версий старше
+
А здесь представлен файл предпочтений, который содержит те же самые заголовки для версий старше
Android 3.0 ({@code res/xml/preference_headers_legacy.xml}):
Вы можете сохранить значение настройки в любой момент, вызвав один из методов {@code persist*()} класса {@link
android.preference.Preference}, например, {@link
-android.preference.Preference#persistInt persistInt()}, если настройка имеет целое значение, или
+android.preference.Preference#persistInt persistInt()}, если настройка имеет целое значение, или
{@link android.preference.Preference#persistBoolean persistBoolean()} для сохранения логического значения.
Примечание. Каждое предпочтение {@link android.preference.Preference} может сохранять только один
@@ -1071,7 +1071,7 @@ android.preference.Preference#getPersistedInt getPersistedInt()} не может
Предоставление значения по умолчанию
-
Если экземпляр вашего класса {@link android.preference.Preference} указывает значение по умолчанию
+
Если экземпляр вашего класса {@link android.preference.Preference} указывает значение по умолчанию
(с помощью атрибута {@code android:defaultValue}),
система вызывает {@link android.preference.Preference#onGetDefaultValue
onGetDefaultValue()}, когда она создает экземпляр объекта для извлечения значения. Вы должны реализовать
@@ -1194,7 +1194,7 @@ protected void onRestoreInstanceState(Parcelable state) {
// Cast state to custom BaseSavedState and pass to superclass
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
-
+
// Set this Preference's widget to reflect the restored state
mNumberPicker.setValue(myState.value);
}
diff --git a/docs/html-intl/intl/ru/guide/topics/ui/ui-events.jd b/docs/html-intl/intl/ru/guide/topics/ui/ui-events.jd
index cd2b4813cf834..9f3609bea789b 100644
--- a/docs/html-intl/intl/ru/guide/topics/ui/ui-events.jd
+++ b/docs/html-intl/intl/ru/guide/topics/ui/ui-events.jd
@@ -30,7 +30,7 @@ parent.link=index.html
которые называются приемниками событий, и служат перехватчиками действий пользователя с вашим пользовательским интерфейсом.
Несмотря на то, что вы будете чаще использовать приемники событий для перехвата действий пользователя, может
-наступить момент, когда вам не захочется наследовать класс View, чтобы создать нестандартный компонент.
+наступить момент, когда вам не захочется наследовать класс View, чтобы создать нестандартный компонент.
Возможно, вы захотите наследовать класс {@link android.widget.Button},
чтобы сделать нечто более необычное. В этом случае вы сможете определить поведение события по умолчанию для своего
класса с помощью обработчиков событий класса.
@@ -46,27 +46,27 @@ parent.link=index.html
onClick()
-
Из объекта {@link android.view.View.OnClickListener}.
+
Из объекта {@link android.view.View.OnClickListener}.
Этот метод вызывается, когда пользователь касается элемента
(в режиме касания), или переводит фокус на элемент с помощью клавиш перемещения или трекбола и
нажимает соответствующую клавишу «ввода» или нажимает на трекбол.
onLongClick()
-
Из объекта {@link android.view.View.OnLongClickListener}.
+
Из объекта {@link android.view.View.OnLongClickListener}.
Этот метод вызывается, когда пользователь касается элемента и удерживает его (в режиме касания),
или переводит фокус на элемент с помощью клавиш перемещения или трекбола и
нажимает и удерживает соответствующую клавишу «ввода» или трекбол (в течение одной секунды).
onFocusChange()
-
Из объекта {@link android.view.View.OnFocusChangeListener}.
+
Из объекта {@link android.view.View.OnFocusChangeListener}.
Этот метод вызывается, когда пользователь перемещается в элемент или из него с помощью клавиш перемещения или трекбола.
onKey()
-
Из объекта {@link android.view.View.OnKeyListener}.
+
Из объекта {@link android.view.View.OnKeyListener}.
Этот метод вызывается, когда пользователь переносит фокус на элемент и нажимает или отпускает аппаратную клавишу на устройстве.
onTouch()
-
Из объекта {@link android.view.View.OnTouchListener}.
+
Из объекта {@link android.view.View.OnTouchListener}.
Этот метод вызывается, когда пользователь выполняет действие, считающееся событием касания, например, нажимает, отпускает
или выполняет любой жест на экране (в пределах границ элемента).
onCreateContextMenu()
-
Из объекта {@link android.view.View.OnCreateContextMenuListener}.
+
Из объекта {@link android.view.View.OnCreateContextMenuListener}.
Этот метод вызывается, когда создается контекстное меню (в результате длительного «длительного нажатия»). См. обсуждение
контекстных меню в руководстве
для разработчиков Меню.
@@ -75,8 +75,8 @@ parent.link=index.html
Эти методы являются единственными составными частями соответствующих интерфейсов. Чтобы определить один из этих методов
и обрабатывать события, реализуйте вложенный интерфейс в вашем процесс или определите его, как анонимный класс.
Затем передайте экземпляр реализации
-в соответствующий метод View.set...Listener(). (Например, вызовите
-{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}
+в соответствующий метод View.set...Listener(). (Например, вызовите
+{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}
и передайте ему свою реализацию {@link android.view.View.OnClickListener OnClickListener}.)
В следующем примере показано, как зарегистрировать приемник события «по клику» (on-click) для кнопки.
@@ -122,7 +122,7 @@ public class ExampleActivity extends Activity implements OnClickListener {
зависит от события. Для некоторых методов, которые возвращают значения, причина описана ниже:
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} —
-этот метод возвращает логическое значение, указывающее, что вы обработали это событие и его более не следует хранить.
+этот метод возвращает логическое значение, указывающее, что вы обработали это событие и его более не следует хранить.
А именно, верните значение true, чтобы указать, что вы обработали событие и его следует остановить;
верните значение false, если вы не обработали его и/или событие должно продолжаться для любых других
приемников события on-click.
@@ -181,14 +181,14 @@ dispatchKeyEvent()}. В качестве альтернативы к пе
макета, учитывайте и другие методы:
{@link android.app.Activity#dispatchTouchEvent(MotionEvent)
- Activity.dispatchTouchEvent(MotionEvent)} — этот метод позволяет вашей операции {@link
+ Activity.dispatchTouchEvent(MotionEvent)} — этот метод позволяет вашей операции {@link
android.app.Activity} перехватывать все события касаний перед их отправкой в окно.
{@link android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)
ViewGroup.onInterceptTouchEvent(MotionEvent)} — этот метод позволяет объекту {@link
android.view.ViewGroup} просматривать события перед их отправкой в дочерние отображаемые объекты.
{@link android.view.ViewParent#requestDisallowInterceptTouchEvent(boolean)
ViewParent.requestDisallowInterceptTouchEvent(boolean)} — вызовите этот метод
-в родительском отображаемом объекте, чтобы указать ему, что он не должен перехватывать события касания с помощью {@link
+в родительском отображаемом объекте, чтобы указать ему, что он не должен перехватывать события касания с помощью {@link
android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)}.
@@ -199,7 +199,7 @@ dispatchKeyEvent()}. В качестве альтернативы к пе
какой элемент будет принимать ввод. Однако, если устройство поддерживает сенсорный ввод, и пользователь
начинает взаимодействовать с интерфейсом, прикасаясь к его элементам, исчезает необходимость
выделять элементы или передавать фокус определенному отображаемому объекту. Следовательно, существует режим
-взаимодействия, который называется «режимом касания».
+взаимодействия, который называется «режимом касания».
Как только пользователь касается экрана, устройство, поддерживающее сенсорный ввод,
@@ -214,7 +214,7 @@ dispatchKeyEvent()}. В качестве альтернативы к пе
с пользовательским интерфейсом без касания экрана.
-Состояние режима касания поддерживается во всей системе (для всех окон и операций).
+Состояние режима касания поддерживается во всей системе (для всех окон и операций).
Чтобы узнать текущее состояние, можно вызвать
{@link android.view.View#isInTouchMode} и посмотреть, находится ли устройство в режиме касания.
@@ -282,7 +282,7 @@ dispatchKeyEvent()}. В качестве альтернативы к пе
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/ru/preview/api-overview.jd b/docs/html-intl/intl/ru/preview/api-overview.jd
index d4e60427a98a7..887ea630e79c7 100644
--- a/docs/html-intl/intl/ru/preview/api-overview.jd
+++ b/docs/html-intl/intl/ru/preview/api-overview.jd
@@ -456,7 +456,7 @@ API-интерфейс платформы, который позволяет п
Android for Work
В Android for Work добавлены много новых возможностей и API-интерфейсов для устройств под управлением Android N.
-Некоторые из них приведены ниже. Полный список обновлений Android for Work, касающихся
+Некоторые из них приведены ниже. Полный список обновлений Android for Work, касающихся
Android N, содержится в списке изменений Android for Work.
Шифрованное хранилище устройства следует использовать только для
информации, которая должна быть доступна в режиме Direct Boot.
Шифрованное хранилище устройства не следует использовать в качестве шифрованного хранилища общего назначения.
-Для хранения данных пользователя или шифрованных данных, которые не требуются в режиме
+Для хранения данных пользователя или шифрованных данных, которые не требуются в режиме
Direct Boot, следует использовать шифрованное хранилище, требующее ввода учетных данных.
Уведомление о разблокировке пользователем
@@ -148,7 +148,7 @@ ACTION_BOOT_COMPLETED}, которое теперь указывает, что
Direct Boot на поддерживаемых устройствах с Android N, выполните одну из следующих последовательностей действий.
-
Включите на устройстве параметры разработчика Developer options, если вы еще не сделали этого ранее. Для этого
+
Включите на устройстве параметры разработчика Developer options, если вы еще не сделали этого ранее. Для этого
перейдите на экран Settings > About phone и нажмите семь раз Build number.
Когда параметры разработчика станут доступны, откройте раздел
Settings > Developer options и выберите
diff --git a/docs/html-intl/intl/ru/preview/features/multi-window.jd b/docs/html-intl/intl/ru/preview/features/multi-window.jd
index f1a8ea603ddd0..b45766c169a18 100644
--- a/docs/html-intl/intl/ru/preview/features/multi-window.jd
+++ b/docs/html-intl/intl/ru/preview/features/multi-window.jd
@@ -356,7 +356,7 @@ android:supportsPictureInPicture=["true" | "false"]
Чтобы перевести операцию в режим "картинка в картинке",
вызовите новый метод Activity.enterPictureInPicture(). Этот метод игнорируется, если
- устройство не поддерживает режим "картинка в картинке". Дополнительная информация содержится в документации
+ устройство не поддерживает режим "картинка в картинке". Дополнительная информация содержится в документации
Режим "картинка в картинке".
diff --git a/docs/html-intl/intl/ru/preview/features/multilingual-support.jd b/docs/html-intl/intl/ru/preview/features/multilingual-support.jd
index 83dd2b4d15452..83e9968f73da4 100644
--- a/docs/html-intl/intl/ru/preview/features/multilingual-support.jd
+++ b/docs/html-intl/intl/ru/preview/features/multilingual-support.jd
@@ -208,7 +208,7 @@ it_IT
конечных пользователей. Поэтому при разработке приложений для Android N
следует использовать средства форматирования, а не жесткое кодирование строк с числами и датами.
-
В качестве наглядного примера можно привести арабский язык, поддержка которого в Android N расширена
+
В качестве наглядного примера можно привести арабский язык, поддержка которого в Android N расширена
с одного {@code ar_EG} до 27 языковых стандартов. Большинство ресурсов этих языковых стандартов общие, но
в некоторых из них используются цифры формата ASCII, а в других — собственные цифры. Например,
если вы хотите создать предложение с числовой переменной
diff --git a/docs/html-intl/intl/ru/preview/features/notification-updates.jd b/docs/html-intl/intl/ru/preview/features/notification-updates.jd
index 9c7cb9347719b..54b3bc36f5d46 100644
--- a/docs/html-intl/intl/ru/preview/features/notification-updates.jd
+++ b/docs/html-intl/intl/ru/preview/features/notification-updates.jd
@@ -203,7 +203,7 @@ Builder.setGroup()}.
-
Добавление уведомлений в группу описано в разделе
+
По возможности оставляйте постоянный URI для доступа к внешнему каталогу, чтобы приложению не
-приходилось многократно запрашивать у пользователя разрешение на доступ. После предоставления доступа пользователем вызовите метод
+приходилось многократно запрашивать у пользователя разрешение на доступ. После предоставления доступа пользователем вызовите метод
getContentResolver().takePersistableUriPermssion() для
URI доступа к каталогу. Система сохранит постоянный URI и при последующих запросах
доступа будет возвращать ответ RESULT_OK. Таким образом, приложение не будет постоянно выводить
diff --git a/docs/html-intl/intl/ru/preview/features/security-config.jd b/docs/html-intl/intl/ru/preview/features/security-config.jd
index de117d68a83e4..5294a4f6bbbdb 100644
--- a/docs/html-intl/intl/ru/preview/features/security-config.jd
+++ b/docs/html-intl/intl/ru/preview/features/security-config.jd
@@ -133,7 +133,7 @@ page.image=images/cards/card-nyc_2x.jpg
- Добавьте самозаверенный сертификат или сертификат закрытого ЦС в формате PEM или DER в
+ Добавьте самозаверенный сертификат или сертификат закрытого ЦС в формате PEM или DER в
{@code res/raw/my_ca}.
@@ -209,7 +209,7 @@ page.image=images/cards/card-nyc_2x.jpg
При отладке приложения, которое использует для подключения протокол HTTPS, вам может потребоваться
подключение к локальному серверу разработки, у которого нет сертификата SSL
для рабочего сервера. Чтобы выполнить отладку без изменения кода
- приложения, вы можете указать ЦС для отладки,
+ приложения, вы можете указать ЦС для отладки,
которые входят в число доверенных, только если для параметра
android:debuggable
установлено значение {@code true} с использованием {@code debug-overrides}. Обычно среды разработки и инструменты
diff --git a/docs/html-intl/intl/ru/training/basics/activity-lifecycle/index.jd b/docs/html-intl/intl/ru/training/basics/activity-lifecycle/index.jd
index b8de11ecea67f..29f1730998e08 100644
--- a/docs/html-intl/intl/ru/training/basics/activity-lifecycle/index.jd
+++ b/docs/html-intl/intl/ru/training/basics/activity-lifecycle/index.jd
@@ -34,12 +34,12 @@ startpage=true
-
Во время навигации пользователя по вашему приложению экземпляры
+
Во время навигации пользователя по вашему приложению экземпляры
{@link android.app.Activity} внутри приложения переключаются между разными состояниями их
жизненного цикла Например, при первом запуске
операции она получает высокий приоритет в системе и привлекает внимание
пользователя. Во время этого процесса система Android вызывает серию методов жизненного цикла
-операции, позволяя настроить пользовательский интерфейс и другие компоненты. Если пользователь выполняет
+операции, позволяя настроить пользовательский интерфейс и другие компоненты. Если пользователь выполняет
действие, запускающее другую операцию, или переключается на другое приложение, система вызывает другой набор
методов жизненного цикла для операции, поскольку она переносится на фоновый уровень (операция больше не
отображается, но экземпляр и состояние остаются без изменений).
@@ -50,12 +50,12 @@ startpage=true
а сетевое соединение разрывалось. После возврата пользователя проигрыватель может снова подключиться к сети, и пользователь сможет возобновить воспроизведение
видео с того же самого места.
-
В этом учебном курсе разъясняются важные методы обратного вызова жизненного цикла, которые получает каждый экземпляр {@link
+
В этом учебном курсе разъясняются важные методы обратного вызова жизненного цикла, которые получает каждый экземпляр {@link
android.app.Activity}, и описывается как их использовать, чтобы операция выполнялась так, как этого ожидает
пользователь, и не потребляла системные ресурсы, когда они ей не нужны.
Из этого урока вы узнаете об основах жизненного цикла операций, способах запуска вашего приложения пользователями и вариантах
@@ -68,5 +68,5 @@ android.app.Activity}, и описывается как их использов
Операции
@@ -59,7 +59,7 @@ android.app.Activity#onPause()}, это может указывать, что о
Приостановка операции
-
+
Когда система вызывает {@link android.app.Activity#onPause()} для операции, это
технически означает, что операция остается частично видимой. Однако чаще всего это означает, что
пользователь покидает операцию, и вскоре она войдет в состояние остановки. Обратный вызов
diff --git a/docs/html-intl/intl/ru/training/basics/activity-lifecycle/recreating.jd b/docs/html-intl/intl/ru/training/basics/activity-lifecycle/recreating.jd
index acb89fa296219..c36ccf4038d08 100644
--- a/docs/html-intl/intl/ru/training/basics/activity-lifecycle/recreating.jd
+++ b/docs/html-intl/intl/ru/training/basics/activity-lifecycle/recreating.jd
@@ -8,13 +8,13 @@ trainingnavtop=true
В отличие от других парадигм программирования, где приложения запускаются с использованием метода {@code main()}, система
-Android запускает код в {@link android.app.Activity}экземпляре посредством активации определенных
+Android запускает код в {@link android.app.Activity}экземпляре посредством активации определенных
методов обратного вызова, соответствующих определенным этапам его
жизненного цикла. Существует последовательность методов обратного вызова, которые запускают операцию и последовательность
методов обратного вызова, уничтожающих операцию.
@@ -83,7 +83,7 @@ Android запускает код в {@link android.app.Activity}экземпл
@@ -66,7 +66,7 @@ page.title=Использование темы Material Design
Примечание. Темы Material Design доступны только в ОС Android 5.0 (уровень API 21) и более поздних версий.
Во вспомогательных библиотеках v7
представлены темы со стилями Material Design для некоторых виджетов. Эти библиотеки также обеспечивают поддержку настройки цветовой палитры.
- Дополнительные сведения см. на странице
+ Дополнительные сведения см. на странице
Обеспечение совместимости.
@@ -108,7 +108,7 @@ page.title=Использование темы Material Design
Кроме того, можно самостоятельно разместить элемент за строкой состояния. Например, если требуется наложить прозрачную строку состояния поверх фотографии, применив еле уловимый темный градиент, чтобы были видны белые значки состояния.
- Для этого задайте для атрибута android:statusBarColor значение
+ Для этого задайте для атрибута android:statusBarColor значение
@android:color/transparent и настройте флаги окна требуемым образом. Также можно воспользоваться
методом {@link android.view.Window#setStatusBarColor Window.setStatusBarColor()} для применения анимации или эффекта постепенного исчезания.
diff --git a/docs/html-intl/intl/ru/training/monitoring-device-state/battery-monitoring.jd b/docs/html-intl/intl/ru/training/monitoring-device-state/battery-monitoring.jd
index 26daf04bd1cea..a8e5843aee614 100644
--- a/docs/html-intl/intl/ru/training/monitoring-device-state/battery-monitoring.jd
+++ b/docs/html-intl/intl/ru/training/monitoring-device-state/battery-monitoring.jd
@@ -7,8 +7,8 @@ next.title=Determining and Monitoring the Docking State and Type
next.link=docking-monitoring.html
@jd:body
-
-
Если вы хотите изменить частоту фоновых обновлений, чтобы продлить время работы устройства от батареи, сначала рекомендуется проверить текущий уровень заряда и состояние зарядки.
Именно от этих двух факторов зависит, как обновления повлияют на время работы устройства от батареи. Когда устройство подключено к сети переменного тока, приложение можно обновлять максимально часто, поскольку процесс обновления не будет сказываться на уровне заряда батареи. Если устройство не подключено к сети, следует воздержаться от обновлений, чтобы продлить время его работы от батареи.
Если заряд батареи практически исчерпан, можно снизить частоту обновлений (вплоть до их полного прекращения).
-
Определение текущего состояния зарядки
-
+
Определение текущего состояния зарядки
+
Начните с определения текущего состояния зарядки. {@link android.os.BatteryManager} передает все сведения о батарее и зарядке в закрепленном намерении {@link android.content.Intent}, которое содержит также информацию о состоянии зарядки.
Поскольку это намерение является закрепленным, регистрировать {@link android.content.BroadcastReceiver} не нужно. Чтобы получить текущее состояние батареи в виде намерения, нужно вызвать {@code registerReceiver}, передав {@code null} в качестве приемника, как показано в коде ниже. Можно также передать фактический объект {@link android.content.BroadcastReceiver}, но это необязательно, поскольку обработка обновлений будет выполняться позднее.
Как правило, если устройство подключено к сети переменного тока, фоновые обновления можно выполнять с максимальной частотой. Если устройство заряжается через USB, частоту можно несколько сократить, а если устройство не подключено к сети – сократить еще больше.
-
Отслеживание изменений состояния зарядки
+
Отслеживание изменений состояния зарядки
Состояние зарядки изменяется всякий раз, когда пользователь подключает устройство к источнику питания. Поскольку это случается довольно часто, важно отслеживать изменения этого состояния и соответствующим образом корректировать частоту обновления приложения.
public class PowerConnectionReceiver extends BroadcastReceiver {
@Override
- public void onReceive(Context context, Intent intent) {
+ public void onReceive(Context context, Intent intent) {
int status = intent.getIntExtra(BatteryManager.EXTRA_STATUS, -1);
boolean isCharging = status == BatteryManager.BATTERY_STATUS_CHARGING ||
status == BatteryManager.BATTERY_STATUS_FULL;
-
+
int chargePlug = intent.getIntExtra(BatteryManager.EXTRA_PLUGGED, -1);
boolean usbCharge = chargePlug == BATTERY_PLUGGED_USB;
boolean acCharge = chargePlug == BATTERY_PLUGGED_AC;
@@ -87,7 +87,7 @@ boolean acCharge = chargePlug == BATTERY_PLUGGED_AC;
}
-
Определение текущего уровня заряда батареи
+
Определение текущего уровня заряда батареи
В некоторых случаях целесообразно определять текущий уровень заряда батареи. Если он ниже определенного значения, частоту фоновых обновлений следует уменьшить.
Чаще всего повторяющиеся оповещения и фоновые службы используются для планового обновления приложения из Интернета, кэширования или загрузки больших объемов данных. Однако если подключение к Интернету не установлено или скорость соединения слишком низкая, выполнять загрузку не имеет смысла.
Проверить наличие подключения к Интернету и его тип можно с помощью {@link android.net.ConnectivityManager}.
-
Определение наличия подключения к Интернету
-
+
Определение наличия подключения к Интернету
+
Если подключение отсутствует, нет смысла планировать обновление из Интернета. В приведенном ниже коде показано, как использовать {@link android.net.ConnectivityManager} для отправки запросов об активной сети и определять возможности подключения.
Когда обновления отключены, необходимо отслеживать изменения доступных соединений, чтобы возобновить их сразу после подключения устройства к Интернету.
-
Отслеживание изменения возможностей подключения
+
Отслеживание изменения возможностей подключения
{@link android.net.ConnectivityManager} передает действие {@link android.net.ConnectivityManager#CONNECTIVITY_ACTION} ({@code "android.net.conn.CONNECTIVITY_CHANGE"}) при каждом изменении сведений о подключении. Зарегистрируйте в манифесте приемник широковещательных намерений, чтобы отслеживать эти изменения и запускать (или приостанавливать) фоновые обновления соответствующим образом.
Устройства под управлением ОС Android можно подключать к нескольким типам док-станций: настольным, которые делятся на цифровые и аналоговые, и автомобильным. В большинстве случаев устройства заряжаются при подключении к док-станции, поэтому состояние подключения к док-станции часто связано с состоянием зарядки.
Состояние подключения к док-станции также передается в виде закрепленного намерения {@link android.content.Intent}, что позволяет запрашивать сведения о наличии подключения к док-станции и ее типе.
-
Определение текущего состояния подключения к док-станции
-
+
Определение текущего состояния подключения к док-станции
+
Сведения о состоянии подключения к док-станции передаются в качестве дополнительных данных в закрепленном оповещении действия {@link android.content.Intent#ACTION_DOCK_EVENT}. Поскольку это закрепленное намерение, регистрировать {@link android.content.BroadcastReceiver} не требуется. Достаточно вызвать {@link android.content.Context#registerReceiver registerReceiver()}, передав {@code null} в качестве приемника широковещательных намерений, как показано в коде ниже.
Обратите внимание, что последние два типа поддерживаются только на уровне API 11, поэтому, даже если вас не интересует, является ли док-станция цифровой или аналоговой, а интересует только ее тип, рекомендуется выполнять проверку по всем трем типам:
Отслеживание изменений состояния подключения к док-станции и ее типа
+
Отслеживание изменений состояния подключения к док-станции и ее типа
При каждом подключении устройства к док-станции или отключении от нее передается действие {@link android.content.Intent#ACTION_DOCK_EVENT}. Чтобы отслеживать состояние подключения к док-станции, достаточно зарегистрировать в манифесте приложения приемник широковещательных намерений, как показано ниже.
Качественное приложение должно оказывать минимальное влияние на время работы устройства от батареи. В этом уроке вы научитесь создавать приложения, способные изменять функционал и режим работы в зависимости от состояния устройства.
Отключение обновления данных фоновых служб при потере подключения и снижение частоты обновления при низком заряде батареи позволяет снизить расход энергии и продлить работу устройства без подзарядки.
Приемники широковещательных намерений, объявленные в манифесте, можно включать и отключать во время работы приложения. Это позволяет отключать ненужные приемники в зависимости от состояния устройства. Вы узнаете, как повысить эффективность путем включения, отключения или каскадирования приемников изменения состояния и как отложить действие до момента перехода устройства в заданное состояние.
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/ru/training/monitoring-device-state/manifest-receivers.jd b/docs/html-intl/intl/ru/training/monitoring-device-state/manifest-receivers.jd
index 724ee93e28223..2bd0fb93658e7 100644
--- a/docs/html-intl/intl/ru/training/monitoring-device-state/manifest-receivers.jd
+++ b/docs/html-intl/intl/ru/training/monitoring-device-state/manifest-receivers.jd
@@ -9,7 +9,7 @@ previous.link=connectivity-monitoring.html
@jd:body
-
Самый простой способ отслеживать изменения состояния устройства – создать приемники {@link android.content.BroadcastReceiver} для каждого отслеживаемого состояния и зарегистрировать их в манифесте приложения. Затем в каждом из этих приемников можно переопределять график повторяющихся оповещений в зависимости от текущего состояния устройства.
Этот способ имеет недостатки: приложение активирует устройство при каждом запуске любого из этих приемников, что далеко не всегда оправданно.
Оптимальный вариант – включать и выключать приемники широковещательных намерений во время работы приложения. Это позволяет использовать приемники, объявленные в манифесте, как пассивные оповещения, которые инициируются системными событиями только в случае необходимости.
-
-
Включение, отключение и каскадирование приемников изменения состояния для повышения эффективности
-
+
+
Включение, отключение и каскадирование приемников изменения состояния для повышения эффективности
+
{@link android.content.pm.PackageManager} позволяет включать и выключать любые компоненты, определенные в манифесте, в том числе все приемники широковещательных намерений:
Алгоритм пользовательского интерфейса зависит от макета, который в данный момент отображается. Например, если приложение работает в двухпанельном режиме, то при нажатии на элемент в левой панели содержание отобразится в правой. В однопанельном режиме содержание откроется отдельно (в другой активности).
@@ -56,7 +56,7 @@ public class NewsReaderActivity extends FragmentActivity {
setContentView(R.layout.main_layout);
View articleView = findViewById(R.id.article);
- mIsDualPane = articleView != null &&
+ mIsDualPane = articleView != null &&
articleView.getVisibility() == View.VISIBLE;
}
}
@@ -116,7 +116,7 @@ public void onCreate(Bundle savedInstanceState) {
else {
/* use list navigation (spinner) */
actionBar.setNavigationMode(android.app.ActionBar.NAVIGATION_MODE_LIST);
- SpinnerAdapter adap = new ArrayAdapter(this,
+ SpinnerAdapter adap = new ArrayAdapter(this,
R.layout.headline_item, CATEGORIES);
actionBar.setListNavigationCallbacks(adap, handler);
}
@@ -168,7 +168,7 @@ public class HeadlinesFragment extends ListFragment {
public class HeadlinesFragment extends ListFragment {
...
@Override
- public void onItemClick(AdapterView<?> parent,
+ public void onItemClick(AdapterView<?> parent,
View view, int position, long id) {
if (null != mHeadlineSelectedListener) {
mHeadlineSelectedListener.onHeadlineSelected(position);
diff --git a/docs/html-intl/intl/ru/training/multiscreen/index.jd b/docs/html-intl/intl/ru/training/multiscreen/index.jd
index 84b9b8b5bdf06..66cf968edf9b9 100644
--- a/docs/html-intl/intl/ru/training/multiscreen/index.jd
+++ b/docs/html-intl/intl/ru/training/multiscreen/index.jd
@@ -7,10 +7,10 @@ next.link=screensizes.html
@jd:body
-
-
-
-
Требования
+
+
+
+
Требования
Android 1.6 или более поздней версии (для запуска учебного приложения требуется версия 2.1 или более поздняя)
На платформе Android работают устройства с самыми разными размерами экрана: от телефонов до телевизоров. Чтобы с вашим приложением могли работать как можно больше пользователей, оно должно корректно отображаться на всех этих устройствах.
Однако совместимость с разными типами устройств – это еще не все. От размера экрана зависит, какие возможности будет иметь пользователь при работе с приложением. Чтобы пользователи действительно остались довольны вашим приложением, оно должно не просто поддерживать разные экраны, но и быть оптимизировано для каждого из них.
Примечание. В этом модуле и в учебном приложении используется вспомогательная библиотека, позволяющая работать с API {@link android.app.Fragment} в версиях до Android 3.0. Чтобы иметь возможность использовать все необходимые API, загрузите библиотеку и добавьте ее в свое приложение.
В этом уроке рассказывается, как создать макет, который адаптируется к разным размерам экрана, используя масштабируемые представления, объекты {@link android.widget.RelativeLayout}, квалификаторы размера и ориентации, фильтры псевдонимов и растровые изображений формата nine-patch.
В этом уроке рассказывается, как работать с экранами разного разрешения с помощью не зависящих от разрешения пикселей и как подготовить растровые изображения для каждого из них.
В этом уроке рассказывается, как реализовать алгоритм работы интерфейса, адаптирующийся к размеру и разрешению экрана, то есть способный определять активный макет во время выполнения приложения, выбирать дальнейшие действия на основе текущего макета и обрабатывать изменения конфигурации экрана.
В этом уроке рассказывается, как создать макет, который адаптируется к разным размерам экрана, используя масштабируемые представления, объекты {@link android.widget.RelativeLayout}, квалификаторы размера и ориентации, фильтры псевдонимов и растровые изображений формата nine-patch.
В этом уроке рассказывается, как работать с экранами разного разрешения с помощью не зависящих от разрешения пикселей и как подготовить растровые изображения для каждого из них.
В этом уроке рассказывается, как реализовать алгоритм работы интерфейса, адаптирующийся к размеру и разрешению экрана, то есть способный определять активный макет во время выполнения приложения, выбирать дальнейшие действия на основе текущего макета и обрабатывать изменения конфигурации экрана.
В этом уроке рассказывается, как создать интерфейс, поддерживающий разные разрешения экрана, за счет использования разных ресурсов и не зависящих от разрешения единиц измерения.
@@ -48,8 +48,8 @@ next.link=adaptui.html
Например, если вы задаете расстояние между двумя представлениями, рекомендуется использовать dp, а не px:
В этом уроке описаны следующие аспекты обеспечения совместимости интерфейса с разными экранами:
-
-
обеспечение способности макета адаптироваться к размеру экрана;
-
выбор макета интерфейса, отвечающего конфигурации экрана;
+
+
обеспечение способности макета адаптироваться к размеру экрана;
+
выбор макета интерфейса, отвечающего конфигурации экрана;
контроль правильности применяемого макета;
-
использование масштабируемых растровых изображений.
-
+
использование масштабируемых растровых изображений.
+
-
Использование параметров wrap_content и match_parent
+
Использование параметров wrap_content и match_parent
Чтобы создать масштабируемый макет, способный адаптироваться к разным экранам, используйте в качестве значений ширины и высоты отдельных компонентов представления параметры "wrap_content" и "match_parent". Если используется "wrap_content", для ширины или высоты представления устанавливается минимальное значение, позволяющее уместить содержание на экран, а параметр "match_parent" (известный как "fill_parent" в API до 8 уровня) служит для растягивания компонента по размеру родительского представления.
@@ -65,7 +65,7 @@ next.link=screendensities.html
Рисунок 1. Приложение News Reader при вертикальной (слева) и горизонтальной (справа) ориентации.
-
Использование объекта RelativeLayout
+
Использование объекта RelativeLayout
С помощью вложенных экземпляров объекта {@link android.widget.LinearLayout} и параметров "wrap_content" и "match_parent" можно создавать достаточно сложные макеты. Однако {@link android.widget.LinearLayout} не дает возможности точно управлять взаимным расположением дочерних представлений: в {@link android.widget.LinearLayout} они просто помещаются в ряд друг за другом. Если необходимо расположить дочерние представления иным образом, используйте объект {@link android.widget.RelativeLayout}, позволяющий задать относительные позиции компонентов. Например, одно дочернее представление можно выровнять по левому краю экрана, а другое – по правому.
Обратите внимание: несмотря на изменение размера компонентов их взаимное расположение остается прежним, так как оно задано объектом {@link android.widget.RelativeLayout.LayoutParams}.
-
-
Использование квалификаторов размера
+
+
Использование квалификаторов размера
Масштабируемые или относительные макеты, один из которых продемонстрирован выше, имеют свои ограничения. Хотя они позволяют создать интерфейс, способный адаптироваться к разным экранам за счет растягивания пространства внутри и вокруг компонентов, пользователю может оказаться не слишком удобно работать с таким интерфейсом. Поэтому в приложении должен использоваться не один масштабируемый макет, а несколько альтернативных вариантов для разных конфигураций экрана. Их можно создать с помощью квалификаторов конфигураций, которые позволяют оперативно выбирать ресурсы, отвечающие текущим параметрам экрана (например, разные варианты макетов для экранов разных размеров).
Следует учесть, что на Android-устройствах до версии 3.2 квалификатор sw600dp не будет работать, поэтому для них по-прежнему нужно использовать large. Таким образом, вам потребуется еще один файл с названием res/layout-large/main.xml, идентичный файлу res/layout-sw600dp/main.xml. В следующем разделе вы познакомитесь с методом, который позволяет избежать дублирования таких файлов макета.
-
Использование псевдонимов макетов
+
Использование псевдонимов макетов
Квалификатор Smallest-width работает только на устройствах Android 3.2 или более поздних версий. Для совместимости с более ранними устройствами по-прежнему следует использовать абстрактные размеры (small, normal, large и xlarge). Например, чтобы интерфейс открывался в однопанельном режиме на телефонах и в многопанельном на планшетных ПК с 7-дюймовым экраном, телевизорах и других крупных устройствах, подготовьте следующие файлы:
@@ -202,7 +202,7 @@ next.link=screendensities.html
{@code large}, а для более новых – sw600dp).
-
Использование квалификаторов ориентации
+
Использование квалификаторов ориентации
Хотя некоторые макеты одинаково хорошо смотрятся в вертикальной и горизонтальной ориентациях, в большинстве случаев интерфейс все же приходится адаптировать. Ниже показано, как изменяется макет в приложении News Reader в зависимости от размера и ориентации экрана.
diff --git a/docs/html-intl/intl/vi/design/patterns/navigation.jd b/docs/html-intl/intl/vi/design/patterns/navigation.jd
index 98490db0e5b63..a3d6003dd4169 100644
--- a/docs/html-intl/intl/vi/design/patterns/navigation.jd
+++ b/docs/html-intl/intl/vi/design/patterns/navigation.jd
@@ -168,7 +168,7 @@ cần chụp ảnh có thể kích hoạt ứng dụng Camera, ứng dụng này
thông tin và tất cả hành động liên kết mà người dùng có thể thực hiện. Ứng dụng của bạn là tập hợp
của nhiều hoạt động, bao gồm cả hoạt động do bạn tạo và hoạt động mà bạn sử dụng lại từ các ứng dụng khác.
-
Tác vụ là trình tự các hoạt động mà một người dùng tuân theo để hoàn thành một mục tiêu.
+
Tác vụ là trình tự các hoạt động mà một người dùng tuân theo để hoàn thành một mục tiêu.
Tác vụ đơn có thể sử dụng các hoạt động từ chỉ một ứng dụng, hoặc có thể dựa trên hoạt động từ nhiều
ứng dụng khác nhau.
diff --git a/docs/html-intl/intl/vi/guide/components/activities.jd b/docs/html-intl/intl/vi/guide/components/activities.jd
index 83e7669a7f767..304b73c879952 100644
--- a/docs/html-intl/intl/vi/guide/components/activities.jd
+++ b/docs/html-intl/intl/vi/guide/components/activities.jd
@@ -57,7 +57,7 @@ hoạt động có thể bắt đầu một hoạt động khác để thực hi
mới bắt đầu, hoạt động trước đó sẽ bị dừng lại, nhưng hệ thống vẫn giữ nguyên hoạt động
trong một ngăn xếp ("back stack"). Khi một hoạt động mới bắt đầu, nó được đẩy lên ngăn xếp và
chiếm lấy tiêu điểm của người dùng. Ngăn xếp sẽ tuân theo cơ chế xếp chồng cơ bản "vào cuối, ra đầu",
-vì thế, khi người dùng kết thúc hoạt động hiện tại và nhấn nút Quay lại, nó
+vì thế, khi người dùng kết thúc hoạt động hiện tại và nhấn nút Quay lại, nó
sẽ được đẩy ra khỏi ngăn xếp (và bị hủy) và hoạt động trước đó sẽ tiếp tục. (Ngăn xếp được
đề cập kỹ hơn trong tài liệu Tác vụ
và Ngăn Xếp.)
@@ -139,7 +139,7 @@ setContentView()}.
Khai báo hoạt động trong bản kê khai
Bạn phải khai báo hoạt động của mình trong tệp bản kê khai để hoạt động
-có thể truy cập được vào hệ thống. Để khai báo hoạt động của mình, hãy mở tệp bản kê khai của bạn và thêm một phần tử {@code <activity>}
+có thể truy cập được vào hệ thống. Để khai báo hoạt động của mình, hãy mở tệp bản kê khai của bạn và thêm một phần tử {@code <activity>}
làm con của phần tử {@code <application>}
. Ví dụ:
@@ -161,7 +161,7 @@ bạn phát hành ứng dụng của mình, bạn không nên thay đổi tên n
một số tính năng, chẳng hạn như các lối tắt của ứng dụng (hãy đọc bài đăng trên blog, Những Điều
Không Thay Đổi Được).
-
Xem tài liệu tham khảo phần tử {@code <activity>}
để biết thêm thông tin về việc khai báo hoạt động của bạn trong bản kê khai.
@@ -200,7 +200,7 @@ tự mình bắt đầu chúng bằng cách sử dụng các ý định rõ ràn
Tuy nhiên, nếu bạn muốn hoạt động của mình phản hồi lại những ý định ngầm mà được chuyển giao từ
các ứng dụng khác (và chính bạn), thì bạn phải định nghĩa các bộ lọc ý định bổ sung cho hoạt động
của mình. Với mỗi loại ý định mà bạn muốn phản hồi, bạn phải nêu một {@code
-<intent-filter>} bao gồm một phần tử
+<intent-filter>}
Theo cách này, không có "phương pháp" nào để máy khách gọi đối với dịch vụ. Thay vào đó, máy khách
-gửi “thông báo” (đối tượng {@link android.os.Message}) mà dịch vụ nhận được trong
+gửi “thông báo” (đối tượng {@link android.os.Message}) mà dịch vụ nhận được trong
{@link android.os.Handler} của mình.
Sau đây là một dịch vụ ví dụ đơn giản sử dụng một giao diện {@link android.os.Messenger}:
@@ -539,7 +539,7 @@ kỹ hơn ở bên dưới.)
Ví dụ, đoạn mã HTML sau sẽ kết nối máy khách với dịch vụ được tạo bên trên bằng cách
-mở rộng lớp Trình gắn kết, vì vậy tất cả những việc mà nó phải làm là đổi kiểu
+mở rộng lớp Trình gắn kết, vì vậy tất cả những việc mà nó phải làm là đổi kiểu
{@link android.os.IBinder} được trả về thành lớp {@code LocalService} và yêu cầu thực thể {@code
LocalService}:
@@ -148,7 +148,7 @@ của bạn.
khởi tạo các thành phần thiết yếu của phân đoạn mà bạn muốn giữ lại khi phân đoạn
bị tạm dừng hoặc dừng hẳn, sau đó tiếp tục.
Hệ thống sẽ gọi phương pháp này khi đến lúc phân đoạn vẽ giao diện người dùng của nó
+
Hệ thống sẽ gọi phương pháp này khi đến lúc phân đoạn vẽ giao diện người dùng của nó
lần đầu tiên. Để vẽ một UI cho phân đoạn của mình, bạn phải trả về một {@link android.view.View} từ phương pháp
này, đây là gốc của bố trí phân đoạn của bạn. Bạn có thể trả về giá trị rỗng nếu phân đoạn không
cung cấp UI.
@@ -303,7 +303,7 @@ phân đoạn:
Cung cấp thuộc tính {@code android:id} với một ID duy nhất.
Cung cấp thuộc tính {@code android:tag} với một xâu duy nhất.
-
Nếu bạn không cung cấp được thuộc tính nào, hệ thống sẽ sử dụng ID của dạng xem
+
Nếu bạn không cung cấp được thuộc tính nào, hệ thống sẽ sử dụng ID của dạng xem
của bộ chứa.
@@ -362,7 +362,7 @@ findFragmentByTag()}.
Để biết ví dụ về hoạt động sử dụng phân đoạn như một trình thực hiện nền, không có UI, hãy xem mẫu {@code
FragmentRetainInstance.java}, mẫu này có trong các mẫu SDK (có sẵn thông qua
-Trình quản lý SDK Android) và nằm trên hệ thống của bạn như là
+Trình quản lý SDK Android) và nằm trên hệ thống của bạn như là
<sdk_root>/APIDemos/app/src/main/java/com/example/android/apis/app/FragmentRetainInstance.java.
@@ -378,7 +378,7 @@ có nó, hãy gọi {@link android.app.Activity#getFragmentManager()} từ hoạ
Nhận các phân đoạn tồn tại trong hoạt động, bằng {@link
android.app.FragmentManager#findFragmentById findFragmentById()} (đối với các phân đoạn cung cấp UI trong
bố trí hoạt động) hoặc {@link android.app.FragmentManager#findFragmentByTag
-findFragmentByTag()} (đối với các phân đoạn có hoặc không cung cấp UI).
+findFragmentByTag()} (đối với các phân đoạn có hoặc không cung cấp UI).
Lấy phân đoạn ra khỏi ngăn xếp, bằng {@link
android.app.FragmentManager#popBackStack()} (mô phỏng một câu lệnh Quay lại của người dùng).
Đăng ký một đối tượng theo dõi cho những thay đổi đối với ngăn xếp, bằng {@link
@@ -562,9 +562,9 @@ public static class FragmentA extends ListFragment {
}
-
Nếu hoạt động chưa triển khai giao diện, khi đó phân đoạn sẽ đưa ra lỗi
+
Nếu hoạt động chưa triển khai giao diện, khi đó phân đoạn sẽ đưa ra lỗi
{@link java.lang.ClassCastException}.
-Nếu thành công, thành viên {@code mListener} giữ một tham chiếu tới triển khai
+Nếu thành công, thành viên {@code mListener} giữ một tham chiếu tới triển khai
{@code OnArticleSelectedListener}của hoạt động, sao cho phân đoạn A có thể chia sẻ sự kiện với hoạt động bằng cách gọi các phương pháp
được định nghĩa bởi giao diện {@code OnArticleSelectedListener}. Ví dụ, nếu phân đoạn A là một
phần mở rộng của {@link android.app.ListFragment}, mỗi lần
@@ -785,7 +785,7 @@ android.widget.FrameLayout}), hoặc bắt đầu một hoạt động mới (t
Phân đoạn thứ hai, {@code DetailsFragment} sẽ hiển thị tóm tắt vở kịch cho mục được chọn từ
danh sách trong {@code TitlesFragment}:
Nhớ lại ở lớp {@code TitlesFragment} rằng, nếu người dùng nhấp vào một mục danh sách và bố trí
@@ -798,7 +798,7 @@ tóm tắt vở kịch được chọn khi màn hình ở hướng đứng:
Lưu ý rằng hoạt động này tự kết thúc nếu cấu hình là khổ ngang, sao cho hoạt động
chính có thể chiếm lấy và hiển thị {@code DetailsFragment} bên cạnh {@code TitlesFragment}.
Điều này có thể xảy ra nếu người dùng bắt đầu {@code DetailsActivity} ở dạng hướng đứng, nhưng
diff --git a/docs/html-intl/intl/vi/guide/components/fundamentals.jd b/docs/html-intl/intl/vi/guide/components/fundamentals.jd
index 4b70140723d95..725c68dacb686 100644
--- a/docs/html-intl/intl/vi/guide/components/fundamentals.jd
+++ b/docs/html-intl/intl/vi/guide/components/fundamentals.jd
@@ -295,16 +295,16 @@ android.app.Activity} và các thuộc tính {@code android:label} quy định m
Bạn phải khai báo tất cả thành phần của ứng dụng như sau:
Các phần tử <activity>
+href="{@docRoot}guide/topics/manifest/activity-element.html"><activity>
cho hoạt động
Các phần tử <receiver>
+href="{@docRoot}guide/topics/manifest/receiver-element.html"><receiver>
cho hàm nhận quảng bá
Các phần tử <provider>
+href="{@docRoot}guide/topics/manifest/provider-element.html"><provider>
cho trình cung cấp nội dung
@@ -379,7 +379,7 @@ chúng, nhưng các dịch vụ bên ngoài như Google Play thì có đọc đ
cho người dùng khi họ tìm kiếm ứng dụng từ thiết bị của mình.
Ví dụ, nếu ứng dụng của bạn yêu cầu máy ảnh và sử dụng các API được giới thiệu trong Android 2.1 (API Mức 7),
-bạn cần khai báo những điều này như yêu cầu trong tệp bản kê khai của mình như sau:
+bạn cần khai báo những điều này như yêu cầu trong tệp bản kê khai của mình như sau:
<manifest ... >
diff --git a/docs/html-intl/intl/vi/guide/components/index.jd b/docs/html-intl/intl/vi/guide/components/index.jd
index 966597d999c20..87b51c2849b02 100644
--- a/docs/html-intl/intl/vi/guide/components/index.jd
+++ b/docs/html-intl/intl/vi/guide/components/index.jd
@@ -1,7 +1,7 @@
page.title=Thành phần Ứng dụng
page.landing=true
-page.landing.intro=Khuôn khổ ứng dụng của Android cho phép bạn tạo lập nhiều ứng dụng đa dạng và sáng tạo bằng cách sử dụng một tập hợp các thành phần có thể tái sử dụng. Phần này giải thích cách bạn có thể xây dựng các thành phần định nghĩa các khối dựng cho ứng dụng của mình và cách kết nối chúng với nhau bằng cách sử dụng ý định.
-page.metaDescription=Khuôn khổ ứng dụng của Android cho phép bạn tạo lập nhiều ứng dụng đa dạng và sáng tạo bằng cách sử dụng một tập hợp các thành phần có thể tái sử dụng. Phần này giải thích cách bạn có thể xây dựng các thành phần định nghĩa các khối dựng cho ứng dụng của mình và cách kết nối chúng với nhau bằng cách sử dụng ý định.
+page.landing.intro=Khuôn khổ ứng dụng của Android cho phép bạn tạo lập nhiều ứng dụng đa dạng và sáng tạo bằng cách sử dụng một tập hợp các thành phần có thể tái sử dụng. Phần này giải thích cách bạn có thể xây dựng các thành phần định nghĩa các khối dựng cho ứng dụng của mình và cách kết nối chúng với nhau bằng cách sử dụng ý định.
+page.metaDescription=Khuôn khổ ứng dụng của Android cho phép bạn tạo lập nhiều ứng dụng đa dạng và sáng tạo bằng cách sử dụng một tập hợp các thành phần có thể tái sử dụng. Phần này giải thích cách bạn có thể xây dựng các thành phần định nghĩa các khối dựng cho ứng dụng của mình và cách kết nối chúng với nhau bằng cách sử dụng ý định.
page.landing.image=images/develop/app_components.png
page.image=images/develop/app_components.png
@@ -11,7 +11,7 @@ page.image=images/develop/app_components.png
tạo lại sau khi cấu hình thay đổi. Vì thế, chúng không cần truy vấn lại dữ liệu
của mình.
-
+
Tổng quan về API Trình tải
Có nhiều lớp và giao diện có thể có liên quan trong khi sử dụng
@@ -129,10 +129,10 @@ của {@link android.content.Loader} hoặc {@link android.content.AsyncTaskLoad
dữ liệu từ một số nguồn khác.
Một triển khai cho {@link android.app.LoaderManager.LoaderCallbacks}.
Đây là nơi bạn tạo trình tải mới và quản lý các tham chiếu của mình tới các
-trình tải hiện có.
+trình tải hiện có.
Một cách để hiển thị dữ liệu của trình tải, chẳng hạn như {@link
android.widget.SimpleCursorAdapter}.
-
Một nguồn dữ liệu, chẳng hạn như một {@link android.content.ContentProvider}, khi sử dụng một
+
Một nguồn dữ liệu, chẳng hạn như một {@link android.content.ContentProvider}, khi sử dụng một
{@link android.content.CursorLoader}.
{@link android.app.LoaderManager} quản lý một hoặc nhiều thực thể {@link
android.content.Loader} trong một {@link android.app.Activity} hoặc
{@link android.app.Fragment}. Chỉ có một {@link
-android.app.LoaderManager} trên mỗi hoạt động hoặc phân đoạn.
+android.app.LoaderManager} trên mỗi hoạt động hoặc phân đoạn.
Thông thường, bạn
sẽ khởi tạo một {@link android.content.Loader} bên trong phương pháp {@link
@@ -157,13 +157,13 @@ tham số sau:
Một ID duy nhất xác định trình tải. Trong ví dụ này, ID là 0.
Các tham đối tùy chọn để cung cấp cho trình tải khi
-xây dựng (null trong ví dụ này).
+xây dựng (null trong ví dụ này).
-
Triển khai {@link android.app.LoaderManager.LoaderCallbacks}, phương pháp mà
+
Triển khai {@link android.app.LoaderManager.LoaderCallbacks}, phương pháp mà
{@link android.app.LoaderManager} gọi để báo cáo các sự kiện trình tải. Trong ví dụ này
, lớp cục bộ triển khai giao diện {@link
android.app.LoaderManager.LoaderCallbacks}, vì thế nó chuyển một tham chiếu
-tới chính nó, {@code this}.
+tới chính nó, {@code this}.
Lệnh gọi {@link android.app.LoaderManager#initLoader initLoader()} đảm bảo rằng một trình tải
được khởi tạo và hiện hoạt. Nó có hai kết quả có thể xảy ra:
@@ -193,7 +193,7 @@ vòng đời của trình tải. {@link android.app.LoaderManager}
khởi động và dừng tải khi cần và duy trì trạng thái của trình tải
và nội dung đi kèm của nó. Như hàm ý, bạn hiếm khi tương tác trực tiếp với các trình tải
(thông qua một ví dụ về việc sử dụng các phương pháp trình tải để tinh chỉnh hành vi
-của một trình tải, hãy xem ví dụ LoaderThrottle).
+của một trình tải, hãy xem ví dụ LoaderThrottle).
Bạn thường sử dụng nhất là các phương pháp {@link
android.app.LoaderManager.LoaderCallbacks} để can thiệp vào tiến trình tải
khi diễn ra một sự kiện đặc biệt. Để thảo luận thêm về chủ đề này, hãy xem phần Sử dụng Phương pháp Gọi lại LoaderManager.
@@ -245,7 +245,7 @@ Khởi tạo và trả về một {@link android.content.Loader} mới cho ID đ
— Được gọi khi một trình tải được tạo trước đó đã hoàn tất việc tải.
{@link android.app.LoaderManager.LoaderCallbacks#onLoaderReset onLoaderReset()}
— Được gọi khi một trình tải được tạo trước đó đang được đặt lại, vì thế mà khiến dữ liệu
của nó không sẵn có.
Phương pháp này được gọi khi một trình tải được tạo trước đó đã hoàn thành việc tải của mình.
Phương pháp này được bảo đảm sẽ được gọi trước khi giải phóng dữ liệu cuối cùng
được cung cấp cho trình tải này. Tại điểm này, bạn nên loại bỏ mọi trường hợp sử dụng
-dữ liệu cũ (do nó sẽ được giải phóng sớm), nhưng không nên
+dữ liệu cũ (do nó sẽ được giải phóng sớm), nhưng không nên
tự mình giải phóng dữ liệu do trình tải sở hữu dữ liệu và sẽ đảm nhận việc này.
Phương pháp này được gọi khi một trình tải được tạo trước đó đang được đặt lại, vì thế mà khiến
+
Phương pháp này được gọi khi một trình tải được tạo trước đó đang được đặt lại, vì thế mà khiến
dữ liệu của nó không sẵn có. Lệnh gọi lại này cho phép bạn tìm hiểu xem khi nào thì dữ liệu
sẽ được giải phóng để bạn có thể loại bỏ tham chiếu của mình tới nó.
-
Sự triển khai này gọi ra
-{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}
+
Sự triển khai này gọi ra
+{@link android.widget.SimpleCursorAdapter#swapCursor swapCursor()}
với một giá trị null:
@@ -366,7 +366,7 @@ public void onLoaderReset(Loader<Cursor> loader) {
android.app.Fragment} có chức năng hiển thị một {@link android.widget.ListView} chứa
kết quả của một truy vấn đối với trình cung cấp nội dung danh bạ. Nó sử dụng một {@link
android.content.CursorLoader} để quản lý truy vấn trên trình cung cấp.
-
+
Để một ứng dụng truy cập danh bạ của một người dùng, như minh họa trong ví dụ này, bản kê khai
của nó phải bao gồm quyền
{@link android.Manifest.permission#READ_CONTACTS READ_CONTACTS}.
diff --git a/docs/html-intl/intl/vi/guide/components/processes-and-threads.jd b/docs/html-intl/intl/vi/guide/components/processes-and-threads.jd
index 390ca156a1f05..b9933edc07fe9 100644
--- a/docs/html-intl/intl/vi/guide/components/processes-and-threads.jd
+++ b/docs/html-intl/intl/vi/guide/components/processes-and-threads.jd
@@ -120,7 +120,7 @@ bắt buộc để đảm bảo giao diện người dùng có phản hồi.
Nó lưu trữ một {@link android.app.Activity} mà không nằm trong tiền cảnh, nhưng vẫn
-hiển thị với người dùng (phương pháp {@link android.app.Activity#onPause onPause()} của nó đã được gọi).
+hiển thị với người dùng (phương pháp {@link android.app.Activity#onPause onPause()} của nó đã được gọi).
Điều này có thể xảy ra, ví dụ, nếu hoạt động tiền cảnh đã bắt đầu một hộp thoại, nó cho phép
hoạt động trước được nhìn thấy phía sau nó.
@@ -202,7 +202,7 @@ gọi lại của hệ thống (chẳng hạn như {@link android.view.View#onKe
hoặc một phương pháp gọi lại vòng đời) sẽ luôn chạy trong luồng UI của tiến trình.
Ví dụ, khi người dùng chạm vào một nút trên màn hình, luồng UI của ứng dụng của bạn sẽ phân phối
-sự kiện chạm tới widget, đến lượt mình, widget sẽ đặt trạng thái được nhấn và đăng một yêu cầu vô hiệu hóa tới
+sự kiện chạm tới widget, đến lượt mình, widget sẽ đặt trạng thái được nhấn và đăng một yêu cầu vô hiệu hóa tới
hàng đợi sự kiện. Luồng UI loại yêu cầu khỏi hàng đợi và thông báo với widget rằng nó nên tự vẽ lại
.
@@ -319,7 +319,7 @@ private class DownloadImageTask extends AsyncTask<String, Void, Bitmap> {
protected Bitmap doInBackground(String... urls) {
return loadImageFromNetwork(urls[0]);
}
-
+
/** The system calls this to perform work in the UI thread and delivers
* the result from doInBackground() */
protected void onPostExecute(Bitmap result) {
diff --git a/docs/html-intl/intl/vi/guide/components/recents.jd b/docs/html-intl/intl/vi/guide/components/recents.jd
index 0a176145f9caa..271c05d9142e9 100644
--- a/docs/html-intl/intl/vi/guide/components/recents.jd
+++ b/docs/html-intl/intl/vi/guide/components/recents.jd
@@ -180,7 +180,7 @@ sau khi người dùng mở một tài liệu bằng ứng dụng:
bất kỳ hoạt động nào mà người dùng đã gọi ra cuối cùng.
-
Lưu ý: Đối với những giá trị ngoài {@code none} và {@code never}
+
Lưu ý: Đối với những giá trị ngoài {@code none} và {@code never}
hoạt động phải được định nghĩa bằng {@code launchMode="standard"}. Nếu thuộc tính này không được quy định thì
{@code documentLaunchMode="none"} sẽ được sử dụng.
@@ -191,7 +191,7 @@ hoàn thành. Bạn có thể khống chế hành vi này bằng lớp {@link an
bằng một cờ {@link android.content.Intent}, hoặc bằng một thuộc tính
<activity>.
-
Bạn có thể luôn loại trừ hoàn toàn một tác vụ khỏi màn hình tổng quan bằng cách thiết đặt thuộc tính
+
Thông báo cửa sổ là một thông báo xuất hiện một lúc trên bề mặt của cửa sổ hiện tại
+
Thông báo cửa sổ là một thông báo xuất hiện một lúc trên bề mặt của cửa sổ hiện tại
rồi biến mất, trong khi thông báo thanh trạng thái cung cấp một biểu tượng trong thanh trạng thái cùng một
thông báo, người dùng có thể chọn nó để thực hiện một hành động (chẳng hạn như bắt đầu một hoạt động).
diff --git a/docs/html-intl/intl/vi/guide/components/tasks-and-back-stack.jd b/docs/html-intl/intl/vi/guide/components/tasks-and-back-stack.jd
index 85afffff5ba54..76df1dd2e075f 100644
--- a/docs/html-intl/intl/vi/guide/components/tasks-and-back-stack.jd
+++ b/docs/html-intl/intl/vi/guide/components/tasks-and-back-stack.jd
@@ -190,7 +190,7 @@ trạng thái của các hoạt động của mình bằng cách sử dụng cá
Khi hệ thống dừng một trong các hoạt động của bạn (chẳng hạn như khi một hoạt động mới bắt đầu hoặc tác vụ
di chuyển về nền), hệ thống có thể hoàn toàn hủy hoạt động đó nếu nó cần khôi phục
-bộ nhớ hệ thống. Khi điều này xảy ra, thông tin về trạng thái của hoạt động sẽ bị mất. Nếu điều này xảy ra,
+bộ nhớ hệ thống. Khi điều này xảy ra, thông tin về trạng thái của hoạt động sẽ bị mất. Nếu điều này xảy ra,
hệ thống vẫn
biết rằng hoạt động có một vị trí trong ngăn xếp, nhưng khi hoạt động được đưa tới vị trí trên cùng
của chồng, hệ thống phải tạo lại nó (thay vì tiếp tục). Để tránh
@@ -314,7 +314,7 @@ hoạt động nằm trên cùng của ngăn xếp không phải là m
Ví dụ, giả sử ngăn xếp của một tác vụ bao gồm hoạt động gốc A với các hoạt động B, C,
và D ở trên cùng (chồng là A-B-C-D; D ở trên cùng). Một ý định đến cho loại hoạt động D.
Nếu D có chế độ khởi chạy {@code "standard"} mặc định, một thực thể mới của lớp sẽ được khởi chạy và
-chồng trở thành A-B-C-D-D. Tuy nhiên, nếu chế độ khởi chạy của D là {@code "singleTop"}, thực thể hiện tại
+chồng trở thành A-B-C-D-D. Tuy nhiên, nếu chế độ khởi chạy của D là {@code "singleTop"}, thực thể hiện tại
của D sẽ nhận ý định thông qua {@link
android.app.Activity#onNewIntent onNewIntent()}, bởi nó nằm ở vị trí trên cùng của chồng—chồng
vẫn là A-B-C-D. Tuy nhiên, nếu một ý định đến cho hoạt động loại B, khi đó một thực thể
@@ -557,9 +557,9 @@ tác vụ mới và người dùng dành một khoảng thời gian làm việc
. Lúc này, tác vụ được gửi tới nền và không hiển thị. Bây giờ, người dùng không có cách nào để quay lại
tác vụ bởi nó không được biểu diễn trong trình khởi chạy ứng dụng.
-
Đối với những trường hợp mà bạn không muốn người dùng có thể quay lại một hoạt động, hãy đặt giá trị của phần tử
+
Đối với những trường hợp mà bạn không muốn người dùng có thể quay lại một hoạt động, hãy đặt giá trị của phần tử
<activity>
-,
+,
{@code finishOnTaskLaunch}
thành {@code "true"} (xem Xóa chồng).
diff --git a/docs/html-intl/intl/vi/guide/topics/manifest/manifest-intro.jd b/docs/html-intl/intl/vi/guide/topics/manifest/manifest-intro.jd
index ca2ed26270f2b..06668b4c685c3 100644
--- a/docs/html-intl/intl/vi/guide/topics/manifest/manifest-intro.jd
+++ b/docs/html-intl/intl/vi/guide/topics/manifest/manifest-intro.jd
@@ -31,27 +31,27 @@ page.title=Bản kê khai Ứng dụng
Nó đặt tên gói Java cho ứng dụng.
Tên gói đóng vai trò như một mã nhận diện duy nhất cho ứng dụng.
-
Nó mô tả các thành phần của ứng dụng — hoạt động,
-dịch vụ, hàm nhận quảng bá, và trình cung cấp nội dung mà ứng dụng
-được soạn bởi. Nó đặt tên các lớp triển khai từng thành phần và
-công bố các khả năng của chúng (ví dụ, những tin nhắn {@link android.content.Intent
-Intent} mà chúng có thể xử lý). Những khai báo này cho phép hệ thống Android
+
Nó mô tả các thành phần của ứng dụng — hoạt động,
+dịch vụ, hàm nhận quảng bá, và trình cung cấp nội dung mà ứng dụng
+được soạn bởi. Nó đặt tên các lớp triển khai từng thành phần và
+công bố các khả năng của chúng (ví dụ, những tin nhắn {@link android.content.Intent
+Intent} mà chúng có thể xử lý). Những khai báo này cho phép hệ thống Android
biết các thành phần là gì và chúng có thể được khởi chạy trong những điều kiện nào.
-
Nó xác định những tiến trình nào sẽ lưu trữ các thành phần ứng dụng.
+
Nó xác định những tiến trình nào sẽ lưu trữ các thành phần ứng dụng.
-
Nó khai báo các quyền mà ứng dụng phải có để
-truy cập các phần được bảo vệ của API và tương tác với các ứng dụng khác.
+
Nó khai báo các quyền mà ứng dụng phải có để
+truy cập các phần được bảo vệ của API và tương tác với các ứng dụng khác.
-
Nó cũng khai báo các quyền mà ứng dụng khác phải có để
+
Nó cũng khai báo các quyền mà ứng dụng khác phải có để
tương tác với các thành phần của ứng dụng.
-
Nó liệt kê các lớp {@link android.app.Instrumentation} cung cấp
-tính năng tạo hồ sơ và các thông tin khác khi ứng dụng đang chạy. Những khai báo này
-chỉ xuất hiện trong bản kê khai khi ứng dụng đang được phát triển và
+
Nó liệt kê các lớp {@link android.app.Instrumentation} cung cấp
+tính năng tạo hồ sơ và các thông tin khác khi ứng dụng đang chạy. Những khai báo này
+chỉ xuất hiện trong bản kê khai khi ứng dụng đang được phát triển và
thử nghiệm; chúng bị loại bỏ trước khi ứng dụng được công bố.
-
Nó khai báo mức tối thiểu của API Android mà ứng dụng
+
Nó khai báo mức tối thiểu của API Android mà ứng dụng
yêu cầu.
Nó liệt kê các thư viện mà ứng dụng phải được liên kết với.
@@ -61,12 +61,12 @@ yêu cầu.
Cấu trúc của Tệp Bản kê khai
-Sơ đồ bên dưới minh họa cấu trúc chung của tệp bản kê khai và mọi
-phần tử mà nó có thể chứa. Từng phần tử, cùng với tất cả thuộc tính
-của mình, sẽ được lập tài liệu theo dõi đầy đủ vào một tệp riêng. Để xem thông tin
-chi tiết về mọi phần tử, hãy nhấp vào tên phần tử trong sơ đồ,
+Sơ đồ bên dưới minh họa cấu trúc chung của tệp bản kê khai và mọi
+phần tử mà nó có thể chứa. Từng phần tử, cùng với tất cả thuộc tính
+của mình, sẽ được lập tài liệu theo dõi đầy đủ vào một tệp riêng. Để xem thông tin
+chi tiết về mọi phần tử, hãy nhấp vào tên phần tử trong sơ đồ,
trong danh sách các phần tử theo thứ tự chữ cái mà tuân theo sơ đồ, hoặc trên bất kỳ
-nội dung nào khác đề cập tới tên phần tử.
+nội dung nào khác đề cập tới tên phần tử.
@@ -126,9 +126,9 @@ nội dung nào khác đề cập tới tên phần tử.
-Tất cả phần tử có thể xuất hiện trong tệp bản kê khai được liệt kê ở bên dưới
-theo thứ tự chữ cái. Đây là những phần tử hợp pháp duy nhất; bạn không thể
-thêm các phần tử hay thuộc tính của chính mình.
+Tất cả phần tử có thể xuất hiện trong tệp bản kê khai được liệt kê ở bên dưới
+theo thứ tự chữ cái. Đây là những phần tử hợp pháp duy nhất; bạn không thể
+thêm các phần tử hay thuộc tính của chính mình.
@@ -158,74 +158,74 @@ thêm các phần tử hay thuộc tính của chính mình.
-
+
Các Quy ước Tệp
-Một số quy ước và quy tắc áp dụng chung cho tất cả các phần tử và thuộc tính
+Một số quy ước và quy tắc áp dụng chung cho tất cả các phần tử và thuộc tính
trong bản kê khai:
Phần tử
-
Chỉ các phần tử
+
Chỉ các phần tử
<manifest> và
-<application>
-là bắt buộc phải có, chúng đều phải có mặt và chỉ có thể xảy ra một lần.
-Hầu hết các phần tử khác có thể xảy ra nhiều lần hoặc không xảy ra — mặc dù ít
-nhất một vài trong số chúng phải có mặt để bản kê khai thực sự có
+<application>
+là bắt buộc phải có, chúng đều phải có mặt và chỉ có thể xảy ra một lần.
+Hầu hết các phần tử khác có thể xảy ra nhiều lần hoặc không xảy ra — mặc dù ít
+nhất một vài trong số chúng phải có mặt để bản kê khai thực sự có
ý nghĩa nào đó.
-Nếu một phần tử chứa bất kỳ nội dung nào, nó có thể chứa các phần tử khác.
+Nếu một phần tử chứa bất kỳ nội dung nào, nó có thể chứa các phần tử khác.
Tất cả giá trị sẽ được đặt thông qua thuộc tính, chứ không phải là dữ liệu ký tự trong một phần tử.
Các phần tử cùng cấp thường không theo thứ tự. Ví dụ, các phần tử
-<activity>,
-<provider>, và
-<service>
-có thể được trộn lẫn với nhau theo bất kỳ trình tự nào. (Phần tử
+<activity>,
+<provider>, và
+<service>
+có thể được trộn lẫn với nhau theo bất kỳ trình tự nào. (Phần tử
<activity-alias>
-là trường hợp ngoại lệ đối với quy tắc này: Nó phải tuân theo
-<activity>
+là trường hợp ngoại lệ đối với quy tắc này: Nó phải tuân theo
+<activity>
, đối tượng mà nó là bí danh cho.)
Thuộc tính
-
Theo cách hiểu thông thường, tất cả thuộc tính đều mang tính tùy chọn. Tuy nhiên, có một số thuộc tính
-phải được quy định cho một phần tử để hoàn thành mục đích của nó. Sử dụng
+
Theo cách hiểu thông thường, tất cả thuộc tính đều mang tính tùy chọn. Tuy nhiên, có một số thuộc tính
+phải được quy định cho một phần tử để hoàn thành mục đích của nó. Sử dụng
tài liệu làm hướng dẫn. Đối với những thuộc tính thực sự tùy chọn, nó đề cập tới một giá trị
mặc định hoặc thông báo điều gì sẽ xảy ra nếu không có một đặc tả.
-
Ngoài một số thuộc tính của phần tử
-<manifest>
-gốc, tất cả tên thuộc tính đều bắt đầu bằng một tiền tố {@code android:}—
-ví dụ, {@code android:alwaysRetainTaskState}. Do tiền tố này
-phổ dụng, tài liệu thường bỏ sót nó khi tham chiếu tới các thuộc tính
+
Ngoài một số thuộc tính của phần tử
+<manifest>
+gốc, tất cả tên thuộc tính đều bắt đầu bằng một tiền tố {@code android:}—
+ví dụ, {@code android:alwaysRetainTaskState}. Do tiền tố này
+phổ dụng, tài liệu thường bỏ sót nó khi tham chiếu tới các thuộc tính
theo tên.
Khai báo tên lớp
-
Nhiều thuộc tính tương ứng với các đối tượng Java, bao gồm các phần tử cho
-chính ứng dụng (phần tử
-<application>
-) và các thành phần chính của nó — hoạt động
-(<activity>),
-dịch vụ
-(<service>),
-hàm nhận quảng bá
-(<receiver>),
-và trình cung cấp nội dung
-(<provider>).
+
Nhiều thuộc tính tương ứng với các đối tượng Java, bao gồm các phần tử cho
+chính ứng dụng (phần tử
+<application>
+) và các thành phần chính của nó — hoạt động
+(<activity>),
+dịch vụ
+(<service>),
+hàm nhận quảng bá
+(<receiver>),
+và trình cung cấp nội dung
+(<provider>).
-Nếu bạn định nghĩa một lớp con như vẫn luôn làm đối với lớp thành phần
-({@link android.app.Activity}, {@link android.app.Service},
-{@link android.content.BroadcastReceiver}, và {@link android.content.ContentProvider}),
-lớp con sẽ được khai báo thông qua một thuộc tính {@code name}. Tên phải bao gồm
-chỉ định gói đầy đủ.
+Nếu bạn định nghĩa một lớp con như vẫn luôn làm đối với lớp thành phần
+({@link android.app.Activity}, {@link android.app.Service},
+{@link android.content.BroadcastReceiver}, và {@link android.content.ContentProvider}),
+lớp con sẽ được khai báo thông qua một thuộc tính {@code name}. Tên phải bao gồm
+chỉ định gói đầy đủ.
Ví dụ, một lớp con {@link android.app.Service} có thể được khai báo như sau:
@@ -239,12 +239,12 @@ Ví dụ, một lớp con {@link android.app.Service} có thể được khai b
</manifest>
-Tuy nhiên, do cách viết tốc ký, nếu ký tự đầu tiên của xâu là một dấu chấm,
-xâu sẽ được nối với tên gói của ứng dụng (như được quy định bởi
-thuộc tính của phần tử <manifest>
+Tuy nhiên, do cách viết tốc ký, nếu ký tự đầu tiên của xâu là một dấu chấm,
+xâu sẽ được nối với tên gói của ứng dụng (như được quy định bởi
+thuộc tính của phần tử <manifest>
-, package
-). Cách gán sau cũng giống như trên:
+, package
+). Cách gán sau cũng giống như trên:
<manifest package="com.example.project" . . . >
@@ -257,13 +257,13 @@ thuộc tính của phần tử {@code @[gói:]kiểu:tên}
Trường hợp giá trị của một thuộc tính là một xâu, phải sử dụng hai dấu xuyệc ngược ('{@code \\}')
-để thoát các ký tự — ví dụ, '{@code \\n}' đối với
+
Trường hợp giá trị của một thuộc tính là một xâu, phải sử dụng hai dấu xuyệc ngược ('{@code \\}')
+để thoát các ký tự — ví dụ, '{@code \\n}' đối với
một dòng tin tức hoặc '{@code \\uxxxx}' đối với một ký tự Unicode.
@@ -308,7 +308,7 @@ một dòng tin tức hoặc '{@code \\uxxxx}' đối với một ký tự Unico
Các Tính năng Tệp
-Phần sau đây mô tả cách phản ánh một số tính năng của Android
+Phần sau đây mô tả cách phản ánh một số tính năng của Android
trong tệp bản kê khai.
@@ -316,23 +316,23 @@ trong tệp bản kê khai.
Bộ lọc Ý định
-Các thành phần cốt lõi của một ứng dụng (hoạt động, dịch vụ và hàm nhận
-quảng bá) được kích hoạt bởi ý định. Ý định là một
-gói thông tin (một đối tượng {@link android.content.Intent}) mô tả một
-hành động mong muốn — bao gồm dữ liệu sẽ được dựa trên, thể loại của
-thành phần mà sẽ thực hiện hành động, và các chỉ dẫn thích hợp khác.
-Android định vị một thành phần phù hợp để hồi đáp ý định, khởi chạy
-một thực thể mới của thành phần nếu cần, và chuyển cho nó đối tượng đó
+Các thành phần cốt lõi của một ứng dụng (hoạt động, dịch vụ và hàm nhận
+quảng bá) được kích hoạt bởi ý định. Ý định là một
+gói thông tin (một đối tượng {@link android.content.Intent}) mô tả một
+hành động mong muốn — bao gồm dữ liệu sẽ được dựa trên, thể loại của
+thành phần mà sẽ thực hiện hành động, và các chỉ dẫn thích hợp khác.
+Android định vị một thành phần phù hợp để hồi đáp ý định, khởi chạy
+một thực thể mới của thành phần nếu cần, và chuyển cho nó đối tượng đó
Ý định.
-Các thành phần sẽ quảng cáo khả năng của mình — các kiểu ý định mà chúng có thể
-hồi đáp — thông qua các bộ lọc ý định. Do hệ thống Android phải
-tìm hiểu một thành phần có thể xử lý những ý định nào trước khi khởi chạy thành phần đó,
-bộ lọc ý định được quy định trong bản kê khai như là các phần tử
+Các thành phần sẽ quảng cáo khả năng của mình — các kiểu ý định mà chúng có thể
+hồi đáp — thông qua các bộ lọc ý định. Do hệ thống Android phải
+tìm hiểu một thành phần có thể xử lý những ý định nào trước khi khởi chạy thành phần đó,
+bộ lọc ý định được quy định trong bản kê khai như là các phần tử
<intent-filter>
-. Một thành phần có thể có nhiều bộ lọc, mỗi bộ lọc lại mô tả
+. Một thành phần có thể có nhiều bộ lọc, mỗi bộ lọc lại mô tả
một khả năng khác nhau.
-Nhiều phần tử có thuộc tính {@code icon} và {@code label} cho một
-biểu tượng nhỏ và nhãn văn bản mà có thể được hiển thị với người dùng. Một số cũng có thuộc tính
-{@code description} cho văn bản giải trình dài hơn mà cũng có thể
-được hiển thị trên màn hình. Ví dụ, phần tử
+Nhiều phần tử có thuộc tính {@code icon} và {@code label} cho một
+biểu tượng nhỏ và nhãn văn bản mà có thể được hiển thị với người dùng. Một số cũng có thuộc tính
+{@code description} cho văn bản giải trình dài hơn mà cũng có thể
+được hiển thị trên màn hình. Ví dụ, phần tử
<permission>
-có cả ba thuộc tính này, vì thế khi người dùng được hỏi xem có
-cấp quyền cho một ứng dụng yêu cầu hay không, biểu tượng thể hiện
+có cả ba thuộc tính này, vì thế khi người dùng được hỏi xem có
+cấp quyền cho một ứng dụng yêu cầu hay không, biểu tượng thể hiện
quyền, tên của quyền, và mô tả nội dung
của quyền đó đều có thể được trình bày cho người dùng xem.
-Trong mọi trường hợp, biểu tượng và nhãn được đặt trong một phần tử chứa sẽ trở thành các thiết đặt
-{@code icon} và {@code label} mặc định cho tất cả phần tử con của bộ chứa đó.
-Vì thế, biểu tượng và nhãn được đặt trong phần tử
-<application>
-là biểu tượng và nhãn mặc định cho từng thành phần của ứng dụng.
-Tương tự, biểu tượng và nhãn được đặt cho một thành phần — ví dụ, một phần tử
-<activity>
-— sẽ là các cài đặt mặc định cho từng phần tử
-<intent-filter>
+Trong mọi trường hợp, biểu tượng và nhãn được đặt trong một phần tử chứa sẽ trở thành các thiết đặt
+{@code icon} và {@code label} mặc định cho tất cả phần tử con của bộ chứa đó.
+Vì thế, biểu tượng và nhãn được đặt trong phần tử
+<application>
+là biểu tượng và nhãn mặc định cho từng thành phần của ứng dụng.
+Tương tự, biểu tượng và nhãn được đặt cho một thành phần — ví dụ, một phần tử
+<activity>
+— sẽ là các cài đặt mặc định cho từng phần tử
+<intent-filter>
của thành phần đó. Nếu một phần tử
-<application>
-thiết đặt một nhãn, nhưng hoạt động và bộ lọc ý định của nó thì không,
-nhãn ứng dụng sẽ được coi là nhãn của cả hoạt động và
+<application>
+thiết đặt một nhãn, nhưng hoạt động và bộ lọc ý định của nó thì không,
+nhãn ứng dụng sẽ được coi là nhãn của cả hoạt động và
bộ lọc ý định.
-Biểu tượng và nhãn được đặt cho một bộ lọc ý định sẽ được sử dụng để biểu diễn một thành phần
+Biểu tượng và nhãn được đặt cho một bộ lọc ý định sẽ được sử dụng để biểu diễn một thành phần
bất cứ khi nào thành phần đó được trình bày với người dùng để thực hiện chức năng
-mà bộ lọc đã quảng cáo. Ví dụ, một bộ lọc với các thiết đặt
-"{@code android.intent.action.MAIN}" và
-"{@code android.intent.category.LAUNCHER}" quảng cáo một hoạt động
+mà bộ lọc đã quảng cáo. Ví dụ, một bộ lọc với các thiết đặt
+"{@code android.intent.action.MAIN}" và
+"{@code android.intent.category.LAUNCHER}" quảng cáo một hoạt động
là hoạt động khởi đầu một ứng dụng — cụ thể, là
-hoạt động sẽ được hiển thị trong trình khởi chạy ứng dụng. Vì thế, biểu tượng và nhãn
+hoạt động sẽ được hiển thị trong trình khởi chạy ứng dụng. Vì thế, biểu tượng và nhãn
được đặt trong bộ lọc là những nội dung được hiển thị trong trình khởi chạy.
@@ -397,14 +397,14 @@ hoạt động sẽ được hiển thị trong trình khởi chạy ứng dụn
Quyền
-Một quyền là sự hạn chế giới hạn truy cập vào một phần của mã
-hoặc vào dữ liệu trên thiết bị. Giới hạn này được áp đặt nhằm bảo vệ dữ liệu
-và mã trọng yếu, có thể bị lạm dụng để bóp méo hoặc làm hỏng trải nghiệm người dùng.
+Một quyền là sự hạn chế giới hạn truy cập vào một phần của mã
+hoặc vào dữ liệu trên thiết bị. Giới hạn này được áp đặt nhằm bảo vệ dữ liệu
+và mã trọng yếu, có thể bị lạm dụng để bóp méo hoặc làm hỏng trải nghiệm người dùng.
-Mỗi quyền được nhận biết bằng một nhãn duy nhất. Thông thường, nhãn cho biết
-hành động bị hạn chế. Ví dụ, sau đây là một số quyền được định nghĩa
+Mỗi quyền được nhận biết bằng một nhãn duy nhất. Thông thường, nhãn cho biết
+hành động bị hạn chế. Ví dụ, sau đây là một số quyền được định nghĩa
bởi Android:
@@ -418,25 +418,25 @@ Một tính năng có thể được bảo vệ bởi nhiều nhất một quy
-Nếu một ứng dụng cần truy cập vào một tính năng được bảo vệ bởi một quyền,
-nó phải khai báo rằng nó yêu cầu quyền đó cùng với một phần tử
-<uses-permission>
-trong bản kê khai. Lúc đó, khi ứng dụng được cài đặt trên
-thiết bị, trình cài đặt sẽ xác định xem có cấp quyền
-được yêu cầu hay không bằng cách kiểm tra các thẩm quyền đã ký chứng chỉ
-của ứng dụng và trong một số trường hợp, bằng cách hỏi người dùng.
-Nếu quyền được cấp, ứng dụng có thể sử dụng các tính năng
+Nếu một ứng dụng cần truy cập vào một tính năng được bảo vệ bởi một quyền,
+nó phải khai báo rằng nó yêu cầu quyền đó cùng với một phần tử
+<uses-permission>
+trong bản kê khai. Lúc đó, khi ứng dụng được cài đặt trên
+thiết bị, trình cài đặt sẽ xác định xem có cấp quyền
+được yêu cầu hay không bằng cách kiểm tra các thẩm quyền đã ký chứng chỉ
+của ứng dụng và trong một số trường hợp, bằng cách hỏi người dùng.
+Nếu quyền được cấp, ứng dụng có thể sử dụng các tính năng
được bảo vệ. Nếu không, việc thử truy cập những tính năng đó sẽ thất bại
-mà không có bất kỳ thông báo nào cho người dùng.
+mà không có bất kỳ thông báo nào cho người dùng.
-Một ứng dụng cũng có thể bảo vệ các thành phần của chính nó (hoạt động, dịch vụ,
-hàm nhận quảng bá và trình cung cấp nội dung) bằng các quyền. Nó có thể sử dụng
-bất kỳ quyền nào được định nghĩa bởi Android (được liệt kê trong
-{@link android.Manifest.permission android.Manifest.permission}) hoặc được khai báo
-bởi các ứng dụng khác. Hoặc nó có thể tự định nghĩa quyền của mình. Một quyền mới được khai báo
-bằng phần tử
+Một ứng dụng cũng có thể bảo vệ các thành phần của chính nó (hoạt động, dịch vụ,
+hàm nhận quảng bá và trình cung cấp nội dung) bằng các quyền. Nó có thể sử dụng
+bất kỳ quyền nào được định nghĩa bởi Android (được liệt kê trong
+{@link android.Manifest.permission android.Manifest.permission}) hoặc được khai báo
+bởi các ứng dụng khác. Hoặc nó có thể tự định nghĩa quyền của mình. Một quyền mới được khai báo
+bằng phần tử
<permission>
. Ví dụ, một hoạt động có thể được bảo vệ như sau:
@@ -457,43 +457,43 @@ bằng phần tử
-Lưu ý rằng trong ví dụ này, quyền {@code DEBIT_ACCT} không chỉ
-được khai báo bằng phần tử
+Lưu ý rằng trong ví dụ này, quyền {@code DEBIT_ACCT} không chỉ
+được khai báo bằng phần tử
<permission>
-, việc sử dụng quyền cũng được yêu cầu bằng phần tử
-<uses-permission>
-. Phải yêu cầu sử dụng quyền để các thành phần khác của
-ứng dụng nhằm khởi chạy hoạt động được bảo vệ, mặc dù việc bảo vệ
-do chính ứng dụng áp đặt.
+, việc sử dụng quyền cũng được yêu cầu bằng phần tử
+<uses-permission>
+. Phải yêu cầu sử dụng quyền để các thành phần khác của
+ứng dụng nhằm khởi chạy hoạt động được bảo vệ, mặc dù việc bảo vệ
+do chính ứng dụng áp đặt.
-Trong cùng ví dụ này, nếu thuộc tính {@code permission} được đặt thành một quyền
-được khai báo ở nơi khác
-(chẳng hạn như {@code android.permission.CALL_EMERGENCY_NUMBERS}, sẽ không
-cần phải khai báo lại nó bằng một phần tử
+Trong cùng ví dụ này, nếu thuộc tính {@code permission} được đặt thành một quyền
+được khai báo ở nơi khác
+(chẳng hạn như {@code android.permission.CALL_EMERGENCY_NUMBERS}, sẽ không
+cần phải khai báo lại nó bằng một phần tử
<permission>
-. Tuy nhiên, sẽ vẫn cần phải yêu cầu sử dụng nó bằng
-<uses-permission>.
+. Tuy nhiên, sẽ vẫn cần phải yêu cầu sử dụng nó bằng
+<uses-permission>.
-Phần tử
-<permission-tree>
-sẽ khai báo một vùng tên cho nhóm quyền mà sẽ được định nghĩa trong
-mã. Và
+Phần tử
+<permission-tree>
+sẽ khai báo một vùng tên cho nhóm quyền mà sẽ được định nghĩa trong
+mã. Và
<permission-group>
-sẽ định nghĩa một nhãn cho một tập hợp quyền (cả được khai báo trong bản kê khai bằng phần tử
-<permission>
-và được khai báo ở chỗ khác). Nó chỉ ảnh hưởng tới cách các quyền được
-nhóm lại khi được trình bày với người dùng. Phần tử
+sẽ định nghĩa một nhãn cho một tập hợp quyền (cả được khai báo trong bản kê khai bằng phần tử
+<permission>
+và được khai báo ở chỗ khác). Nó chỉ ảnh hưởng tới cách các quyền được
+nhóm lại khi được trình bày với người dùng. Phần tử
<permission-group>
-không quy định những quyền nào thuộc về nhóm;
+không quy định những quyền nào thuộc về nhóm;
nó chỉ đặt cho nhóm một cái tên. Một quyền được đặt vào nhóm
bằng cách gán tên nhóm với thuộc tính của phần tử
-<permission>
-,
-permissionGroup
+<permission>
+,
+permissionGroup
.
@@ -501,17 +501,17 @@ bằng cách gán tên nhóm với thuộc tính của phần tử
Thư viện
-Mọi ứng dụng đều được liên kết với thư viện Android mặc định, nó
-bao gồm các gói cơ bản để xây dựng ứng dụng (bằng các lớp thông dụng
-chẳng hạn như Hoạt động, Dịch vụ, Ý định, Dạng xem, Nút, Ứng dụng, Trình cung cấp Nội dung,
+Mọi ứng dụng đều được liên kết với thư viện Android mặc định, nó
+bao gồm các gói cơ bản để xây dựng ứng dụng (bằng các lớp thông dụng
+chẳng hạn như Hoạt động, Dịch vụ, Ý định, Dạng xem, Nút, Ứng dụng, Trình cung cấp Nội dung,
v.v.).
-Tuy nhiên, một số gói nằm trong thư viện của chính mình. Nếu ứng dụng của bạn
-sử dụng mã từ bất kỳ gói nào trong những gói này, nó phải công khai yêu cầu được liên kết
-với chúng. Bản kê khai phải chứa một phần tử
-<uses-library>
-riêng để đặt tên cho từng thư viện. (Tên thư viện có thể được tìm thấy trong tài liệu
+Tuy nhiên, một số gói nằm trong thư viện của chính mình. Nếu ứng dụng của bạn
+sử dụng mã từ bất kỳ gói nào trong những gói này, nó phải công khai yêu cầu được liên kết
+với chúng. Bản kê khai phải chứa một phần tử
+<uses-library>
+riêng để đặt tên cho từng thư viện. (Tên thư viện có thể được tìm thấy trong tài liệu
của gói.)
diff --git a/docs/html-intl/intl/vi/guide/topics/providers/calendar-provider.jd b/docs/html-intl/intl/vi/guide/topics/providers/calendar-provider.jd
index e2ecdb32b2e81..c9d779b114834 100644
--- a/docs/html-intl/intl/vi/guide/topics/providers/calendar-provider.jd
+++ b/docs/html-intl/intl/vi/guide/topics/providers/calendar-provider.jd
@@ -42,7 +42,7 @@ page.title=Trình cung cấp Lịch
@@ -63,8 +63,8 @@ các thao tác trên lịch, sự kiện, người dự, nhắc nhở, v.v.
API Trình cung cấp Lịch có thể được sử dụng bởi các ứng dụng và trình điều hợp đồng bộ. Các quy tắc
thay đổi tùy vào loại chương trình đang thực hiện lệnh gọi. Tài liệu này
-tập trung chủ yếu vào việc sử dụng API Trình cung cấp Lịch như một ứng dụng. Để bàn
-về việc các trình điều hợp đồng bộ khác nhau như thế nào, hãy xem phần
+tập trung chủ yếu vào việc sử dụng API Trình cung cấp Lịch như một ứng dụng. Để bàn
+về việc các trình điều hợp đồng bộ khác nhau như thế nào, hãy xem phần
Trình điều hợp Đồng bộ.
@@ -79,17 +79,17 @@ và cũng không cần cung cấp một giao diện người dùng để xem ho
Các trình cung cấp nội dung sẽ lưu trữ dữ liệu và cho phép truy cập
ứng dụng. Trình cung cấp nội dung được nền tảng Android giới thiệu (bao gồm Trình cung cấp Lịch) thường trình bày dữ liệu như một tập hợp gồm nhiều bảng dựa trên một
mô hình cơ sở dữ liệu quan hệ, trong đó mỗi hàng là một bản ghi và mỗi cột là dữ liệu thuộc
một loại và có ý nghĩa cụ thể. Thông qua API Trình cung cấp Lịch, các ứng dụng
và trình điều hợp đồng bộ có thể nhận được quyền truy cập đọc/ghi vào các bảng trong cơ sở dữ liệu là nơi chứa
dữ liệu lịch của người dùng.
-
Mọi trình cung cấp nội dung đều đưa ra một URI công khai (được bẻ dòng như một đối tượng
+
Mọi trình cung cấp nội dung đều đưa ra một URI công khai (được bẻ dòng như một đối tượng
{@link android.net.Uri}
) để xác định tập dữ liệu của nó một cách duy nhất. Trình cung cấp nội dung mà kiểm soát nhiều
- tập dữ liệu (nhiều bảng) sẽ đưa ra một URI riêng cho từng bảng. Tất cả
+ tập dữ liệu (nhiều bảng) sẽ đưa ra một URI riêng cho từng bảng. Tất cả
URI cho trình cung cấp đều bắt đầu bằng xâu "content://". Điều này
sẽ xác định dữ liệu là đang được kiểm soát bởi một trình cung cấp nội dung. Trình cung cấp
Lịch định nghĩa các hằng số cho URI đối với từng lớp (bảng) của nó. Những URI
@@ -113,26 +113,26 @@ các bảng chính và các trường liên kết chúng với nhau.
Bảng này chứa
thông tin riêng của lịch. Mỗi hàng trong bảng này chứa chi tiết của
một lịch duy nhất, chẳng hạn như tên, màu, thông tin đồng bộ, v.v.
{@link android.provider.CalendarContract.Events}
-
+
Bảng này chứa
thông tin riêng theo sự kiện. Mỗi hàng trong bảng có thông tin cho một
sự kiện duy nhất—ví dụ: tiêu đề sự kiện, địa điểm, thời gian bắt đầu
, thời gian kết thúc, v.v. Sự kiện có thể xảy ra một lần hoặc lặp lại nhiều lần. Người dự,
-nhắc nhở, và các tính chất mở rộng được lưu trữ trong các bảng riêng.
-Mỗi mục đều có một {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+nhắc nhở, và các tính chất mở rộng được lưu trữ trong các bảng riêng.
+Mỗi mục đều có một {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
tham chiếu tới {@link android.provider.BaseColumns#_ID} trong bảng Sự kiện.
Bảng này chứa
thời gian bắt đầu và thời gian kết thúc của mỗi lần xảy ra một sự kiện. Mỗi hàng trong bảng này
đại diện cho một lần xảy ra sự kiện. Với các sự kiện xảy ra một lần thì có một ánh xạ 1:1
@@ -141,7 +141,7 @@ của thực thể tới sự kiện. Đối với các sự kiện định kỳ
Bảng này chứa
thông tin về người dự (khách) của sự kiện. Mỗi hàng đại diện một khách duy nhất của
một sự kiện. Nó quy định loại khách và phản hồi tham dự của khách
@@ -149,17 +149,17 @@ cho một sự kiện.
Bảng này chứa
dữ liệu về cảnh báo/thông báo. Mỗi hàng đại diện một cảnh báo duy nhất cho một sự kiện. Một
sự kiện có thể có nhiều nhắc nhở. Số nhắc nhở tối đa của một sự kiện
-được quy định trong
-{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS},
+được quy định trong
+{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS},
được đặt bởi trình điều hợp đồng bộ đang
sở hữu lịch đã cho. Nhắc nhở được quy định bằng số phút trước khi diễn ra sự kiện
và có một phương pháp để xác định cách người dùng sẽ được cảnh báo.
-
+
API Trình cung cấp Lịch được thiết kế để linh hoạt và mạnh mẽ. Đồng
@@ -178,9 +178,9 @@ Lịch.
Trình điều hợp đồng bộ. Trình điều hợp đồng bộ có chức năng đồng bộ dữ liệu lịch
-lên thiết bị của một người dùng bằng một máy chủ hoặc nguồn dữ liệu khác. Trong bảng
+lên thiết bị của một người dùng bằng một máy chủ hoặc nguồn dữ liệu khác. Trong bảng
{@link android.provider.CalendarContract.Calendars} và
-{@link android.provider.CalendarContract.Events},
+{@link android.provider.CalendarContract.Events},
có các cột để cho trình điều hợp đồng bộ sử dụng.
Trình cung cấp và ứng dụng không nên sửa đổi chúng. Trên thực tế, chúng không
hiển thị trừ khi được truy cập như một trình điều hợp đồng bộ. Để biết thêm thông tin về
@@ -209,9 +209,9 @@ phải bao gồm quyền {@link android.Manifest.permission#WRITE_CALENDAR}
Bảng Lịch
-
Bảng {@link android.provider.CalendarContract.Calendars} chứa thông tin chi tiết
+
Bảng {@link android.provider.CalendarContract.Calendars} chứa thông tin chi tiết
cho từng lịch. Các cột
-Lịch sau có thể ghi được bởi cả ứng dụng và trình điều hợp đồng bộ.
+Lịch sau có thể ghi được bởi cả ứng dụng và trình điều hợp đồng bộ.
Để xem danh sách đầy đủ về các trường được hỗ trợ, hãy xem tài liệu tham khảo
{@link android.provider.CalendarContract.Calendars}.
@@ -229,7 +229,7 @@ Lịch sau có thể ghi được bởi cả ứng dụng và Trình tải. Nếu bạn đang không chỉ
+không đồng bộ thay vì trên luồng chính. Để bàn thêm, hãy xem phần
+Trình tải. Nếu bạn đang không chỉ
đọc dữ liệu mà còn sửa đổi nó, hãy xem {@link android.content.AsyncQueryHandler}.
@@ -268,18 +268,18 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
Tại sao bạn phải nêu
ACCOUNT_TYPE?
Nếu bạn truy vấn trên một {@link
android.provider.CalendarContract.Calendars#ACCOUNT_NAME
-Calendars.ACCOUNT_NAME}, bạn cũng phải nêu
+Calendars.ACCOUNT_NAME}, bạn cũng phải nêu
{@link android.provider.CalendarContract.Calendars#ACCOUNT_TYPE Calendars.ACCOUNT_TYPE}
trong lựa chọn. Đó là vì một tài khoản đã cho chỉ
được coi là duy nhất nếu có cả ACCOUNT_NAME và
@@ -289,7 +289,7 @@ trình xác thực tài khoản mà đã được sử dụng khi tài khoản
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} dành cho các lịch
không liên kết với một tài khoản thiết bị. Tài khoản {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} không được
-đồng bộ.
+đồng bộ.
Trong phần tiếp theo của ví dụ, bạn sẽ xây dựng truy vấn của mình. Lựa chọn
@@ -301,58 +301,58 @@ các lịch có ACCOUNT_NAME
đã xem, không chỉ các lịch mà người dùng sở hữu, hãy bỏ qua OWNER_ACCOUNT.
Truy vấn sẽ trả về đối tượng {@link android.database.Cursor}
mà bạn có thể sử dụng để xem xét tập kết quả được trả về bởi truy vấn
-cơ sở dữ liệu. Để bàn thêm về việc sử dụng các truy vấn trong trình cung cấp nội dung,
+cơ sở dữ liệu. Để bàn thêm về việc sử dụng các truy vấn trong trình cung cấp nội dung,
hãy xem phần Trình cung cấp Nội dung.
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
Phần tiếp theo sử dụng con chạy để duyệt qua tập kết quả. Nó sử dụng
các hằng số được thiết lập ngay từ đầu ví dụ để trả về các giá trị
cho mỗi trường.
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
-
+
Sửa đổi một lịch
Để thực hiện cập nhật một lịch, bạn có thể cung cấp {@link
android.provider.BaseColumns#_ID} của lịch hoặc dưới dạng ID được nối vào cho
-Uri
+Uri
-({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
hoặc dưới dạng mục chọn đầu tiên. Lựa chọn
nên bắt đầu bằng "_id=?", và
selectionArg đầu tiên sẽ là {@link
-android.provider.BaseColumns#_ID} của lịch.
+android.provider.BaseColumns#_ID} của lịch.
Bạn cũng có thể thực hiện cập nhật bằng cách mã hóa ID trong URI. Ví dụ này thay đổi tên hiển thị
-của một lịch bằng cách sử dụng phương pháp
+của một lịch bằng cách sử dụng phương pháp
({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
:
@@ -375,7 +375,7 @@ một ứng dụng cần tạo một lịch cục bộ, nó có thể làm đi
chèn lịch dưới dạng một trình điều hợp đồng bộ, sử dụng {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} của {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}.
-{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
+{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
là một loại tài khoản đặc biệt dành cho các lịch không
liên kết với một tài khoản thiết bị. Các lịch loại này không được đồng bộ với một máy chủ. Để
bàn về trình điều hợp đồng bộ, hãy xem phần Trình điều hợp Đồng bộ.
@@ -434,7 +434,7 @@ android.provider.CalendarContract.Events}.
Thời lượng của sự kiện theo định dạng RFC5545.
Ví dụ, giá trị bằng "PT1H" cho biết sự kiện sẽ kéo dài
một giờ và giá trị bằng "P2W" cho biết
@@ -444,39 +444,39 @@ thời lượng là 2 tuần.
Giá trị bằng 1 cho biết sự kiện này chiếm cả ngày, được xác định bởi
múi giờ tại địa phương. Giá trị bằng 0 cho biết đó là một sự kiện thường xuyên mà có thể bắt đầu
và kết thúc vào bất cứ lúc nào trong một ngày.
Ngày lặp lại đối với sự kiện.
- Bạn thường sử dụng {@link android.provider.CalendarContract.EventsColumns#RDATE}
- cùng với {@link android.provider.CalendarContract.EventsColumns#RRULE}
+
Ngày lặp lại đối với sự kiện.
+ Bạn thường sử dụng {@link android.provider.CalendarContract.EventsColumns#RDATE}
+ cùng với {@link android.provider.CalendarContract.EventsColumns#RRULE}
để định nghĩa một tập tổng hợp
các trường hợp xảy ra lặp lại. Để bàn thêm, hãy xem phần RFC5545 spec.
@@ -514,11 +514,11 @@ java.util.TimeZone#getAvailableIDs()}. Lưu ý rằng quy tắc này không áp
bạn đang chèn một sự kiện thông qua Ý định {@link
android.content.Intent#ACTION_INSERT INSERT} như được mô tả trong Sử dụng ý định để chèn một sự kiện—trong kịch bản
đó, một múi giờ mặc định sẽ được cung cấp.
-
+
Đối với các sự kiện không định kỳ, bạn phải đưa vào {@link
android.provider.CalendarContract.EventsColumns#DTEND}.
-
-
+
+
Đối với các sự kiện định kỳ, bạn phải đưa vào một {@link
android.provider.CalendarContract.EventsColumns#DURATION} bên cạnh {@link
android.provider.CalendarContract.EventsColumns#RRULE} hay {@link
@@ -526,9 +526,9 @@ android.provider.CalendarContract.EventsColumns#RDATE}. Lưu ý rằng quy tắc
bạn đang chèn một sự kiện thông qua Ý định {@link
android.content.Intent#ACTION_INSERT INSERT} như được mô tả trong Sử dụng ý định để chèn một sự kiện—trong kịch bản
đó, bạn có thể sử dụng một {@link
-android.provider.CalendarContract.EventsColumns#RRULE} cùng với {@link android.provider.CalendarContract.EventsColumns#DTSTART} và {@link android.provider.CalendarContract.EventsColumns#DTEND}, và ứng dụng Lịch
+android.provider.CalendarContract.EventsColumns#RRULE} cùng với {@link android.provider.CalendarContract.EventsColumns#DTSTART} và {@link android.provider.CalendarContract.EventsColumns#DTEND}, và ứng dụng Lịch
sẽ tự động chuyển nó thành một thời lượng.
-
+
Sau đây là một ví dụ về cách chèn một sự kiện. Ví dụ này đang được thực hiện trong luồng
@@ -539,8 +539,8 @@ thông tin, hãy xem phần {@link android.content.AsyncQueryHandler}.
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -561,7 +561,7 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
@@ -578,14 +578,14 @@ người dự hoặc nhắc nhở vào một sự kiện.
bạn nên sử dụng một Ý định {@link android.content.Intent#ACTION_EDIT EDIT} như được mô tả
trong Sử dụng ý định để chỉnh sửa một sự kiện.
Tuy nhiên, nếu cần, bạn có thể chỉnh sửa sự kiện trực tiếp. Để thực hiện cập nhật
-một Sự kiện, bạn có thể cung cấp _ID của sự kiện
+một Sự kiện, bạn có thể cung cấp _ID của sự kiện
hoặc dưới dạng ID được nối vào cho Uri ({@link
-android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
-hoặc dưới dạng mục chọn đầu tiên.
+android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+hoặc dưới dạng mục chọn đầu tiên.
Lựa chọn nên bắt đầu bằng "_id=?", và
selectionArg đầu tiên nên là _ID của sự kiện. Bạn cũng có thể
thực hiện cập nhật bằng cách sử dụng một lựa chọn không có ID. Sau đây là một ví dụ về cách cập nhật một
-sự kiện. Nó thay đổi tiêu đề của sự kiện bằng cách sử dụng phương pháp
+sự kiện. Nó thay đổi tiêu đề của sự kiện bằng cách sử dụng phương pháp
{@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}
:
@@ -598,7 +598,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -625,22 +625,22 @@ ContentValues values = new ContentValues();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().delete(deleteUri, null, null);
-Log.i(DEBUG_TAG, "Rows deleted: " + rows);
+Log.i(DEBUG_TAG, "Rows deleted: " + rows);
Bảng Người dự
Mỗi hàng của bảng {@link android.provider.CalendarContract.Attendees} đại diện
-cho một người dự hoặc khách duy nhất của một sự kiện. Gọi
-{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
+cho một người dự hoặc khách duy nhất của một sự kiện. Gọi
+{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
sẽ trả về một danh sách người dự cho sự kiện
-với {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} đã cho.
+với {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} đã cho.
{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} này
phải khớp với {@link
-android.provider.BaseColumns#_ID} của một sự kiện cụ thể.
+android.provider.BaseColumns#_ID} của một sự kiện cụ thể.
Bảng sau liệt kê các trường
-có thể ghi được. Khi chèn một người dự mới, bạn phải điền tất cả
+có thể ghi được. Khi chèn một người dự mới, bạn phải điền tất cả
ngoại trừ ATTENDEE_NAME.
@@ -698,7 +698,7 @@ ngoại trừ ATTENDEE_NAME.
Thêm Người dự
Sau đây là một ví dụ về cách thêm một người dự vào một sự kiện. Lưu ý rằng
-{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
là bắt buộc:
@@ -718,17 +718,17 @@ Uri uri = cr.insert(Attendees.CONTENT_URI, values);
Bảng Nhắc nhở
Mỗi hàng của bảng {@link android.provider.CalendarContract.Reminders} đại diện
-cho một nhắc nhở của một sự kiện. Gọi
+cho một nhắc nhở của một sự kiện. Gọi
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()} sẽ trả về một danh sách nhắc nhở cho
-sự kiện với
+sự kiện với
{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID} đã cho.
Bảng sau liệt kê các trường ghi được đối với nhắc nhở. Tất cả đều phải được
đưa vào khi chèn một nhắc nhở mới. Lưu ý rằng các trình điều hợp đồng bộ quy định
các loại nhắc nhở chúng hỗ trợ trong bảng {@link
-android.provider.CalendarContract.Calendars}. Xem
-{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
+android.provider.CalendarContract.Calendars}. Xem
+{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
để biết chi tiết.
@@ -773,16 +773,16 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
Bảng Thực thể
-
Bảng
+
Bảng
{@link android.provider.CalendarContract.Instances} chứa
thời gian bắt đầu và thời gian kết thúc của các lần xảy ra một sự kiện. Mỗi hàng trong bảng này
đại diện cho một lần xảy ra sự kiện. Bảng thực thể không ghi được và chỉ
đưa ra một cách để truy vấn các lần xảy ra sự kiện.
-
Bảng sau liệt kê một số trường mà bạn có thể truy vấn đối với một thực thể. Lưu ý
-rằng múi giờ được định nghĩa bởi
-{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
-và
+
Bảng sau liệt kê một số trường mà bạn có thể truy vấn đối với một thực thể. Lưu ý
+rằng múi giờ được định nghĩa bởi
+{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
+và
{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_INSTANCES}.
Phút bắt đầu của thực thể được xác định từ nửa đêm theo múi giờ
-của Lịch.
+của Lịch.
-
+
@@ -840,7 +840,7 @@ của Lịch.
trong URI. Trong ví dụ này, {@link android.provider.CalendarContract.Instances}
có quyền truy cập trường {@link
android.provider.CalendarContract.EventsColumns#TITLE} thông qua việc
-triển khai giao diện {@link android.provider.CalendarContract.EventsColumns} của nó.
+triển khai giao diện {@link android.provider.CalendarContract.EventsColumns} của nó.
Nói cách khác, {@link
android.provider.CalendarContract.EventsColumns#TITLE} được trả về qua một
chế độ xem cơ sở dữ liệu, chứ không qua việc truy vấn bảng {@link
@@ -853,7 +853,7 @@ public static final String[] INSTANCE_PROJECTION = new String[] {
Instances.BEGIN, // 1
Instances.TITLE // 2
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_BEGIN_INDEX = 1;
@@ -868,7 +868,7 @@ long startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2011, 10, 24, 8, 0);
long endMillis = endTime.getTimeInMillis();
-
+
Cursor cur = null;
ContentResolver cr = getContentResolver();
@@ -883,28 +883,28 @@ ContentUris.appendId(builder, startMillis);
ContentUris.appendId(builder, endMillis);
// Submit the query
-cur = cr.query(builder.build(),
- INSTANCE_PROJECTION,
- selection,
- selectionArgs,
+cur = cr.query(builder.build(),
+ INSTANCE_PROJECTION,
+ selection,
+ selectionArgs,
null);
-
+
while (cur.moveToNext()) {
String title = null;
long eventID = 0;
- long beginVal = 0;
-
+ long beginVal = 0;
+
// Get the field values
eventID = cur.getLong(PROJECTION_ID_INDEX);
beginVal = cur.getLong(PROJECTION_BEGIN_INDEX);
title = cur.getString(PROJECTION_TITLE_INDEX);
-
- // Do something with the values.
- Log.i(DEBUG_TAG, "Event: " + title);
+
+ // Do something with the values.
+ Log.i(DEBUG_TAG, "Event: " + title);
Calendar calendar = Calendar.getInstance();
- calendar.setTimeInMillis(beginVal);
+ calendar.setTimeInMillis(beginVal);
DateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
- Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
+ Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
}
}
@@ -922,9 +922,9 @@ while (cur.moveToNext()) {
- Bạn cũng có thể tham khảo tới URI bằng
-{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
-Để xem một ví dụ về cách sử dụng ý định này, hãy xem Sử dụng ý định để xem dữ liệu lịch.
+ Bạn cũng có thể tham khảo tới URI bằng
+{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
+Để xem một ví dụ về cách sử dụng ý định này, hãy xem Sử dụng ý định để xem dữ liệu lịch.
Mở lịch đến thời gian được chỉ định bởi <ms_since_epoch>.
@@ -935,11 +935,11 @@ while (cur.moveToNext()) {
content://com.android.calendar/events/<event_id>
-
- Bạn cũng có thể tham khảo tới URI bằng
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
+
+ Bạn cũng có thể tham khảo tới URI bằng
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
Để xem một ví dụ về cách sử dụng ý định này, hãy xem Sử dụng ý định để xem dữ liệu lịch.
-
+
Xem sự kiện được chỉ định bởi <event_id>.
@@ -952,12 +952,12 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_EDIT EDIT}
content://com.android.calendar/events/<event_id>
-
- Bạn cũng có thể tham khảo tới URI bằng
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
+
+ Bạn cũng có thể tham khảo tới URI bằng
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
Để xem một ví dụ về cách sử dụng ý định này, hãy xem Sử dụng ý định để chỉnh sửa một sự kiện.
-
-
+
+
Chỉnh sửa sự kiện được chỉ định bởi <event_id>.
@@ -972,11 +972,11 @@ while (cur.moveToNext()) {
{@link android.content.Intent#ACTION_INSERT INSERT}
content://com.android.calendar/events
-
- Bạn cũng có thể tham khảo tới URI bằng
-{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
+
+ Bạn cũng có thể tham khảo tới URI bằng
+{@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}.
Để xem một ví dụ về cách sử dụng ý định này, hãy xem Sử dụng ý định để chèn một sự kiện.
-
+
Xem sự kiện này tính là thời gian bận hay là thời gian rảnh có thể được xếp lại lịch.
-
-
+
+
Các phần sau mô tả cách sử dụng những ý định này.
@@ -1059,23 +1059,23 @@ Events.AVAILABILITY}
Bằng cách này, ứng dụng của bạn thậm chí không cần phải có quyền {@link
android.Manifest.permission#WRITE_CALENDAR} được bao gồm trong tệp bản kê khai của mình.
-
+
Khi người dùng chạy một ứng dụng mà sử dụng cách này, ứng dụng sẽ gửi
chúng tới Lịch để hoàn thành việc thêm một sự kiện. Ý định {@link
android.content.Intent#ACTION_INSERT INSERT} sử dụng các trường phụ thêm để
điền trước vào một mẫu bằng các chi tiết của sự kiện trong Lịch. Khi đó, người dùng có thể
hủy bỏ sự kiện, chỉnh sửa mẫu nếu cần, hoặc lưu sự kiện vào lịch
của mình.
-
+
Sau đây là một đoạn mã HTML lập biểu một sự kiện vào ngày 19/1/2012, diễn ra
từ 7:30 sáng đến 8:30 sáng. Lưu ý điều sau đây về đoạn mã HTML này:
-
Nó quy định {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
+
Nó quy định {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
là Uri.
-
+
Nó sử dụng các trường phụ {@link
android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME
CalendarContract.EXTRA_EVENT_BEGIN_TIME} và {@link
@@ -1083,10 +1083,10 @@ android.provider.CalendarContract#EXTRA_EVENT_END_TIME
CalendarContract.EXTRA_EVENT_END_TIME} để điền trước thời gian của sự kiện
vào mẫu. Các giá trị đối với những thời gian này phải tính bằng mili giây UTC
trôi qua kể từ giờ epoch.
-
+
Nó sử dụng trường phụ {@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}
để cung cấp một danh sách người được mời phân cách bằng dấu phẩy, được chỉ định theo địa chỉ e-mail.
-
+
Calendar beginTime = Calendar.getInstance();
@@ -1158,18 +1158,18 @@ truy cập Trình cung cấp Lịch:
Trình điều hợp đồng bộ cần chỉ định rằng nó là một trình điều hợp đồng bộ bằng cách đặt {@link android.provider.CalendarContract#CALLER_IS_SYNCADAPTER} thành true.
-
-
+
+
Trình điều hợp đồng bộ cần cung cấp một {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_NAME} và một {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} làm tham số truy vấn trong URI.
-
+
Trình điều hợp đồng bộ có quyền truy nhập ghi vào nhiều cột hơn ứng dụng hay widget.
- Ví dụ, một ứng dụng chỉ có thể sửa đổi một vài đặc điểm của một lịch,
+ Ví dụ, một ứng dụng chỉ có thể sửa đổi một vài đặc điểm của một lịch,
chẳng hạn như tên lịch, tên hiển thị, thiết đặt hiển thị, và lịch có được
đồng bộ hay không. Nếu so sánh, một trình điều hợp đồng bộ có thể truy cập không chỉ những cột đó, mà còn nhiều cột khác,
chẳng hạn như màu lịch, múi giờ, mức truy nhập, địa điểm, v.v.
-Tuy nhiên, trình điều hợp đồng bộ bị hạn chế đối với ACCOUNT_NAME và
+Tuy nhiên, trình điều hợp đồng bộ bị hạn chế đối với ACCOUNT_NAME và
ACCOUNT_TYPE mà nó quy định.
Sau đây là một phương pháp hữu ích hơn mà bạn có thể sử dụng để trả về một URI để dùng với một trình điều hợp đồng bộ:
@@ -1180,5 +1180,5 @@ Tuy nhiên, trình điều hợp đồng bộ bị hạn chế đối với
-
Để biết việc triển khai mẫu trình điều hợp đồng bộ (không liên quan cụ thể tới Lịch), hãy xem phần
+
Để biết việc triển khai mẫu trình điều hợp đồng bộ (không liên quan cụ thể tới Lịch), hãy xem phần
SampleSyncAdapter.
diff --git a/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd b/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd
index 2fa2ed3c9bdf9..2d94e10c7ab8a 100644
--- a/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd
+++ b/docs/html-intl/intl/vi/guide/topics/providers/contacts-provider.jd
@@ -253,7 +253,7 @@ page.title=Trình cung cấp Danh bạ
Ví dụ, nếu bạn muốn ứng dụng của mình duy trì dữ liệu danh bạ cho dịch vụ dựa trên nền web của mình
với miền {@code com.example.dataservice}, và tài khoản của người dùng cho dịch vụ của bạn
là {@code becky.sharp@dataservice.example.com}, trước tiên, người dùng phải thêm
- "loại" tài khoản ({@code com.example.dataservice}) và "tên" tài khoản
+ "loại" tài khoản ({@code com.example.dataservice}) và "tên" tài khoản
({@code becky.smart@dataservice.example.com}) trước khi ứng dụng của bạn có thể thêm hàng liên lạc thô.
Bạn có thể giải thích yêu cầu này với người dùng bằng tài liệu, hoặc bạn có thể nhắc
người dùng thêm loại và tên này, hoặc cả hai. Loại tài khoản và tên tài khoản
@@ -1697,7 +1697,7 @@ startActivity(insertIntent);
Nếu dịch vụ chấp nhận thông tin xác thực, trình xác thực có thể
lưu giữ thông tin xác thực đó để sử dụng sau. Vì khuôn khổ trình xác thực bổ trợ,
- {@link android.accounts.AccountManager} có thể cung cấp quyền truy cập bất kỳ token xác thực nào mà một trình xác thực
+ {@link android.accounts.AccountManager} có thể cung cấp quyền truy cập bất kỳ token xác thực nào mà một trình xác thực
hỗ trợ và chọn hiện ra, chẳng hạn như token xác thực OAuth2.
@@ -1821,7 +1821,7 @@ mà cung cấp dữ liệu cụ thể cho
Dữ liệu từ Luồng Xã hội
- Các bảng {@code android.provider.ContactsContract.StreamItems} và
+ Các bảng {@code android.provider.ContactsContract.StreamItems} và
{@code android.provider.ContactsContract.StreamItemPhotos} quản lý
dữ liệu đến từ các mạng xã hội. Bạn có thể ghi một trình điều hợp đồng bộ mà thêm dữ liệu luồng từ
mạng của chính mình vào những bảng này, hoặc bạn có thể đọc dữ liệu luồng từ những bảng này và
@@ -1830,7 +1830,7 @@ mà cung cấp dữ liệu cụ thể cho
Văn bản từ luồng xã hội
- Các mục dòng dữ liệu luôn được liên kết với một liên lạc thô.
+ Các mục dòng dữ liệu luôn được liên kết với một liên lạc thô.
{@code android.provider.ContactsContract.StreamItemsColumns#RAW_CONTACT_ID} liên kết với giá trị
_ID của liên lạc thô mới. Loại tài khoản và tên tài khoản của liên lạc thô
cũng được lưu giữ trong hàng mục dòng.
@@ -1934,7 +1934,7 @@ mà cung cấp dữ liệu cụ thể cho
Cột này có sẵn để tương thích ngược với các phiên bản trước của Trình cung cấp
Danh bạ mà đã sử dụng nó để lưu giữ ảnh. Tuy nhiên, trong phiên bản hiện tại
bạn không nên sử dụng cột này để lưu giữ ảnh. Thay vào đó, hãy sử dụng
- hoặc {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} hoặc
+ hoặc {@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_FILE_ID} hoặc
{@code android.provider.ContactsContract.StreamItemPhotosColumns#PHOTO_URI} (cả hai
đều được mô tả trong các điểm sau) để lưu giữ ảnh trong một tệp. Lúc này, cột này
chứa một hình thu nhỏ của ảnh sẵn sàng để đọc.
@@ -2344,7 +2344,7 @@ mà cung cấp dữ liệu cụ thể cho
việc truy xuất thông tin ảnh. Không có lớp thuận tiện cho việc truy xuất hình thu nhỏ
chính đối với một liên lạc thô, nhưng bạn có thể gửi một truy vấn tới bảng
{@link android.provider.ContactsContract.Data}, chọn
- {@code android.provider.BaseColumns#_ID} của liên lạc thô,
+ {@code android.provider.BaseColumns#_ID} của liên lạc thô,
{@link android.provider.ContactsContract.CommonDataKinds.Photo#CONTENT_ITEM_TYPE
Photo.CONTENT_ITEM_TYPE}, và cột {@link android.provider.ContactsContract.Data#IS_PRIMARY}
để tìm hàng ảnh chính của liên lạc thô.
diff --git a/docs/html-intl/intl/vi/guide/topics/providers/content-provider-basics.jd b/docs/html-intl/intl/vi/guide/topics/providers/content-provider-basics.jd
index 5f868cacf5aea..808c0f712a34a 100644
--- a/docs/html-intl/intl/vi/guide/topics/providers/content-provider-basics.jd
+++ b/docs/html-intl/intl/vi/guide/topics/providers/content-provider-basics.jd
@@ -236,7 +236,7 @@ page.title=Nội dung Cơ bản về Trình cung cấp Nội dung
Ví dụ, để có một danh sách các từ và nội dung bản địa của chúng từ Trình cung cấp Từ điển Người dùng,
bạn hãy gọi {@link android.content.ContentResolver#query ContentResolver.query()}.
Phương pháp {@link android.content.ContentResolver#query query()} sẽ gọi phương pháp
- {@link android.content.ContentProvider#query ContentProvider.query()} được định nghĩa bởi
+ {@link android.content.ContentProvider#query ContentProvider.query()} được định nghĩa bởi
Trình cung cấp Từ điển Người dùng. Các dòng mã sau thể hiện một lệnh gọi
{@link android.content.ContentResolver#query ContentResolver.query()}:
Bảng 2 cho biết các tham đối tới
- {@link android.content.ContentResolver#query
+ {@link android.content.ContentResolver#query
query(Uri,projection,selection,selectionArgs,sortOrder)} khớp với một câu lệnh SQL SELECT như thế nào:
- sortOrder quy định thứ tự các hàng xuất hiện trong
+ sortOrder quy định thứ tự các hàng xuất hiện trong
{@link android.database.Cursor} được trả về.
@@ -344,7 +344,7 @@ Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
Lưu ý: Các lớp {@link android.net.Uri} và {@link android.net.Uri.Builder}
- chứa các phương pháp thuận tiện để xây dựng đối tượng URI định dạng tốt từ các xâu.
+ chứa các phương pháp thuận tiện để xây dựng đối tượng URI định dạng tốt từ các xâu.
{@link android.content.ContentUris} chứa các phương pháp thuận tiện để nối các giá trị id với
một URI. Đoạn mã HTML trước sử dụng {@link android.content.ContentUris#withAppendedId
withAppendedId()} để nối một id với URI nội dung Từ điển Người dùng.
@@ -359,8 +359,8 @@ withAppendedId()} để nối một id với URI nội dung Từ điển Ngườ
Để giải thích rõ, đoạn mã HTML trong phần này gọi
- {@link android.content.ContentResolver#query ContentResolver.query()} trên "luồng UI"". Tuy nhiên, trong
- mã thực sự, bạn nên thực hiện các truy vấn không đồng bộ trên một luồng riêng. Một cách để làm
+ {@link android.content.ContentResolver#query ContentResolver.query()} trên "luồng UI"". Tuy nhiên, trong
+ mã thực sự, bạn nên thực hiện các truy vấn không đồng bộ trên một luồng riêng. Một cách để làm
điều này đó là sử dụng lớp {@link android.content.CursorLoader}, nó được mô tả chi tiết hơn
trong hướng dẫn
Trình tải. Bênh cạnh đó, các dòng mã chỉ là đoạn mã HTML; chúng không thể hiện một ứng dụng
@@ -428,7 +428,7 @@ String[] mSelectionArgs = {""};
Đoạn mã HTML tiếp theo cho biết cách sử dụng
{@link android.content.ContentResolver#query ContentResolver.query()}, bằng cách sử dụng Trình cung cấp Từ điển
- Người dùng như một ví dụ. Truy vấn máy khách trình cung cấp tương tự như một truy vấn SQL, và nó chứa một
+ Người dùng như một ví dụ. Truy vấn máy khách trình cung cấp tương tự như một truy vấn SQL, và nó chứa một
tập hợp các cột để trả về, một tập hợp các tiêu chí lựa chọn, và một thứ tự sắp xếp.
Biểu thức để chỉ định các hàng cần truy xuất sẽ được chia thành một mệnh đề lựa chọn và
tham đối lựa chọn. Mệnh đề lựa chọn là sự kết hợp giữa các biểu thức lô-gic và biểu thức Boolean,
- tên cột, và giá trị (biến mSelectionClause). Nếu bạn chỉ định
- tham số thay thế được ? thay vì một giá trị, phương pháp truy vấn sẽ truy xuất giá trị
+ tên cột, và giá trị (biến mSelectionClause). Nếu bạn chỉ định
+ tham số thay thế được ? thay vì một giá trị, phương pháp truy vấn sẽ truy xuất giá trị
từ mảng tham đối lựa chọn (biến mSelectionArgs).
- Phương pháp máy khách {@link android.content.ContentResolver#query ContentResolver.query()} luôn trả về
- một {@link android.database.Cursor} chứa các cột được chỉ định bởi dự thảo của
- truy vấn cho các hàng khớp với các tiêu chí lựa chọn của truy vấn. Một đối tượng
- {@link android.database.Cursor} cung cấp truy cập đọc ngẫu nhiên vào các hàng và cột mà nó
- chứa. Bằng cách sử dụng phương pháp {@link android.database.Cursor}, bạn có thể lặp lại các hàng trong
+ Phương pháp máy khách {@link android.content.ContentResolver#query ContentResolver.query()} luôn trả về
+ một {@link android.database.Cursor} chứa các cột được chỉ định bởi dự thảo của
+ truy vấn cho các hàng khớp với các tiêu chí lựa chọn của truy vấn. Một đối tượng
+ {@link android.database.Cursor} cung cấp truy cập đọc ngẫu nhiên vào các hàng và cột mà nó
+ chứa. Bằng cách sử dụng phương pháp {@link android.database.Cursor}, bạn có thể lặp lại các hàng trong
kết quả, xác định kiểu dữ liệu của từng cột, lấy dữ liệu ra khỏi cột, và kiểm tra các tính chất khác
- của kết quả. Một số triển khai {@link android.database.Cursor} sẽ tự động
- cập nhật đối tượng khi dữ liệu của trình cung cấp thay đổi, hoặc kích khởi các phương pháp trong một đối tượng quan sát
+ của kết quả. Một số triển khai {@link android.database.Cursor} sẽ tự động
+ cập nhật đối tượng khi dữ liệu của trình cung cấp thay đổi, hoặc kích khởi các phương pháp trong một đối tượng quan sát
khi {@link android.database.Cursor} thay đổi, hoặc cả hai.
@@ -703,14 +703,14 @@ if (mCursor != null) {
Để nhận các quyền cần để truy cập một trình cung cấp, ứng dụng yêu cầu chúng bằng một phần tử
<uses-permission>
- trong tệp bản kê khai của nó. Khi Trình quản lý Gói Android cài đặt các ứng dụng, người dùng
+ trong tệp bản kê khai của nó. Khi Trình quản lý Gói Android cài đặt các ứng dụng, người dùng
phải phê chuẩn tất cả quyền mà ứng dụng yêu cầu. Nếu người dùng phê chuẩn tất cả quyền, khi đó
Trình quản lý Gói sẽ tiếp tục cài đặt; nếu người dùng không phê chuẩn chúng, Trình quản lý Gói sẽ
hủy bỏ việc cài đặt.
@@ -793,8 +793,8 @@ content://user_dictionary/words/<id_value>
Để cập nhật một hàng, bạn sử dụng một đối tượng {@link android.content.ContentValues} với các giá trị
được cập nhật giống như cách bạn làm với việc chèn, và các tiêu chí lựa chọn giống như cách bạn làm với truy vấn.
Phương pháp máy khách mà bạn sử dụng là
- {@link android.content.ContentResolver#update ContentResolver.update()}. Bạn chỉ cần thêm
- các giá trị vào đối tượng {@link android.content.ContentValues} cho các cột mà bạn đang cập nhật. Nếu bạn
+ {@link android.content.ContentResolver#update ContentResolver.update()}. Bạn chỉ cần thêm
+ các giá trị vào đối tượng {@link android.content.ContentValues} cho các cột mà bạn đang cập nhật. Nếu bạn
muốn xóa các nội dung của một cột, hãy đặt giá trị thành null.
Bạn cũng nên thanh lọc thông tin đầu vào của người dùng khi gọi
- {@link android.content.ContentResolver#update ContentResolver.update()}. Để tìm hiểu thêm về
+ {@link android.content.ContentResolver#update ContentResolver.update()}. Để tìm hiểu thêm về
điều này, hãy đọc phần Bảo vệ trước mục nhập độc hại.
Bạn cũng nên thanh lọc thông tin đầu vào của người dùng khi gọi
- {@link android.content.ContentResolver#delete ContentResolver.delete()}. Để tìm hiểu thêm về
+ {@link android.content.ContentResolver#delete ContentResolver.delete()}. Để tìm hiểu thêm về
điều này, hãy đọc phần Bảo vệ trước mục nhập độc hại.
Truy cập dữ liệu thông qua ý định: Mặc dù không thể gửi một ý định
- trực tiếp tới một trình cung cấp, bạn có thể gửi một ý định tới ứng dụng của trình cung cấp đó,
+ trực tiếp tới một trình cung cấp, bạn có thể gửi một ý định tới ứng dụng của trình cung cấp đó,
đây thường là cách tốt nhất để sửa đổi dữ liệu của trình cung cấp.
@@ -947,14 +947,14 @@ mRowsDeleted = getContentResolver().delete(
bạn tạo một mảng đối tượng {@link android.content.ContentProviderOperation} rồi
phân phối chúng tới một trình cung cấp nội dung bằng
{@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}. Bạn chuyển
- quyền của trình cung cấp nội dung cho phương pháp này thay vì một URI nội dung cụ thể.
+ quyền của trình cung cấp nội dung cho phương pháp này thay vì một URI nội dung cụ thể.
Điều này cho phép đối tượng {@link android.content.ContentProviderOperation} trong mảng có tác dụng
đối với một bảng khác. Một lệnh gọi tới {@link android.content.ContentResolver#applyBatch
ContentResolver.applyBatch()} trả về một mảng kết quả.
Mô tả lớp hợp đồng {@link android.provider.ContactsContract.RawContacts}
- bao gồm một đoạn mã HTML thể hiện việc chèn hàng loạt. Ứng dụng mẫu
+ bao gồm một đoạn mã HTML thể hiện việc chèn hàng loạt. Ứng dụng mẫu
Trình quản lý Danh bạ
có một ví dụ về truy cập hàng loạt trong tệp nguồn ContactAdder.java
của nó.
@@ -1053,7 +1053,7 @@ mRowsDeleted = getContentResolver().delete(
trả kiểm soát về ứng dụng của bạn.
- Hoạt động của bạn trả về tiền cảnh, và hệ thống sẽ gọi phương pháp
+ Hoạt động của bạn trả về tiền cảnh, và hệ thống sẽ gọi phương pháp
{@link android.app.Activity#onActivityResult onActivityResult()}
của hoạt động của bạn. Phương pháp này nhận được ý định kết quả do hoạt động lựa chọn tạo trong
ứng dụng Danh bạ.
diff --git a/docs/html-intl/intl/vi/guide/topics/providers/content-provider-creating.jd b/docs/html-intl/intl/vi/guide/topics/providers/content-provider-creating.jd
index 2e8579a1e92ef..fcc9b0eb60ef0 100644
--- a/docs/html-intl/intl/vi/guide/topics/providers/content-provider-creating.jd
+++ b/docs/html-intl/intl/vi/guide/topics/providers/content-provider-creating.jd
@@ -221,7 +221,7 @@ page.title=Tạo một Trình cung cấp Nội dung
có một trình cung cấp cho phép kết hợp dữ liệu bảng và các tệp.
- Để làm việc với dữ liệu trên nền mạng, hãy sử dụng các lớp trong {@link java.net} và
+ Để làm việc với dữ liệu trên nền mạng, hãy sử dụng các lớp trong {@link java.net} và
{@link android.net}. Bạn cũng có thể đồng bộ hoá dữ liệu trên nền mạng với một kho lưu trữ dữ liệu cục bộ
chẳng hạn như một cơ sở dữ liệu, rồi cung cấp dữ liệu dưới dạng bảng hoặc tệp.
Ứng dụng mẫu
@@ -381,7 +381,7 @@ page.title=Tạo một Trình cung cấp Nội dung
Tài liệu có thể là một tệp mở được (có một kiểu MIME cụ thể), hoặc một
-thư mục chứa các tài liệu bổ sung (có kiểu MIME
+thư mục chứa các tài liệu bổ sung (có kiểu MIME
{@link android.provider.DocumentsContract.Document#MIME_TYPE_DIR}).
Mỗi tài liệu có thể có các khả năng khác nhau như được mô tả bởi
@@ -177,7 +177,7 @@ có thể sử dụng kho lưu trữ đám mây dựa trên tag cho dữ liệu
trực tiếp với nhau. Một máy khách yêu cầu quyền để tương tác
với tệp (cụ thể là quyền đọc, chỉnh sửa, tạo hoặc xóa tệp).
-
Tương tác bắt đầu khi một ứng dụng (trong ví dụ này này một ứng dụng ảnh) thể hiện ý định
+
Tương tác bắt đầu khi một ứng dụng (trong ví dụ này này một ứng dụng ảnh) thể hiện ý định
{@link android.content.Intent#ACTION_OPEN_DOCUMENT} hoặc {@link android.content.Intent#ACTION_CREATE_DOCUMENT}. Ý định có thể bao gồm các bộ lọc
để cụ thể hơn các tiêu chí—ví dụ, "cấp cho tôi tất cả tệp mở được
có kiểu MIME là 'image'."
diff --git a/docs/html-intl/intl/vi/guide/topics/resources/accessing-resources.jd b/docs/html-intl/intl/vi/guide/topics/resources/accessing-resources.jd
index b5491dcdee2c8..0054562cde1a4 100644
--- a/docs/html-intl/intl/vi/guide/topics/resources/accessing-resources.jd
+++ b/docs/html-intl/intl/vi/guide/topics/resources/accessing-resources.jd
@@ -259,8 +259,8 @@ tham chiếu một tài nguyên hệ thống, bạn sẽ cần đưa vào tên g
android:text="@string/hello" />
-
Lưu ý: Bạn nên sử dụng các tài nguyên xâu
-vào mọi lúc, để ứng dụng của bạn có thể được bản địa hóa cho các ngôn ngữ khác.
+
Lưu ý: Bạn nên sử dụng các tài nguyên xâu
+vào mọi lúc, để ứng dụng của bạn có thể được bản địa hóa cho các ngôn ngữ khác.
Để biết thông tin về việc tạo các tài nguyên
thay thế (chẳng hạn như xâu được bản địa hóa), hãy xem phần Cung cấp Tài nguyên
Thay thế. Để được hướng dẫn đầy đủ về việc bản địa hóa ứng dụng của bạn cho các ngôn ngữ khác,
diff --git a/docs/html-intl/intl/vi/guide/topics/resources/providing-resources.jd b/docs/html-intl/intl/vi/guide/topics/resources/providing-resources.jd
index b733643e75cd2..ef1c6b6d4c773 100644
--- a/docs/html-intl/intl/vi/guide/topics/resources/providing-resources.jd
+++ b/docs/html-intl/intl/vi/guide/topics/resources/providing-resources.jd
@@ -190,7 +190,7 @@ phải được lưu ở đây, chẳng hạn như một Chú ý: Không được lưu tệp tài nguyên trực tiếp vào trong thư mục
+
Ngôn ngữ được định nghĩa bằng một mã ngôn ngữ ISO
- 639-1 gồm hai chữ cái, có thể theo sau là một mã khu vực
+ 639-1 gồm hai chữ cái, có thể theo sau là một mã khu vực
ISO
3166-1-alpha-2 dài hai chữ cái (đằng trước là "{@code r}" chữ thường).
@@ -498,7 +498,7 @@ Nhiều Màn hình.
{@code xlarge}: Các màn hình lớn hơn đáng kể so với màn hình
HVGA mật độ trung bình truyền thống. Kích cỡ bố trí tối thiểu đối với một màn hình siêu lớn
bằng xấp xỉ 720x960 đơn vị dp. Trong hầu hết trường hợp, những thiết bị có màn hình
- siêu lớn sẽ quá lớn để mang trong túi và gần như là
+ siêu lớn sẽ quá lớn để mang trong túi và gần như là
thiết bị kiểu máy tính bảng. Được thêm trong API mức 9.
Lưu ý: Việc sử dụng một hạn định kích cỡ không hàm ý rằng các
@@ -510,7 +510,7 @@ bất kỳ tài nguyên nào phù hợp nhất.
ứng dụng của bạn sẽ bị lỗi vào thời gian chạy (ví dụ, nếu tất cả tài nguyên bố trí được gắn thẻ hạn định {@code
xlarge} nhưng thiết bị lại có màn hình kích cỡ bình thường).
Xem thêm trường cấu hình {@link android.content.res.Configuration#screenLayout},
@@ -530,7 +530,7 @@ hay lớn.
{@code notlong}: Màn hình không dài, chẳng hạn như QVGA, HVGA và VGA
Được thêm trong API mức 4.
-
Giá trị này thuần túy được dựa trên tỷ lệ khung ảnh của màn hình (màn hình "dài" sẽ rộng hơn). Nó
+
Giá trị này thuần túy được dựa trên tỷ lệ khung ảnh của màn hình (màn hình "dài" sẽ rộng hơn). Nó
không liên quan tới hướng của màn hình.
Xem thêm trường cấu hình {@link android.content.res.Configuration#screenLayout},
ở đó cho biết màn hình có dài không.
@@ -628,7 +628,7 @@ Mức 8
{@code xxhdpi}: Màn hình mật độ siêu siêu cao; xấp xỉ 480dpi. Được thêm trong API
Mức 16
{@code xxxhdpi}: Mật độ siêu siêu siêu cao sử dụng (chỉ biểu tượng trình khởi chạy, xem
- ghi chú
+ ghi chú
trong Hỗ trợ Nhiều Màn hình); xấp xỉ 640dpi. Được thêm trong API
Mức 18
{@code nodpi}: Loại này có thể được sử dụng cho tài nguyên bitmap mà bạn không muốn được định cỡ
@@ -950,7 +950,7 @@ layout-land/} cho khổ ngang và {@code layout-port/} cho khổ dọc, hãy đ
cấu hình mà bạn chưa nghĩ đến, mà còn bởi các phiên bản Android mới đôi khi thêm
hạn định cấu hình mà những phiên bản cũ hơn không hỗ trợ. Nếu bạn sử dụng một hạn định tài nguyên mới,
nhưng vẫn duy trì tính tương thích về mã với các phiên bản cũ hơn của Android thì khi một phiên bản cũ hơn của
-Android chạy trên ứng dụng của bạn, nó sẽ bị lỗi nếu bạn không cung cấp tài nguyên mặc định, do nó
+Android chạy trên ứng dụng của bạn, nó sẽ bị lỗi nếu bạn không cung cấp tài nguyên mặc định, do nó
không thể sử dụng tài nguyên được đặt tên bằng hạn định mới. Ví dụ, nếu {@code
minSdkVersion} của bạn được đặt bằng 4, và bạn xác định tất cả tài nguyên vẽ được của mình bằng cách sử dụng chế độ ban đêm ({@code night} hoặc {@code notnight}, đã được thêm trong API
Mức 8), khi đó một thiết bị API mức 4 sẽ không thể truy cập tài nguyên vẽ được của bạn và sẽ bị lỗi. Trong trường hợp
diff --git a/docs/html-intl/intl/vi/guide/topics/resources/runtime-changes.jd b/docs/html-intl/intl/vi/guide/topics/resources/runtime-changes.jd
index 4a9c38ccfe605..328b8ec3ad8e9 100644
--- a/docs/html-intl/intl/vi/guide/topics/resources/runtime-changes.jd
+++ b/docs/html-intl/intl/vi/guide/topics/resources/runtime-changes.jd
@@ -82,12 +82,12 @@ hoạt động của mình để giữ lại các đối tượng có trạng th
Để giữ lại các đối tượng có trạng thái trong một phân đoạn trong khi thay đổi cấu hình thời gian chạy:
-
Mở rộng lớp {@link android.app.Fragment} và khai báo các tham chiếu tới đối tượng
+
Mở rộng lớp {@link android.app.Fragment} và khai báo các tham chiếu tới đối tượng
có trạng thái của bạn.
Gọi {@link android.app.Fragment#setRetainInstance(boolean)} khi phân đoạn được tạo.
Thêm phân đoạn vào hoạt động của bạn.
-
Sử dụng {@link android.app.FragmentManager} để truy xuất phân đoạn khi hoạt động
+
Sử dụng {@link android.app.FragmentManager} để truy xuất phân đoạn khi hoạt động
được khởi động lại.
@@ -125,8 +125,8 @@ rò rỉ tất cả dạng xem và tài nguyên của thực thể hoạt độn
có nghĩa là ứng dụng của bạn duy trì việc lưu giữ tài nguyên và chúng không thể được thu dọn bộ nhớ rác, vì thế
rất nhiều bộ nhớ có thể bị mất.)
-
Khi đó, hãy sử dụng {@link android.app.FragmentManager} để thêm phân đoạn vào hoạt động.
-Bạn có thể thu được đối tượng dữ liệu từ phân đoạn khi hoạt động bắt đầu lại trong khi
+
Khi đó, hãy sử dụng {@link android.app.FragmentManager} để thêm phân đoạn vào hoạt động.
+Bạn có thể thu được đối tượng dữ liệu từ phân đoạn khi hoạt động bắt đầu lại trong khi
thay đổi cấu hình thời gian chạy. Ví dụ, định nghĩa hoạt động của bạn như sau:
@@ -168,7 +168,7 @@ public class MyActivity extends Activity {
Trong ví dụ này, {@link android.app.Activity#onCreate(Bundle) onCreate()} thêm một phân đoạn
hoặc khôi phục một tham chiếu đến nó. {@link android.app.Activity#onCreate(Bundle) onCreate()} cũng
lưu trữ đối tượng có trạng thái bên trong thực thể phân đoạn đó.
-{@link android.app.Activity#onDestroy() onDestroy()} cập nhật đối tượng có trạng thái bên trong
+{@link android.app.Activity#onDestroy() onDestroy()} cập nhật đối tượng có trạng thái bên trong
thực thể phân đoạn được giữ lại.
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/controls.jd b/docs/html-intl/intl/vi/guide/topics/ui/controls.jd
index 37fe81c8c73a8..eda00506d0aff 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/controls.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/controls.jd
@@ -69,7 +69,7 @@ kiểu điều khiển nhập liệu cụ thể, bạn có thể xây dựng
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/declaring-layout.jd b/docs/html-intl/intl/vi/guide/topics/ui/declaring-layout.jd
index 6add812d89f7d..54852000a50f8 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/declaring-layout.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/declaring-layout.jd
@@ -107,7 +107,7 @@ trong thư mục dự án res/layout/ Android của bạn để bi
Nạp Tài nguyên XML
-
Khi bạn biên dịch ứng dụng của mình, từng tệp bố trí XML được biên dịch thành một tài nguyên
+
Khi bạn biên dịch ứng dụng của mình, từng tệp bố trí XML được biên dịch thành một tài nguyên
{@link android.view.View}. Bạn nên nạp tài nguyên bố trí từ mã ứng dụng của mình, trong triển khai gọi lại
{@link android.app.Activity#onCreate(android.os.Bundle) Activity.onCreate()} của bạn.
Làm vậy bằng cách gọi {@link android.app.Activity#setContentView(int) setContentView()},
@@ -260,7 +260,7 @@ Tài nguyên Có sẵn.
- Cặp thứ nhất được gọi là chiều rộng đo được và
+ Cặp thứ nhất được gọi là chiều rộng đo được và
chiều cao đo được. Những kích thước này xác định một dạng xem muốn phóng lớn bao nhiêu
trong dạng xem mẹ của nó. Các
kích thước đo được có thể thu được bằng cách gọi {@link android.view.View#getMeasuredWidth()}
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/dialogs.jd b/docs/html-intl/intl/vi/guide/topics/ui/dialogs.jd
index 1fa45508ef0c3..00d523014a647 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/dialogs.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/dialogs.jd
@@ -32,7 +32,7 @@ page.tags=alertdialog,dialogfragment
Các phương pháp set...Button() yêu cầu một tiêu đề cho nút (được cung cấp
-bởi một tài nguyên xâu) và một
-{@link android.content.DialogInterface.OnClickListener} có chức năng định nghĩa hành động sẽ tiến hành
+bởi một tài nguyên xâu) và một
+{@link android.content.DialogInterface.OnClickListener} có chức năng định nghĩa hành động sẽ tiến hành
khi người dùng nhấn nút.
Có ba nút hành động khác nhau mà bạn có thể thêm:
@@ -248,7 +248,7 @@ khi người dùng nhấn nút.
Trung lập
Bạn nên sử dụng nút này khi người dùng có thể không muốn tiếp tục với hành động,
nhưng không hẳn muốn hủy bỏ. Nó nằm ở giữa nút
- tích cực và tiêu cực. Ví dụ, hành động có thể là "Nhắc tôi sau."
+ tích cực và tiêu cực. Ví dụ, hành động có thể là "Nhắc tôi sau."
Bạn chỉ có thể thêm một nút mỗi loại vào một {@link
@@ -271,7 +271,7 @@ Hộp thoại có tiêu đề và danh sách.
Danh sách nhiều lựa chọn cố định (hộp kiểm)
-
Để tạo danh sách một lựa chọn như danh sách trong hình 3,
+
Để tạo danh sách một lựa chọn như danh sách trong hình 3,
hãy sử dụng phương pháp {@link android.app.AlertDialog.Builder#setItems setItems()}:
@@ -291,7 +291,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Vì danh sách xuất hiện trong vùng nội dung của hộp thoại,
hộp thoại không thể hiển thị cả thông báo và danh sách và bạn nên đặt một tiêu đề cho hộp thoại
-bằng {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
+bằng {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
Để chỉ định các mục cho danh sách, hãy gọi {@link
android.app.AlertDialog.Builder#setItems setItems()}, chuyển một mảng.
Hoặc, bạn có thể chỉ định một danh sách bằng cách sử dụng {@link
@@ -317,11 +317,11 @@ Danh sách nhiều mục lựa chọn.
Thêm một danh sách nhiều lựa chọn hoặc một lựa chọn cố định
-
Để thêm một danh sách nhiều lựa chọn (hộp kiểm) hoặc
+
Để thêm một danh sách nhiều lựa chọn (hộp kiểm) hoặc
một lựa chọn (nút chọn một), hãy sử dụng các phương pháp
{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
-DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} hoặc
-{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} hoặc
+{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} tương ứng.
Ví dụ, sau đây là cách bạn có thể tạo một danh sách nhiều lựa chọn như
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -373,7 +373,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Mặc dù cả danh sách truyền thống và danh sách có nút chọn một
đều cung cấp hành động "một lựa chọn", bạn nên sử dụng {@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} nếu bạn muốn cố định lựa chọn của người dùng.
Cụ thể, nếu việc mở hộp thoại lại sau này báo hiệu lựa chọn hiện tại của người dùng, khi đó
bạn hãy tạo một danh sách với các nút chọn một.
@@ -442,7 +442,7 @@ bạn nên đổi họ phông thành {@code "sans-serif"} sao cho cả hai trư
một kiểu phông thống nhất.
Để bung bố trí ra trong {@link android.support.v4.app.DialogFragment} của bạn,
-hãy lấy một {@link android.view.LayoutInflater} với
+hãy lấy một {@link android.view.LayoutInflater} với
{@link android.app.Activity#getLayoutInflater()} và gọi
{@link android.view.LayoutInflater#inflate inflate()}, trong đó tham số đầu tiên
là ID tài nguyên bố trí và tham số thứ hai là một dạng xem mẹ cho bố trí.
@@ -470,7 +470,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -505,7 +505,7 @@ giao diện mà thông qua đó, nó sẽ chuyển các sự kiện lại cho ho
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ của hộp thoại thông qua triển khai giao diện {@code NoticeDialogListe
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ hay UI toàn màn hình, dựa vào kích cỡ màn hình:
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
@@ -776,7 +776,7 @@ android.support.v4.app.DialogFragment#onDismiss onDismiss()} trong {@link
android.support.v4.app.DialogFragment} của mình.
Bạn cũng có thể hủy bỏ một hộp thoại. Đây là một sự kiện đặc biệt chỉ báo người dùng
-chủ ý rời khỏi hộp thoại mà không hoàn thành tác vụ. Điều này xảy ra nếu người dùng nhấn nút
+chủ ý rời khỏi hộp thoại mà không hoàn thành tác vụ. Điều này xảy ra nếu người dùng nhấn nút
Quay lại, chạm vào màn hình ngoài vùng hộp thoại,
hoặc nếu bạn công khai gọi {@link android.app.Dialog#cancel()} trên {@link
android.app.Dialog} (chẳng hạn như khi hồi đáp lại một nút "Hủy bỏ" trong hộp thoại).
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/menus.jd b/docs/html-intl/intl/vi/guide/topics/ui/menus.jd
index 8e9e1c412c5a9..7950907d88bb8 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/menus.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/menus.jd
@@ -83,9 +83,9 @@ không có), vì thế bạn nên chuyển sang sử dụng thanh hành động
các tùy chọn khác.
Menu ngữ cảnh là một menu nổi xuất hiện khi
người dùng thực hiện nhấp giữ trên một phần tử. Nó cung cấp các hành động ảnh hưởng tới nội dung hoặc
khung ngữ cảnh được chọn.
@@ -94,7 +94,7 @@ các mục hành động ảnh hưởng tới nội dung được chọn trong m
chọn nhiều mục.
Menu bật lên sẽ hiển thị danh sách các mục trong một danh sách thẳng đứng được neo vào dạng xem
đã gọi ra menu. Nên cung cấp một phần tràn gồm các hành động liên quan tới nội dung cụ thể hoặc
@@ -128,14 +128,14 @@ kích cỡ màn hình khác nhau và các cấu hình khác bằng cách tận d
dự án của bạn và xây dựng menu với các phần tử sau:
<menu>
-
Định nghĩa một {@link android.view.Menu}, đó là một bộ chứa các mục menu. Phần tử
+
Định nghĩa một {@link android.view.Menu}, đó là một bộ chứa các mục menu. Phần tử
<menu> phải là một nút gốc cho tệp và có thể giữ một hoặc nhiều phần tử
<item> và <group>.
<item>
Tạo một {@link android.view.MenuItem}, nó biểu diễn một mục đơn trong một menu. Phần tử
này có thể chứa một phần tử <menu> được lồng nhau để tạo một menu con.
-
+
<group>
Một bộ chứa tùy chọn, vô hình cho các phần tử {@code <item>}. Nó cho phép bạn
phân loại các mục menu sao cho chúng chia sẻ các tính chất như trạng thái hiện hoạt và khả năng hiển thị. Để biết thêm
@@ -273,7 +273,7 @@ tính chất của chúng bằng các API {@link android.view.MenuItem}.
Nếu bạn phát triển ứng dụng của mình cho phiên bản Android 2.3.x và thấp hơn, hệ thống gọi {@link
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} để tạo menu tùy chọn
-khi người dùng mở menu lần đầu tiên. Nếu bạn phát triển cho phiên bản Android 3.0 vào cao hơn,
+khi người dùng mở menu lần đầu tiên. Nếu bạn phát triển cho phiên bản Android 3.0 vào cao hơn,
hệ thống sẽ gọi {@link android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} khi
bắt đầu hoạt động để hiển thị các mục cho thanh hành động.
@@ -346,7 +346,7 @@ trừ khi menu bị vô hiệu hóa vì lý do nào đó. Tuy nhiên, bạn ch
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} để tạo trạng thái menu
ban đầu chứ không phải để thực hiện thay đổi trong vòng đời của hoạt động.
-
Nếu bạn muốn sửa đổi menu tùy chọn dựa trên
+
Nếu bạn muốn sửa đổi menu tùy chọn dựa trên
các sự kiện xảy ra trong vòng đời của hoạt động, bạn có thể làm vậy trong phương pháp
{@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}. Phương pháp
này chuyển cho bạn đối tượng {@link android.view.Menu} như hiện đang có để bạn có thể sửa đổi nó,
@@ -363,7 +363,7 @@ trình bày trong thanh hành động. Khi một sự kiện xảy ra và bạn
gọi {@link android.app.Activity#invalidateOptionsMenu invalidateOptionsMenu()} để yêu cầu
hệ thống gọi {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}.
-
Lưu ý:
+
Lưu ý:
Bạn không nên thay đổi các mục trong menu tùy chọn dựa trên {@link android.view.View} đang
trong tiêu điểm. Khi ở chế độ cảm ứng (khi người dùng không sử dụng bi xoay hay d-pad), các dạng xem
không thể lấy tiêu điểm, vì thế bạn không nên sử dụng tiêu điểm làm cơ sở để sửa đổi
@@ -609,7 +609,7 @@ someView.setOnLongClickListener(new View.OnLongClickListener() {
Khi bạn gọi {@link android.app.Activity#startActionMode startActionMode()}, hệ thống sẽ trả về
{@link android.view.ActionMode} được tạo. Bằng cách lưu điều này trong một biến thành viên, bạn có thể
-thực hiện thay đổi thanh hành động theo ngữ cảnh để hồi đáp những sự kiện khác. Trong mẫu trên,
+thực hiện thay đổi thanh hành động theo ngữ cảnh để hồi đáp những sự kiện khác. Trong mẫu trên,
{@link android.view.ActionMode} được sử dụng để đảm bảo rằng thực thể {@link android.view.ActionMode} không
được tạo lại nếu nó đã hiện hoạt, bằng cách kiểm tra xem thành viên có rỗng không trước khi khởi động
chế độ hành động.
Để tham khảo một ứng dụng mẫu sử dụng kỹ thuật này, hãy xem mã mẫu
+
Để tham khảo một ứng dụng mẫu sử dụng kỹ thuật này, hãy xem mã mẫu
Note
Pad.
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/notifiers/notifications.jd b/docs/html-intl/intl/vi/guide/topics/ui/notifiers/notifications.jd
index 5890cb331b965..8b6e1c8458c91 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/notifiers/notifications.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/notifiers/notifications.jd
@@ -150,7 +150,7 @@ thông báo, bạn chuyển đối tượng {@link android.app.Notification} t
{@link android.app.PendingIntent} chứa một
{@link android.content.Intent} có chức năng bắt đầu
một {@link android.app.Activity} trong ứng dụng của bạn. Để liên kết
- {@link android.app.PendingIntent} với một cử chỉ, hãy gọi phương pháp
+ {@link android.app.PendingIntent} với một cử chỉ, hãy gọi phương pháp
{@link android.support.v4.app.NotificationCompat.Builder} phù hợp. Ví dụ, nếu bạn muốn bắt đầu
{@link android.app.Activity} khi người dùng nhấp vào văn bản thông báo trong
ngăn kéo thông báo, bạn hãy thêm {@link android.app.PendingIntent} bằng cách gọi
@@ -449,7 +449,7 @@ numMessages = 0;
Thêm hỗ trợ cho phiên bản Android 4.0.3 và trước đó. Để làm điều này, hãy quy định mẹ của
- {@link android.app.Activity} mà bạn đang bắt đầu bằng cách thêm phần tử
+ {@link android.app.Activity} mà bạn đang bắt đầu bằng cách thêm phần tử
<meta-data>
làm con của
<activity>.
@@ -466,9 +466,9 @@ numMessages = 0;
- Cũng thêm hỗ trợ cho phiên bản Android 4.1 và sau đó. Để làm điều này, hãy thêm thuộc tính
+ Cũng thêm hỗ trợ cho phiên bản Android 4.1 và sau đó. Để làm điều này, hãy thêm thuộc tính
android:parentActivityName
- vào phần tử
+ vào phần tử
<activity>
của {@link android.app.Activity} mà bạn đang bắt đầu.
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/overview.jd b/docs/html-intl/intl/vi/guide/topics/ui/overview.jd
index 7bd45527c7b4b..260b40d9e19c8 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/overview.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/overview.jd
@@ -39,7 +39,7 @@ và một phần tử <LinearLayout> tạo ra một nhóm d
Để xem hướng dẫn đầy đủ về tạo bố trí UI, hãy xem phần Bố trí
XML.
-
+
Thành phần Giao diện Người dùng
Bạn không phải xây dựng tất cả UI của mình bằng cách sử dụng các đối tượng {@link android.view.View} và {@link
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/settings.jd b/docs/html-intl/intl/vi/guide/topics/ui/settings.jd
index 8e19b979d0ac1..47a5c27d1f087 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/settings.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/settings.jd
@@ -82,7 +82,7 @@ cách xây dựng thiết đặt ứng dụng của bạn bằng cách sử dụ
Hình 1. Ảnh chụp màn hình từ thiết đặt của ứng dụng
-Messaging trên Android. Chọn một mục được định nghĩa bởi một {@link android.preference.Preference}
+Messaging trên Android. Chọn một mục được định nghĩa bởi một {@link android.preference.Preference}
sẽ mở ra một giao diện để thay đổi thiết đặt.
@@ -121,7 +121,7 @@ sau:
Vì thiết đặt của ứng dụng của bạn được xây dựng bằng cách sử dụng các đối tượng {@link android.preference.Preference}
thay vì đối tượng
-{@link android.view.View}, bạn nên sử dụng một lớp con {@link android.app.Activity} hoặc
+{@link android.view.View}, bạn nên sử dụng một lớp con {@link android.app.Activity} hoặc
{@link android.app.Fragment} chuyên dụng để hiển thị thiết đặt danh sách:
@@ -226,7 +226,7 @@ android.preference.ListPreference}. Cả hai mục đều bao gồm ba thuộc t
{@code android:key}
Thuộc tính này được yêu cầu cho các tùy chọn duy trì một giá trị dữ liệu. Nó quy định khóa
(xâu) duy nhất mà hệ thống sử dụng khi lưu giá trị của thiết đặt này trong {@link
-android.content.SharedPreferences}.
+android.content.SharedPreferences}.
Các thực thể duy nhất mà thuộc tính này không được yêu cầu là khi tùy chọn là một
{@link android.preference.PreferenceCategory} hoặc {@link android.preference.PreferenceScreen}, hoặc
tùy chọn quy định một {@link android.content.Intent} để gọi ra (bằng phần tử {@code <intent>}) hoặc {@link android.app.Fragment} để hiển thị (bằng thuộc tính {@code
@@ -285,7 +285,7 @@ android.preference.PreferenceCategory}.
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
- <PreferenceCategory
+ <PreferenceCategory
android:title="@string/pref_sms_storage_title"
android:key="pref_key_storage_settings">
<CheckBoxPreference
@@ -293,12 +293,12 @@ android.preference.PreferenceCategory}.
android:summary="@string/pref_summary_auto_delete"
android:title="@string/pref_title_auto_delete"
android:defaultValue="false"... />
- <Preference
+ <Preference
android:key="pref_key_sms_delete_limit"
android:dependency="pref_key_auto_delete"
android:summary="@string/pref_summary_delete_limit"
android:title="@string/pref_title_sms_delete"... />
- <Preference
+ <Preference
android:key="pref_key_mms_delete_limit"
android:dependency="pref_key_auto_delete"
android:summary="@string/pref_summary_delete_limit"
@@ -569,7 +569,7 @@ cũ hơn (xem phần nói về Hỗ trợ các phi
với tiêu đề tùy chọn).
-
Hình 4. Bố trí có hai bảng với tiêu đề. 1.
+
Hình 4. Bố trí có hai bảng với tiêu đề. 1.
Tiêu đề được định nghĩa trong một tệp tiêu đề XML. 2. Mỗi nhóm thiết đặt được định nghĩa bởi một
{@link android.preference.PreferenceFragment}, được quy định bởi một phần tử {@code <header>} trong tệp tiêu đề
.
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
- <Preference
+ <Preference
android:title="@string/prefs_category_one"
android:summary="@string/prefs_summ_category_one" >
- <intent
+ <intent
android:targetPackage="com.example.prefs"
android:targetClass="com.example.prefs.SettingsActivity"
android:action="com.example.prefs.PREFS_ONE" />
</Preference>
- <Preference
+ <Preference
android:title="@string/prefs_category_two"
android:summary="@string/prefs_summ_category_two" >
- <intent
+ <intent
android:targetPackage="com.example.prefs"
android:targetClass="com.example.prefs.SettingsActivity"
android:action="com.example.prefs.PREFS_TWO" />
@@ -834,7 +834,7 @@ android.preference.Preference#setSummary setSummary()} khi thiết đặt thay
trạng thái hiện tại (chẳng hạn như thiết đặt Ngủ như minh họa trong hình 5).
Lưu ý: Như đã mô tả trong tài liệu Thiết kế Android về Thiết đặt, chúng tôi khuyên bạn nên cập nhật
-tóm tắt cho {@link android.preference.ListPreference} mỗi khi người dùng thay đổi tùy chọn để
+tóm tắt cho {@link android.preference.ListPreference} mỗi khi người dùng thay đổi tùy chọn để
mô tả thiết đặt hiện tại.
Để quản lý vòng đời trong hoạt động cho phù hợp, chúng tôi khuyên rằng bạn nên đăng ký và bỏ đăng ký
@@ -902,7 +902,7 @@ của ứng dụng của bạn từ dưới nền, bạn nên sử dụng kết
người dùng tinh chỉnh mức sử dụng dữ liệu cho ứng dụng của bạn thông qua thiết đặt ứng dụng.
Ví dụ, bạn có thể cho phép người dùng kiểm soát tần suất ứng dụng của bạn đồng bộ dữ liệu, ứng dụng của bạn
-chỉ được thực hiện tải lên/tải xuống khi trên Wi-Fi, ứng dụng của bạn sử dụng dữ liệu trong khi đang chuyển vùng dữ liệu, v.v... hay không. Với
+chỉ được thực hiện tải lên/tải xuống khi trên Wi-Fi, ứng dụng của bạn sử dụng dữ liệu trong khi đang chuyển vùng dữ liệu, v.v... hay không. Với
những kiểm soát này, người dùng sẽ ít có khả năng vô hiệu hóa truy cập dữ liệu của ứng dụng của bạn
hơn nhiều khi họ đạt gần mức giới hạn đặt ra trong Thiết đặt hệ thống, vì thay vào đó, họ có thể kiểm soát chính xác
lượng dữ liệu mà ứng dụng của bạn sử dụng.
@@ -946,7 +946,7 @@ mà bạn cần làm:
Quy định giao diện người dùng sẽ xuất hiện khi người dùng chọn thiết đặt.
Lưu giá trị của thiết đặt khi phù hợp.
-
Khởi tạo {@link android.preference.Preference} bằng giá trị hiện tại (hoặc mặc định)
+
Khởi tạo {@link android.preference.Preference} bằng giá trị hiện tại (hoặc mặc định)
khi xét tới dạng xem.
Cung cấp giá trị mặc định khi hệ thống yêu cầu.
Nếu {@link android.preference.Preference} cung cấp UI của chính mình (chẳng hạn như một hộp thoại), hãy lưu
@@ -975,11 +975,11 @@ các nút hộp thoại tích cực và tiêu cực mặc định:
public class NumberPickerPreference extends DialogPreference {
public NumberPickerPreference(Context context, AttributeSet attrs) {
super(context, attrs);
-
+
setDialogLayoutResource(R.layout.numberpicker_dialog);
setPositiveButtonText(android.R.string.ok);
setNegativeButtonText(android.R.string.cancel);
-
+
setDialogIcon(null);
}
...
@@ -1034,7 +1034,7 @@ với bạn xem thiết đặt có giá trị được duy trì hay không. Nế
cho bạn giá trị mặc định.
Phương pháp {@link android.preference.Preference#onSetInitialValue onSetInitialValue()} chuyển một
-boolean, restorePersistedValue, để cho biết liệu giá trị đã được duy trì
+boolean, restorePersistedValue, để cho biết liệu giá trị đã được duy trì
cho thiết đặt hay không. Nếu nó là true, khi đó bạn nên truy xuất giá trị được duy trì bằng cách gọi
một trong các phương pháp của lớp {@link
android.preference.Preference}, {@code getPersisted*()}, chẳng hạn như {@link
@@ -1060,7 +1060,7 @@ protected void onSetInitialValue(boolean restorePersistedValue, Object defaultVa
Mỗi phương pháp {@code getPersisted*()} sẽ lấy một tham đối quy định
-giá trị mặc định sẽ sử dụng trong trường hợp thực sự không có giá trị được duy trì hoặc khóa không tồn tại. Trong
+giá trị mặc định sẽ sử dụng trong trường hợp thực sự không có giá trị được duy trì hoặc khóa không tồn tại. Trong
ví dụ trên, một hằng số cục bộ được sử dụng để quy định giá trị mặc định trong trường hợp {@link
android.preference.Preference#getPersistedInt getPersistedInt()} không thể trả về một giá trị được duy trì.
@@ -1194,7 +1194,7 @@ protected void onRestoreInstanceState(Parcelable state) {
// Cast state to custom BaseSavedState and pass to superclass
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
-
+
// Set this Preference's widget to reflect the restored state
mNumberPicker.setValue(myState.value);
}
diff --git a/docs/html-intl/intl/vi/guide/topics/ui/ui-events.jd b/docs/html-intl/intl/vi/guide/topics/ui/ui-events.jd
index b4d1635d1caa9..c2b337ce78704 100644
--- a/docs/html-intl/intl/vi/guide/topics/ui/ui-events.jd
+++ b/docs/html-intl/intl/vi/guide/topics/ui/ui-events.jd
@@ -20,8 +20,8 @@ parent.link=index.html
Khi xem xét các sự kiện trong giao diện người dùng của bạn, cách tiếp cận là chụp lại sự kiện từ
đối tượng Dạng xem cụ thể mà người dùng tương tác với. Lớp Dạng xem sẽ cung cấp phương thức để làm việc này.
-
Trong các lớp Dạng xem khác nhau mà bạn sẽ sử dụng để soạn bố trí của mình, bạn có thể thấy một vài phương pháp gọi lại
-công khai dường như hữu ích đối với sự kiện UI. Những phương pháp này được khuôn khổ Android gọi khi
+
Trong các lớp Dạng xem khác nhau mà bạn sẽ sử dụng để soạn bố trí của mình, bạn có thể thấy một vài phương pháp gọi lại
+công khai dường như hữu ích đối với sự kiện UI. Những phương pháp này được khuôn khổ Android gọi khi
xảy ra hành động tương ứng trên đối tượng đó. Ví dụ, khi một Dạng xem (chẳng hạn như một Nút) được chạm vào,
phương pháp onTouchEvent() được gọi trên đối tượng đó. Tuy nhiên, để can thiệp vào điều này, bạn phải mở rộng
lớp và khống chế phương pháp đó. Tuy nhiên, việc mở rộng mọi đối tượng Dạng xem
@@ -30,7 +30,7 @@ một tập hợp giao diện lồng nhau cùng các phương pháp gọi lại
được gọi là đối tượng theo dõi sự kiện, là tấm vé để bạn chụp lại tương tác giữa người dùng với UI của bạn.
Trong khi các đối tượng theo dõi sự kiện sẽ thường được sử dụng để theo dõi tương tác của người dùng, có thể
-có lúc bạn muốn mở rộng một lớp Dạng xem để xây dựng một thành phần tùy chỉnh.
+có lúc bạn muốn mở rộng một lớp Dạng xem để xây dựng một thành phần tùy chỉnh.
Có thể là bạn muốn mở rộng lớp {@link android.widget.Button}
để khiến cái gì đó trông ấn tượng hơn. Trong trường hợp này, bạn sẽ có thể định nghĩa các hành vi sự kiện mặc định cho lớp
của mình bằng cách sử dụng bộ xử lý sự kiện của lớp.
@@ -38,7 +38,7 @@ của mình bằng cách sử dụng bộ xử lý sự
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/vi/preview/api-overview.jd b/docs/html-intl/intl/vi/preview/api-overview.jd
index 0e2c35e0e2286..5abc2f8829b96 100644
--- a/docs/html-intl/intl/vi/preview/api-overview.jd
+++ b/docs/html-intl/intl/vi/preview/api-overview.jd
@@ -336,7 +336,7 @@ của chúng — người dùng chỉ cần kéo và thả để thêm hoặ
Chặn số
Android N đã hỗ trợ chặn số điện thoại trong nền tảng này và cung cấp một
- API khuôn khổ cho phép các nhà cung cấp dịch vụ duy trì một danh sách số bị chặn.
+ API khuôn khổ cho phép các nhà cung cấp dịch vụ duy trì một danh sách số bị chặn.
Ứng dụng SMS mặc định, ứng dụng gọi điện mặc định và các ứng dụng của nhà cung cấp có thể đọc và
ghi vào danh sách số bị chặn. Các ứng dụng khác không thể truy cập vào danh sách này.
Được đưa vào Android 6.0 (Mức API 23), Chế độ Ngủ sâu cải thiện thời lượng pin bằng cách
trì hoãn các hoạt động của CPU và mạng khi người dùng không cắm sạc,
- không di chuyển và tắt màn hình thiết bị. Android N
+ không di chuyển và tắt màn hình thiết bị. Android N
thêm các cải tiến cho Chế độ Ngủ sâu bằng cách sử dụng một tập con các hạn chế của CPU và mạng
khi thiết bị không được cắm sạc với màn hình bị tắt, nhưng không nhất thiết
phải để một chỗ, ví dụ như một thiết bị cầm tay di chuyển trong túi của người dùng.
@@ -250,7 +250,7 @@ page.image=images/cards/card-n-changes_2x.png
Nếu một ứng dụng nhắm mục tiêu mức API 23 hoặc thấp hơn thì hệ thống sẽ tự động tắt
tất cả các tiến trình chạy ngầm của ứng dụng đó. Điều này có nghĩa là nếu một người dùng rời khỏi
- ứng dụng đó để mở màn hình Settings và thay đổi
+ ứng dụng đó để mở màn hình Settings và thay đổi
Display size thì hệ thống sẽ tắt ứng dụng giống
như trong trường hợp thiết bị thiếu bộ nhớ. Nếu ứng dụng đó có bất kỳ tiến trình nào
chạy ở tiền cảnh thì hệ thống sẽ thông báo cho các tiến trình đó về thay đổi cấu hình như
@@ -418,7 +418,7 @@ JavaVM::AttachCurrentThread from <jni.h>.
Giờ đây các hạn chế đặt lại mật khẩu cho người quản lý thiết bị sẽ áp dụng với người sở hữu
cấu hình. Người quản lý thiết bị không thể sử dụng
- DevicePolicyManager.resetPassword() được nữa để xóa mật khẩu hoặc thay đổi
+ DevicePolicyManager.resetPassword() được nữa để xóa mật khẩu hoặc thay đổi
các mật khẩu đã đặt. Người quản lý thiết bị vẫn có thể đặt một mật khẩu nhưng chỉ
khi thiết bị không có mật khẩu, mã PIN hoặc mẫu hình.
Các ứng dụng nhắm đến Preview không nhận được truyền phát {@link
- android.net.ConnectivityManager#CONNECTIVITY_ACTION} nếu chúng
+ android.net.ConnectivityManager#CONNECTIVITY_ACTION} nếu chúng
đăng ký nhận truyền phát trong bản kê khai của chúng. Các ứng dụng đang chạy ở tiền cảnh
vẫn có thể theo dõi {@code CONNECTIVITY_CHANGE} trên luồng chính của chúng bằng cách
đăng ký{@link android.content.BroadcastReceiver} với {@link
@@ -119,7 +119,7 @@ page.image=images/cards/card-nyc_2x.jpg
- Khi sử dụng lớp{@link android.app.job.JobInfo.Builder JobInfo.Builder}
+ Khi sử dụng lớp{@link android.app.job.JobInfo.Builder JobInfo.Builder}
để xây dựng đối tượng {@link android.app.job.JobInfo} của bạn, hãy áp dụng phương thức {@link
android.app.job.JobInfo.Builder#setRequiredNetworkType
setRequiredNetworkType()} và chuyển {@link android.app.job.JobInfo
@@ -145,7 +145,7 @@ public static void scheduleJob(Context context) {
- Khi các điều kiện cho tác vụ của bạn đã được đáp ứng, ứng dụng của bạn sẽ nhận được lệnh gọi lại để chạy
+ Khi các điều kiện cho tác vụ của bạn đã được đáp ứng, ứng dụng của bạn sẽ nhận được lệnh gọi lại để chạy
phương thức{@link android.app.job.JobService#onStartJob onStartJob()}trong
{@code JobService.class} được chỉ định. Để xem thêm các ví dụ về triển khai {@link
android.app.job.JobScheduler} , hãy xem ứng dụng mẫu JobScheduler.
@@ -243,7 +243,7 @@ public static void scheduleJob(Context context) {
- Lưu ý: {@code TriggerContentUri()} không thể được sử dụng
+ Lưu ý: {@code TriggerContentUri()} không thể được sử dụng
kết hợp với {@link android.app.job.JobInfo.Builder#setPeriodic
setPeriodic()} hoặc {@link android.app.job.JobInfo.Builder#setPersisted
setPersisted()}. Để tiếp tục theo dõi các thay đổi nội dung, hãy lên lịch một
@@ -313,7 +313,7 @@ public static void scheduleJob(Context context) {
Mã mẫu sau sẽ ghi đè lên phương thức {@link
- android.app.job.JobService#onStartJob JobService.onStartJob()} và
+ android.app.job.JobService#onStartJob JobService.onStartJob()} và
và ghi lại các thẩm quyền nội dung và URI đã kích hoạt tác vụ.
@@ -357,7 +357,7 @@ public boolean onStartJob(JobParameters params) {
bộ nhớ ít có thể cải thiện hiệu suất và trải nghiệm của người dùng. Loại bỏ
các thành phần phụ thuộc trên các dịch vụ chạy ngầm và bộ thu truyền phát không biểu thị đã đăng ký tĩnh
có thể giúp ứng dụng của bạn chạy tốt hơn trên các thiết bị như vậy. Mặc dù
- N Developer Preview thực hiện các bước để giảm bớt một vài trong số các vấn đề này, nhưng chúng tôi
+ N Developer Preview thực hiện các bước để giảm bớt một vài trong số các vấn đề này, nhưng chúng tôi
khuyến nghị bạn nên tối ưu ứng dụng của bạn để chạy hoàn toàn không cần sử dụng
các tiến trình chạy ngầm này.
diff --git a/docs/html-intl/intl/vi/preview/features/direct-boot.jd b/docs/html-intl/intl/vi/preview/features/direct-boot.jd
index d95d83103b151..9b2a557c2b16a 100644
--- a/docs/html-intl/intl/vi/preview/features/direct-boot.jd
+++ b/docs/html-intl/intl/vi/preview/features/direct-boot.jd
@@ -81,7 +81,7 @@ bộ lọc ý định cho LOCKED_BOOT_COMPLETED trong bản kê kha
</receiver>
-
Khi người dùng đã mở khóa thiết bị thì mọi thành phần có thể truy cập
+
Khi người dùng đã mở khóa thiết bị thì mọi thành phần có thể truy cập
cả bộ nhớ lưu trữ mã hóa thiết bị lẫn bộ nhớ lưu trữ mã hóa thông tin xác thực.
Truy cập Bộ nhớ Lưu trữ Mã hóa của Thiết bị
@@ -89,7 +89,7 @@ cả bộ nhớ lưu trữ mã hóa thiết bị lẫn bộ nhớ lưu trữ mã
Để truy cập bộ nhớ lưu trữ mã hóa thiết bị, hãy tạo một thực thể
{@link android.content.Context} thứ hai bằng cách gọi
Context.createDeviceEncryptedStorageContext(). Tất cả các lệnh gọi
-API bộ nhớ lưu trữ đều sử dụng bối cảnh này để truy cập bộ nhớ lưu trữ mã hóa thiết bị.
+API bộ nhớ lưu trữ đều sử dụng bối cảnh này để truy cập bộ nhớ lưu trữ mã hóa thiết bị.
Ví dụ sau sẽ truy cập bộ nhớ lưu trữ mã hóa của thiết bị và mở một tệp
dữ liệu ứng dụng có sẵn:
Android N cung cấp một tập nhỏ các API ICU4J thông qua
- gói android.icu thay vì gói com.ibm.icu.
+ gói android.icu thay vì gói com.ibm.icu.
Khuôn khổ Android có thể chọn không
cung cấp các API ICU4J vì nhiều lý do; ví dụ, Android N không cung cấp
một số API bị loại bỏ hoặc những API chưa được đội ngũ ICU công bố là
@@ -79,7 +79,7 @@ Khuôn khổ Android có thể chọn không
Các API khuôn khổ Android ICU4J không có tất cả các API của ICU4J.
Các nhà phát triển NDK cần biết rằng ICU4C Android không được hỗ trợ.
-
Các API trong khuôn khổ Android không thay thế hỗ trợ của Android cho
+
- Nếu bạn đã sử dụng các API ICU4J trong ứng dụng và
+ Nếu bạn đã sử dụng các API ICU4J trong ứng dụng và
các API android.icu đáp ứng yêu cầu của bạn thì việc chuyển nhập sang
các API của khuôn khổ đòi hỏi bạn phải thay đổi thành phần nhập vào của Java
từ com.ibm.icu sang android.icu. Khi đó bạn có thể
diff --git a/docs/html-intl/intl/vi/preview/features/multi-window.jd b/docs/html-intl/intl/vi/preview/features/multi-window.jd
index 485bc284786f1..5b2cb54cbc1c4 100644
--- a/docs/html-intl/intl/vi/preview/features/multi-window.jd
+++ b/docs/html-intl/intl/vi/preview/features/multi-window.jd
@@ -33,7 +33,7 @@ page.keywords="multi-window", "android N", "split screen", "free-form"
Nếu bạn dựng ứng dụng của bạn bằng N Preview SDK, bạn có thể cấu hình cách ứng dụng của bạn
- xử lý hiển thị đa cửa sổ. Ví dụ, bạn có thể quy định
+ xử lý hiển thị đa cửa sổ. Ví dụ, bạn có thể quy định
các kích thước tối thiểu cho phép của hoạt động của bạn. Bạn cũng có thể vô hiệu hóa hiển thị đa cửa sổ cho
ứng dụng của bạn, đảm bảo rằng hệ thống chỉ hiển thị ứng dụng của bạn trong chế độ
toàn màn hình.
@@ -117,7 +117,7 @@ page.keywords="multi-window", "android N", "split screen", "free-form"
Lưu ý: Trong chế độ đa cửa sổ, một ứng dụng có thể trong trạng thái
- tạm dừng và vẫn hiển thị với người dùng. Ứng dụng có thể cần tiếp tục
+ tạm dừng và vẫn hiển thị với người dùng. Ứng dụng có thể cần tiếp tục
các hoạt động của nó thậm chí trong khi đamg bị tạm dừng. Ví dụ, một ứng dụng phát video đang ở trong
chế độ tạm dừng nhưng vẫn hiển thị thì sẽ tiếp tục hiển thị video của nó. Vì lý do
này, chúng tôi đề nghị các hoạt động phát video không tạm dừng
@@ -129,13 +129,13 @@ page.keywords="multi-window", "android N", "split screen", "free-form"
Khi người dùng đặt một ứng dụng vào trong chế độ đa cửa sổ, hệ thống sẽ thông báo về
- hoạt động thay đổi cấu hình đó, như được quy định trong Xử lý Thay đổi
+ hoạt động thay đổi cấu hình đó, như được quy định trong Xử lý Thay đổi
Thời gian chạy. Về cơ bản, thay đổi này có ngụ ý về vòng đời hoạt động tương tự
vì khi hệ thống thông báo cho ứng dụng rằng thiết bị đã chuyển
từ chế độ hướng dọc sang chế độ ngang, ngoại trừ trường hợp các kích thước của thiết bị
đã được thay đổi thay vì chỉ bị hoán đổi. Như đã thảo luận trong phần Xử lý Thay đổi
Thời gian chạy, hoạt động của bạn có thể tự xử lý thay đổi cấu hình này, hoặc nó
- có thể cho phép hệ thống hủy hoạt động này và tạo lại nó với
+ có thể cho phép hệ thống hủy hoạt động này và tạo lại nó với
các kích thước mới.
- Với Android N, phần tử bản kê khai <layout>
+ Với Android N, phần tử bản kê khai <layout>
có hỗ trợ một số thuộc tính sẽ ảnh hưởng đến cách hoạt động có hành vi như thế nào trong
chế độ đa cửa sổ:
Chiều cao và chiều rộng tối thiểu cho hoạt động trong cả chế độ chia màn hình
- và chế độ hình dạng tự do. Nếu người dùng di chuyển thanh phân chia trong chế độ chia màn hình
+ và chế độ hình dạng tự do. Nếu người dùng di chuyển thanh phân chia trong chế độ chia màn hình
để làm cho hoạt động nhỏ hơn mức tối thiểu quy định, hệ thống sẽ cắt xén
hoạt động đó thành kích cỡ mà người dùng yêu cầu.
Các phương thức mới sau đây đã được thêm vào lớp {@link android.app.Activity}
- để hỗ trợ hiển thị đa cửa sổ. Để biết chi tiết về mỗi phương thức, xem
+ để hỗ trợ hiển thị đa cửa sổ. Để biết chi tiết về mỗi phương thức, xem
Tham chiếu N Preview SDK.
Thực hiện một vài thao tác thay đổi kích cỡ nối tiếp nhau thật nhanh. Xác minh rằng ứng dụng
- của bạn không bị lỗi hoặc bị rò rỉ bộ nhớ. Để biết thông tin về kiểm tra việc sử dụng bộ nhớ của
+ của bạn không bị lỗi hoặc bị rò rỉ bộ nhớ. Để biết thông tin về kiểm tra việc sử dụng bộ nhớ của
ứng dụng, xem
Kiểm tra Sử dụng RAM của bạn.
diff --git a/docs/html-intl/intl/vi/preview/features/notification-updates.jd b/docs/html-intl/intl/vi/preview/features/notification-updates.jd
index d80cf6c08f5eb..f60646a46f43d 100644
--- a/docs/html-intl/intl/vi/preview/features/notification-updates.jd
+++ b/docs/html-intl/intl/vi/preview/features/notification-updates.jd
@@ -37,7 +37,7 @@ hiện có để hỗ trợ trả lời giữa dòng trên thiết bị cầm ta
thông báo, từng thông báo một từ khu vực hiển thị thông báo.
-
Cuối cùng, Android N cũng thêm các API mới cho phép bạn tận dụng các trang trí
+
Cuối cùng, Android N cũng thêm các API mới cho phép bạn tận dụng các trang trí
của hệ thống trong các dạng xem thông báo tùy chỉnh của ứng dụng của bạn. Các API này giúp
đảm bảo rằng dạng xem thông báo có chung một cách trình bày nhất quán
với các mẫu tiêu chuẩn.
@@ -69,9 +69,9 @@ của thông báo. Trên thiết bị cầm tay, hành động trả lời giữ
-
Tạo thực thể{@link android.support.v4.app.RemoteInput.Builder}
+
Tạo thực thể{@link android.support.v4.app.RemoteInput.Builder}
mà bạn có thể thêm vào hành động
-thông báo của bạn. Hàm dựng của lớp này sẽ chấp nhận xâu mà hệ thống sử dụng làm khóa
+thông báo của bạn. Hàm dựng của lớp này sẽ chấp nhận xâu mà hệ thống sử dụng làm khóa
cho nhập liệu văn bản. Sau đó, ứng dụng cầm tay của bạn sử dụng khóa đó để truy xuất văn bản
nhập liệu.
diff --git a/docs/html-intl/intl/vi/preview/features/picture-in-picture.jd b/docs/html-intl/intl/vi/preview/features/picture-in-picture.jd
index 4b3cb400f72ea..65799dbb0ca30 100644
--- a/docs/html-intl/intl/vi/preview/features/picture-in-picture.jd
+++ b/docs/html-intl/intl/vi/preview/features/picture-in-picture.jd
@@ -128,7 +128,7 @@ các hành động ở chế độ PIP trên thanh điều khiển và sử dụ
video. Hãy xóa các phần tử UI trước khi hoạt động của bạn vào chế độ PIP,
và khôi phục các phần tử này khi hoạt động quay lại chế độ toàn màn hình.
Ghi đè phương thức Activity.onPictureInPictureChanged() hoặc
-Fragment.onPictureInPictureChanged() và bật hoặc
+Fragment.onPictureInPictureChanged() và bật hoặc
tắt các phần tử UI khi cần thiết, ví dụ:
@@ -150,7 +150,7 @@ public void onPictureInPictureChanged(boolean inPictureInPicture) {
Khi hoạt động của bạn chuyển sang chế độ PIP thì hệ thống sẽ coi hoạt động đó đang ở trong
trạng thái tạm dừng và sẽ gọi phương thức onPause() của hoạt động. Việc phát lại
video không nên được tạm dừng và cần được tiếp tục phát nếu hoạt động
-bị tạm dừng do chế độ PIP. Hãy kiểm tra chế độ PIP trong phương thức
+bị tạm dừng do chế độ PIP. Hãy kiểm tra chế độ PIP trong phương thức
onPause() của hoạt động và xử lý việc phát lại cho phù hợp, ví
dụ:
- Tại Preview 4 và 5 bạn sẽ được sử dụng các
+ Tại Preview 4 và 5 bạn sẽ được sử dụng các
API và SDK N cuối cùng để phát triển, và cả các ảnh hệ thống gần hoàn thiện
để kiểm thử các hành vi, tính năng của hệ thống. Android N sẽ cung cấp một mức
API chuẩn vào thời điểm này. Bạn có thể tiến hành kiểm thử khả năng tương thích cuối cùng đối với các ứng dụng
@@ -321,7 +321,7 @@ Android N có
Hành vi chỉ ra cho bạn các phần chính yếu để kiểm thử.
Tổng quan về các API mới, bao gồm một phần Tổng quan về API, bản tải xuống được
Tham khảo
- API và các hướng dẫn chi tiết cho nhà phát triển đối với các tính năng quan trọng như
+ API và các hướng dẫn chi tiết cho nhà phát triển đối với các tính năng quan trọng như
hỗ trợ đa cửa sổ, thông báo gộp, hỗ trợ đa bản địa và các tính năng khác.
Mã mẫu trong đó
minh họa cách hỗ trợ các quyền và tính năng mới.
diff --git a/docs/html-intl/intl/vi/training/material/animations.jd b/docs/html-intl/intl/vi/training/material/animations.jd
index e93c99d64508f..9299d3c931a89 100644
--- a/docs/html-intl/intl/vi/training/material/animations.jd
+++ b/docs/html-intl/intl/vi/training/material/animations.jd
@@ -21,7 +21,7 @@ page.title=Định nghĩa Hoạt hình Tùy chỉnh
-
Hoạt hình theo phong cách material design phản hồi hành động của người dùng và cung cấp
+
Hoạt hình theo phong cách material design phản hồi hành động của người dùng và cung cấp
tính liên tục trực quan khi người dùng tương tác với ứng dụng của bạn. Giao diện material cung cấp một số hoạt hình
mặc định cho các nút và chuyển tiếp hoạt động, và Android 5.0 (API mức 21) và cao hơn cho phép bạn tùy chỉnh
những hoạt hình này và tạo các hoạt hình mới:
@@ -160,7 +160,7 @@ trung tâm.
Chuyển tiếp phần tử chung xác định các dạng xem chung giữa hai hoạt động
sẽ chuyển tiếp như thế nào giữa những hoạt động này. Ví dụ, nếu hai hoạt động có cùng
-hình ảnh ở các vị trí và kích cỡ khác nhau, chuyển tiếp phần tử chung changeImageTransform
+hình ảnh ở các vị trí và kích cỡ khác nhau, chuyển tiếp phần tử chung changeImageTransform
sẽ thể hiện và co giãn hình ảnh một cách mượt mà giữa những hoạt động này.
@@ -329,7 +329,7 @@ thay vì {@link android.app.Activity#finish Activity.finish()}.
Để tạo một hoạt hình chuyển tiếp cảnh giữa hai hoạt động có nhiều hơn một phần tử
chung, hãy định nghĩa các phần tử chung trong cả hai bố trí bằng thuộc tính android:transitionName
- (hoặc sử dụng phương thức {@link android.view.View#setTransitionName View.setTransitionName()}
+ (hoặc sử dụng phương thức {@link android.view.View#setTransitionName View.setTransitionName()}
trong cả hai hoạt động), và tạo một đối tượng {@link android.app.ActivityOptions} như sau:
diff --git a/docs/html-intl/intl/vi/training/material/compatibility.jd b/docs/html-intl/intl/vi/training/material/compatibility.jd
index e19a745dd9b98..2f5c0160f6757 100644
--- a/docs/html-intl/intl/vi/training/material/compatibility.jd
+++ b/docs/html-intl/intl/vi/training/material/compatibility.jd
@@ -94,7 +94,7 @@ r21 và cao hơn gồm những tính năng material design sau:
Bảng màu
-
Để có được các kiểu phong cách material design và tùy chỉnh bảng màu bằng Thư viện Hỗ trợ v7
+
Để có được các kiểu phong cách material design và tùy chỉnh bảng màu bằng Thư viện Hỗ trợ v7
của Android, hãy áp dụng một trong các chủ đề Theme.AppCompat:
diff --git a/docs/html-intl/intl/vi/training/material/drawables.jd b/docs/html-intl/intl/vi/training/material/drawables.jd
index 175e77d629e8a..db69412c544e0 100644
--- a/docs/html-intl/intl/vi/training/material/drawables.jd
+++ b/docs/html-intl/intl/vi/training/material/drawables.jd
@@ -57,7 +57,7 @@ Lớp này trích xuất những màu nổi bật sau:
Sáng lặng
-
Để trích xuất những màu này, hãy chuyển một đối tượng {@link android.graphics.Bitmap} cho phương thức tĩnh
+
Để trích xuất những màu này, hãy chuyển một đối tượng {@link android.graphics.Bitmap} cho phương thức tĩnh
{@link android.support.v7.graphics.Palette#generate Palette.generate()} trong
luồng chạy ngầm nơi bạn tải hình ảnh của mình. Nếu bạn không thể sử dụng luồng đó, hãy gọi phương thức
{@link android.support.v7.graphics.Palette#generateAsync Palette.generateAsync()} và
diff --git a/docs/html-intl/intl/vi/training/material/get-started.jd b/docs/html-intl/intl/vi/training/material/get-started.jd
index 9e612ad10c07c..45d7c09e3e0b1 100644
--- a/docs/html-intl/intl/vi/training/material/get-started.jd
+++ b/docs/html-intl/intl/vi/training/material/get-started.jd
@@ -94,7 +94,7 @@ bố trí của bạn, hãy đặc biệt chú ý tới điều sau đây:
Quy định Độ cao trong Dạng xem của Bạn
-
Dạng xem có thể đổ bóng và giá trị độ cao của một dạng xem
+
Dạng xem có thể đổ bóng và giá trị độ cao của một dạng xem
xác định kích cỡ bóng và thứ tự vẽ của nó. Để đặt độ cao của một dạng xem, hãy sử dụng thuộc tính
android:elevation trong bố trí của bạn:
@@ -122,7 +122,7 @@ chạm.
{@link android.support.v7.widget.RecyclerView} là một phiên bản dễ ghép nối hơn của {@link
android.widget.ListView} có hỗ trợ các kiểu bố trí khác nhau và cung cấp những cải tiến về hiệu năng.
{@link android.support.v7.widget.CardView} cho phép bạn hiện các mẩu thông tin bên trong thẻ với
-một diện mạo nhất quán giữa các ứng dụng. Ví dụ về mã sau đây minh họa cách thêm
+một diện mạo nhất quán giữa các ứng dụng. Ví dụ về mã sau đây minh họa cách thêm
{@link android.support.v7.widget.CardView} vào bố trí của bạn:
diff --git a/docs/html-intl/intl/vi/training/material/index.jd b/docs/html-intl/intl/vi/training/material/index.jd
index 44b74e1826fdf..eb489457e7c21 100644
--- a/docs/html-intl/intl/vi/training/material/index.jd
+++ b/docs/html-intl/intl/vi/training/material/index.jd
@@ -17,7 +17,7 @@ page.metaDescription=Tìm hiểu cách áp dụng material design cho ứng dụ
Material design là một hướng dẫn toàn diện về thiết kế trực quan, chuyển động
và tương tác giữa nhiều nền tảng và thiết bị. Để sử dụng material design trong ứng dụng Androi của mình, hãy làm theo hướng dẫn
-mô tả trong
+mô tả trong
đặc tả
material design và sử dụng những thành phần và tính năng mới sẵn có trong Android 5.0
(API mức 21).
diff --git a/docs/html-intl/intl/vi/training/material/lists-cards.jd b/docs/html-intl/intl/vi/training/material/lists-cards.jd
index 7127649bda830..47a7d6f8f3b48 100644
--- a/docs/html-intl/intl/vi/training/material/lists-cards.jd
+++ b/docs/html-intl/intl/vi/training/material/lists-cards.jd
@@ -210,7 +210,7 @@ android.support.v7.widget.CardView} có thể có đổ bóng và góc bo tròn.
Để biết thêm thông tin, hãy xem phần Duy trì
Tính tương thích.
-
Sử dụng những thuộc tính sau để tùy chỉnh diện mạo của widget
+
Sử dụng những thuộc tính sau để tùy chỉnh diện mạo của widget
{@link android.support.v7.widget.CardView}:
diff --git a/docs/html-intl/intl/vi/training/material/shadows-clipping.jd b/docs/html-intl/intl/vi/training/material/shadows-clipping.jd
index e9091f289fcb1..f4ce4025963f4 100644
--- a/docs/html-intl/intl/vi/training/material/shadows-clipping.jd
+++ b/docs/html-intl/intl/vi/training/material/shadows-clipping.jd
@@ -22,7 +22,7 @@ page.title=Định nghĩa Đổ bóng và Dạng xem Cắt hình
tầm quan trọng tương đối của từng phần tử và tập chung sự chú ý của họ vào tác vụ hiện có.
Độ cao của một dạng xem, được biểu diễn bằng thuộc tính Z, sẽ xác định diện mạo trực quan của
-bóng đổ: dạng xem có giá trị Z cao hơn sẽ đổ bóng lớn hơn, mềm hơn. Dạng xem có giá trị Z cao hơn sẽ che khuất dạng xem
+bóng đổ: dạng xem có giá trị Z cao hơn sẽ đổ bóng lớn hơn, mềm hơn. Dạng xem có giá trị Z cao hơn sẽ che khuất dạng xem
có giá trị Z thấp hơn; tuy nhiên, giá trị Z của một dạng xem không ảnh hưởng tới kích cỡ của dạng xem.
Đổ bóng được vẽ bởi dạng xem mẹ của dạng xem cao hơn, do vậy nó phụ thuộc vào tiêu chuẩn cắt dạng xem,
@@ -51,7 +51,7 @@ trong không gian 3D.
Hình 1 - Đổ bóng cho các độ cao dạng xem khác nhau.
Để đặt độ cao của dạng xem trong một định nghĩa bố trí, hãy sử dụng thuộc tính android:elevation
-. Để đặt độ cao của dạng xem trong mã của một hoạt động, hãy sử dụng phương thức
+. Để đặt độ cao của dạng xem trong mã của một hoạt động, hãy sử dụng phương thức
{@link android.view.View#setElevation View.setElevation()}.
Để đặt độ dịch của dạng xem, hãy sử dụng phương thức {@link android.view.View#setTranslationZ
@@ -59,7 +59,7 @@ View.setTranslationZ()}.
Các phương thức {@link android.view.ViewPropertyAnimator#z ViewPropertyAnimator.z()} và {@link
android.view.ViewPropertyAnimator#translationZ ViewPropertyAnimator.translationZ()} mới cho phép
-bạn dễ dàng tạo hiệu ứng hoạt hình cho độ cao của dạng xem. Để biết thêm thông tin, hãy xem tài liệu tham khảo API cho
+bạn dễ dàng tạo hiệu ứng hoạt hình cho độ cao của dạng xem. Để biết thêm thông tin, hãy xem tài liệu tham khảo API cho
{@link android.view.ViewPropertyAnimator} và hướng dẫn cho nhà phát triển về Hoạt hình Thuộc tính
.
- 如果您正在准备国际化营销，请务必加入本地化的 Google Play
+ 如果您正在准备国际化营销，请务必加入本地化的 Google Play
徽章，让用户知道您是在 Google Play 上发布应用的。您可以使用徽章生成器快速构建本地化的徽章，然后用到您的网站或营销材料中。
您还可以获得高分辨率的资源。
diff --git a/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd b/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd
index c7cf7cf700b17..e9b13c02f0028 100644
--- a/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd
+++ b/docs/html-intl/intl/zh-cn/distribute/tools/promote/linking.jd
@@ -13,7 +13,7 @@ page.metaDescription=了解如何构建链接，把用户从浏览或搜索带
-
Google Play 提供多种链接格式，可让你按自己需要的方式将用户从 Android 应用、网页、广告、评论、文章、社交媒体帖子等链接到你的商品。
+
Google Play 提供多种链接格式，可让你按自己需要的方式将用户从 Android 应用、网页、广告、评论、文章、社交媒体帖子等链接到你的商品。
当结帐流程结束后（即用户成功购买商品或取消购买），Google Play 会向您的 onActivityResult 方法发送响应 Intent。onActivityResult 的结果代码中有一个代码将用于表明用户是完成了购买还是取消了购买。响应 Intent 中会包含所购商品的相关信息，其中包括 Google Play 为了唯一标识此次购买交易而生成的 purchaseToken 字符串。Intent 中还包含使用您的私人开发者密钥签署的购买签名。
+
当结帐流程结束后（即用户成功购买商品或取消购买），Google Play 会向您的 onActivityResult 方法发送响应 Intent。onActivityResult 的结果代码中有一个代码将用于表明用户是完成了购买还是取消了购买。响应 Intent 中会包含所购商品的相关信息，其中包括 Google Play 为了唯一标识此次购买交易而生成的 purchaseToken 字符串。Intent 中还包含使用您的私人开发者密钥签署的购买签名。
@@ -400,10 +400,10 @@ Google Play 然后根据
这样，您可以只包括每种设备配置所需的纹理，从而减小
APK 文件的大小。
-根据每个设备是否支持您的纹理压缩格式，Google Play
+根据每个设备是否支持您的纹理压缩格式，Google Play
将向其提供您已声明支持该设备的 APK。
-
目前，只有在每个 APK 根据以下配置提供不同筛选时，Google Play
+
目前，只有在每个 APK 根据以下配置提供不同筛选时，Google Play
才允许您为同一应用发布多个 APK：
一个布尔值，表示是否应同步日历并将其事件存储在设备上。
值为 0
表示不同步该日历，也不将其事件存储在设备上。值为 1
@@ -268,13 +268,13 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
以下后续部分使用游标单步调试结果集。它使用在示例开头设置的常量来返回每个字段的值。
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -373,7 +373,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ public class NoticeDialogFragment extends DialogFragment {
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ UI：
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
diff --git a/docs/html-intl/intl/zh-cn/guide/topics/ui/menus.jd b/docs/html-intl/intl/zh-cn/guide/topics/ui/menus.jd
index b77f3bf497daa..bafbc65e7167a 100644
--- a/docs/html-intl/intl/zh-cn/guide/topics/ui/menus.jd
+++ b/docs/html-intl/intl/zh-cn/guide/topics/ui/menus.jd
@@ -83,9 +83,9 @@ Android 3.0 及更高版本的系统中，创建选项菜单部分。
-
+
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/zh-cn/preview/api-overview.jd b/docs/html-intl/intl/zh-cn/preview/api-overview.jd
index 495692ac2d85f..f4f889d180214 100644
--- a/docs/html-intl/intl/zh-cn/preview/api-overview.jd
+++ b/docs/html-intl/intl/zh-cn/preview/api-overview.jd
@@ -762,7 +762,7 @@ Android 扩展包 (AEP) 的所有扩展（EXT_texture_sRGB_decode<
支持不同屏幕
@@ -105,7 +105,7 @@ public void onSaveInstanceState(Bundle savedInstanceState) {
// Save the user's current game state
savedInstanceState.putInt(STATE_SCORE, mCurrentScore);
savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel);
-
+
// Always call the superclass so it can save the view hierarchy state
super.onSaveInstanceState(savedInstanceState);
}
@@ -138,7 +138,7 @@ onCreate()} 中恢复一些状态数据：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); // Always call the superclass first
-
+
// Check whether we're recreating a previously destroyed instance
if (savedInstanceState != null) {
// Restore value of members from saved state
@@ -157,12 +157,12 @@ android.app.Activity#onRestoreInstanceState onRestoreInstanceState()} ，而不
系统只在存在要恢复的已保存状态时调用 {@link
android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}
，因此您无需检查 {@link android.os.Bundle} 是否为 null：
-
+
public void onRestoreInstanceState(Bundle savedInstanceState) {
// Always call the superclass so it can restore the view hierarchy
super.onRestoreInstanceState(savedInstanceState);
-
+
// Restore state members from saved instance
mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
diff --git a/docs/html-intl/intl/zh-cn/training/basics/activity-lifecycle/starting.jd b/docs/html-intl/intl/zh-cn/training/basics/activity-lifecycle/starting.jd
index cebd7484d179c..04f380d7d0db7 100644
--- a/docs/html-intl/intl/zh-cn/training/basics/activity-lifecycle/starting.jd
+++ b/docs/html-intl/intl/zh-cn/training/basics/activity-lifecycle/starting.jd
@@ -9,7 +9,7 @@ trainingnavtop=true
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-cn/training/monitoring-device-state/manifest-receivers.jd b/docs/html-intl/intl/zh-cn/training/monitoring-device-state/manifest-receivers.jd
index 07c014f10a315..ed1b6ceb0354f 100644
--- a/docs/html-intl/intl/zh-cn/training/monitoring-device-state/manifest-receivers.jd
+++ b/docs/html-intl/intl/zh-cn/training/monitoring-device-state/manifest-receivers.jd
@@ -9,7 +9,7 @@ previous.link=connectivity-monitoring.html
@jd:body
-
Android 4.3 平台首度導入了藍牙低功耗技術 (Bluetooth LE) 支援功能，讓裝置以主機角色建立連線。在 Android 5.0 中，Android 裝置則可以扮演 Bluetooth LE「周邊裝置」的角色。應用程式可以透過這項功能，輕鬆讓附近的裝置偵測到。舉例來說，您可以打造應用程式，讓裝置化身為計步器或健康監測器，並將資料傳送給另一台 Bluetooth LE 裝置。
+
Android 4.3 平台首度導入了藍牙低功耗技術 (Bluetooth LE) 支援功能，讓裝置以主機角色建立連線。在 Android 5.0 中，Android 裝置則可以扮演 Bluetooth LE「周邊裝置」的角色。應用程式可以透過這項功能，輕鬆讓附近的裝置偵測到。舉例來說，您可以打造應用程式，讓裝置化身為計步器或健康監測器，並將資料傳送給另一台 Bluetooth LE 裝置。
全新的 {@link android.bluetooth.le} API 可讓您的應用程式播送廣告、掃描回應，以及與附近的 Bluetooth LE 裝置建立連線。如要使用全新的廣告和掃描功能，請在您的資訊清單中新增 {@link android.Manifest.permission#BLUETOOTH_ADMIN BLUETOOTH_ADMIN} 權限。當使用者從 Play 商店更新或下載您的應用程式時，會看到以下的權限要求提示：「藍牙連線資訊：允許應用程式控制藍牙功能，包括對附近的藍牙裝置播送資訊，或是從附近的藍牙裝置取得資訊。」
如要開始 Bluetooth LE 廣告功能，以便其他裝置發掘您的應用程式，請呼叫 {@link android.bluetooth.le.BluetoothLeAdvertiser#startAdvertising(android.bluetooth.le.AdvertiseSettings, android.bluetooth.le.AdvertiseData, android.bluetooth.le.AdvertiseCallback) startAdvertising()} 並傳遞 {@link android.bluetooth.le.AdvertiseCallback} 類別實作。回呼物件會收到廣告作業成功或失敗的報告。
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/families/faq.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/families/faq.jd
index 6964789008945..057e58373e674 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/families/faq.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/families/faq.jd
@@ -10,7 +10,7 @@ page.metaDescription=有關 Designed for Families 的問題與回答
font-weight:bold;
}
-
+
本文件內容
@@ -106,7 +106,7 @@ page.metaDescription=有關 Designed for Families 的問題與回答
- 在您選擇加入 Designed for Families 後，Google Play 會檢閱您的應用程式，以確認其是否適合家庭使用。若您的應用程式符合所有計劃需求，預計發行時間不會長於一般發行時間；但是，若在 Designed for Families 檢閱期間拒絕應用程式，則該應用程式的發行可能會出現延遲。
+ 在您選擇加入 Designed for Families 後，Google Play 會檢閱您的應用程式，以確認其是否適合家庭使用。若您的應用程式符合所有計劃需求，預計發行時間不會長於一般發行時間；但是，若在 Designed for Families 檢閱期間拒絕應用程式，則該應用程式的發行可能會出現延遲。
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/families/start.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/families/start.jd
index bf7a7259739f2..ca44a282178af 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/families/start.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/families/start.jd
@@ -51,7 +51,7 @@ page.metaDescription=只需幾個簡易步驟即可加入 Designed for Families
- 注意：Designed for Families 計劃中已發行的應用程式也可供 Google Play 上的所有使用者使用。
+ 注意：Designed for Families 計劃中已發行的應用程式也可供 Google Play 上的所有使用者使用。
@@ -67,4 +67,4 @@ page.metaDescription=只需幾個簡易步驟即可加入 Designed for Families
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/guide.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/guide.jd
index 0165279f68984..e70eaa3e25c8f 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/guide.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/guide.jd
@@ -54,4 +54,4 @@ page.image=distribute/images/play_dev_guide.png
data-query="collection:play_dev_guide"
data-cardSizes="9x6"
data-maxResults="1">
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/auto.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/auto.jd
index bf7b702e68525..d724869350a65 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/auto.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/auto.jd
@@ -431,4 +431,4 @@ data-sortorder="-timestamp" data-cardsizes="9x3" data-maxresults="6">
重要說明：由於存在這一限制，因此您不應將生產 APK 用於 Auto 支援原型設計。
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/core.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/core.jd
index feabc2002fdad..3435ec2a4e19a 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/core.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/core.jd
@@ -13,7 +13,7 @@ page.image=/distribute/images/core-quality-guidelines.jpg
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/tablets.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/tablets.jd
index 3c16f9daa50ba..d584e5375095b 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/tablets.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/quality/tablets.jd
@@ -46,7 +46,7 @@ Xnonavpage=true
是。上述需求僅判斷在 Google Play 上是否將您的應用程式視為 Android Wear 應用程式，以及該應用程式是否可供 Android Wear 使用者更輕鬆地探尋。若未接受您的應用程式為 Wear 應用程式，仍會向其他裝置類型 (例如手機或平板電腦) 提供該應用程式，並且仍會安裝在穿戴式裝置上。
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/start.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/start.jd
index 3364e49bbdcae..8bff67d02eb7d 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/start.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/start.jd
@@ -134,4 +134,4 @@ href="https://support.google.com/googleplay/android-developer/bin/answer.py?hl=e
data-query="collection:distribute/googleplay/gettingstarted"
data-sortOrder="-timestamp"
data-cardSizes="9x3"
- data-maxResults="6">
\ No newline at end of file
+ data-maxResults="6">
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/tv.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/tv.jd
index c4f7a7cd089c9..aa2096ad4cdd3 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/tv.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/tv.jd
@@ -173,7 +173,7 @@ page.metaDescription=將您的應用程式、遊戲與內容散佈至 Android
@@ -207,4 +207,4 @@ page.metaDescription=將您的應用程式、遊戲與內容散佈至 Android
data-query="collection:tvlanding"
data-cardSizes="9x6, 6x3x2"
data-maxResults="6">
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/googleplay/wear.jd b/docs/html-intl/intl/zh-tw/distribute/googleplay/wear.jd
index 19a48f56a5b55..f4aca5cca51ab 100644
--- a/docs/html-intl/intl/zh-tw/distribute/googleplay/wear.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/googleplay/wear.jd
@@ -196,4 +196,4 @@ page.metaDescription=將您的應用程式、遊戲與內容散佈至 Android We
data-query="collection:wearlanding"
data-cardSizes="6x2"
data-maxResults="3">
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/tools/launch-checklist.jd b/docs/html-intl/intl/zh-tw/distribute/tools/launch-checklist.jd
index 6e974174849be..167c4f10d5ace 100644
--- a/docs/html-intl/intl/zh-tw/distribute/tools/launch-checklist.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/tools/launch-checklist.jd
@@ -789,4 +789,4 @@ data-maxresults="6">
data-query="collection:distribute/toolsreference/launchchecklist/afterlaunch"
data-sortOrder="-timestamp"
data-cardSizes="9x3,9x3,9x3,9x3,9x3,9x3"
- data-maxResults="6">
\ No newline at end of file
+ data-maxResults="6">
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/distribute/tools/localization-checklist.jd b/docs/html-intl/intl/zh-tw/distribute/tools/localization-checklist.jd
index 1b95d0b3458d1..c34fcee498bc0 100644
--- a/docs/html-intl/intl/zh-tw/distribute/tools/localization-checklist.jd
+++ b/docs/html-intl/intl/zh-tw/distribute/tools/localization-checklist.jd
@@ -713,4 +713,4 @@ data-maxresults="6">
data-query="collection:distribute/toolsreference/localizationchecklist/supportlaunch"
data-sortOrder="-timestamp"
data-cardSizes="9x3,9x3,6x3,9x3,9x3,9x3"
- data-maxResults="6">
\ No newline at end of file
+ data-maxResults="6">
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/google/play/filters.jd b/docs/html-intl/intl/zh-tw/google/play/filters.jd
index e96b9ddcacd80..eec87ac751561 100644
--- a/docs/html-intl/intl/zh-tw/google/play/filters.jd
+++ b/docs/html-intl/intl/zh-tw/google/play/filters.jd
@@ -263,4 +263,4 @@ href="{@docRoot}guide/topics/manifest/uses-feature-element.html"><uses-featur
若您需要有關如何在 Google Play 上發行多個 APK 的詳細資訊，請參閱多 APK 支援。
\ No newline at end of file
+
若您需要有關如何在 Google Play 上發行多個 APK 的詳細資訊，請參閱多 APK 支援。
\ No newline at end of file
diff --git a/docs/html-intl/intl/zh-tw/guide/components/bound-services.jd b/docs/html-intl/intl/zh-tw/guide/components/bound-services.jd
index da47634b894fa..e26e993fd672f 100644
--- a/docs/html-intl/intl/zh-tw/guide/components/bound-services.jd
+++ b/docs/html-intl/intl/zh-tw/guide/components/bound-services.jd
@@ -303,7 +303,7 @@ public class BindingActivity extends Activity {
}
-
指出日曆是否應同步，並且讓日曆的活動儲存在裝置上的布林值。
值 0 表示不同步此日曆，並且不要在裝置上儲存其活動。
值 1 表示同步此日曆的活動，並且在裝置上儲存其活動。
@@ -268,18 +268,18 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
下一節會使用游標逐步檢視結果集。它會使用範例一開始設定好的常數，傳回每個欄位的值。
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
-
+
修改日曆
如要執行日曆的更新，您可以提供日曆的 {@link
-android.provider.BaseColumns#_ID}，可以是 URI 的附加 ID
+android.provider.BaseColumns#_ID}，可以是 URI 的附加 ID
({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}) 或以第一個選擇項目方式提供。
-選項的開頭應該是 "_id=?"，而且第一個
+選項的開頭應該是 "_id=?"，而且第一個
selectionArg 應該是日曆的 {@link
android.provider.BaseColumns#_ID}。
-您也可以透過將 ID 編碼在 URI 中，以執行更新。此範例會使用
+您也可以透過將 ID 編碼在 URI 中，以執行更新。此範例會使用
({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}) 方式變更日曆的顯示名稱：
@@ -434,7 +434,7 @@ android.provider.CalendarContract.Events} 參照。
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -561,7 +561,7 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
@@ -581,11 +581,11 @@ long eventID = Long.parseLong(uri.getLastPathSegment());
android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}) 或以第一個選擇項目方式提供。
-選項的開頭應該是 "_id=?"，而且第一個
+選項的開頭應該是 "_id=?"，而且第一個
selectionArg 應該是活動的 _ID。
您也可以使用不含 ID 的選項進行更新。以下是更新活動的範例。
-它使用
+它使用
{@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()} 方式變更活動的標題：
@@ -598,7 +598,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -625,19 +625,19 @@ ContentValues values = new ContentValues();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().delete(deleteUri, null, null);
-Log.i(DEBUG_TAG, "Rows deleted: " + rows);
+Log.i(DEBUG_TAG, "Rows deleted: " + rows);
@@ -346,7 +346,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -372,7 +372,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
雖然傳統清單和包含圓形按鈕的清單都可提供「單選」動作，但如果您想保留使用者的選擇，請使用 {@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()}。也就是說，如果您想讓對話方塊再次開啟時顯示使用者目前所選的選項，請建立包含圓形按鈕的清單。
@@ -470,7 +470,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -479,7 +479,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -505,7 +505,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -513,10 +513,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -543,7 +543,7 @@ public class NoticeDialogFragment extends DialogFragment {
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -656,7 +656,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -678,7 +678,7 @@ public class CustomDialogFragment extends DialogFragment {
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
diff --git a/docs/html-intl/intl/zh-tw/guide/topics/ui/menus.jd b/docs/html-intl/intl/zh-tw/guide/topics/ui/menus.jd
index be1fa7f0dfdab..6f7405bc00eff 100644
--- a/docs/html-intl/intl/zh-tw/guide/topics/ui/menus.jd
+++ b/docs/html-intl/intl/zh-tw/guide/topics/ui/menus.jd
@@ -83,9 +83,9 @@ parent.link=index.html
@@ -282,7 +282,7 @@ android.view.ViewGroup} 在發送至子檢視時能監控事件。
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html-intl/intl/zh-tw/preview/api-overview.jd b/docs/html-intl/intl/zh-tw/preview/api-overview.jd
index aeace5bdddb2f..e5fdf8d6d61b1 100644
--- a/docs/html-intl/intl/zh-tw/preview/api-overview.jd
+++ b/docs/html-intl/intl/zh-tw/preview/api-overview.jd
@@ -414,7 +414,7 @@ android.os.PowerManager.WakeLock}, {@link android.app.AlarmManager} 鬧鐘和 GP
-
+
支援不同的螢幕
@@ -105,7 +105,7 @@ public void onSaveInstanceState(Bundle savedInstanceState) {
// Save the user's current game state
savedInstanceState.putInt(STATE_SCORE, mCurrentScore);
savedInstanceState.putInt(STATE_LEVEL, mCurrentLevel);
-
+
// Always call the superclass so it can save the view hierarchy state
super.onSaveInstanceState(savedInstanceState);
}
@@ -138,7 +138,7 @@ onCreate()} 中還原某些狀態資料：
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState); // Always call the superclass first
-
+
// Check whether we're recreating a previously destroyed instance
if (savedInstanceState != null) {
// Restore value of members from saved state
@@ -157,12 +157,12 @@ android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}，系統
只有存在要還原的已儲存狀態時，系統才會呼叫 {@link
android.app.Activity#onRestoreInstanceState onRestoreInstanceState()}，因此您無需檢查 {@link android.os.Bundle} 是否為 null：
-
+
public void onRestoreInstanceState(Bundle savedInstanceState) {
// Always call the superclass so it can restore the view hierarchy
super.onRestoreInstanceState(savedInstanceState);
-
+
// Restore state members from saved instance
mCurrentScore = savedInstanceState.getInt(STATE_SCORE);
mCurrentLevel = savedInstanceState.getInt(STATE_LEVEL);
diff --git a/docs/html-intl/intl/zh-tw/training/basics/activity-lifecycle/starting.jd b/docs/html-intl/intl/zh-tw/training/basics/activity-lifecycle/starting.jd
index fae2fa35091d3..b03f22be92005 100644
--- a/docs/html-intl/intl/zh-tw/training/basics/activity-lifecycle/starting.jd
+++ b/docs/html-intl/intl/zh-tw/training/basics/activity-lifecycle/starting.jd
@@ -9,7 +9,7 @@ trainingnavtop=true
@@ -53,7 +53,7 @@ This page provides an overview of some new features and technologies.
Quick Search Box
-
+
New Camera/Camcorder UI
@@ -67,32 +67,32 @@ Battery Usage Indicator
Quick Search Box for Android
-
Android 1.6 includes a redesigned search framework that provides a quick,
-effective, and consistent way for users to search across multiple sources—such as
-browser bookmarks & history, contacts, and the web—directly from
+
Android 1.6 includes a redesigned search framework that provides a quick,
+effective, and consistent way for users to search across multiple sources—such as
+browser bookmarks & history, contacts, and the web—directly from
the home screen.
-
The system constantly learns which search results are more relevant based on what is
-clicked. So popular contacts or apps that have previously been picked will bubble up to
+
The system constantly learns which search results are more relevant based on what is
+clicked. So popular contacts or apps that have previously been picked will bubble up to
the top when a user types the first few letters of a relevant query.
-
The search framework also provides developers a way to easily expose relevant
+
The search framework also provides developers a way to easily expose relevant
content from their applications in Quick Search Box.
Camera, Camcorder, and Gallery
-
An updated user interface provides an integrated camera, camcorder, and gallery experience.
-Users can quickly toggle between still and video capture modes. Additionally, the gallery
+
An updated user interface provides an integrated camera, camcorder, and gallery experience.
+Users can quickly toggle between still and video capture modes. Additionally, the gallery
enables users to select multiple photos for deletion.
Android 1.6 also provides a much faster camera experience.
-Compared to the previous release, launching the camera is now 39% faster,
+Compared to the previous release, launching the camera is now 39% faster,
and there is a 28% improvement in the time from completing one shot to the next.
VPN, 802.1x
-
A new Virtual Private Network (VPN) control panel in Settings allows users
+
A new Virtual Private Network (VPN) control panel in Settings allows users
to configure and connect to the following types of VPNs:
@@ -105,8 +105,8 @@ to configure and connect to the following types of VPNs:
Battery usage indicator
-
A new battery usage screen lets users see which apps and services are consuming
-battery power. If the user determines that a particular service or application is
+
A new battery usage screen lets users see which apps and services are consuming
+battery power. If the user determines that a particular service or application is
using too much power, they can take action to save the battery by
adjusting settings, stopping the application, or uninstalling the application.
@@ -132,11 +132,11 @@ it easier for users to discover great apps and games from developers.
At the homescreen, users can choose among Apps, Games, and Downloads.
Inside a category, users can explore titles that are Top paid, Top free, and Just in.
-
For each title, users can now see screenshots submitted by developers in addition to
+
For each title, users can now see screenshots submitted by developers in addition to
reviews from other users.
-
-
+
+
New Platform Technologies
@@ -145,44 +145,44 @@ it easier for users to discover great apps and games from developers.
The Android search framework has been redesigned and expanded to provide
third-party applications the opportunity to surface
-content from their applications in Quick Search Box, the global search tool.
-To do this, developers will need to make their app "searchable" and provide
+content from their applications in Quick Search Box, the global search tool.
+To do this, developers will need to make their app "searchable" and provide
suggestions in response to user queries.
-To enable application search suggestions, users simply select each application from which
+To enable application search suggestions, users simply select each application from which
they'd like to receive suggestions, under Searchable items in the Search settings.
Text-to-speech engine
-
Android 1.6 features a multi-lingual speech synthesis engine called Pico.
-It allows any Android application to "speak" a string of text with an accent that matches the language.
-The engine supports the following languages: English (American and British accents), French,
-Italian, German and Spanish. If you're using a T-Mobile G1 or Dream device, you'll need to download the
-SpeechSynthesis Data Installer from Google Play, which includes the "voices" needed by the
+
Android 1.6 features a multi-lingual speech synthesis engine called Pico.
+It allows any Android application to "speak" a string of text with an accent that matches the language.
+The engine supports the following languages: English (American and British accents), French,
+Italian, German and Spanish. If you're using a T-Mobile G1 or Dream device, you'll need to download the
+SpeechSynthesis Data Installer from Google Play, which includes the "voices" needed by the
text-to-speech engine.
Gestures
-
A new gestures framework provides application developers with a framework for creating, storing,
+
A new gestures framework provides application developers with a framework for creating, storing,
loading, and recognizing gestures and associating them with specific actions.
-
Developers can use the new GestureBuilder tool included in the Android 1.6 SDK to generate libraries
+
Developers can use the new GestureBuilder tool included in the Android 1.6 SDK to generate libraries
of gestures to include with their application.
Accessibility
-
Android 1.6 provides a new accessibility framework.
-With this framework, developers can create accessibility plugins that respond to user input,
-such as making a sound when a new window is shown, vibrating when navigating to the top of
+
Android 1.6 provides a new accessibility framework.
+With this framework, developers can create accessibility plugins that respond to user input,
+such as making a sound when a new window is shown, vibrating when navigating to the top of
a list, and providing spoken feedback.
Expanded support for screen densities and resolutions
-
Android 1.6 adds screen support that enables applications to be rendered properly on different
-display resolutions and densities. Developers can also specify the types of screens supported by their
+
Android 1.6 adds screen support that enables applications to be rendered properly on different
+display resolutions and densities. Developers can also specify the types of screens supported by their
application.
@@ -208,7 +208,7 @@ application.
New Framework APIs
-
For a detailed overview of new APIs, see the
-Version Notes.
-For a complete report of all API changes, see the
+
For a detailed overview of new APIs, see the
+Version Notes.
+For a complete report of all API changes, see the
API Differences Report.
diff --git a/docs/html/about/versions/android-2.0-highlights.jd b/docs/html/about/versions/android-2.0-highlights.jd
index c16088ad8021b..3f7e1c8cd2386 100644
--- a/docs/html/about/versions/android-2.0-highlights.jd
+++ b/docs/html/about/versions/android-2.0-highlights.jd
@@ -33,7 +33,7 @@ sdk.date=October 2009
@@ -49,7 +49,7 @@ and technologies in Android 2.0.
-
+
New User Features
@@ -99,10 +99,10 @@ when you touch a contact photo or status icon.
@@ -150,7 +150,7 @@ when you touch a contact photo or status icon.
Browser
-
Refreshed UI with actionable browser URL bar enables users to directly
+
Refreshed UI with actionable browser URL bar enables users to directly
tap the address bar for instant searches and navigation.
Bookmarks with web page thumbnails.
Support for double-tap zoom.
@@ -192,10 +192,10 @@ hardware acceleration.
New Framework APIs
Android 2.0 includes several new developer APIs.
-For an overview of new APIs, see the
+For an overview of new APIs, see the
Android 2.0 version notes.
-
For a complete report of all API changes, see the
+
The system image included in the downloadable platform provides a variety of
built-in locales. In some cases, region-specific strings are available for the
locales. In other cases, a default version of the language is used. The
-languages that are available in the Android {@sdkPlatformVersion} system
-image are listed below (with language_country/region locale
+languages that are available in the Android {@sdkPlatformVersion} system
+image are listed below (with language_country/region locale
descriptor).
@@ -203,7 +203,7 @@ descriptor).
-
Localized UI strings match the locales that are accessible
+
Localized UI strings match the locales that are accessible
through Settings.
Emulator Skins
@@ -263,8 +263,8 @@ stored in the system itself. This identifier, called the "API Level", allows the
system to correctly determine whether an application is compatible with
the system, prior to installing the application.
-
To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
-set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <uses-sdk>
+
To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
+set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <uses-sdk>
element in your application's manifest.
For more information about how to use API Level, see the
The system image included in the downloadable platform provides a variety of
built-in locales. In some cases, region-specific strings are available for the
locales. In other cases, a default version of the language is used. The
-languages that are available in the Android {@sdkPlatformVersion} system
-image are listed below (with language_country/region locale
+languages that are available in the Android {@sdkPlatformVersion} system
+image are listed below (with language_country/region locale
descriptor).
@@ -192,7 +192,7 @@ descriptor).
-
Localized UI strings match the locales that are accessible
+
Localized UI strings match the locales that are accessible
through Settings.
Emulator Skins
@@ -242,14 +242,14 @@ through Settings.
API level
The Android {@sdkPlatformVersion} platform delivers an updated version of the framework
-API. As with previous versions, the Android {@sdkPlatformVersion} API
+API. As with previous versions, the Android {@sdkPlatformVersion} API
is assigned an integer identifier — {@sdkPlatformApiLevel} — that is
stored in the system itself. This identifier, called the "API Level", allows the
system to correctly determine whether an application is compatible with
the system, prior to installing the application.
-
To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
-set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <uses-sdk>
+
To use APIs introduced in Android {@sdkPlatformVersion} in your application, you need to
+set the proper value, "{@sdkPlatformApiLevel}", in the attributes of the <uses-sdk>
element in your application's manifest.
For more information about how to use API Level, see the API Level
If your application will use APIs introduced in Android 2.0 (API Level 5),
+
If your application will use APIs introduced in Android 2.0 (API Level 5),
you can take advantage of new APIs for managing key-event pairs:
@@ -363,16 +363,16 @@ method), then invoke the action at key up. Here's a pattern you can use:
If you want to update a legacy application so that its handling of the BACK
-key works properly for both Android 2.0 and older platform versions, you
+key works properly for both Android 2.0 and older platform versions, you
can use an approach similar to that shown above. Your code can catch the
-target button event on key-down, set a flag to track the key event, and
-then also catch the event on key-up, executing the desired action if the tracking
-flag is set. You'll also want to watch for focus changes and clear the tracking
+target button event on key-down, set a flag to track the key event, and
+then also catch the event on key-up, executing the desired action if the tracking
+flag is set. You'll also want to watch for focus changes and clear the tracking
flag when gaining/losing focus.
API differences report
-
For a detailed view of API changes in Android {@sdkPlatformVersion} (API Level {@sdkPlatformApiLevel}), as compared to
+
For a detailed view of API changes in Android {@sdkPlatformVersion} (API Level {@sdkPlatformApiLevel}), as compared to
the previous version, see the API Differences Report.
Adds support for library projects in the Ant build system.
Adds improved layout rendering in ADT’s visual layout editor.
-
+
diff --git a/docs/html/about/versions/android-2.3.3.jd b/docs/html/about/versions/android-2.3.3.jd
index eec0735b08423..91f1d282d1f61 100644
--- a/docs/html/about/versions/android-2.3.3.jd
+++ b/docs/html/about/versions/android-2.3.3.jd
@@ -81,7 +81,7 @@ tag technologies, based on two new intent actions —
android.nfc.action.NDEF_DISCOVERED and
android.nfc.action.TECH_DISCOVERED.
-
The NFC API is available in the {@link android.nfc} and
+
The NFC API is available in the {@link android.nfc} and
{@link android.nfc.tech} packages. The key classes are:
@@ -89,7 +89,7 @@ tag technologies, based on two new intent actions —
{@link android.nfc.NdefMessage}, which represents an NDEF data message,
the standard format in which "records" carrying data are transmitted between
devices and tags. An NDEF message certain many NDEF records of different types.
-Applications can receive these messages from
+Applications can receive these messages from
{@link android.nfc.NfcAdapter#ACTION_NDEF_DISCOVERED NDEF_DISCOVERED},
{@link android.nfc.NfcAdapter#ACTION_TECH_DISCOVERED TECH_DISCOVERED}, or
{@link android.nfc.NfcAdapter#ACTION_TAG_DISCOVERED TAG_DISCOVERED} Intents.
@@ -124,15 +124,15 @@ NFC. To request filtering, add
<uses-feature android:name="android.hardware.nfc"
android:required="true"> to the application's manifest.
-
For more information, read the
+
For more information, read the
NFC developer guide.
Bluetooth
Android 2.3.3 adds platform and API support for Bluetooth nonsecure socket
connections. This lets applications communicate with simple devices that may not
-offer a UI for authentication. See
-{@link android.bluetooth.BluetoothDevice#createInsecureRfcommSocketToServiceRecord(java.util.UUID)} and
+offer a UI for authentication. See
+{@link android.bluetooth.BluetoothDevice#createInsecureRfcommSocketToServiceRecord(java.util.UUID)} and
{@link android.bluetooth.BluetoothAdapter#listenUsingInsecureRfcommWithServiceRecord(java.lang.String, java.util.UUID)}
for more information.
@@ -183,7 +183,7 @@ the system, prior to installing the application.
To use APIs introduced in Android {@sdkPlatformVersion} in your application,
you need compile the application against the Android library that is provided in
-the Android {@sdkPlatformVersion} SDK platform. Depending on your needs, you might
+the Android {@sdkPlatformVersion} SDK platform. Depending on your needs, you might
also need to add an android:minSdkVersion="{@sdkPlatformApiLevel}"
attribute to the <uses-sdk> element in the application's
manifest. If your application is designed to run only on Android 2.3 and higher,
diff --git a/docs/html/about/versions/android-2.3.4.jd b/docs/html/about/versions/android-2.3.4.jd
index 963df9a7f51c4..8705d1d50dec3 100644
--- a/docs/html/about/versions/android-2.3.4.jd
+++ b/docs/html/about/versions/android-2.3.4.jd
@@ -31,7 +31,7 @@ Differences Report »
Android 2.3.4 ({@link android.os.Build.VERSION_CODES#GINGERBREAD_MR1})
is a maintenance release that adds several bug fixes and patches
-to the Android 2.3 platform, without any API changes from Android 2.3.3. Additionally,
+to the Android 2.3 platform, without any API changes from Android 2.3.3. Additionally,
Android 2.3.4 brings support for the Open Accessory API to mobile devices,
through the optional Open Accessory Library.
Applications can obtain an instance of the {@link android.app.DownloadManager}
class by calling {@link
android.content.Context#getSystemService(String)} and passing
-{@link android.content.Context#DOWNLOAD_SERVICE}. Applications that request
+{@link android.content.Context#DOWNLOAD_SERVICE}. Applications that request
downloads through this API should register a broadcast receiver for {@link
android.app.DownloadManager#ACTION_NOTIFICATION_CLICKED}, to appropriately
handle when the user clicks on a running download in a notification or from the
@@ -690,7 +690,7 @@ the system, prior to installing the application.
To use APIs introduced in Android {@sdkPlatformVersion} in your application,
you need compile the application against the Android library that is provided in
-the Android {@sdkPlatformVersion} SDK platform. Depending on your needs, you might
+the Android {@sdkPlatformVersion} SDK platform. Depending on your needs, you might
also need to add an android:minSdkVersion="{@sdkPlatformApiLevel}"
attribute to the <uses-sdk> element in the application's
manifest. If your application is designed to run only on Android 2.3 and higher,
diff --git a/docs/html/about/versions/android-3.0-highlights.jd b/docs/html/about/versions/android-3.0-highlights.jd
index 21dbda6af4ced..e9d2b392ed987 100644
--- a/docs/html/about/versions/android-3.0-highlights.jd
+++ b/docs/html/about/versions/android-3.0-highlights.jd
@@ -40,7 +40,7 @@ page.title=Honeycomb
Welcome to Android 3.0!
-
The Android 3.0 platform introduces many new and exciting features for users and developers.
+
The Android 3.0 platform introduces many new and exciting features for users and developers.
This document provides a glimpse of some of the new features and technologies, as delivered in
Android 3.0. For a more detailed look at new developer APIs, see the Android 3.0 Platform document.
Android 3.0 is a new version of the Android platform that is specifically optimized for devices with larger screen sizes, particularly tablets. It introduces a brand new, truly virtual and “holographic” UI design, as well as an elegant, content-focused interaction model.
-
Android 3.0 builds on the things people love most about Android — refined multitasking, rich notifications, Home screen customization, widgets, and more — and transforms them with a vibrant, 3D experience and deeper interactivity, making them familiar but even better than before.
+
Android 3.0 builds on the things people love most about Android — refined multitasking, rich notifications, Home screen customization, widgets, and more — and transforms them with a vibrant, 3D experience and deeper interactivity, making them familiar but even better than before.
The new UI brings fresh paradigms for interaction, navigation, and customization and makes them available to all applications — even those built for earlier versions of the platform. Applications written for Android 3.0 are able to use an extended set of UI objects, powerful graphics, and media capabilities to engage users in new ways.
Multiple-choice selection for ListView and GridView
New {@link android.widget.AbsListView#CHOICE_MODE_MULTIPLE_MODAL} mode for {@link
@@ -419,9 +419,9 @@ java
class in the API Demos sample application.
-
+
New APIs to transform views
-
+
New APIs allow you to easily apply 2D and 3D transformations to views in your activity
layout. New transformations are made possible with a set of object properties that define the view's
layout position, orientation, transparency and more.
@@ -452,7 +452,7 @@ animator.start();
-
+
New holographic themes
The standard system widgets and overall look have been redesigned and incorporate a new
@@ -475,55 +475,55 @@ href="{@docRoot}guide/topics/ui/themes.html#SelectATheme">select a theme based o
version.
-
-
+
+
New widgets
{@link android.widget.AdapterViewAnimator}
Base class for an {@link android.widget.AdapterView} that performs animations when switching
between its views.
-
+
{@link android.widget.AdapterViewFlipper}
Simple {@link android.widget.ViewAnimator} that animates between two or more views that have
been added to it. Only one child is shown at a time. If requested, it can automatically flip
between
each child at a regular interval.
-
+
{@link android.widget.CalendarView}
Allows users to select dates from a calendar by touching the date and can scroll or fling the
calendar to a desired date. You can configure the range of dates available in the widget.
-
+
{@link android.widget.ListPopupWindow}
Anchors itself to a host view and displays a list of choices, such as for a list of
suggestions when typing into an {@link android.widget.EditText} view.
-
+
{@link android.widget.NumberPicker}
Enables the user to select a number from a predefined range. The widget presents an input
field and up and down buttons for selecting a number. Touching the input field allows the user to
scroll through values or touch again to directly edit the current value. It also allows you to map
positions to strings, so that the corresponding string is displayed instead of the index
position.
-
+
{@link android.widget.PopupMenu}
Displays a {@link android.view.Menu} in a modal popup window that's anchored to a view. The
popup appears below the anchor view if there is room, or above it if there is not. If the IME (soft
keyboard) is visible, the popup does not overlap the IME it until the user touches the
menu.
-
+
{@link android.widget.SearchView}
Provides a search box that you can configure to deliver search queries to a specified
activity and display search suggestions (in the same manner as the traditional search dialog). This
widget is particularly useful for offering a search widget in the Action Bar. For more information,
see Creating a Search Interface.
-
+
{@link android.widget.StackView}
A view that displays its children in a 3D stack and allows users to swipe through
views like a rolodex.
-
+
-
+
@@ -545,7 +545,7 @@ smoother scrolling, and overall better performance and response to user interact
View support for hardware and software layers
-
+
By default, a {@link android.view.View} has no layer specified. You can specify that the
view be backed by either a hardware or software layer, specified by values {@link
android.view.View#LAYER_TYPE_HARDWARE} and {@link android.view.View#LAYER_TYPE_SOFTWARE}, using
@@ -563,7 +563,7 @@ software layer, which can potentially be slow.
For more information, see the {@link android.view.View#LAYER_TYPE_HARDWARE} and {@link
android.view.View#LAYER_TYPE_SOFTWARE} documentation.
-
+
Renderscript 3D graphics engine
@@ -591,7 +591,7 @@ android.media.MediaRecorder#setCaptureRate setCaptureRate()} sets the rate at wh
should be captured.
Texture support for image streams
-
+
New {@link android.graphics.SurfaceTexture} allows you to capture an image stream as an OpenGL ES
texture. By calling {@link android.hardware.Camera#setPreviewTexture setPreviewTexture()} for your
{@link android.hardware.Camera} instance, you can specify the {@link
@@ -599,7 +599,7 @@ android.graphics.SurfaceTexture} upon which to draw video playback or preview fr
camera.
HTTP Live streaming
-
+
Applications can now pass an M3U playlist URL to the media framework to begin an HTTP Live
streaming session. The media framework supports most of the HTTP Live streaming specification,
including adaptive bit rate. See the Supported Media Formats d
more information.
EXIF data
-
+
The {@link android.media.ExifInterface} includes new fields for photo aperture, ISO, and exposure
time.
@@ -810,7 +810,7 @@ expressed with acceleration and rotation rate data. A web page can register for
events by calling {@code window.addEventListener} with event type {@code "deviceorientation"}
and register for motion events by registering the {@code "devicemotion"} event type.
-
+
CSS 3D Transforms
As defined by the CSS 3D Transform
Module specification, the Browser allows elements rendered by CSS to be transformed in three
@@ -967,7 +967,7 @@ the system, prior to installing the application.
To use APIs introduced in Android {@sdkPlatformVersion} in your application,
you need compile the application against the Android library that is provided in
-the Android {@sdkPlatformVersion} SDK platform. Depending on your needs, you might
+the Android {@sdkPlatformVersion} SDK platform. Depending on your needs, you might
also need to add an android:minSdkVersion="{@sdkPlatformApiLevel}"
attribute to the <uses-sdk> element in the application's
manifest. If your application is designed to run only on Android 2.3 and higher,
diff --git a/docs/html/about/versions/android-3.1-highlights.jd b/docs/html/about/versions/android-3.1-highlights.jd
index 5283c2a458615..2a706989f4719 100644
--- a/docs/html/about/versions/android-3.1-highlights.jd
+++ b/docs/html/about/versions/android-3.1-highlights.jd
@@ -93,7 +93,7 @@ device.
The platform also adds new support for USB accessories — external
hardware devices designed to attach to Android-powered devices as USB hosts. When an
accessory is attached, the framework will look for a corresponding application
-and offer to launch it for the user. The accessory can also present a URL
+and offer to launch it for the user. The accessory can also present a URL
to the user, for downloading an appropriate application if one is not already
installed. Users can interact with the application to control powered accessories such
as robotics controllers; docking stations; diagnostic and musical equipment;
@@ -215,7 +215,7 @@ indicator to let users see how much space is available.
-
Figure
+
Figure
4. Home screen widgets can now be resized.
Calendar
diff --git a/docs/html/about/versions/android-3.1.jd b/docs/html/about/versions/android-3.1.jd
index cdcf51eee6294..e1486bef7da82 100644
--- a/docs/html/about/versions/android-3.1.jd
+++ b/docs/html/about/versions/android-3.1.jd
@@ -240,7 +240,7 @@ and game controllers include
android.view.MotionEvent#AXIS_HAT_Y}, {@link
android.view.MotionEvent#AXIS_RTRIGGER}, {@link
android.view.MotionEvent#AXIS_ORIENTATION}, {@link
-android.view.MotionEvent#AXIS_THROTTLE}, and many others.
+android.view.MotionEvent#AXIS_THROTTLE}, and many others.
Existing {@link android.view.MotionEvent} axes are represented by {@link
android.view.MotionEvent#AXIS_X}, {@link android.view.MotionEvent#AXIS_Y},
{@link android.view.MotionEvent#AXIS_PRESSURE}, {@link
@@ -299,7 +299,7 @@ each axis value.
Finally, since the motion events from joysticks, gamepads, mice, and
trackballs are not touch events, the platform adds a new callback method for
passing them to a {@link android.view.View} as "generic" motion events.
-Specifically, it reports the non-touch motion events to
+Specifically, it reports the non-touch motion events to
{@link android.view.View}s through a call to {@link
android.view.View#onGenericMotionEvent(android.view.MotionEvent)
onGenericMotionEvent()}, rather than to {@link
@@ -318,7 +318,7 @@ onGenericMotionEvent()} there instead.
To look at a sample application that uses joystick motion
events, see GameControllerInput
+href="{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/view/GameControllerInput.html">GameControllerInput
and GameView.
diff --git a/docs/html/about/versions/android-3.2.jd b/docs/html/about/versions/android-3.2.jd
index 887755cfefb2e..c6df7f5ddab60 100644
--- a/docs/html/about/versions/android-3.2.jd
+++ b/docs/html/about/versions/android-3.2.jd
@@ -132,7 +132,7 @@ provides these tools:
New resource qualifiers for targeting layouts and other resources to a
-minimum smallestWidth, width, or height, and
+minimum smallestWidth, width, or height, and
New manifest attributes, for specifying the app's maximum
screen compatibility range
@@ -201,7 +201,7 @@ the resource should be used, measured in "dp" units. As mentioned above, a
screen's smallestWidth is constant, regardless of orientation. Examples:
sw320dp, sw720dp, sw720dp.
-
wNNNdp and hNNNdp — Specifies the minimum
+
wNNNdp and hNNNdp — Specifies the minimum
width or height on which the resource should be used, measured in "dp" units. As
mentioned above, a screen's width and height are relative to the orientation of
the screen and change whenever the orientation changes. Examples:
@@ -214,7 +214,7 @@ dp, others for wider than 600 dp, and others for wider than 720 dp. When
multiple resource configurations are qualified for a given screen, the system
selects the configuration that is the closest match. For precise control over
which resources are loaded on a given screen, you can tag resources with one
-qualifier or combine several new or existing qualifiers.
+qualifier or combine several new or existing qualifiers.
Based on the typical dimensions listed earlier, here are some examples of how
you could use the new qualifiers:
diff --git a/docs/html/about/versions/android-4.0.3.jd b/docs/html/about/versions/android-4.0.3.jd
index 3be684df63b27..bcfa35c94bce8 100644
--- a/docs/html/about/versions/android-4.0.3.jd
+++ b/docs/html/about/versions/android-4.0.3.jd
@@ -102,16 +102,16 @@ android:name="android.permission.WRITE_SOCIAL_STREAM"> in their manife
Adds the class {@link android.provider.CalendarContract.Colors} to represent
a color table in the Calendar
Provider. The class provides fields for accessing
-colors available for a given account. Colors are referenced by
+colors available for a given account. Colors are referenced by
{@link android.provider.CalendarContract.ColorsColumns#COLOR_KEY COLOR_KEY}
which must be unique for a given account name/type. These values can only be
updated by the sync adapter.
Adds {@link android.provider.CalendarContract.AttendeesColumns#TYPE_RESOURCE}
-(such as conference rooms) for attendees and
+(such as conference rooms) for attendees and
{@link android.provider.CalendarContract.EventsColumns#AVAILABILITY_TENTATIVE},
as well as {@link android.provider.CalendarContract.EventsColumns#EVENT_COLOR_KEY}
for events.
@@ -123,7 +123,7 @@ for events.
own padding. Instead, the system now automatically adds padding for each widget,
based the characteristics of the current screen. This leads to a more uniform,
consistent presentation of widgets in a grid. To assist applications that host
-home screen widgets, the platform provides a new method
+home screen widgets, the platform provides a new method
{@link android.appwidget.AppWidgetHostView#getDefaultPaddingForWidget(android.content.Context, android.content.ComponentName, android.graphics.Rect)
getDefaultPaddingForWidget()}. Applications can call this method to get the
system-defined padding and account for it when computing the number of cells to
@@ -136,7 +136,7 @@ allocate to the widget.
android.view.textservice.SpellCheckerSession#cancel() cancel()} method cancels
any pending and running spell-checker tasks in a session.
-
For spell-checker services, a new suggestions flag,
+
For spell-checker services, a new suggestions flag,
{@link android.view.textservice.SuggestionsInfo#RESULT_ATTR_HAS_RECOMMENDED_SUGGESTIONS},
lets the services distinguish higher-confidence suggestions from
lower-confidence ones. For example, a spell-checker could set the flag if an
@@ -206,8 +206,8 @@ the inflated layout.
allow apps to get and set the maximum scroll offset for an
{@link android.view.accessibility.AccessibilityRecord} object.
-
When touch-exploration mode is enabled, a new secure setting
-{@link android.provider.Settings.Secure#ACCESSIBILITY_SPEAK_PASSWORD}
+
When touch-exploration mode is enabled, a new secure setting
+{@link android.provider.Settings.Secure#ACCESSIBILITY_SPEAK_PASSWORD}
indicates whether the user requests the IME to speak text entered in password fields, even when
a headset is not in use. By default, no password text is spoken unless a headset
is in use.
Android now includes a personal profile that represents the device owner, as defined by the
-{@link android.provider.ContactsContract.Profile} table. Social apps that maintain a user identity
+{@link android.provider.ContactsContract.Profile} table. Social apps that maintain a user identity
can contribute to the user's profile data by creating a new {@link
android.provider.ContactsContract.RawContacts} entry within the {@link
android.provider.ContactsContract.Profile}. That is, raw contacts that represent the device user do
@@ -210,7 +210,7 @@ used by the sync adapter. The provider takes no action with items in this table
them when their related events are deleted.
-
To access a user’s calendar data with the Calendar Provider, your application must request
+
To access a user’s calendar data with the Calendar Provider, your application must request
the {@link android.Manifest.permission#READ_CALENDAR} permission (for read access) and
{@link android.Manifest.permission#WRITE_CALENDAR} (for write access).
@@ -850,7 +850,7 @@ android.view.accessibility.AccessibilityRecord} (there may be several records at
event).
From either {@link android.view.accessibility.AccessibilityEvent} or an individual {@link
-android.view.accessibility.AccessibilityRecord}, you can call {@link
+android.view.accessibility.AccessibilityRecord}, you can call {@link
android.view.accessibility.AccessibilityRecord#getSource() getSource()} to retrieve a {@link
android.view.accessibility.AccessibilityNodeInfo} object.
An {@link android.view.accessibility.AccessibilityNodeInfo} represents a single node
diff --git a/docs/html/about/versions/android-4.1.jd b/docs/html/about/versions/android-4.1.jd
index 4131c36fe1ca8..4d7cb85f43351 100644
--- a/docs/html/about/versions/android-4.1.jd
+++ b/docs/html/about/versions/android-4.1.jd
@@ -103,8 +103,8 @@ useful new APIs for app developers.
-
-
+
+
Declare your app API Level
To better optimize your app for devices running Android {@sdkPlatformVersion},
@@ -117,7 +117,7 @@ test it, then publish an update with this change.
can use APIs in Android {@sdkPlatformVersion} while also supporting older versions by adding
conditions to your code that check for the system API level before executing
APIs not supported by your {@code minSdkVersion}.
+href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#min">{@code minSdkVersion}.
To learn more about
maintaining backward-compatibility, read Creating Backward-Compatible
@@ -148,15 +148,15 @@ app on Android 4.1.
By specifying {@code android:isolatedProcess="true"} in the
{@code } tag, your {@link android.app.Service} will run under
its own isolated user ID process that has no permissions of its own.
Memory management
-
New {@link android.content.ComponentCallbacks2} constants such as {@link
-android.content.ComponentCallbacks2#TRIM_MEMORY_RUNNING_LOW} and {@link
+
New {@link android.content.ComponentCallbacks2} constants such as {@link
+android.content.ComponentCallbacks2#TRIM_MEMORY_RUNNING_LOW} and {@link
android.content.ComponentCallbacks2#TRIM_MEMORY_RUNNING_CRITICAL} provide foreground
processes more information about
memory state before the system calls {@link android.app.Activity#onLowMemory()}.
@@ -178,7 +178,7 @@ app.
Live Wallpapers
New intent protocol to directly launch the live wallpaper preview activity so you can help
- users easily select your live wallpaper without forcing them to leave
+ users easily select your live wallpaper without forcing them to leave
your app and navigate through the Home wallpaper picker.
To launch the live wallpaper picker, call {@link android.content.Context#startActivity
@@ -207,7 +207,7 @@ creates the appropriate activity.
Note: When the user enters a deep activity in your app and
- it creates a new task for your app, the system actually inserts the stack of parent activities
+
Note: When the user enters a deep activity in your app and
+ it creates a new task for your app, the system actually inserts the stack of parent activities
into the task. As such, pressing the Back button also navigates back through the stack of parent
activities.
-
When the system creates a synthetic back stack for your app, it builds a basic {@link
+
When the system creates a synthetic back stack for your app, it builds a basic {@link
android.content.Intent} to create a new instance of each parent activity. So there's no
saved state for the parent activities the way you'd expect had the user naturally navigated
through
@@ -251,9 +251,9 @@ you want to modify the {@link android.content.Intent} for the activity's parent,
the length of the array with {@link android.app.TaskStackBuilder#getIntentCount()} and pass that
value to {@link android.app.TaskStackBuilder#editIntentAt editIntentAt()}.
-
If your app structure is more complex, there are several other APIs
+
If your app structure is more complex, there are several other APIs
available that allow you to handle the behavior of Up navigation and
- fully customize the synthetic back stack. Some of the APIs that give you additional
+ fully customize the synthetic back stack. Some of the APIs that give you additional
control include:
Internet use—and smartphone penetration—is growing fastest in markets with
- low, intermittent, or expensive connectivity. Successful apps in these
- markets need to perform across a variety of speeds and devices, as well as
+ low, intermittent, or expensive connectivity. Successful apps in these
+ markets need to perform across a variety of speeds and devices, as well as
conserve and share information about battery and data consumption.
To help you address these important considerations, we’ve compiled the
- following checklist. These do not follow a particular order, and as
- always it's a good idea to research particularities of any market or country
- you're targeting.
+ following checklist. These do not follow a particular order, and as
+ always it's a good idea to research particularities of any market or country
+ you're targeting.
Serve WebP files over the
- network. WebP reduces image load times, saves network bandwidth, and often
- results in smaller file sizes than its PNG and JPG counterparts, with at
- least the same image quality. Even at lossy settings, WebP can produce a
- nearly identical image. Android has had lossy WebP support since
- Android 4.0 (API level 14: Ice Cream Sandwich) and support for lossless /
+ href="https://developers.google.com/speed/webp/">WebP
files over the
+ network. WebP reduces image load times, saves network bandwidth, and often
+ results in smaller file sizes than its PNG and JPG counterparts, with at
+ least the same image quality. Even at lossy settings, WebP can produce a
+ nearly identical image. Android has had lossy WebP support since
+ Android 4.0 (API level 14: Ice Cream Sandwich) and support for lossless /
transparent WebP since Android 4.2 (API level 17: Jelly Bean).
Dynamic image sizing
Have your apps request images at the targeted rendering size, and have
- your server provide those images to fit; the target rendering size will
- vary based on device specifications. Doing this minimizes the network
- overhead and reduces the amount of memory needed to hold each image,
+ your server provide those images to fit; the target rendering size will
+ vary based on device specifications. Doing this minimizes the network
+ overhead and reduces the amount of memory needed to hold each image,
resulting in improved performance and user satisfaction.
Your user experience degrades when users are waiting for images to
- download. Using appropriate image sizes helps to address these issues.
- Consider making image size requests based on network type or network
+ download. Using appropriate image sizes helps to address these issues.
+ Consider making image size requests based on network type or network
quality; this size could be smaller than the target rendering size.
Dynamic placeholders like
- pre-computed palette values or low-resolution thumbnails can improve
+ pre-computed palette values or low-resolution thumbnails can improve
the user experience while the image is being fetched.
Use image loading libraries
Your app should not have to fetch any image more than once. Image
- loading libraries such as Glide and Picasso
- fetch the image, cache it, and provide hooks into your Views to show
- placeholder images until the actual images are ready. Because images are
- cached, these libraries return the local copy the next time they are
+ loading libraries such as Glide and Picasso
+ fetch the image, cache it, and provide hooks into your Views to show
+ placeholder images until the actual images are ready. Because images are
+ cached, these libraries return the local copy the next time they are
requested.
Image-loading libraries manage their cache, holding onto the most recent
images so that your app storage doesn’t grow indefinitely.
In places like subways, planes, elevators, and parking garages, it is
- common for devices to lose network connectivity. Creating a useful offline
- state results in users being able to interact with the app at all times, by
- presenting cached information. Ensure that your app is usable offline or
- when network connectivity is poor by storing data locally, caching data,
+ common for devices to lose network connectivity. Creating a useful offline
+ state results in users being able to interact with the app at all times, by
+ presenting cached information. Ensure that your app is usable offline or
+ when network connectivity is poor by storing data locally, caching data,
and queuing outbound requests for when connectivity is restored.
Where possible, apps should not notify users that connectivity has
- been lost. It is only when the user performs an operation where connectivity
+ been lost. It is only when the user performs an operation where connectivity
is essential that the user needs to be notified.
When a device lacks connectivity, your app should batch up network
- requests—on behalf of the user—that can be executed when
- connectivity is restored. An example of this is an email client that allows
- users to compose, send, read, move, and delete existing mails even when the
- device is offline. These operations can be cached and executed when
- connectivity is restored. In doing so, the app is able to provide a similar
+ requests—on behalf of the user—that can be executed when
+ connectivity is restored. An example of this is an email client that allows
+ users to compose, send, read, move, and delete existing mails even when the
+ device is offline. These operations can be cached and executed when
+ connectivity is restored. In doing so, the app is able to provide a similar
user experience whether the device is online or offline.
Use GcmNetworkManager and/or Content Providers
Ensure that your app stores all data on disk via a database or similar
- structure so that it performs optimally regardless of network conditions
- (for example, via SQLite + ContentProvider). The
- GCM Network Manager
+ GCM Network Manager
(
- GcmNetworkManager) can result in a robust mechanism to
- sync data with servers while content
- providers ({@link android.content.ContentProvider}) cache that data,
+ GcmNetworkManager) can result in a robust mechanism to
+ sync data with servers while content
+ providers ({@link android.content.ContentProvider}) cache that data,
combining to provide an architecture that enables a useful offline state.
Apps should cache content that is fetched from the network. Before making
- subsequent requests, apps should display locally cached data. This ensures
- that the app is functional regardless of whether the device is offline or
+ subsequent requests, apps should display locally cached data. This ensures
+ that the app is functional regardless of whether the device is offline or
on a slow/unreliable network.
Deduplicate network requests
An offline-first architecture initially tries to fetch data from local
- storage and, failing that, requests the data from the network. After being
- retrieved from the network, the data is cached locally for future
- retrieval. This helps to ensure that network requests for the same piece of
- data only occur once—the rest of the requests are satisfied locally. To
- achieve this, use a local database for long-lived data (usually
- {@link android.database.sqlite} or
+ storage and, failing that, requests the data from the network. After being
+ retrieved from the network, the data is cached locally for future
+ retrieval. This helps to ensure that network requests for the same piece of
+ data only occur once—the rest of the requests are satisfied locally. To
+ achieve this, use a local database for long-lived data (usually
+ {@link android.database.sqlite} or
{@link android.content.SharedPreferences}).
An offline-first architecture always looks for data locally first, then
- makes the request over the network. The response is cached and then returned
- locally. Such an architecture simplifies an app’s flow between offline and
- online states as one side fetches from the network to the cache, while the
+ makes the request over the network. The response is cached and then returned
+ locally. Such an architecture simplifies an app’s flow between offline and
+ online states as one side fetches from the network to the cache, while the
other retrieves data from the cache to present to the user.
For transitory data, use a bounded disk cache such as a DiskLruCache
- . Data that doesn’t typically change should only be requested once over
- the network and cached for future use. Examples of such data are images and
+ . Data that doesn’t typically change should only be requested once over
+ the network and cached for future use. Examples of such data are images and
non-temporal documents like news articles or social posts.
Writers of apps should not assume that any network that the device is
- connected to is long-lasting or reliable. For this reason, apps should
- prioritize network requests to display the most useful information to the
+ connected to is long-lasting or reliable. For this reason, apps should
+ prioritize network requests to display the most useful information to the
user as soon as possible.
Presenting users with visible and relevant information immediately is a
- better user experience than making them wait for information that might not
- be necessary. This reduces the time that the user has to wait and
+ better user experience than making them wait for information that might not
+ be necessary. This reduces the time that the user has to wait and
increases the usefulness of the app on slow networks.
The ability for your app to transfer data in a timely fashion is
- dependent on the network connection. Detecting the quality of the network
- and adjusting the way your app uses it can help provide an excellent user
+ dependent on the network connection. Detecting the quality of the network
+ and adjusting the way your app uses it can help provide an excellent user
experience.
You can use the following methods to detect the underlying network
- quality. Using the data from these methods, your app should tailor its use
+ quality. Using the data from these methods, your app should tailor its use
of the network to continue to provide a timely response to user actions:
On slower connections, consider downloading only lower-resolution media
- or perhaps none at all. This ensures that your users are still able to use
- the app on slow connections. Where you don’t have an image or the image is
- still loading, you should always show a placeholder. You can create a
- dynamic placeholder by using the
- Palette library to generate placeholder colors that match the target
+ Palette library to generate placeholder colors that match the target
image.
Network quality is not static; it changes based on location, network
- traffic, and local population density. Apps should detect changes in
- network and adjust bandwidth accordingly. By doing so, your app can tailor
- the user experience to the network quality. Detect network state using
+ traffic, and local population density. Apps should detect changes in
+ network and adjust bandwidth accordingly. By doing so, your app can tailor
+ the user experience to the network quality. Detect network state using
these methods:
As the network quality degrades, scale down the number and size of
- requests. As the connection quality improves, you can scale up your
+ requests. As the connection quality improves, you can scale up your
requests to optimal levels.
The broadcast
- CONNECTIVITY_CHANGE is sent when a change in network
- connectivity occurs. When your app is in the foreground, you can call CONNECTIVITY_CHANGE is sent when a change in network
+ connectivity occurs. When your app is in the foreground, you can call
- registerReceiver to receive this broadcast. After receiving
- the broadcast, you should reevaluate the current network state and adjust
- your UI and network usage appropriately. You should not declare this receiver
- in your manifest, as it will no longer function beginning with Android N.
+ registerReceiver to receive this broadcast. After receiving
+ the broadcast, you should reevaluate the current network state and adjust
+ your UI and network usage appropriately. You should not declare this receiver
+ in your manifest, as it will no longer function beginning with Android N.
For more details see
Android N behavior changes.
Reaching new users means supporting an increasing variety of Android
- platform versions and device specifications. Optimize for common RAM and
+ platform versions and device specifications. Optimize for common RAM and
screen sizes and resolutions to improve the user experience.
Support varying screen sizes
Use density-independent pixels (dp)
Defining layout dimensions with pixels is a problem because different
- screens have different pixel densities, so the same number of pixels may
- correspond to different physical sizes on different devices. The
- density-independent pixel (dp) corresponds to the physical size of a pixel
+ screens have different pixel densities, so the same number of pixels may
+ correspond to different physical sizes on different devices. The
+ density-independent pixel (dp) corresponds to the physical size of a pixel
at 160 dots per inch (mdpi density).
Defining layouts with dp ensures that the physical size of your user
- interface is consistent regardless of device. Visit the Android
- guide on
- Supporting Multiple Screens for best practices using
+ Supporting Multiple Screens for best practices using
density-independent pixels.
Test graphics on ldpi/mdpi screen densities
Ensure that your app layouts work well on low- and medium-density
- (ldpi/mdpi) screens because these are
- common densities, especially in lower-cost devices. Testing on
- lower-density screens helps to validate that your layouts are legible on
+ common densities, especially in lower-cost devices. Testing on
+ lower-density screens helps to validate that your layouts are legible on
lower-density screens.
Lower-density screens can result in unclear text where the finer details
- aren't visible. The Material Design guidelines describe
- metrics and keylines to ensure that your layouts can scale across
+ metrics and keylines to ensure that your layouts can scale across
screen densities.
Devices with lower-density screens tend to have lower hardware
- specifications. To ensure that your app performs well on these devices,
- consider reducing or eliminating heavy loads, such as animations and
- transitions. For more information on supporting different densities, see
- the Android training on
Supporting Different Densities.
Test layouts on small/medium screen sizes
Validate that your layouts scale down by testing on smaller screens. As
- screen sizes shrink, be very selective about visible UI elements, because
+ screen sizes shrink, be very selective about visible UI elements, because
there is limited space for them.
Devices with smaller screens tend to have lower hardware specifications.
- To ensure that your app performs well on these devices, try reducing or
- eliminating heavy loads, such as animations or transitions. For more
- information on supporting different screen sizes, see the Android
- training on
Supporting Different Screen Sizes.
Apps should build and target a recent version of Android to ensure most
- current behavior across a broad range of devices; this still provides
- backward compatibility to older versions. Here are the best practices for
+ current behavior across a broad range of devices; this still provides
+ backward compatibility to older versions. Here are the best practices for
targeting API levels appropriately:
- {@code targetSdkVersion} should be the latest version of Android.
- Targeting the most recent version ensures that your app inherits newer
- runtime behaviors when running newer versions of Android. Be sure to
- test your app on newer Android versions when updating the
+ {@code targetSdkVersion} should be the latest version of Android.
+ Targeting the most recent version ensures that your app inherits newer
+ runtime behaviors when running newer versions of Android. Be sure to
+ test your app on newer Android versions when updating the
targetSdkVersion as it can affect app behavior.
- {@code minSdkVersion} sets the minimum supported Android version.
- Use Android 4.0 (API level 14: Ice Cream Sandwich) or Android 4.1 (API
- level 16: Jelly Bean)—these versions give maximum coverage for modern
- devices. Setting {@code minSdkVersion} also results in the Android build
- tools reporting incorrect use of new APIs that might not be available in
- older versions of the platform. By doing so, developers are protected
+ {@code minSdkVersion} sets the minimum supported Android version.
+ Use Android 4.0 (API level 14: Ice Cream Sandwich) or Android 4.1 (API
+ level 16: Jelly Bean)—these versions give maximum coverage for modern
+ devices. Setting {@code minSdkVersion} also results in the Android build
+ tools reporting incorrect use of new APIs that might not be available in
+ older versions of the platform. By doing so, developers are protected
from inadvertently breaking backward compatibility.
Ensure your app provides a consistent experience across OS versions by
using the Google-provided support libraries such as AppCompat and the Design
- Support Library. The Android Support Library package is a set of code
- libraries that provides backward-compatible versions of Android framework
+ Support Library. The Android Support Library package is a set of code
+ libraries that provides backward-compatible versions of Android framework
APIs as well as features that are only available through the library APIs.
Some of the the highlights include:
v4 & v7 support library: Many framework APIs for older versions of
- Android such as {@link android.support.v4.view.ViewPager},
- {@link android.app.ActionBar},
- {@link android.support.v7.widget.RecyclerView}, and
+ Android such as {@link android.support.v4.view.ViewPager},
+ {@link android.app.ActionBar},
+ {@link android.support.v7.widget.RecyclerView}, and
{@link android.support.v7.graphics.Palette}.
Design
- Support library: APIs to support adding Material Design components
+ Support library: APIs to support adding Material Design components
and patterns to your apps.
- Multidex Support library: provides support for large apps that have
- more than 65K methods. This can happen if your app is using many
- libraries.
+ Multidex Support library: provides support for large apps that have
+ more than 65K methods. This can happen if your app is using many
+ libraries.
, which provides much of Android 5.0’s
{@link android.app.job.JobScheduler} API for older versions of Android.
Updates to Google Play services are distributed automatically by the
- Google Play Store, and new versions of the client library are delivered
+ Google Play Store, and new versions of the client library are delivered
through the Android SDK Manager.
Adjusting your memory footprint dynamically helps to ensure compatibility
across devices with different RAM configurations.
Methods such as {@link android.app.ActivityManager#isLowRamDevice} and
- {@link android.app.ActivityManager#getMemoryClass()} help determine memory
- constraints at runtime. Based on this information, you can scale down your
- memory usage. As an example, you can use lower resolution images on low memory
+ {@link android.app.ActivityManager#getMemoryClass()} help determine memory
+ constraints at runtime. Based on this information, you can scale down your
+ memory usage. As an example, you can use lower resolution images on low memory
devices.
Long-running processes stay resident in memory and can result in slowing
- down the device. In most situations, your app should wake up for a given
- event, process data, and shut down. You should use Google Cloud Messaging
- (GCM) and/or Google Cloud Messaging
+ (GCM) and/or
- GcmNetworkManager to avoid long running background
+ GcmNetworkManager to avoid long running background
services and reduce memory pressure on the user’s device.
Benchmark memory usage
Android Studio provides memory benchmarking and profiling tools, enabling
you to measure memory usage at run time. Benchmarking your app’s memory
- footprint enables you to monitor memory usage over multiple versions of
- the app. This can help catch unintentional memory footprint growth. These
+ footprint enables you to monitor memory usage over multiple versions of
+ the app. This can help catch unintentional memory footprint growth. These
tools can be used in the following ways:
Use the Memory
- Monitor tool to find out whether undesirable garbage collection (GC)
- event patterns might be causing performance problems.
+ href="{@docRoot}tools/performance/memory-monitor/index.html">Memory
+ Monitor tool to find out whether undesirable garbage collection (GC)
+ event patterns might be causing performance problems.
Run Heap Viewer
- to identify object types that get or stay allocated unexpectedly or
+ to identify object types that get or stay allocated unexpectedly or
unnecessarily.
Use
- Allocation Tracker to identify where in your code the problem might
+ Allocation Tracker to identify where in your code the problem might
be.
Data plans in some countries can cost upwards of 10% of monthly income.
- Conserve data and give control to optimize user experience. Reduce data
+ Conserve data and give control to optimize user experience. Reduce data
consumption and give users control over your app’s use of data.
Reduce app size
Reduce APK graphical asset size
Graphical assets are often the largest contributor to the size of the
- APK. Optimizing these can result in smaller downloads and thus faster
+ APK. Optimizing these can result in smaller downloads and thus faster
installation times for users.
For graphical assets like icons, use Scalable Vector Graphics (SVG)
- format. SVG images are relatively tiny in size and can be rendered at
- runtime to any resolution. The Android Support
- library provides a backward-compatible implementation for vector resources as
- far back as Android 2.1 (API level 7). Get started with vectors with Android Support
+ library provides a backward-compatible implementation for vector resources as
+ far back as Android 2.1 (API level 7). Get started with vectors with
this Medium post.
For non-vector images, like photos, use WebP. WebP reduces
- image load times, saves network bandwidth, and is proven to result in
- smaller file sizes than its PNG and JPG counterparts, with at least the
- same image quality. Even at lossy settings, WebP can produce a nearly
- identical image. Android has had lossy WebP support since Android 4.0 (API
+ href="https://developers.google.com/speed/webp/">WebP. WebP reduces
+ image load times, saves network bandwidth, and is proven to result in
+ smaller file sizes than its PNG and JPG counterparts, with at least the
+ same image quality. Even at lossy settings, WebP can produce a nearly
+ identical image. Android has had lossy WebP support since Android 4.0 (API
level 14: Ice Cream Sandwich) and support for lossless / transparent WebP since Android 4.2 (API level 17: Jelly Bean).
If you have many large images across multiple densities, consider
- using Multiple
- APK support to split your APK by density. This results in builds
- targeted for specific densities, meaning users with low-density devices
+ using Multiple
+ APK support to split your APK by density. This results in builds
+ targeted for specific densities, meaning users with low-density devices
won’t have to incur the penalty of unused high-density assets.
Consider optimizing your compiled code using a tool such as ProGuard. ProGuard identifies
- code that isn’t being used and removes it from your APK. Also ProGuard. ProGuard identifies
+ code that isn’t being used and removes it from your APK. Also
- enable resource shrinking at build time by setting
- minifyEnabled=true, shrinkResources=true in
- build.gradle—this automatically removes unused resources from
+ enable resource shrinking
at build time by setting
+ minifyEnabled=true, shrinkResources=true in
+ build.gradle—this automatically removes unused resources from
your APK.
When using Google Play services, you should
selectively include only the necessary APIs into your APK.
Low-cost devices often come with little on-device storage. Users can
- extend this with SD cards; however, apps need to explicitly declare that
+ extend this with SD cards; however, apps need to explicitly declare that
they support being installed to external storage before users can move them.
Allow your app to be installed to external storage using the
- android:installLocation flag in your AndroidManifest. For more
- information on enabling your app to be moved to external storage, see the
- Android guide on App Install
+ android:installLocation flag in your AndroidManifest. For more
+ information on enabling your app to be moved to external storage, see the
+ Android guide on App Install
Location.
Reduce post-install app disk usage
Keeping your app’s disk usage low means that users are less likely to
- uninstall your app when the device is low on free space. When using caches,
- it’s important to apply bounds around your caches—this prevents your app’s
- disk usage from growing indefinitely. Be sure you put your cached data in
- {@link android.content.Context#getCacheDir()}—the system can delete files
- placed here as needed, so they won’t show up as storage committed to the
+ uninstall your app when the device is low on free space. When using caches,
+ it’s important to apply bounds around your caches—this prevents your app’s
+ disk usage from growing indefinitely. Be sure you put your cached data in
+ {@link android.content.Context#getCacheDir()}—the system can delete files
+ placed here as needed, so they won’t show up as storage committed to the
app.
Offer configurable network usage
-
Provide onboarding experiences for
+
Provide onboarding experiences for
subjective user choices
Apps that allow users to reduce data usage are well received, even if
- they demand heavy data requirements. If your app uses a considerable amount
- of bandwidth (for example, video streaming apps), you can provide an
- onboarding experience for users to configure network usage. For example,
- you could allow the user to force lower-bitrate video streams on cellular
+ they demand heavy data requirements. If your app uses a considerable amount
+ of bandwidth (for example, video streaming apps), you can provide an
+ onboarding experience for users to configure network usage. For example,
+ you could allow the user to force lower-bitrate video streams on cellular
networks.
Additional settings for users to control data syncing, prefetching, and
- network usage behavior (for example, prefetch all starred news categories on
+ network usage behavior (for example, prefetch all starred news categories on
Wi-Fi only), also help users tailor your app’s behavior to their needs.
You can navigate to the app’s network settings from outside the app by
- means of a network preferences screen. You can invoke this screen from
+ means of a network preferences screen. You can invoke this screen from
either the system settings screen or the system data usage screen.
To provide a network preferences screen that users can access from within
- your app as well as from the system settings, in your app include an
- activity that supports the
+ your app as well as from the system settings, in your app include an
+ activity that supports the
{@link android.content.Intent#ACTION_MANAGE_NETWORK_USAGE} action.
Access to reliable power supplies varies, and outages can disrupt planned
-charges. Defend your users' batteries against unnecessary drain by benchmarking
-your battery use, avoiding wakelocks, scheduling tasks, and monitoring sensor
+
Access to reliable power supplies varies, and outages can disrupt planned
+charges. Defend your users' batteries against unnecessary drain by benchmarking
+your battery use, avoiding wakelocks, scheduling tasks, and monitoring sensor
requests.
Reduce battery consumption
Your app should do minimal activity when in the background and when the
device is running on battery power.
Wake
- locks are mechanisms to keep devices on so that they can perform
- background activities. Avoid using wake locks because they prevent the
+ locks are mechanisms to keep devices on so that they can perform
+ background activities. Avoid using wake locks because they prevent the
device from going into low-power states.
- GcmNetworkManager schedules tasks and lets Google Play
- services batch operations across the system. This greatly
- simplifies the implementation of common patterns, such as waiting for
- network connectivity, device charging state, retries, and backoff. Use
- GcmNetworkManager to perform non-essential background activity
+ GcmNetworkManager schedules tasks and lets Google Play
+ services batch operations across the system. This greatly
+ simplifies the implementation of common patterns, such as waiting for
+ network connectivity, device charging state, retries, and backoff. Use
+ GcmNetworkManager to perform non-essential background activity
when the device is charging and is connected to an unmetered network.
Sensors, like GPS, can also have a significant drain on the battery. The
- recommended way to request location is to use the FusedLocationProvider API.
- The FusedLocationProvider API manages the
- underlying location technology and provides a simple API so that you can
- specify requirements—like high accuracy or low power—at a high
- level. It also optimizes the device's use of battery power by caching
- locations and batching requests across apps. For more information on the
- ideal ways to request location, see the Getting the Last
+ recommended way to request location is to use the FusedLocationProvider API.
+ The FusedLocationProvider API manages the
+ underlying location technology and provides a simple API so that you can
+ specify requirements—like high accuracy or low power—at a high
+ level. It also optimizes the device's use of battery power by caching
+ locations and batching requests across apps. For more information on the
+ ideal ways to request location, see the Getting the Last
Known Location training guide.
Benchmark battery usage
Benchmarking your app’s usage in a controlled environment helps you
- understand the battery-heavy tasks in your app. It is a good practice to
- benchmark your app’s battery usage to gauge efficiency and track changes
+ understand the battery-heavy tasks in your app. It is a good practice to
+ benchmark your app’s battery usage to gauge efficiency and track changes
over time.
Make sure that your app works well on a variety of screens: offering good,
- crisp graphics and appropriate layouts on low resolution and physically small
- screens. Ensure that your app is designed to be easily localized by
- accommodating the variations between languages: allow for spacing, density,
- order, emphasis, and wording variations. Also make sure that date, time, and
- the like are internationalized and displayed according to the phone’s
+ crisp graphics and appropriate layouts on low resolution and physically small
+ screens. Ensure that your app is designed to be easily localized by
+ accommodating the variations between languages: allow for spacing, density,
+ order, emphasis, and wording variations. Also make sure that date, time, and
+ the like are internationalized and displayed according to the phone’s
settings.
Fast and responsive UI
Touch feedback on all touchable items
Touch feedback adds a tactile feeling to the user interface. You should
- ensure your app provides touch feedback on all touchable elements to reduce
+ ensure your app provides touch feedback on all touchable elements to reduce
the perceived app latency as much as possible.
- Responsive interaction encourages deeper exploration of an app by
- creating timely, logical, and delightful screen reactions to user input.
- Responsive interaction elevates an app from an information-delivery service
- to an experience that communicates using multiple visual and tactile
+ Responsive interaction encourages deeper exploration of an app by
+ creating timely, logical, and delightful screen reactions to user input.
+ Responsive interaction elevates an app from an information-delivery service
+ to an experience that communicates using multiple visual and tactile
responses.
Apps that are unresponsive when performing background activity feel slow
- and reduce user satisfaction. Ensure your app always has a responsive UI
- regardless of any background activity. Achieve this by performing network
- operations or any heavy-duty operations in a background thread—keep the UI
+ and reduce user satisfaction. Ensure your app always has a responsive UI
+ regardless of any background activity. Achieve this by performing network
+ operations or any heavy-duty operations in a background thread—keep the UI
thread as idle as you can.
Material Design apps use minimal visual changes when your app is loading
- content by representing each operation with a single activity indicator.
- Avoid blocking dialogs with
loading indicators.
Empty
- states occur when the regular content of a view can’t be shown. It might
- be a list that has no items or a search that returns no results. Avoid
- completely empty states. The most basic empty state displays a
- non-interactive image and a text tagline. Where you don’t have an image, or
- the image is still loading, you should always show either a static
- placeholder, or create a dynamic placeholder by using the Palette
+ href="http://www.google.com/design/spec/patterns/empty-states.html">Empty
+ states occur when the regular content of a view can’t be shown. It might
+ be a list that has no items or a search that returns no results. Avoid
+ completely empty states. The most basic empty state displays a
+ non-interactive image and a text tagline. Where you don’t have an image, or
+ the image is still loading, you should always show either a static
+ placeholder, or create a dynamic placeholder by using the Palette
library to generate placeholder colors that match the target image.
Android devices refresh the screen at 60 frames per second (fps), meaning
- your app has to update the screen within roughly 16 milliseconds. Profile
- your app using on-device tools to see if and when your app is not
+ your app has to update the screen within roughly 16 milliseconds. Profile
+ your app using on-device tools to see if and when your app is not
meeting this 16-ms average.
If anticipated start speed is low, use launch screen
+
If anticipated start speed is low, use launch screen
on first load
The launch screen is a user’s first experience of your application.
- Launching your app while displaying a blank canvas increases its perceived
- loading time, so consider using a placeholder UI or a branded launch screen
+ Launching your app while displaying a blank canvas increases its perceived
+ loading time, so consider using a placeholder UI or a branded launch screen
to reduce the perceived loading time.
A
- placeholder UI is the most seamless launch transition, appropriate for
+ placeholder UI is the most seamless launch transition, appropriate for
both app launches and in-app activity transitions.
- Branded launch screens provide momentary brand exposure, freeing the UI
+ Branded launch screens provide momentary brand exposure, freeing the UI
to focus on content.
- Material Design is a visual language that synthesizes the classic
- principles of good design with the innovation and possibility of technology
- and science. Material Design aims to develop a single underlying system that
- allows for a unified experience across platforms and device sizes. Consider
- using key Material Design components so that users intuitively know how to
+ Material Design is a visual language that synthesizes the classic
+ principles of good design with the innovation and possibility of technology
+ and science. Material Design aims to develop a single underlying system that
+ allows for a unified experience across platforms and device sizes. Consider
+ using key Material Design components so that users intuitively know how to
use your app.
Ready-to-use Material Design components are available via the Design Support
- library. These components are supported in Android 2.1 (API level 7) and
+ href="{@docRoot}tools/support-library/features.html#design">Design Support
+ library. These components are supported in Android 2.1 (API level 7) and
above.
Localization
Your users could be from any part of the world and their first language
- may not be yours. If you don’t present your app in a language that your
- users can read, it is a missed opportunity. You should therefore
+ may not be yours. If you don’t present your app in a language that your
+ users can read, it is a missed opportunity. You should therefore
localize your app for key regional languages.
The first step in delivering a great tablet app experience is making sure
that it meets the core app quality criteria for all of the devices
and form factors that the app is targeting. For complete information, see the Core App Quality Guidelines.
+href="{@docRoot}distribute/essentials/quality/core.html">Core App Quality Guidelines.
@@ -73,7 +73,7 @@ Before publishing, also ensure that your app passes the basic technical checks a
If your app is already uploaded to the Google Play Developer Console, you
- can see how it is doing against these checks
+ can see how it is doing against these checks
by visiting the Optimization
Tips page.
Similarly, check the manifest for <permission> elements that
+
Similarly, check the manifest for <permission> elements that
imply hardware
feature requirements that not be appropriate for tablets. If you find such
permissions, make sure to explicitly declare a corresponding
diff --git a/docs/html/distribute/googleplay/cast.jd b/docs/html/distribute/googleplay/cast.jd
index 937ab58901a6b..3112f8100c3e0 100644
--- a/docs/html/distribute/googleplay/cast.jd
+++ b/docs/html/distribute/googleplay/cast.jd
@@ -26,7 +26,7 @@ take full advantage of multiscreen experiences via Cast.
diff --git a/docs/html/distribute/googleplay/families/faq.jd b/docs/html/distribute/googleplay/families/faq.jd
index 363dc91c114b3..663850f54df1b 100644
--- a/docs/html/distribute/googleplay/families/faq.jd
+++ b/docs/html/distribute/googleplay/families/faq.jd
@@ -10,7 +10,7 @@ page.metaDescription=Questions and answers about Designed for Families
font-weight:bold;
}
-
+
In this document
@@ -84,7 +84,7 @@ page.metaDescription=Questions and answers about Designed for Families
No, you do not need to translate your privacy policy. However, if you
distribute your apps in a few select countries, it is advised that you do
- translate your privacy policy.
+ translate your privacy policy.
@@ -173,7 +173,7 @@ page.metaDescription=Questions and answers about Designed for Families
confirm that it is appropriate for families. Assuming your app complies with all program
requirements, we expect that publishing time should not take any longer
than normal; however, there may be a delay in publishing the app if it is
- rejected during the Designed for Families review.
+ rejected during the Designed for Families review.
@@ -301,7 +301,7 @@ page.metaDescription=Questions and answers about Designed for Families
House ads are allowed, but they must comply with ads policies.
+ href="https://support.google.com/googleplay/android-developer/answer/6184502#ads">ads policies.
diff --git a/docs/html/distribute/googleplay/families/start.jd b/docs/html/distribute/googleplay/families/start.jd
index 0e773bd11c3aa..f174dae26da22 100644
--- a/docs/html/distribute/googleplay/families/start.jd
+++ b/docs/html/distribute/googleplay/families/start.jd
@@ -86,7 +86,7 @@ page.metaDescription=Join Designed for Families in just a few simple steps.
Note: Published apps in the Designed for Families program
- are also available to all users on Google Play.
+ are also available to all users on Google Play.
diff --git a/docs/html/distribute/googleplay/tv.jd b/docs/html/distribute/googleplay/tv.jd
index a35edbc45470d..981ba510dd76e 100644
--- a/docs/html/distribute/googleplay/tv.jd
+++ b/docs/html/distribute/googleplay/tv.jd
@@ -275,7 +275,7 @@ page.metaDescription=Distribute your apps, games, and content to Android TV.
the criteria, you’ll receive a notification email sent to your developer account
address, with a summary of the areas that you need to address. When you’ve made
the necessary adjustments, you can upload a new version of your app to the Developer
- Console.
+ Console.
@@ -296,7 +296,7 @@ page.metaDescription=Distribute your apps, games, and content to Android TV.
Approved — Your app was reviewed and approved. The app will be
- made available directly to Android TV users.
+ made available directly to Android TV users.
diff --git a/docs/html/distribute/tools/promote/device-art.jd b/docs/html/distribute/tools/promote/device-art.jd
index 9b4dd1481aeb6..7fef02ff11e51 100644
--- a/docs/html/distribute/tools/promote/device-art.jd
+++ b/docs/html/distribute/tools/promote/device-art.jd
@@ -221,7 +221,7 @@ feature image or screenshots for your Google Play app listing.
landOffset: [489,327],
portRes: ['shadow', 'back', 'fore'],
portOffset: [327,489],
- portSize: [1440, 2560],
+ portSize: [1440, 2560],
archived: true
},
{
diff --git a/docs/html/distribute/tools/promote/linking.jd b/docs/html/distribute/tools/promote/linking.jd
index 025480b1f1bd1..13b15744d4053 100644
--- a/docs/html/distribute/tools/promote/linking.jd
+++ b/docs/html/distribute/tools/promote/linking.jd
@@ -18,7 +18,7 @@ page.metaDescription=Learn how to build links that take users to your published
Google Play provides several link formats that let you bring users to your
products in the way you want, from Android apps, web pages, ads, reviews,
-articles, social media posts, and more.
+articles, social media posts, and more.
The link formats let you:
diff --git a/docs/html/google/backup/signup.jd b/docs/html/google/backup/signup.jd
index 598003dbe23b2..86518b6458f95 100644
--- a/docs/html/google/backup/signup.jd
+++ b/docs/html/google/backup/signup.jd
@@ -105,7 +105,7 @@ This is the terms of service for the Android Backup Service.
8.4 You agree that you shall not remove, obscure, or alter any proprietary rights notices (including copyright, trade mark notices) which may be affixed to or contained within the Service.
9. License from Google
-9.1 Subject to terms and conditions of these Terms, Google gives you a personal, worldwide, royalty-free, non-assignable and non-exclusive license to use the Service as provided to you by Google. This license is for the sole purpose of enabling you to use and enjoy the benefit of the Service as provided by Google, in the manner permitted by the Terms.
+9.1 Subject to terms and conditions of these Terms, Google gives you a personal, worldwide, royalty-free, non-assignable and non-exclusive license to use the Service as provided to you by Google. This license is for the sole purpose of enabling you to use and enjoy the benefit of the Service as provided by Google, in the manner permitted by the Terms.
9.2 You may not (and you may not permit anyone else to) copy, modify, create a derivative work of, reverse engineer, decompile or otherwise attempt to extract the source code from the Service or any part thereof, unless this is expressly permitted or required by law, or unless you have been specifically told that you may do so by Google, in writing.
@@ -208,7 +208,7 @@ with the Android Backup Service Terms of Service
-
@@ -234,7 +234,7 @@ onclick="onRegister(); return false;" >Register with Android Backup Service<
);
}
}
-
+
function boxFocusChanged(obj, focused) {
if (focused) {
if(obj.value == DEFAULT_TEXT){
@@ -248,14 +248,14 @@ onclick="onRegister(); return false;" >Register with Android Backup Service<
}
}
}
-
-
+
+
function onFormInput() {
/* verify that the TOS is agreed and a bit version is chosen */
var packagename = $("#pname").val();
if ($("input#agree").is(":checked")
&& packagename.length
- && packagename != DEFAULT_TEXT) {
+ && packagename != DEFAULT_TEXT) {
/* reveal the button */
$("a#registerButton").removeClass('disabled');
} else {
diff --git a/docs/html/google/index.jd b/docs/html/google/index.jd
index 027ba23a6e5b7..9b7ff0b8b48fe 100644
--- a/docs/html/google/index.jd
+++ b/docs/html/google/index.jd
@@ -53,7 +53,7 @@ footer.hide=1
Google Play developer tools
- Scale your publishing, manage your catalog, build revenue using Google Play developer tools.
+ Scale your publishing, manage your catalog, build revenue using Google Play developer tools.
@@ -572,7 +572,7 @@ the dontAllow() method on {@code LicenseCheckerCallback}.
In case of a recoverable local or server error, such as when the network is
not available to send the request, {@code LicenseChecker} passes a {@code RETRY} response to
-your {@code Policy} object's processServerResponse() method.
+your {@code Policy} object's processServerResponse() method.
Also, both the {@code allow()} and {@code dontAllow()} callback methods receive a
reason argument. The {@code allow()} method's reason is usually {@code
Policy.LICENSED} or {@code Policy.RETRY} and the {@code dontAllow()} reason is usually {@code
@@ -672,7 +672,7 @@ private class MyLicenseCheckerCallback implements LicenseCheckerCallback {
return;
}
displayResult(getString(R.string.dont_allow));
-
+
if (reason == Policy.RETRY) {
// If the reason received from the policy is RETRY, it was probably
// due to a loss of connection with the service, so we should give the
@@ -854,9 +854,9 @@ sample application calls checkAccess() from a
Embed your public key for licensing
For each application, the Google Play service automatically
-generates a 2048-bit RSA public/private key pair that is used for
-licensing and in-app billing. The key pair is uniquely associated with the
-application. Although associated with the application, the key pair is
+generates a 2048-bit RSA public/private key pair that is used for
+licensing and in-app billing. The key pair is uniquely associated with the
+application. Although associated with the application, the key pair is
not the same as the key that you use to sign your applications (or derived from it).
The Google Play Developer Console exposes the public key for licensing to any
@@ -876,11 +876,11 @@ your application's public key for licensing:
href="http://play.google.com/apps/publish">Developer Console and sign in.
Make sure that you sign in to the account from which the application you are
licensing is published (or will be published).
-
In the application details page, locate the Services & APIs
+
In the application details page, locate the Services & APIs
link and click it.
-
In the Services & APIs page, locate the
-Licensing & In-App Billing section. Your public key for
-licensing is given in the
+
In the Services & APIs page, locate the
+Licensing & In-App Billing section. Your public key for
+licensing is given in the
Your License Key For This Application field.
@@ -107,10 +107,10 @@ response data using an RSA key pair that is shared exclusively between the Googl
server and you.
The licensing service generates a single licensing key pair for each
-application and exposes the public key in your application's
-Services & APIs page in the Developer Console. You must copy
-the public key from the Developer Console and embed it in your application
-source code. The server retains the private key internally and uses it to sign
+application and exposes the public key in your application's
+Services & APIs page in the Developer Console. You must copy
+the public key from the Developer Console and embed it in your application
+source code. The server retains the private key internally and uses it to sign
license responses for the applications you publish with that account.
When your application receives a signed response, it uses the embedded public
@@ -209,7 +209,7 @@ practices in the following documents, you can help ensure that your implementati
secure.
Adding licensing to an application does not affect the way the application
functions when run on a device that does not offer Google Play.
-
You can implement licensing controls for a free app, but only if you're using the service to
+
You can implement licensing controls for a free app, but only if you're using the service to
provide APK expansion files.
diff --git a/docs/html/google/play/publishing/multiple-apks.jd b/docs/html/google/play/publishing/multiple-apks.jd
index fd4481dc076a3..a878fb3ab1ad6 100644
--- a/docs/html/google/play/publishing/multiple-apks.jd
+++ b/docs/html/google/play/publishing/multiple-apks.jd
@@ -250,11 +250,11 @@ If you can't avoid using both, be aware that for any conflicts in agreement betw
For example, you can provide one APK for devices that support multitouch and another
-APK for devices that do not support multitouch. See
+APK for devices that do not support multitouch. See
Features
Reference for a list of features supported by the platform.
Panorama center-of-view in degrees from
-90 (look straight up) to 90 (look straight down.)
zoom
Panorama zoom. 1.0 = normal zoom, 2.0 = zoomed in 2x, 3.0 = zoomed in 4x, and so on.
- A zoom of 1.0 is 90 degree horizontal FOV for a nominal
- landscape mode 4 x 3 aspect ratio display.
- Android phones in portrait mode will adjust the zoom so that
- the vertical FOV is approximately the same as the landscape vertical
- FOV. This means that the horizontal FOV of an Android phone in portrait
- mode is much narrower than in landscape mode. This is done to minimize
- the fisheye lens effect that would be present if a 90 degree horizontal
+ A zoom of 1.0 is 90 degree horizontal FOV for a nominal
+ landscape mode 4 x 3 aspect ratio display.
+ Android phones in portrait mode will adjust the zoom so that
+ the vertical FOV is approximately the same as the landscape vertical
+ FOV. This means that the horizontal FOV of an Android phone in portrait
+ mode is much narrower than in landscape mode. This is done to minimize
+ the fisheye lens effect that would be present if a 90 degree horizontal
FOV was used in portrait mode.
mapZoom
The map zoom of the map location associated with this panorama. This value is passed on to the
Maps activity when the Street View "Go to Maps" menu item is chosen. It corresponds to the z parameter in
diff --git a/docs/html/guide/appendix/g-app-intents.jd b/docs/html/guide/appendix/g-app-intents.jd
index 9ec72db2411fa..21c927b913b75 100644
--- a/docs/html/guide/appendix/g-app-intents.jd
+++ b/docs/html/guide/appendix/g-app-intents.jd
@@ -83,7 +83,7 @@ href="{@docRoot}guide/components/intents-filters.html">Intents and Intent Filter
Android programs are compiled into .dex (Dalvik Executable) files, which
are in turn zipped into a single .apk file on the device. .dex files can
be created by automatically translating compiled applications written in
@@ -26,7 +26,7 @@ excludeFromSuggestions=true
a string value assigned to an Intent. Action strings can be defined by Android
or by a third-party developer. For example, android.intent.action.VIEW
for a Web URL, or com.example.rumbler.SHAKE_PHONE for a custom application
- to vibrate the phone.
+ to vibrate the phone.
Android Debug Bridge, a command-line debugging application included with the
SDK. It provides tools to browse the device, copy tools on the device, and
- forward ports for debugging. If you are developing in Android Studio,
- adb is integrated into your development environment. See
+ forward ports for debugging. If you are developing in Android Studio,
+ adb is integrated into your development environment. See
Android Debug Bridge
for more information.
@@ -90,7 +90,7 @@ excludeFromSuggestions=true
DDMS
Dalvik Debug Monitor Service, a GUI debugging application included
with the SDK. It provides screen capture, log dump, and process
- examination capabilities. If you are developing in Android Studio,
+ examination capabilities. If you are developing in Android Studio,
DDMS is integrated into your development environment. See Using DDMS to learn more about the program.
@@ -100,7 +100,7 @@ excludeFromSuggestions=true
is not intended to persist in the history stack, contain complex layout,
or perform complex actions. Android provides a default simple dialog for
you with optional buttons, though you can define your own dialog layout.
- The base class for dialogs is {@link android.app.Dialog Dialog}.
+ The base class for dialogs is {@link android.app.Dialog Dialog}.
@@ -113,7 +113,7 @@ excludeFromSuggestions=true
— xml or bitmap files that describe the image. Drawable resources
are compiled into subclasses of {@link android.graphics.drawable}. For
more information about drawables and other resources, see Resources.
+ href="{@docRoot}guide/topics/resources/resources-i18n.html">Resources.
@@ -133,7 +133,7 @@ excludeFromSuggestions=true
based on the criteria supplied in the Intent and the Intent Filters
defined by other applications. For more information, see Intents and
- Intent Filters.
+ Intent Filters.
@@ -147,7 +147,7 @@ excludeFromSuggestions=true
application/activity that best matches the Intent and criteria. For more
information, see Intents and
- Intent Filters.
+ Intent Filters.
An application class that listens for Intents that are broadcast,
rather than being sent to a single target application/activity. The system
delivers a broadcast Intent to all interested broadcast receivers, which
- handle the Intent sequentially.
-
A resizeable bitmap resource that can be used for backgrounds or other
images on the device. See
- Nine-Patch Stretchable Image for more information.
+ Nine-Patch Stretchable Image for more information.
Android provides OpenGL ES libraries that you can use for fast,
complex 3D images. It is harder to use than a Canvas object, but
- better for 3D objects. The {@link android.opengl} and
- {@link javax.microedition.khronos.opengles} packages expose
- OpenGL ES functionality.
+ better for 3D objects. The {@link android.opengl} and
+ {@link javax.microedition.khronos.opengles} packages expose
+ OpenGL ES functionality.
An object of class {@link android.app.Service} that runs in the
background (without any UI presence) to perform various persistent
- actions, such as playing music or monitoring network activity.
+ actions, such as playing music or monitoring network activity.
An object of type {@link android.view.Surface} representing a block of
memory that gets composited to the screen. A Surface holds a Canvas object
for drawing, and provides various helper methods to draw layers and resize
- the surface. You should not use this class directly; use
- {@link android.view.SurfaceView} instead.
+ the surface. You should not use this class directly; use
+ {@link android.view.SurfaceView} instead.
@@ -249,7 +249,7 @@ excludeFromSuggestions=true
windows, and so on). It receives calls from its parent object (see
viewgroup, below)to draw itself, and informs its parent object about where
and how big it would like to be (which may or may not be respected by the
- parent). For more information, see {@link android.view.View}.
+ parent). For more information, see {@link android.view.View}.
@@ -259,18 +259,18 @@ excludeFromSuggestions=true
they can be, as well as for calling each to draw itself when appropriate.
Some viewgroups are invisible and are for layout only, while others have
an intrinsic UI (for instance, a scrolling list box). Viewgroups are all
- in the {@link android.widget widget} package, but extend
- {@link android.view.ViewGroup ViewGroup}.
+ in the {@link android.widget widget} package, but extend
+ {@link android.view.ViewGroup ViewGroup}.
One of a set of fully implemented View subclasses that render form
elements and other UI components, such as a text box or popup menu.
Because a widget is fully implemented, it handles measuring and drawing
- itself and responding to screen events. Widgets are all in the
+ itself and responding to screen events. Widgets are all in the
{@link android.widget} package.
- for the user to interact with, typically bundled up
in a single file (with an .apk suffix). Android ships with a rich set
@@ -186,10 +186,10 @@ document),
seamless, activity after activity, task after
task.
-
+
An activity handles a particular type of content (data) and accepts a
- set of related user actions. Each activity has a
+ set of related user actions. Each activity has a
lifecycle that is
independent of the other
activities in its application or task — each activity is
@@ -283,7 +283,7 @@ independent of the other
to the activity stack, so that pressing Back displays the previous
activity on the stack. However, the user cannot use the Back button to go
back further than the last visit to Home. The adding of an activity to
- the current stack happens whether or not that activity begins a new
+ the current stack happens whether or not that activity begins a new
task (as long as that task was started
without going Home), so going back can let the user go back to
activities in previous tasks. The user can get to tasks earlier than
@@ -297,7 +297,7 @@ independent of the other
designing the navigation, if you have screen A and you want the user
to be able go to a subsequent screen B and then use the Back button to go
back to screen A, then the screen A needs to be implemented as an
- activity. The one exception to this rule is if your application
+ activity. The one exception to this rule is if your application
takes control of the Back button and manages the
navigation
itself.
@@ -340,7 +340,7 @@ itself.
Send a text message with an attachment
- View a YouTube video and share it by email with someone else
+ View a YouTube video and share it by email with someone else
@@ -666,7 +666,7 @@ itself.
mailto:info@example.com link, they are actually initiating an Intent
object, or just an intent, which then gets resolved to a
particular component (we consider only activity components here).
- So, the result of a user touching a mailto: link is an Intent object
+ So, the result of a user touching a mailto: link is an Intent object
that the system tries to match to an activity. If that Intent object was
written explicitly naming an activity (an explicit intent),
then the system immediately launches that activity in response to the user
@@ -925,7 +925,7 @@ href="{@docRoot}guide/components/intents-filters.html">Intents and Intent Filter
For instance, you could disable the user control that initiates
the Intent object, or display a message to the user that lets them go
to a location, such as Google Play, to download its application.
- In this way, your code can start the activity (using either startActivity()
+ In this way, your code can start the activity (using either startActivity()
or startActivityForResult()) only if the intent has tested to resolve
to an activity that is actually present.
@@ -947,7 +947,7 @@ href="{@docRoot}guide/components/intents-filters.html">Intents and Intent Filter
launcher (typically implemented as a sliding drawer on the
Home screen), or from a shortcut icon on the Home screen, or
from the task switcher. (The mechanism for this is for the
- activity to have an
+ activity to have an
intent filter with action
MAIN and
category LAUNCHER.)
@@ -1103,7 +1103,7 @@ MAIN and
activity to be run.
-
+
Notifications and App Widgets should provide consistent back behavior
Notifications and app widgets are two common ways that a user can launch
diff --git a/docs/html/guide/practices/ui_guidelines/icon_design.jd b/docs/html/guide/practices/ui_guidelines/icon_design.jd
index 07266607ed4c2..6b546c9fd21df 100644
--- a/docs/html/guide/practices/ui_guidelines/icon_design.jd
+++ b/docs/html/guide/practices/ui_guidelines/icon_design.jd
@@ -58,7 +58,7 @@ Screens
-
New Guides for App Designers!
+
New Guides for App Designers!
Check out the new documents for designers at Android Design, including more guidelines
for Iconography.
@@ -72,13 +72,13 @@ professional to users.
This document provides information to help you create icons for various parts
of your application’s user interface that match the general styles used by the
-Android 2.x framework. Following these guidelines will help you to create a
+Android 2.x framework. Following these guidelines will help you to create a
polished and unified experience for the user.
The following documents discuss detailed guidelines for the common types of
icons used throughout Android applications:
A Launcher icon is a graphic that represents your application on the
device's Home screen and in the Launcher window.
@@ -103,7 +103,7 @@ icons used throughout Android applications:
graphically represent list items. An example is the Settings application.
-
To get started creating your icons more quickly, you can download
+
To get started creating your icons more quickly, you can download
the Android Icon Templates Pack.
@@ -142,7 +142,7 @@ section in the box at the top-right corner of this page.
Android is designed to run on a variety of devices that offer a range of
screen sizes and resolutions. When you design the icons for your application,
it's important keep in mind that your application may be installed on any of
-those devices. As described in the Supporting Multiple
Screens document, the Android platform makes it straightforward for you to
provide icons in such a way that they will be displayed properly on any device,
@@ -158,7 +158,7 @@ your application, see Resource
directory qualifiers for screen size and density.
-
For tips on how to create and manage icon sets for multiple densities, see
+
For tips on how to create and manage icon sets for multiple densities, see
Tips for Designers.
@@ -290,7 +290,7 @@ initially draw launcher icons on an 864x864 artboard, it will be easier and
cleaner to tweak the icons when you scale the artboard down to the target
sizes for final asset creation.
-
+
Check out the new documents for designers at Android Design, including more guidelines
for Iconography.
diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd b/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd
index 2df3a2250ef55..483e076ac52f4 100644
--- a/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd
+++ b/docs/html/guide/practices/ui_guidelines/icon_design_launcher_archive.jd
@@ -95,7 +95,7 @@ but rather they are meant to emphasize the common approaches that your icons can
share with others on the device. Figure 1, at right, provides examples.
-
Figure 1. Example launcher icons for Android 2.0 and
diff --git a/docs/html/guide/practices/ui_guidelines/icon_design_list.jd b/docs/html/guide/practices/ui_guidelines/icon_design_list.jd
index 29e1a9380de71..fa350bc2b6a7b 100644
--- a/docs/html/guide/practices/ui_guidelines/icon_design_list.jd
+++ b/docs/html/guide/practices/ui_guidelines/icon_design_list.jd
@@ -30,7 +30,7 @@ Screens
-
New Guides for App Designers!
+
New Guides for App Designers!
Check out the new documents for designers at Android Design, including more guidelines
for Iconography.
Check out the new documents for designers at Android Design, including more guidelines
for Iconography.
@@ -267,7 +267,7 @@ menu icon color palette.
appropriate. For example, in Figure 3 the logical place for rounded corners is
the roof and not the rest of the building.
-
All dimensions specified on this page are based on a 48x48 pixel artboard
+
All dimensions specified on this page are based on a 48x48 pixel artboard
size with a 6 pixel safeframe.
The menu icon effect (the outer glow) described in
Check out the new documents for designers at Android Design, including more guidelines
for Iconography.
@@ -291,10 +291,10 @@ your application.
the Android platform.
Warning:
-Because these resources can change between platform versions, you
+Because these resources can change between platform versions, you
should not reference the system's copy of the resources. If you want to
use any icons or other internal drawable resources, you should store a
-local copy of those icons or drawables in your application resources,
+local copy of those icons or drawables in your application resources,
then reference the local copy from your application code. In that way, you can
maintain control over the appearance of your icons, even if the system's
copy changes. Note that the grid below is not intended to be complete.
The Android UX team has put together a set of guidelines for the interaction and
visual design of Android applications. The new collection provides an overview of
Android styles, design patterns, building blocks for exceptional Android designs, and more.
A menu holds a set of commands (user actions) that are normally hidden, and
are accessible by a button, key, or gesture. Menu commands provide a means
- for performing operations and for navigating to other parts of your
+ for performing operations and for navigating to other parts of your
application or other applications. Menus are useful for freeing screen space,
as an alternative to placing functionality and navigation, in buttons or other
- user controls in the content area of your application.
+ user controls in the content area of your application.
@@ -102,7 +102,7 @@ onclick="$('#naMessage').hide();$('#deprecatedSticker').show()" />
the functionality and navigation for your application. Briefly:
The Options menu contains primary functionality that applies
- globally to the current activity or starts a related activity.
+ globally to the current activity or starts a related activity.
It is typically invoked by a user pressing a hard button, often labeled Menu.
The Context menu contains secondary functionality for the currently
selected item. It is typically invoked by a user's touch & hold
@@ -113,11 +113,11 @@ onclick="$('#naMessage').hide();$('#deprecatedSticker').show()" />
All but the simplest applications have menus. The system automatically
- lays the menus out and provides standard ways for users to access them.
+ lays the menus out and provides standard ways for users to access them.
In this sense, they are familiar and dependable ways for users to access
functionality across all applications. All menus are panels that "float"
on top of the activity screen and are smaller than full screen, so that the
- application is still visible around its edges. This is a visual reminder
+ application is still visible around its edges. This is a visual reminder
that a menu is an intermediary operation that disappears once it's used.
Note: Your menus and screens might not look
-like those shown in this document; they may vary from one version of Android
+
Note: Your menus and screens might not look
+like those shown in this document; they may vary from one version of Android
or device to another.
@@ -137,13 +137,13 @@ or device to another.
The Options menu contains commands that apply globally across the current
activity, or can start another activity. They do not apply to a selected
- item in the content (a Context menu does that).
+ item in the content (a Context menu does that).
- On most devices, a user presses the Menu button to access the Options menu,
- as shown in the screenshot below. To close the menu, the user presses
- Menu again, or presses the Back button.
+ On most devices, a user presses the Menu button to access the Options menu,
+ as shown in the screenshot below. To close the menu, the user presses
+ Menu again, or presses the Back button.
In fact, to cancel out of any menu, press the Back button. (Pressing the Menu
button or touching outside the menu also works.) Note that how to invoke this
menu may be different on different devices.
@@ -153,15 +153,15 @@ or device to another.
Each
activity
activity has its own set of operations and therefore its own Options menu.
- An application with multiple activities would have a different Options menu
- for each activity.
+ An application with multiple activities would have a different Options menu
+ for each activity.
For example, in the message list view of an email program, the Options menu
- might let you search the messages, compose a new message, refresh the list,
- or change the email settings. The compose view of an email program would
- have a different Options menu, such as adding a CC field, attaching a file,
+ might let you search the messages, compose a new message, refresh the list,
+ or change the email settings. The compose view of an email program would
+ have a different Options menu, such as adding a CC field, attaching a file,
or discarding the message.
@@ -179,7 +179,7 @@ or device to another.
Options expanded menu - If the activity has more menu items than will
fit on the icon menu, then the last icon is labeled "More" — selecting it
- displays a list that can contain any number of menu items and will scroll
+ displays a list that can contain any number of menu items and will scroll
as necessary.
@@ -202,18 +202,18 @@ or device to another.
A user can touch & hold on content on the screen to
- access a Context menu (if one exists), as shown in the screenshot below.
+ access a Context menu (if one exists), as shown in the screenshot below.
A Context menu is a list of menu items (commands) that can operate
on the selected content. The command can either be part of the current
- activity, or the system can pass the selected content along to
- an operation in another activity (by way of an
+ activity, or the system can pass the selected content along to
+ an operation in another activity (by way of an
intent).
For example, in an email message list, a user can touch & hold on
an email message to open a Context menu containing commands to read,
- archive, or delete the message.
+ archive, or delete the message.
@@ -231,7 +231,7 @@ or device to another.
In the above example, if the user performs touch & hold on the contact
"Obi Wan Kenobi", a Context menu opens. The commands provided in
this Context menu are the complete set of actions that can be performed
- on this contact.
+ on this contact.
@@ -246,7 +246,7 @@ or device to another.
Also note, as shown in the following screenshot, the Context menu and the
next screen both hold the same complete set of commands that can be performed
- on this contact. The Context menu displays the commands in a list,
+ on this contact. The Context menu displays the commands in a list,
while the "View contact" activity splits them into various items in the
Options menu, icon buttons and list items.
@@ -268,10 +268,10 @@ or device to another.
Text Commands in Context Menu
- Text links and text fields in the content both have system-provided operations
+ Text links and text fields in the content both have system-provided operations
that are common across all applications: operations such as "Select all", "Select text",
- "Copy all", and "Add to dictionary". If the text field is editable, it also
- has other operations, such as "Cut all" and "Input Method", and if text
+ "Copy all", and "Add to dictionary". If the text field is editable, it also
+ has other operations, such as "Cut all" and "Input Method", and if text
is also on the clipboard, it has "Paste". The system automatically inserts
the appropriate menu items into the Context menu of text links and text
fields, as shown in the following screenshot.
@@ -342,7 +342,7 @@ or device to another.
An example of a selection-specific Context menu is when a user performs a
touch & hold on a person's name in a list view of a contacts application.
The Context menu would typically contain commands "View contact", "Call contact",
- and "Edit contact".
+ and "Edit contact".
Place the most frequently used operations first
@@ -365,7 +365,7 @@ or device to another.
Don't put commands only in a Context menu
- If a user can fully access your application without using Context menus,
+ If a user can fully access your application without using Context menus,
then it's designed properly! In general, if part of your application is inaccessible
without using Context menus, then you need to duplicate those commands elsewhere.
@@ -373,8 +373,8 @@ or device to another.
Before opening a Context menu, it has no visual representation that identifies
its presence (whereas the Options menu has the Menu button), and so is not
- particularly discoverable.
- Therefore, in general, a Context menu should duplicate commands
+ particularly discoverable.
+ Therefore, in general, a Context menu should duplicate commands
found in the corresponding activity screen. For example, while it's useful to
let the user call a phone number from a Context menu invoked by touch
& hold on a name in a list of contacts, that operation should also
@@ -388,7 +388,7 @@ or device to another.
As described under shortcut,
touching on an item in the content should activate the same command as touching
the first item in the Context menu. Both cases should be the most intuitive
- operation for that item.
+ operation for that item.
Selecting an item in the content should perform the most intuitive operation
@@ -427,13 +427,13 @@ or device to another.
A Context menu should identify the selected item
- When a user does touch & hold on an item, the Context menu should
- contain the name of the selected item. Therefore,
+ When a user does touch & hold on an item, the Context menu should
+ contain the name of the selected item. Therefore,
when creating a Context menu, be sure to include a title and the name of the
- selected item so that it's clear to the user what the context is.
+ selected item so that it's clear to the user what the context is.
For example, if a user selects a contact "Joan of Arc", put that name in the
title of the Context menu (using
- {@link android.view.ContextMenu#setHeaderTitle(java.lang.CharSequence) setHeaderTitle}).
+ {@link android.view.ContextMenu#setHeaderTitle(java.lang.CharSequence) setHeaderTitle}).
Likewise, a command to edit the contact should be called "Edit contact",
not just "Edit".
@@ -442,7 +442,7 @@ or device to another.
Put only the most important commands fixed on the screen
- By putting commands in menus, you free up the screen to hold more content.
+ By putting commands in menus, you free up the screen to hold more content.
On the other hand, fixing commands in the content area of an activity
makes them more prominent and easy to use.
@@ -456,7 +456,7 @@ or device to another.
To give a command the highest prominence, ensuring the command is obvious and won't be overlooked.
Example: A "Buy" button in a store application.
-
+
When quick access to the command is important and going to the menu would be
tedious or slow.
Example: Next/Previous buttons or Zoom In/Out buttons in an image viewing application.
@@ -494,7 +494,7 @@ or device to another.
When a dialog is displayed, pressing the Menu button should do nothing. This also holds
true
for activities that look like dialogs. A dialog box is recognizable by being
- smaller than full-screen, having zero to three buttons, is non-scrollable, and
+ smaller than full-screen, having zero to three buttons, is non-scrollable, and
possibly a list of selectable items that can include checkboxes or radio buttons.
@@ -520,12 +520,12 @@ true
Sometimes a menu item's action cannot be performed — for example,
- the "Forward" button in a browser cannot work until after the "Back"
+ the "Forward" button in a browser cannot work until after the "Back"
button has been pressed. We recommend:
-
+
In Options menu - disable the menu item, which dims the text and icon,
turning it gray. This applies to menu items in both the icon menu and the
"More" menu. It would be disorienting for the icon menu to change from 6
diff --git a/docs/html/guide/practices/ui_guidelines/widget_design.jd b/docs/html/guide/practices/ui_guidelines/widget_design.jd
index cf2cd64d483a2..95c594dba972e 100644
--- a/docs/html/guide/practices/ui_guidelines/widget_design.jd
+++ b/docs/html/guide/practices/ui_guidelines/widget_design.jd
@@ -46,7 +46,7 @@ parent.link=index.html
-
New Guides for App Designers!
+
New Guides for App Designers!
Check out the new documents for designers at Android Design.
diff --git a/docs/html/guide/topics/admin/device-admin.jd b/docs/html/guide/topics/admin/device-admin.jd
index e2fef04b75372..2a8583a83e7dc 100644
--- a/docs/html/guide/topics/admin/device-admin.jd
+++ b/docs/html/guide/topics/admin/device-admin.jd
@@ -135,60 +135,60 @@ can require PIN or passwords to have at least six characters.
combination of letters and numbers. They may include symbolic characters.
-
+
Complex password required
Requires that passwords must contain at least a letter, a numerical digit, and a special symbol. Introduced in Android 3.0.
-
-
+
+
Minimum letters required in password
The minimum number of
-letters required in the password for all admins or a particular one. Introduced in Android 3.0.
+letters required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
-
-
Minimum lowercase letters required in password
-
The minimum number of lowercase
-letters required in the password for all admins or a particular one. Introduced in Android 3.0.
+
+
+
+
Minimum lowercase letters required in password
+
The minimum number of lowercase
+letters required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
-
Minimum non-letter characters required in password
+
+
+
Minimum non-letter characters required in password
The minimum number of
-non-letter characters required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
-
-
Minimum numerical digits required in password
-
The minimum number of numerical digits required in the password for all admins or a particular one. Introduced in Android 3.0.
+non-letter characters required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
Minimum symbols required in password
-
The minimum number of symbols required in the password for all admins or a particular one. Introduced in Android 3.0.
+
+
Minimum numerical digits required in password
+
The minimum number of numerical digits required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
Minimum uppercase letters required in password
-
The minimum number of uppercase letters required in the password for all admins or a particular one. Introduced in Android 3.0.
+
+
Minimum symbols required in password
+
The minimum number of symbols required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
Password expiration timeout
-
When the password will expire, expressed as a delta in milliseconds from when a device admin sets the expiration timeout. Introduced in Android 3.0.
+
+
Minimum uppercase letters required in password
+
The minimum number of uppercase letters required in the password for all admins or a particular one. Introduced in Android 3.0.
-
-
Password history restriction
+
+
Password expiration timeout
+
When the password will expire, expressed as a delta in milliseconds from when a device admin sets the expiration timeout. Introduced in Android 3.0.
+
+
+
+
Password history restriction
This policy prevents users from reusing the last n unique passwords.
This policy is typically used in conjunction with
{@link android.app.admin.DevicePolicyManager#setPasswordExpirationTimeout(android.content.ComponentName,long) setPasswordExpirationTimeout()}, which forces
users to update their passwords after a specified amount of time has elapsed.
-Introduced in Android 3.0.
+Introduced in Android 3.0.
-
+
Maximum failed password attempts
Specifies how many times a user can enter the wrong password before the
@@ -203,18 +203,18 @@ pressed a button before the device locks the screen. When this happens, users
need to enter their PIN or passwords again before they can use their devices and
access data. The value can be between 1 and 60 minutes.
-
-
Require storage encryption
-
Specifies that the storage area should be encrypted, if the device supports it.
+
+
Require storage encryption
+
Specifies that the storage area should be encrypted, if the device supports it.
Introduced in Android 3.0.
Disable camera
-
+
Specifies that the camera should be disabled. Note that this doesn't have
to be a permanent disabling. The camera can be enabled/disabled dynamically
based on context, time, and so on. Introduced in Android 4.0.
-
+
@@ -234,7 +234,7 @@ Administration API lets you do the following:
The examples used in this document are based on the Device Administration API
sample, which is included in the SDK samples (available through the
-Android SDK Manager) and located on your system as
+Android SDK Manager) and located on your system as
<sdk_root>/ApiDemos/app/src/main/java/com/example/android/apis/app/DeviceAdminSample.java.
The sample application offers a demo of device admin features. It presents users
@@ -250,8 +250,8 @@ policies, the system returns an error.
Set how many failed password attempts can occur before the device is wiped
(that is, restored to factory settings).
Set how long from now the password will expire.
-
Set the password history length (length refers to number of old passwords stored in the history).
-This prevents users from reusing
+
Set the password history length (length refers to number of old passwords stored in the history).
+This prevents users from reusing
one of the last n passwords they previously used.
Specify that the storage area should be encrypted, if the device supports it.
Set the maximum amount of inactive time that can elapse before the device
@@ -259,7 +259,7 @@ locks.
Make the device lock immediately.
Wipe the device's data (that is, restore factory settings).
Disable the camera.
-
+
@@ -454,8 +454,8 @@ changes to prompt the user to activate the device admin application, as shown in
Figure 2. Sample Application: Activating the Application
-
Below is the code that gets executed when the user clicks the Enable Admin checkbox. This has the effect of triggering the
-{@link android.preference.Preference.OnPreferenceChangeListener#onPreferenceChange(android.preference.Preference, java.lang.Object) onPreferenceChange()}
+
Below is the code that gets executed when the user clicks the Enable Admin checkbox. This has the effect of triggering the
+{@link android.preference.Preference.OnPreferenceChangeListener#onPreferenceChange(android.preference.Preference, java.lang.Object) onPreferenceChange()}
callback. This callback is invoked when the value of this {@link android.preference.Preference} has been changed by the user and is about to be set and/or persisted. If the user is enabling the application, the display
changes to prompt the user to activate the device admin application, as shown in figure
2. Otherwise, the device admin application is disabled.
@@ -556,7 +556,7 @@ containing at least numeric characters.
@@ -622,8 +622,8 @@ int maxFailedPw;
mDPM.setMaximumFailedPasswordsForWipe(mDeviceAdminSample, maxFailedPw);
Set password expiration timeout
-
Beginning with Android 3.0, you can use the
-{@link android.app.admin.DevicePolicyManager#setPasswordExpirationTimeout(android.content.ComponentName,long) setPasswordExpirationTimeout()}
+
Beginning with Android 3.0, you can use the
+{@link android.app.admin.DevicePolicyManager#setPasswordExpirationTimeout(android.content.ComponentName,long) setPasswordExpirationTimeout()}
method to set when a password will expire, expressed as a delta in milliseconds from when a device admin sets the expiration timeout. For example:
Beginning with Android 3.0, you can use the
-{@link android.app.admin.DevicePolicyManager#setPasswordHistoryLength(android.content.ComponentName,int) setPasswordHistoryLength()}
+
Beginning with Android 3.0, you can use the
+{@link android.app.admin.DevicePolicyManager#setPasswordHistoryLength(android.content.ComponentName,int) setPasswordHistoryLength()}
method to limit users'
ability to reuse old passwords. This method takes a length
parameter, which specifies how many old
passwords are stored. When this policy is active, users cannot enter a new
password that matches the last n passwords. This prevents
users from using the same password over and over. This policy is typically used
-in conjunction with
+in conjunction with
{@link android.app.admin.DevicePolicyManager#setPasswordExpirationTimeout(android.content.ComponentName,long) setPasswordExpirationTimeout()},
which forces users
to update their passwords after a specified amount of time has elapsed.
Beginning with Android 3.0, you can use the
-{@link android.app.admin.DevicePolicyManager#setStorageEncryption(android.content.ComponentName,boolean) setStorageEncryption()}
+{@link android.app.admin.DevicePolicyManager#setStorageEncryption(android.content.ComponentName,boolean) setStorageEncryption()}
method to set a policy requiring encryption of the storage area, where supported.
Binding App Widgets
@@ -32,58 +32,58 @@ to embed app widgets
access to content. If you're building a Home replacement or a similar app,
you can also allow the user to embed app widgets by implementing an
{@link android.appwidget.AppWidgetHost}.
-This is not something that most apps will ever need to do, but if you are
-creating your own host, it's important to understand the contractual obligations
+This is not something that most apps will ever need to do, but if you are
+creating your own host, it's important to understand the contractual obligations
a host implicitly agrees to.
-
This document focuses on the responsibilities involved in implementing a custom
-{@link android.appwidget.AppWidgetHost}. For an example of how to implement an
+
This document focuses on the responsibilities involved in implementing a custom
+{@link android.appwidget.AppWidgetHost}. For an example of how to implement an
{@link android.appwidget.AppWidgetHost}, see the source code for the
-Android Home screen
+Android Home screen
-Launcher.
+Launcher.
-
Here is an overview of key classes and concepts involved in implementing a custom
+
Here is an overview of key classes and concepts involved in implementing a custom
{@link android.appwidget.AppWidgetHost}:
-
App Widget Host—
- The {@link android.appwidget.AppWidgetHost} provides the interaction
-with the AppWidget service for apps, like the home screen, that want to embed
-app widgets in their UI. An {@link android.appwidget.AppWidgetHost} must have
-an ID that is unique within the host's own package. This ID remains persistent
+
App Widget Host—
+ The {@link android.appwidget.AppWidgetHost} provides the interaction
+with the AppWidget service for apps, like the home screen, that want to embed
+app widgets in their UI. An {@link android.appwidget.AppWidgetHost} must have
+an ID that is unique within the host's own package. This ID remains persistent
across all uses of the host. The ID is typically a hard-coded value that you assign
in your application.
-
+
App Widget ID—
- Each app widget instance is assigned a unique ID at the time of binding
-(see {@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed bindAppWidgetIdIfAllowed()},
-discussed in more detail in Binding app widgets).
-The unique ID is obtained by the host using {@link android.appwidget.AppWidgetHost#allocateAppWidgetId() allocateAppWidgetId()}. This ID is persistent across the lifetime of the widget,
-that is, until it is deleted from the host. Any host-specific state (such as the
-size and location of the widget) should be persisted by the hosting package and
+ Each app widget instance is assigned a unique ID at the time of binding
+(see {@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed bindAppWidgetIdIfAllowed()},
+discussed in more detail in Binding app widgets).
+The unique ID is obtained by the host using {@link android.appwidget.AppWidgetHost#allocateAppWidgetId() allocateAppWidgetId()}. This ID is persistent across the lifetime of the widget,
+that is, until it is deleted from the host. Any host-specific state (such as the
+size and location of the widget) should be persisted by the hosting package and
associated with the app widget ID.
-
-
App Widget Host View—
- {@link android.appwidget.AppWidgetHostView} can be thought of as a frame
-that the widget is wrapped in whenever it needs to be displayed. An app widget
-is assigned to an {@link android.appwidget.AppWidgetHostView} every time the
+
+
App Widget Host View—
+ {@link android.appwidget.AppWidgetHostView} can be thought of as a frame
+that the widget is wrapped in whenever it needs to be displayed. An app widget
+is assigned to an {@link android.appwidget.AppWidgetHostView} every time the
widget is inflated by the host.
Options Bundle—
-The {@link android.appwidget.AppWidgetHost} uses the options bundle to communicate
-information to the {@link android.appwidget.AppWidgetProvider} about how the
-widget is being displayed (for example, size range, and whether the widget is on
-a lockscreen or the home screen). This information allows the
-{@link android.appwidget.AppWidgetProvider} to tailor the widget's contents
+The {@link android.appwidget.AppWidgetHost} uses the options bundle to communicate
+information to the {@link android.appwidget.AppWidgetProvider} about how the
+widget is being displayed (for example, size range, and whether the widget is on
+a lockscreen or the home screen). This information allows the
+{@link android.appwidget.AppWidgetProvider} to tailor the widget's contents
and appearance based on how and where it is displayed.
-You use
+You use
{@link android.appwidget.AppWidgetHostView#updateAppWidgetOptions(android.os.Bundle) updateAppWidgetOptions()}
-and
+and
{@link android.appwidget.AppWidgetHostView#updateAppWidgetSize updateAppWidgetSize()}
-to modify an app widget's
-bundle. Both of these methods trigger a callback to the
+to modify an app widget's
+bundle. Both of these methods trigger a callback to the
{@link android.appwidget.AppWidgetProvider}.
@@ -98,15 +98,15 @@ app is running on.
Binding app widgets on Android 4.0 and lower
-
On devices running Android version 4.0 and lower, users add app widgets
-via a system activity that allows users to select a widget. This implicitly
-does a permission check—that is, by adding the app widget, the user is
-implicitly granting permission to your app to add app widgets to the host.
-Here is an example that illustrates
-this approach, taken from the original
-Launcher. In this snippet, an event handler invokes
-{@link android.app.Activity#startActivityForResult(android.content.Intent,int) startActivityForResult()}
-with the request code {@code REQUEST_PICK_APPWIDGET} in response to a
+
On devices running Android version 4.0 and lower, users add app widgets
+via a system activity that allows users to select a widget. This implicitly
+does a permission check—that is, by adding the app widget, the user is
+implicitly granting permission to your app to add app widgets to the host.
+Here is an example that illustrates
+this approach, taken from the original
+Launcher. In this snippet, an event handler invokes
+{@link android.app.Activity#startActivityForResult(android.content.Intent,int) startActivityForResult()}
+with the request code {@code REQUEST_PICK_APPWIDGET} in response to a
user action:
@@ -118,9 +118,9 @@ public void onClick(DialogInterface dialog, int which) {
...
case AddAdapter.ITEM_APPWIDGET: {
...
- int appWidgetId =
+ int appWidgetId =
Launcher.this.mAppWidgetHost.allocateAppWidgetId();
- Intent pickIntent =
+ Intent pickIntent =
new Intent(AppWidgetManager.ACTION_APPWIDGET_PICK);
pickIntent.putExtra
(AppWidgetManager.EXTRA_APPWIDGET_ID, appWidgetId);
@@ -135,7 +135,7 @@ public void onClick(DialogInterface dialog, int which) {
app widget to your activity. In the following example, the activity responds
by calling {@code addAppWidget()} to add the app widget:
-
public final class Launcher extends Activity
+
public final class Launcher extends Activity
implements View.OnClickListener, OnLongClickListener {
...
@Override
@@ -152,7 +152,7 @@ by calling {@code addAppWidget()} to add the app widget:
completeAddAppWidget(data, mAddItemCellInfo, !mDesktopLocked);
break;
}
- }
+ }
...
}
}
@@ -164,7 +164,7 @@ needs to be configured before it's added:
int appWidgetId = data.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1);
String customWidget = data.getStringExtra(EXTRA_CUSTOM_WIDGET);
- AppWidgetProviderInfo appWidget =
+ AppWidgetProviderInfo appWidget =
mAppWidgetManager.getAppWidgetInfo(appWidgetId);
if (appWidget.configure != null) {
@@ -183,7 +183,7 @@ see Creating
App Widget Configuration Activity.
Once the app widget is ready, the next step is to do the
-actual work of adding it to the workspace. The
+actual work of adding it to the workspace. The
original Launcher uses a method called {@code completeAddAppWidget()}
to do this.
@@ -201,12 +201,12 @@ binding. To use this improved process, your app must declare the
But this is just the first step. At runtime the user must
explicitly grant permission to your app to allow it to add app widgets
to the host. To test whether your app has permission to add the widget,
-you use the
-{@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed bindAppWidgetIdIfAllowed()}
-method.
+you use the
+{@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed bindAppWidgetIdIfAllowed()}
+method.
If {@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed bindAppWidgetIdIfAllowed()}
returns {@code false}, your app must display a dialog prompting the
-user to grant permission
+user to grant permission
("allow" or "always allow," to cover all future app widget additions).
This snippet gives an example of how to display the dialog:
The host also has to check whether the user added
+
The host also has to check whether the user added
an app widget that needs configuration. For more discussion of this topic,
-see
+see
Creating
an App Widget Configuration Activity.
@@ -229,23 +229,23 @@ an App Widget Configuration Activity.
What Version are You Targeting?
-
The approach you use in implementing your host should depend on what Android version
-you're targeting. Many of the features described in this section were introduced
+
The approach you use in implementing your host should depend on what Android version
+you're targeting. Many of the features described in this section were introduced
in 3.0 or later. For example:
Android 3.0 (API Level 11) introduces auto-advance behavior for widgets.
Android 3.1 (API Level 12) introduces the ability to resize widgets.
Android 4.0 (API Level 15) introduces a change in padding policy that
-puts the responsibility on the
+puts the responsibility on the
host to manage padding.
Android 4.1 (API Level 16) adds an API that allows the widget provider
to get more detailed information about the environment in which its
widget instances are being hosted.
-
Android 4.2 (API Level 17) introduces the options bundle and the
-{@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed(int,android.content.ComponentName,android.os.Bundle) bindAppWidgetIdIfAllowed()}
+
Android 4.2 (API Level 17) introduces the options bundle and the
+{@link android.appwidget.AppWidgetManager#bindAppWidgetIdIfAllowed(int,android.content.ComponentName,android.os.Bundle) bindAppWidgetIdIfAllowed()}
method. It also introduces lockscreen widgets.
-
If you are targeting earlier devices, refer to the original
+
If you are targeting earlier devices, refer to the original
Launcher as an example.
@@ -273,7 +273,7 @@ from the Configuration Activity. This is a necessary step for many app widge
they can be properly displayed.
Every app widget specifies a minimum width and height in dps, as defined in the {@link android.appwidget.AppWidgetProviderInfo} metadata
-(using {@link android.appwidget.AppWidgetProviderInfo#minWidth android:minWidth} and
+(using {@link android.appwidget.AppWidgetProviderInfo#minWidth android:minWidth} and
{@link android.appwidget.AppWidgetProviderInfo#minHeight android:minHeight}).
Make sure that the widget is laid out with at least this many dps.
For example, many hosts align icons and widgets in a grid. In this scenario,
@@ -379,7 +379,7 @@ so it is not explicitly required to set this for a home screen host.
for your app—for example, if your host is a home screen, ensure
that the
{@link android.appwidget.AppWidgetProviderInfo#widgetCategory android:widgetCategory}
-attribute in the
+attribute in the
{@link android.appwidget.AppWidgetProviderInfo} metadata includes
the flag {@link android.appwidget.AppWidgetProviderInfo#WIDGET_CATEGORY_HOME_SCREEN}.
Similarly, for the lockscreen, ensure that field includes the flag {@link android.appwidget.AppWidgetProviderInfo#WIDGET_CATEGORY_KEYGUARD}. For more
diff --git a/docs/html/guide/topics/appwidgets/index.jd b/docs/html/guide/topics/appwidgets/index.jd
index c9575e025f053..7d555ed2d8d89 100644
--- a/docs/html/guide/topics/appwidgets/index.jd
+++ b/docs/html/guide/topics/appwidgets/index.jd
@@ -4,7 +4,7 @@ page.tags=home,AppWidgetProvider
App Widgets are miniature application views that can be embedded in other
applications
(such as the Home screen) and receive periodic updates. These views are
-referred
+referred
to as Widgets in the user interface,
and you can publish one with an App Widget provider. An application component
-that is
+that is
able to hold other App Widgets is called an App Widget host. The screenshot
below shows
the Music App Widget.
@@ -85,14 +85,14 @@ update frequency,
Defines the basic methods that allow you to programmatically interface
with the App Widget,
based on broadcast events. Through it, you will receive broadcasts when the
-App Widget is updated,
+App Widget is updated,
enabled, disabled and deleted.
View layout
Defines the initial layout for the App Widget, defined in XML.
Additionally, you can implement an App Widget configuration Activity. This is
-an optional
+an optional
{@link android.app.Activity} that launches when the user adds your App Widget
and allows him or her
to modify App Widget settings at create-time.
@@ -117,7 +117,7 @@ application's
The <receiver> element requires the
-android:name
+android:name
attribute, which specifies the {@link android.appwidget.AppWidgetProvider} used
by the App Widget.
@@ -133,7 +133,7 @@ automatically sends all other App Widget broadcasts to the AppWidgetProvider as
necessary.
The <meta-data> element specifies the
-{@link android.appwidget.AppWidgetProviderInfo} resource and requires the
+{@link android.appwidget.AppWidgetProviderInfo} resource and requires the
following attributes:
android:name - Specifies the metadata name. Use
@@ -141,21 +141,21 @@ following attributes:
to identify the data as the {@link android.appwidget.AppWidgetProviderInfo}
descriptor.
android:resource - Specifies the {@link
-android.appwidget.AppWidgetProviderInfo}
+android.appwidget.AppWidgetProviderInfo}
resource location.
Adding the AppWidgetProviderInfo Metadata
-
The {@link android.appwidget.AppWidgetProviderInfo} defines the essential
+
The {@link android.appwidget.AppWidgetProviderInfo} defines the essential
qualities of an App Widget, such as its minimum layout dimensions, its initial
layout resource,
how often to update the App Widget, and (optionally) a configuration Activity to
launch at create-time.
Define the AppWidgetProviderInfo object in an XML resource using a single
<appwidget-provider> element and save it in the project's
-res/xml/
+res/xml/
folder.
The updatePeriodMillis attribute defines how often the App
Widget framework should request an update from the {@link
-android.appwidget.AppWidgetProvider} by calling the
-{@link android.appwidget.AppWidgetProvider#onUpdate(android.content.Context,android.appwidget.AppWidgetManager,int[]) onUpdate()}
+android.appwidget.AppWidgetProvider} by calling the
+{@link android.appwidget.AppWidgetProvider#onUpdate(android.content.Context,android.appwidget.AppWidgetManager,int[]) onUpdate()}
callback method. The actual update
is not guaranteed to occur exactly on time with this value and we suggest
updating as infrequently as possible—perhaps no more than once an hour to
conserve the battery. You might also allow the user to adjust the frequency in a
configuration—some people might want a stock ticker to update every 15
-minutes, or maybe only four times a day.
+minutes, or maybe only four times a day.
Note: If the device is asleep when it
-is time for an update
+is time for an update
(as defined by updatePeriodMillis), then the device will
-wake up in order
+wake up in order
to perform the update. If you don't update more than once per hour, this
-probably won't
+probably won't
cause significant problems for the battery life. If, however, you need
-to update more
+to update more
frequently and/or you do not need to update while the device is asleep,
-then you can instead
+then you can instead
perform updates based on an alarm that will not wake the device. To do
-so, set an alarm with
+so, set an alarm with
an Intent that your AppWidgetProvider receives, using the {@link
-android.app.AlarmManager}.
+android.app.AlarmManager}.
Set the alarm type to either {@link
-android.app.AlarmManager#ELAPSED_REALTIME} or
+android.app.AlarmManager#ELAPSED_REALTIME} or
{@link android.app.AlarmManager#RTC}, which will only
deliver the alarm when the device is awake. Then set
-updatePeriodMillis to
+updatePeriodMillis to
zero ("0").
The initialLayout attribute points to the layout resource
@@ -244,7 +244,7 @@ android.app.Activity} to launch when
Widget properties. This is optional
(read Creating an App Widget Configuration
Activity below).
-
+
The previewImage attribute specifies a preview of what the
app widget will look like after it's configured, which the user sees when
selecting the app widget. If not supplied, the user instead sees your
@@ -255,7 +255,7 @@ using previewImage, see Setting a Preview
Image. Introduced in Android 3.0.
The autoAdvanceViewId attribute specifies the view ID of the
-app widget subview that should be auto-advanced by the widget's host. Introduced in Android 3.0.
+app widget subview that should be auto-advanced by the widget's host. Introduced in Android 3.0.
The resizeMode attribute specifies the rules by which a widget
can be resized. You use this attribute to make homescreen widgets
@@ -264,7 +264,7 @@ widget to show its resize handles, then drag the horizontal and/or vertical
handles to change the size on the layout grid. Values for the
resizeMode attribute include "horizontal", "vertical", and "none".
To declare a widget as resizeable horizontally and vertically, supply the value
-"horizontal|vertical". Introduced in Android 3.1.
+"horizontal|vertical". Introduced in Android 3.1.
The minResizeHeight attribute specifies the minimum height (in dps) to which
the widget can be resized. This field has no effect if it is greater than {@code minHeight} or if
@@ -296,7 +296,7 @@ View objects listed
below, but before you begin designing your App Widget, please read and
understand the
App Widget
-Design
+Design
Guidelines.
Creating the App Widget layout is simple if you're
@@ -306,7 +306,7 @@ However, you must be aware that App Widget layouts are based on {@link
android.widget.RemoteViews},
which do not support every kind of layout or view widget.
-
A RemoteViews object (and, consequently, an App Widget) can support the
+
A RemoteViews object (and, consequently, an App Widget) can support the
following layout classes:
@@ -334,7 +334,7 @@ following layout classes:
Descendants of these classes are not supported.
-
RemoteViews also supports {@link android.view.ViewStub}, which is an invisible, zero-sized View you can use
+
RemoteViews also supports {@link android.view.ViewStub}, which is an invisible, zero-sized View you can use
to lazily inflate layout resources at runtime.
@@ -386,7 +386,7 @@ to lazily inflate layout resources at runtime.
You must declare your AppWidgetProvider class implementation as a
-broadcast receiver
+broadcast receiver
using the <receiver> element in the AndroidManifest (see
Declaring an App Widget in the Manifest above).
This is called to update the App Widget at intervals defined by the
updatePeriodMillis
- attribute in the AppWidgetProviderInfo (see Adding the
+ attribute in the AppWidgetProviderInfo (see Adding the
AppWidgetProviderInfo Metadata above). This method is also called
when the user adds the App Widget, so it should perform the essential setup,
such as define event handlers for Views and start a temporary
@@ -415,25 +415,25 @@ method calls:
configuration
Activity, this method is not called when the user adds the
App Widget,
- but is called for the subsequent updates. It is the responsibility of the
+ but is called for the subsequent updates. It is the responsibility of the
configuration Activity to perform the first update when configuration is
done.
(See Creating an App Widget Configuration
-Activity below.)
This is called when the widget is first placed and any time the widget is resized. You can use this callback to show or hide content based on the widget's size ranges. You get the size ranges by calling {@link android.appwidget.AppWidgetManager#getAppWidgetOptions getAppWidgetOptions()}, which returns a {@link android.os.Bundle} that includes the following:
{@link android.appwidget.AppWidgetManager#OPTION_APPWIDGET_MIN_WIDTH}—Contains
the lower bound on the current width, in dp units, of a widget instance.
{@link android.appwidget.AppWidgetManager#OPTION_APPWIDGET_MIN_HEIGHT}—Contains
the lower bound on the current height, in dp units, of a widget instance.
{@link android.appwidget.AppWidgetManager#OPTION_APPWIDGET_MAX_WIDTH}—Contains
the upper bound on the current width, in dp units, of a widget instance.
{@link android.appwidget.AppWidgetManager#OPTION_APPWIDGET_MAX_HEIGHT}—Contains
the upper bound on the current width, in dp units, of a widget instance.
@@ -444,34 +444,34 @@ This callback was introduced in API Level 16 (Android 4.1). If you implement thi
host.
This is called when an instance the App Widget is created for the first
-time. For example, if the user
+time. For example, if the user
adds two instances of your App Widget, this is only called the first time.
If you need to open a new database or perform other setup that only needs to
-occur once
- for all App Widget instances, then this is a good place to do it.
+occur once
+ for all App Widget instances, then this is a good place to do it.
This is called when the last instance of your App Widget is deleted from
-the App Widget host.
- This is where you should clean up any work done in
- {@link android.appwidget.AppWidgetProvider#onEnabled(Context)},
- such as delete a temporary database.
+the App Widget host.
+ This is where you should clean up any work done in
+ {@link android.appwidget.AppWidgetProvider#onEnabled(Context)},
+ such as delete a temporary database.
This is called for every broadcast and before each of the above callback
methods.
You normally don't need to implement this method because the default
-AppWidgetProvider
- implementation filters all App Widget broadcasts and calls the above
- methods as appropriate.
+AppWidgetProvider
+ implementation filters all App Widget broadcasts and calls the above
+ methods as appropriate.
-
The most important AppWidgetProvider callback is
-{@link android.appwidget.AppWidgetProvider#onUpdate(android.content.Context, android.appwidget.AppWidgetManager, int[]) onUpdate()}
+
The most important AppWidgetProvider callback is
+{@link android.appwidget.AppWidgetProvider#onUpdate(android.content.Context, android.appwidget.AppWidgetManager, int[]) onUpdate()}
because it is called when
each App Widget is added to a host (unless you use a configuration Activity). If
your App Widget accepts any user interaction events, then you need to register
the event handlers in this callback. If your App Widget doesn't create temporary
-files or databases, or perform other work that requires clean-up, then
-{@link android.appwidget.AppWidgetProvider#onUpdate(android.content.Context, android.appwidget.AppWidgetManager, int[]) onUpdate()}
+files or databases, or perform other work that requires clean-up, then
+{@link android.appwidget.AppWidgetProvider#onUpdate(android.content.Context, android.appwidget.AppWidgetManager, int[]) onUpdate()}
may be the only callback
method you need to define. For example, if you want an App Widget with a button
that launches an Activity when clicked, you could use the following
@@ -503,9 +503,9 @@ public class ExampleAppWidgetProvider extends AppWidgetProvider {
}
-
This AppWidgetProvider defines only the
+
This AppWidgetProvider defines only the
{@link
-android.appwidget.AppWidgetProvider#onUpdate(android.content.Context, android.appwidget.AppWidgetManager, int[]) onUpdate()}
+android.appwidget.AppWidgetProvider#onUpdate(android.content.Context, android.appwidget.AppWidgetManager, int[]) onUpdate()}
method for the purpose of
defining a {@link android.app.PendingIntent} that launches an {@link
android.app.Activity} and attaching it to the App Widget's button with {@link
@@ -528,8 +528,8 @@ running after the callback methods return (see {@link
android.content.BroadcastReceiver} for information about the broadcast
lifecycle). If your App Widget setup process can take several seconds (perhaps
while performing web requests) and you require that your process continues,
-consider starting a {@link android.app.Service} in the
-{@link android.appwidget.AppWidgetProvider#onUpdate(Context,AppWidgetManager,int[]) onUpdate()}
+consider starting a {@link android.app.Service} in the
+{@link android.appwidget.AppWidgetProvider#onUpdate(Context,AppWidgetManager,int[]) onUpdate()}
method. From within the Service, you can perform your own updates
to the App Widget without worrying about the AppWidgetProvider closing down due
to an Application
@@ -537,7 +537,7 @@ Not Responding (ANR) error. See the Wiktionary sample's AppWidgetProvider for an example of an App Widget running a {@link
android.app.Service}.
{@link android.appwidget.AppWidgetProvider} is just a convenience class. If
you would like
-to receive the App Widget broadcasts directly, you can implement your own
-{@link android.content.BroadcastReceiver} or override the
-{@link android.appwidget.AppWidgetProvider#onReceive(Context,Intent)} callback.
+to receive the App Widget broadcasts directly, you can implement your own
+{@link android.content.BroadcastReceiver} or override the
+{@link android.appwidget.AppWidgetProvider#onReceive(Context,Intent)} callback.
The Intents you need to care about are as follows:
@@ -565,11 +565,11 @@ The Intents you need to care about are as follows:
If you would like the user to configure settings when he or she adds a new
App Widget,
you can create an App Widget configuration Activity. This {@link
-android.app.Activity}
+android.app.Activity}
will be automatically launched by the App Widget host and allows the user to
configure
available settings for the App Widget at create-time, such as the App Widget
-color, size,
+color, size,
update period or other functionality settings.
The configuration Activity should be declared as a normal Activity in the
@@ -588,8 +588,8 @@ so the Activity needs to accept this Intent. For example:
Notice that the Activity is declared with a fully-qualified namespace,
-because
+because
it will be referenced from outside your package scope.
That's all you need to get started with a configuration Activity. Now all you
@@ -612,21 +612,21 @@ Activity. There are, however, two important things to remember when you
implement the Activity:
The App Widget host calls the configuration Activity and the configuration
-Activity should always
+Activity should always
return a result. The result should include the App Widget ID
passed by the Intent that launched the Activity (saved in the Intent extras
as
{@link android.appwidget.AppWidgetManager#EXTRA_APPWIDGET_ID}).
-
The
- {@link android.appwidget.AppWidgetProvider#onUpdate(Context,AppWidgetManager,int[]) onUpdate()}
+
The
+ {@link android.appwidget.AppWidgetProvider#onUpdate(Context,AppWidgetManager,int[]) onUpdate()}
method will not be called when the App Widget
is created
(the system will not send the ACTION_APPWIDGET_UPDATE broadcast when a
configuration Activity
is launched). It is the responsibility of the configuration Activity to
-request an update from the
- AppWidgetManager when the App Widget is first created. However,
-{@link android.appwidget.AppWidgetProvider#onUpdate(Context,AppWidgetManager,int[]) onUpdate()}
+request an update from the
+ AppWidgetManager when the App Widget is first created. However,
+{@link android.appwidget.AppWidgetProvider#onUpdate(Context,AppWidgetManager,int[]) onUpdate()}
will be called for subsequent updates—it is only skipped
the first time.
@@ -641,8 +641,8 @@ configuration Activity
When an App Widget uses a configuration Activity, it is the responsibility of
the Activity
-to update the App Widget when configuration is complete.
-You can do so by requesting an update directly from the
+to update the App Widget when configuration is complete.
+You can do so by requesting an update directly from the
{@link android.appwidget.AppWidgetManager}.
Here's a summary of the procedure to properly update the App Widget and close
@@ -655,7 +655,7 @@ Intent intent = getIntent();
Bundle extras = intent.getExtras();
if (extras != null) {
mAppWidgetId = extras.getInt(
- AppWidgetManager.EXTRA_APPWIDGET_ID,
+ AppWidgetManager.EXTRA_APPWIDGET_ID,
AppWidgetManager.INVALID_APPWIDGET_ID);
}
@@ -696,7 +696,7 @@ reaching the end, the App Widget host is notified that the configuration was
cancelled and the
App Widget will not be added.
@@ -708,7 +708,7 @@ sample class in ApiDemos for an example.
android.appwidget.AppWidgetProviderInfo#previewImage} field, which specifies a
preview of what the app widget looks like. This preview is shown to the user from the
widget picker. If this field is not supplied, the app widget's icon is used for
-the preview.
+the preview.
This is how you specify this setting in XML:
@@ -742,12 +742,12 @@ list. For an example, see the Gmail app widget.
{@link android.widget.GridView}
A view that shows items in
two-dimensional scrolling grid. For an example, see the Bookmarks app
-widget.
+widget.
{@link android.widget.StackView}
A
stacked card view (kind of like a rolodex), where the user can flick the front
card up/down to see the previous/next card, respectively. Examples include
-the YouTube and Books app widgets.
+the YouTube and Books app widgets.
{@link android.widget.AdapterViewFlipper}
An adapter-backed simple
{@link
@@ -764,7 +764,7 @@ must include extra architecture to support their use in app widgets. In the
context of an app widget, the {@link android.widget.Adapter} is replaced by a
{@link android.widget.RemoteViewsService.RemoteViewsFactory RemoteViewsFactory},
which is simply a thin wrapper around the {@link android.widget.Adapter}
-interface.
+interface.
When
requested for a specific item in the collection, the {@link
android.widget.RemoteViewsService.RemoteViewsFactory RemoteViewsFactory} creates
@@ -782,7 +782,7 @@ interface for an adapter between a collection view (such as {@link
android.widget.ListView}, {@link android.widget.GridView}, and so on) and the
underlying data for that view. From the StackView Widget
-sample, here is an example of the boilerplate code you use to implement
+sample, here is an example of the boilerplate code you use to implement
this service and interface:
@@ -813,13 +813,13 @@ sample:
This sample consists of a stack of 10 views, which display the values
"0!" through "9!" The sample
-app widget has these primary behaviors:
+app widget has these primary behaviors:
The user can vertically fling the top view in the
app widget to display the next or previous view. This is a built-in StackView
-behavior.
+behavior.
Without any user interaction, the app widget automatically advances
through
@@ -828,17 +828,17 @@ its views in sequence, like a slide show. This is due to the setting
res/xml/stackwidgetinfo.xml file. This setting applies to the view
ID,
which in this case is the view ID of the stack view.
-
+
If the user touches the top view, the app widget displays the {@link
android.widget.Toast} message "Touched view n," where
n is the index (position) of the touched view. For more discussion of
-how this is implemented, see
+how this is implemented, see
Adding behavior to individual items.
Implementing app widgets with collections
-
To implement an app widget with collections, you follow the same basic steps
+
To implement an app widget with collections, you follow the same basic steps
you would use to implement any app widget. The following sections describe the
additional steps you need to perform to implement an app widget with
collections.
@@ -940,7 +940,7 @@ collection:
int[] appWidgetIds) {
// update each of the app widgets with the remote adapter
for (int i = 0; i < appWidgetIds.length; ++i) {
-
+
// Set up the intent that starts the StackViewService, which will
// provide the views for this collection.
Intent intent = new Intent(context, StackWidgetService.class);
@@ -949,13 +949,13 @@ int[] appWidgetIds) {
intent.setData(Uri.parse(intent.toUri(Intent.URI_INTENT_SCHEME)));
// Instantiate the RemoteViews object for the app widget layout.
RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
- // Set up the RemoteViews object to use a RemoteViews adapter.
+ // Set up the RemoteViews object to use a RemoteViews adapter.
// This adapter connects
// to a RemoteViewsService through the specified intent.
// This is how you populate the data.
rv.setRemoteAdapter(appWidgetIds[i], R.id.stack_view, intent);
-
- // The empty view is displayed when the collection has no items.
+
+ // The empty view is displayed when the collection has no items.
// It should be in the same layout used to instantiate the RemoteViews
// object above.
rv.setEmptyView(R.id.stack_view, R.id.empty_view);
@@ -963,12 +963,12 @@ int[] appWidgetIds) {
//
// Do additional processing specific to this app widget...
//
-
- appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
+
+ appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
-
+
RemoteViewsService class
@@ -984,7 +984,7 @@ lifecycle.
As described above, your {@link android.widget.RemoteViewsService} subclass
provides the {@link android.widget.RemoteViewsService.RemoteViewsFactory
-RemoteViewsFactory} used to populate the remote collection view.
+RemoteViewsFactory} used to populate the remote collection view.
Specifically, you need to
perform these steps:
@@ -993,7 +993,7 @@ perform these steps:
Subclass {@link android.widget.RemoteViewsService}. {@link
android.widget.RemoteViewsService} is the service through which
a remote adapter can request {@link android.widget.RemoteViews}.
-
+
In your {@link android.widget.RemoteViewsService} subclass, include a
class that implements the {@link
android.widget.RemoteViewsService.RemoteViewsFactory RemoteViewsFactory}
@@ -1027,12 +1027,12 @@ functions as an adapter to glue the data to the remote collection view.
The two most important methods you need to implement for your
{@link android.widget.RemoteViewsService.RemoteViewsFactory RemoteViewsFactory}
-subclass are
+subclass are
{@link android.widget.RemoteViewsService.RemoteViewsFactory#onCreate()
onCreate()} and
{@link android.widget.RemoteViewsService.RemoteViewsFactory#getViewAt(int)
getViewAt()}
-.
+.
The system calls {@link
android.widget.RemoteViewsService.RemoteViewsFactory#onCreate() onCreate()} when
@@ -1047,7 +1047,7 @@ array and the text they contain is displayed
Here is an excerpt from the StackView Widget
-sample's
+sample's
{@link android.widget.RemoteViewsService.RemoteViewsFactory
RemoteViewsFactory} implementation that shows portions of the {@link
android.widget.RemoteViewsService.RemoteViewsFactory#onCreate() onCreate()}
@@ -1081,7 +1081,7 @@ RemoteViewsService.RemoteViewsFactory {
RemoteViewsFactory} method {@link
android.widget.RemoteViewsService.RemoteViewsFactory#getViewAt(int) getViewAt()}
returns a {@link android.widget.RemoteViews} object corresponding to the data at
-the specified position in the data set. Here is an excerpt from
+the specified position in the data set. Here is an excerpt from
the
StackView Widget sample's {@link
@@ -1089,8 +1089,8 @@ android.widget.RemoteViewsService.RemoteViewsFactory RemoteViewsFactory}
implementation:
public RemoteViews getViewAt(int position) {
-
- // Construct a remote views item based on the app widget item XML file,
+
+ // Construct a remote views item based on the app widget item XML file,
// and set the text based on the position.
RemoteViews rv = new RemoteViews(mContext.getPackageName(), R.layout.widget_item);
rv.setTextViewText(R.id.widget_item, mWidgetItems.get(position).text);
@@ -1104,7 +1104,7 @@ implementation:
The above sections show you how to bind your data to your app widget
collection. But what if you want to add dynamic behavior to the individual items
-in your collection view?
+in your collection view?
As described in Using the AppWidgetProvider
Class, you normally use {@link
@@ -1122,7 +1122,7 @@ android.widget.RemoteViews#setOnClickFillInIntent(int, android.content.Intent)
setOnClickFillInIntent()}. This entails setting up up a pending intent template
for your collection view, and then setting a fill-in intent on each item in the
collection via your {@link android.widget.RemoteViewsService.RemoteViewsFactory
-RemoteViewsFactory}.
When the user touches a view, the intent is fired and it broadcasts
TOAST_ACTION.
-
+
This broadcast is intercepted by the StackWidgetProvider's
{@link android.appwidget.AppWidgetProvider#onReceive(android.content.Context,
android.content.Intent) onReceive()} method, and the app widget displays the
@@ -1154,7 +1154,7 @@ href="{@docRoot}resources/samples/StackWidget/index.html">StackView Widget
sample uses a broadcast, but typically an app widget would simply launch an
activity in a scenario like this one.
-
Setting up the pending intent template
+
Setting up the pending intent template
The StackWidgetProvider ({@link
android.appwidget.AppWidgetProvider} subclass) sets up a pending intent.
@@ -1162,7 +1162,7 @@ Individuals items of a collection cannot set up their own pending intents.
Instead, the collection as a whole sets up a pending intent template, and the
individual items set a fill-in intent to create unique behavior on an
item-by-item
-basis.
+basis.
This class also receives the broadcast that is sent when the user touches a
view. It processes this event in its {@link
@@ -1179,7 +1179,7 @@ message for the current view.
...
// Called when the BroadcastReceiver receives an Intent broadcast.
- // Checks to see whether the intent's action is TOAST_ACTION. If it is, the app widget
+ // Checks to see whether the intent's action is TOAST_ACTION. If it is, the app widget
// displays a Toast message for the current item.
@Override
public void onReceive(Context context, Intent intent) {
@@ -1192,12 +1192,12 @@ message for the current view.
}
super.onReceive(context, intent);
}
-
+
@Override
public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
// update each of the app widgets with the remote adapter
for (int i = 0; i < appWidgetIds.length; ++i) {
-
+
// Sets up the intent that points to the StackViewService that will
// provide the views for this collection.
Intent intent = new Intent(context, StackWidgetService.class);
@@ -1207,7 +1207,7 @@ message for the current view.
intent.setData(Uri.parse(intent.toUri(Intent.URI_INTENT_SCHEME)));
RemoteViews rv = new RemoteViews(context.getPackageName(), R.layout.widget_layout);
rv.setRemoteAdapter(appWidgetIds[i], R.id.stack_view, intent);
-
+
// The empty view is displayed when the collection has no items. It should be a sibling
// of the collection view.
rv.setEmptyView(R.id.stack_view, R.id.empty_view);
@@ -1227,13 +1227,13 @@ message for the current view.
PendingIntent toastPendingIntent = PendingIntent.getBroadcast(context, 0, toastIntent,
PendingIntent.FLAG_UPDATE_CURRENT);
rv.setPendingIntentTemplate(R.id.stack_view, toastPendingIntent);
-
+
appWidgetManager.updateAppWidget(appWidgetIds[i], rv);
}
super.onUpdate(context, appWidgetManager, appWidgetIds);
}
}
-
+
Setting the fill-in Intent
Your {@link android.widget.RemoteViewsService.RemoteViewsFactory
@@ -1274,17 +1274,17 @@ class StackRemoteViewsFactory implements RemoteViewsService.RemoteViewsFactory {
...
}
...
-
- // Given the position (index) of a WidgetItem in the array, use the item's text value in
+
+ // Given the position (index) of a WidgetItem in the array, use the item's text value in
// combination with the app widget item XML file to construct a RemoteViews object.
public RemoteViews getViewAt(int position) {
// position will always range from 0 to getCount() - 1.
-
+
// Construct a RemoteViews item based on the app widget item XML file, and set the
// text based on the position.
RemoteViews rv = new RemoteViews(mContext.getPackageName(), R.layout.widget_item);
rv.setTextViewText(R.id.widget_item, mWidgetItems.get(position).text);
-
+
// Next, set a fill-intent, which will be used to fill in the pending intent template
// that is set on the collection view in StackWidgetProvider.
Bundle extras = new Bundle();
@@ -1294,9 +1294,9 @@ class StackRemoteViewsFactory implements RemoteViewsService.RemoteViewsFactory {
// Make it possible to distinguish the individual on-click
// action of a given item
rv.setOnClickFillInIntent(R.id.widget_item, fillInIntent);
-
+
...
-
+
// Return the RemoteViews object.
return rv;
}
diff --git a/docs/html/guide/topics/connectivity/bluetooth-le.jd b/docs/html/guide/topics/connectivity/bluetooth-le.jd
index 3d606863052a2..ba742eeef8a2a 100644
--- a/docs/html/guide/topics/connectivity/bluetooth-le.jd
+++ b/docs/html/guide/topics/connectivity/bluetooth-le.jd
@@ -171,7 +171,7 @@ include the following in your app's manifest:
However, if you want to make your app available to devices that don't support BLE,
-you should still include this element in your app's manifest, but set {@code required="false"}.
+you should still include this element in your app's manifest, but set {@code required="false"}.
Then at run-time you can determine BLE availability by using
{@link android.content.pm.PackageManager#hasSystemFeature PackageManager.hasSystemFeature()}:
diff --git a/docs/html/guide/topics/connectivity/bluetooth.jd b/docs/html/guide/topics/connectivity/bluetooth.jd
index 96008c5c5701a..07fcd09a751ce 100644
--- a/docs/html/guide/topics/connectivity/bluetooth.jd
+++ b/docs/html/guide/topics/connectivity/bluetooth.jd
@@ -4,55 +4,55 @@ page.tags=wireless,bluetoothadapter,bluetoothdevice
The Android platform includes support for the Bluetooth network stack,
which allows a device to wirelessly exchange data with other Bluetooth devices.
The application framework provides access to the Bluetooth functionality through
the Android Bluetooth APIs. These APIs let applications wirelessly
connect to other Bluetooth devices, enabling point-to-point and multipoint
-wireless features.
-
+wireless features.
+
Using the Bluetooth APIs, an Android application can perform the
following:
Provides support for
Bluetooth headsets to be used with mobile phones. This includes both Bluetooth
-Headset and Hands-Free (v1.5) profiles.
+Headset and Hands-Free (v1.5) profiles.
{@link android.bluetooth.BluetoothA2dp}
Defines how high quality
audio can be streamed from one device to another over a Bluetooth connection.
-"A2DP" stands for Advanced Audio Distribution Profile.
+"A2DP" stands for Advanced Audio Distribution Profile.
{@link android.bluetooth.BluetoothHealth}
Represents a Health Device Profile proxy that controls the Bluetooth service.
@@ -146,23 +146,23 @@ application’s registration state and Bluetooth channel state.
Represents an application configuration that the Bluetooth Health third-party
+
Represents an application configuration that the Bluetooth Health third-party
application registers to communicate with a remote Bluetooth health
-device.
An interface that notifies {@link android.bluetooth.BluetoothProfile} IPC
clients when they have been connected to or disconnected from the service (that
is, the internal service that runs a particular profile).
-
-
-
-
-
-
-
Bluetooth Permissions
-
+
+
+
+
+
+
+
Bluetooth Permissions
+
In order to use Bluetooth features in your application, you must declare
the Bluetooth permission {@link android.Manifest.permission#BLUETOOTH}.
You need this permission to perform any Bluetooth communication,
@@ -175,40 +175,40 @@ ability to discover local Bluetooth devices. The other abilities granted by this
permission should not be used, unless the application is a "power manager" that
will modify Bluetooth settings upon user request. Note: If you
use {@link android.Manifest.permission#BLUETOOTH_ADMIN} permission, then you must
-also have the {@link android.Manifest.permission#BLUETOOTH} permission.
-
+also have the {@link android.Manifest.permission#BLUETOOTH} permission.
+
Declare the Bluetooth permission(s) in your application manifest file. For
-example:
See the <uses-permission>
-reference for more information about declaring application permissions.
-
-
-
Setting Up Bluetooth
-
-
-
+href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission>
+reference for more information about declaring application permissions.
+
+
+
Setting Up Bluetooth
+
+
+Figure 1: The enabling Bluetooth dialog.
-
-
+
+
Before your application can communicate over Bluetooth, you need to verify
-that Bluetooth is supported on the device, and if so, ensure that it is enabled.
-
+that Bluetooth is supported on the device, and if so, ensure that it is enabled.
+
If Bluetooth is not supported, then you should gracefully disable any
Bluetooth features. If Bluetooth is supported, but disabled, then you can request that the
user enable Bluetooth without leaving your application. This setup is
-accomplished in two steps, using the {@link android.bluetooth.BluetoothAdapter}.
-
-
-
+accomplished in two steps, using the {@link android.bluetooth.BluetoothAdapter}.
+
+
+
Get the {@link android.bluetooth.BluetoothAdapter}
The {@link android.bluetooth.BluetoothAdapter} is required for any and all Bluetooth
activity. To get the {@link android.bluetooth.BluetoothAdapter}, call the static {@link
@@ -217,15 +217,15 @@ android.bluetooth.BluetoothAdapter#getDefaultAdapter()} method. This returns a
Bluetooth adapter (the Bluetooth radio). There's one Bluetooth adapter for the
entire system, and your application can interact with it using this object. If
{@link android.bluetooth.BluetoothAdapter#getDefaultAdapter()} returns null,
-then the device does not support Bluetooth and your story ends here. For example:
-
+then the device does not support Bluetooth and your story ends here. For example:
+
BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
if (mBluetoothAdapter == null) {
// Device does not support Bluetooth
}
-
-
-
+
+
+
Enable Bluetooth
Next, you need to ensure that Bluetooth is enabled. Call {@link
android.bluetooth.BluetoothAdapter#isEnabled()} to check whether Bluetooth is
@@ -234,17 +234,17 @@ request that Bluetooth be enabled, call {@link
android.app.Activity#startActivityForResult(Intent,int) startActivityForResult()}
with the {@link android.bluetooth.BluetoothAdapter#ACTION_REQUEST_ENABLE} action Intent.
This will issue a request to enable Bluetooth through the system settings (without
-stopping your application). For example:
-
+stopping your application). For example:
+
if (!mBluetoothAdapter.isEnabled()) {
Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
}
-
-
+
+
A dialog will appear requesting user permission to enable Bluetooth, as shown
in Figure 1. If the user responds "Yes," the system will begin to enable Bluetooth
-and focus will return to your application once the process completes (or fails).
+and focus will return to your application once the process completes (or fails).
The {@code REQUEST_ENABLE_BT} constant passed to {@link
android.app.Activity#startActivityForResult(Intent,int) startActivityForResult()} is a locally
@@ -259,9 +259,9 @@ android.app.Activity#onActivityResult(int,int,Intent) onActivityResult()}
callback. If Bluetooth was not enabled
due to an error (or the user responded "No") then the result code is {@link
android.app.Activity#RESULT_CANCELED}.
-
-
-
+
+
+
Optionally, your application can also listen for the
{@link android.bluetooth.BluetoothAdapter#ACTION_STATE_CHANGED} broadcast Intent, which
the system will broadcast whenever the Bluetooth state has changed. This broadcast contains
@@ -273,21 +273,21 @@ android.bluetooth.BluetoothAdapter#STATE_ON}, {@link
android.bluetooth.BluetoothAdapter#STATE_TURNING_OFF}, and {@link
android.bluetooth.BluetoothAdapter#STATE_OFF}. Listening for this
broadcast can be useful to detect changes made to the Bluetooth state while your
-app is running.
-
+app is running.
+
Tip: Enabling discoverability will automatically
enable Bluetooth. If you plan to consistently enable device discoverability before
performing Bluetooth activity, you can skip
step 2 above. Read about enabling discoverability,
-below.
-
-
-
Finding Devices
-
+below.
+
+
+
Finding Devices
+
Using the {@link android.bluetooth.BluetoothAdapter}, you can find remote Bluetooth
devices either through device discovery or by querying the list of paired (bonded)
-devices.
-
+devices.
+
Device discovery is a scanning procedure that searches the local area for
Bluetooth enabled devices and then requesting some information about each one
(this is sometimes referred to as "discovering," "inquiring" or "scanning").
@@ -296,15 +296,15 @@ request only if it is currently enabled to be discoverable. If a device is
discoverable, it will respond to the discovery request by sharing some
information, such as the device name, class, and its unique MAC address. Using
this information, the device performing discovery can then choose to initiate a
-connection to the discovered device.
-
+connection to the discovered device.
+
Once a connection is made with a remote device for the first time, a pairing
request is automatically presented to the user. When a device is
paired, the basic information about that device (such as the device name, class,
and MAC address) is saved and can be read using the Bluetooth APIs. Using the
known MAC address for a remote device, a connection can be initiated with it at
-any time without performing discovery (assuming the device is within range).
-
+any time without performing discovery (assuming the device is within range).
+
Remember there is a difference between being paired and being connected. To
be paired means that two devices are aware of each other's existence, have a
shared link-key that can be used for authentication, and are capable of
@@ -312,28 +312,28 @@ establishing an encrypted connection with each other. To be connected means that
the devices currently share an RFCOMM channel and are able to transmit data with
each other. The current Android Bluetooth API's require devices to be paired
before an RFCOMM connection can be established. (Pairing is automatically performed
-when you initiate an encrypted connection with the Bluetooth APIs.)
-
+when you initiate an encrypted connection with the Bluetooth APIs.)
+
The following sections describe how to find devices that have been paired, or
-discover new devices using device discovery.
-
+discover new devices using device discovery.
+
Note: Android-powered devices are not
discoverable by default. A user can make
the device discoverable for a limited time through the system settings, or an
application can request that the user enable discoverability without leaving the
-application. How to enable discoverability
-is discussed below.
Before performing device discovery, its worth querying the set
of paired devices to see if the desired device is already known. To do so,
call {@link android.bluetooth.BluetoothAdapter#getBondedDevices()}. This
will return a Set of {@link android.bluetooth.BluetoothDevice}s representing
paired devices. For example, you can query all paired devices and then
-show the name of each device to the user, using an ArrayAdapter:
-
+show the name of each device to the user, using an ArrayAdapter:
+
Set<BluetoothDevice> pairedDevices = mBluetoothAdapter.getBondedDevices();
// If there are paired devices
if (pairedDevices.size() > 0) {
@@ -343,24 +343,24 @@ if (pairedDevices.size() > 0) {
mArrayAdapter.add(device.getName() + "\n" + device.getAddress());
}
}
-
-
+
+
All that's needed from the {@link android.bluetooth.BluetoothDevice} object
in order to initiate a connection is the MAC address. In this example, it's saved
as a part of an ArrayAdapter that's shown to the user. The MAC address can later
be extracted in order to initiate the connection. You can learn more about creating
-a connection in the section about Connecting Devices.
To start discovering devices, simply call {@link
android.bluetooth.BluetoothAdapter#startDiscovery()}. The
process is asynchronous and the method will immediately return with a boolean
indicating whether discovery has successfully started. The discovery process
usually involves an inquiry scan of about 12 seconds, followed by a page scan of
-each found device to retrieve its Bluetooth name.
-
+each found device to retrieve its Bluetooth name.
+
Your application must register a BroadcastReceiver for the
{@link android.bluetooth.BluetoothDevice#ACTION_FOUND} Intent in
order to receive information about each
@@ -371,8 +371,8 @@ Intent carries the extra fields
{@link android.bluetooth.BluetoothDevice#EXTRA_CLASS}, containing a
{@link android.bluetooth.BluetoothDevice} and a {@link
android.bluetooth.BluetoothClass}, respectively. For example, here's how you can
-register to handle the broadcast when devices are discovered:
-
+register to handle the broadcast when devices are discovered:
+
// Create a BroadcastReceiver for ACTION_FOUND
private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
public void onReceive(Context context, Intent intent) {
@@ -389,15 +389,15 @@ private final BroadcastReceiver mReceiver = new BroadcastReceiver() {
// Register the BroadcastReceiver
IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(mReceiver, filter); // Don't forget to unregister during onDestroy
-
-
+
+
All that's needed from the {@link android.bluetooth.BluetoothDevice} object
in order to initiate a
connection is the MAC address. In this example, it's saved as a part of an
ArrayAdapter that's shown to the user. The MAC address can later be extracted in
order to initiate the connection. You can learn more about creating a connection
-in the section about Connecting Devices.
Caution: Performing device discovery is
a heavy procedure for the Bluetooth
adapter and will consume a lot of its resources. Once you have found a device to
@@ -406,10 +406,10 @@ connect, be certain that you always stop discovery with
attempting a connection. Also, if you
already hold a connection with a device, then performing discovery can
significantly reduce the bandwidth available for the connection, so you should
-not perform discovery while connected.
-
-
Enabling discoverability
-
+not perform discovery while connected.
+
+
Enabling discoverability
+
If you would like to make the local device discoverable to other devices,
call {@link android.app.Activity#startActivityForResult(Intent,int)} with the
{@link android.bluetooth.BluetoothAdapter#ACTION_REQUEST_DISCOVERABLE} action
@@ -420,30 +420,30 @@ discoverable for 120 seconds. You can define a different duration by adding the
extra. The maximum duration an app can set is 3600 seconds, and a value of 0
means the device is always discoverable. Any value below 0 or above 3600 is
automatically set to 120 secs). For example, this snippet sets the duration to
-300:
+300:
Intent discoverableIntent = new
Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivity(discoverableIntent);
-
-
-
-
+
+
+
+Figure 2: The enabling discoverability dialog.
-
-
+
+
A dialog will be displayed, requesting user permission to make the device
discoverable, as shown in Figure 2. If the user responds "Yes," then the device
will become discoverable for the specified amount of time. Your activity will
then receive a call to the {@link android.app.Activity#onActivityResult(int,int,Intent)
onActivityResult())} callback, with the result code equal to the duration that the device
is discoverable. If the user responded "No" or if an error occurred, the result code will
-be {@link android.app.Activity#RESULT_CANCELED}.
Note: If Bluetooth has not been enabled on the device,
-then enabling device discoverability will automatically enable Bluetooth.
-
+then enabling device discoverability will automatically enable Bluetooth.
+
The device will silently remain in discoverable mode for the allotted time.
If you would like to be notified when the discoverable mode has changed, you can
register a BroadcastReceiver for the {@link
@@ -457,18 +457,18 @@ new and old scan mode, respectively. Possible values for each are
android.bluetooth.BluetoothAdapter#SCAN_MODE_NONE},
which indicate that the device is either in discoverable mode, not in
discoverable mode but still able to receive connections, or not in discoverable
-mode and unable to receive connections, respectively.
-
+mode and unable to receive connections, respectively.
+
You do not need to enable device discoverability if you will be initiating
the connection to a remote device. Enabling discoverability is only necessary when
you want your application to host a server socket that will accept incoming
connections, because the remote devices must be able to discover the device
-before it can initiate the connection.
-
-
-
-
Connecting Devices
-
+before it can initiate the connection.
+
+
+
+
Connecting Devices
+
In order to create a connection between your application on two devices, you
must implement both the server-side and client-side mechanisms, because one
device must open a server socket and the other one must initiate the connection
@@ -478,36 +478,36 @@ client are considered connected to each other when they each have a connected
point, each device can obtain input and output streams and data transfer can
begin, which is discussed in the section about Managing a Connection. This section describes how
-to initiate the connection between two devices.
-
+to initiate the connection between two devices.
+
The server device and the client device each obtain the required {@link
android.bluetooth.BluetoothSocket} in different ways. The server will receive it
when an incoming connection is accepted. The client will receive it when it
-opens an RFCOMM channel to the server.
-
-
-
+opens an RFCOMM channel to the server.
+
+
+Figure 3: The Bluetooth pairing dialog.
-
-
+
+
One implementation technique is to automatically prepare each device as a
server, so that each one has a server socket open and listening for connections.
Then either device can initiate a connection with the other and become the
client. Alternatively, one device can explicitly "host" the connection and open
a server socket on demand and the other device can simply initiate the
-connection.
-
+connection.
+
Note: If the two devices have not been previously paired,
then the Android framework will automatically show a pairing request notification or
dialog to the user during the connection procedure, as shown in Figure 3. So
when attempting to connect devices,
your application does not need to be concerned about whether or not the devices are
paired. Your RFCOMM connection attempt will block until the user has successfully paired,
-or will fail if the user rejects pairing, or if pairing fails or times out.
-
-
-
Connecting as a server
-
+or will fail if the user rejects pairing, or if pairing fails or times out.
+
+
+
Connecting as a server
+
When you want to connect two devices, one must act as a server by holding an
open {@link android.bluetooth.BluetoothServerSocket}. The purpose of the server
socket is to listen for incoming connection requests and when one is accepted,
@@ -515,26 +515,26 @@ provide a connected {@link android.bluetooth.BluetoothSocket}. When the {@link
android.bluetooth.BluetoothSocket} is acquired from the {@link
android.bluetooth.BluetoothServerSocket},
the {@link android.bluetooth.BluetoothServerSocket} can (and should) be
-discarded, unless you want to accept more connections.
-
-
-
-
About UUID
-
+discarded, unless you want to accept more connections.
+
+
+
+
About UUID
+
A Universally Unique Identifier (UUID) is a standardized 128-bit format for a string
ID used to uniquely identify information. The point of a UUID is that it's big
enough that you can select any random and it won't clash. In this case, it's
used to uniquely identify your application's Bluetooth service. To get a UUID to
use with your application, you can use one of the many random UUID generators on
the web, then initialize a {@link java.util.UUID} with {@link
-java.util.UUID#fromString(String)}.
-
-
-
+java.util.UUID#fromString(String)}.
+
+
+
Here's the basic procedure to set up a server socket and accept a
-connection:
-
-
+connection:
+
+
Get a {@link android.bluetooth.BluetoothServerSocket} by calling the
{@link
android.bluetooth.BluetoothAdapter#listenUsingRfcommWithServiceRecord(String,
@@ -546,9 +546,9 @@ UUID is also included in the SDP entry and will be the basis for the connection
agreement with the client device. That is, when the client attempts to connect
with this device, it will carry a UUID that uniquely identifies the service with
which it wants to connect. These UUIDs must match in order for the connection to
-be accepted (in the next step).
-
-
+be accepted (in the next step).
+
+
Start listening for connection requests by calling
{@link android.bluetooth.BluetoothServerSocket#accept()}.
This is a blocking call. It will return when either a connection has been
@@ -556,9 +556,9 @@ accepted or an exception has occurred. A connection is accepted only when a
remote device has sent a connection request with a UUID matching the one
registered with this listening server socket. When successful, {@link
android.bluetooth.BluetoothServerSocket#accept()} will
-return a connected {@link android.bluetooth.BluetoothSocket}.
-
-
+return a connected {@link android.bluetooth.BluetoothSocket}.
+
+
Unless you want to accept additional connections, call
{@link android.bluetooth.BluetoothServerSocket#close()}.
This releases the server socket and all its resources, but does not close the
@@ -567,10 +567,10 @@ android.bluetooth.BluetoothServerSocket#accept()}. Unlike TCP/IP, RFCOMM only al
connected client per channel at a time, so in most cases it makes sense to call {@link
android.bluetooth.BluetoothServerSocket#close()} on the {@link
android.bluetooth.BluetoothServerSocket} immediately after accepting a connected
-socket.
-
-
-
+socket.
+
+
+
The {@link android.bluetooth.BluetoothServerSocket#accept()} call should not
be executed in the main activity UI thread because it is a blocking call and
will prevent any other interaction with the application. It usually makes
@@ -583,16 +583,16 @@ android.bluetooth.BluetoothServerSocket} (or {@link
android.bluetooth.BluetoothSocket}) from another thread and the blocked call will
immediately return. Note that all methods on a {@link
android.bluetooth.BluetoothServerSocket} or {@link android.bluetooth.BluetoothSocket}
-are thread-safe.
-
-
Example
-
+are thread-safe.
+
+
Example
+
Here's a simplified thread for the server component that accepts incoming
-connections:
-
+connections:
+
private class AcceptThread extends Thread {
private final BluetoothServerSocket mmServerSocket;
-
+
public AcceptThread() {
// Use a temporary object that is later assigned to mmServerSocket,
// because mmServerSocket is final
@@ -603,7 +603,7 @@ private class AcceptThread extends Thread {
} catch (IOException e) { }
mmServerSocket = tmp;
}
-
+
public void run() {
BluetoothSocket socket = null;
// Keep listening until exception occurs or a socket is returned
@@ -622,7 +622,7 @@ private class AcceptThread extends Thread {
}
}
}
-
+
/** Will cancel the listening socket, and cause the thread to finish */
public void cancel() {
try {
@@ -630,37 +630,37 @@ private class AcceptThread extends Thread {
} catch (IOException e) { }
}
}
-
-
+
+
In this example, only one incoming connection is desired, so as soon as a
connection is accepted and the {@link android.bluetooth.BluetoothSocket} is
acquired, the application
sends the acquired {@link android.bluetooth.BluetoothSocket} to a separate
thread, closes the
-{@link android.bluetooth.BluetoothServerSocket} and breaks the loop.
-
+{@link android.bluetooth.BluetoothServerSocket} and breaks the loop.
+
Note that when {@link android.bluetooth.BluetoothServerSocket#accept()}
returns the {@link android.bluetooth.BluetoothSocket}, the socket is already
connected, so you should not call {@link
android.bluetooth.BluetoothSocket#connect()} (as you do from the
-client-side).
-
+client-side).
+
manageConnectedSocket() is a fictional method in the application
that will
initiate the thread for transferring data, which is discussed in the section
-about Managing a Connection.
You should usually close your {@link android.bluetooth.BluetoothServerSocket}
as soon as you are done listening for incoming connections. In this example, {@link
android.bluetooth.BluetoothServerSocket#close()} is called as soon
as the {@link android.bluetooth.BluetoothSocket} is acquired. You may also want
to provide a public method in your thread that can close the private {@link
android.bluetooth.BluetoothSocket} in the event that you need to stop listening on the
-server socket.
-
-
-
Connecting as a client
-
+server socket.
+
+
+
Connecting as a client
+
In order to initiate a connection with a remote device (a device holding an
open
server socket), you must first obtain a {@link
@@ -669,11 +669,11 @@ android.bluetooth.BluetoothDevice} object that represents the remote device.
section about Finding Devices.) You must then use the
{@link android.bluetooth.BluetoothDevice} to acquire a {@link
-android.bluetooth.BluetoothSocket} and initiate the connection.
-
-
Here's the basic procedure:
-
-
+android.bluetooth.BluetoothSocket} and initiate the connection.
+
+
Here's the basic procedure:
+
+
Using the {@link android.bluetooth.BluetoothDevice}, get a {@link
android.bluetooth.BluetoothSocket} by calling {@link
android.bluetooth.BluetoothDevice#createRfcommSocketToServiceRecord(UUID)}.
@@ -684,9 +684,9 @@ must match the UUID used by the server device when it opened its
android.bluetooth.BluetoothAdapter#listenUsingRfcommWithServiceRecord(String,
UUID)}). Using the same UUID is simply a matter of hard-coding the UUID string
into your application and then referencing it from both the server and client
-code.
-
-
+code.
+
+
Initiate the connection by calling {@link
android.bluetooth.BluetoothSocket#connect()}.
Upon this call, the system will perform an SDP lookup on the remote device in
@@ -697,34 +697,34 @@ android.bluetooth.BluetoothSocket#connect()} will return. This method is a
blocking call. If, for
any reason, the connection fails or the {@link
android.bluetooth.BluetoothSocket#connect()} method times out (after about
-12 seconds), then it will throw an exception.
+12 seconds), then it will throw an exception.
Because {@link
android.bluetooth.BluetoothSocket#connect()} is a blocking call, this connection
procedure should always be performed in a thread separate from the main activity
-thread.
+thread.
Note: You should always ensure that the device is not performing
device discovery when you call {@link
android.bluetooth.BluetoothSocket#connect()}. If discovery is in progress, then
the
-connection attempt will be significantly slowed and is more likely to fail.
-
-
-
-
Example
-
+connection attempt will be significantly slowed and is more likely to fail.
+
+
+
+
Example
+
Here is a basic example of a thread that initiates a Bluetooth
-connection:
-
+connection:
+
private class ConnectThread extends Thread {
private final BluetoothSocket mmSocket;
private final BluetoothDevice mmDevice;
-
+
public ConnectThread(BluetoothDevice device) {
// Use a temporary object that is later assigned to mmSocket,
// because mmSocket is final
BluetoothSocket tmp = null;
mmDevice = device;
-
+
// Get a BluetoothSocket to connect with the given BluetoothDevice
try {
// MY_UUID is the app's UUID string, also used by the server code
@@ -732,11 +732,11 @@ private class ConnectThread extends Thread {
} catch (IOException e) { }
mmSocket = tmp;
}
-
+
public void run() {
// Cancel discovery because it will slow down the connection
mBluetoothAdapter.cancelDiscovery();
-
+
try {
// Connect the device through the socket. This will block
// until it succeeds or throws an exception
@@ -748,11 +748,11 @@ private class ConnectThread extends Thread {
} catch (IOException closeException) { }
return;
}
-
+
// Do work to manage the connection (in a separate thread)
manageConnectedSocket(mmSocket);
}
-
+
/** Will cancel an in-progress connection, and close the socket */
public void cancel() {
try {
@@ -760,42 +760,42 @@ private class ConnectThread extends Thread {
} catch (IOException e) { }
}
}
-
-
+
+
Notice that {@link android.bluetooth.BluetoothAdapter#cancelDiscovery()} is called
before the connection is made. You should always do this before connecting and it is safe
to call without actually checking whether it is running or not (but if you do want to
-check, call {@link android.bluetooth.BluetoothAdapter#isDiscovering()}).
manageConnectedSocket() is a fictional method in the application
that will initiate the thread for transferring data, which is discussed in the section
-about Managing a Connection.
When you're done with your {@link android.bluetooth.BluetoothSocket}, always
call {@link android.bluetooth.BluetoothSocket#close()} to clean up.
Doing so will immediately close the connected socket and clean up all internal
-resources.
-
-
-
Managing a Connection
-
+resources.
+
+
+
Managing a Connection
+
When you have successfully connected two (or more) devices, each one will
have a connected {@link android.bluetooth.BluetoothSocket}. This is where the fun
begins because you can share data between devices. Using the {@link
android.bluetooth.BluetoothSocket}, the general procedure to transfer arbitrary data is
-simple:
-
+simple:
+
Get the {@link java.io.InputStream} and {@link java.io.OutputStream} that
handle transmissions through the socket, via {@link
android.bluetooth.BluetoothSocket#getInputStream()} and
-{@link android.bluetooth.BluetoothSocket#getOutputStream}, respectively.
Read and write data to the streams with {@link
-java.io.InputStream#read(byte[])} and {@link java.io.OutputStream#write(byte[])}.
-
-
-
That's it.
-
+java.io.InputStream#read(byte[])} and {@link java.io.OutputStream#write(byte[])}.
+
+
+
That's it.
+
There are, of course, implementation details to consider. First and foremost,
you should use a dedicated thread for all stream reading and writing. This is
important because both {@link java.io.InputStream#read(byte[])} and {@link
@@ -806,37 +806,37 @@ block, but can block for flow control if the remote device is not calling {@link
java.io.InputStream#read(byte[])} quickly enough and the intermediate buffers are full.
So, your main loop in the thread should be dedicated to reading from the {@link
java.io.InputStream}. A separate public method in the thread can be used to initiate
-writes to the {@link java.io.OutputStream}.
-
-
Example
-
-
Here's an example of how this might look:
-
+writes to the {@link java.io.OutputStream}.
+
+
Example
+
+
Here's an example of how this might look:
+
private class ConnectedThread extends Thread {
private final BluetoothSocket mmSocket;
private final InputStream mmInStream;
private final OutputStream mmOutStream;
-
+
public ConnectedThread(BluetoothSocket socket) {
mmSocket = socket;
InputStream tmpIn = null;
OutputStream tmpOut = null;
-
+
// Get the input and output streams, using temp objects because
// member streams are final
try {
tmpIn = socket.getInputStream();
tmpOut = socket.getOutputStream();
} catch (IOException e) { }
-
+
mmInStream = tmpIn;
mmOutStream = tmpOut;
}
-
+
public void run() {
byte[] buffer = new byte[1024]; // buffer store for the stream
int bytes; // bytes returned from read()
-
+
// Keep listening to the InputStream until an exception occurs
while (true) {
try {
@@ -850,14 +850,14 @@ private class ConnectedThread extends Thread {
}
}
}
-
+
/* Call this from the main activity to send data to the remote device */
public void write(byte[] bytes) {
try {
mmOutStream.write(bytes);
} catch (IOException e) { }
}
-
+
/* Call this from the main activity to shutdown the connection */
public void cancel() {
try {
@@ -865,44 +865,44 @@ private class ConnectedThread extends Thread {
} catch (IOException e) { }
}
}
-
-
+
+
The constructor acquires the necessary streams and once executed, the thread
will wait for data to come through the InputStream. When {@link
java.io.InputStream#read(byte[])} returns with
bytes from the stream, the data is sent to the main activity using a member
Handler from the parent class. Then it goes back and waits for more bytes from
-the stream.
-
+the stream.
+
Sending outgoing data is as simple as calling the thread's
write() method from the main activity and passing in the bytes to
be sent. This method then simply calls {@link
-java.io.OutputStream#write(byte[])} to send the data to the remote device.
-
+java.io.OutputStream#write(byte[])} to send the data to the remote device.
+
The thread's cancel() method is important so that the connection
can be
terminated at any time by closing the {@link android.bluetooth.BluetoothSocket}.
This should always be called when you're done using the Bluetooth
-connection.
Starting in Android 3.0, the Bluetooth API includes support for working with
Bluetooth profiles. A Bluetooth profile is a wireless interface
specification for Bluetooth-based communication between devices. An example
is the Hands-Free profile. For a mobile phone to connect to a wireless headset,
-both devices must support the Hands-Free profile.
+both devices must support the Hands-Free profile.
You can implement the interface {@link android.bluetooth.BluetoothProfile} to write
your own classes to support a particular Bluetooth profile. The Android
Bluetooth API provides implementations for the following Bluetooth
-profiles:
Health Device. Android 4.0 (API level 14) introduces
support for the Bluetooth Health Device Profile (HDP). This lets you create
@@ -928,50 +928,50 @@ specialization codes, refer to Bluetooth Assigned Numbers at www.bluetooth.org. Note that these values
are also referenced in the ISO/IEEE 11073-20601 [7] specification as
MDC_DEV_SPEC_PROFILE_* in the Nomenclature Codes Annex. For more discussion of
-HDP, see Health Device Profile.
Use {@link
android.bluetooth.BluetoothAdapter#getProfileProxy(android.content.Context,
android.bluetooth.BluetoothProfile.ServiceListener, int) getProfileProxy()} to
establish a connection to the profile proxy object associated with the profile.
In the example below, the profile proxy object is an instance of {@link
-android.bluetooth.BluetoothHeadset}.
+android.bluetooth.BluetoothHeadset}.
Set up a {@link android.bluetooth.BluetoothProfile.ServiceListener}. This
listener notifies {@link android.bluetooth.BluetoothProfile} IPC clients when
-they have been connected to or disconnected from the service.
+they have been connected to or disconnected from the service.
In {@link
android.bluetooth.BluetoothProfile.ServiceListener#onServiceConnected(int,
android.bluetooth.BluetoothProfile) onServiceConnected()}, get a handle
-to the profile proxy object.
+to the profile proxy object.
Once you have the profile proxy object, you can use it to monitor the
state of the connection and perform other operations that are relevant to that
-profile.
-
+profile.
+
For example, this code snippet shows how to connect to a {@link
android.bluetooth.BluetoothHeadset} proxy object so that you can control the
-Headset profile:
+Headset profile:
BluetoothHeadset mBluetoothHeadset;
-
+
// Get the default adapter
BluetoothAdapter mBluetoothAdapter = BluetoothAdapter.getDefaultAdapter();
-
+
// Establish connection to the proxy.
mBluetoothAdapter.getProfileProxy(context, mProfileListener, BluetoothProfile.HEADSET);
-
+
private BluetoothProfile.ServiceListener mProfileListener = new BluetoothProfile.ServiceListener() {
public void onServiceConnected(int profile, BluetoothProfile proxy) {
if (profile == BluetoothProfile.HEADSET) {
@@ -984,16 +984,16 @@ private BluetoothProfile.ServiceListener mProfileListener = new BluetoothProfile
}
}
};
-
+
// ... call functions on mBluetoothHeadset
-
+
// Close proxy connection after use.
mBluetoothAdapter.closeProfileProxy(mBluetoothHeadset);
-
+
-
Vendor-specific AT commands
+
Vendor-specific AT commands
Starting in Android 3.0, applications can register to receive system
broadcasts of pre-defined vendor-specific AT commands sent by headsets (such as
@@ -1060,7 +1060,7 @@ android.bluetooth.BluetoothProfile.ServiceListener#HEALTH} profile type to
establish a connection with the profile proxy object.
Create a {@link android.bluetooth.BluetoothHealthCallback} and register an
-application configuration
+application configuration
({@link android.bluetooth.BluetoothHealthAppConfiguration})
that acts as a health
sink.
diff --git a/docs/html/guide/topics/connectivity/nfc/index.jd b/docs/html/guide/topics/connectivity/nfc/index.jd
index f12facf75ecc2..bc4f075c71f75 100644
--- a/docs/html/guide/topics/connectivity/nfc/index.jd
+++ b/docs/html/guide/topics/connectivity/nfc/index.jd
@@ -17,12 +17,12 @@ page.title=Near Field Communication
Android-powered devices with NFC simultaneously support three main modes of operation:
-
Reader/writer mode, allowing the NFC device to read and/or write
+
Reader/writer mode, allowing the NFC device to read and/or write
passive NFC tags and stickers.
-
P2P mode, allowing the NFC device to exchange data with other NFC
+
P2P mode, allowing the NFC device to exchange data with other NFC
peers; this operation mode is used by Android Beam.
-
Card emulation mode, allowing the NFC device itself to act as an NFC
-card. The emulated NFC card can then be accessed by an external NFC reader,
+
Card emulation mode, allowing the NFC device itself to act as an NFC
+card. The emulated NFC card can then be accessed by an external NFC reader,
such as an NFC point-of-sale terminal.
Here are the requirements for developing a SIP application:
-
+
You must have a mobile device that is running Android 2.3 or higher.
-
+
SIP runs over a wireless data connection, so your device must have a data
connection (with a mobile data service or Wi-Fi). This means that you
can't test on AVD—you can only test on a physical device. For details, see
@@ -139,7 +139,7 @@ capable of supporting SIP, add the following to your application's
manifest:
-
<uses-sdk android:minSdkVersion="9" />. This
+
<uses-sdk android:minSdkVersion="9" />. This
indicates that your application requires Android 2.3 or higher. For more
information, see API
Levels and the documentation for the <uses-
feature> element.
-
+
If your application is designed to receive calls, you must also define a receiver ({@link android.content.BroadcastReceiver} subclass) in the application's manifest:
@@ -261,7 +261,7 @@ public void onRegistering(String localProfileUri) {
public void onRegistrationDone(String localProfileUri, long expiryTime) {
updateStatus("Ready");
}
-
+
public void onRegistrationFailed(String localProfileUri, int errorCode,
String errorMessage) {
updateStatus("Registration failed. Please check settings.");
@@ -291,8 +291,8 @@ example:
A {@link android.net.sip.SipProfile} that is making the call (the
"local profile"), and a valid SIP address to receive the call (the
-"peer profile").
-
+"peer profile").
+
A {@link android.net.sip.SipManager} object.
@@ -304,7 +304,7 @@ established:
SipAudioCall.Listener listener = new SipAudioCall.Listener() {
-
+
@Override
public void onCallEstablished(SipAudioCall call) {
call.startAudio();
@@ -312,7 +312,7 @@ SipAudioCall.Listener listener = new SipAudioCall.Listener() {
call.toggleMute();
...
}
-
+
@Override
public void onCallEnded(SipAudioCall call) {
// Do something.
@@ -326,12 +326,12 @@ make the call. The {@link android.net.sip.SipManager} method
A local SIP profile (the caller).
A peer SIP profile (the user being called).
-
+
A {@link android.net.sip.SipAudioCall.Listener} to listen to the call
events from {@link android.net.sip.SipAudioCall}. This can be null,
but as shown above, the listener is used to set things up once the call is
established.
-
+
The timeout value, in seconds.
For example:
@@ -349,15 +349,15 @@ your application:
<receiver>. In SipDemo, this is
<receiver android:name=".IncomingCallReceiver"
android:label="Call Receiver"/>.
-
+
Implement the receiver, which is a subclass of {@link
android.content.BroadcastReceiver}. In SipDemo, this is
IncomingCallReceiver.
-
+
Initialize the local profile ({@link android.net.sip.SipProfile}) with a
pending intent that fires your receiver when someone calls the local profile.
-
+
Set up an intent filter that filters by the action that represents an
incoming call. In SipDemo, this action is
android.SipDemo.INCOMING_CALL.
@@ -427,16 +427,16 @@ action string provided by the application. In SipDemo, this action string is
android.net.sip.SipProfile} object gets created with a pending intent based on
the action string android.SipDemo.INCOMING_CALL. The
PendingIntent object will perform a broadcast when the {@link
-android.net.sip.SipProfile} receives a call:
+android.net.sip.SipProfile} receives a call:
public SipManager mSipManager = null;
public SipProfile mSipProfile = null;
...
-Intent intent = new Intent();
-intent.setAction("android.SipDemo.INCOMING_CALL");
-PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, Intent.FILL_IN_DATA);
+Intent intent = new Intent();
+intent.setAction("android.SipDemo.INCOMING_CALL");
+PendingIntent pendingIntent = PendingIntent.getBroadcast(this, 0, intent, Intent.FILL_IN_DATA);
mSipManager.open(mSipProfile, pendingIntent, null);
The broadcast will be intercepted by the intent filter, which will then fire
@@ -485,8 +485,8 @@ href="{@docRoot}tools/device.html">Developing on a Device.
href="{@docRoot}tools/device.html">Developing on a Device.
If you are using Android Studio, you can view the application log output by
-opening the Event Log console (View > Tool Windows > Event Log).
-
Ensure your application is configured to launch Logcat automatically when it runs:
+opening the Event Log console (View > Tool Windows > Event Log).
+
Ensure your application is configured to launch Logcat automatically when it runs:
Select Run > Edit Configurations.
Select the Miscellaneous tab in the Run/Debug Configurations window.
diff --git a/docs/html/guide/topics/connectivity/usb/accessory.jd b/docs/html/guide/topics/connectivity/usb/accessory.jd
index a2177678fc56d..3942b3a951b96 100644
--- a/docs/html/guide/topics/connectivity/usb/accessory.jd
+++ b/docs/html/guide/topics/connectivity/usb/accessory.jd
@@ -169,7 +169,7 @@ UsbAccessory accessory = (UsbAccessory) intent.getParcelableExtra(UsbManager.EXT
include a <uses-feature> element that declares that your application uses
the android.hardware.usb.accessory feature.
-
If you are using the
+
If you are using the
add-on library,
add the <uses-library> element specifying
com.android.future.usb.accessory for the library.
@@ -347,7 +347,7 @@ UsbAccessory[] accessoryList = manager.getAcccessoryList();
private static final String ACTION_USB_PERMISSION =
"com.android.example.USB_PERMISSION";
private final BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {
-
+
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if (ACTION_USB_PERMISSION.equals(action)) {
@@ -444,7 +444,7 @@ private void openAccessory() {
BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {
public void onReceive(Context context, Intent intent) {
- String action = intent.getAction();
+ String action = intent.getAction();
if (UsbManager.ACTION_USB_ACCESSORY_DETACHED.equals(action)) {
UsbAccessory accessory = (UsbAccessory)intent.getParcelableExtra(UsbManager.EXTRA_ACCESSORY);
diff --git a/docs/html/guide/topics/connectivity/usb/host.jd b/docs/html/guide/topics/connectivity/usb/host.jd
index d2194e6d6f6dd..856027d09d7f6 100644
--- a/docs/html/guide/topics/connectivity/usb/host.jd
+++ b/docs/html/guide/topics/connectivity/usb/host.jd
@@ -263,7 +263,7 @@ UsbDevice device = (UsbDevice) intent.getParcelableExtra(UsbManager.EXTRA_DEVICE
obtain a device from the map.
@@ -317,7 +317,7 @@ private final BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {
if(device != null){
//call method to set up device communication
}
- }
+ }
else {
Log.d(TAG, "permission denied for device " + device);
}
@@ -396,7 +396,7 @@ private boolean forceClaim = true;
UsbInterface intf = device.getInterface(0);
UsbEndpoint endpoint = intf.getEndpoint(0);
-UsbDeviceConnection connection = mUsbManager.openDevice(device);
+UsbDeviceConnection connection = mUsbManager.openDevice(device);
connection.claimInterface(intf, forceClaim);
connection.bulkTransfer(endpoint, bytes, bytes.length, TIMEOUT); //do in another thread
@@ -422,7 +422,7 @@ connection.bulkTransfer(endpoint, bytes, bytes.length, TIMEOUT); //do in another
BroadcastReceiver mUsbReceiver = new BroadcastReceiver() {
public void onReceive(Context context, Intent intent) {
- String action = intent.getAction();
+ String action = intent.getAction();
if (UsbManager.ACTION_USB_DEVICE_DETACHED.equals(action)) {
UsbDevice device = (UsbDevice)intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);
diff --git a/docs/html/guide/topics/connectivity/wifip2p.jd b/docs/html/guide/topics/connectivity/wifip2p.jd
index d7e1269696cf9..b8eb40ea5014f 100644
--- a/docs/html/guide/topics/connectivity/wifip2p.jd
+++ b/docs/html/guide/topics/connectivity/wifip2p.jd
@@ -66,7 +66,7 @@ a photo sharing application.
methods. A {@link android.net.wifi.p2p.WifiP2pManager#WIFI_P2P_PEERS_CHANGED_ACTION} intent is
also broadcast if the {@link android.net.wifi.p2p.WifiP2pManager#discoverPeers discoverPeers()}
method discovers that the peers list has changed.
-
+
API Overview
The {@link android.net.wifi.p2p.WifiP2pManager} class provides methods to allow you to interact with
@@ -135,7 +135,7 @@ a photo sharing application.
are described in the following table:
Table 2. Wi-Fi P2P Listeners
-
+
Listener interface
@@ -395,7 +395,7 @@ protected void onPause() {
available peers that are in range. The call to this function is asynchronous and a success or
failure is communicated to your application with {@link
android.net.wifi.p2p.WifiP2pManager.ActionListener#onSuccess onSuccess()} and {@link
- android.net.wifi.p2p.WifiP2pManager.ActionListener#onFailure onFailure()} if you created a
+ android.net.wifi.p2p.WifiP2pManager.ActionListener#onFailure onFailure()} if you created a
{@link android.net.wifi.p2p.WifiP2pManager.ActionListener}. The
{@link android.net.wifi.p2p.WifiP2pManager.ActionListener#onSuccess onSuccess()} method only notifies you
that the discovery process succeeded and does not provide any information about the actual peers
diff --git a/docs/html/guide/topics/data/index.jd b/docs/html/guide/topics/data/index.jd
index 1e082b3fef95f..169fc223d5556 100644
--- a/docs/html/guide/topics/data/index.jd
+++ b/docs/html/guide/topics/data/index.jd
@@ -1,6 +1,6 @@
page.title=Data Storage
page.landing=true
-page.landing.intro=Store application data in databases, files, or preferences, in internal or removeable storage. You can also add a data backup service to let users store and recover application and system data.
+page.landing.intro=Store application data in databases, files, or preferences, in internal or removeable storage. You can also add a data backup service to let users store and recover application and system data.
page.landing.image=
@jd:body
@@ -10,14 +10,14 @@ page.landing.image=
\ No newline at end of file
diff --git a/docs/html/guide/topics/graphics/index.jd b/docs/html/guide/topics/graphics/index.jd
index 17f630994952f..a87e404503ed1 100644
--- a/docs/html/guide/topics/graphics/index.jd
+++ b/docs/html/guide/topics/graphics/index.jd
@@ -17,7 +17,7 @@ support hardware acceleration on tablets. With this new pipeline, all drawing op
by the UI toolkit are carried out using the GPU. You’ll be happy to hear that Android 4.0, Ice Cream
Sandwich, brings an improved version of the hardware-accelerated 2D rendering pipeline.
-
+
The Android framework provides two animation systems: property animation
and view animation. Both animation systems are viable options,
but the property animation system, in general, is the preferred method to use, because it
diff --git a/docs/html/guide/topics/graphics/prop-animation.jd b/docs/html/guide/topics/graphics/prop-animation.jd
index aed533de16ca1..693799c5ba1e6 100755
--- a/docs/html/guide/topics/graphics/prop-animation.jd
+++ b/docs/html/guide/topics/graphics/prop-animation.jd
@@ -165,9 +165,9 @@ page.tags=valueanimator,objectanimator,layouttransition,ViewPropertyAnimator
"{@docRoot}resources/samples/ApiDemos/src/com/example/android/apis/animation/index.html">API
Demos sample project provides many examples on how to use the property
animation system.
-
+
How Property Animation Differs from View Animation
-
+
The view animation system provides the capability to only animate {@link android.view.View}
objects, so if you wanted to animate non-{@link android.view.View} objects, you have to implement
your own code to do so. The view animation system is also constrained in the fact that it only
diff --git a/docs/html/guide/topics/location/strategies.jd b/docs/html/guide/topics/location/strategies.jd
index 32be463e687cb..2dfed2ce6e8e4 100755
--- a/docs/html/guide/topics/location/strategies.jd
+++ b/docs/html/guide/topics/location/strategies.jd
@@ -411,12 +411,12 @@ data to work.
Using Android Studio
Select Tools > Android > AVD Manager. In the Android Virtual
-Device Manager window, choose your AVD and launch it in the emulator by selecting the green
+Device Manager window, choose your AVD and launch it in the emulator by selecting the green
play arrow in the Actions column.
Then, select Tools > Android > Android Device Monitor.
-Select the Emulator Control tab in the Android Device Monitor window, and enter GPS coordinates
-under Location Controls as individual lat/long coordinates, with a GPX file for route playback,
+Select the Emulator Control tab in the Android Device Monitor window, and enter GPS coordinates
+under Location Controls as individual lat/long coordinates, with a GPX file for route playback,
or a KML file for multiple place marks.
@@ -25,16 +25,16 @@ specifications within a filter.
{@code android:name}
The name of the action. Some standard actions are defined in the
-{@link android.content.Intent#ACTION_CHOOSER Intent} class as
+{@link android.content.Intent#ACTION_CHOOSER Intent} class as
ACTION_string constants. To assign one of these actions to
-this attribute, prepend "{@code android.intent.action.}" to the
+this attribute, prepend "{@code android.intent.action.}" to the
string that follows {@code ACTION_}.
For example, for {@code ACTION_MAIN}, use "{@code android.intent.action.MAIN}"
and for {@code ACTION_WEB_SEARCH}, use "{@code android.intent.action.WEB_SEARCH}".
For actions you define, it's best to use the package name as a prefix to
-ensure uniqueness. For example, a {@code TRANSMOGRIFY} action might be specified
+ensure uniqueness. For example, a {@code TRANSMOGRIFY} action might be specified
as follows:
diff --git a/docs/html/guide/topics/manifest/activity-alias-element.jd b/docs/html/guide/topics/manifest/activity-alias-element.jd
index 1427b55219bdc..adb9937899fd2 100644
--- a/docs/html/guide/topics/manifest/activity-alias-element.jd
+++ b/docs/html/guide/topics/manifest/activity-alias-element.jd
@@ -29,62 +29,62 @@ alias and it must be declared before the alias in the manifest.
The alias presents the target activity as a independent entity.
-It can have its own set of intent filters, and they, rather than the
-intent filters on the target activity itself, determine which intents
+It can have its own set of intent filters, and they, rather than the
+intent filters on the target activity itself, determine which intents
can activate the target through the alias and how the system
-treats the alias. For example, the intent filters on the alias may
-specify the "{@link android.content.Intent#ACTION_MAIN
-android.intent.action.MAIN}"
-and "{@link android.content.Intent#CATEGORY_LAUNCHER
-android.intent.category.LAUNCHER}" flags, causing it to be
-represented in the application launcher, even though none of the
+treats the alias. For example, the intent filters on the alias may
+specify the "{@link android.content.Intent#ACTION_MAIN
+android.intent.action.MAIN}"
+and "{@link android.content.Intent#CATEGORY_LAUNCHER
+android.intent.category.LAUNCHER}" flags, causing it to be
+represented in the application launcher, even though none of the
filters on the target activity itself set these flags.
With the exception of {@code targetActivity}, {@code }
-attributes are a subset of <activity> attributes.
+attributes are a subset of <activity> attributes.
For attributes in the subset, none of the values set for the target carry over
-to the alias. However, for attributes not in the subset, the values set for
+to the alias. However, for attributes not in the subset, the values set for
the target activity also apply to the alias.
attributes:
{@code android:enabled}
-
Whether or not the target activity can be instantiated by the system through
-this alias — "{@code true}" if it can be, and "{@code false}" if not.
+
Whether or not the target activity can be instantiated by the system through
+this alias — "{@code true}" if it can be, and "{@code false}" if not.
The default value is "{@code true}".
-The <application> element has its own
-enabled attribute that applies to all
-application components, including activity aliases. The
+The <application> element has its own
+enabled attribute that applies to all
+application components, including activity aliases. The
<application> and {@code }
-attributes must both be "{@code true}" for the system to be able to instantiate
-the target activity through the alias. If either is "{@code false}", the alias
+attributes must both be "{@code true}" for the system to be able to instantiate
+the target activity through the alias. If either is "{@code false}", the alias
does not work.
{@code android:exported}
-
Whether or not components of other applications can launch the target activity
-through this alias — "{@code true}" if they can, and "{@code false}" if not.
-If "{@code false}", the target activity can be launched through the alias only by
-components of the same application as the alias or applications with the same user ID.
+
Whether or not components of other applications can launch the target activity
+through this alias — "{@code true}" if they can, and "{@code false}" if not.
+If "{@code false}", the target activity can be launched through the alias only by
+components of the same application as the alias or applications with the same user ID.
-The default value depends on whether the alias contains intent filters. The
+The default value depends on whether the alias contains intent filters. The
absence of any filters means that the activity can be invoked through the alias
-only by specifying the exact name of the alias. This implies that the alias
-is intended only for application-internal use (since others would not know its name)
+only by specifying the exact name of the alias. This implies that the alias
+is intended only for application-internal use (since others would not know its name)
— so the default value is "{@code false}".
-On the other hand, the presence of at least one filter implies that the alias
+On the other hand, the presence of at least one filter implies that the alias
is intended for external use — so the default value is "{@code true}".
{@code android:icon}
-
An icon for the target activity when presented to users through the alias.
-See the <activity> element's
+
An icon for the target activity when presented to users through the alias.
+See the <activity> element's
icon attribute for more information.
A unique name for the alias. The name should resemble a fully
-qualified class name. But, unlike the name of the target activity,
-the alias name is arbitrary; it does not refer to an actual class.
+qualified class name. But, unlike the name of the target activity,
+the alias name is arbitrary; it does not refer to an actual class.
{@code android:permission}
-
The name of a permission that clients must have to launch the target activity
-or get it to do something via the alias. If a caller of
+
The name of a permission that clients must have to launch the target activity
+or get it to do something via the alias. If a caller of
{@link android.content.Context#startActivity startActivity()} or
{@link android.app.Activity#startActivityForResult startActivityForResult()}
has not been granted the specified permission, the target activity will not be
-activated.
+activated.
This attribute supplants any permission set for the target activity itself. If
it is not set, a permission is not needed to activate the target through the alias.
-For more information on permissions, see the
-Permissions
+For more information on permissions, see the
+Permissions
section in the introduction.
{@code android:targetActivity}
The name of the activity that can be activated through the alias.
-This name must match the {@code name} attribute of an
+This name must match the {@code name} attribute of an
<activity> element that precedes
the alias in the manifest.
Adds a category name to an intent filter. See
-Intents and
+Intents and
Intent Filters for details on intent filters and the role of category
specifications within a filter.
attributes:
{@code android:name}
-
The name of the category. Standard categories are defined in the
+
The name of the category. Standard categories are defined in the
{@link android.content.Intent} class as CATEGORY_name
-constants. The name assigned here can be derived from those constants
-by prefixing "{@code android.intent.category.}" to the
+constants. The name assigned here can be derived from those constants
+by prefixing "{@code android.intent.category.}" to the
name that follows {@code CATEGORY_}. For example,
-the string value for {@code CATEGORY_LAUNCHER} is
+the string value for {@code CATEGORY_LAUNCHER} is
"{@code android.intent.category.LAUNCHER}".
Note: In order to receive implicit intents, you must include the
@@ -39,7 +39,7 @@ your activity.
Custom categories should use the package name as a prefix, to ensure
that they are unique.
Specifies which data subsets of the parent content provider permission
-can be granted for. Data subsets are indicated by the path part of a
+can be granted for. Data subsets are indicated by the path part of a
{@code content:} URI. (The authority part of the URI identifies the
-content provider.)
-Granting permission is a way of enabling clients of the provider that don't
-normally have permission to access its data to overcome that restriction on
+content provider.)
+Granting permission is a way of enabling clients of the provider that don't
+normally have permission to access its data to overcome that restriction on
a one-time basis.
-
-If a content provider's grantUriPermissions
-attribute is "{@code true}", permission can be granted for any the data under
-the provider's purview. However, if that attribute is "{@code false}", permission
-can be granted only to data subsets that are specified by this element.
+
+If a content provider's grantUriPermissions
+attribute is "{@code true}", permission can be granted for any the data under
+the provider's purview. However, if that attribute is "{@code false}", permission
+can be granted only to data subsets that are specified by this element.
A provider can contain any number of {@code } elements.
Each one can specify only one path (only one of the three possible attributes).
-For information on how permission is granted, see the
+For information on how permission is granted, see the
<intent-filter> element's
grantUriPermissions attribute.
@@ -41,34 +41,34 @@ For information on how permission is granted, see the
A path identifying the data subset or subsets that permission can be
-granted for. The {@code path} attribute specifies a complete path;
-permission can be granted only to the particular data subset identified
-by that path.
-The {@code pathPrefix} attribute specifies the initial part of a path;
-permission can be granted to all data subsets with paths that share that
-initial part.
-The {@code pathPattern} attribute specifies a complete path, but one
+
A path identifying the data subset or subsets that permission can be
+granted for. The {@code path} attribute specifies a complete path;
+permission can be granted only to the particular data subset identified
+by that path.
+The {@code pathPrefix} attribute specifies the initial part of a path;
+permission can be granted to all data subsets with paths that share that
+initial part.
+The {@code pathPattern} attribute specifies a complete path, but one
that can contain the following wildcards:
An asterisk ('{@code *}') matches a sequence of 0 to many occurrences of
the immediately preceding character.
-
A period followed by an asterisk ("{@code .*}") matches any sequence of
+
A period followed by an asterisk ("{@code .*}") matches any sequence of
0 to many characters.
-Because '{@code \}' is used as an escape character when the string is read
-from XML (before it is parsed as a pattern), you will need to double-escape:
-For example, a literal '{@code *}' would be written as "{@code \\*}" and a
-literal '{@code \}' would be written as "{@code \\\\}". This is basically
+Because '{@code \}' is used as an escape character when the string is read
+from XML (before it is parsed as a pattern), you will need to double-escape:
+For example, a literal '{@code *}' would be written as "{@code \\*}" and a
+literal '{@code \}' would be written as "{@code \\\\}". This is basically
the same as what you would need to write if constructing the string in Java code.
-For more information on these types of patterns, see the descriptions of
+For more information on these types of patterns, see the descriptions of
{@link android.os.PatternMatcher#PATTERN_LITERAL},
{@link android.os.PatternMatcher#PATTERN_PREFIX}, and
{@link android.os.PatternMatcher#PATTERN_SIMPLE_GLOB} in the
@@ -81,10 +81,10 @@ For more information on these types of patterns, see the descriptions of
diff --git a/docs/html/guide/topics/manifest/instrumentation-element.jd b/docs/html/guide/topics/manifest/instrumentation-element.jd
index 74be559db1374..a476be3b72f1a 100644
--- a/docs/html/guide/topics/manifest/instrumentation-element.jd
+++ b/docs/html/guide/topics/manifest/instrumentation-element.jd
@@ -23,15 +23,15 @@ object is instantiated before any of the application's components.
attributes:
{@code android:functionalTest}
-
Whether or not the Instrumentation class should run as a functional test
+
Whether or not the Instrumentation class should run as a functional test
— "{@code true}" if it should, and "{@code false}" if not. The
default value is "{@code false}".
{@code android:handleProfiling}
-
Whether or not the Instrumentation object will turn profiling on and
-off — "{@code true}" if it determines when profiling starts and
-stops, and "{@code false}" if profiling continues the entire time it is
-running. A value of "{@code true}" enables the object to target profiling
+
Whether or not the Instrumentation object will turn profiling on and
+off — "{@code true}" if it determines when profiling starts and
+stops, and "{@code false}" if profiling continues the entire time it is
+running. A value of "{@code true}" enables the object to target profiling
at a specific set of operations. The default value is "{@code false}".
{@code android:icon}
@@ -43,11 +43,11 @@ be set as a reference to a drawable resource.
be set as a raw string or a reference to a string resource.
{@code android:name}
-
The name of the {@link android.app.Instrumentation} subclass.
-This should be a fully qualified class name (such as,
-"{@code com.example.project.StringInstrumentation}"). However, as a shorthand,
-if the first character of the name is a period, it is appended to the package
-name specified in the <manifest> element.
+
The name of the {@link android.app.Instrumentation} subclass.
+This should be a fully qualified class name (such as,
+"{@code com.example.project.StringInstrumentation}"). However, as a shorthand,
+if the first character of the name is a period, it is appended to the package
+name specified in the <manifest> element.
There is no default. The name must be specified.
diff --git a/docs/html/guide/topics/manifest/intent-filter-element.jd b/docs/html/guide/topics/manifest/intent-filter-element.jd
index 14b4e03b64a8f..13956c9ad430d 100644
--- a/docs/html/guide/topics/manifest/intent-filter-element.jd
+++ b/docs/html/guide/topics/manifest/intent-filter-element.jd
@@ -27,23 +27,23 @@ parent.link=manifest-intro.html
description:
Specifies the types of intents that an activity, service, or broadcast
receiver can respond to. An intent filter declares the capabilities of its
-parent component — what an activity or service can do and what types
-of broadcasts a receiver can handle. It opens the component to receiving
-intents of the advertised type, while filtering out those that are not
+parent component — what an activity or service can do and what types
+of broadcasts a receiver can handle. It opens the component to receiving
+intents of the advertised type, while filtering out those that are not
meaningful for the component.
-Most of the contents of the filter are described by its
-<action>,
+Most of the contents of the filter are described by its
+<action>,
<category>, and
<data> subelements.
An icon that represents the parent activity, service, or broadcast
-receiver when that component is presented to the user as having the
+receiver when that component is presented to the user as having the
capability described by the filter.
-This attribute must be set as a reference to a drawable resource
-containing the image definition. The default value is the icon set
-by the parent component's {@code icon} attribute. If the parent
+This attribute must be set as a reference to a drawable resource
+containing the image definition. The default value is the icon set
+by the parent component's {@code icon} attribute. If the parent
does not specify an icon, the default is the icon set by the
<application> element.
-For more on intent filter icons, see
+For more on intent filter icons, see
Icons and Labels
in the introduction.
@@ -75,44 +75,44 @@ to the user as having the capability described by the filter.
The label should be set as a reference to a string resource, so that
-it can be localized like other strings in the user interface.
-However, as a convenience while you're developing the application,
+it can be localized like other strings in the user interface.
+However, as a convenience while you're developing the application,
it can also be set as a raw string.
-The default value is the label set by the parent component. If the
+The default value is the label set by the parent component. If the
parent does not specify a label, the default is the label set by the
-<application> element's
+<application> element's
label attribute.
-For more on intent filter labels, see
+For more on intent filter labels, see
Icons and Labels
in the introduction.
{@code android:priority}
The priority that should be given to the parent component with regard
-to handling intents of the type described by the filter. This attribute has
+to handling intents of the type described by the filter. This attribute has
meaning for both activities and broadcast receivers:
-
It provides information about how able an activity is to respond to
+
It provides information about how able an activity is to respond to
an intent that matches the filter, relative to other activities that could
-also respond to the intent. When an intent could be handled by multiple
+also respond to the intent. When an intent could be handled by multiple
activities with different priorities, Android will consider only those with
higher priority values as potential targets for the intent.
It controls the order in which broadcast receivers are executed to
-receive broadcast messages. Those with higher priority
-values are called before those with lower values. (The order applies only
+receive broadcast messages. Those with higher priority
+values are called before those with lower values. (The order applies only
to synchronous messages; it's ignored for asynchronous messages.)
-Use this attribute only if you really need to impose a specific order in
+Use this attribute only if you really need to impose a specific order in
which the broadcasts are received, or want to force Android to prefer
one activity over others.
A name-value pair for an item of additional, arbitrary data that can
-be supplied to the parent component. A component element can contain any
+be supplied to the parent component. A component element can contain any
number of {@code } subelements. The values from all of
-them are collected in a single {@link android.os.Bundle} object and made
-available to the component as the
-{@link android.content.pm.PackageItemInfo#metaData
+them are collected in a single {@link android.os.Bundle} object and made
+available to the component as the
+{@link android.content.pm.PackageItemInfo#metaData
PackageItemInfo.metaData} field.
-Ordinary values are specified through the value
-attribute. However, to assign a resource ID as the value, use the
-resource attribute instead. For example,
-the following code assigns whatever value is stored in the {@code @string/kangaroo}
+Ordinary values are specified through the value
+attribute. However, to assign a resource ID as the value, use the
+resource attribute instead. For example,
+the following code assigns whatever value is stored in the {@code @string/kangaroo}
resource to the "{@code zoo}" name:
@@ -44,22 +44,22 @@ the numeric ID of the resource, not the value stored in the resource:
-It is highly recommended that you avoid supplying related data as
+It is highly recommended that you avoid supplying related data as
multiple separate {@code } entries. Instead, if you
-have complex data to associate with a component, store it as a resource and
+have complex data to associate with a component, store it as a resource and
use the {@code resource} attribute to inform the component of its ID.
attributes:
{@code android:name}
-
A unique name for the item. To ensure that the name is unique, use a
-Java-style naming convention — for example,
+
A unique name for the item. To ensure that the name is unique, use a
+Java-style naming convention — for example,
"{@code com.example.project.activity.fred}".
{@code android:resource}
-
A reference to a resource. The ID of the resource is the value assigned
-to the item. The ID can be retrieved from the meta-data Bundle by the
+
A reference to a resource. The ID of the resource is the value assigned
+to the item. The ID can be retrieved from the meta-data Bundle by the
{@link android.os.Bundle#getInt Bundle.getInt()} method.
{@code android:value}
@@ -70,7 +70,7 @@ to the item. The ID can be retrieved from the meta-data Bundle by the
Type
Bundle method
-
String value, using double backslashes ({@code \\}) to escape characters
+
String value, using double backslashes ({@code \\}) to escape characters
— such as "{@code \\n}" and "{@code \\uxxxxx}" for a Unicode character.
Color value, in the form "{@code #rgb}", "{@code #argb}",
+
Color value, in the form "{@code #rgb}", "{@code #argb}",
"{@code #rrggbb}", or "{@code #aarrggbb}"
{@link android.os.Bundle#getInt(String) getInt()}
diff --git a/docs/html/guide/topics/manifest/path-permission-element.jd b/docs/html/guide/topics/manifest/path-permission-element.jd
index cdaf82b00f292..4774707331514 100644
--- a/docs/html/guide/topics/manifest/path-permission-element.jd
+++ b/docs/html/guide/topics/manifest/path-permission-element.jd
@@ -33,9 +33,9 @@ specified multiple times to supply multiple paths.
{@code android:path}
-
A complete URI path for a subset of content provider data.
-Permission can be granted only to the particular data identified by this path.
-When used to provide search suggestion content, it must be appended
+
A complete URI path for a subset of content provider data.
+Permission can be granted only to the particular data identified by this path.
+When used to provide search suggestion content, it must be appended
with "/search_suggest_query".
@@ -47,24 +47,24 @@ Permission can be granted to all data subsets with paths that share this initial
{@code android:pathPattern}
A complete URI path for a subset of content provider data,
but one that can use the following wildcards:
-
-
+
+
An asterisk ('*'). This matches a sequence of 0 to many occurrences of
-the immediately preceding character.
-
-
A period followed by an asterisk (".*"). This matches any sequence of
-0 or more characters.
-
-
-
-Because '\' is used as an escape character when the string is read
+the immediately preceding character.
+
+
A period followed by an asterisk (".*"). This matches any sequence of
+0 or more characters.
+
+
+
+Because '\' is used as an escape character when the string is read
from XML (before it is parsed as a pattern), you will need to double-escape.
-For example, a literal '*' would be written as "\\*" and a
-literal '\' would be written as "\\". This is basically
+For example, a literal '*' would be written as "\\*" and a
+literal '\' would be written as "\\". This is basically
the same as what you would need to write if constructing the string in Java code.
-
-
-For more information on these types of patterns, see the descriptions of
+
+
+For more information on these types of patterns, see the descriptions of
PATTERN_LITERAL,
PATTERN_PREFIX, and
PATTERN_SIMPLE_GLOB in the
@@ -74,20 +74,20 @@ For more information on these types of patterns, see the descriptions of
{@code android:permission}
The name of a permission that clients must have in order to read or write the
-content provider's data. This attribute is a convenient way of setting a
-single permission for both reading and writing. However, the
-readPermission and
+content provider's data. This attribute is a convenient way of setting a
+single permission for both reading and writing. However, the
+readPermission and
writePermission attributes take precedence
over this one.
-
+
{@code android:readPermission}
A permission that clients must have in order to query the content provider.
-
+
{@code android:writePermission}
A permission that clients must have in order to make changes to the data controlled by the content provider.
-
+
diff --git a/docs/html/guide/topics/manifest/permission-group-element.jd b/docs/html/guide/topics/manifest/permission-group-element.jd
index 3221d4b68c364..85452b534fcfc 100644
--- a/docs/html/guide/topics/manifest/permission-group-element.jd
+++ b/docs/html/guide/topics/manifest/permission-group-element.jd
@@ -20,17 +20,17 @@ permission join the group through the {@code permissionGroup} attribute of the
presented together in the user interface.
-Note that this element does not declare a permission itself, only a category in
-which permissions can be placed. See the
-<permission> element for element for information
+Note that this element does not declare a permission itself, only a category in
+which permissions can be placed. See the
+<permission> element for element for information
on declaring permissions and assigning them to groups.
attributes:
{@code android:description}
-
User-readable text that describes the group. The text should be
-longer and more explanatory than the label. This attribute must be
+
User-readable text that describes the group. The text should be
+longer and more explanatory than the label. This attribute must be
set as a reference to a string resource. Unlike the {@code label}
attribute, it cannot be a raw string.
@@ -39,10 +39,10 @@ attribute, it cannot be a raw string.
as a reference to a drawable resource containing the image definition.
{@code android:label}
-
A user-readable name for the group. As a convenience, the label can
-be directly set as a raw string while you're developing the application.
-However, when the application is ready to be published, it should be set
-as a reference to a string resource, so that it can be localized like other
+
A user-readable name for the group. As a convenience, the label can
+be directly set as a raw string while you're developing the application.
+However, when the application is ready to be published, it should be set
+as a reference to a string resource, so that it can be localized like other
strings in the user interface.
Declares the base name for a tree of permissions. The application takes
-ownership of all names within the tree. It can dynamically add new permissions
+ownership of all names within the tree. It can dynamically add new permissions
to the tree by calling {@link android.content.pm.PackageManager#addPermission PackageManager.addPermission()}. Names within the tree are separated by
periods ('{@code .}'). For example, if the base name is
{@code com.example.project.taxes}, permissions like the following might be
@@ -25,30 +25,30 @@ added:
{@code com.example.project.taxes.deductions.EXAGGERATE}
-Note that this element does not declare a permission itself, only a
-namespace in which further permissions can be placed. See the
-<permission>
+Note that this element does not declare a permission itself, only a
+namespace in which further permissions can be placed. See the
+<permission>
element for information on declaring permissions.
attributes:
{@code android:icon}
-
An icon representing all the permissions in the tree. This attribute
-must be set as a reference to a drawable resource containing the image
+
An icon representing all the permissions in the tree. This attribute
+must be set as a reference to a drawable resource containing the image
definition.
{@code android:label}
-
A user-readable name for the group. As a convenience, the label can
-be directly set as a raw string for quick and dirty programming. However,
-when the application is ready to be published, it should be set as a
-reference to a string resource, so that it can be localized like other
+
A user-readable name for the group. As a convenience, the label can
+be directly set as a raw string for quick and dirty programming. However,
+when the application is ready to be published, it should be set as a
+reference to a string resource, so that it can be localized like other
strings in the user interface.
{@code android:name}
-
The name that's at the base of the permission tree. It serves as
-a prefix to all permission names in the tree. Java-style scoping should
-be used to ensure that the name is unique. The name must have more than
-two period-separated segments in its path — for example,
+
The name that's at the base of the permission tree. It serves as
+a prefix to all permission names in the tree. Java-style scoping should
+be used to ensure that the name is unique. The name must have more than
+two period-separated segments in its path — for example,
{@code com.example.base} is OK, but {@code com.example} is not.
- Declares a content provider component. A content provider is a subclass of
- {@link android.content.ContentProvider} that supplies structured access to data managed by the
- application. All content providers in your application must be defined in a
+ Declares a content provider component. A content provider is a subclass of
+ {@link android.content.ContentProvider} that supplies structured access to data managed by the
+ application. All content providers in your application must be defined in a
{@code } element in the manifest file; otherwise, the system is unaware of them
and doesn't run them.
You only declare content providers that are part of your application. Content providers in
other applications that you use in your application should not be declared.
-
+
The Android system stores references to content providers according to an authority
- string, part of the provider's content URI. For example, suppose you want to
+ string, part of the provider's content URI. For example, suppose you want to
access a content provider that stores information about health care professionals. To do
- this, you call the method
+ this, you call the method
{@link android.content.ContentResolver#query ContentResolver.query()}, which among other
arguments takes a URI that identifies the provider:
-
The content:scheme identifies the URI as a content URI pointing to
- an Android content provider. The authority
+ an Android content provider. The authority
com.example.project.healthcareprovider identifies the provider itself; the
- Android system looks up the authority in its list of known providers and their authorities.
- The substring nurses/rn is a path, which the content provider can use
+ Android system looks up the authority in its list of known providers and their authorities.
+ The substring nurses/rn is a path, which the content provider can use
to identify subsets of the provider data.
- Notice that when you define your provider in the <provider> element, you
+ Notice that when you define your provider in the <provider> element, you
don't include the scheme or the path in the android:name argument, only the
- authority.
+ authority.
- For information on using and developing content providers, see the API Guide,
+ For information on using and developing content providers, see the API Guide,
Content Providers.
A list of one or more URI authorities that identify data offered by the content provider.
- Multiple authorities are listed by separating their names with a semicolon.
- To avoid conflicts, authority names should use a Java-style naming convention
+ Multiple authorities are listed by separating their names with a semicolon.
+ To avoid conflicts, authority names should use a Java-style naming convention
(such as {@code com.example.provider.cartoonprovider}). Typically, it's the name
of the {@link android.content.ContentProvider} subclass that implements the provider
Whether or not the content provider can be instantiated by the system —
- "{@code true}" if it can be, and "{@code false}" if not. The default value
+
Whether or not the content provider can be instantiated by the system —
+ "{@code true}" if it can be, and "{@code false}" if not. The default value
is "{@code true}".
-The <application> element has its own
-enabled attribute that applies to all
-application components, including content providers. The
+The <application> element has its own
+enabled attribute that applies to all
+application components, including content providers. The
<application> and {@code }
attributes must both be "{@code true}" (as they both
-are by default) for the content provider to be enabled. If either is
+are by default) for the content provider to be enabled. If either is
"{@code false}", the provider is disabled; it cannot be instantiated.
{@code android:exported}
Whether the content provider is available for other applications to use:
-
+
true: The provider is available to other applications. Any application can
use the provider's content URI to access it, subject to the permissions specified for
the provider.
- false: The provider is not available to other applications. Set
+ false: The provider is not available to other applications. Set
android:exported="false" to limit access to the provider to your
applications. Only applications that have the same user ID (UID) as the provider will
have access to it.
- The default value is "true" for applications that set either
+ The default value is "true" for applications that set either
android:minSdkVersion
- or
-android:targetSdkVersion to
+ or
+android:targetSdkVersion to
"16" or lower. For applications that
- set either of these attributes to "17" or higher, the default is
+ set either of these attributes to "17" or higher, the default is
"false".
You can set android:exported="false" and still limit access to your
- provider by setting permissions with the
+ provider by setting permissions with the
permission
attribute.
-
+
{@code android:grantUriPermissions}
-
Whether or not those who ordinarily would not have permission to
+
Whether or not those who ordinarily would not have permission to
access the content provider's data can be granted permission to do so,
temporarily overcoming the restriction imposed by the
readPermission,
-writePermission, and
-permission attributes
-—
-"{@code true}" if permission can be granted, and "{@code false}" if not.
-If "{@code true}", permission can be granted to any of the content
-provider's data. If "{@code false}", permission can be granted only
-to the data subsets listed in
-<grant-uri-permission> subelements,
+writePermission, and
+permission attributes
+—
+"{@code true}" if permission can be granted, and "{@code false}" if not.
+If "{@code true}", permission can be granted to any of the content
+provider's data. If "{@code false}", permission can be granted only
+to the data subsets listed in
+<grant-uri-permission> subelements,
if any. The default value is "{@code false}".
-Granting permission is a way of giving an application component one-time
-access to data protected by a permission. For example, when an e-mail
-message contains an attachment, the mail application may call upon the
-appropriate viewer to open it, even though the viewer doesn't have general
-permission to look at all the content provider's data.
+Granting permission is a way of giving an application component one-time
+access to data protected by a permission. For example, when an e-mail
+message contains an attachment, the mail application may call upon the
+appropriate viewer to open it, even though the viewer doesn't have general
+permission to look at all the content provider's data.
-
-In such cases, permission is granted by
-{@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}
-and {@link android.content.Intent#FLAG_GRANT_WRITE_URI_PERMISSION}
-flags in the Intent object that activates the component. For example, the
-mail application might put {@code FLAG_GRANT_READ_URI_PERMISSION} in the
-Intent passed to {@code Context.startActivity()}. The permission is specific
-to the URI in the Intent.
+
+In such cases, permission is granted by
+{@link android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION}
+and {@link android.content.Intent#FLAG_GRANT_WRITE_URI_PERMISSION}
+flags in the Intent object that activates the component. For example, the
+mail application might put {@code FLAG_GRANT_READ_URI_PERMISSION} in the
+Intent passed to {@code Context.startActivity()}. The permission is specific
+to the URI in the Intent.
If you enable this feature, either by setting this attribute to "{@code true}"
-or by defining <grant-uri-permission>
-subelements, you must call
-{@link android.content.Context#revokeUriPermission
-Context.revokeUriPermission()} when a covered URI is deleted from
+or by defining <grant-uri-permission>
+subelements, you must call
+{@link android.content.Context#revokeUriPermission
+Context.revokeUriPermission()} when a covered URI is deleted from
the provider.
@@ -187,52 +187,52 @@ element.
{@code android:icon}
-
An icon representing the content provider.
-This attribute must be set as a reference to a drawable resource containing
-the image definition. If it is not set, the icon specified for the application
-as a whole is used instead (see the <application>
+
An icon representing the content provider.
+This attribute must be set as a reference to a drawable resource containing
+the image definition. If it is not set, the icon specified for the application
+as a whole is used instead (see the <application>
element's icon attribute).
{@code android:initOrder}
-
The order in which the content provider should be instantiated,
-relative to other content providers hosted by the same process.
-When there are dependencies among content providers, setting this
-attribute for each of them ensures that they are created in the order
-required by those dependencies. The value is a simple integer,
+
The order in which the content provider should be instantiated,
+relative to other content providers hosted by the same process.
+When there are dependencies among content providers, setting this
+attribute for each of them ensures that they are created in the order
+required by those dependencies. The value is a simple integer,
with higher numbers being initialized first.
{@code android:label}
-
A user-readable label for the content provided.
-If this attribute is not set, the label set for the application as a whole is
-used instead (see the <application> element's
+
A user-readable label for the content provided.
+If this attribute is not set, the label set for the application as a whole is
+used instead (see the <application> element's
label attribute).
The label should be set as a reference to a string resource, so that
-it can be localized like other strings in the user interface.
-However, as a convenience while you're developing the application,
+it can be localized like other strings in the user interface.
+However, as a convenience while you're developing the application,
it can also be set as a raw string.
{@code android:multiprocess}
-
Whether or not an instance of the content provider can be created in
+
Whether or not an instance of the content provider can be created in
every client process — "{@code true}" if instances can run in multiple
processes, and "{@code false}" if not. The default value is "{@code false}".
-Normally, a content provider is instantiated in the process of the
-application that defined it. However, if this flag is set to "{@code true}",
-the system can create an instance in every process where there's a client
-that wants to interact with it, thus avoiding the overhead of interprocess
+Normally, a content provider is instantiated in the process of the
+application that defined it. However, if this flag is set to "{@code true}",
+the system can create an instance in every process where there's a client
+that wants to interact with it, thus avoiding the overhead of interprocess
communication.
{@code android:name}
-
The name of the class that implements the content provider, a subclass of
-{@link android.content.ContentProvider}. This should be a fully qualified
-class name (such as, "{@code com.example.project.TransportationProvider}").
-However, as a shorthand, if the first character of the name is a period,
-it is appended to the package name specified in the
+
The name of the class that implements the content provider, a subclass of
+{@link android.content.ContentProvider}. This should be a fully qualified
+class name (such as, "{@code com.example.project.TransportationProvider}").
+However, as a shorthand, if the first character of the name is a period,
+it is appended to the package name specified in the
<manifest> element.
@@ -242,58 +242,58 @@ There is no default. The name must be specified.
{@code android:permission}
The name of a permission that clients must have to read or write the
-content provider's data. This attribute is a convenient way of setting a
-single permission for both reading and writing. However, the
-readPermission and
+content provider's data. This attribute is a convenient way of setting a
+single permission for both reading and writing. However, the
+readPermission and
writePermission attributes take precedence
-over this one. If the readPermission
+over this one. If the readPermission
attribute is also set, it controls access for querying the content provider.
And if the writePermission attribute is set,
it controls access for modifying the provider's data.
-For more information on permissions, see the
-Permissions
-section in the introduction and a separate document,
+For more information on permissions, see the
+Permissions
+section in the introduction and a separate document,
Security and
Permissions.
{@code android:process}
-
The name of the process in which the content provider should run. Normally,
-all components of an application run in the default process created for the
-application. It has the same name as the application package. The
-<application> element's
-process
-attribute can set a different
+
The name of the process in which the content provider should run. Normally,
+all components of an application run in the default process created for the
+application. It has the same name as the application package. The
+<application> element's
+process
+attribute can set a different
default for all components. But each component can override the default
-with its own {@code process} attribute, allowing you to spread your
+with its own {@code process} attribute, allowing you to spread your
application across multiple processes.
-If the name assigned to this attribute begins with a colon (':'), a new
-process, private to the application, is created when it's needed and
+If the name assigned to this attribute begins with a colon (':'), a new
+process, private to the application, is created when it's needed and
the activity runs in that process.
-If the process name begins with a lowercase character, the activity will run
+If the process name begins with a lowercase character, the activity will run
in a global process of that name, provided that it has permission to do so.
-This allows components in different applications to share a process, reducing
+This allows components in different applications to share a process, reducing
resource usage.
{@code android:readPermission}
-
A permission that clients must have to query the content provider.
-See also the permission and
+
A permission that clients must have to query the content provider.
+See also the permission and
writePermission attributes.
{@code android:syncable}
-
Whether or not the data under the content provider's control
-is to be synchronized with data on a server — "{@code true}"
+
Whether or not the data under the content provider's control
+is to be synchronized with data on a server — "{@code true}"
if it is to be synchronized, and "{@code false}" if not.
{@code android:writePermission}
-
A permission that clients must have to make changes to the data
-controlled by the content provider.
-See also the permission and
+
A permission that clients must have to make changes to the data
+controlled by the content provider.
+See also the permission and
readPermission attributes.
Declares a broadcast receiver (a {@link android.content.BroadcastReceiver}
-subclass) as one of the application's components. Broadcast receivers enable
-applications to receive intents that are broadcast by the system or by other
+subclass) as one of the application's components. Broadcast receivers enable
+applications to receive intents that are broadcast by the system or by other
applications, even when other components of the application are not running.
There are two ways to make a broadcast receiver known to the system: One is
declare it in the manifest file with this element. The other is to create
-the receiver dynamically in code and register it with the {@link
+the receiver dynamically in code and register it with the {@link
android.content.Context#registerReceiver Context.registerReceiver()}
method. See the {@link android.content.BroadcastReceiver} class description
for more on dynamically created receivers.
@@ -40,14 +40,14 @@ for more on dynamically created receivers.
attributes:
{@code android:enabled}
-
Whether or not the broadcast receiver can be instantiated by the system —
-"{@code true}" if it can be, and "{@code false}" if not. The default value
+
Whether or not the broadcast receiver can be instantiated by the system —
+"{@code true}" if it can be, and "{@code false}" if not. The default value
is "{@code true}".
-The <application> element has its own
-enabled attribute that applies to all
-application components, including broadcast receivers. The
+The <application> element has its own
+enabled attribute that applies to all
+application components, including broadcast receivers. The
<application> and
{@code } attributes must both be "{@code true}" for
the broadcast receiver to be enabled. If either is "{@code false}", it is
@@ -55,72 +55,72 @@ disabled; it cannot be instantiated.
{@code android:exported}
-
Whether or not the broadcast receiver can receive messages from sources
-outside its application — "{@code true}" if it can, and "{@code false}"
-if not. If "{@code false}", the only messages the broadcast receiver can
-receive are those sent by components of the same application or applications
-with the same user ID.
+
Whether or not the broadcast receiver can receive messages from sources
+outside its application — "{@code true}" if it can, and "{@code false}"
+if not. If "{@code false}", the only messages the broadcast receiver can
+receive are those sent by components of the same application or applications
+with the same user ID.
-The default value depends on whether the broadcast receiver contains intent filters.
+The default value depends on whether the broadcast receiver contains intent filters.
The absence of any filters means that it can be invoked only by Intent objects that
-specify its exact class name. This implies that the receiver is intended only for
-application-internal use (since others would not normally know the class name).
+specify its exact class name. This implies that the receiver is intended only for
+application-internal use (since others would not normally know the class name).
So in this case, the default value is "{@code false}".
-On the other hand, the presence of at least one filter implies that the broadcast
-receiver is intended to receive intents broadcast by the system or other applications,
+On the other hand, the presence of at least one filter implies that the broadcast
+receiver is intended to receive intents broadcast by the system or other applications,
so the default value is "{@code true}".
-This attribute is not the only way to limit a broadcast receiver's external exposure.
-You can also use a permission to limit the external entities that can send it messages
+This attribute is not the only way to limit a broadcast receiver's external exposure.
+You can also use a permission to limit the external entities that can send it messages
(see the permission attribute).
{@code android:icon}
-
An icon representing the broadcast receiver. This attribute must be set
-as a reference to a drawable resource containing the image definition.
-If it is not set, the icon specified for the application as a whole is used
-instead (see the <application>
+
An icon representing the broadcast receiver. This attribute must be set
+as a reference to a drawable resource containing the image definition.
+If it is not set, the icon specified for the application as a whole is used
+instead (see the <application>
element's icon attribute).
-The broadcast receiver's icon — whether set here or by the
-<application> element — is also the
-default icon for all the receiver's intent filters (see the
-<intent-filter> element's
-icon attribute).
+The broadcast receiver's icon — whether set here or by the
+<application> element — is also the
+default icon for all the receiver's intent filters (see the
+<intent-filter> element's
+icon attribute).
{@code android:label}
-
A user-readable label for the broadcast receiver. If this attribute is not
-set, the label set for the application as a whole is
-used instead (see the <application> element's
+
A user-readable label for the broadcast receiver. If this attribute is not
+set, the label set for the application as a whole is
+used instead (see the <application> element's
label attribute).
-The broadcast receiver's label — whether set here or by the
-<application> element — is also the
-default label for all the receiver's intent filters (see the
-<intent-filter> element's
-label attribute).
+The broadcast receiver's label — whether set here or by the
+<application> element — is also the
+default label for all the receiver's intent filters (see the
+<intent-filter> element's
+label attribute).
The label should be set as a reference to a string resource, so that
-it can be localized like other strings in the user interface.
-However, as a convenience while you're developing the application,
+it can be localized like other strings in the user interface.
+However, as a convenience while you're developing the application,
it can also be set as a raw string.
{@code android:name}
-
The name of the class that implements the broadcast receiver, a subclass of
-{@link android.content.BroadcastReceiver}. This should be a fully qualified
-class name (such as, "{@code com.example.project.ReportReceiver}"). However,
-as a shorthand, if the first character of the name is a period (for example,
-"{@code . ReportReceiver}"), it is appended to the package name specified in
-the <manifest> element.
+
The name of the class that implements the broadcast receiver, a subclass of
+{@link android.content.BroadcastReceiver}. This should be a fully qualified
+class name (such as, "{@code com.example.project.ReportReceiver}"). However,
+as a shorthand, if the first character of the name is a period (for example,
+"{@code . ReportReceiver}"), it is appended to the package name specified in
+the <manifest> element.
The name of a permission that broadcasters must have to send a
+
The name of a permission that broadcasters must have to send a
message to the broadcast receiver.
-If this attribute is not set, the permission set by the
+If this attribute is not set, the permission set by the
<application> element's
-permission attribute applies
-to the broadcast receiver. If neither attribute is set, the receiver
+permission attribute applies
+to the broadcast receiver. If neither attribute is set, the receiver
is not protected by a permission.
-For more information on permissions, see the
-Permissions
-section in the introduction and a separate document,
+For more information on permissions, see the
+Permissions
+section in the introduction and a separate document,
Security and Permissions.
{@code android:process}
-
The name of the process in which the broadcast receiver should run.
-Normally, all components of an application run in the default process created
-for the application. It has the same name as the application package. The
-<application> element's
-process attribute can set a different
+
The name of the process in which the broadcast receiver should run.
+Normally, all components of an application run in the default process created
+for the application. It has the same name as the application package. The
+<application> element's
+process attribute can set a different
default for all components. But each component can override the default
-with its own {@code process} attribute, allowing you to spread your
+with its own {@code process} attribute, allowing you to spread your
application across multiple processes.
-If the name assigned to this attribute begins with a colon (':'), a new
-process, private to the application, is created when it's needed and
+If the name assigned to this attribute begins with a colon (':'), a new
+process, private to the application, is created when it's needed and
the broadcast receiver runs in that process.
-If the process name begins with a lowercase character, the receiver will run
+If the process name begins with a lowercase character, the receiver will run
in a global process of that name, provided that it has permission to do so.
-This allows components in different applications to share a process, reducing
+This allows components in different applications to share a process, reducing
resource usage.
Declares a service (a {@link android.app.Service} subclass) as one
-of the application's components. Unlike activities, services lack a
-visual user interface. They're used to implement long-running background
-operations or a rich communications API that can be called by other
+of the application's components. Unlike activities, services lack a
+visual user interface. They're used to implement long-running background
+operations or a rich communications API that can be called by other
applications.
All services must be represented by {@code } elements in
-the manifest file. Any that are not declared there will not be seen
+the manifest file. Any that are not declared there will not be seen
by the system and will never be run.
attributes:
{@code android:enabled}
-
Whether or not the service can be instantiated by the system —
-"{@code true}" if it can be, and "{@code false}" if not. The default value
+
Whether or not the service can be instantiated by the system —
+"{@code true}" if it can be, and "{@code false}" if not. The default value
is "{@code true}".
-The <application> element has its own
-enabled attribute that applies to all
-application components, including services. The
+The <application> element has its own
+enabled attribute that applies to all
+application components, including services. The
<application> and {@code }
attributes must both be "{@code true}" (as they both
-are by default) for the service to be enabled. If either is
+are by default) for the service to be enabled. If either is
"{@code false}", the service is disabled; it cannot be instantiated.
{@code android:exported}
-
Whether or not components of other applications can invoke
-the service or interact with it — "{@code true}" if they can, and
-"{@code false}" if not. When the value is "{@code false}", only
-components of the same application or applications
+
Whether or not components of other applications can invoke
+the service or interact with it — "{@code true}" if they can, and
+"{@code false}" if not. When the value is "{@code false}", only
+components of the same application or applications
with the same user ID can start the service or bind to it.
-The default value depends on whether the service contains intent filters. The
-absence of any filters means that it can be invoked only by specifying
-its exact class name. This implies that the service is intended only for
-application-internal use (since others would not know the class name). So in
+The default value depends on whether the service contains intent filters. The
+absence of any filters means that it can be invoked only by specifying
+its exact class name. This implies that the service is intended only for
+application-internal use (since others would not know the class name). So in
this case, the default value is "{@code false}".
-On the other hand, the presence of at least one filter implies that the service
+On the other hand, the presence of at least one filter implies that the service
is intended for external use, so the default value is "{@code true}".
This attribute is not the only way to limit the exposure of a service to other
-applications. You can also use a permission to limit the external entities that
-can interact with the service (see the permission
+applications. You can also use a permission to limit the external entities that
+can interact with the service (see the permission
attribute).
{@code android:icon}
-
An icon representing the service. This attribute must be set as a
-reference to a drawable resource containing the image definition.
-If it is not set, the icon specified for the application
-as a whole is used instead (see the <application>
+
An icon representing the service. This attribute must be set as a
+reference to a drawable resource containing the image definition.
+If it is not set, the icon specified for the application
+as a whole is used instead (see the <application>
element's icon attribute).
-The service's icon — whether set here or by the
-<application> element — is also the
-default icon for all the service's intent filters (see the
-<intent-filter> element's
+The service's icon — whether set here or by the
+<application> element — is also the
+default icon for all the service's intent filters (see the
+<intent-filter> element's
icon attribute).
-
+
{@code android:isolatedProcess}
If set to true, this service will run under a special process that is isolated from the
rest of the system and has no permissions of its own.
- The only communication with it is through the Service API
+ The only communication with it is through the Service API
(binding and starting).
{@code android:label}
-
A name for the service that can be displayed to users.
-If this attribute is not set, the label set for the application as a whole is
-used instead (see the <application> element's
+
A name for the service that can be displayed to users.
+If this attribute is not set, the label set for the application as a whole is
+used instead (see the <application> element's
label attribute).
-The service's label — whether set here or by the
-<application> element — is also the
-default label for all the service's intent filters (see the
-<intent-filter> element's
-label attribute).
+The service's label — whether set here or by the
+<application> element — is also the
+default label for all the service's intent filters (see the
+<intent-filter> element's
+label attribute).
The label should be set as a reference to a string resource, so that
-it can be localized like other strings in the user interface.
-However, as a convenience while you're developing the application,
+it can be localized like other strings in the user interface.
+However, as a convenience while you're developing the application,
it can also be set as a raw string.
{@code android:name}
-
The name of the {@link android.app.Service} subclass that implements
-the service. This should be a fully qualified class name (such as,
-"{@code com.example.project.RoomService}"). However, as a shorthand, if
+
The name of the {@link android.app.Service} subclass that implements
+the service. This should be a fully qualified class name (such as,
+"{@code com.example.project.RoomService}"). However, as a shorthand, if
the first character of the name is a period (for example, "{@code .RoomService}"),
-it is appended to the package name specified in the
-<manifest> element.
+it is appended to the package name specified in the
+<manifest> element.
The name of a permission that an entity must have in order to
-launch the service or bind to it. If a caller of
+
The name of a permission that an entity must have in order to
+launch the service or bind to it. If a caller of
{@link android.content.Context#startService startService()},
{@link android.content.Context#bindService bindService()}, or
{@link android.content.Context#stopService stopService()},
@@ -147,38 +147,38 @@ has not been granted this permission, the method will not work and the
Intent object will not be delivered to the service.
-If this attribute is not set, the permission set by the
+If this attribute is not set, the permission set by the
<application> element's
-permission
+permission
attribute applies to the service. If neither attribute is set, the service is
not protected by a permission.
-For more information on permissions, see the
-Permissions
-section in the introduction and a separate document,
+For more information on permissions, see the
+Permissions
+section in the introduction and a separate document,
Security and Permissions.
{@code android:process}
-
The name of the process where the service is to run. Normally,
-all components of an application run in the default process created for the
-application. It has the same name as the application package. The
-<application> element's
-process
-attribute can set a different
+
The name of the process where the service is to run. Normally,
+all components of an application run in the default process created for the
+application. It has the same name as the application package. The
+<application> element's
+process
+attribute can set a different
default for all components. But component can override the default
-with its own {@code process} attribute, allowing you to spread your
+with its own {@code process} attribute, allowing you to spread your
application across multiple processes.
-If the name assigned to this attribute begins with a colon (':'), a new
-process, private to the application, is created when it's needed and
+If the name assigned to this attribute begins with a colon (':'), a new
+process, private to the application, is created when it's needed and
the service runs in that process.
-If the process name begins with a lowercase character, the service will run
+If the process name begins with a lowercase character, the service will run
in a global process of that name, provided that it has permission to do so.
-This allows components in different applications to share a process, reducing
+This allows components in different applications to share a process, reducing
resource usage.
Google Play filters applications according
to the texture compression formats that they support, to ensure that
they can be installed only on devices that can handle their textures
properly. You can use texture compression filtering
as a way of targeting specific device types, based on GPU platform.
transition from Android 1.5 to 1.6, when support for multiple screens was first introduced. You
should not use it.
-
+
{@code android:smallScreens}
Indicates whether the application supports smaller screen form-factors.
A small screen is defined as one with a smaller aspect ratio than
@@ -84,14 +84,14 @@ should not use it.
the platform can do to make such an application work on a smaller screen. This is {@code "true"} by
default.
-
+
{@code android:normalScreens}
Indicates whether an application supports the "normal" screen
form-factors. Traditionally this is an HVGA medium density
screen, but WQVGA low density and WVGA high density are also
considered to be normal. This attribute is "true" by default.
-
+
{@code android:largeScreens}
Indicates whether the application supports larger screen form-factors.
A large screen is defined as a screen that is significantly larger
@@ -116,7 +116,7 @@ generally enable scr
compatibility mode.
This attribute was introduced in API level 9.
-
+
{@code android:anyDensity}
Indicates whether the application includes resources to accommodate any screen
density.
@@ -127,14 +127,14 @@ is if your app directly manipulates bitmaps (see the Supporting Multiple
Screens document for more information).
-
+
{@code android:requiresSmallestWidthDp}
Specifies the minimum smallestWidth required. The smallestWidth is the shortest dimension of
the screen space (in {@code dp} units) that must be available to your application UI—that is,
the shortest of the available screen's two dimensions. So, in order for a device to be considered
compatible with your application, the device's smallestWidth must be equal to or greater than this
value. (Usually, the value you supply for this is the "smallest width" that your layout supports,
-regardless of the screen's current orientation.)
+regardless of the screen's current orientation.)
For example, a typical handset screen has a smallestWidth of 320dp, a 7" tablet has a
smallestWidth of 600dp, and a 10" tablet has a smallestWidth of 720dp. These values are generally
@@ -209,7 +209,7 @@ screens with a 320dp width, so screen compatibility mode is not applied if your
android:largestWidthLimitDp} is larger than 320.
Google Play uses the <uses-library> elements declared
in your app manifest to filter your app from devices that do not meet it's library
requirements. For more information about filtering, see the topic
diff --git a/docs/html/guide/topics/manifest/uses-permission-element.jd b/docs/html/guide/topics/manifest/uses-permission-element.jd
index 32fe21eb89ea7..03a0dc15d75fd 100644
--- a/docs/html/guide/topics/manifest/uses-permission-element.jd
+++ b/docs/html/guide/topics/manifest/uses-permission-element.jd
@@ -5,10 +5,10 @@ parent.link=manifest-intro.html
-
+
-
-
Google Play Filtering
+
+
Google Play Filtering
In some cases, the permissions that you request
through <uses-permission> can affect how
@@ -43,24 +43,24 @@ href="{@docRoot}guide/topics/manifest/uses-feature-element.html#permissions-feat
description:
Requests a permission that the application must be granted in
-order for it to operate correctly. Permissions are granted by the user when the
+order for it to operate correctly. Permissions are granted by the user when the
application is installed (on devices running Android 5.1 and lower) or while the app is running (on devices running Android 6.0 and higher).
-For more information on permissions, see the
-Permissions
+For more information on permissions, see the
+Permissions
section in the introduction and the separate
System
Permissions API guide.
-A list of permissions defined by the base platform can be found at
+A list of permissions defined by the base platform can be found at
{@link android.Manifest.permission android.Manifest.permission}.
attributes:
{@code android:name}
-
The name of the permission. It can be a permission defined by the
-application with the <permission>
-element, a permission defined by another application, or one of the
+
The name of the permission. It can be a permission defined by the
+application with the <permission>
+element, a permission defined by another application, or one of the
standard system permissions (such as
{@link android.Manifest.permission#CAMERA "android.permission.CAMERA"}
or {@link android.Manifest.permission#READ_CONTACTS
diff --git a/docs/html/guide/topics/media/index.jd b/docs/html/guide/topics/media/index.jd
index a750c9a8809ff..c66ab309515c0 100644
--- a/docs/html/guide/topics/media/index.jd
+++ b/docs/html/guide/topics/media/index.jd
@@ -1,6 +1,6 @@
page.title=Media and Camera
page.landing=true
-page.landing.intro=Add video, audio, and photo capabilities to your app with Android's robust APIs for playing and recording media.
+page.landing.intro=Add video, audio, and photo capabilities to your app with Android's robust APIs for playing and recording media.
page.landing.image=
@jd:body
diff --git a/docs/html/guide/topics/media/jet/jetcreator_manual.jd b/docs/html/guide/topics/media/jet/jetcreator_manual.jd
index 214c79eed7b39..c2df25b1a4359 100644
--- a/docs/html/guide/topics/media/jet/jetcreator_manual.jd
+++ b/docs/html/guide/topics/media/jet/jetcreator_manual.jd
@@ -21,7 +21,7 @@ format, that respond in real-time to game play events and user interaction.
JET works in conjunction with SONiVOX's
Embedded Audio Synthesizer (EAS) which is the MIDI
playback device for Android. Both the
-JET and EAS engines are integrated into the Android embedded platform through the
+JET and EAS engines are integrated into the Android embedded platform through the
{@link android.media.JetPlayer} class, as well
as inherent in the JET Creator application. As such, the JET content author can
be sure that the playback will sound exactly the same in both the JET Creator
@@ -387,34 +387,34 @@ JET Creator projects to other people.
you first launch JET Creator you are presented with an open dialog like the
following.
-
+
-
-
+
+
Open will open an existing .jtc (JET Creator file) file. Use the browser
button to browse to the directory where you have saved your .jtc file.
-
+
New will create a new .jtc file.
-
+
Import will import a JET Archive (.zip) file.
-
+
Cancel will cancel the dialog and exit the application.
-
-
+
+
5 Main Window
@@ -457,16 +457,16 @@ Creator Main Window
The buttons along the left side of main
window do the following:
-
Add:
+
Add:
Displays the segment or event window for adding a new segment or event
-
Revise:
+
Revise:
Displays the segment or event window for updating an existing segment or event
-
Delete:
+
Delete:
Deletes the selected segment or event (will ask for confirmation)
-
Move:
+
Move:
Displays the move window which allows you to move selected segments or events
in time
@@ -476,11 +476,11 @@ in time
Dequeue All: Dequeues
(deselects) all segments
-
Play:
+
Play:
Starts playback of all queued segments. This button changes to Stop if any
segments are playing
-
Audition:
+
Audition:
Displays the Audition window (see below)
diff --git a/docs/html/guide/topics/media/jetplayer.jd b/docs/html/guide/topics/media/jetplayer.jd
index f3d55f90f4aeb..0f3212188c6f2 100644
--- a/docs/html/guide/topics/media/jetplayer.jd
+++ b/docs/html/guide/topics/media/jetplayer.jd
@@ -1,5 +1,5 @@
page.title=JetPlayer
-parent.title=Multimedia and Camera
+parent.title=Multimedia and Camera
parent.link=index.html
@jd:body
diff --git a/docs/html/guide/topics/processes/process-lifecycle.jd b/docs/html/guide/topics/processes/process-lifecycle.jd
index 0380f945aef0c..47ca1ec8912b4 100644
--- a/docs/html/guide/topics/processes/process-lifecycle.jd
+++ b/docs/html/guide/topics/processes/process-lifecycle.jd
@@ -48,7 +48,7 @@ following conditions hold:
at the top of the screen that the user is interacting with (its
{@link android.app.Activity#onResume} method has been called).
It has a {@link android.content.BroadcastReceiver} that is currently running
- (its {@link android.content.BroadcastReceiver#onReceive
+ (its {@link android.content.BroadcastReceiver#onReceive
BroadcastReceiver.onReceive()} method is executing).
It has a {@link android.app.Service} that is currently executing code
in one of its callbacks ({@link android.app.Service#onCreate Service.onCreate()},
diff --git a/docs/html/guide/topics/providers/calendar-provider.jd b/docs/html/guide/topics/providers/calendar-provider.jd
index 3cd4511de9b01..485f3c1676305 100644
--- a/docs/html/guide/topics/providers/calendar-provider.jd
+++ b/docs/html/guide/topics/providers/calendar-provider.jd
@@ -42,7 +42,7 @@ page.title=Calendar Provider
@@ -63,8 +63,8 @@ operations on calendars, events, attendees, reminders, and so on.
The Calender Provider API can be used by applications and sync adapters. The
rules vary depending on what type of program is making the calls. This document
-focuses primarily on using the Calendar Provider API as an application. For
-a discussion of how sync adapters are different, see
+focuses primarily on using the Calendar Provider API as an application. For
+a discussion of how sync adapters are different, see
Sync Adapters.
@@ -79,17 +79,17 @@ nor does it need to provide a user interface to view or create events.
Content providers store data and make it accessible to
applications. The content providers offered by the Android platform (including the Calendar Provider) typically expose data as a set of tables based on a
relational database model, where each row is a record and each column is data of
a particular type and meaning. Through the Calendar Provider API, applications
and sync adapters can get read/write access to the database tables that hold a
user's calendar data.
-
Every content provider exposes a public URI (wrapped as a
-{@link android.net.Uri}
+
Every content provider exposes a public URI (wrapped as a
+{@link android.net.Uri}
object) that uniquely identifies its data set. A content provider that controls
- multiple data sets (multiple tables) exposes a separate URI for each one. All
+ multiple data sets (multiple tables) exposes a separate URI for each one. All
URIs for providers begin with the string "content://". This
identifies the data as being controlled by a content provider. The Calendar
Provider defines constants for the URIs for each of its classes (tables). These
@@ -113,26 +113,26 @@ main tables and the fields that link them to each other.
This table holds
the calendar-specific information. Each row in this table contains the details for
a single calendar, such as the name, color, sync information, and so on.
{@link android.provider.CalendarContract.Events}
-
+
This table holds the
event-specific information. Each row in this table has the information for a single
event—for example, event title, location, start time, end
time, and so on. The event can occur one-time or can recur multiple times. Attendees,
-reminders, and extended properties are stored in separate tables.
-They each have an {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+reminders, and extended properties are stored in separate tables.
+They each have an {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
that references the {@link android.provider.BaseColumns#_ID} in the Events table.
This table holds the
start and end time for each occurrence of an event. Each row in this table
represents a single event occurrence. For one-time events there is a 1:1 mapping
@@ -141,7 +141,7 @@ of instances to events. For recurring events, multiple rows are automatically
This table holds the
event attendee (guest) information. Each row represents a single guest of an
event. It specifies the type of guest and the guest's attendance response
@@ -149,17 +149,17 @@ for the event.
This table holds the
alert/notification data. Each row represents a single alert for an event. An
event can have multiple reminders. The maximum number of reminders per event is
-specified in
-{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS},
+specified in
+{@link android.provider.CalendarContract.CalendarColumns#MAX_REMINDERS},
which is set by the sync adapter that
owns the given calendar. Reminders are specified in minutes before the event
and have a method that determines how the user will be alerted.
-
+
The Calendar Provider API is designed to be flexible and powerful. At the
@@ -178,9 +178,9 @@ Intents.
Sync adapters. A sync adapter synchronizes the calendar data
-on a user's device with another server or data source. In the
+on a user's device with another server or data source. In the
{@link android.provider.CalendarContract.Calendars} and
-{@link android.provider.CalendarContract.Events} tables,
+{@link android.provider.CalendarContract.Events} tables,
there are columns that are reserved for the sync adapters to use.
The provider and applications should not modify them. In fact, they are not
visible unless they are accessed as a sync adapter. For more information about
@@ -209,9 +209,9 @@ to delete, insert or update calendar data:
Calendars Table
-
The {@link android.provider.CalendarContract.Calendars} table contains details
+
The {@link android.provider.CalendarContract.Calendars} table contains details
for individual calendars. The following
-Calendars columns are writable by both an application and a sync adapter.
+Calendars columns are writable by both an application and a sync adapter.
For a full list of supported fields, see the
{@link android.provider.CalendarContract.Calendars} reference.
@@ -229,7 +229,7 @@ For a full list of supported fields, see the
A boolean indicating whether the calendar is selected to be displayed. A
value of 0 indicates that events associated with this calendar should not be
shown. A value of 1 indicates that events associated with this calendar should
@@ -240,7 +240,7 @@ android.provider.CalendarContract.Instances} table.
A boolean indicating whether the calendar should be synced and have its
events stored on the device. A value of 0 says do not sync this calendar or
store its events on the device. A value of 1 says sync events for this calendar
@@ -253,8 +253,8 @@ and store its events on the device.
Here is an example that shows how to get the calendars that are owned by a particular
user. For simplicity's sake, in this example the query operation is shown in the
user interface thread ("main thread"). In practice, this should be done in an asynchronous
-thread instead of on the main thread. For more discussion, see
-Loaders. If you are not just
+thread instead of on the main thread. For more discussion, see
+Loaders. If you are not just
reading data but modifying it, see {@link android.content.AsyncQueryHandler}.
@@ -268,18 +268,18 @@ public static final String[] EVENT_PROJECTION = new String[] {
Calendars.CALENDAR_DISPLAY_NAME, // 2
Calendars.OWNER_ACCOUNT // 3
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_ACCOUNT_NAME_INDEX = 1;
private static final int PROJECTION_DISPLAY_NAME_INDEX = 2;
private static final int PROJECTION_OWNER_ACCOUNT_INDEX = 3;
-
+
Why must you include
ACCOUNT_TYPE?
If you query on a {@link
android.provider.CalendarContract.Calendars#ACCOUNT_NAME
-Calendars.ACCOUNT_NAME}, you must also include
+Calendars.ACCOUNT_NAME}, you must also include
{@link android.provider.CalendarContract.Calendars#ACCOUNT_TYPE Calendars.ACCOUNT_TYPE}
in the selection. That is because a given account is
only considered unique given both its ACCOUNT_NAME and its
@@ -289,7 +289,7 @@ account authenticator that was used when the account was registered with the
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} for calendars not
associated with a device account. {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL} accounts do not get
-synced.
+synced.
In the next part of the example, you construct your query. The selection
@@ -301,59 +301,59 @@ calendars that have the ACCOUNT_NAME
has viewed, not just calendars the user owns, omit the OWNER_ACCOUNT.
The query returns a {@link android.database.Cursor}
object that you can use to traverse the result set returned by the database
-query. For more discussion of using queries in content providers,
+query. For more discussion of using queries in content providers,
see Content Providers.
// Run query
Cursor cur = null;
ContentResolver cr = getContentResolver();
-Uri uri = Calendars.CONTENT_URI;
-String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+Uri uri = Calendars.CONTENT_URI;
+String selection = "((" + Calendars.ACCOUNT_NAME + " = ?) AND ("
+ Calendars.ACCOUNT_TYPE + " = ?) AND ("
+ Calendars.OWNER_ACCOUNT + " = ?))";
String[] selectionArgs = new String[] {"sampleuser@gmail.com", "com.google",
- "sampleuser@gmail.com"};
-// Submit the query and get a Cursor object back.
+ "sampleuser@gmail.com"};
+// Submit the query and get a Cursor object back.
cur = cr.query(uri, EVENT_PROJECTION, selection, selectionArgs, null);
This next section uses the cursor to step through the result set. It uses the
constants that were set up at the beginning of the example to return the values
for each field.
-
+
// Use the cursor to step through the returned records
while (cur.moveToNext()) {
long calID = 0;
String displayName = null;
String accountName = null;
String ownerName = null;
-
+
// Get the field values
calID = cur.getLong(PROJECTION_ID_INDEX);
displayName = cur.getString(PROJECTION_DISPLAY_NAME_INDEX);
accountName = cur.getString(PROJECTION_ACCOUNT_NAME_INDEX);
ownerName = cur.getString(PROJECTION_OWNER_ACCOUNT_INDEX);
-
+
// Do something with the values...
...
}
-
+
Modifying a calendar
To perform an update of an calendar, you can provide the {@link
android.provider.BaseColumns#_ID} of the calendar either as an appended ID to
-the Uri
+the Uri
-({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
or as the first selection item. The selection
should start with "_id=?", and the first
selectionArg should be the {@link
-android.provider.BaseColumns#_ID} of the calendar.
+android.provider.BaseColumns#_ID} of the calendar.
You can also do updates by encoding the ID in the URI. This example changes a
-calendar's display name using the
-({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+calendar's display name using the
+({@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
approach:
private static final String DEBUG_TAG = "MyActivity";
@@ -375,7 +375,7 @@ an application needs to create a local calendar, it can do this by performing
the calendar insertion as a sync adapter, using an {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} of {@link
android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}.
-{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
+{@link android.provider.CalendarContract#ACCOUNT_TYPE_LOCAL}
is a special account type for calendars that are not
associated with a device account. Calendars of this type are not synced to a server. For a
discussion of sync adapters, see Sync Adapters.
@@ -434,7 +434,7 @@ android.provider.CalendarContract.Events} reference.
A value of 1 indicates this event occupies the entire day, as defined by
the local time zone. A value of 0 indicates it is a regular event that may start
and end at any time during a day.
The recurrence dates for the event.
- You typically use {@link android.provider.CalendarContract.EventsColumns#RDATE}
- in conjunction with {@link android.provider.CalendarContract.EventsColumns#RRULE}
+
The recurrence dates for the event.
+ You typically use {@link android.provider.CalendarContract.EventsColumns#RDATE}
+ in conjunction with {@link android.provider.CalendarContract.EventsColumns#RRULE}
to define an aggregate set of
repeating occurrences. For more discussion, see the RFC5545 spec.
@@ -519,11 +519,11 @@ you're inserting an event through the {@link
android.content.Intent#ACTION_INSERT INSERT} Intent, described in Using an intent to insert an event—in that
scenario, a default time zone is supplied.
-
+
For non-recurring events, you must include {@link
android.provider.CalendarContract.EventsColumns#DTEND}.
-
-
+
+
For recurring events, you must include a {@link
android.provider.CalendarContract.EventsColumns#DURATION} in addition to {@link
android.provider.CalendarContract.EventsColumns#RRULE} or {@link
@@ -532,9 +532,9 @@ you're inserting an event through the {@link
android.content.Intent#ACTION_INSERT INSERT} Intent, described in Using an intent to insert an event—in that
scenario, you can use an {@link
-android.provider.CalendarContract.EventsColumns#RRULE} in conjunction with {@link android.provider.CalendarContract.EventsColumns#DTSTART} and {@link android.provider.CalendarContract.EventsColumns#DTEND}, and the Calendar application
+android.provider.CalendarContract.EventsColumns#RRULE} in conjunction with {@link android.provider.CalendarContract.EventsColumns#DTSTART} and {@link android.provider.CalendarContract.EventsColumns#DTEND}, and the Calendar application
converts it to a duration automatically.
-
+
Here is an example of inserting an event. This is being performed in the UI
@@ -545,8 +545,8 @@ information, see {@link android.content.AsyncQueryHandler}.
long calID = 3;
-long startMillis = 0;
-long endMillis = 0;
+long startMillis = 0;
+long endMillis = 0;
Calendar beginTime = Calendar.getInstance();
beginTime.set(2012, 9, 14, 7, 30);
startMillis = beginTime.getTimeInMillis();
@@ -567,7 +567,7 @@ Uri uri = cr.insert(Events.CONTENT_URI, values);
// get the event ID that is the last element in the Uri
long eventID = Long.parseLong(uri.getLastPathSegment());
-//
+//
// ... do something with event ID
//
//
@@ -584,14 +584,14 @@ attendees or reminders to an event.
that you use an {@link android.content.Intent#ACTION_EDIT EDIT} Intent, as
described in Using an intent to edit an event.
However, if you need to, you can edit events directly. To perform an update of
-an Event, you can provide the _ID of the
+an Event, you can provide the _ID of the
event either as an appended ID to the Uri ({@link
-android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
-or as the first selection item.
+android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()})
+or as the first selection item.
The selection should start with "_id=?", and the first
selectionArg should be the _ID of the event. You can
also do updates using a selection with no ID. Here is an example of updating an
-event. It changes the title of the event using the
+event. It changes the title of the event using the
{@link android.content.ContentUris#withAppendedId(android.net.Uri,long) withAppendedId()}
approach:
@@ -604,7 +604,7 @@ ContentResolver cr = getContentResolver();
ContentValues values = new ContentValues();
Uri updateUri = null;
// The new title for the event
-values.put(Events.TITLE, "Kickboxing");
+values.put(Events.TITLE, "Kickboxing");
updateUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().update(updateUri, values, null, null);
Log.i(DEBUG_TAG, "Rows updated: " + rows);
@@ -631,22 +631,22 @@ ContentValues values = new ContentValues();
Uri deleteUri = null;
deleteUri = ContentUris.withAppendedId(Events.CONTENT_URI, eventID);
int rows = getContentResolver().delete(deleteUri, null, null);
-Log.i(DEBUG_TAG, "Rows deleted: " + rows);
+Log.i(DEBUG_TAG, "Rows deleted: " + rows);
Attendees Table
Each row of the {@link android.provider.CalendarContract.Attendees} table
-represents a single attendee or guest of an event. Calling
-{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
+represents a single attendee or guest of an event. Calling
+{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()}
returns a list of attendees for the
-event with the given {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}.
-This {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+event with the given {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}.
+This {@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
must match the {@link
-android.provider.BaseColumns#_ID} of a particular event.
+android.provider.BaseColumns#_ID} of a particular event.
The following table lists the
-writable fields. When inserting a new attendee, you must include all of them
+writable fields. When inserting a new attendee, you must include all of them
except ATTENDEE_NAME.
@@ -704,7 +704,7 @@ except ATTENDEE_NAME.
Adding Attendees
Here is an example that adds a single attendee to an event. Note that the
-{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
+{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}
is required:
@@ -724,17 +724,17 @@ Uri uri = cr.insert(Attendees.CONTENT_URI, values);
Reminders Table
Each row of the {@link android.provider.CalendarContract.Reminders} table
-represents a single reminder for an event. Calling
+represents a single reminder for an event. Calling
{@link android.provider.CalendarContract.Reminders#query(android.content.ContentResolver, long, java.lang.String[]) query()} returns a list of reminders for the
-event with the given
+event with the given
{@link android.provider.CalendarContract.AttendeesColumns#EVENT_ID}.
The following table lists the writable fields for reminders. All of them must
be included when inserting a new reminder. Note that sync adapters specify the
types of reminders they support in the {@link
-android.provider.CalendarContract.Calendars} table. See
-{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
+android.provider.CalendarContract.Calendars} table. See
+{@link android.provider.CalendarContract.CalendarColumns#ALLOWED_REMINDERS}
for details.
@@ -779,16 +779,16 @@ Uri uri = cr.insert(Reminders.CONTENT_URI, values);
Instances Table
-
The
+
The
{@link android.provider.CalendarContract.Instances} table holds the
start and end time for occurrences of an event. Each row in this table
represents a single event occurrence. The instances table is not writable and only
provides a way to query event occurrences.
-
The following table lists some of the fields you can query on for an instance. Note
-that time zone is defined by
-{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
-and
+
The following table lists some of the fields you can query on for an instance. Note
+that time zone is defined by
+{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_TYPE}
+and
{@link android.provider.CalendarContract.CalendarCache#KEY_TIMEZONE_INSTANCES}.
The start minute of the instance measured from midnight, relative to the
-Calendar's time zone.
+Calendar's time zone.
-
+
@@ -846,7 +846,7 @@ Calendar's time zone.
in the URI. In this example, {@link android.provider.CalendarContract.Instances}
gets access to the {@link
android.provider.CalendarContract.EventsColumns#TITLE} field through its
-implementation of the {@link android.provider.CalendarContract.EventsColumns} interface.
+implementation of the {@link android.provider.CalendarContract.EventsColumns} interface.
In other words, {@link
android.provider.CalendarContract.EventsColumns#TITLE} is returned through a
database view, not through querying the raw {@link
@@ -859,7 +859,7 @@ public static final String[] INSTANCE_PROJECTION = new String[] {
Instances.BEGIN, // 1
Instances.TITLE // 2
};
-
+
// The indices for the projection array above.
private static final int PROJECTION_ID_INDEX = 0;
private static final int PROJECTION_BEGIN_INDEX = 1;
@@ -874,7 +874,7 @@ long startMillis = beginTime.getTimeInMillis();
Calendar endTime = Calendar.getInstance();
endTime.set(2011, 10, 24, 8, 0);
long endMillis = endTime.getTimeInMillis();
-
+
Cursor cur = null;
ContentResolver cr = getContentResolver();
@@ -889,28 +889,28 @@ ContentUris.appendId(builder, startMillis);
ContentUris.appendId(builder, endMillis);
// Submit the query
-cur = cr.query(builder.build(),
- INSTANCE_PROJECTION,
- selection,
- selectionArgs,
+cur = cr.query(builder.build(),
+ INSTANCE_PROJECTION,
+ selection,
+ selectionArgs,
null);
-
+
while (cur.moveToNext()) {
String title = null;
long eventID = 0;
- long beginVal = 0;
-
+ long beginVal = 0;
+
// Get the field values
eventID = cur.getLong(PROJECTION_ID_INDEX);
beginVal = cur.getLong(PROJECTION_BEGIN_INDEX);
title = cur.getString(PROJECTION_TITLE_INDEX);
-
- // Do something with the values.
- Log.i(DEBUG_TAG, "Event: " + title);
+
+ // Do something with the values.
+ Log.i(DEBUG_TAG, "Event: " + title);
Calendar calendar = Calendar.getInstance();
- calendar.setTimeInMillis(beginVal);
+ calendar.setTimeInMillis(beginVal);
DateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
- Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
+ Log.i(DEBUG_TAG, "Date: " + formatter.format(calendar.getTime()));
}
}
@@ -928,9 +928,9 @@ while (cur.moveToNext()) {
- You can also refer to the URI with
-{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
-For an example of using this intent, see Using intents to view calendar data.
+ You can also refer to the URI with
+{@link android.provider.CalendarContract#CONTENT_URI CalendarContract.CONTENT_URI}.
+For an example of using this intent, see Using intents to view calendar data.
Open calendar to the time specified by <ms_since_epoch>.
@@ -1002,7 +1002,7 @@ For an example of using this intent, see manifest file.
-
+
When users run an application that uses this approach, the application sends
them to the Calendar to finish adding the event. The {@link
android.content.Intent#ACTION_INSERT INSERT} Intent uses extra fields to
pre-populate a form with the details of the event in the Calendar. Users can
then cancel the event, edit the form as needed, or save the event to their
calendars.
-
+
Here is a code snippet that schedules an event on January 19, 2012, that runs
from 7:30 a.m. to 8:30 a.m. Note the following about this code snippet:
-
It specifies {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
+
It specifies {@link android.provider.CalendarContract.Events#CONTENT_URI Events.CONTENT_URI}
as the Uri.
-
+
It uses the {@link
android.provider.CalendarContract#EXTRA_EVENT_BEGIN_TIME
CalendarContract.EXTRA_EVENT_BEGIN_TIME} and {@link
@@ -1090,10 +1090,10 @@ android.provider.CalendarContract#EXTRA_EVENT_END_TIME
CalendarContract.EXTRA_EVENT_END_TIME} extra fields to pre-populate the form
with the time of the event. The values for these times must be in UTC milliseconds
from the epoch.
-
+
It uses the {@link android.content.Intent#EXTRA_EMAIL Intent.EXTRA_EMAIL}
extra field to provide a comma-separated list of invitees, specified by email address.
A sync adapter needs to specify that it's a sync adapter by setting {@link android.provider.CalendarContract#CALLER_IS_SYNCADAPTER} to true.
-
-
+
+
A sync adapter needs to provide an {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_NAME} and an {@link
android.provider.CalendarContract.SyncColumns#ACCOUNT_TYPE} as query parameters in the URI.
-
+
A sync adapter has write access to more columns than an application or widget.
- For example, an application can only modify a few characteristics of a calendar,
+ For example, an application can only modify a few characteristics of a calendar,
such as its name, display name, visibility setting, and whether the calendar is
synced. By comparison, a sync adapter can access not only those columns, but many others,
such as calendar color, time zone, access level, location, and so on.
-However, a sync adapter is restricted to the ACCOUNT_NAME and
+However, a sync adapter is restricted to the ACCOUNT_NAME and
ACCOUNT_TYPE it specified.
Here is a helper method you can use to return a URI for use with a sync adapter:
@@ -1188,5 +1188,5 @@ However, a sync adapter is restricted to the ACCOUNT_NAME and
.appendQueryParameter(Calendars.ACCOUNT_TYPE, accountType).build();
}
-
For a sample implementation of a sync adapter (not specifically related to Calendar), see
+
For a sample implementation of a sync adapter (not specifically related to Calendar), see
SampleSyncAdapter.
diff --git a/docs/html/guide/topics/providers/content-provider-basics.jd b/docs/html/guide/topics/providers/content-provider-basics.jd
index b7ae3d2cb85cf..37df4e92c66e8 100644
--- a/docs/html/guide/topics/providers/content-provider-basics.jd
+++ b/docs/html/guide/topics/providers/content-provider-basics.jd
@@ -238,7 +238,7 @@ page.title=Content Provider Basics
For example, to get a list of the words and their locales from the User Dictionary Provider,
you call {@link android.content.ContentResolver#query ContentResolver.query()}.
The {@link android.content.ContentResolver#query query()} method calls the
- {@link android.content.ContentProvider#query ContentProvider.query()} method defined by the
+ {@link android.content.ContentProvider#query ContentProvider.query()} method defined by the
User Dictionary Provider. The following lines of code show a
{@link android.content.ContentResolver#query ContentResolver.query()} call:
Table 2 shows how the arguments to
- {@link android.content.ContentResolver#query
+ {@link android.content.ContentResolver#query
query(Uri,projection,selection,selectionArgs,sortOrder)} match an SQL SELECT statement:
@@ -361,8 +361,8 @@ Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
For the sake of clarity, the code snippets in this section call
- {@link android.content.ContentResolver#query ContentResolver.query()} on the "UI thread"". In
- actual code, however, you should do queries asynchronously on a separate thread. One way to do
+ {@link android.content.ContentResolver#query ContentResolver.query()} on the "UI thread"". In
+ actual code, however, you should do queries asynchronously on a separate thread. One way to do
this is to use the {@link android.content.CursorLoader} class, which is described
in more detail in the
Loaders guide. Also, the lines of code are snippets only; they don't show a complete
@@ -430,7 +430,7 @@ String[] mSelectionArgs = {""};
The next snippet shows how to use
{@link android.content.ContentResolver#query ContentResolver.query()}, using the User Dictionary
- Provider as an example. A provider client query is similar to an SQL query, and it contains a
+ Provider as an example. A provider client query is similar to an SQL query, and it contains a
set of columns to return, a set of selection criteria, and a sort order.
The expression that specifies the rows to retrieve is split into a selection clause and
selection arguments. The selection clause is a combination of logical and Boolean expressions,
- column names, and values (the variable mSelectionClause). If you specify the
- replaceable parameter ? instead of a value, the query method retrieves the value
+ column names, and values (the variable mSelectionClause). If you specify the
+ replaceable parameter ? instead of a value, the query method retrieves the value
from the selection arguments array (the variable mSelectionArgs).
- The {@link android.content.ContentResolver#query ContentResolver.query()} client method always
- returns a {@link android.database.Cursor} containing the columns specified by the query's
- projection for the rows that match the query's selection criteria. A
- {@link android.database.Cursor} object provides random read access to the rows and columns it
- contains. Using {@link android.database.Cursor} methods, you can iterate over the rows in the
+ The {@link android.content.ContentResolver#query ContentResolver.query()} client method always
+ returns a {@link android.database.Cursor} containing the columns specified by the query's
+ projection for the rows that match the query's selection criteria. A
+ {@link android.database.Cursor} object provides random read access to the rows and columns it
+ contains. Using {@link android.database.Cursor} methods, you can iterate over the rows in the
results, determine the data type of each column, get the data out of a column, and examine other
- properties of the results. Some {@link android.database.Cursor} implementations automatically
- update the object when the provider's data changes, or trigger methods in an observer object
+ properties of the results. Some {@link android.database.Cursor} implementations automatically
+ update the object when the provider's data changes, or trigger methods in an observer object
when the {@link android.database.Cursor} changes, or both.
@@ -705,14 +705,14 @@ if (mCursor != null) {
To get the permissions needed to access a provider, an application requests them with a
<uses-permission>
- element in its manifest file. When the Android Package Manager installs the application, a user
- must approve all of the permissions the application requests. If the user approves all of them,
+ element in its manifest file. When the Android Package Manager installs the application, a user
+ must approve all of the permissions the application requests. If the user approves all of them,
Package Manager continues the installation; if the user doesn't approve them, Package Manager
aborts the installation.
@@ -795,8 +795,8 @@ content://user_dictionary/words/<id_value>
To update a row, you use a {@link android.content.ContentValues} object with the updated
values just as you do with an insertion, and selection criteria just as you do with a query.
The client method you use is
- {@link android.content.ContentResolver#update ContentResolver.update()}. You only need to add
- values to the {@link android.content.ContentValues} object for columns you're updating. If you
+ {@link android.content.ContentResolver#update ContentResolver.update()}. You only need to add
+ values to the {@link android.content.ContentValues} object for columns you're updating. If you
want to clear the contents of a column, set the value to null.
You should also sanitize user input when you call
- {@link android.content.ContentResolver#update ContentResolver.update()}. To learn more about
+ {@link android.content.ContentResolver#update ContentResolver.update()}. To learn more about
this, read the section Protecting against malicious input.
You should also sanitize user input when you call
- {@link android.content.ContentResolver#delete ContentResolver.delete()}. To learn more about
+ {@link android.content.ContentResolver#delete ContentResolver.delete()}. To learn more about
this, read the section Protecting against malicious input.
@@ -948,9 +948,9 @@ mRowsDeleted = getContentResolver().delete(
To access a provider in "batch mode",
you create an array of {@link android.content.ContentProviderOperation} objects and then
dispatch them to a content provider with
- {@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}. You pass the
- content provider's authority to this method, rather than a particular content URI.
- This allows each {@link android.content.ContentProviderOperation} object in the array to work
+ {@link android.content.ContentResolver#applyBatch ContentResolver.applyBatch()}. You pass the
+ content provider's authority to this method, rather than a particular content URI.
+ This allows each {@link android.content.ContentProviderOperation} object in the array to work
against a different table. A call to {@link android.content.ContentResolver#applyBatch
ContentResolver.applyBatch()} returns an array of results.
@@ -1013,7 +1013,7 @@ mRowsDeleted = getContentResolver().delete(
A provider defines URI permissions for content URIs in its manifest, using the
android:grantUriPermission
- attribute of the
+ attribute of the
<provider>
element, as well as the
<grant-uri-permission>
diff --git a/docs/html/guide/topics/providers/content-provider-creating.jd b/docs/html/guide/topics/providers/content-provider-creating.jd
index baa92e131dc74..ec6909c891368 100755
--- a/docs/html/guide/topics/providers/content-provider-creating.jd
+++ b/docs/html/guide/topics/providers/content-provider-creating.jd
@@ -422,7 +422,7 @@ public class ExampleProvider extends ContentProvider {
* in the path
*/
sUriMatcher.addURI("com.example.app.provider", "table3", 1);
-
+
/*
* Sets the code for a single row to 2. In this case, the "#" wildcard is
* used. "content://com.example.app.provider/table3/3" matches, but
@@ -881,7 +881,7 @@ vnd.android.cursor.item/vnd.com.example.provider.table1
A contract class also helps developers because it usually has mnemonic names for its constants,
so developers are less likely to use incorrect values for column names or URIs. Since it's a
class, it can contain Javadoc documentation. Integrated development environments such as
- Android Studio can auto-complete constant names from the contract class and display Javadoc for
+ Android Studio can auto-complete constant names from the contract class and display Javadoc for
the constants.
diff --git a/docs/html/guide/topics/renderscript/compute.jd b/docs/html/guide/topics/renderscript/compute.jd
index fc795ff6a63f0..861c9258f2c25 100755
--- a/docs/html/guide/topics/renderscript/compute.jd
+++ b/docs/html/guide/topics/renderscript/compute.jd
@@ -167,7 +167,7 @@ precision (such as SIMD CPU instructions).
We strongly recommend using the Support Library APIs for accessing RenderScript because they
- provide a wider range of device compatibility. Developers targeting specific versions of
+ provide a wider range of device compatibility. Developers targeting specific versions of
Android can use {@link android.renderscript} if necessary.
diff --git a/docs/html/guide/topics/resources/accessing-resources.jd b/docs/html/guide/topics/resources/accessing-resources.jd
index b971238c17732..953b27418efcb 100644
--- a/docs/html/guide/topics/resources/accessing-resources.jd
+++ b/docs/html/guide/topics/resources/accessing-resources.jd
@@ -264,8 +264,8 @@ reference a system resource, you would need to include the package name. For exa
android:text="@string/hello" />
-
Note: You should use string resources at
-all times, so that your application can be localized for other languages.
+
@@ -94,7 +94,7 @@ In XML: @[package:]animator/filename
</set>
-
The file must have a single root element: either
+
The file must have a single root element: either
<set>, <objectAnimator>, or <valueAnimator>. You can
group animation elements together inside the <set> element, including other
<set> elements.
@@ -109,7 +109,7 @@ group animation elements together inside the <set> element, i
<valueAnimator>, or other <set> elements). Represents
an {@link android.animation.AnimatorSet}.
You can specify nested <set> tags to further
- group animations together. Each <set> can define its own
+ group animations together. Each <set> can define its own
ordering attribute.
attributes:
@@ -119,11 +119,11 @@ group animation elements together inside the <set> element, i
Keyword. Specifies the play ordering of animations in this set.
-
-
Value
Description
-
sequentially
Play animations in this set sequentially
-
together (default)
Play animations in this set at the same time.
-
+
+
Value
Description
+
sequentially
Play animations in this set sequentially
+
together (default)
Play animations in this set at the same time.
+
@@ -131,11 +131,11 @@ group animation elements together inside the <set> element, i
<objectAnimator>
Animates a specific property of an object over a specific amount of time. Represents
an {@link android.animation.ObjectAnimator}.
-
+
attributes:
- android:propertyName
+ android:propertyName
String. Required. The object's property to animate, referenced by its name. For example you can specify
@@ -206,11 +206,11 @@ group animation elements together inside the <set> element, i
Keyword. Do not specify this attribute if the value is a color. The animation framework automatically handles color
values
-
-
Value
Description
-
intType
Specifies that the animated values are integers
-
floatType (default)
Specifies that the animated values are floats
-
+
+
Value
Description
+
intType
Specifies that the animated values are integers
+
floatType (default)
Specifies that the animated values are floats
+
@@ -279,11 +279,11 @@ group animation elements together inside the <set> element, i
Keyword. Do not specify this attribute if the value is a color. The animation framework automatically handles color
values.
-
-
Value
Description
-
intType
Specifies that the animated values are integers
-
floatType (default)
Specifies that the animated values are floats
-
+
+
Value
Description
+
intType
Specifies that the animated values are integers
+
floatType (default)
Specifies that the animated values are floats
+
@@ -320,7 +320,7 @@ group animation elements together inside the <set> element, i
before starting the animation set. Calling {@link android.animation.AnimatorSet#setTarget
setTarget()} sets a single target object for all children of the {@link
android.animation.AnimatorSet} as a convenience. The following code shows how to do this:
-
+
AnimatorSet set = (AnimatorSet) AnimatorInflater.loadAnimator(myContext,
R.anim.property_animator);
diff --git a/docs/html/guide/topics/resources/more-resources.jd b/docs/html/guide/topics/resources/more-resources.jd
index 1afbf70731e40..8488cdee76205 100644
--- a/docs/html/guide/topics/resources/more-resources.jd
+++ b/docs/html/guide/topics/resources/more-resources.jd
@@ -760,7 +760,7 @@ int color = colors.{@link android.content.res.TypedArray#getColor(int,int) getCo
-
+
example:
@@ -781,7 +781,7 @@ int color = colors.{@link android.content.res.TypedArray#getColor(int,int) getCo
-
+
see also:
diff --git a/docs/html/guide/topics/resources/providing-resources.jd b/docs/html/guide/topics/resources/providing-resources.jd
index c919ed5e777dd..80a989a57e284 100644
--- a/docs/html/guide/topics/resources/providing-resources.jd
+++ b/docs/html/guide/topics/resources/providing-resources.jd
@@ -523,7 +523,7 @@ is larger than the current screen, the system will not
application will crash at runtime (for example, if all layout resources are tagged with the {@code
xlarge} qualifier, but the device is a normal-size screen).
Also see the {@link android.content.res.Configuration#screenLayout} configuration field,
@@ -608,7 +608,7 @@ which indicates the current device orientation.
Added in API level 8, television added in API 13, watch added in API 20.
This can change during the life of your application if the user places the device in a
@@ -659,8 +659,8 @@ application during runtime.
Level 8
{@code xxhdpi}: Extra-extra-high-density screens; approximately 480dpi. Added in API
Level 16
-
{@code xxxhdpi}: Extra-extra-extra-high-density uses (launcher icon only, see the
- note
+
{@code xxxhdpi}: Extra-extra-extra-high-density uses (launcher icon only, see the
+ note
in Supporting Multiple Screens); approximately 640dpi. Added in API
Level 18
{@code nodpi}: This can be used for bitmap resources that you do not want to be scaled
diff --git a/docs/html/guide/topics/resources/runtime-changes.jd b/docs/html/guide/topics/resources/runtime-changes.jd
index 8781d208d6eac..2e6f9b765edf8 100644
--- a/docs/html/guide/topics/resources/runtime-changes.jd
+++ b/docs/html/guide/topics/resources/runtime-changes.jd
@@ -84,12 +84,12 @@ your activity to preserve stateful objects.
To retain stateful objects in a fragment during a runtime configuration change:
-
Extend the {@link android.app.Fragment} class and declare references to your stateful
+
Extend the {@link android.app.Fragment} class and declare references to your stateful
objects.
Call {@link android.app.Fragment#setRetainInstance(boolean)} when the fragment is created.
Add the fragment to your activity.
-
Use {@link android.app.FragmentManager} to retrieve the fragment when the activity is
+
Use {@link android.app.FragmentManager} to retrieve the fragment when the activity is
restarted.
@@ -127,8 +127,8 @@ leak all the views and resources of the original activity instance. (Leaking res
means that your application maintains a hold on them and they cannot be garbage-collected, so
lots of memory can be lost.)
-
Then use {@link android.app.FragmentManager} to add the fragment to the activity.
-You can obtain the data object from the fragment when the activity starts again during runtime
+
Then use {@link android.app.FragmentManager} to add the fragment to the activity.
+You can obtain the data object from the fragment when the activity starts again during runtime
configuration changes. For example, define your activity as follows:
@@ -170,7 +170,7 @@ public class MyActivity extends Activity {
In this example, {@link android.app.Activity#onCreate(Bundle) onCreate()} adds a fragment
or restores a reference to it. {@link android.app.Activity#onCreate(Bundle) onCreate()} also
stores the stateful object inside the fragment instance.
-{@link android.app.Activity#onDestroy() onDestroy()} updates the stateful object inside the
+{@link android.app.Activity#onDestroy() onDestroy()} updates the stateful object inside the
retained fragment instance.
diff --git a/docs/html/guide/topics/sensors/index.jd b/docs/html/guide/topics/sensors/index.jd
index 09d27e7a9bd59..36d3adcb48a3d 100644
--- a/docs/html/guide/topics/sensors/index.jd
+++ b/docs/html/guide/topics/sensors/index.jd
@@ -1,7 +1,7 @@
page.title=Location and Sensors APIs
page.landing=true
page.tags=location,sensors
-page.landing.intro=Use sensors on the device to add rich location and motion capabilities to your app, from GPS or network location to accelerometer, gyroscope, temperature, barometer, and more.
+page.landing.intro=Use sensors on the device to add rich location and motion capabilities to your app, from GPS or network location to accelerometer, gyroscope, temperature, barometer, and more.
page.landing.image=
@jd:body
@@ -10,7 +10,7 @@ page.landing.image=
- The Android platform offers a spelling checker framework that lets you implement
- and access spell checking in your application. The framework is one of the
+ The Android platform offers a spelling checker framework that lets you implement
+ and access spell checking in your application. The framework is one of the
Text Service APIs offered by the Android platform.
- To use the framework in your app, you create a special type of Android service that
+ To use the framework in your app, you create a special type of Android service that
generates a spelling checker session object. Based on text you provide,
the session object returns spelling suggestions generated by the spelling checker.
diff --git a/docs/html/guide/topics/ui/accessibility/apps.jd b/docs/html/guide/topics/ui/accessibility/apps.jd
index eb639e37027d3..26fb3cca9dc3d 100644
--- a/docs/html/guide/topics/ui/accessibility/apps.jd
+++ b/docs/html/guide/topics/ui/accessibility/apps.jd
@@ -458,7 +458,7 @@ public boolean dispatchPopulateAccessibilityEvent(AccessibilityEvent event) {
// Call the super implementation to populate its text to the event, which
// calls onPopulateAccessibilityEvent() on API Level 14 and up.
boolean completed = super.dispatchPopulateAccessibilityEvent(event);
-
+
// In case this is running on a API revision earlier that 14, check
// the text content of the event and add an appropriate text
// description for this custom view:
diff --git a/docs/html/guide/topics/ui/binding.jd b/docs/html/guide/topics/ui/binding.jd
index a4fd25c2825e9..48a1d409ef21e 100644
--- a/docs/html/guide/topics/ui/binding.jd
+++ b/docs/html/guide/topics/ui/binding.jd
@@ -16,7 +16,7 @@ parent.link=index.html
-// Get a Spinner and bind it to an ArrayAdapter that
+// Get a Spinner and bind it to an ArrayAdapter that
// references a String array.
Spinner s1 = (Spinner) findViewById(R.id.spinner1);
ArrayAdapter adapter = ArrayAdapter.createFromResource(
@@ -31,7 +31,7 @@ private static String[] PROJECTION = new String[] {
Spinner s2 = (Spinner) findViewById(R.id.spinner2);
Cursor cur = managedQuery(People.CONTENT_URI, PROJECTION, null, null);
-
+
SimpleCursorAdapter adapter2 = new SimpleCursorAdapter(this,
android.R.layout.simple_spinner_item, // Use a template
// that displays a
@@ -41,7 +41,7 @@ SimpleCursorAdapter adapter2 = new SimpleCursorAdapter(this,
// people database to...
new int[] {android.R.id.text1}); // The "text1" view defined in
// the XML template
-
+
adapter2.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item);
s2.setAdapter(adapter2);
@@ -70,7 +70,7 @@ private OnItemClickListener mMessageClickedHandler = new OnItemClickListener() {
// Now hook into our object and set its onItemClickListener member
// to our class handler object.
mHistoryView = (ListView)findViewById(R.id.history);
-mHistoryView.setOnItemClickListener(mMessageClickedHandler);
+mHistoryView.setOnItemClickListener(mMessageClickedHandler);
The second <item> defines the bitmap to use when the button is
focused (when the button is highlighted using the trackball or directional
pad).
-
The third <item> defines the bitmap to use when the button is in the
+
The third <item> defines the bitmap to use when the button is in the
default state (it's neither pressed nor focused).
Note: The order of the <item> elements is
diff --git a/docs/html/guide/topics/ui/controls/checkbox.jd b/docs/html/guide/topics/ui/controls/checkbox.jd
index 2a64e38d3bf43..f5feeb106a380 100644
--- a/docs/html/guide/topics/ui/controls/checkbox.jd
+++ b/docs/html/guide/topics/ui/controls/checkbox.jd
@@ -65,7 +65,7 @@ click event for both checkboxes:
public void onCheckboxClicked(View view) {
// Is the view now checked?
boolean checked = ((CheckBox) view).isChecked();
-
+
// Check which checkbox was clicked
switch(view.getId()) {
case R.id.checkbox_meat:
diff --git a/docs/html/guide/topics/ui/controls/pickers.jd b/docs/html/guide/topics/ui/controls/pickers.jd
index c0667add65aaa..9788f084022ae 100644
--- a/docs/html/guide/topics/ui/controls/pickers.jd
+++ b/docs/html/guide/topics/ui/controls/pickers.jd
@@ -123,15 +123,15 @@ android.support.v4.app.DialogFragment#show show()}.
For example, here's a button that, when clicked, calls a method to show the dialog:
@@ -113,8 +113,8 @@ For example, here's an implementation of the interface in an {@link android.app.
public class SpinnerActivity extends Activity implements OnItemSelectedListener {
...
-
- public void onItemSelected(AdapterView<?> parent, View view,
+
+ public void onItemSelected(AdapterView<?> parent, View view,
int pos, long id) {
// An item was selected. You can retrieve the selected item using
// parent.getItemAtPosition(pos)
diff --git a/docs/html/guide/topics/ui/controls/text.jd b/docs/html/guide/topics/ui/controls/text.jd
index f4d72b2a80f6f..f5c2a4251788d 100644
--- a/docs/html/guide/topics/ui/controls/text.jd
+++ b/docs/html/guide/topics/ui/controls/text.jd
@@ -4,7 +4,7 @@ page.tags=edittext,autocompletetextview
-
+
In this document
Specifying the Keyboard Type
@@ -279,7 +279,7 @@ that provides suggestions from an array, using {@link android.widget.ArrayAdapte
layout with only the text field:
<?xml version="1.0" encoding="utf-8"?>
-<AutoCompleteTextView xmlns:android="http://schemas.android.com/apk/res/android"
+<AutoCompleteTextView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/autocomplete_country"
android:layout_width="fill_parent"
android:layout_height="wrap_content" />
@@ -313,8 +313,8 @@ code to specify the adapter that supplies the suggestions:
AutoCompleteTextView textView = (AutoCompleteTextView) findViewById(R.id.autocomplete_country);
// Get the string array
String[] countries = getResources().getStringArray(R.array.countries_array);
-// Create the adapter and set it to the AutoCompleteTextView
-ArrayAdapter<String> adapter =
+// Create the adapter and set it to the AutoCompleteTextView
+ArrayAdapter<String> adapter =
new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, countries);
textView.setAdapter(adapter);
Android offers a sophisticated and powerful componentized model for building your UI,
-based on the fundamental layout classes: {@link android.view.View} and
-{@link android.view.ViewGroup}. To start with, the platform includes a variety of prebuilt
-View and ViewGroup subclasses — called widgets and layouts, respectively —
+
Android offers a sophisticated and powerful componentized model for building your UI,
+based on the fundamental layout classes: {@link android.view.View} and
+{@link android.view.ViewGroup}. To start with, the platform includes a variety of prebuilt
+View and ViewGroup subclasses — called widgets and layouts, respectively —
that you can use to construct your UI.
-
A partial list of available widgets includes {@link android.widget.Button Button},
-{@link android.widget.TextView TextView},
-{@link android.widget.EditText EditText},
+
A partial list of available widgets includes {@link android.widget.Button Button},
+{@link android.widget.TextView TextView},
+{@link android.widget.EditText EditText},
{@link android.widget.ListView ListView},
-{@link android.widget.CheckBox CheckBox},
-{@link android.widget.RadioButton RadioButton},
-{@link android.widget.Gallery Gallery},
-{@link android.widget.Spinner Spinner}, and the more special-purpose
-{@link android.widget.AutoCompleteTextView AutoCompleteTextView},
+{@link android.widget.CheckBox CheckBox},
+{@link android.widget.RadioButton RadioButton},
+{@link android.widget.Gallery Gallery},
+{@link android.widget.Spinner Spinner}, and the more special-purpose
+{@link android.widget.AutoCompleteTextView AutoCompleteTextView},
{@link android.widget.ImageSwitcher ImageSwitcher}, and
{@link android.widget.TextSwitcher TextSwitcher}.
-
Among the layouts available are {@link android.widget.LinearLayout LinearLayout},
-{@link android.widget.FrameLayout FrameLayout}, {@link android.widget.RelativeLayout RelativeLayout},
+
Among the layouts available are {@link android.widget.LinearLayout LinearLayout},
+{@link android.widget.FrameLayout FrameLayout}, {@link android.widget.RelativeLayout RelativeLayout},
and others. For more examples, see Common Layout Objects.
-
If none of the prebuilt widgets or layouts meets your needs, you can create your own View subclass.
-If you only need to make small adjustments to an existing widget or layout, you can simply subclass
+
If none of the prebuilt widgets or layouts meets your needs, you can create your own View subclass.
+If you only need to make small adjustments to an existing widget or layout, you can simply subclass
the widget or layout and override its methods.
-
Creating your own View subclasses gives you precise control over the appearance and function
-of a screen element. To give an idea of the control you get with custom views, here are some
+
Creating your own View subclasses gives you precise control over the appearance and function
+of a screen element. To give an idea of the control you get with custom views, here are some
examples of what you could do with them:
-
+
You could create a completely custom-rendered View type, for example a "volume
@@ -60,7 +60,7 @@ examples of what you could do with them:
You could override the way that an EditText component is rendered on the screen
- (the Notepad Tutorial uses this to good effect,
+ (the Notepad Tutorial uses this to good effect,
to create a lined-notepad page).
@@ -69,7 +69,7 @@ examples of what you could do with them:
-The sections below explain how to create custom Views and use them in your application.
+The sections below explain how to create custom Views and use them in your application.
For detailed reference information, see the {@link android.view.View} class.
@@ -77,26 +77,26 @@ For detailed reference information, see the {@link android.view.View} class. Here is a high level overview of what you need to know to get started in creating your own
View components:
-
+
- Extend an existing {@link android.view.View View} class or subclass
+ Extend an existing {@link android.view.View View} class or subclass
with your own class.
- Override some of the methods from the superclass. The superclass methods
+ Override some of the methods from the superclass. The superclass methods
to override start with 'on', for
- example, {@link android.view.View#onDraw onDraw()},
- {@link android.view.View#onMeasure onMeasure()}, and
+ example, {@link android.view.View#onDraw onDraw()},
+ {@link android.view.View#onMeasure onMeasure()}, and
{@link android.view.View#onKeyDown onKeyDown()}.
- This is similar to the on... events in {@link android.app.Activity Activity}
+ This is similar to the on... events in {@link android.app.Activity Activity}
or {@link android.app.ListActivity ListActivity}
that you override for lifecycle and other functionality hooks.
- Use your new extension class. Once completed, your new extension class
+ Use your new extension class. Once completed, your new extension class
can be used in place of the view upon which it was based.
-
+
Tip:
Extension classes can be defined as inner classes inside the activities
that use them. This is useful because it controls access to them but
@@ -119,7 +119,7 @@ way you like, limited perhaps only by your imagination, the size of the
screen, and the available processing power (remember that ultimately your
application might have to run on something with significantly less power
than your desktop workstation).
-
To create a fully customized component:
+
To create a fully customized component:
The most generic view you can extend is, unsurprisingly, {@link
@@ -170,11 +170,11 @@ slightly more complex by the requirements of limits from the parent
(which are passed in to the onMeasure() method) and by the
requirement to call the setMeasuredDimension() method with the
measured width and height once they have been calculated. If you fail to
-call this method from an overridden onMeasure() method, the
+call this method from an overridden onMeasure() method, the
result will be an exception at measurement time.
-
At a high level, implementing onMeasure() looks something
+
At a high level, implementing onMeasure() looks something
like this:
-
+
The overridden onMeasure() method is called with width and
@@ -193,7 +193,7 @@ result will be an exception at measurement time.
measurement width and height which will be required to render the
component. It should try to stay within the specifications passed in,
although it can choose to exceed them (in this case, the parent can
- choose what to do, including clipping, scrolling, throwing an exception,
+ choose what to do, including clipping, scrolling, throwing an exception,
or asking the onMeasure() to try again, perhaps with
different measurement specifications).
@@ -212,7 +212,7 @@ Here's a summary of some of the other standard methods that the framework calls
Category
Methods
Description
-
+
Creation
@@ -228,7 +228,7 @@ Here's a summary of some of the other standard methods that the framework calls
Called after a view and all of its children has been inflated
from XML.
-
+
Layout
{@link android.view.View#onMeasure}
@@ -247,14 +247,14 @@ Here's a summary of some of the other standard methods that the framework calls
Called when the size of this view has changed.
-
+
Drawing
{@link android.view.View#onDraw}
Called when the view should render its content.
-
+
Event processing
{@link android.view.View#onKeyDown}
@@ -265,58 +265,58 @@ Here's a summary of some of the other standard methods that the framework calls
{@link android.view.View#onKeyUp}
Called when a key up event occurs.
-
+
{@link android.view.View#onTrackballEvent}
Called when a trackball motion event occurs.
-
+
{@link android.view.View#onTouchEvent}
Called when a touch screen motion event occurs.
-
-
+
+
Focus
{@link android.view.View#onFocusChanged}
Called when the view gains or loses focus.
-
+
{@link android.view.View#onWindowFocusChanged}
Called when the window containing the view gains or loses focus.
Called when the visibility of the window containing the view
has changed.
-
+
-
+
A Custom View Example
-
The CustomView sample in the
+
The CustomView sample in the
API Demos provides an example
of a customized View. The custom View is defined in the
LabelView
@@ -359,9 +359,9 @@ combination of a single line EditText field and an adjacent button with an attac
something from the list, it populates the EditText field, but the user can
also type something directly into the EditText if they prefer.
In Android, there are actually two other Views readily available to do
-this: {@link android.widget.Spinner Spinner} and
-{@link android.widget.AutoCompleteTextView AutoCompleteTextView}, but
-regardless, the concept of a Combo Box makes an easy-to-understand
+this: {@link android.widget.Spinner Spinner} and
+{@link android.widget.AutoCompleteTextView AutoCompleteTextView}, but
+regardless, the concept of a Combo Box makes an easy-to-understand
example.
To create a compound component:
@@ -397,7 +397,7 @@ example.
In the case of extending a Layout, you don't need to override the
onDraw() and onMeasure() methods since the
- layout will have default behavior that will likely work just fine. However,
+ layout will have default behavior that will likely work just fine. However,
you can still override them if you need to.
@@ -409,7 +409,7 @@ example.
To summarize, the use of a Layout as the basis for a Custom Control has a
number of advantages, including:
-
+
You can specify the layout using the declarative XML files just like
@@ -433,7 +433,7 @@ number of advantages, including:
SpeechView which extends LinearLayout to make a component for displaying
Speech quotes. The corresponding classes in the sample code are
List4.java and List6.java.
-
+
Modifying an Existing View Type
@@ -450,7 +450,7 @@ samples. This demonstrates many aspects of using the Android platform, among
them is extending an EditText View to make a lined notepad. This is not a
perfect example, and the APIs for doing this might change from this early
preview, but it does demonstrate the principles.
-
If you haven't done so already, import the
+
If you haven't done so already, import the
NotePad sample into Android Studio (or
just look at the source using the link provided). In particular look at the definition of
MyEditText in the The Definition
As always, the super is called first. Furthermore,
+
As always, the super is called first. Furthermore,
this is not a default constructor, but a parameterized one. The
EditText is created with these parameters when it is inflated from an
XML layout file, thus, our constructor needs to both take them and pass them
@@ -496,7 +496,7 @@ file.
Overridden Methods
-
In this example, there is only one method to be overridden:
+
In this example, there is only one method to be overridden:
onDraw() — but there could easily be others needed when you
create your own custom components.
For the NotePad sample, overriding the onDraw() method allows
@@ -513,7 +513,7 @@ file.
The custom component is created as a generic view in the XML, and
@@ -531,7 +531,7 @@ file.
NoteEditor$MyEditText notation which is a standard way to
refer to inner classes in the Java programming language.
If your custom View component is not defined as an inner class, then you can,
- alternatively, declare the View component
+ alternatively, declare the View component
with the XML element name, and exclude the class attribute. For example:
The set...Button() methods require a title for the button (supplied
-by a string resource) and a
-{@link android.content.DialogInterface.OnClickListener} that defines the action to take
+by a string resource) and a
+{@link android.content.DialogInterface.OnClickListener} that defines the action to take
when the user presses the button.
There are three different action buttons you can add:
@@ -251,7 +251,7 @@ when the user presses the button.
Neutral
You should use this when the user may not want to proceed with the action,
but doesn't necessarily want to cancel. It appears between the positive and negative
- buttons. For example, the action might be "Remind me later."
+ buttons. For example, the action might be "Remind me later."
You can add only one of each button type to an {@link
@@ -274,7 +274,7 @@ A dialog with a title and list.
A persistent multiple-choice list (checkboxes)
-
To create a single-choice list like the one in figure 3,
+
To create a single-choice list like the one in figure 3,
use the {@link android.app.AlertDialog.Builder#setItems setItems()} method:
@@ -294,7 +294,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Because the list appears in the dialog's content area,
the dialog cannot show both a message and a list and you should set a title for the
-dialog with {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
+dialog with {@link android.app.AlertDialog.Builder#setTitle setTitle()}.
To specify the items for the list, call {@link
android.app.AlertDialog.Builder#setItems setItems()}, passing an array.
Alternatively, you can specify a list using {@link
@@ -320,11 +320,11 @@ A list of multiple-choice items.
Adding a persistent multiple-choice or single-choice list
-
To add a list of multiple-choice items (checkboxes) or
+
To add a list of multiple-choice items (checkboxes) or
single-choice items (radio buttons), use the
{@link android.app.AlertDialog.Builder#setMultiChoiceItems(Cursor,String,String,
-DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} or
-{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+DialogInterface.OnMultiChoiceClickListener) setMultiChoiceItems()} or
+{@link android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} methods, respectively.
For example, here's how you can create a multiple-choice list like the
@@ -349,7 +349,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
// If the user checked the item, add it to the selected items
mSelectedItems.add(which);
} else if (mSelectedItems.contains(which)) {
- // Else, if the item is already in the array, remove it
+ // Else, if the item is already in the array, remove it
mSelectedItems.remove(Integer.valueOf(which));
}
}
@@ -376,7 +376,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
Although both a traditional list and a list with radio buttons
provide a "single choice" action, you should use {@link
-android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
+android.app.AlertDialog.Builder#setSingleChoiceItems(int,int,DialogInterface.OnClickListener)
setSingleChoiceItems()} if you want to persist the user's choice.
That is, if opening the dialog again later should indicate what the user's current choice is,
then you create a list with radio buttons.
@@ -445,7 +445,7 @@ you should change its font family to {@code "sans-serif"} so that both text fiel
a matching font style.
To inflate the layout in your {@link android.support.v4.app.DialogFragment},
-get a {@link android.view.LayoutInflater} with
+get a {@link android.view.LayoutInflater} with
{@link android.app.Activity#getLayoutInflater()} and call
{@link android.view.LayoutInflater#inflate inflate()}, where the first parameter
is the layout resource ID and the second parameter is a parent view for the layout.
@@ -473,7 +473,7 @@ public Dialog onCreateDialog(Bundle savedInstanceState) {
public void onClick(DialogInterface dialog, int id) {
LoginDialogFragment.this.getDialog().cancel();
}
- });
+ });
return builder.create();
}
@@ -508,7 +508,7 @@ interface through which it delivers the events back to the host activity:
public class NoticeDialogFragment extends DialogFragment {
-
+
/* The activity that creates an instance of this dialog fragment must
* implement this interface in order to receive event callbacks.
* Each method passes the DialogFragment in case the host needs to query it. */
@@ -516,10 +516,10 @@ public class NoticeDialogFragment extends DialogFragment {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
-
+
// Use this instance of the interface to deliver action events
NoticeDialogListener mListener;
-
+
// Override the Fragment.onAttach() method to instantiate the NoticeDialogListener
@Override
public void onAttach(Activity activity) {
@@ -546,7 +546,7 @@ events through an implementation of the {@code NoticeDialogListener} interface:<
public class MainActivity extends FragmentActivity
implements NoticeDialogFragment.NoticeDialogListener{
...
-
+
public void showNoticeDialog() {
// Create an instance of the dialog fragment and show it
DialogFragment dialog = new NoticeDialogFragment();
@@ -659,7 +659,7 @@ public class CustomDialogFragment extends DialogFragment {
// Inflate the layout to use as dialog or embedded fragment
return inflater.inflate(R.layout.purchase_items, container, false);
}
-
+
/** The system calls this only when creating the layout in a dialog. */
@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
@@ -681,7 +681,7 @@ or a fullscreen UI, based on the screen size:
public void showDialog() {
FragmentManager fragmentManager = getSupportFragmentManager();
CustomDialogFragment newFragment = new CustomDialogFragment();
-
+
if (mIsLargeLayout) {
// The device is using a large layout, so show the fragment as a dialog
newFragment.show(fragmentManager, "dialog");
@@ -781,7 +781,7 @@ android.support.v4.app.DialogFragment#onDismiss onDismiss()} method in your {@li
android.support.v4.app.DialogFragment}.
You can also cancel a dialog. This is a special event that indicates the user
-explicitly left the dialog without completing the task. This occurs if the user presses the
+explicitly left the dialog without completing the task. This occurs if the user presses the
Back button, touches the screen outside the dialog area,
or if you explicitly call {@link android.app.Dialog#cancel()} on the {@link
android.app.Dialog} (such as in response to a "Cancel" button in the dialog).
diff --git a/docs/html/guide/topics/ui/drag-drop.jd b/docs/html/guide/topics/ui/drag-drop.jd
index 4eb54f2325682..8871c87f4f258 100644
--- a/docs/html/guide/topics/ui/drag-drop.jd
+++ b/docs/html/guide/topics/ui/drag-drop.jd
@@ -978,7 +978,7 @@ protected class myDragEventListener implements View.OnDragListener {
Log.e("DragDrop Example","Unknown action type received by OnDragListener.");
break;
}
-
+
return false;
}
};
diff --git a/docs/html/guide/topics/ui/how-android-draws.jd b/docs/html/guide/topics/ui/how-android-draws.jd
index 168f77b265cfa..79563692d493b 100644
--- a/docs/html/guide/topics/ui/how-android-draws.jd
+++ b/docs/html/guide/topics/ui/how-android-draws.jd
@@ -4,18 +4,18 @@ parent.link=index.html
@jd:body
-
When an {@link android.app.Activity} receives focus, it will be requested to
+
When an {@link android.app.Activity} receives focus, it will be requested to
draw its layout.
-The Android framework will handle the procedure for drawing, but the
+The Android framework will handle the procedure for drawing, but the
{@link android.app.Activity} must provide
the root node of its layout hierarchy.
-
Drawing begins with the root node of the layout. It is requested to measure and
-draw the layout tree. Drawing is handled by walking the tree and rendering each
-{@link android.view.View} that intersects the invalid region. In turn, each
+
Drawing begins with the root node of the layout. It is requested to measure and
+draw the layout tree. Drawing is handled by walking the tree and rendering each
+{@link android.view.View} that intersects the invalid region. In turn, each
{@link android.view.ViewGroup} is responsible for requesting
-each of its children to be drawn
-(with the {@link android.view.View#draw(Canvas) draw()} method)
+each of its children to be drawn
+(with the {@link android.view.View#draw(Canvas) draw()} method)
and each {@link android.view.View} is responsible for drawing itself.
Because the tree is traversed in-order,
this means that parents will be drawn before (i.e., behind) their children, with
@@ -24,55 +24,55 @@ and each {@link android.view.View} is responsible for drawing itself.
-
The framework will not draw {@link android.view.View} objects that are not
-in the invalid region, and also
+
The framework will not draw {@link android.view.View} objects that are not
+in the invalid region, and also
will take care of drawing the {@link android.view.View} background for you.
-
You can force a {@link android.view.View} to draw, by calling
+
You can force a {@link android.view.View} to draw, by calling
{@link android.view.View#invalidate()}.
- Drawing the layout is a two pass process: a measure pass and a layout pass.
-The measuring pass is implemented in {@link android.view.View#measure(int, int)}
-and is a top-down traversal of the {@link android.view.View} tree. Each {@link android.view.View}
+ Drawing the layout is a two pass process: a measure pass and a layout pass.
+The measuring pass is implemented in {@link android.view.View#measure(int, int)}
+and is a top-down traversal of the {@link android.view.View} tree. Each {@link android.view.View}
pushes dimension specifications down the tree
- during the recursion. At the end of the measure pass, every
+ during the recursion. At the end of the measure pass, every
{@link android.view.View} has stored
its measurements. The second pass happens in
{@link android.view.View#layout(int,int,int,int)} and is also top-down. During
this pass each parent is responsible for positioning all of its children
using the sizes computed in the measure pass.
-
+
- When a {@link android.view.View} object's
-{@link android.view.View#measure(int, int) measure()} method
+ When a {@link android.view.View} object's
+{@link android.view.View#measure(int, int) measure()} method
returns, its {@link android.view.View#getMeasuredWidth()} and
- {@link android.view.View#getMeasuredHeight()} values must be set, along
- with those for all of that {@link android.view.View} object's descendants.
-A {@link android.view.View} object's measured width and
-measured height values must respect the constraints imposed by the
+ {@link android.view.View#getMeasuredHeight()} values must be set, along
+ with those for all of that {@link android.view.View} object's descendants.
+A {@link android.view.View} object's measured width and
+measured height values must respect the constraints imposed by the
{@link android.view.View} object's parents. This guarantees
that at the end of the measure pass, all parents accept all of their
- children's measurements. A parent {@link android.view.View} may call
+ children's measurements. A parent {@link android.view.View} may call
{@link android.view.View#measure(int, int) measure()} more than once on
its children. For example, the parent may measure each child once with
unspecified dimensions to find out how big they want to be, then call
- {@link android.view.View#measure(int, int) measure()} on them again with
+ {@link android.view.View#measure(int, int) measure()} on them again with
actual numbers if the sum of all the children's
- unconstrained sizes is too big or too small (that is, if the children
+ unconstrained sizes is too big or too small (that is, if the children
don't agree among themselves
- as to how much space they each get, the parent will intervene and set
+ as to how much space they each get, the parent will intervene and set
the rules on the second pass).
-
+
- To initiate a layout, call {@link android.view.View#requestLayout}.
+ To initiate a layout, call {@link android.view.View#requestLayout}.
This method is typically
- called by a {@link android.view.View} on itself
+ called by a {@link android.view.View} on itself
when it believes that is can no longer fit within
its current bounds.
@@ -80,54 +80,54 @@ when it believes that is can no longer fit within
The measure pass uses two classes to communicate dimensions. The
- {@link android.view.ViewGroup.LayoutParams} class is used by
+ {@link android.view.ViewGroup.LayoutParams} class is used by
{@link android.view.View} objects to tell their parents how they
- want to be measured and positioned. The base
+ want to be measured and positioned. The base
{@link android.view.ViewGroup.LayoutParams} class just
- describes how big the {@link android.view.View} wants to be for both
+ describes how big the {@link android.view.View} wants to be for both
width and height. For each
dimension, it can specify one of:
{@link android.view.ViewGroup.LayoutParams#MATCH_PARENT MATCH_PARENT},
which means the {@link android.view.View} wants to be as big as its parent
(minus padding)
{@link android.view.ViewGroup.LayoutParams#WRAP_CONTENT WRAP_CONTENT},
which means that the {@link android.view.View} wants to be just big enough to
enclose its content (plus padding).
-
There are subclasses of {@link android.view.ViewGroup.LayoutParams} for
+
There are subclasses of {@link android.view.ViewGroup.LayoutParams} for
different subclasses of {@link android.view.ViewGroup}.
- For example, {@link android.widget.RelativeLayout} has its own subclass of
+ For example, {@link android.widget.RelativeLayout} has its own subclass of
{@link android.view.ViewGroup.LayoutParams}, which includes
- the ability to center child {@link android.view.View} objects
+ the ability to center child {@link android.view.View} objects
horizontally and vertically.
-
+
- {@link android.view.View.MeasureSpec MeasureSpec} objects are used to push
+ {@link android.view.View.MeasureSpec MeasureSpec} objects are used to push
requirements down the tree from parent to
- child. A {@link android.view.View.MeasureSpec MeasureSpec} can be in one of
+ child. A {@link android.view.View.MeasureSpec MeasureSpec} can be in one of
three modes:
-
{@link android.view.View.MeasureSpec#UNSPECIFIED UNSPECIFIED}: This is
+
{@link android.view.View.MeasureSpec#UNSPECIFIED UNSPECIFIED}: This is
used by a parent to determine the desired dimension
- of a child {@link android.view.View}. For example, a
-{@link android.widget.LinearLayout} may call
+ of a child {@link android.view.View}. For example, a
+{@link android.widget.LinearLayout} may call
{@link android.view.View#measure(int, int) measure()} on its child
- with the height set to {@link android.view.View.MeasureSpec#UNSPECIFIED UNSPECIFIED}
-and a width of {@link android.view.View.MeasureSpec#EXACTLY EXACTLY} 240 to
-find out how tall the child {@link android.view.View} wants to be given a
+ with the height set to {@link android.view.View.MeasureSpec#UNSPECIFIED UNSPECIFIED}
+and a width of {@link android.view.View.MeasureSpec#EXACTLY EXACTLY} 240 to
+find out how tall the child {@link android.view.View} wants to be given a
width of 240 pixels.
-
{@link android.view.View.MeasureSpec#EXACTLY EXACTLY}: This is used
+
{@link android.view.View.MeasureSpec#EXACTLY EXACTLY}: This is used
by the parent to impose an exact size on the
child. The child must use this size, and guarantee that all of its
descendants will fit within this size.
-
{@link android.view.View.MeasureSpec#AT_MOST AT MOST}: This is used by
+
{@link android.view.View.MeasureSpec#AT_MOST AT MOST}: This is used by
the parent to impose a maximum size on the
child. The child must guarantee that it and all of its descendants will fit
within this size.
-
+
diff --git a/docs/html/guide/topics/ui/index.jd b/docs/html/guide/topics/ui/index.jd
index 0725eb73defc0..ccdf200ecac61 100644
--- a/docs/html/guide/topics/ui/index.jd
+++ b/docs/html/guide/topics/ui/index.jd
@@ -1,6 +1,6 @@
page.title=User Interface
page.landing=true
-page.landing.intro=Your app's user interface is everything that the user can see and interact with. Android provides a variety of pre-built UI components such as structured layout objects and UI controls that allow you to build the graphical user interface for your app. Android also provides other UI modules for special interfaces such as dialogs, notifications, and menus.
+page.landing.intro=Your app's user interface is everything that the user can see and interact with. Android provides a variety of pre-built UI components such as structured layout objects and UI controls that allow you to build the graphical user interface for your app. Android also provides other UI modules for special interfaces such as dialogs, notifications, and menus.
page.landing.image=images/ui/ui_index.png
page.landing.next=overview.html
diff --git a/docs/html/guide/topics/ui/layout/grid.jd b/docs/html/guide/topics/ui/layout/grid.jd
index 3474f48c9d864..31f9b9ca4ead6 100644
--- a/docs/html/guide/topics/ui/layout/grid.jd
+++ b/docs/html/guide/topics/ui/layout/grid.jd
@@ -32,7 +32,7 @@ cells empty, but cells cannot span columns, as they can in HTML.
Each row has zero or more cells, each of which is defined by any kind of other View. So, the cells of a row may be
composed of a variety of View objects, like ImageView or TextView objects.
A cell may also be a ViewGroup object (for example, you can nest another TableLayout as a cell).
-
The following sample layout has two rows and two cells in each. The accompanying screenshot shows the
+
The following sample layout has two rows and two cells in each. The accompanying screenshot shows the
result, with cell borders displayed as dotted lines (added for visual effect).
@@ -71,7 +71,7 @@ result, with cell borders displayed as dotted lines (added for visual effect). <
Columns can be hidden, marked to stretch and fill the available screen space,
or can be marked as shrinkable to force the column to shrink until the table
- fits the screen. See the {@link android.widget.TableLayout TableLayout reference}
+ fits the screen. See the {@link android.widget.TableLayout TableLayout reference}
documentation for more details.
diff --git a/docs/html/guide/topics/ui/layout/linear.jd b/docs/html/guide/topics/ui/layout/linear.jd
index 7441782f5e6fd..4224d17d07a70 100644
--- a/docs/html/guide/topics/ui/layout/linear.jd
+++ b/docs/html/guide/topics/ui/layout/linear.jd
@@ -59,7 +59,7 @@ href="{@docRoot}reference/android/widget/LinearLayout.LayoutParams.html#attr_and
>{@code android:layout_weight} attribute.
This attribute assigns an "importance" value to a view in
terms of how much space it should occupy on the screen. A larger weight value allows it to expand
-to fill any remaining space in the parent view.
+to fill any remaining space in the parent view.
Child views can specify a weight value, and then any remaining space in the view group is
assigned to children in the proportion of their declared weight. Default
weight is zero.
diff --git a/docs/html/guide/topics/ui/layout/listview.jd b/docs/html/guide/topics/ui/layout/listview.jd
index 3c6e32ca41cfe..e6e5578e6fd88 100644
--- a/docs/html/guide/topics/ui/layout/listview.jd
+++ b/docs/html/guide/topics/ui/layout/listview.jd
@@ -80,7 +80,7 @@ public class ListViewLoader extends ListActivity
ContactsContract.Data.DISPLAY_NAME};
// This is the select criteria
- static final String SELECTION = "((" +
+ static final String SELECTION = "((" +
ContactsContract.Data.DISPLAY_NAME + " NOTNULL) AND (" +
ContactsContract.Data.DISPLAY_NAME + " != '' ))";
@@ -105,7 +105,7 @@ public class ListViewLoader extends ListActivity
// Create an empty adapter we will use to display the loaded data.
// We pass null for the cursor, then update it in onLoadFinished()
- mAdapter = new SimpleCursorAdapter(this,
+ mAdapter = new SimpleCursorAdapter(this,
android.R.layout.simple_list_item_1, null,
fromColumns, toViews, 0);
setListAdapter(mAdapter);
@@ -138,7 +138,7 @@ public class ListViewLoader extends ListActivity
mAdapter.swapCursor(null);
}
- @Override
+ @Override
public void onListItemClick(ListView l, View v, int position, long id) {
// Do something when a list item is clicked
}
diff --git a/docs/html/guide/topics/ui/layout/relative.jd b/docs/html/guide/topics/ui/layout/relative.jd
index ca5cb48380368..92735ae808bf1 100644
--- a/docs/html/guide/topics/ui/layout/relative.jd
+++ b/docs/html/guide/topics/ui/layout/relative.jd
@@ -38,7 +38,7 @@ make one below another, centered in the screen, centered left, and so on. By def
views are drawn at the top-left of the layout, so you must define the position of each view
using the various layout properties available from {@link
android.widget.RelativeLayout.LayoutParams}.
-
+
Some of the many layout properties available to views in a {@link android.widget.RelativeLayout}
include:
diff --git a/docs/html/guide/topics/ui/menus.jd b/docs/html/guide/topics/ui/menus.jd
index ad2aa9b8bf290..73dec2095dca8 100644
--- a/docs/html/guide/topics/ui/menus.jd
+++ b/docs/html/guide/topics/ui/menus.jd
@@ -77,9 +77,9 @@ activity. It's where you should place actions that have a global impact on the a
"Search," "Compose email," and "Settings."
A context menu is a floating menu that appears when the
user performs a long-click on an element. It provides actions that affect the selected content or
context frame.
@@ -88,7 +88,7 @@ action items that affect the selected content in a bar at the top of the screen
to select multiple items.
A popup menu displays a list of items in a vertical list that's anchored to the view that
invoked the menu. It's good for providing an overflow of actions that relate to specific content or
@@ -130,7 +130,7 @@ directory and build the menu with the following elements:
<item>
Creates a {@link android.view.MenuItem}, which represents a single item in a menu. This
element may contain a nested <menu> element in order to create a submenu.
-
+
<group>
An optional, invisible container for {@code <item>} elements. It allows you to
categorize menu items so they share properties such as active state and visibility. For more
@@ -224,7 +224,7 @@ the sixth item and the rest into the overflow menu, which the user can open by s
More.
If you've developed your application for Android 3.0 (API level 11) and
-higher, items from the options menu are available in the
+higher, items from the options menu are available in the
app bar. By default, the system
places all items in the action overflow, which the user can reveal with the action overflow icon on
the right side of the app bar (or by pressing the device Menu button, if available). To
@@ -343,7 +343,7 @@ again unless the menu is invalidated for some reason. However, you should use {@
android.app.Activity#onCreateOptionsMenu(Menu) onCreateOptionsMenu()} only to create the initial
menu state and not to make changes during the activity lifecycle.
-
If you want to modify the options menu based on
+
If you want to modify the options menu based on
events that occur during the activity lifecycle, you can do so in
the {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()} method. This
method passes you the {@link android.view.Menu} object as it currently exists so you can modify it,
@@ -360,7 +360,7 @@ presented in the app bar. When an event occurs and you want to perform a menu up
call {@link android.app.Activity#invalidateOptionsMenu invalidateOptionsMenu()} to request that the
system call {@link android.app.Activity#onPrepareOptionsMenu(Menu) onPrepareOptionsMenu()}.
-
Note:
+
Note:
You should never change items in the options menu based on the {@link android.view.View} currently
in focus. When in touch mode (when the user is not using a trackball or d-pad), views
cannot take focus, so you should never use focus as the basis for modifying
@@ -738,8 +738,8 @@ that shows a popup menu:
A toast provides simple feedback about an operation in a small popup.
It only fills the amount of space required for the message and the current
-activity remains visible and interactive.
-For example, navigating away from an email before you send it triggers a
-"Draft saved" toast to let you know that you can continue editing later.
+activity remains visible and interactive.
+For example, navigating away from an email before you send it triggers a
+"Draft saved" toast to let you know that you can continue editing later.
Toasts automatically disappear after a timeout.
-
If user response to a status message is required, consider instead using a
+
If user response to a status message is required, consider instead using a
Notification.
@@ -49,8 +49,8 @@ toast.show();
This example demonstrates everything you need for most toast notifications.
-You should rarely need anything else. You may, however, want to position the
-toast differently or even use your own layout instead of a simple text message.
+You should rarely need anything else. You may, however, want to position the
+toast differently or even use your own layout instead of a simple text message.
The following sections describe how you can do these things.
You can also chain your methods and avoid holding on to the Toast object, like this:
@@ -61,7 +61,7 @@ The following sections describe how you can do these things.
A standard toast notification appears near the bottom of the screen, centered horizontally.
You can change this position with the {@link android.widget.Toast#setGravity(int,int,int)}
-method. This accepts three parameters: a {@link android.view.Gravity} constant,
+method. This accepts three parameters: a {@link android.view.Gravity} constant,
an x-position offset, and a y-position offset.
For example, if you decide that the toast should appear in the top-left corner, you can set the
@@ -70,7 +70,7 @@ gravity like this:
If you want to nudge the position to the right, increase the value of the second parameter.
+
If you want to nudge the position to the right, increase the value of the second parameter.
To nudge it down, increase the value of the last parameter.
@@ -103,7 +103,7 @@ with the following XML (saved as toast_layout.xml):
android:textColor="#FFF"
/>
</LinearLayout>
-
+
Notice that the ID of the LinearLayout element is "toast_layout_root". You must use this
ID to inflate the layout from the XML, as shown here:
First, retrieve the {@link android.view.LayoutInflater} with
-{@link android.app.Activity#getLayoutInflater()}
+
First, retrieve the {@link android.view.LayoutInflater} with
+{@link android.app.Activity#getLayoutInflater()}
(or {@link android.content.Context#getSystemService(String) getSystemService()}),
-and then inflate the layout from XML using
+and then inflate the layout from XML using
{@link android.view.LayoutInflater#inflate(int, ViewGroup)}. The first parameter
is the layout resource ID and the second is the root View. You can use
-this inflated layout to find more View objects in the layout, so now capture and
+this inflated layout to find more View objects in the layout, so now capture and
define the content for the ImageView and TextView elements. Finally, create
a new Toast with {@link android.widget.Toast#Toast(Context)} and set some properties
of the toast, such as the gravity and duration. Then call
{@link android.widget.Toast#setView(View)} and pass it the inflated layout.
-You can now display the toast with your custom layout by calling
+You can now display the toast with your custom layout by calling
{@link android.widget.Toast#show()}.
-
Note: Do not use the public constructor for a Toast
+
Note: Do not use the public constructor for a Toast
unless you are going to define the layout with {@link android.widget.Toast#setView(View)}.
If you do not have a custom layout to use, you must use
{@link android.widget.Toast#makeText(Context,int,int)} to create the Toast.
For a complete guide to creating a UI layout, see XML
Layouts.
-
+
User Interface Components
You don't have to build all of your UI using {@link android.view.View} and {@link
diff --git a/docs/html/guide/topics/ui/settings.jd b/docs/html/guide/topics/ui/settings.jd
index 243c1c340eb32..9e304a3f603cc 100644
--- a/docs/html/guide/topics/ui/settings.jd
+++ b/docs/html/guide/topics/ui/settings.jd
@@ -84,7 +84,7 @@ href="{@docRoot}design/patterns/settings.html">Settings design guide.
Figure 1. Screenshots from the Android Messaging app's
-settings. Selecting an item defined by a {@link android.preference.Preference}
+settings. Selecting an item defined by a {@link android.preference.Preference}
opens an interface to change the setting.
@@ -230,7 +230,7 @@ android.preference.ListPreference}. Both items include the following three attri
{@code android:key}
This attribute is required for preferences that persist a data value. It specifies the unique
key (a string) the system uses when saving this setting's value in the {@link
-android.content.SharedPreferences}.
+android.content.SharedPreferences}.
The only instances in which this attribute is not required is when the preference is a
{@link android.preference.PreferenceCategory} or {@link android.preference.PreferenceScreen}, or the
preference specifies an {@link android.content.Intent} to invoke (with an
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
- <Preference
+ <Preference
android:title="@string/prefs_category_one"
android:summary="@string/prefs_summ_category_one" >
- <intent
+ <intent
android:targetPackage="com.example.prefs"
android:targetClass="com.example.prefs.SettingsActivity"
android:action="com.example.prefs.PREFS_ONE" />
</Preference>
- <Preference
+ <Preference
android:title="@string/prefs_category_two"
android:summary="@string/prefs_summ_category_two" >
- <intent
+ <intent
android:targetPackage="com.example.prefs"
android:targetClass="com.example.prefs.SettingsActivity"
android:action="com.example.prefs.PREFS_TWO" />
@@ -982,11 +982,11 @@ default positive and negative dialog buttons:
public class NumberPickerPreference extends DialogPreference {
public NumberPickerPreference(Context context, AttributeSet attrs) {
super(context, attrs);
-
+
setDialogLayoutResource(R.layout.numberpicker_dialog);
setPositiveButtonText(android.R.string.ok);
setNegativeButtonText(android.R.string.cancel);
-
+
setDialogIcon(null);
}
...
@@ -1201,7 +1201,7 @@ protected void onRestoreInstanceState(Parcelable state) {
// Cast state to custom BaseSavedState and pass to superclass
SavedState myState = (SavedState) state;
super.onRestoreInstanceState(myState.getSuperState());
-
+
// Set this Preference's widget to reflect the restored state
mNumberPicker.setValue(myState.value);
}
diff --git a/docs/html/guide/topics/ui/themes.jd b/docs/html/guide/topics/ui/themes.jd
index f932dbdec191c..436b789ea51fa 100644
--- a/docs/html/guide/topics/ui/themes.jd
+++ b/docs/html/guide/topics/ui/themes.jd
@@ -177,7 +177,7 @@ You're probably familiar with some already, such as {@link android.R.attr#layout
The best place to find properties that apply to a specific {@link android.view.View} is the
corresponding class reference, which lists all of the supported XML attributes. For example, all of the
attributes listed in the table of
-TextView XML
+TextView XML
attributes can be used in a style definition for a {@link android.widget.TextView} element (or one of
its subclasses). One of the attributes listed in the reference is {@code
@@ -279,14 +279,14 @@ does not use the android: namespace prefix.
Apply a theme to an Activity or application
To set a theme for all the activities of your application, open the {@code AndroidManifest.xml} file and
-edit the <application> tag to include the android:theme attribute with the
+edit the <application> tag to include the android:theme attribute with the
style name. For example:
<application android:theme="@style/CustomTheme">
-
If you want a theme applied to just one Activity in your application, then add the
+
If you want a theme applied to just one Activity in your application, then add the
android:theme attribute to the <activity> tag instead.
Just as Android provides other built-in resources, there are many pre-defined themes that you can use, to avoid
@@ -374,9 +374,9 @@ keeps your program code focused on application functionality, rather than style.
for you to change your theme programatically (perhaps based on a user preference), you can.
To set the theme in your program code, use the {@link android.content.ContextWrapper#setTheme(int)}
-method and pass it the theme resource ID. Note that, when doing so, you must be sure to set the theme before
-instantiating any Views in the context, for example, before calling
-setContentView(View) or inflate(int, ViewGroup). This ensures that
+method and pass it the theme resource ID. Note that, when doing so, you must be sure to set the theme before
+instantiating any Views in the context, for example, before calling
+setContentView(View) or inflate(int, ViewGroup). This ensures that
the system applies the same theme for all of your UI screens. Here's an example:
@@ -391,7 +391,7 @@ the system applies the same theme for all of your UI screens. Here's an example:
If you are considering loading a theme programmatically for the main
screen of your application, note that the theme would not be applied
in any animations the system would use to start the activity, which
-would take place before your application opens. In most cases, if
+would take place before your application opens. In most cases, if
you want to apply a theme to your main screen, doing so in XML
is a better approach.
diff --git a/docs/html/guide/topics/ui/ui-events.jd b/docs/html/guide/topics/ui/ui-events.jd
index 6d41b15f6c17e..7dd24a44fa89e 100644
--- a/docs/html/guide/topics/ui/ui-events.jd
+++ b/docs/html/guide/topics/ui/ui-events.jd
@@ -20,8 +20,8 @@ parent.link=index.html
When considering events within your user interface, the approach is to capture the events from
the specific View object that the user interacts with. The View class provides the means to do so.
-
Within the various View classes that you'll use to compose your layout, you may notice several public callback
-methods that look useful for UI events. These methods are called by the Android framework when the
+
Within the various View classes that you'll use to compose your layout, you may notice several public callback
+methods that look useful for UI events. These methods are called by the Android framework when the
respective action occurs on that object. For instance, when a View (such as a Button) is touched,
the onTouchEvent() method is called on that object. However, in order to intercept this, you must extend
the class and override the method. However, extending every View object
@@ -30,7 +30,7 @@ a collection of nested interfaces with callbacks that you can much more easily d
called event listeners, are your ticket to capturing the user interaction with your UI.
While you will more commonly use the event listeners to listen for user interaction, there may
-come a time when you do want to extend a View class, in order to build a custom component.
+come a time when you do want to extend a View class, in order to build a custom component.
Perhaps you want to extend the {@link android.widget.Button}
class to make something more fancy. In this case, you'll be able to define the default event behaviors for your
class using the class event handlers.
An event listener is an interface in the {@link android.view.View} class that contains a single
+
An event listener is an interface in the {@link android.view.View} class that contains a single
callback method. These methods will be called by the Android framework when the View to which the listener has
been registered is triggered by user interaction with the item in the UI.
@@ -46,27 +46,27 @@ been registered is triggered by user interaction with the item in the UI.
onClick()
-
From {@link android.view.View.OnClickListener}.
- This is called when the user either touches the item
+
From {@link android.view.View.OnClickListener}.
+ This is called when the user either touches the item
(when in touch mode), or focuses upon the item with the navigation-keys or trackball and
presses the suitable "enter" key or presses down on the trackball.
onLongClick()
-
From {@link android.view.View.OnLongClickListener}.
- This is called when the user either touches and holds the item (when in touch mode), or
+
From {@link android.view.View.OnLongClickListener}.
+ This is called when the user either touches and holds the item (when in touch mode), or
focuses upon the item with the navigation-keys or trackball and
presses and holds the suitable "enter" key or presses and holds down on the trackball (for one second).
onFocusChange()
-
From {@link android.view.View.OnFocusChangeListener}.
+
From {@link android.view.View.OnFocusChangeListener}.
This is called when the user navigates onto or away from the item, using the navigation-keys or trackball.
onKey()
-
From {@link android.view.View.OnKeyListener}.
+
From {@link android.view.View.OnKeyListener}.
This is called when the user is focused on the item and presses or releases a hardware key on the device.
onTouch()
-
From {@link android.view.View.OnTouchListener}.
+
From {@link android.view.View.OnTouchListener}.
This is called when the user performs an action qualified as a touch event, including a press, a release,
or any movement gesture on the screen (within the bounds of the item).
onCreateContextMenu()
-
From {@link android.view.View.OnCreateContextMenuListener}.
+
From {@link android.view.View.OnCreateContextMenuListener}.
This is called when a Context Menu is being built (as the result of a sustained "long click"). See the discussion
on context menus in the Menus
developer guide.
@@ -75,8 +75,8 @@ been registered is triggered by user interaction with the item in the UI.
These methods are the sole inhabitants of their respective interface. To define one of these methods
and handle your events, implement the nested interface in your Activity or define it as an anonymous class.
Then, pass an instance of your implementation
-to the respective View.set...Listener() method. (E.g., call
-{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}
+to the respective View.set...Listener() method. (E.g., call
+{@link android.view.View#setOnClickListener(View.OnClickListener) setOnClickListener()}
and pass it your implementation of the {@link android.view.View.OnClickListener OnClickListener}.)
The example below shows how to register an on-click listener for a Button.
@@ -121,17 +121,17 @@ public class ExampleActivity extends Activity implements OnClickListener {
no return value, but some other event listener methods must return a boolean. The reason
depends on the event. For the few that do, here's why:
-
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} -
- This returns a boolean to indicate whether you have consumed the event and it should not be carried further.
- That is, return true to indicate that you have handled the event and it should stop here;
+
{@link android.view.View.OnLongClickListener#onLongClick(View) onLongClick()} -
+ This returns a boolean to indicate whether you have consumed the event and it should not be carried further.
+ That is, return true to indicate that you have handled the event and it should stop here;
return false if you have not handled it and/or the event should continue to any other
on-click listeners.
{@link android.view.View.OnKeyListener#onKey(View,int,KeyEvent) onKey()} -
This returns a boolean to indicate whether you have consumed the event and it should not be carried further.
- That is, return true to indicate that you have handled the event and it should stop here;
+ That is, return true to indicate that you have handled the event and it should stop here;
return false if you have not handled it and/or the event should continue to any other
on-key listeners.
{@link android.view.View.OnTouchListener#onTouch(View,MotionEvent) onTouch()} -
This returns a boolean to indicate whether your listener consumes this event. The important thing is that
this event can have multiple actions that follow each other. So, if you return false when the
down action event is received, you indicate that you have not consumed the event and are also
@@ -142,7 +142,7 @@ depends on the event. For the few that do, here's why:
Remember that hardware key events are always delivered to the View currently in focus. They are dispatched starting from the top
of the View hierarchy, and then down, until they reach the appropriate destination. If your View (or a child of your View)
currently has focus, then you can see the event travel through the {@link android.view.View#dispatchKeyEvent(KeyEvent)
-dispatchKeyEvent()} method. As an alternative to capturing key events through your View, you can also receive
+dispatchKeyEvent()} method. As an alternative to capturing key events through your View, you can also receive
all of the events inside your Activity with {@link android.app.Activity#onKeyDown(int,KeyEvent) onKeyDown()}
and {@link android.app.Activity#onKeyUp(int,KeyEvent) onKeyUp()}.
@@ -176,19 +176,19 @@ including:
{@link android.view.View#onTouchEvent} - Called when a touch screen motion event occurs.
{@link android.view.View#onFocusChanged} - Called when the view gains or loses focus.
-
There are some other methods that you should be aware of, which are not part of the View class,
-but can directly impact the way you're able to handle events. So, when managing more complex events inside
+
There are some other methods that you should be aware of, which are not part of the View class,
+but can directly impact the way you're able to handle events. So, when managing more complex events inside
a layout, consider these other methods:
{@link android.app.Activity#dispatchTouchEvent(MotionEvent)
- Activity.dispatchTouchEvent(MotionEvent)} - This allows your {@link
+ Activity.dispatchTouchEvent(MotionEvent)} - This allows your {@link
android.app.Activity} to intercept all touch events before they are dispatched to the window.
{@link android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)
ViewGroup.onInterceptTouchEvent(MotionEvent)} - This allows a {@link
android.view.ViewGroup} to watch events as they are dispatched to child Views.
{@link android.view.ViewParent#requestDisallowInterceptTouchEvent(boolean)
ViewParent.requestDisallowInterceptTouchEvent(boolean)} - Call this
- upon a parent View to indicate that it should not intercept touch events with {@link
+ upon a parent View to indicate that it should not intercept touch events with {@link
android.view.ViewGroup#onInterceptTouchEvent(MotionEvent)}.
@@ -199,7 +199,7 @@ necessary to give focus to actionable items (like buttons) so the user can see
what will accept input. If the device has touch capabilities, however, and the user
begins interacting with the interface by touching it, then it is no longer necessary to
highlight items, or give focus to a particular View. Thus, there is a mode
-for interaction named "touch mode."
+for interaction named "touch mode."
For a touch-capable device, once the user touches the screen, the device
@@ -214,7 +214,7 @@ exit touch mode, and find a view to take focus. Now, the user may resume interac
with the user interface without touching the screen.
-The touch mode state is maintained throughout the entire system (all windows and activities).
+The touch mode state is maintained throughout the entire system (all windows and activities).
To query the current state, you can call
{@link android.view.View#isInTouchMode} to see whether the device is currently in touch mode.
@@ -254,10 +254,10 @@ the focus is leaving. Define the value of the attribute to be the id of the View
Ordinarily, in this vertical layout, navigating up from the first Button would not go
anywhere, nor would navigating down from the second Button. Now that the top Button has
-defined the bottom one as the nextFocusUp (and vice versa), the navigation focus will
+defined the bottom one as the nextFocusUp (and vice versa), the navigation focus will
cycle from top-to-bottom and bottom-to-top.
-
If you'd like to declare a View as focusable in your UI (when it is traditionally not),
+
If you'd like to declare a View as focusable in your UI (when it is traditionally not),
add the android:focusable XML attribute to the View, in your layout declaration.
Set the value true. You can also declare a View
as focusable while in Touch Mode with android:focusableInTouchMode.
@@ -282,7 +282,7 @@ as discussed in the Event Listeners section, above
the framework will take care of measuring, laying out, and drawing the tree
as appropriate.
-
+
Note: The entire View tree is single threaded. You must always be on
the UI thread when calling any method on any View.
If you are doing work on other threads and want to update the state of a View
diff --git a/docs/html/guide/webapps/debugging.jd b/docs/html/guide/webapps/debugging.jd
index a74797df3bd36..9e8e11337b73a 100755
--- a/docs/html/guide/webapps/debugging.jd
+++ b/docs/html/guide/webapps/debugging.jd
@@ -92,7 +92,7 @@ expect from other web browsers.
Using Console APIs in WebView
All the console APIs shown above are also
-supported when debugging in {@link android.webkit.WebView}.
+supported when debugging in {@link android.webkit.WebView}.
If you're targeting Android 2.1 (API level 7) and higher, you must
provide a {@link android.webkit.WebChromeClient}
that implements the {@link android.webkit.WebChromeClient#onConsoleMessage(String,int,String)
diff --git a/docs/html/guide/webapps/targeting.jd b/docs/html/guide/webapps/targeting.jd
index 4a2ea1773c952..10259b115b29d 100644
--- a/docs/html/guide/webapps/targeting.jd
+++ b/docs/html/guide/webapps/targeting.jd
@@ -108,7 +108,7 @@ should exactly match the device screen's width and that the ability to zoom shou
When optimizing your site for mobile devices, you should usually set the width to
-{@code "device-width"} so the size fits exactly on all devices, then use CSS media queries to
+{@code "device-width"} so the size fits exactly on all devices, then use CSS media queries to
flexibly adapt layouts to suit different screen sizes.
Note: You should disable user scaling only when you're certain
diff --git a/docs/html/license.jd b/docs/html/license.jd
index 4f4036b412117..e843c6b35e07b 100644
--- a/docs/html/license.jd
+++ b/docs/html/license.jd
@@ -9,7 +9,7 @@ excludeFromSuggestions=true
For the purposes of licensing, the content of this web site is divided
into two categories:
-
Documentation content, including both static documentation and content extracted from source
+
Documentation content, including both static documentation and content extracted from source
code modules, as well as sample code, and
All other site content
@@ -66,7 +66,7 @@ it as an audiobook for the visually impaired, or even translate it.
license, note that proprietary trademarks and brand features are not
included in that license.
-
Google's trademarks and other brand features (including the
+
Google's trademarks and other brand features (including the
stylized typeface logo) are not included
in the license.
@@ -74,7 +74,7 @@ Please see Brand Guidelines for
information about this usage.
-
In some cases, a page may include content, such as an image, that is not
+
In some cases, a page may include content, such as an image, that is not
covered by the license. In that case, we will label the content that is not licensed.
In addition, content linked from a page on this site is not covered
@@ -92,22 +92,22 @@ Proper attribution is required when you reuse or create modified
versions of content that appears on a page made available under the
terms of the Creative Commons Attribution license. On this site, the
requirement for attribution applies only to the non-documentation
-content, as described earlier in this document. The complete
-requirements for attribution can be found in section 4b of the
+content, as described earlier in this document. The complete
+requirements for attribution can be found in section 4b of the
Creative Commons legal code.
In practice we ask that you provide attribution to the Android Open
- Source project to the best of the ability of the medium in which you
- are producing the work. There are several typical ways in which this
+ Source project to the best of the ability of the medium in which you
+ are producing the work. There are several typical ways in which this
might apply:
Exact Reproductions
If your online work exactly reproduces text or images from this
site, in whole or in part, please include a paragraph at the bottom
- of your page that reads:
+ of your page that reads:
This beta SDK release contains a large number of bug fixes and improvements from the early-look SDKs.
+
This beta SDK release contains a large number of bug fixes and improvements from the early-look SDKs.
The sections below describe the highlights of the release.
New Features and Notable Changes
@@ -109,7 +109,7 @@ The sections below describe the highlights of the release.
Known issues/limitations for Graphical Layout Editor include:
-
+
Font display is very close but not equals to on-device rendering since the font engine in Java slightly differs from the font engine in Android. This should not have any impact on your layouts.
@@ -123,7 +123,7 @@ The sections below describe the highlights of the release.
No support for WebView, MapView and SurfaceView.
-
No UI support for <merge>, <include>, <ViewStub> elements. You can add these elements to your manifest using the xml editor only.
+
No UI support for <merge>, <include>, <ViewStub> elements. You can add these elements to your manifest using the xml editor only.
If a layout fails to render in a way that prevents the whole editor from opening, you can:
@@ -221,7 +221,7 @@ specify which port the emulator should bind to for the console. <port> mus
The DDMS utility has been refactored into library form. This is not of direct interest to application developers, but may be of interest to vendors interested in integrating the Android SDK into their products. Watch for more information about the ddmlib library soon.
-
For performance and maintainability reasons, some APIs were moved into separate modules that must be explicitly included in the application via a directive in AndroidManifest.xml. Notable APIs that fall into this category are the MapView, and the java.awt.* classes, which each now reside in separate modules that must be imported. Developers who overlook this requirement will see ClassNotFoundExceptions that seem spurious.
+
For performance and maintainability reasons, some APIs were moved into separate modules that must be explicitly included in the application via a directive in AndroidManifest.xml. Notable APIs that fall into this category are the MapView, and the java.awt.* classes, which each now reside in separate modules that must be imported. Developers who overlook this requirement will see ClassNotFoundExceptions that seem spurious.
Developers who use 'adb push' to install applications must now use 'adb install', since the full package manager is now implemented. 'adb push' will no longer work to install .apk files.
@@ -386,14 +386,14 @@ specify which port the emulator should bind to for the console. <port> mus
Emulator Console
-
Now provides support for emulating inbound SMS messages. The ADT plugin and DDMS provide integrated access to
-this capability. For more information about how to emulate inbound SMS from the console,
+
Now provides support for emulating inbound SMS messages. The ADT plugin and DDMS provide integrated access to
+this capability. For more information about how to emulate inbound SMS from the console,
see SMS Emulation.
Emulator
-
The default emulator skin has been changed to HVGA-P from QVGA-L. For information
-about emulator skins and how to load a specific skin when starting the emulator, see
+
The default emulator skin has been changed to HVGA-P from QVGA-L. For information
+about emulator skins and how to load a specific skin when starting the emulator, see
Using Emulator Skins.
Emulator support for multiple screen sizes/densities, including new
skins.
Android SDK and AVD Manager, a graphical UI to let you manage your
-SDK and AVD environments more easily. The tool lets you create and manage
+SDK and AVD environments more easily. The tool lets you create and manage
your Android Virtual
-Devices and download new SDK packages (such as platform versions and
+Devices and download new SDK packages (such as platform versions and
add-ons) into your environment.
Improved support for test packages in New Project Wizard
-
The reference documentation now offers a "Filter by API Level"
-capability that lets you display only the parts of the API that are actually
+
The reference documentation now offers a "Filter by API Level"
+capability that lets you display only the parts of the API that are actually
available to your application, based on the android:minSdkVersion
value the application declares in its manifest. For more information, see
Android API Levels
@@ -114,7 +114,7 @@ href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin for Eclipse.
Android SDK and AVD Manager
-
The SDK offers a new tool called Android SDK and AVD Manager that lets you
+
The SDK offers a new tool called Android SDK and AVD Manager that lets you
manage your SDK and AVD environments more efficiently.
Using the tool, you can quickly check what Android platforms, add-ons,
@@ -129,15 +129,15 @@ environment that were not included in the SDK package.
The tool also lets you quickly create new AVDs, manage
their properties, and run a target AVD from a single window.
-
If you are developing in Eclipse with ADT, you can access the Android SDK
+
If you are developing in Eclipse with ADT, you can access the Android SDK
and AVD Manager from the Window menu.
-
If you are developing in another IDE, you can access the Android SDK and
+
If you are developing in another IDE, you can access the Android SDK and
AVD Manager through the android command-line tool, located in the
<sdk>/tools directory. You can launch the tool with a graphical UI by
using the android command without specifying any options. You can
also simply double-click the android.bat (Windows) or android (OS X/Linux) file.
-You can still use android commands to create and manage AVDs,
+You can still use android commands to create and manage AVDs,
including AVDs with custom hardware configurations.
Integration with zipalign
@@ -160,9 +160,9 @@ manually from the command line if you choose.
If you are developing in Eclipse with ADT, support for
zipalign is integrated into the Export Wizard. When you use the
Wizard to export a signed application package, ADT signs and then automatically
-runs zipalign against the exported package. If you use the Wizard
-to export an unsigned application package, then it will not zipalign the
-package because zipalign must be performed only after the APK has been signed.
+runs zipalign against the exported package. If you use the Wizard
+to export an unsigned application package, then it will not zipalign the
+package because zipalign must be performed only after the APK has been signed.
You must manually sign and zipalign the package after export.
If you are developing using Ant and are compiling in release mode, the
build tools will automatically sign and then zipalign the
@@ -182,14 +182,14 @@ alignment.
Support for Test Packages in New Project Wizard
The New Project Wizard available in the ADT 0.9.3 now lets you add a test
-package containing Instrumentation or other classes of tests while you are
+package containing Instrumentation or other classes of tests while you are
creating or importing a new Android application project.
New USB Driver for Windows
If you are using Windows and want to develop or test your application on an
Android-powered device (such as the T-Mobile G1), you need an appropriate USB
-driver.
+driver.
The Windows version of the Android 1.6 SDK includes a new, WinUSB-based
driver that you can install. The driver is compatible with both 32- and 64-bit
@@ -241,19 +241,19 @@ only) has been fixed.
Android 1.5 SDK, Release 3
Provides an updated Android 1.5 system image that includes permissions
-fixes, as described below, and a new application — an IME for Japanese
-text input. Also provides the same set of developer tools included in the
+fixes, as described below, and a new application — an IME for Japanese
+text input. Also provides the same set of developer tools included in the
previous SDK, but with bug fixes and several new features.
Permissions Fixes
-
The latest version of the Android platform, deployable to
+
The latest version of the Android platform, deployable to
Android-powered devices, includes fixes to the permissions-checking
in certain areas of the framework. Specifically, the Android system
now properly checks and enforces several existing permissions where it
-did not do so in the previous release. Because of these changes in
-enforcement, you are strongly encouraged to test your application
-against the new Android 1.5 system image included in this SDK, to ensure
+did not do so in the previous release. Because of these changes in
+enforcement, you are strongly encouraged to test your application
+against the new Android 1.5 system image included in this SDK, to ensure
that it functions normally.
In particular, if your application uses any of the system areas listed below,
@@ -292,14 +292,14 @@ Google APIs add-on and the library it provides, see:
href="http://code.google.com/android/add-ons/google-apis">http://code.google.com/android/add-ons/google-apis
The SDK add-on architecture now lets device manufacturers specify a USB
-Vendor ID in their add-ons.
+Vendor ID in their add-ons.
The android tool provides a new command that scans SDK add-ons
for their USB Vendor IDs and makes them available to adb (OS X and Linux
versions of the SDK only). The command is android update adb. On
Windows versions of the SDK, a custom USB driver is included that supports the
"Google" and "HTC" Vendor IDs, which allow adb to recognize G1 and HTC
-Magic devices. For other devices, contact the device manufacturer
-to obtain a USB driver, especially if you have an SDK add-on that defines
+Magic devices. For other devices, contact the device manufacturer
+to obtain a USB driver, especially if you have an SDK add-on that defines
a new USB Vendor ID.
The telephony, sensor, and geo fix issues in the emulator are now
fixed.
@@ -329,12 +329,12 @@ changes include:
Multiple versions of the Android platform are included (Android 1.1,
Android 1.5). The tools are updated to let you deploy your application
-on any platform in the SDK, which helps you ensure forward-compatibility and,
+on any platform in the SDK, which helps you ensure forward-compatibility and,
if applicable, backward-compatibility.
Introduces Android
Virtual Devices — (AVD) configurations of options that you
run in the emulator to better model actual devices. Each AVD gets its
-own dedicated storage area, making it much easier to work with multiple emulators
+own dedicated storage area, making it much easier to work with multiple emulators
that are running concurrently.
Support for SDK add-ons, which extend the
Android SDK to give you access to one or more external Android libraries and/or
@@ -383,13 +383,13 @@ is similar to any of the Android platform targets included in the SDK — it
includes an external library, a system image, as well as custom emulator skins
and system properties. The add-on differs in that the Android platform it
provides may include customized UI, resources, or behaviors, a different set of
-preinstalled applications, or other similar modifications.
+preinstalled applications, or other similar modifications.
The SDK includes a single SDK add-on — the Google APIs add-on. The
Google APIs add-on gives your application access to the com.google.android.maps
-external library that is included on many (if not most) Android-powered devices.
+external library that is included on many (if not most) Android-powered devices.
The Google APIs add-on also includes a {@link android.location.Geocoder Geocoder}
-backend service implementation. For more information, see the "Maps External
+backend service implementation. For more information, see the "Maps External
Library" section below.
Android Virtual Devices (AVDs)
@@ -401,7 +401,7 @@ compatible system image. There are two types of targets:
Targets that represent core Android platform versions.
Targets that are SDK add-ons, which typically provide application access to
one or more external libraries and/or a customized (but compliant) system image
-that can run in the emulator.
+that can run in the emulator.
A new tool called "android" lets you discover what targets and AVDs are
@@ -427,7 +427,7 @@ href="http://code.google.com/android/add-ons/google-apis">http://code.google.com
For your convenience, the Google APIs add-on is included in the SDK.
-
For information about how to register for a Maps API Key, see
+
@@ -566,8 +566,8 @@ service and receive a Maps API Key, which you then add to your MapView
for authentication to the server.
Developers should note that the registration service for MapView is now
-active and Google Maps is actively enforcing the Maps API Key requirement.
-For information about how to register for a Maps API Key, see
+active and Google Maps is actively enforcing the Maps API Key requirement.
+For information about how to register for a Maps API Key, see
Obtaining a Maps API Key.
@@ -615,21 +615,21 @@ in Eclipse.
In some cases, you may encounter problems when using the browser on an
emulator started with the command-line option -http-proxy.
On the OSX platform, if you manually remove the ~/.android directory
-using rm -rf ~/.android, then try to run
-the emulator, it crashes. This happens because the emulator fails to create
+using rm -rf ~/.android, then try to run
+the emulator, it crashes. This happens because the emulator fails to create
a new .android directory before attempting to create the child SDK1.0 directory.
To work around this issue, manually create a new .android directory using
-mkdir ~/.android, then run the emulator. The emulator
+mkdir ~/.android, then run the emulator. The emulator
creates the SDK1.0 directory and starts normally.
-
We regret to inform developers that Android 1.1 will not include support
+
We regret to inform developers that Android 1.1 will not include support
for ARCNet network interfaces.
The final set of Intent patterns honored by Android 1.0 has not yet been
fully documented. Documentation will be provided in future releases.
In ADT Editor, you can add at most ten new resource values at a time,
-in a given res/values/*.xml, using the form in the Android Resources pane.
+in a given res/values/*.xml, using the form in the Android Resources pane.
If you add more than ten, the Android Resources pane will not display the
-attributes fields for the additional resource entries. To work around this
-problem, you can close the file in the editor and open it again, or you
+attributes fields for the additional resource entries. To work around this
+problem, you can close the file in the editor and open it again, or you
can edit the resource entries in the XML text mode.
The emulator's battery-control commands (power <option>)
are not working in this release.
@@ -657,7 +657,7 @@ href="{@docRoot}tools/sdk/eclipse-adt.html">ADT Plugin for Eclipse.
T-Mobile G1 Compatibility
-
This version of the SDK has been tested for compatibility with the first
+
This version of the SDK has been tested for compatibility with the first
Android-powered mobile device, the T-Mobile
G1.
@@ -679,7 +679,7 @@ href="http://code.google.com/android/add-ons/google-apis/mapkey.html">http://cod
Android-powered device (such as the T-Mobile G1), you need an appropriate USB
driver. For your convenience, the Windows version of the Android SDK includes a
USB driver that you can install, to let you develop on the device. The USB
-driver files are located in the <SDK>/usb_driver directory.
+driver files are located in the <SDK>/usb_driver directory.
@@ -694,23 +694,23 @@ change across versions, so were not suitable for use by applications. You can
still access the platform's styleable attributes from your resources or code. To
do so, declare a custom resource element using a
<declare-styleable> in your project's res/values/R.attrs
-file, then declare the attribute inside. For examples, see
+file, then declare the attribute inside. For examples, see
<sdk>/samples/ApiDemos/res/values/attrs.xml. For more information about
custom resources, see Custom
Layout Resources. Note that the android.R.styleable documentation is still
provided in the SDK, but only as a reference of the platform's styleable
attributes for the various elements.
-
The VM now properly ensures that private classes are not
+
The VM now properly ensures that private classes are not
available to applications through reflection. If you were using reflection
-to access private classes in a previous release, you will now get a run-time
+to access private classes in a previous release, you will now get a run-time
error.
The Settings and Email applications are now included in the SDK and
available in the emulator.
-
We regret to inform developers that SDK 1.0_r2 does not support MFM, RLL,
+
We regret to inform developers that SDK 1.0_r2 does not support MFM, RLL,
or Winchester hard disk drives.
-
In the emulator, the control key for enabling/disabling trackball mode
+
In the emulator, the control key for enabling/disabling trackball mode
is changed from Control-T to F6. You can also enter trackball mode temporarily
using the Delete key. While the key is pressed, you can send trackball events.
@@ -783,19 +783,19 @@ emulator started with the command-line option -http-proxy.
We regret to inform developers that Android 1.0 will not include support for
dot-matrix printers.
On the OSX platform, if you manually remove the ~/.android directory
-using rm -rf ~/.android, then try to run
-the emulator, it crashes. This happens because the emulator fails to create
+using rm -rf ~/.android, then try to run
+the emulator, it crashes. This happens because the emulator fails to create
a new .android directory before attempting to create the child SDK1.0 directory.
To work around this issue, manually create a new .android directory using
-mkdir ~/.android, then run the emulator. The emulator
+mkdir ~/.android, then run the emulator. The emulator
creates the SDK1.0 directory and starts normally.
The final set of Intent patterns honored by Android 1.0 has not yet been
fully documented. Documentation will be provided in future releases.
In ADT Editor, you can add at most ten new resource values at a time,
-in a given res/values/*.xml, using the form in the Android Resources pane.
+in a given res/values/*.xml, using the form in the Android Resources pane.
If you add more than ten, the Android Resources pane will not display the
-attributes fields for the additional resource entries. To work around this
-problem, you can close the file in the editor and open it again, or you
+attributes fields for the additional resource entries. To work around this
+problem, you can close the file in the editor and open it again, or you
can edit the resource entries in the XML text mode.
The emulator's battery-control commands (power <option>)
are not working in this release.
-
+
diff --git a/docs/html/topic/libraries/data-binding/index.jd b/docs/html/topic/libraries/data-binding/index.jd
index 293de51ea0001..ec6e58c15ca10 100644
--- a/docs/html/topic/libraries/data-binding/index.jd
+++ b/docs/html/topic/libraries/data-binding/index.jd
@@ -515,8 +515,8 @@ If you need to use an expression with a predicate (e.g. ternary), you can use
Avoid Complex Listeners
Listener expressions are very powerful and can make your code very easy to read.
-On the other hand, listeners containing complex expressions make your layouts hard to read and unmaintainable.
-These expressions should be as simple as passing available data from your UI to your callback method. You should implement
+On the other hand, listeners containing complex expressions make your layouts hard to read and unmaintainable.
+These expressions should be as simple as passing available data from your UI to your callback method. You should implement
any business logic inside the callback method that you invoked from the listener expression.
diff --git a/docs/html/topic/performance/optimizing-view-hierarchies.jd b/docs/html/topic/performance/optimizing-view-hierarchies.jd
index 1738acb049d64..27d3d163f853c 100644
--- a/docs/html/topic/performance/optimizing-view-hierarchies.jd
+++ b/docs/html/topic/performance/optimizing-view-hierarchies.jd
@@ -381,7 +381,7 @@ your hierarchy by switching over to an entirely different layout type.
For example, you may find that a {@link android.widget.TableLayout}
provides the same functionality as a more complex layout with many
-positional dependencies. In the N release of Android, the
+positional dependencies. In the N release of Android, the
{@code ConstraintLayout} class provides similar functionality to
{@link android.widget.RelativeLayout}, but at a significantly lower cost.
diff --git a/docs/html/topic/performance/scheduling.jd b/docs/html/topic/performance/scheduling.jd
index b6f0fdc1b230c..c11cf9b4a227b 100644
--- a/docs/html/topic/performance/scheduling.jd
+++ b/docs/html/topic/performance/scheduling.jd
@@ -264,7 +264,7 @@ Regardless of the solution you adopt, keep the following points in mind:
Internet-connectivity detection problems. A library or API may think the
Internet is available, but your service may not be accessible. Fail
gracefully and reschedule as few of your tasks as possible.
-
Depending on the conditions you assign for running a task,
+
Depending on the conditions you assign for running a task,
such as network availability, after the task is triggered, a
change may occur so that those conditions are no longer met.
In such a case, your operation may fail unexpectedly and repeatedly.
diff --git a/docs/html/training/accessibility/accessible-app.jd b/docs/html/training/accessibility/accessible-app.jd
index dd26febf09492..54c185c505296 100644
--- a/docs/html/training/accessibility/accessible-app.jd
+++ b/docs/html/training/accessibility/accessible-app.jd
@@ -55,7 +55,7 @@ href="https://play.google.com/store/apps/details?id=com.google.android.marvin.ta
If you have a label that's likely not to change during the lifecycle of the
application (such as "Pause" or "Purchase"), you can add it via the XML layout,
by setting a UI element's {@code android:contentDescription} attribute, like in this
example:
@@ -163,7 +163,7 @@ supported can be found in the {@link
android.view.accessibility.AccessibilityEvent} reference documentation.
As an example, if you want to extend an image view such that you can write
-captions by typing on the keyboard when it has focus, it makes sense to fire an
+captions by typing on the keyboard when it has focus, it makes sense to fire an
{@link android.view.accessibility.AccessibilityEvent#TYPE_VIEW_TEXT_CHANGED}
event, even though that's not normally built into image views. The code to
generate that event would look like this:
diff --git a/docs/html/training/accessibility/service.jd b/docs/html/training/accessibility/service.jd
index 5b99c46be67e8..9935c97ba61f4 100755
--- a/docs/html/training/accessibility/service.jd
+++ b/docs/html/training/accessibility/service.jd
@@ -67,7 +67,7 @@ public class MyAccessibilityService extends AccessibilityService {
Like any other service, you also declare it in the manifest file.
Remember to specify that it handles the {@code android.accessibilityservice} intent,
-so that the service is called when applications fire an
+so that the service is called when applications fire an
{@link android.view.accessibility.AccessibilityEvent}.
diff --git a/docs/html/training/animation/screen-slide.jd b/docs/html/training/animation/screen-slide.jd
index a68d475f18ee4..d953c0793f975 100644
--- a/docs/html/training/animation/screen-slide.jd
+++ b/docs/html/training/animation/screen-slide.jd
@@ -218,7 +218,7 @@ public class ScreenSlidePagerActivity extends FragmentActivity {
position of the page on the screen, which is obtained from the position parameter
of the {@link android.support.v4.view.ViewPager.PageTransformer#transformPage transformPage()} method.
-
The position parameter indicates where a given page is located relative to the center of the screen.
+
The position parameter indicates where a given page is located relative to the center of the screen.
It is a dynamic property that changes as the user scrolls through the pages. When a page fills the screen, its position value is 0.
When a page is drawn just off the right side of the screen, its position value is 1. If the user scrolls halfway between pages one and two, page one has a position of -0.5 and page two has a position of 0.5. Based on the position of the pages on the screen, you can create custom slide animations by setting page properties with methods such as {@link android.view.View#setAlpha setAlpha()}, {@link android.view.View#setTranslationX setTranslationX()}, or
{@link android.view.View#setScaleY setScaleY()}.
diff --git a/docs/html/training/animation/zoom.jd b/docs/html/training/animation/zoom.jd
index 6a38e7d8c71d4..60de70e8c02ce 100644
--- a/docs/html/training/animation/zoom.jd
+++ b/docs/html/training/animation/zoom.jd
@@ -297,13 +297,13 @@ private void zoomImageFromThumb(final View thumbView, int imageResId) {
set.play(ObjectAnimator
.ofFloat(expandedImageView, View.X, startBounds.left))
.with(ObjectAnimator
- .ofFloat(expandedImageView,
+ .ofFloat(expandedImageView,
View.Y,startBounds.top))
.with(ObjectAnimator
- .ofFloat(expandedImageView,
+ .ofFloat(expandedImageView,
View.SCALE_X, startScaleFinal))
.with(ObjectAnimator
- .ofFloat(expandedImageView,
+ .ofFloat(expandedImageView,
View.SCALE_Y, startScaleFinal));
set.setDuration(mShortAnimationDuration);
set.setInterpolator(new DecelerateInterpolator());
diff --git a/docs/html/training/app-indexing/deep-linking.jd b/docs/html/training/app-indexing/deep-linking.jd
index 2c4a1310fbf1e..a68e5a3cc4c12 100644
--- a/docs/html/training/app-indexing/deep-linking.jd
+++ b/docs/html/training/app-indexing/deep-linking.jd
@@ -69,7 +69,7 @@ in your manifest for deep linking. The URIs {@code “example://gizmos”} and
<!-- Accepts URIs that begin with "example://gizmos” -->
<data android:scheme="example"
android:host="gizmos" />
-
+
</intent-filter>
</activity>
diff --git a/docs/html/training/articles/perf-anr.jd b/docs/html/training/articles/perf-anr.jd
index bbebec5a83e10..2eda4fa679cae 100644
--- a/docs/html/training/articles/perf-anr.jd
+++ b/docs/html/training/articles/perf-anr.jd
@@ -64,10 +64,10 @@ concern.)
and Window Manager system services. Android will display the ANR dialog
for a particular application when it detects one of the following
conditions:
-
-
No response to an input event (such as key press or screen touch events)
+
+
No response to an input event (such as key press or screen touch events)
within 5 seconds.
-
A {@link android.content.BroadcastReceiver BroadcastReceiver}
+
A {@link android.content.BroadcastReceiver BroadcastReceiver}
hasn't finished executing within 10 seconds.
@@ -100,7 +100,7 @@ To post progress changes to the user, you can call
{@link android.os.AsyncTask#onProgressUpdate onProgressUpdate()} callback method. From your
implementation of {@link android.os.AsyncTask#onProgressUpdate onProgressUpdate()} (which
runs on the UI thread), you can notify the user. For example:
-
+
private class DownloadFilesTask extends AsyncTask<URL, Integer, Long> {
// Do the long-running work in here
@@ -127,14 +127,14 @@ private class DownloadFilesTask extends AsyncTask<URL, Integer, Long> {
}
}
-
+
To execute this worker thread, simply create an instance and
call {@link android.os.AsyncTask#execute execute()}:
-
+
new DownloadFilesTask().execute(url1, url2, url3);
-
+
Although it's more complicated than {@link android.os.AsyncTask}, you might want to instead
create your own {@link java.lang.Thread} or {@link android.os.HandlerThread} class. If you do,
@@ -143,7 +143,7 @@ android.os.Process#setThreadPriority Process.setThreadPriority()} and passing {@
android.os.Process#THREAD_PRIORITY_BACKGROUND}. If you don't set the thread to a lower priority
this way, then the thread could still slow down your app because it operates at the same priority
as the UI thread by default.
-
+
If you implement {@link java.lang.Thread} or {@link android.os.HandlerThread},
be sure that your UI thread does not block while waiting for the worker thread to
complete—do not call {@link java.lang.Thread#wait Thread.wait()} or
@@ -183,16 +183,16 @@ make your application seem responsive to users:
If your application is doing work in the background in response to
user input, show that progress is being made (such as with a {@link
android.widget.ProgressBar} in your UI).
-
+
For games specifically, do calculations for moves in a worker
thread.
-
+
If your application has a time-consuming initial setup phase, consider
showing a splash screen or rendering the main view as quickly as possible, indicate that
loading is in progress and fill the information asynchronously. In either case, you should
indicate somehow that progress is being made, lest the user perceive that
the application is frozen.
-
+
Use performance tools such as Systrace
and Traceview to determine bottlenecks
in your app's responsiveness.
diff --git a/docs/html/training/articles/perf-jni.jd b/docs/html/training/articles/perf-jni.jd
index 5a9fa1e04b463..8d2fd9b2ebb67 100644
--- a/docs/html/training/articles/perf-jni.jd
+++ b/docs/html/training/articles/perf-jni.jd
@@ -564,9 +564,9 @@ be aware of:
that looked through the weak globals table, the arguments, the locals
table, and the globals table in that order. The first time it found your
direct pointer, it would report that your reference was of the type it
- happened to be examining. This meant, for example, that if
+ happened to be examining. This meant, for example, that if
you called GetObjectRefType on a global jclass that happened
- to be the same as the jclass passed as an implicit argument to your static
+ to be the same as the jclass passed as an implicit argument to your static
native method, you'd get JNILocalRefType rather than
JNIGlobalRefType.
diff --git a/docs/html/training/articles/smp.jd b/docs/html/training/articles/smp.jd
index 0b45987558d68..a95931b536a9c 100644
--- a/docs/html/training/articles/smp.jd
+++ b/docs/html/training/articles/smp.jd
@@ -75,7 +75,7 @@ page.article=true
multiprocessor architectures. This document introduces issues that
can arise when writing code for symmetric multiprocessor systems in C, C++, and the Java
programming language (hereafter referred to simply as “Java” for the sake of
-brevity). It's intended as a primer for Android app developers, not as a complete
+brevity). It's intended as a primer for Android app developers, not as a complete
discussion on the subject. The focus is on the ARM CPU architecture.
If you’re in a hurry, you can skip the Theory section
diff --git a/docs/html/training/articles/user-data-overview.jd b/docs/html/training/articles/user-data-overview.jd
index 8715d36cb76c6..dc0df20fc06c3 100644
--- a/docs/html/training/articles/user-data-overview.jd
+++ b/docs/html/training/articles/user-data-overview.jd
@@ -266,4 +266,4 @@ href="#references" style="color:#777;padding-left:.1em;">1
href="http://stackoverflow.com/questions/24374701/alternative-to-read-phone-state-permission-for-getting-notified-of-call">source)
[2] Using Personal Examples to Improve Risk Communication for Security and Privacy Decisions, by M. Harbach, M. Hettig, S. Weber, and M. Smith. In Proceedings of ACM CHI 2014.
[3] Modeling Users’ Mobile App Privacy Preferences: Restoring Usability in a Sea of Permission Settings, by J. Lin B. Liu, N. Sadeh and J. Hong. In Proceedings of SOUPS 2014.
Tenets of Working
diff --git a/docs/html/training/basics/activity-lifecycle/index.jd b/docs/html/training/basics/activity-lifecycle/index.jd
index afeab867860c2..95ed21efe048e 100644
--- a/docs/html/training/basics/activity-lifecycle/index.jd
+++ b/docs/html/training/basics/activity-lifecycle/index.jd
@@ -41,7 +41,7 @@ class="button">Download the demo
lifecycle. For instance, when your
activity starts for the first time, it comes to the foreground of the system and receives user
focus. During this process, the Android system calls a series of lifecycle methods on the
-activity in which you set up the user interface and other components. If the user performs an
+activity in which you set up the user interface and other components. If the user performs an
action that starts another activity or switches to another app, the system calls another set of
lifecycle methods on your activity as it moves into the background (where the activity is no
longer visible, but the instance and its state remains intact).
@@ -57,7 +57,7 @@ android.app.Activity} instance receives and how you can use them so your activit
user expects and does not consume system resources when your activity doesn't need them.
Activities
@@ -32,7 +32,7 @@ class="button">Download the demo
-
During normal app use, the foreground activity is sometimes obstructed by other
+
During normal app use, the foreground activity is sometimes obstructed by other
visual components that cause the activity to pause. For example, when a semi-transparent
activity opens (such as one in the style of a dialog), the previous activity pauses. As long as the
activity is still partially visible but currently not the activity in focus, it remains paused.
@@ -60,7 +60,7 @@ system calls {@link android.app.Activity#onResume onResume()} (2).
Pause Your Activity
-
+
When the system calls {@link android.app.Activity#onPause()} for your activity, it
technically means your activity is still partially visible, but most often is an indication that
the user is leaving the activity and it will soon enter the Stopped state. You should usually use
diff --git a/docs/html/training/basics/activity-lifecycle/recreating.jd b/docs/html/training/basics/activity-lifecycle/recreating.jd
index a52d5fd61f178..60a337742df71 100644
--- a/docs/html/training/basics/activity-lifecycle/recreating.jd
+++ b/docs/html/training/basics/activity-lifecycle/recreating.jd
@@ -8,13 +8,13 @@ trainingnavtop=true
This lesson introduces the wireless radio state machine, explains how your app’s connectivity model interacts with it, and how you can minimize your data connection and use prefetching and bundling to minimize the battery drain associated with your data transfers.
This lesson will examine how your refresh frequency can be varied to best mitigate the effect of background updates on the underlying wireless radio state machine.
@@ -47,4 +47,4 @@ will want to jump to a lesson or not.-->
When it comes to impact on battery life, not all connection types are created equal. Not only does the Wi-Fi radio use significantly less battery than its wireless radio counterparts, but the radios used in different wireless radio technologies have different battery implications.
Optimizing Battery Life discusses how to build battery-efficient apps that modify their refresh frequency based on the state of the host device. That includes disabling background service updates when you lose connectivity and reducing the rate of updates when the battery level is low.
This lesson will examine how your refresh frequency can be varied to best mitigate the effect of background updates on the underlying wireless radio state machine.
-
-
Use Google Cloud Messaging as an Alternative to Polling
-
+
+
Use Google Cloud Messaging as an Alternative to Polling
+
Every time your app polls your server to check if an update is required, you activate the wireless radio, drawing power unnecessarily, for up to 20 seconds on a typical 3G connection.
Google Cloud Messaging for Android (GCM) is a lightweight mechanism used to transmit data from a server to a particular app instance. Using GCM, your server can notify your app running on a particular device that there is new data available for it.
GCM is implemented using a persistent TCP/IP connection. While it's possible to implement your own push service, it's best practice to use GCM. This minimizes the number of persistent connections and allows the platform to optimize bandwidth and minimize the associated impact on battery life.
-
Optimize Polling with Inexact Repeating Alarms and Exponential Backoffs
+
Optimize Polling with Inexact Repeating Alarms and Exponential Backoffs
Where polling is required, it's good practice to set the default data refresh frequency of your app as low as possible without detracting from the user experience.
One approach is to implement an exponential back-off pattern to reduce the frequency of your updates (and / or the degree of prefetching you perform) if the app hasn't been used since the previous update. It's often useful to assert a minimum update frequency and to reset the frequency whenever the app is used, for example:
diff --git a/docs/html/training/gestures/detector.jd b/docs/html/training/gestures/detector.jd
index 97f039c709a8a..0624e86335bce 100644
--- a/docs/html/training/gestures/detector.jd
+++ b/docs/html/training/gestures/detector.jd
@@ -48,48 +48,48 @@ phases to gesture detection:
Gathering data about touch events.
-
+
Interpreting the data to see if it meets the criteria for any of the
-gestures your app supports.
+gestures your app supports.
Support Library Classes
The examples in this lesson use the {@link android.support.v4.view.GestureDetectorCompat}
-and {@link android.support.v4.view.MotionEventCompat} classes. These classes are in the
+and {@link android.support.v4.view.MotionEventCompat} classes. These classes are in the
Support Library. You should use
-Support Library classes where possible to provide compatibility with devices
-running Android 1.6 and higher. Note that {@link android.support.v4.view.MotionEventCompat} is not a
-replacement for the {@link android.view.MotionEvent} class. Rather, it provides static utility
-methods to which you pass your {@link android.view.MotionEvent} object in order to receive
+Support Library classes where possible to provide compatibility with devices
+running Android 1.6 and higher. Note that {@link android.support.v4.view.MotionEventCompat} is not a
+replacement for the {@link android.view.MotionEvent} class. Rather, it provides static utility
+methods to which you pass your {@link android.view.MotionEvent} object in order to receive
the desired action associated with that event.
Gather Data
When a user places one or more fingers on the screen, this triggers the
-callback {@link android.view.View#onTouchEvent onTouchEvent()}
+callback {@link android.view.View#onTouchEvent onTouchEvent()}
on the View that received the touch events.
-For each sequence of touch events (position, pressure, size, addition of another finger, etc.)
+For each sequence of touch events (position, pressure, size, addition of another finger, etc.)
that is ultimately identified as a gesture,
{@link android.view.View#onTouchEvent onTouchEvent()} is fired several times.
The gesture starts when the user first touches the screen, continues as the system tracks
the position of the user's finger(s), and ends by capturing the final event of
-the user's fingers leaving the screen. Throughout this interaction,
-the {@link android.view.MotionEvent} delivered to {@link android.view.View#onTouchEvent onTouchEvent()}
-provides the details of every interaction. Your app can use the data provided by the {@link android.view.MotionEvent}
+the user's fingers leaving the screen. Throughout this interaction,
+the {@link android.view.MotionEvent} delivered to {@link android.view.View#onTouchEvent onTouchEvent()}
+provides the details of every interaction. Your app can use the data provided by the {@link android.view.MotionEvent}
to determine if a gesture it cares
about happened.
Capturing touch events for an Activity or View
-
To intercept touch events in an Activity or View, override
+
To intercept touch events in an Activity or View, override
the {@link android.view.View#onTouchEvent onTouchEvent()} callback.
-
The following snippet uses
+
The following snippet uses
{@link android.support.v4.view.MotionEventCompat#getActionMasked getActionMasked()}
-to extract the action the user performed from the {@code event} parameter. This gives you the raw
+to extract the action the user performed from the {@code event} parameter. This gives you the raw
data you need to determine if a gesture you care about occurred:
@@ -98,10 +98,10 @@ public class MainActivity extends Activity {
// This example shows an Activity, but you would use the same approach if
// you were subclassing a View.
@Override
-public boolean onTouchEvent(MotionEvent event){
-
+public boolean onTouchEvent(MotionEvent event){
+
int action = MotionEventCompat.getActionMasked(event);
-
+
switch(action) {
case (MotionEvent.ACTION_DOWN) :
Log.d(DEBUG_TAG,"Action was DOWN");
@@ -118,10 +118,10 @@ public boolean onTouchEvent(MotionEvent event){
case (MotionEvent.ACTION_OUTSIDE) :
Log.d(DEBUG_TAG,"Movement occurred outside bounds " +
"of current screen element");
- return true;
- default :
+ return true;
+ default :
return super.onTouchEvent(event);
- }
+ }
}
You can then do your own processing on these events to determine if a
@@ -143,22 +143,22 @@ setOnTouchListener()} method. This makes it possible to to listen for touch
events without subclassing an existing {@link android.view.View}. For
example:
Beware of creating a listener that returns {@code false} for the
-{@link android.view.MotionEvent#ACTION_DOWN} event. If you do this, the listener will
-not be called for the subsequent {@link android.view.MotionEvent#ACTION_MOVE}
+
Beware of creating a listener that returns {@code false} for the
+{@link android.view.MotionEvent#ACTION_DOWN} event. If you do this, the listener will
+not be called for the subsequent {@link android.view.MotionEvent#ACTION_MOVE}
and {@link android.view.MotionEvent#ACTION_UP} string of events. This is because
{@link android.view.MotionEvent#ACTION_DOWN} is the starting point for all touch events.
-
If you are creating a custom View, you can override
-{@link android.view.View#onTouchEvent onTouchEvent()},
+
If you are creating a custom View, you can override
+{@link android.view.View#onTouchEvent onTouchEvent()},
as described above.
Detect Gestures
@@ -168,24 +168,24 @@ common gestures. Some of the gestures it supports include {@link
android.view.GestureDetector.OnGestureListener#onDown onDown()}, {@link
android.view.GestureDetector.OnGestureListener#onLongPress onLongPress()},
{@link android.view.GestureDetector.OnGestureListener#onFling onFling()}, and so
-on. You can use {@link android.view.GestureDetector} in conjunction with the
+on. You can use {@link android.view.GestureDetector} in conjunction with the
{@link android.view.View#onTouchEvent onTouchEvent()}
method described above.
Detecting All Supported Gestures
-
When you instantiate a {@link android.support.v4.view.GestureDetectorCompat}
-object, one of the parameters it takes is a class that implements the
-{@link android.view.GestureDetector.OnGestureListener} interface.
-{@link android.view.GestureDetector.OnGestureListener} notifies users when
-a particular touch event has occurred. To make it possible for your
-{@link android.view.GestureDetector} object to receive events, you override
-the View or Activity's {@link android.view.View#onTouchEvent onTouchEvent()} method,
+
When you instantiate a {@link android.support.v4.view.GestureDetectorCompat}
+object, one of the parameters it takes is a class that implements the
+{@link android.view.GestureDetector.OnGestureListener} interface.
+{@link android.view.GestureDetector.OnGestureListener} notifies users when
+a particular touch event has occurred. To make it possible for your
+{@link android.view.GestureDetector} object to receive events, you override
+the View or Activity's {@link android.view.View#onTouchEvent onTouchEvent()} method,
and pass along all observed events to the detector instance.
-
In the following snippet, a return value of {@code true} from the individual
+
In the following snippet, a return value of {@code true} from the individual
on<TouchEvent> methods indicates that you
have handled the touch event. A return value of {@code false} passes events down
through the view stack until the touch has been successfully handled.
@@ -195,14 +195,14 @@ you interact with the touch screen, and what the contents of the {@link
android.view.MotionEvent} are for each touch event. You will realize how much
data is being generated for even simple interactions.
-
public class MainActivity extends Activity implements
+
public class MainActivity extends Activity implements
GestureDetector.OnGestureListener,
GestureDetector.OnDoubleTapListener{
-
- private static final String DEBUG_TAG = "Gestures";
- private GestureDetectorCompat mDetector;
- // Called when the activity is first created.
+ private static final String DEBUG_TAG = "Gestures";
+ private GestureDetectorCompat mDetector;
+
+ // Called when the activity is first created.
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
@@ -216,21 +216,21 @@ data is being generated for even simple interactions.
mDetector.setOnDoubleTapListener(this);
}
- @Override
- public boolean onTouchEvent(MotionEvent event){
+ @Override
+ public boolean onTouchEvent(MotionEvent event){
this.mDetector.onTouchEvent(event);
// Be sure to call the superclass implementation
return super.onTouchEvent(event);
}
@Override
- public boolean onDown(MotionEvent event) {
- Log.d(DEBUG_TAG,"onDown: " + event.toString());
+ public boolean onDown(MotionEvent event) {
+ Log.d(DEBUG_TAG,"onDown: " + event.toString());
return true;
}
@Override
- public boolean onFling(MotionEvent event1, MotionEvent event2,
+ public boolean onFling(MotionEvent event1, MotionEvent event2,
float velocityX, float velocityY) {
Log.d(DEBUG_TAG, "onFling: " + event1.toString()+event2.toString());
return true;
@@ -238,7 +238,7 @@ data is being generated for even simple interactions.
@Override
public void onLongPress(MotionEvent event) {
- Log.d(DEBUG_TAG, "onLongPress: " + event.toString());
+ Log.d(DEBUG_TAG, "onLongPress: " + event.toString());
}
@Override
@@ -294,23 +294,23 @@ android.view.GestureDetector.SimpleOnGestureListener} and overrides {@link
android.view.GestureDetector.OnGestureListener#onFling onFling()} and {@link
android.view.GestureDetector.OnGestureListener#onDown onDown()}.
-
Whether or not you use {@link android.view.GestureDetector.OnGestureListener},
-it's best practice to implement an
-{@link android.view.GestureDetector.OnGestureListener#onDown onDown()}
-method that returns {@code true}. This is because all gestures begin with an
-{@link android.view.GestureDetector.OnGestureListener#onDown onDown()} message. If you return
-{@code false} from {@link android.view.GestureDetector.OnGestureListener#onDown onDown()},
-as {@link android.view.GestureDetector.SimpleOnGestureListener} does by default,
-the system assumes that you want to ignore the rest of the gesture, and the other methods of
-{@link android.view.GestureDetector.OnGestureListener} never get called.
-This has the potential to cause unexpected problems in your app.
-The only time you should return {@code false} from
-{@link android.view.GestureDetector.OnGestureListener#onDown onDown()}
+
Whether or not you use {@link android.view.GestureDetector.OnGestureListener},
+it's best practice to implement an
+{@link android.view.GestureDetector.OnGestureListener#onDown onDown()}
+method that returns {@code true}. This is because all gestures begin with an
+{@link android.view.GestureDetector.OnGestureListener#onDown onDown()} message. If you return
+{@code false} from {@link android.view.GestureDetector.OnGestureListener#onDown onDown()},
+as {@link android.view.GestureDetector.SimpleOnGestureListener} does by default,
+the system assumes that you want to ignore the rest of the gesture, and the other methods of
+{@link android.view.GestureDetector.OnGestureListener} never get called.
+This has the potential to cause unexpected problems in your app.
+The only time you should return {@code false} from
+{@link android.view.GestureDetector.OnGestureListener#onDown onDown()}
is if you truly want to ignore an entire gesture.
-
public class MainActivity extends Activity {
-
- private GestureDetectorCompat mDetector;
+
public class MainActivity extends Activity {
+
+ private GestureDetectorCompat mDetector;
@Override
public void onCreate(Bundle savedInstanceState) {
@@ -319,23 +319,23 @@ is if you truly want to ignore an entire gesture.
mDetector = new GestureDetectorCompat(this, new MyGestureListener());
}
- @Override
- public boolean onTouchEvent(MotionEvent event){
+ @Override
+ public boolean onTouchEvent(MotionEvent event){
this.mDetector.onTouchEvent(event);
return super.onTouchEvent(event);
}
-
+
class MyGestureListener extends GestureDetector.SimpleOnGestureListener {
- private static final String DEBUG_TAG = "Gestures";
-
+ private static final String DEBUG_TAG = "Gestures";
+
@Override
- public boolean onDown(MotionEvent event) {
- Log.d(DEBUG_TAG,"onDown: " + event.toString());
+ public boolean onDown(MotionEvent event) {
+ Log.d(DEBUG_TAG,"onDown: " + event.toString());
return true;
}
@Override
- public boolean onFling(MotionEvent event1, MotionEvent event2,
+ public boolean onFling(MotionEvent event1, MotionEvent event2,
float velocityX, float velocityY) {
Log.d(DEBUG_TAG, "onFling: " + event1.toString()+event2.toString());
return true;
diff --git a/docs/html/training/gestures/index.jd b/docs/html/training/gestures/index.jd
index 260cfff33073d..fad1afafbbe93 100644
--- a/docs/html/training/gestures/index.jd
+++ b/docs/html/training/gestures/index.jd
@@ -60,7 +60,7 @@ for Touch Feedback. Detecting Common Gestures
- Learn how to detect basic touch gestures such as scrolling, flinging, and double-tapping, using
+ Learn how to detect basic touch gestures such as scrolling, flinging, and double-tapping, using
{@link android.view.GestureDetector}.
@@ -84,7 +84,7 @@ touch event.
Learn how to detect multi-pointer (finger) gestures.
-
diff --git a/docs/html/training/gestures/movement.jd b/docs/html/training/gestures/movement.jd
index ed4928eb30419..0a611b3d6daff 100644
--- a/docs/html/training/gestures/movement.jd
+++ b/docs/html/training/gestures/movement.jd
@@ -55,13 +55,13 @@ detecting touch events is often based more on movement than on simple contact.
To help apps distinguish between movement-based gestures (such as a swipe) and
non-movement gestures (such as a single tap), Android includes the notion of
"touch slop." Touch slop refers to the distance in pixels a user's touch can wander
-before the gesture is interpreted as a movement-based gesture. For more discussion of this
+before the gesture is interpreted as a movement-based gesture. For more discussion of this
topic, see Managing Touch Events in a ViewGroup.
There are several different ways to track movement in a gesture, depending on
-the needs of your application. For example:
+the needs of your application. For example:
@@ -89,8 +89,8 @@ details.
You could have a movement-based gesture that is simply based on the distance and/or direction the pointer traveled. But velocity often is a
determining factor in tracking a gesture's characteristics or even deciding
whether the gesture occurred. To make velocity calculation easier, Android
-provides the {@link android.view.VelocityTracker} class and the
-{@link android.support.v4.view.VelocityTrackerCompat} class in the
+provides the {@link android.view.VelocityTracker} class and the
+{@link android.support.v4.view.VelocityTrackerCompat} class in the
Support Library.
{@link
android.view.VelocityTracker} helps you track the velocity of touch events. This
@@ -98,7 +98,7 @@ is useful for gestures in which velocity is part of the criteria for the
gesture, such as a fling.
-
Here is a simple example that illustrates the purpose of the methods in the
+
Here is a simple example that illustrates the purpose of the methods in the
{@link android.view.VelocityTracker} API:
public class MainActivity extends Activity {
@@ -126,16 +126,16 @@ gesture, such as a fling.
break;
case MotionEvent.ACTION_MOVE:
mVelocityTracker.addMovement(event);
- // When you want to determine the velocity, call
- // computeCurrentVelocity(). Then call getXVelocity()
- // and getYVelocity() to retrieve the velocity for each pointer ID.
+ // When you want to determine the velocity, call
+ // computeCurrentVelocity(). Then call getXVelocity()
+ // and getYVelocity() to retrieve the velocity for each pointer ID.
mVelocityTracker.computeCurrentVelocity(1000);
// Log velocity of pixels per second
// Best practice to use VelocityTrackerCompat where possible.
- Log.d("", "X velocity: " +
- VelocityTrackerCompat.getXVelocity(mVelocityTracker,
+ Log.d("", "X velocity: " +
+ VelocityTrackerCompat.getXVelocity(mVelocityTracker,
pointerId));
- Log.d("", "Y velocity: " +
+ Log.d("", "Y velocity: " +
VelocityTrackerCompat.getYVelocity(mVelocityTracker,
pointerId));
break;
@@ -150,8 +150,8 @@ gesture, such as a fling.
}
-
Note: Note that you should calculate velocity after an
-{@link android.view.MotionEvent#ACTION_MOVE} event,
-not after {@link android.view.MotionEvent#ACTION_UP}. After an {@link android.view.MotionEvent#ACTION_UP},
+
Note: Note that you should calculate velocity after an
+{@link android.view.MotionEvent#ACTION_MOVE} event,
+not after {@link android.view.MotionEvent#ACTION_UP}. After an {@link android.view.MotionEvent#ACTION_UP},
the X and Y velocities will be 0.
When multiple pointers touch the screen at the same time, the system generates the
+
When multiple pointers touch the screen at the same time, the system generates the
following touch events:
-
{@link android.view.MotionEvent#ACTION_DOWN}—For the first pointer that
-touches the screen. This starts the gesture. The pointer data for this pointer is
+
{@link android.view.MotionEvent#ACTION_DOWN}—For the first pointer that
+touches the screen. This starts the gesture. The pointer data for this pointer is
always at index 0 in the {@link android.view.MotionEvent}.
-
{@link android.support.v4.view.MotionEventCompat#ACTION_POINTER_DOWN}—For
-extra pointers that enter the screen beyond the first. The pointer data for this
+
{@link android.support.v4.view.MotionEventCompat#ACTION_POINTER_DOWN}—For
+extra pointers that enter the screen beyond the first. The pointer data for this
pointer is at the index returned by {@link android.support.v4.view.MotionEventCompat#getActionIndex getActionIndex()}.
{@link android.view.MotionEvent#ACTION_MOVE}—A change has happened during a press gesture.
{@link android.support.v4.view.MotionEventCompat#ACTION_POINTER_UP}—Sent when a non-primary pointer goes up.
@@ -66,20 +66,20 @@ pointer is at the index returned by {@link android.support.v4.view.MotionEventCo
android.view.MotionEvent} via each pointer's index and ID:
-
Index: A {@link android.view.MotionEvent} effectively
-stores information about each pointer in an array. The index of a pointer is its position
+
Index: A {@link android.view.MotionEvent} effectively
+stores information about each pointer in an array. The index of a pointer is its position
within this array. Most of the {@link
android.view.MotionEvent} methods you use to interact with pointers take the
pointer index as a parameter, not the pointer ID.
-
-
+
+
ID: Each pointer also has an ID mapping that stays
-persistent across touch events to allow tracking an individual pointer across
+persistent across touch events to allow tracking an individual pointer across
the entire gesture.
-
+
-
The order in which individual pointers appear within a motion event is
+
The order in which individual pointers appear within a motion event is
undefined. Thus the index of a pointer can change from one event to the
next, but the pointer ID of a pointer is guaranteed to remain constant as long
as the pointer remains active. Use the {@link
@@ -91,7 +91,7 @@ the pointer index for a given pointer ID in that motion event. For example:
private int mActivePointerId;
-
+
public boolean onTouchEvent(MotionEvent event) {
....
// Get the pointer ID
@@ -99,7 +99,7 @@ public boolean onTouchEvent(MotionEvent event) {
// ... Many touch events later...
- // Use the pointer ID to find the index of the active pointer
+ // Use the pointer ID to find the index of the active pointer
// and fetch its position
int pointerIndex = event.findPointerIndex(mActivePointerId);
// Get the pointer's current position
@@ -109,25 +109,25 @@ public boolean onTouchEvent(MotionEvent event) {
Get a MotionEvent's Action
-
You should always use the method
-{@link android.view.MotionEvent#getActionMasked getActionMasked()} (or better yet, the compatability version
-{@link android.support.v4.view.MotionEventCompat#getActionMasked MotionEventCompat.getActionMasked()}) to retrieve
+
You should always use the method
+{@link android.view.MotionEvent#getActionMasked getActionMasked()} (or better yet, the compatability version
+{@link android.support.v4.view.MotionEventCompat#getActionMasked MotionEventCompat.getActionMasked()}) to retrieve
the action of a
-{@link android.view.MotionEvent}. Unlike the older {@link android.view.MotionEvent#getAction getAction()}
-method, {@link android.support.v4.view.MotionEventCompat#getActionMasked getActionMasked()} is designed to work with
-multiple pointers. It returns the masked action
-being performed, without including the pointer index bits. You can then use
-{@link android.support.v4.view.MotionEventCompat#getActionIndex getActionIndex()} to return the index of
+{@link android.view.MotionEvent}. Unlike the older {@link android.view.MotionEvent#getAction getAction()}
+method, {@link android.support.v4.view.MotionEventCompat#getActionMasked getActionMasked()} is designed to work with
+multiple pointers. It returns the masked action
+being performed, without including the pointer index bits. You can then use
+{@link android.support.v4.view.MotionEventCompat#getActionIndex getActionIndex()} to return the index of
the pointer associated with the action. This is illustrated in the snippet below.
-
Note: This example uses the
+
Note: This example uses the
{@link android.support.v4.view.MotionEventCompat}
-class. This class is in the
+class. This class is in the
Support Library. You should use
{@link android.support.v4.view.MotionEventCompat} to provide the best support for a wide range of
-platforms. Note that {@link android.support.v4.view.MotionEventCompat} is not a
-replacement for the {@link android.view.MotionEvent} class. Rather, it provides static utility
-methods to which you pass your {@link android.view.MotionEvent} object in order to receive
+platforms. Note that {@link android.support.v4.view.MotionEventCompat} is not a
+replacement for the {@link android.view.MotionEvent} class. Rather, it provides static utility
+methods to which you pass your {@link android.view.MotionEvent} object in order to receive
the desired action associated with that event.
int action = MotionEventCompat.getActionMasked(event);
@@ -137,17 +137,17 @@ int xPos = -1;
int yPos = -1;
Log.d(DEBUG_TAG,"The action is " + actionToString(action));
-
+
if (event.getPointerCount() > 1) {
- Log.d(DEBUG_TAG,"Multitouch event");
- // The coordinates of the current screen contact, relative to
- // the responding View or Activity.
+ Log.d(DEBUG_TAG,"Multitouch event");
+ // The coordinates of the current screen contact, relative to
+ // the responding View or Activity.
xPos = (int)MotionEventCompat.getX(event, index);
yPos = (int)MotionEventCompat.getY(event, index);
} else {
// Single touch event
- Log.d(DEBUG_TAG,"Single touch event");
+ Log.d(DEBUG_TAG,"Single touch event");
xPos = (int)MotionEventCompat.getX(event, index);
yPos = (int)MotionEventCompat.getY(event, index);
}
@@ -156,7 +156,7 @@ if (event.getPointerCount() > 1) {
// Given an action int, returns a string description
public static String actionToString(int action) {
switch (action) {
-
+
case MotionEvent.ACTION_DOWN: return "Down";
case MotionEvent.ACTION_MOVE: return "Move";
case MotionEvent.ACTION_POINTER_DOWN: return "Pointer Down";
@@ -168,7 +168,7 @@ public static String actionToString(int action) {
return "";
}
-
+
For more discussion of multi-touch and some examples, see the lesson Dragging and Scaling.
diff --git a/docs/html/training/gestures/scale.jd b/docs/html/training/gestures/scale.jd
index f2e4eb82d1228..d4aa91651db7f 100644
--- a/docs/html/training/gestures/scale.jd
+++ b/docs/html/training/gestures/scale.jd
@@ -44,13 +44,13 @@ class="button">Download the sample
This lesson describes how to use touch gestures to drag and scale on-screen
objects, using {@link android.view.View#onTouchEvent onTouchEvent()} to intercept
-touch events.
+touch events.
Drag an Object
-
If you are targeting Android 3.0 or higher, you can use the built-in drag-and-drop event
-listeners with {@link android.view.View.OnDragListener}, as described in
+
If you are targeting Android 3.0 or higher, you can use the built-in drag-and-drop event
+listeners with {@link android.view.View.OnDragListener}, as described in
Drag and Drop.
A common operation for a touch gesture is to use it to drag an object across
@@ -66,14 +66,14 @@ the touch screen and lifts the first finger. If your app is just tracking
individual pointers, it will regard the second pointer as the default and move
the image to that location.
-
To prevent this from happening, your app needs to distinguish between the
-original pointer and any follow-on pointers. To do this, it tracks the
-{@link android.view.MotionEvent#ACTION_POINTER_DOWN} and
-{@link android.view.MotionEvent#ACTION_POINTER_UP} events described in
-Handling Multi-Touch Gestures.
-{@link android.view.MotionEvent#ACTION_POINTER_DOWN} and
-{@link android.view.MotionEvent#ACTION_POINTER_UP} are
-passed to the {@link android.view.View#onTouchEvent onTouchEvent()} callback
+
To prevent this from happening, your app needs to distinguish between the
+original pointer and any follow-on pointers. To do this, it tracks the
+{@link android.view.MotionEvent#ACTION_POINTER_DOWN} and
+{@link android.view.MotionEvent#ACTION_POINTER_UP} events described in
+Handling Multi-Touch Gestures.
+{@link android.view.MotionEvent#ACTION_POINTER_DOWN} and
+{@link android.view.MotionEvent#ACTION_POINTER_UP} are
+passed to the {@link android.view.View#onTouchEvent onTouchEvent()} callback
whenever a secondary pointer goes down or up.
@@ -90,16 +90,16 @@ calculate the distance to move using data from the correct pointer.
The following snippet enables a user to drag an object around on the screen. It records the initial
position of the active pointer, calculates the distance the pointer traveled, and moves the object to the
new position. It correctly manages the possibility of additional pointers, as described
-above.
+above.
-
Notice that the snippet uses the {@link android.view.MotionEvent#getActionMasked getActionMasked()} method.
-You should always use this method (or better yet, the compatability version
-{@link android.support.v4.view.MotionEventCompat#getActionMasked MotionEventCompat.getActionMasked()})
+
Notice that the snippet uses the {@link android.view.MotionEvent#getActionMasked getActionMasked()} method.
+You should always use this method (or better yet, the compatability version
+{@link android.support.v4.view.MotionEventCompat#getActionMasked MotionEventCompat.getActionMasked()})
to retrieve the action of a
-{@link android.view.MotionEvent}. Unlike the older
-{@link android.view.MotionEvent#getAction getAction()}
-method, {@link android.support.v4.view.MotionEventCompat#getActionMasked getActionMasked()}
-is designed to work with multiple pointers. It returns the masked action
+{@link android.view.MotionEvent}. Unlike the older
+{@link android.view.MotionEvent#getAction getAction()}
+method, {@link android.support.v4.view.MotionEventCompat#getActionMasked getActionMasked()}
+is designed to work with multiple pointers. It returns the masked action
being performed, without including the pointer index bits.
// The ‘active pointer’ is the one currently moving our object.
@@ -109,15 +109,15 @@ private int mActivePointerId = INVALID_POINTER_ID;
public boolean onTouchEvent(MotionEvent ev) {
// Let the ScaleGestureDetector inspect all events.
mScaleDetector.onTouchEvent(ev);
-
- final int action = MotionEventCompat.getActionMasked(ev);
-
- switch (action) {
+
+ final int action = MotionEventCompat.getActionMasked(ev);
+
+ switch (action) {
case MotionEvent.ACTION_DOWN: {
- final int pointerIndex = MotionEventCompat.getActionIndex(ev);
- final float x = MotionEventCompat.getX(ev, pointerIndex);
- final float y = MotionEventCompat.getY(ev, pointerIndex);
-
+ final int pointerIndex = MotionEventCompat.getActionIndex(ev);
+ final float x = MotionEventCompat.getX(ev, pointerIndex);
+ final float y = MotionEventCompat.getY(ev, pointerIndex);
+
// Remember where we started (for dragging)
mLastTouchX = x;
mLastTouchY = y;
@@ -125,15 +125,15 @@ public boolean onTouchEvent(MotionEvent ev) {
mActivePointerId = MotionEventCompat.getPointerId(ev, 0);
break;
}
-
+
case MotionEvent.ACTION_MOVE: {
// Find the index of the active pointer and fetch its position
- final int pointerIndex =
- MotionEventCompat.findPointerIndex(ev, mActivePointerId);
-
+ final int pointerIndex =
+ MotionEventCompat.findPointerIndex(ev, mActivePointerId);
+
final float x = MotionEventCompat.getX(ev, pointerIndex);
final float y = MotionEventCompat.getY(ev, pointerIndex);
-
+
// Calculate the distance moved
final float dx = x - mLastTouchX;
final float dy = y - mLastTouchY;
@@ -149,62 +149,62 @@ public boolean onTouchEvent(MotionEvent ev) {
break;
}
-
+
case MotionEvent.ACTION_UP: {
mActivePointerId = INVALID_POINTER_ID;
break;
}
-
+
case MotionEvent.ACTION_CANCEL: {
mActivePointerId = INVALID_POINTER_ID;
break;
}
-
+
case MotionEvent.ACTION_POINTER_UP: {
-
- final int pointerIndex = MotionEventCompat.getActionIndex(ev);
- final int pointerId = MotionEventCompat.getPointerId(ev, pointerIndex);
+
+ final int pointerIndex = MotionEventCompat.getActionIndex(ev);
+ final int pointerId = MotionEventCompat.getPointerId(ev, pointerIndex);
if (pointerId == mActivePointerId) {
// This was our active pointer going up. Choose a new
// active pointer and adjust accordingly.
final int newPointerIndex = pointerIndex == 0 ? 1 : 0;
- mLastTouchX = MotionEventCompat.getX(ev, newPointerIndex);
- mLastTouchY = MotionEventCompat.getY(ev, newPointerIndex);
+ mLastTouchX = MotionEventCompat.getX(ev, newPointerIndex);
+ mLastTouchY = MotionEventCompat.getY(ev, newPointerIndex);
mActivePointerId = MotionEventCompat.getPointerId(ev, newPointerIndex);
}
break;
}
- }
+ }
return true;
}
Drag to Pan
-
The previous section showed an example of dragging an object around the screen. Another
-common scenario is panning, which is when a user's dragging motion causes scrolling
-in both the x and y axes. The above snippet directly intercepted the {@link android.view.MotionEvent}
-actions to implement dragging. The snippet in this section takes advantage of the platform's
-built-in support for common gestures. It overrides
-{@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()} in
+
The previous section showed an example of dragging an object around the screen. Another
+common scenario is panning, which is when a user's dragging motion causes scrolling
+in both the x and y axes. The above snippet directly intercepted the {@link android.view.MotionEvent}
+actions to implement dragging. The snippet in this section takes advantage of the platform's
+built-in support for common gestures. It overrides
+{@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()} in
{@link android.view.GestureDetector.SimpleOnGestureListener}.
-
To provide a little more context, {@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()}
-is called when a user is dragging his finger to pan the content.
-{@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()} is only called when
-a finger is down; as soon as the finger is lifted from the screen, the gesture either ends,
-or a fling gesture is started (if the finger was moving with some speed just before it was lifted).
+
To provide a little more context, {@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()}
+is called when a user is dragging his finger to pan the content.
+{@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()} is only called when
+a finger is down; as soon as the finger is lifted from the screen, the gesture either ends,
+or a fling gesture is started (if the finger was moving with some speed just before it was lifted).
For more discussion of scrolling vs. flinging, see Animating a Scroll Gesture.
Here is the snippet for {@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()}:
-
// The current viewport. This rectangle represents the currently visible
-// chart domain and range.
-private RectF mCurrentViewport =
+
// The current viewport. This rectangle represents the currently visible
+// chart domain and range.
+private RectF mCurrentViewport =
new RectF(AXIS_X_MIN, AXIS_Y_MIN, AXIS_X_MAX, AXIS_Y_MAX);
-// The current destination rectangle (in pixel coordinates) into which the
+// The current destination rectangle (in pixel coordinates) into which the
// chart data should be drawn.
private Rect mContentRect;
@@ -213,18 +213,18 @@ private final GestureDetector.SimpleOnGestureListener mGestureListener
...
@Override
-public boolean onScroll(MotionEvent e1, MotionEvent e2,
+public boolean onScroll(MotionEvent e1, MotionEvent e2,
float distanceX, float distanceY) {
// Scrolling uses math based on the viewport (as opposed to math using pixels).
-
+
// Pixel offset is the offset in screen pixels, while viewport offset is the
- // offset within the current viewport.
- float viewportOffsetX = distanceX * mCurrentViewport.width()
+ // offset within the current viewport.
+ float viewportOffsetX = distanceX * mCurrentViewport.width()
/ mContentRect.width();
- float viewportOffsetY = -distanceY * mCurrentViewport.height()
+ float viewportOffsetY = -distanceY * mCurrentViewport.height()
/ mContentRect.height();
...
- // Updates the viewport, refreshes the display.
+ // Updates the viewport, refreshes the display.
setViewportBottomLeft(
mCurrentViewport.left + viewportOffsetX,
mCurrentViewport.bottom + viewportOffsetY);
@@ -232,20 +232,20 @@ public boolean onScroll(MotionEvent e1, MotionEvent e2,
return true;
}
-
The implementation of {@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()}
+
The implementation of {@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()}
scrolls the viewport in response to the touch gesture:
/**
* Sets the current viewport (defined by mCurrentViewport) to the given
- * X and Y positions. Note that the Y value represents the topmost pixel position,
+ * X and Y positions. Note that the Y value represents the topmost pixel position,
* and thus the bottom of the mCurrentViewport rectangle.
*/
private void setViewportBottomLeft(float x, float y) {
/*
- * Constrains within the scroll range. The scroll range is simply the viewport
- * extremes (AXIS_X_MAX, etc.) minus the viewport size. For example, if the
- * extremes were 0 and 10, and the viewport size was 2, the scroll range would
+ * Constrains within the scroll range. The scroll range is simply the viewport
+ * extremes (AXIS_X_MAX, etc.) minus the viewport size. For example, if the
+ * extremes were 0 and 10, and the viewport size was 2, the scroll range would
* be 0 to 8.
*/
@@ -270,11 +270,11 @@ provides {@link android.view.ScaleGestureDetector}. {@link
android.view.GestureDetector} and {@link android.view.ScaleGestureDetector} can
be used together when you want a view to recognize additional gestures.
-
To report detected gesture events, gesture detectors use listener objects
-passed to their constructors. {@link android.view.ScaleGestureDetector} uses
-{@link android.view.ScaleGestureDetector.OnScaleGestureListener}.
-Android provides
-{@link android.view.ScaleGestureDetector.SimpleOnScaleGestureListener}
+
To report detected gesture events, gesture detectors use listener objects
+passed to their constructors. {@link android.view.ScaleGestureDetector} uses
+{@link android.view.ScaleGestureDetector.OnScaleGestureListener}.
+Android provides
+{@link android.view.ScaleGestureDetector.SimpleOnScaleGestureListener}
as a helper class that you can extend if you don’t care about all of the reported events.
@@ -311,7 +311,7 @@ public void onDraw(Canvas canvas) {
canvas.restore();
}
-private class ScaleListener
+private class ScaleListener
extends ScaleGestureDetector.SimpleOnScaleGestureListener {
@Override
public boolean onScale(ScaleGestureDetector detector) {
@@ -329,14 +329,14 @@ private class ScaleListener
More complex scaling example
-
Here is a more complex example from the {@code InteractiveChart} sample provided with this class.
+
Here is a more complex example from the {@code InteractiveChart} sample provided with this class.
The {@code InteractiveChart} sample supports both scrolling (panning) and scaling with multiple fingers,
-using the {@link android.view.ScaleGestureDetector} "span"
-({@link android.view.ScaleGestureDetector#getCurrentSpanX getCurrentSpanX/Y}) and
+using the {@link android.view.ScaleGestureDetector} "span"
+({@link android.view.ScaleGestureDetector#getCurrentSpanX getCurrentSpanX/Y}) and
"focus" ({@link android.view.ScaleGestureDetector#getFocusX getFocusX/Y}) features:
@Override
-private RectF mCurrentViewport =
+private RectF mCurrentViewport =
new RectF(AXIS_X_MIN, AXIS_Y_MIN, AXIS_X_MAX, AXIS_Y_MAX);
private Rect mContentRect;
private ScaleGestureDetector mScaleGestureDetector;
@@ -399,7 +399,7 @@ private final ScaleGestureDetector.OnScaleGestureListener mScaleGestureListener
0,
0);
mCurrentViewport.right = mCurrentViewport.left + newWidth;
- mCurrentViewport.bottom = mCurrentViewport.top + newHeight;
+ mCurrentViewport.bottom = mCurrentViewport.top + newHeight;
...
// Invalidates the View to update the display.
ViewCompat.postInvalidateOnAnimation(InteractiveLineGraphView.this);
diff --git a/docs/html/training/gestures/scroll.jd b/docs/html/training/gestures/scroll.jd
index 4b82d6966e5c6..374ceff55f5dc 100644
--- a/docs/html/training/gestures/scroll.jd
+++ b/docs/html/training/gestures/scroll.jd
@@ -41,12 +41,12 @@ class="button">Download the sample
-
In Android, scrolling is typically achieved by using the
+
In Android, scrolling is typically achieved by using the
{@link android.widget.ScrollView}
-class. Any standard layout that might extend beyond the bounds of its container should be
-nested in a {@link android.widget.ScrollView} to provide a scrollable view that's
-managed by the framework. Implementing a custom scroller should only be
-necessary for special scenarios. This lesson describes such a scenario: displaying
+class. Any standard layout that might extend beyond the bounds of its container should be
+nested in a {@link android.widget.ScrollView} to provide a scrollable view that's
+managed by the framework. Implementing a custom scroller should only be
+necessary for special scenarios. This lesson describes such a scenario: displaying
a scrolling effect in response to touch gestures using scrollers.
@@ -54,8 +54,8 @@ a scrolling effect in response to touch gestures using scrollers.
android.widget.OverScroller}) to collect the data you need to produce a
scrolling animation in response to a touch event. They are similar, but
{@link android.widget.OverScroller}
-includes methods for indicating to users that they've reached the content edges
-after a pan or fling gesture. The {@code InteractiveChart} sample
+includes methods for indicating to users that they've reached the content edges
+after a pan or fling gesture. The {@code InteractiveChart} sample
uses the {@link android.widget.EdgeEffect} class
(actually the {@link android.support.v4.widget.EdgeEffectCompat} class)
to display a "glow" effect when users reach the content edges.
@@ -68,7 +68,7 @@ compatibility with older devices.
Also note that you generally only need to use scrollers
when implementing scrolling yourself. {@link android.widget.ScrollView} and
-{@link android.widget.HorizontalScrollView} do all of this for you if you nest your
+{@link android.widget.HorizontalScrollView} do all of this for you if you nest your
layout within them.
@@ -86,71 +86,71 @@ scrolling animation look smooth.
"Scrolling" is a word that can take on different meanings in Android, depending on the context.
-
Scrolling is the general process of moving the viewport (that is, the 'window'
-of content you're looking at). When scrolling is in both the x and y axes, it's called
-panning. The sample application provided with this class, {@code InteractiveChart}, illustrates
+
Scrolling is the general process of moving the viewport (that is, the 'window'
+of content you're looking at). When scrolling is in both the x and y axes, it's called
+panning. The sample application provided with this class, {@code InteractiveChart}, illustrates
two different types of scrolling, dragging and flinging:
-
Dragging is the type of scrolling that occurs when a user drags her
-finger across the touch screen. Simple dragging is often implemented by overriding
-{@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()} in
-{@link android.view.GestureDetector.OnGestureListener}. For more discussion of dragging, see
+
Dragging is the type of scrolling that occurs when a user drags her
+finger across the touch screen. Simple dragging is often implemented by overriding
+{@link android.view.GestureDetector.OnGestureListener#onScroll onScroll()} in
+{@link android.view.GestureDetector.OnGestureListener}. For more discussion of dragging, see
Dragging and Scaling.
-
Flinging is the type of scrolling that occurs when a user
-drags and lifts her finger quickly. After the user lifts her finger, you generally
-want to keep scrolling (moving the viewport), but decelerate until the viewport stops moving.
-Flinging can be implemented by overriding
-{@link android.view.GestureDetector.OnGestureListener#onFling onFling()}
-in {@link android.view.GestureDetector.OnGestureListener}, and by using
-a scroller object. This is the use
+
Flinging is the type of scrolling that occurs when a user
+drags and lifts her finger quickly. After the user lifts her finger, you generally
+want to keep scrolling (moving the viewport), but decelerate until the viewport stops moving.
+Flinging can be implemented by overriding
+{@link android.view.GestureDetector.OnGestureListener#onFling onFling()}
+in {@link android.view.GestureDetector.OnGestureListener}, and by using
+a scroller object. This is the use
case that is the topic of this lesson.
-
It's common to use scroller objects
+
It's common to use scroller objects
in conjunction with a fling gesture, but they
can be used in pretty much any context where you want the UI to display
-scrolling in response to a touch event. For example, you could override
-{@link android.view.View#onTouchEvent onTouchEvent()} to process touch
-events directly, and produce a scrolling effect or a "snapping to page" animation
+scrolling in response to a touch event. For example, you could override
+{@link android.view.View#onTouchEvent onTouchEvent()} to process touch
+events directly, and produce a scrolling effect or a "snapping to page" animation
in response to those touch events.
-
Implement Touch-Based Scrolling
+
Implement Touch-Based Scrolling
This section describes how to use a scroller.
-The snippet shown below comes from the {@code InteractiveChart} sample
+The snippet shown below comes from the {@code InteractiveChart} sample
provided with this class.
-It uses a
-{@link android.view.GestureDetector}, and overrides the
-{@link android.view.GestureDetector.SimpleOnGestureListener} method
+It uses a
+{@link android.view.GestureDetector}, and overrides the
+{@link android.view.GestureDetector.SimpleOnGestureListener} method
{@link android.view.GestureDetector.OnGestureListener#onFling onFling()}.
It uses {@link android.widget.OverScroller} to track the fling gesture.
-If the user reaches the content edges
+If the user reaches the content edges
after the fling gesture, the app displays a "glow" effect.
-
Note: The {@code InteractiveChart} sample app displays a
-chart that you can zoom, pan, scroll, and so on. In the following snippet,
-{@code mContentRect} represents the rectangle coordinates within the view that the chart
-will be drawn into. At any given time, a subset of the total chart domain and range are drawn
-into this rectangular area.
-{@code mCurrentViewport} represents the portion of the chart that is currently
-visible in the screen. Because pixel offsets are generally treated as integers,
-{@code mContentRect} is of the type {@link android.graphics.Rect}. Because the
-graph domain and range are decimal/float values, {@code mCurrentViewport} is of
+
Note: The {@code InteractiveChart} sample app displays a
+chart that you can zoom, pan, scroll, and so on. In the following snippet,
+{@code mContentRect} represents the rectangle coordinates within the view that the chart
+will be drawn into. At any given time, a subset of the total chart domain and range are drawn
+into this rectangular area.
+{@code mCurrentViewport} represents the portion of the chart that is currently
+visible in the screen. Because pixel offsets are generally treated as integers,
+{@code mContentRect} is of the type {@link android.graphics.Rect}. Because the
+graph domain and range are decimal/float values, {@code mCurrentViewport} is of
the type {@link android.graphics.RectF}.
-
The first part of the snippet shows the implementation of
+
The first part of the snippet shows the implementation of
{@link android.view.GestureDetector.OnGestureListener#onFling onFling()}:
-
// The current viewport. This rectangle represents the currently visible
+
// The current viewport. This rectangle represents the currently visible
// chart domain and range. The viewport is the part of the app that the
// user manipulates via touch gestures.
-private RectF mCurrentViewport =
+private RectF mCurrentViewport =
new RectF(AXIS_X_MIN, AXIS_Y_MIN, AXIS_X_MAX, AXIS_Y_MAX);
-// The current destination rectangle (in pixel coordinates) into which the
+// The current destination rectangle (in pixel coordinates) into which the
// chart data should be drawn.
private Rect mContentRect;
@@ -171,7 +171,7 @@ private final GestureDetector.SimpleOnGestureListener mGestureListener
}
...
@Override
- public boolean onFling(MotionEvent e1, MotionEvent e2,
+ public boolean onFling(MotionEvent e1, MotionEvent e2,
float velocityX, float velocityY) {
fling((int) -velocityX, (int) -velocityY);
return true;
@@ -184,10 +184,10 @@ private void fling(int velocityX, int velocityY) {
// Flings use math in pixels (as opposed to math based on the viewport).
Point surfaceSize = computeScrollSurfaceSize();
mScrollerStartViewport.set(mCurrentViewport);
- int startX = (int) (surfaceSize.x * (mScrollerStartViewport.left -
+ int startX = (int) (surfaceSize.x * (mScrollerStartViewport.left -
AXIS_X_MIN) / (
AXIS_X_MAX - AXIS_X_MIN));
- int startY = (int) (surfaceSize.y * (AXIS_Y_MAX -
+ int startY = (int) (surfaceSize.y * (AXIS_Y_MAX -
mScrollerStartViewport.bottom) / (
AXIS_Y_MAX - AXIS_Y_MIN));
// Before flinging, aborts the current animation.
@@ -200,10 +200,10 @@ private void fling(int velocityX, int velocityY) {
velocityX,
velocityY,
/*
- * Minimum and maximum scroll positions. The minimum scroll
- * position is generally zero and the maximum scroll position
- * is generally the content size less the screen size. So if the
- * content width is 1000 pixels and the screen width is 200
+ * Minimum and maximum scroll positions. The minimum scroll
+ * position is generally zero and the maximum scroll position
+ * is generally the content size less the screen size. So if the
+ * content width is 1000 pixels and the screen width is 200
* pixels, the maximum scroll offset should be 800 pixels.
*/
0, surfaceSize.x - mContentRect.width(),
@@ -216,21 +216,21 @@ private void fling(int velocityX, int velocityY) {
ViewCompat.postInvalidateOnAnimation(this);
}
-
When {@link android.view.GestureDetector.OnGestureListener#onFling onFling()} calls
-{@link android.support.v4.view.ViewCompat#postInvalidateOnAnimation postInvalidateOnAnimation()},
-it triggers
-{@link android.view.View#computeScroll computeScroll()} to update the values for x and y.
+
When {@link android.view.GestureDetector.OnGestureListener#onFling onFling()} calls
+{@link android.support.v4.view.ViewCompat#postInvalidateOnAnimation postInvalidateOnAnimation()},
+it triggers
+{@link android.view.View#computeScroll computeScroll()} to update the values for x and y.
This is typically be done when a view child is animating a scroll using a scroller object, as in this example.
-
Most views pass the scroller object's x and y position directly to
-{@link android.view.View#scrollTo scrollTo()}.
-The following implementation of {@link android.view.View#computeScroll computeScroll()}
-takes a different approach—it calls
-{@link android.widget.OverScroller#computeScrollOffset computeScrollOffset()} to get the current
-location of x and y. When the criteria for displaying an overscroll "glow" edge effect are met
-(the display is zoomed in, x or y is out of bounds, and the app isn't already showing an overscroll),
-the code sets up the overscroll glow effect and calls
-{@link android.support.v4.view.ViewCompat#postInvalidateOnAnimation postInvalidateOnAnimation()}
+
Most views pass the scroller object's x and y position directly to
+{@link android.view.View#scrollTo scrollTo()}.
+The following implementation of {@link android.view.View#computeScroll computeScroll()}
+takes a different approach—it calls
+{@link android.widget.OverScroller#computeScrollOffset computeScrollOffset()} to get the current
+location of x and y. When the criteria for displaying an overscroll "glow" edge effect are met
+(the display is zoomed in, x or y is out of bounds, and the app isn't already showing an overscroll),
+the code sets up the overscroll glow effect and calls
+{@link android.support.v4.view.ViewCompat#postInvalidateOnAnimation postInvalidateOnAnimation()}
to trigger an invalidate on the view:
// Edge effect / overscroll tracking objects.
@@ -250,7 +250,7 @@ public void computeScroll() {
boolean needsInvalidate = false;
- // The scroller isn't finished, meaning a fling or programmatic pan
+ // The scroller isn't finished, meaning a fling or programmatic pan
// operation is currently active.
if (mScroller.computeScrollOffset()) {
Point surfaceSize = computeScrollSurfaceSize();
@@ -262,7 +262,7 @@ public void computeScroll() {
boolean canScrollY = (mCurrentViewport.top > AXIS_Y_MIN
|| mCurrentViewport.bottom < AXIS_Y_MAX);
- /*
+ /*
* If you are zoomed in and currX or currY is
* outside of bounds and you're not already
* showing overscroll, then render the overscroll
@@ -272,7 +272,7 @@ public void computeScroll() {
&& currX < 0
&& mEdgeEffectLeft.isFinished()
&& !mEdgeEffectLeftActive) {
- mEdgeEffectLeft.onAbsorb((int)
+ mEdgeEffectLeft.onAbsorb((int)
OverScrollerCompat.getCurrVelocity(mScroller));
mEdgeEffectLeftActive = true;
needsInvalidate = true;
@@ -280,7 +280,7 @@ public void computeScroll() {
&& currX > (surfaceSize.x - mContentRect.width())
&& mEdgeEffectRight.isFinished()
&& !mEdgeEffectRightActive) {
- mEdgeEffectRight.onAbsorb((int)
+ mEdgeEffectRight.onAbsorb((int)
OverScrollerCompat.getCurrVelocity(mScroller));
mEdgeEffectRightActive = true;
needsInvalidate = true;
@@ -290,7 +290,7 @@ public void computeScroll() {
&& currY < 0
&& mEdgeEffectTop.isFinished()
&& !mEdgeEffectTopActive) {
- mEdgeEffectTop.onAbsorb((int)
+ mEdgeEffectTop.onAbsorb((int)
OverScrollerCompat.getCurrVelocity(mScroller));
mEdgeEffectTopActive = true;
needsInvalidate = true;
@@ -298,7 +298,7 @@ public void computeScroll() {
&& currY > (surfaceSize.y - mContentRect.height())
&& mEdgeEffectBottom.isFinished()
&& !mEdgeEffectBottomActive) {
- mEdgeEffectBottom.onAbsorb((int)
+ mEdgeEffectBottom.onAbsorb((int)
OverScrollerCompat.getCurrVelocity(mScroller));
mEdgeEffectBottomActive = true;
needsInvalidate = true;
@@ -316,14 +316,14 @@ private PointF mZoomFocalPoint = new PointF();
// If a zoom is in progress (either programmatically or via double
// touch), performs the zoom.
if (mZoomer.computeZoom()) {
- float newWidth = (1f - mZoomer.getCurrZoom()) *
+ float newWidth = (1f - mZoomer.getCurrZoom()) *
mScrollerStartViewport.width();
- float newHeight = (1f - mZoomer.getCurrZoom()) *
+ float newHeight = (1f - mZoomer.getCurrZoom()) *
mScrollerStartViewport.height();
- float pointWithinViewportX = (mZoomFocalPoint.x -
+ float pointWithinViewportX = (mZoomFocalPoint.x -
mScrollerStartViewport.left)
/ mScrollerStartViewport.width();
- float pointWithinViewportY = (mZoomFocalPoint.y -
+ float pointWithinViewportY = (mZoomFocalPoint.y -
mScrollerStartViewport.top)
/ mScrollerStartViewport.height();
mCurrentViewport.set(
@@ -339,9 +339,9 @@ if (needsInvalidate) {
}
-
This is the {@code computeScrollSurfaceSize()} method that's called in the above snippet. It
-computes the current scrollable surface size, in pixels. For example, if the entire chart area is visible,
-this is simply the current size of {@code mContentRect}. If the chart is zoomed in 200% in both directions,
+
This is the {@code computeScrollSurfaceSize()} method that's called in the above snippet. It
+computes the current scrollable surface size, in pixels. For example, if the entire chart area is visible,
+this is simply the current size of {@code mContentRect}. If the chart is zoomed in 200% in both directions,
the returned size will be twice as large horizontally and vertically.
private Point computeScrollSurfaceSize() {
@@ -352,8 +352,8 @@ the returned size will be twice as large horizontally and vertically.
/ mCurrentViewport.height()));
}
-
For another example of scroller usage, see the
-source code for the
-{@link android.support.v4.view.ViewPager} class. It scrolls in response to flings,
+
For another example of scroller usage, see the
+source code for the
+{@link android.support.v4.view.ViewPager} class. It scrolls in response to flings,
and uses scrolling to implement the "snapping to page" animation.
The {@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}
-method is called whenever a touch event is detected on the surface of a
-{@link android.view.ViewGroup}, including on the surface of its children. If
-{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}
-returns {@code true}, the {@link android.view.MotionEvent} is intercepted,
-meaning it will be not be passed on to the child, but rather to the
+
The {@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}
+method is called whenever a touch event is detected on the surface of a
+{@link android.view.ViewGroup}, including on the surface of its children. If
+{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}
+returns {@code true}, the {@link android.view.MotionEvent} is intercepted,
+meaning it will be not be passed on to the child, but rather to the
{@link android.view.View#onTouchEvent onTouchEvent()} method of the parent.
-
The {@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}
-method gives a parent the chance to see any touch event before its children do.
-If you return {@code true} from
-{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()},
-the child view that was previously handling touch events
-receives an {@link android.view.MotionEvent#ACTION_CANCEL}, and the events from that
-point forward are sent to the parent's
-{@link android.view.View#onTouchEvent onTouchEvent()} method for the usual handling.
-{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()} can also
-return {@code false} and simply spy on events as they travel down the view hierarchy
+
The {@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}
+method gives a parent the chance to see any touch event before its children do.
+If you return {@code true} from
+{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()},
+the child view that was previously handling touch events
+receives an {@link android.view.MotionEvent#ACTION_CANCEL}, and the events from that
+point forward are sent to the parent's
+{@link android.view.View#onTouchEvent onTouchEvent()} method for the usual handling.
+{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()} can also
+return {@code false} and simply spy on events as they travel down the view hierarchy
to their usual targets, which will handle the events with their own
{@link android.view.View#onTouchEvent onTouchEvent()}.
-
In the following snippet, the class {@code MyViewGroup} extends
-{@link android.view.ViewGroup}.
-{@code MyViewGroup} contains multiple child views. If you drag your finger across
-a child view horizontally, the child view should no longer get touch events, and
-{@code MyViewGroup} should handle touch events by scrolling its contents. However,
-if you press buttons in the child view, or scroll the child view vertically,
-the parent shouldn't intercept those touch events, because the child is the
-intended target. In those cases,
+
In the following snippet, the class {@code MyViewGroup} extends
+{@link android.view.ViewGroup}.
+{@code MyViewGroup} contains multiple child views. If you drag your finger across
+a child view horizontally, the child view should no longer get touch events, and
+{@code MyViewGroup} should handle touch events by scrolling its contents. However,
+if you press buttons in the child view, or scroll the child view vertically,
+the parent shouldn't intercept those touch events, because the child is the
+intended target. In those cases,
{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()} should
-return {@code false}, and {@code MyViewGroup}'s
+return {@code false}, and {@code MyViewGroup}'s
{@link android.view.View#onTouchEvent onTouchEvent()} won't be called.
public class MyViewGroup extends ViewGroup {
@@ -118,20 +118,20 @@ return {@code false}, and {@code MyViewGroup}'s
switch (action) {
case MotionEvent.ACTION_MOVE: {
if (mIsScrolling) {
- // We're currently scrolling, so yes, intercept the
+ // We're currently scrolling, so yes, intercept the
// touch event!
return true;
}
- // If the user has dragged her finger horizontally more than
+ // If the user has dragged her finger horizontally more than
// the touch slop, start the scroll
// left as an exercise for the reader
- final int xDiff = calculateDistanceX(ev);
+ final int xDiff = calculateDistanceX(ev);
- // Touch slop should be calculated using ViewConfiguration
+ // Touch slop should be calculated using ViewConfiguration
// constants.
- if (xDiff > mTouchSlop) {
+ if (xDiff > mTouchSlop) {
// Start scrolling!
mIsScrolling = true;
return true;
@@ -141,26 +141,26 @@ return {@code false}, and {@code MyViewGroup}'s
...
}
- // In general, we don't want to intercept touch events. They should be
+ // In general, we don't want to intercept touch events. They should be
// handled by the child view.
return false;
}
@Override
public boolean onTouchEvent(MotionEvent ev) {
- // Here we actually handle the touch event (e.g. if the action is ACTION_MOVE,
+ // Here we actually handle the touch event (e.g. if the action is ACTION_MOVE,
// scroll this container).
- // This method will only be called if the touch event was intercepted in
+ // This method will only be called if the touch event was intercepted in
// onInterceptTouchEvent
...
}
}
-
Note that {@link android.view.ViewGroup} also provides a
-{@link android.view.ViewGroup#requestDisallowInterceptTouchEvent requestDisallowInterceptTouchEvent()} method.
-The {@link android.view.ViewGroup} calls this method when a child does not want the parent and its
-ancestors to intercept touch events with
-{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}.
+
Note that {@link android.view.ViewGroup} also provides a
+{@link android.view.ViewGroup#requestDisallowInterceptTouchEvent requestDisallowInterceptTouchEvent()} method.
+The {@link android.view.ViewGroup} calls this method when a child does not want the parent and its
+ancestors to intercept touch events with
+{@link android.view.ViewGroup#onInterceptTouchEvent onInterceptTouchEvent()}.
Use ViewConfiguration Constants
@@ -176,10 +176,10 @@ before the gesture is interpreted as scrolling. Touch slop is typically used to
prevent accidental scrolling when the user is performing some other touch
operation, such as touching on-screen elements.
-
Two other commonly used {@link android.view.ViewConfiguration} methods are
-{@link android.view.ViewConfiguration#getScaledMinimumFlingVelocity getScaledMinimumFlingVelocity()}
+
Two other commonly used {@link android.view.ViewConfiguration} methods are
+{@link android.view.ViewConfiguration#getScaledMinimumFlingVelocity getScaledMinimumFlingVelocity()}
and {@link android.view.ViewConfiguration#getScaledMaximumFlingVelocity getScaledMaximumFlingVelocity()}.
-These methods return the minimum and maximum velocity (respectively) to initiate a fling,
+These methods return the minimum and maximum velocity (respectively) to initiate a fling,
as measured in pixels per second. For example:
Android provides the {@link android.view.TouchDelegate} class to make it possible
-for a parent to extend the touchable area of a child view beyond the child's bounds.
+
Android provides the {@link android.view.TouchDelegate} class to make it possible
+for a parent to extend the touchable area of a child view beyond the child's bounds.
This is useful when the child has to be small, but should have a larger touch region. You can
also use this approach to shrink the child's touch region if need be.
-
In the following example, an {@link android.widget.ImageButton} is the
-"delegate view" (that is, the child whose touch area the parent will extend).
+
In the following example, an {@link android.widget.ImageButton} is the
+"delegate view" (that is, the child whose touch area the parent will extend).
Here is the layout file:
@@ -225,7 +225,7 @@ Here is the layout file:
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity" >
-
+
<ImageButton android:id="@+id/button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
@@ -245,9 +245,9 @@ Here is the layout file:
-In its capacity as touch delegate for the {@link android.widget.ImageButton} child view, the
+In its capacity as touch delegate for the {@link android.widget.ImageButton} child view, the
parent view will receive all touch events. If the touch event occurred within the child's hit
-rectangle, the parent will pass the touch
+rectangle, the parent will pass the touch
event to the child for handling.
@@ -261,7 +261,7 @@ public class MainActivity extends Activity {
setContentView(R.layout.activity_main);
// Get the parent view
View parentView = findViewById(R.id.parent_layout);
-
+
parentView.post(new Runnable() {
// Post in the parent's message queue to make sure the parent
// lays out its children before you call getHitRect()
@@ -275,29 +275,29 @@ public class MainActivity extends Activity {
myButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
- Toast.makeText(MainActivity.this,
- "Touch occurred within ImageButton touch region.",
+ Toast.makeText(MainActivity.this,
+ "Touch occurred within ImageButton touch region.",
Toast.LENGTH_SHORT).show();
}
});
-
+
// The hit rectangle for the ImageButton
myButton.getHitRect(delegateArea);
-
+
// Extend the touch area of the ImageButton beyond its bounds
// on the right and bottom.
delegateArea.right += 100;
delegateArea.bottom += 100;
-
+
// Instantiate a TouchDelegate.
- // "delegateArea" is the bounds in local coordinates of
+ // "delegateArea" is the bounds in local coordinates of
// the containing view to be mapped to the delegate view.
// "myButton" is the child view that should receive motion
// events.
- TouchDelegate touchDelegate = new TouchDelegate(delegateArea,
+ TouchDelegate touchDelegate = new TouchDelegate(delegateArea,
myButton);
-
- // Sets the TouchDelegate on the parent view, such that touches
+
+ // Sets the TouchDelegate on the parent view, such that touches
// within the touch delegate bounds are routed to the child.
if (View.class.isInstance(myButton.getParent())) {
((View) myButton.getParent()).setTouchDelegate(touchDelegate);
diff --git a/docs/html/training/id-auth/authenticate.jd b/docs/html/training/id-auth/authenticate.jd
index 65dbc3987bd3e..bf32e8ed04886 100644
--- a/docs/html/training/id-auth/authenticate.jd
+++ b/docs/html/training/id-auth/authenticate.jd
@@ -129,7 +129,7 @@ private class OnTokenAcquired implements AccountManagerCallback<Bundle> {
public void run(AccountManagerFuture<Bundle> result) {
// Get the result of the operation from the AccountManagerFuture.
Bundle bundle = result.getResult();
-
+
// The token is a named value in the bundle. The name of the value
// is stored in the constant AccountManager.KEY_AUTHTOKEN.
token = bundle.getString(AccountManager.KEY_AUTHTOKEN);
diff --git a/docs/html/training/id-auth/custom_auth.jd b/docs/html/training/id-auth/custom_auth.jd
index def9b51418df0..3c106a97317f3 100644
--- a/docs/html/training/id-auth/custom_auth.jd
+++ b/docs/html/training/id-auth/custom_auth.jd
@@ -81,7 +81,7 @@ a database that is only accessible to root. But on a rooted device, the
credentials would be readable by anyone with {@code adb} access to the device.
With this in mind, you shouldn't pass the user's actual
-password to {@link android.accounts.AccountManager#addAccountExplicitly
+password to {@link android.accounts.AccountManager#addAccountExplicitly
AccountManager.addAccountExplicitly()}. Instead, you should store a
cryptographically secure token that would be of limited use to an attacker. If your
user credentials are protecting something valuable, you should carefully
diff --git a/docs/html/training/id-auth/index.jd b/docs/html/training/id-auth/index.jd
index f15ee295fa9ca..45c6309648e98 100644
--- a/docs/html/training/id-auth/index.jd
+++ b/docs/html/training/id-auth/index.jd
@@ -15,7 +15,7 @@ startpage=true
Deep layouts - Layouts with too much nesting are bad for performance. Consider using flatter layouts such as {@link android.widget.RelativeLayout} or {@link android.widget.GridLayout} to improve performance. The default maximum depth is 10.
-
Another benefit of Lint is that it is integrated into Android Studio. Lint automatically runs
+
Another benefit of Lint is that it is integrated into Android Studio. Lint automatically runs
whenever you compile your program. With Android Studio, you can also run lint inspections for a
specific build variant, or for all build variants.
@@ -153,7 +153,7 @@ specific build variant, or for all build variants.
File>Settings>Project Settings option. The Inspection Configuration page
appears with the supported inspections.
-
Figure 5. Inspection Configuration
+
Figure 5. Inspection Configuration
Lint has the ability to automatically fix some issues, provide suggestions for others and jump
directly to the offending code for review.
Build a signed APK file for your In-app Billing application. To learn how to build and sign your APK, see Building Your Application for Release. Make sure that you are using your final (not debug) certificate and private key to sign your application.
+
Build a signed APK file for your In-app Billing application. To learn how to build and sign your APK, see Building Your Application for Release. Make sure that you are using your final (not debug) certificate and private key to sign your application.
In the Developer Console, open the application entry that you created earlier.
Click on the APK tab then click on Upload new APK. Upload the signed APK file to the Developer Console. Don’t publish the app yet!
You can query Google Play to programmatically retrieve details of the in-app products that are associated with your application (such as the product’s price, title, description, and type). This is useful, for example, when you want to display a listing of unowned items that are still available for purchase to users.
Note: When making the query, you will need to specify the product IDs for the products explicitly. You can manually find the product IDs from the Developer Console by opening the In-app Products tab for your application. The product IDs are listed under the column labeled Name/ID.
-
To retrieve the product details, call {@code queryInventoryAsync(boolean, List, QueryInventoryFinishedListener)} on your IabHelper instance.
+
To retrieve the product details, call {@code queryInventoryAsync(boolean, List, QueryInventoryFinishedListener)} on your IabHelper instance.
-
The first input argument indicates whether product details should be retrieved (should be set to {@code true}).
+
The first input argument indicates whether product details should be retrieved (should be set to {@code true}).
The {@code List} argument consists of one or more product IDs (also called SKUs) for the products that you want to query.
Finally, the {@code QueryInventoryFinishedListener} argument specifies a listener is notified when the query operation has completed and handles the query response.
The following example shows how you can make a purchase request for a product with ID {@code SKU_GAS}, using an arbitrary value of 10001 for the request code, and an encoded developer payload string.
The following example shows how you can handle the purchase response in the listener, depending on whether the purchase order was completed successfully, and whether the user purchased gas or a premium upgrade. In this example, gas is an in-app product that can be purchased multiple times, so you should consume the purchase to allow the user to buy it again. To learn how to consume purchases, see the Consuming Products section. The premium upgrade is a one-time purchase so you don’t need to consume it. It is good practice to update the UI immediately so that your users can see their newly purchased items.
-IabHelper.OnIabPurchaseFinishedListener mPurchaseFinishedListener
+IabHelper.OnIabPurchaseFinishedListener mPurchaseFinishedListener
= new IabHelper.OnIabPurchaseFinishedListener() {
- public void onIabPurchaseFinished(IabResult result, Purchase purchase)
+ public void onIabPurchaseFinished(IabResult result, Purchase purchase)
{
if (result.isFailure()) {
Log.d(TAG, "Error purchasing: " + result);
return;
- }
+ }
else if (purchase.getSku().equals(SKU_GAS)) {
// consume the gas and update the UI
}
@@ -86,7 +86,7 @@ mHelper.queryInventoryAsync(mGotInventoryListener);
If the query is successful, the query results are stored in an {@code Inventory} object that is passed back to the listener. The In-app Billing service returns only the purchases made by the user account that is currently logged in to the device.
-IabHelper.QueryInventoryFinishedListener mGotInventoryListener
+IabHelper.QueryInventoryFinishedListener mGotInventoryListener
= new IabHelper.QueryInventoryFinishedListener() {
public void onQueryInventoryFinished(IabResult result,
Inventory inventory) {
@@ -96,7 +96,7 @@ IabHelper.QueryInventoryFinishedListener mGotInventoryListener
}
else {
// does the user have the premium upgrade?
- mIsPremium = inventory.hasPurchase(SKU_PREMIUM);
+ mIsPremium = inventory.hasPurchase(SKU_PREMIUM);
// update UI accordingly
}
}
@@ -111,7 +111,7 @@ IabHelper.QueryInventoryFinishedListener mGotInventoryListener
In this example, you want to consume the gas item that the user has previously purchased in your app.
diff --git a/docs/html/training/in-app-billing/test-iab-app.jd b/docs/html/training/in-app-billing/test-iab-app.jd
index 9d47a96ce908c..fc7fe1aa70812 100644
--- a/docs/html/training/in-app-billing/test-iab-app.jd
+++ b/docs/html/training/in-app-billing/test-iab-app.jd
@@ -39,7 +39,7 @@ Test your In-app Billing application with static responses by using Google Play
Click Settings > Account details, then in the License Testing section, add the Google email addresses for your tester accounts.
-
Build a signed APK file for your In-app Billing application. To learn how to build and sign your APK, see Building Your Application for Release. Make sure that you are using your final (not debug) certificate and private key to sign your application.
+
Build a signed APK file for your In-app Billing application. To learn how to build and sign your APK, see Building Your Application for Release. Make sure that you are using your final (not debug) certificate and private key to sign your application.
Make sure that you have uploaded the signed APK for your application to the Developer Console, and associated one or more in-app products with your application. You don't need to publish the application on Google Play to test it.
Warning: It may take up to 2-3 hours after uploading the APK for Google Play to recognize your updated APK version. If you try to test your application before your uploaded APK is recognized by Google Play, your application will receive a ‘purchase cancelled’ response with an error message “This version of the application is not enabled for In-app Billing.”
Install the APK file to your physical test device by using the {@code adb} tool. To learn how to install the application, see Running on a Device. Make sure that:
diff --git a/docs/html/training/keyboard-input/index.jd b/docs/html/training/keyboard-input/index.jd
index 46795c4d9f4d2..bd7ad189be28b 100644
--- a/docs/html/training/keyboard-input/index.jd
+++ b/docs/html/training/keyboard-input/index.jd
@@ -32,9 +32,9 @@ through an attached keyboard.
These topics and more are discussed in the following lessons.
Learn how to show certain soft input methods, such as those designed for phone numbers, web
addresses, or other formats. Also learn how to specify characteristics such
@@ -51,5 +51,5 @@ through an attached keyboard.
Learn how to respond directly to keyboard input for user actions.
-
-
+
+
diff --git a/docs/html/training/keyboard-input/style.jd b/docs/html/training/keyboard-input/style.jd
index b0e506cf756c9..714c8b3c3e32f 100644
--- a/docs/html/training/keyboard-input/style.jd
+++ b/docs/html/training/keyboard-input/style.jd
@@ -71,7 +71,7 @@ so the text field conceals the user's input:
android:id="@+id/password"
android:hint="@string/password_hint"
android:inputType="textPassword"
- ... />
+ ... />
There are several possible values documented with the
diff --git a/docs/html/training/load-data-background/handle-results.jd b/docs/html/training/load-data-background/handle-results.jd
index ce0024f031c26..7439d3e99cf85 100644
--- a/docs/html/training/load-data-background/handle-results.jd
+++ b/docs/html/training/load-data-background/handle-results.jd
@@ -127,7 +127,7 @@ public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) {
*/
@Override
public void onLoaderReset(Loader<Cursor> loader) {
-
+
/*
* Clears out the adapter's reference to the Cursor.
* This prevents memory leaks.
diff --git a/docs/html/training/location/display-address.jd b/docs/html/training/location/display-address.jd
index 86066299e5d70..daa6fd3832afc 100644
--- a/docs/html/training/location/display-address.jd
+++ b/docs/html/training/location/display-address.jd
@@ -324,7 +324,7 @@ public class FetchAddressIntentService extends IntentService {
process if needed. If the service is already running then it remains running.
Because the service extends {@link android.app.IntentService IntentService},
it shuts down automatically when all intents have been processed.
-
+
Start the service from your app's main activity,
and create an {@link android.content.Intent} to pass data to the service. You
need an explicit intent, because you want only your service
diff --git a/docs/html/training/location/geofencing.jd b/docs/html/training/location/geofencing.jd
index 1cf89fdc8b920..ce6ad55ad8891 100644
--- a/docs/html/training/location/geofencing.jd
+++ b/docs/html/training/location/geofencing.jd
@@ -369,7 +369,7 @@ reduce the alerts is to use a transition type of
GEOFENCE_TRANSITION_DWELL instead of
GEOFENCE_TRANSITION_ENTER. This way, the dwelling alert is sent only when the user stops
-inside a geofence for a given period of time. You can choose the duration by setting a
+inside a geofence for a given period of time. You can choose the duration by setting a
loitering delay.
Users have a number of alternatives when it comes to enjoying the audio from their Android
devices. Most devices have a built-in speaker, headphone jacks for wired headsets, and many also
feature Bluetooth connectivity and support for A2DP audio.
-
-
Check What Hardware is Being Used
-
+
+
Check What Hardware is Being Used
+
How your app behaves might be affected by which hardware its output is being routed to.
You can query the {@link android.media.AudioManager} to determine if the audio is currently
@@ -48,13 +48,13 @@ if (isBluetoothA2dpOn()) {
// Adjust output for Speakerphone.
} else if (isWiredHeadsetOn()) {
// Adjust output for headsets
-} else {
+} else {
// If audio plays and noone can hear it, is it still playing?
}
-
Handle Changes in the Audio Output Hardware
+
Handle Changes in the Audio Output Hardware
When a headset is unplugged, or a Bluetooth device disconnected, the audio stream
automatically reroutes to the built in speaker. If you listen to your music at as high a volume as I
@@ -65,7 +65,7 @@ intent when this happens. It’s good practice to register a {@link android.cont
that listens for this intent whenever you’re playing audio. In the case of music players, users
typically expect the playback to be paused—while for games you may choose to significantly
lower the volume.
If your app plays audio, it’s important that your users can control the audio in a predictable
manner. To ensure a great user experience, it’s also important that your app manages the audio focus
-to ensure multiple apps aren’t playing audio at the same time.
+to ensure multiple apps aren’t playing audio at the same time.
-
After this class, you will be able to build apps that respond to hardware audio key presses,
+
After this class, you will be able to build apps that respond to hardware audio key presses,
which request audio focus when playing audio, and which respond appropriately to changes in audio
-focus caused by the system or other applications.
+focus caused by the system or other applications.
-
Learn how to ensure your users can control the volume of your app using the hardware or
software volume controls and where available the play, stop, pause, skip, and previous media
-playback keys.
With multiple apps potentially playing audio it's important to think about how they should
interact. To avoid every music app playing at the same time, Android uses audio focus to moderate
audio playback. Learn how to request the audio focus, listen for a loss of audio focus, and how to
-respond when that happens.
Audio can be played from a number of sources. Learn how to find out where the audio is being
-played and how to handle a headset being disconnected during playback.
-
+played and how to handle a headset being disconnected during playback.
+
diff --git a/docs/html/training/managing-audio/volume-playback.jd b/docs/html/training/managing-audio/volume-playback.jd
index be0f583d50c7f..7e2889300c8ae 100644
--- a/docs/html/training/managing-audio/volume-playback.jd
+++ b/docs/html/training/managing-audio/volume-playback.jd
@@ -8,8 +8,8 @@ next.link=audio-focus.html
@jd:body
-
-
A good user experience is a predictable one. If your app plays media it’s important that your
users can control the volume of your app using the hardware or software volume controls of their
device, bluetooth headset, or headphones.
@@ -38,9 +38,9 @@ device, bluetooth headset, or headphones.
Similarly, where appropriate and available, the play, stop, pause, skip, and previous media
playback keys should perform their respective actions on the audio stream used by your app.
-
-
Identify Which Audio Stream to Use
-
+
+
Identify Which Audio Stream to Use
+
The first step to creating a predictable audio experience is understanding which audio stream
your app will use.
@@ -53,11 +53,11 @@ clock, you’ll almost certainly be playing your audio using the {@link
android.media.AudioManager#STREAM_MUSIC} stream.
-
Use Hardware Volume Keys to Control Your App’s Audio Volume
+
Use Hardware Volume Keys to Control Your App’s Audio Volume
By default, pressing the volume controls modify the volume of the active audio stream. If your
app isn't currently playing anything, hitting the volume keys adjusts the ringer volume.
-
+
If you've got a game or music app, then chances are good that when the user hits the volume keys
they want to control the volume of the game or music, even if they’re currently between songs or
there’s no music in the current game location.
@@ -65,8 +65,8 @@ there’s no music in the current game location.
You may be tempted to try and listen for volume key presses and modify the volume of your
audio stream that way. Resist the urge. Android provides the handy {@link
android.app.Activity#setVolumeControlStream setVolumeControlStream()} method to direct volume key
-presses to the audio stream you specify.
-
+presses to the audio stream you specify.
+
Having identified the audio stream your application
will be using, you should set it as the volume stream target. You should make this call early in
your app’s lifecycle—because you only need to call it once during the activity lifecycle, you
@@ -85,7 +85,7 @@ specify (in this case “music”) whenever the target activity or fragment is v
Use Hardware Playback Control Keys to Control Your App’s Audio
-Playback
+Playback
Media playback buttons such as play, pause, stop, skip, and previous are available on some
handsets and many connected or wireless headsets. Whenever a user presses one of these hardware
diff --git a/docs/html/training/monitoring-device-state/connectivity-monitoring.jd b/docs/html/training/monitoring-device-state/connectivity-monitoring.jd
index d5e7a859b1216..2dd904f325f74 100644
--- a/docs/html/training/monitoring-device-state/connectivity-monitoring.jd
+++ b/docs/html/training/monitoring-device-state/connectivity-monitoring.jd
@@ -11,7 +11,7 @@ next.link=manifest-receivers.html
@jd:body
-
Some of the most common uses for repeating alarms and background services is to schedule regular
@@ -39,21 +39,21 @@ download, why both waking the device to schedule the update at all?
connected to the Internet, and if so, what type of connection is in place.
-
Determine if You Have an Internet Connection
-
+
Determine if You Have an Internet Connection
+
There's no need to schedule an update based on an Internet resource if you aren't connected to
-the Internet. The following snippet shows how to use the {@link android.net.ConnectivityManager}
+the Internet. The following snippet shows how to use the {@link android.net.ConnectivityManager}
to query the active network and determine if it has Internet connectivity.
The simplest way to monitor device state changes is to create a {@link
@@ -38,10 +38,10 @@ receivers is triggered—potentially much more frequently than required.
A better approach is to disable or enable the broadcast receivers at runtime. That way you can
use the receivers you declared in the manifest as passive alarms that are triggered by system events
only when necessary.
-
-
Toggle and Cascade State Change Receivers to Improve Efficiency
-
+
+
Toggle and Cascade State Change Receivers to Improve Efficiency
+
You can use the {@link android.content.pm.PackageManager} to toggle the enabled state on any
component defined in the manifest, including whichever broadcast receivers you wish to enable or
disable as shown in the snippet below:
@@ -59,6 +59,6 @@ your receivers except the connectivity-change receiver. Conversely, once you are
stop listening for connectivity changes and simply check to see if you're online immediately before
performing an update and rescheduling a recurring update alarm.
-
You can use the same technique to delay a download that requires higher bandwidth to complete.
+
You can use the same technique to delay a download that requires higher bandwidth to complete.
Simply enable a broadcast receiver that listens for connectivity changes and initiates the
download only after you are connected to Wi-Fi.
diff --git a/docs/html/training/multiple-threads/create-threadpool.jd b/docs/html/training/multiple-threads/create-threadpool.jd
index e22afd37c2221..df28833d3177d 100644
--- a/docs/html/training/multiple-threads/create-threadpool.jd
+++ b/docs/html/training/multiple-threads/create-threadpool.jd
@@ -48,7 +48,7 @@ trainingnavtop=true
also occurs in any object that is only instantiated once. To learn more about this, read the
Processes and Threads API guide.
-
+
Depending on the layout that your application is currently showing, the UI
flow may be different. For example, if your application is in the dual-pane
@@ -66,7 +66,7 @@ public class NewsReaderActivity extends FragmentActivity {
setContentView(R.layout.main_layout);
View articleView = findViewById(R.id.article);
- mIsDualPane = articleView != null &&
+ mIsDualPane = articleView != null &&
articleView.getVisibility() == View.VISIBLE;
}
}
@@ -139,7 +139,7 @@ public void onCreate(Bundle savedInstanceState) {
else {
/* use list navigation (spinner) */
actionBar.setNavigationMode(android.app.ActionBar.NAVIGATION_MODE_LIST);
- SpinnerAdapter adap = new ArrayAdapter(this,
+ SpinnerAdapter adap = new ArrayAdapter(this,
R.layout.headline_item, CATEGORIES);
actionBar.setListNavigationCallbacks(adap, handler);
}
@@ -157,7 +157,7 @@ large screens, but is a separate activity on smaller screens.
In cases like this, you can usually avoid code duplication by reusing the
same {@link android.app.Fragment} subclass in several activities. For example,
-ArticleFragment
+ArticleFragment
is used in the dual-pane layout:
{@sample development/samples/training/multiscreen/newsreader/res/layout/twopanes.xml all}
@@ -206,7 +206,7 @@ activity (as opposed to notifying a specific hard-coded activity):
public class HeadlinesFragment extends ListFragment {
...
@Override
- public void onItemClick(AdapterView<?> parent,
+ public void onItemClick(AdapterView<?> parent,
View view, int position, long id) {
if (null != mHeadlineSelectedListener) {
mHeadlineSelectedListener.onHeadlineSelected(position);
diff --git a/docs/html/training/multiscreen/index.jd b/docs/html/training/multiscreen/index.jd
index 8eff246cd8ebc..2c59facbda771 100644
--- a/docs/html/training/multiscreen/index.jd
+++ b/docs/html/training/multiscreen/index.jd
@@ -7,10 +7,10 @@ startpage=true
@jd:body
-
Android powers hundreds of device types with several different screen sizes,
ranging from small phones to large TV sets. Therefore, it’s important
that you design your application to be compatible with all screen sizes so it’s available to as many
@@ -62,26 +62,26 @@ of reusable code for your own application.
href="{@docRoot}tools/support-library/index.html">support library in order to use the {@link
android.app.Fragment} APIs on versions lower than Android 3.0. You must download and add the
library to your application in order to use all APIs in this class.
-
-
This lesson walks you through how to design layouts that adapts
several different screen sizes (using flexible dimensions for
views, {@link android.widget.RelativeLayout}, screen size and orientation qualifiers,
- alias filters, and nine-patch bitmaps).
This lesson shows you how to support screens that have different
pixel densities (using density-independent pixels and providing
- bitmaps appropriate for each density).
This lesson shows you how to implement your UI flow in a way
that adapts to several screen size/density combinations
(run-time detection of active layout, reacting according to
- current layout, handling screen configuration changes).
-
+ current layout, handling screen configuration changes).
+
This lesson shows you how to support different screen sizes by:
-
-
Ensuring your layout can be adequately resized to fit the screen
-
Providing appropriate UI layout according to screen configuration
+
+
Ensuring your layout can be adequately resized to fit the screen
+
Providing appropriate UI layout according to screen configuration
Ensuring the correct layout is applied to the correct screen
-
Providing bitmaps that scale correctly
-
+
Providing bitmaps that scale correctly
+
-
Use "wrap_content" and "match_parent"
+
Use "wrap_content" and "match_parent"
To ensure that your layout is flexible and adapts to different screen sizes,
you should use "wrap_content" and "match_parent" for the width
@@ -78,11 +78,11 @@ width and height:
and landscape (right).
-
Use RelativeLayout
+
Use RelativeLayout
You can construct fairly complex layouts using nested instances of {@link
android.widget.LinearLayout} and
-combinations of "wrap_content" and "match_parent" sizes.
+combinations of "wrap_content" and "match_parent" sizes.
However, {@link android.widget.LinearLayout} does not allow you to precisely control the
spacial relationships of child views; views in a {@link android.widget.LinearLayout} simply line up
side-by-side. If you need child views to be oriented in variations other than a straight line, a
@@ -139,8 +139,8 @@ the right side of the screen.
spatial relationships are preserved as specified by the {@link
android.widget.RelativeLayout.LayoutParams}.
-
-
Use Size Qualifiers
+
+
Use Size Qualifiers
There's only so much mileage you can get from a flexible layout or relative layout
like the one in the previous sections. While those layouts adapt to
@@ -148,7 +148,7 @@ different screens by stretching the space within and around components, they
may not provide the best user experience for each screen size. Therefore, your
application should not only implement flexible layouts, but should also provide
several alternative layouts to target different screen configurations. You do
-so by using configuration qualifiers, which allows the runtime
+so by using configuration qualifiers, which allows the runtime
to automatically select the appropriate resource based on the current device’s
configuration (such as a different layout design for different screen sizes).
@@ -209,13 +209,13 @@ layout.
However, this won't work well on pre-3.2 devices, because they don't
recognize sw600dp as a size qualifier, so you still have to use the large
-qualifier as well. So, you should have a file named
+qualifier as well. So, you should have a file named
res/layout-large/main.xml
which is identical to res/layout-sw600dp/main.xml. In the next section
you'll see a technique that allows you to avoid duplicating the layout files this way.
-
Use Layout Aliases
+
Use Layout Aliases
The smallest-width qualifier is available only on Android 3.2 and above.
Therefore, you should also still use the abstract size bins (small, normal,
@@ -271,7 +271,7 @@ applied to tablets and TVs regardless of Android version (pre-3.2 tablets and TV
{@code large}, and post-3.2 will match sw600dp).
-
Use Orientation Qualifiers
+
Use Orientation Qualifiers
Some layouts work well in both landscape and portrait orientations, but most of them can
benefit from adjustments. In the News Reader sample app, here is how the layout
@@ -287,7 +287,7 @@ behaves in each screen size and orientation:
TV, landscape: dual pane, wide, with action bar
-
So each of these layouts is defined in an XML file in the
+
So each of these layouts is defined in an XML file in the
res/layout/ directory. To then assign each layout to the various screen
configurations, the app uses layout aliases to match them to
each configuration:
@@ -361,7 +361,7 @@ borders indicate the places where the image can be stretched, and the ones on
the right and bottom borders indicate where the content should be
placed.
-
Also, notice the .9.png extension. You must use this
+
Also, notice the .9.png extension. You must use this
extension, since this is how the framework detects that this is a nine-patch
image, as opposed to a regular PNG image.
This lesson explains how to create and issue a notification.
-
The examples in this class are based on the
-{@link android.support.v4.app.NotificationCompat.Builder} class.
-{@link android.support.v4.app.NotificationCompat.Builder}
+
The examples in this class are based on the
+{@link android.support.v4.app.NotificationCompat.Builder} class.
+{@link android.support.v4.app.NotificationCompat.Builder}
is in the Support Library. You should use
{@link android.support.v4.app.NotificationCompat} and its subclasses,
particularly {@link android.support.v4.app.NotificationCompat.Builder}, to
@@ -52,9 +52,9 @@ provide the best notification support for a wide range of platforms.
Create a Notification Builder
-
When creating a notification, specify the UI content and actions with a
-{@link android.support.v4.app.NotificationCompat.Builder} object. At bare minimum,
-a {@link android.support.v4.app.NotificationCompat.Builder Builder}
+
When creating a notification, specify the UI content and actions with a
+{@link android.support.v4.app.NotificationCompat.Builder} object. At bare minimum,
+a {@link android.support.v4.app.NotificationCompat.Builder Builder}
object must include the following:
@@ -96,7 +96,7 @@ of {@link android.app.Activity} you're starting. When you start an {@link
android.app.Activity} from a notification, you must preserve the user's expected
navigation experience. In the snippet below, clicking the notification opens a
new activity that effectively extends the behavior of the notification. In this
-case there is no need to create an artificial back stack (see
+case there is no need to create an artificial back stack (see
Preserving Navigation when Starting an Activity for
more information):
@@ -132,11 +132,11 @@ mBuilder.setContentIntent(resultPendingIntent);
To issue the notification:
-
Get an instance of {@link android.app.NotificationManager}.
+
Get an instance of {@link android.app.NotificationManager}.
Use the {@link android.app.NotificationManager#notify notify()} method to issue the
-notification. When you call {@link android.app.NotificationManager#notify notify()}, specify a notification ID.
-You can use this ID to update the notification later on. This is described in more detail in
+notification. When you call {@link android.app.NotificationManager#notify notify()}, specify a notification ID.
+You can use this ID to update the notification later on. This is described in more detail in
Managing Notifications.
Call {@link
@@ -152,7 +152,7 @@ NotificationCompat.Builder mBuilder;
// Sets an ID for the notification
int mNotificationId = 001;
// Gets an instance of the NotificationManager service
-NotificationManager mNotifyMgr =
+NotificationManager mNotifyMgr =
(NotificationManager) getSystemService(NOTIFICATION_SERVICE);
// Builds the notification and issues it.
mNotifyMgr.notify(mNotificationId, mBuilder.build());
diff --git a/docs/html/training/notify-user/display-progress.jd b/docs/html/training/notify-user/display-progress.jd
index 3439571fe3064..e2cf033d7b6c2 100644
--- a/docs/html/training/notify-user/display-progress.jd
+++ b/docs/html/training/notify-user/display-progress.jd
@@ -59,9 +59,9 @@ trainingnavtop=true
Display a Fixed-duration Progress Indicator
To display a determinate progress bar, add the bar to your notification by calling
- {@link android.support.v4.app.NotificationCompat.Builder#setProgress
- setProgress(max, progress, false)} and then issue the notification.
- The third argument is a boolean that indicates whether the
+ {@link android.support.v4.app.NotificationCompat.Builder#setProgress
+ setProgress(max, progress, false)} and then issue the notification.
+ The third argument is a boolean that indicates whether the
progress bar is indeterminate (true) or determinate (false).
As your operation proceeds,
increment progress, and update the notification. At the end of the operation,
@@ -74,7 +74,7 @@ trainingnavtop=true
You can either leave the progress bar showing when the operation is done, or remove it. In
either case, remember to update the notification text to show that the operation is complete.
To remove the progress bar, call
- {@link android.support.v4.app.NotificationCompat.Builder#setProgress
+ {@link android.support.v4.app.NotificationCompat.Builder#setProgress
setProgress(0, 0, false)}. For example:
@@ -136,14 +136,14 @@ new Thread(
To display a continuing (indeterminate) activity indicator, add it to your notification with
{@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress(0, 0, true)}
- and issue the notification. The first two arguments are ignored, and the third argument
+ and issue the notification. The first two arguments are ignored, and the third argument
declares that the indicator is indeterminate. The result is an indicator
that has the same style as a progress bar, except that its animation is ongoing.
Issue the notification at the beginning of the operation. The animation will run until you
modify your notification. When the operation is done, call
- {@link android.support.v4.app.NotificationCompat.Builder#setProgress
+ {@link android.support.v4.app.NotificationCompat.Builder#setProgress
setProgress(0, 0, false)} and then update the notification to remove the activity indicator.
Always do this; otherwise, the animation will run even when the operation is complete. Also
remember to change the notification text to indicate that the operation is complete.
@@ -160,7 +160,7 @@ mNotifyManager.notify(id, mBuilder.build());
Replace the lines you've found with the following lines. Notice that the third parameter
- in the {@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}
+ in the {@link android.support.v4.app.NotificationCompat.Builder#setProgress setProgress()}
call is set to {@code true} to indicate that the progress bar is
indeterminate:
diff --git a/docs/html/training/notify-user/expanded.jd b/docs/html/training/notify-user/expanded.jd
index b657426829565..23d85d4380928 100644
--- a/docs/html/training/notify-user/expanded.jd
+++ b/docs/html/training/notify-user/expanded.jd
@@ -75,7 +75,7 @@ big view give users access to same functionality:
The normal view provides these features through a new activity that launches
-when the user clicks the notification. Keep this in mind as you design your notifications—first
+when the user clicks the notification. Keep this in mind as you design your notifications—first
provide the functionality in the normal view, since
this is how many users will interact with the notification.
@@ -87,19 +87,19 @@ to construct and issue the notification.
In this snippet, the
{@link android.app.IntentService} method
-{@link android.app.IntentService#onHandleIntent onHandleIntent()} specifies the new activity
+{@link android.app.IntentService#onHandleIntent onHandleIntent()} specifies the new activity
that will be launched if the user
-clicks the notification itself. The method
-{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent setContentIntent()}
+clicks the notification itself. The method
+{@link android.support.v4.app.NotificationCompat.Builder#setContentIntent setContentIntent()}
defines a pending intent that should be fired when the user
clicks the notification, thereby launching the activity.
Intent resultIntent = new Intent(this, ResultActivity.class);
resultIntent.putExtra(CommonConstants.EXTRA_MESSAGE, msg);
-resultIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
+resultIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
Intent.FLAG_ACTIVITY_CLEAR_TASK);
-
-// Because clicking the notification launches a new ("special") activity,
+
+// Because clicking the notification launches a new ("special") activity,
// there's no need to create an artificial back stack.
PendingIntent resultPendingIntent =
PendingIntent.getActivity(
@@ -130,8 +130,8 @@ snoozeIntent.setAction(CommonConstants.ACTION_SNOOZE);
PendingIntent piSnooze = PendingIntent.getService(this, 0, snoozeIntent, 0);
-
This snippet shows how to construct the
-{@link android.support.v4.app.NotificationCompat.Builder Builder} object.
+
This snippet shows how to construct the
+{@link android.support.v4.app.NotificationCompat.Builder Builder} object.
It sets the style for the big
view to be "big text," and sets its content to be the reminder message. It uses
{@link android.support.v4.app.NotificationCompat.Builder#addAction addAction()}
diff --git a/docs/html/training/notify-user/index.jd b/docs/html/training/notify-user/index.jd
index 616e767873f8e..57efd65128497 100644
--- a/docs/html/training/notify-user/index.jd
+++ b/docs/html/training/notify-user/index.jd
@@ -43,9 +43,9 @@ class="button">Download the sample
- A notification is a user interface element that you display outside your app's normal UI to indicate
- that an event has occurred. Users can choose to view the notification while using other apps and respond
- to it when it's convenient for them.
+ A notification is a user interface element that you display outside your app's normal UI to indicate
+ that an event has occurred. Users can choose to view the notification while using other apps and respond
+ to it when it's convenient for them.
@@ -86,10 +86,10 @@ class="button">Download the sample
- Learn how to create a big view within an expanded notification, while still maintaining
+ Learn how to create a big view within an expanded notification, while still maintaining
backward compatibility.
-
+
Displaying Progress in a Notification
diff --git a/docs/html/training/notify-user/navigation.jd b/docs/html/training/notify-user/navigation.jd
index b7051ab5f1fab..cdb7f3d6e0c45 100644
--- a/docs/html/training/notify-user/navigation.jd
+++ b/docs/html/training/notify-user/navigation.jd
@@ -37,7 +37,7 @@ trainingnavtop=true
- Part of designing a notification is preserving the user's expected navigation experience.
+ Part of designing a notification is preserving the user's expected navigation experience.
For a detailed discussion of this topic, see the
Notifications
API guide.
@@ -49,7 +49,7 @@ trainingnavtop=true
You're starting an {@link android.app.Activity} that's part of the application's normal
- workflow.
+ workflow.
Special activity
@@ -202,7 +202,7 @@ NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
Intent notifyIntent =
new Intent(new ComponentName(this, ResultActivity.class));
// Sets the Activity to start in a new, empty task
-notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
+notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK |
Intent.FLAG_ACTIVITY_CLEAR_TASK);
// Creates the PendingIntent
PendingIntent notifyIntent =
diff --git a/docs/html/training/run-background-service/report-status.jd b/docs/html/training/run-background-service/report-status.jd
index 41121c17e3e68..41fbb00e115ff 100644
--- a/docs/html/training/run-background-service/report-status.jd
+++ b/docs/html/training/run-background-service/report-status.jd
@@ -91,7 +91,7 @@ public class RSSPullService extends IntentService {
Receive Status Broadcasts from an IntentService
-
+
To receive broadcast {@link android.content.Intent} objects, use a subclass of
{@link android.content.BroadcastReceiver}. In the subclass, implement the
{@link android.content.BroadcastReceiver#onReceive BroadcastReceiver.onReceive()} callback
@@ -137,7 +137,7 @@ public class DisplayActivity extends FragmentActivity {
// The filter's action is BROADCAST_ACTION
IntentFilter mStatusIntentFilter = new IntentFilter(
Constants.BROADCAST_ACTION);
-
+
// Adds a data filter for the HTTP scheme
mStatusIntentFilter.addDataScheme("http");
...
@@ -194,6 +194,6 @@ public class DisplayActivity extends FragmentActivity {
{@link android.content.Intent}.
- Google Sign-In for Android lets you authenticate a user with the same credentials they use on
- Google. After a user signs in with Google, you can create more engaging experiences and drive
+ Google Sign-In for Android lets you authenticate a user with the same credentials they use on
+ Google. After a user signs in with Google, you can create more engaging experiences and drive
usage of your app.
@@ -34,8 +34,8 @@ page.trainingcourse=true
Access the profile and social graph
- After users have signed in with Google, your app can welcome them by name and display their
- picture. If your app requests social scopes, it can connect users with friends, and access
+ After users have signed in with Google, your app can welcome them by name and display their
+ picture. If your app requests social scopes, it can connect users with friends, and access
age range, language, and public profile information.
Getting Profile Information.
@@ -47,6 +47,6 @@ page.trainingcourse=true
The Google Android APIs are part of the Google Play services platform. To use Google features,
set up the Google Play services SDK in your app development project. For more information, see
the Start Integrating
+ "https://developers.google.com/identity/sign-in/android/start-integrating">Start Integrating
guide for Google Sign-In.
\ No newline at end of file
diff --git a/docs/html/wear/preview/features/ime.jd b/docs/html/wear/preview/features/ime.jd
index 1301be9afb2a7..b07736f1da30e 100644
--- a/docs/html/wear/preview/features/ime.jd
+++ b/docs/html/wear/preview/features/ime.jd
@@ -19,14 +19,14 @@ page.tags="wear"
-
Wear 2.0 supports input methods beyond voice by extending the Android
+
Wear 2.0 supports input methods beyond voice by extending the Android
Input Method Framework (IMF) to Android Wear. IMF allows for virtual, on-screen
- keyboards and other input methods to be used for text entry. The IMF APIs used
- for Wear devices are the same as other form factors, though usage is slightly
+ keyboards and other input methods to be used for text entry. The IMF APIs used
+ for Wear devices are the same as other form factors, though usage is slightly
different due to limited screen real estate.
-
Wear 2.0 comes with the system default Input Method Editor (IME)
-and opens up the IMF APIs for third-party developers to create custom input
+
Wear 2.0 comes with the system default Input Method Editor (IME)
+and opens up the IMF APIs for third-party developers to create custom input
methods for Wear.
@@ -46,17 +46,17 @@ documentation for
Invoking an Input Method
-If you are developing an IME for Wear, remember that the
-feature is supported only on Android 6.0 (API level 23) and higher versions of
-the platform.
-To ensure that your IME can only be installed on Wearables that support input
+If you are developing an IME for Wear, remember that the
+feature is supported only on Android 6.0 (API level 23) and higher versions of
+the platform.
+To ensure that your IME can only be installed on Wearables that support input
methods beyond voice, add the following to your app's manifest:
<uses-sdk android:minSdkVersion="23" />
-This indicates that your app requires Android 6.0 or higher.
+This indicates that your app requires Android 6.0 or higher.
For more information, see API Levels
- and the documentation for the <uses-sdk>
+ and the documentation for the <uses-sdk>
element.
To control how your app is filtered from devices that do not support Wear
@@ -67,14 +67,14 @@ IMEs (for example, on Phone), add the following to your app's manifest:
Wear provides user settings on the watch that lets the user to enable multiple
- IMEs from the list of installed IMEs. Once the users enable your IME, they
+ IMEs from the list of installed IMEs. Once the users enable your IME, they
can invoke your IME from:
-
A notification or an app using the
+
A notification or an app using the
RemoteInput API.
-
Wear apps with an
+
Wear apps with an
EditText
- field. Touching a text field places the cursor in the field and automatically
+ field. Touching a text field places the cursor in the field and automatically
displays the IME on focus.
@@ -86,10 +86,10 @@ IMEs (for example, on Phone), add the following to your app's manifest:
Set Default Action
-{@code RemoteInput}
+{@code RemoteInput}
and Wear apps expect only single-line text entry. The ENTER key should always trigger
a call to sendDefaultEditorAction,
- which causes the app to dismiss the keyboard and continue on to the next step
+ which causes the app to dismiss the keyboard and continue on to the next step
or action.
@@ -97,22 +97,22 @@ and Wear apps expect only single-line text entry. The ENTER key should always tr
Input methods on Wear consume most of the screen, leaving very little of the
app visible; using full-screen mode ensures an optimal user experience regardless
- of the app UI. In full-screen mode, an
+ of the app UI. In full-screen mode, an
{@code ExtractEditText} provides a mirrored
view of the text field being edited and can be styled to blend with the rest of
- the input method UI. For more details on full-screen mode, see
+ the input method UI. For more details on full-screen mode, see
InputMethodService.
Handle InputType flags
-For privacy reasons, at a minimum you should handle the {@code InputType}
-flag {@code TYPE_TEXT_VARIATION_PASSWORD} in your IME. When your IME is in
-password mode, make sure that your keyboard is optimized for single key press
-(auto spelling correction, auto completion and gesture input are disabled).
-Most importantly, keyboard in password mode should support ASCII symbols
-regardless of the input language. For more details, see
+For privacy reasons, at a minimum you should handle the {@code InputType}
+flag {@code TYPE_TEXT_VARIATION_PASSWORD} in your IME. When your IME is in
+password mode, make sure that your keyboard is optimized for single key press
+(auto spelling correction, auto completion and gesture input are disabled).
+Most importantly, keyboard in password mode should support ASCII symbols
+regardless of the input language. For more details, see
Specifying The Input Method Type.
@@ -120,9 +120,9 @@ regardless of the input language. For more details, see
Provide a key for switching to the next input method
Android allows users to easily switch between all IMEs supported by the platform.
- In your IME implementation, set the boolean
+ In your IME implementation, set the boolean
supportsSwitchingToNextInputMethod = true
- to enable your IME to support the switching mechanism
+ to enable your IME to support the switching mechanism
(so that apps can switch to the next platform-supported IME).
diff --git a/docs/html/wear/preview/features/notifications.jd b/docs/html/wear/preview/features/notifications.jd
index c84a47002f9d1..dcc09709deb3f 100644
--- a/docs/html/wear/preview/features/notifications.jd
+++ b/docs/html/wear/preview/features/notifications.jd
@@ -155,7 +155,7 @@ action in the notification unless a different action is specified using
Call the method {@code setAllowGeneratedReplies()} for the notification action.
- For more information, see the downloadable
+ For more information, see the downloadable
API reference.
Ensure that the notification action has a
diff --git a/docs/html/work/cosu.jd b/docs/html/work/cosu.jd
index 8bc54d49bc8ec..f66006bab1f5d 100644
--- a/docs/html/work/cosu.jd
+++ b/docs/html/work/cosu.jd
@@ -223,7 +223,7 @@ and {@link android.app.Activity#onPause()}
-Starting from Marshmallow, if your app is whitelisted by an EMM using {@link
+Starting from Marshmallow, if your app is whitelisted by an EMM using {@link
android.app.admin.DevicePolicyManager#setLockTaskPackages setLockTaskPackages},
your activities can automatically start lock task mode when the app is
launched.
@@ -253,15 +253,15 @@ launch into lock task mode. Non-privileged apps are treated as normal.
The default value of the {@link android.R.attr#lockTaskMode} attribute is
-normal. When this attribute is set to normal, tasks don’t launch into
-{@link android.R.attr#lockTaskMode}, unless {@link android.app.Activity#startLockTask()}
+normal. When this attribute is set to normal, tasks don’t launch into
+{@link android.R.attr#lockTaskMode}, unless {@link android.app.Activity#startLockTask()}
is called. To call {@link android.app.Activity#startLockTask()},
-applications still need to be whitelisted using
-{@link android.app.admin.DevicePolicyManager#setLockTaskPackages setLockTaskPackages},
+applications still need to be whitelisted using
+{@link android.app.admin.DevicePolicyManager#setLockTaskPackages setLockTaskPackages},
otherwise, the user sees a dialog to approve entering pinned mode.
-
+
To have your activity automatically enter {@link android.R.attr#lockTaskMode},
change the value of this attribute to if_whitelisted.
Doing so causes your app to behave in this manner:
@@ -289,7 +289,7 @@ Example XML as follows:
Given either of these options, you still need to create a mechanism for
calling {@link android.app.Activity#stopLockTask()} so that users can
-exit {@link android.R.attr#lockTaskMode}.
+exit {@link android.R.attr#lockTaskMode}.
To manage applications in COSU, you need a DPC running as device
-owner to set several policies on the device.
+owner to set several policies on the device.
-
@@ -148,7 +148,7 @@ pengguna untuk memulai aktivitas tertentu dari lebih dari satu aktivitas, instan
aktivitas tersebut akan dibuat dan didorong ke back-stack (bukannya memunculkan instance sebelumnya dari
aktivitas ke atas). Dengan demikian, satu aktivitas pada aplikasi Anda mungkin dibuat beberapa
kali (bahkan dari beberapa tugas), seperti yang ditampilkan dalam gambar 3. Dengan demikian, jika pengguna mengarahkan mundur
-menggunakan tombol Back, setiap instance aktivitas ini akan ditampilkan dalam urutan saat
+menggunakan tombol Back, setiap instance aktivitas ini akan ditampilkan dalam urutan saat
dibuka (masing-masing
dengan status UI sendiri). Akan tetapi, Anda bisa memodifikasi perilaku ini jika tidak ingin aktivitas
dibuat instance-nya lebih dari sekali. Caranya dibahas di bagian selanjutnya tentang 
-
-
-
-
-
-
-
@@ -113,77 +113,77 @@ page.title=캘린더 제공자
@@ -129,7 +129,7 @@ Android 구성 요소입니다. 콘텐츠 제공자는 기기의 연락처 애
그림 1. 연락처 제공자 테이블 구조입니다.
@@ -446,51 +446,51 @@ Email.CONTENT_ITEM_TYPE}을 갖는
@@ -556,67 +556,67 @@ Google 계정과 같고, 이는 계정 이름으로 이메일 주소를 사용
-
-
-
-
-
-
- 
-
@@ -116,7 +116,7 @@ botão Voltar continua até a Tela inicial.
-
-
+href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission>
+reference for more information about declaring application permissions.
+
+
+
+
+
+
+opens an RFCOMM channel to the server.
+
+
- 
-
-
+
+
-
stylized typeface logo) are not included
in the license.
@@ -74,7 +74,7 @@ Please see 
