Tutorial para aprender algunos caso de uso del objeto Intent en aplicaciones Android.

Hasta ahora, las apps sobre las que trabajaste tuvieron una sola 
actividad. En realidad, muchas apps para Android requieren varias 
actividades y navegación entre ellas.

En este tutorial, crearás una app de diccionario de modo que 
utilice varias actividades, en conjunto con&nbsp;intents para navegar entre ellas y también enviar información a otras apps.

Introducción

A lo la, trabajarás con la app "Words". Esta es una app de diccionario simple que muestra un listado de letras y palabras para cada letra, teniendo a su vez la capacidad de buscar definiciones de cada palabra en el navegador.

Puede que parezca mucho, pero no te preocupes:no tendrás que 
compilar una app completa para aprender sobre <code class="inline-code">Intents</code>. En cambio, se te 
proporcionó una versión incompleta del proyecto, conocida como proyecto 
inicial.

Si bien todas las pantallas están implementadas, aún no puedes 
navegar de una a otra. Tu tarea es usar <code class="inline-code">Intents</code> de modo que todo el 
proyecto funcione, sin tener que compilar todo desde cero.

Para poder realizar este tutorial deberás clonar el proyecto presente en el siguiente repositorio de GitHub.

Antes de continuar, dedica un momento a explorar el proyecto.&nbsp;Todos los conceptos deberían resultarte conocidos de unidades anteriores. 

Inicialmente, la app consta de dos actividades, cuyas vistas son definidas por las funciones composables presentes en el paquete <code class="inline-code">screens</code>. Dentro del paquete <code class="inline-code">components</code> se encuentra el componente que diseña un <code class="inline-code">TopAppBar</code> personalizada y será utilizada en ambas vistas. Dentro de <code class="inline-code">utils</code> tenemos un archivo de kotlin en el que definimos dos constantes: <code class="inline-code">LETTER</code>, que usamos para pasar información entre pantallas, y <code class="inline-code">SEARCH_PREFIX</code>, que es la dirección que usamos para buscar definiciones de palabras en Google.

A lo largo de este tutorial, nos encontraremos con varios puntos marcados como "TODO" en el código. Estas marcas son indicaciones de tareas pendientes que, como desarrollador, debes completar para avanzar en el proyecto y reforzar los conceptos aprendidos.

Para encontrar los puntos que a implementar deberás utilizar la vista 'TODO' en Android Studio, la cual está accesible desde la barra lateral izquierda de nuestro IDE.

Para esta sesión, se requiere que implementes las funcionalidades señaladas en cada uno de los elementos TODO que han sido dispuestos en el código.&nbsp;

Cuando te sientas cómodo con el proyecto tal como está hasta ahora, continúa a la siguiente sección, en la que aprenderás sobre los intents.

Descripción general de la App "Words"

Una vez que configuraste el proyecto inicial, revisemos que es un <code class="inline-code">Intent</code> y como puedes utilizarlos en tus Apps.

Los Intents son objetos(de la clase <code class="inline-code">Intent</code>), que básicamente son usados para intercambiar información entre un componente y otro, dentro del sistema de Android, y dicha información puede ser con fines meramente comunicativos, o también para ejecutar determinadas acciones preestablecidas que la Actividad original, en teoría no cuenta con ellas, y por ello requiere funciones extras.

Usarás un intent explícito para realizar acciones o presentar pantallas en tu propia app y serás el responsable de todo el proceso. Por lo general, usas intents implícitos a fin de realizar acciones que involucran otras apps y que dependen del sistema a efectos de determinar el resultado final. Usarás ambos tipos de intents en la app de Words.

Intents

Es hora de implementar tu primer <code class="inline-code">Intent</code>. En la primera pantalla, cuando 
el usuario presione una letra, se lo debe dirigir a una segunda pantalla
 con una lista de palabras. La <code class="inline-code"><code>DetailActivity</code></code> ya está implementada, por lo que todo lo que se necesita es iniciarla 
mediante un <code class="inline-code">Intent</code>. Como tu app conoce exactamente qué actividad se debe 
iniciar, utilizarás un intent explícito.

Para crear y usar un <code class="inline-code">Intent</code>, solo necesitas seguir algunos pasos:

Recuerda que un <code class="inline-code">Intent</code> es solo un conjunto de 
instrucciones, todavía no hay una instancia de la actividad de destino. 
En cambio, un <code class="inline-code">extra</code> es un dato al que se le asigna un nombre que se 
puede recuperar más adelante, como un número o una cadena. Esto es 
similar a pasar un argumento cuando llamas a una función. Dado que se 
puede mostrar una <code class="inline-code"><code>DetailActivity</code></code> para cualquier letra, debes indicarle cuál letra presentar.

Ahora ejecuta la app y presiona una letra. Se mostrará la pantalla de 
detalles. No obstante, independientemente de la letra que presione el 
usuario, la pantalla de detalles siempre mostrará las palabras que 
comienzan con la letra&nbsp;A.

Aún debes trabajar sobre algunas cosas en la 
actividad de los detalles de modo que aparezcan las palabras 
correspondientes a la letra que se pase como el<code> </code><code class="inline-code"><code>Intent</code></code> extra.

Configura la MainActivity

Acabas de crear tu primer intent explícito. Ahora, continuemos con la pantalla de detalles.

En el método <code class="inline-code">onCreate</code> de <code class="inline-code">DetailActivity</code>, después de la llamada a&nbsp; <code class="inline-code">super.onCreate</code>, reemplaza la letra hard-coded con el código que obtenga el letterId que se pasó desde el <code class="inline-code">Intent</code>. Dentro del lambda <code class="inline-code">onBackClick</code> llamaremos a la función <code class="inline-code">finish</code>, la cual finaliza la ejecución de la actividad actual.

Veamos cada parte de todo lo que está ocurriendo:

En primer lugar, ¿de dónde proviene la propiedad <code class="inline-code">intent</code>? No es una propiedad de <code class="inline-code">DetailActivity</code>, sino una propiedad de cualquier actividad. Mantiene una referencia al intent utilizado a efectos de iniciar la actividad.

El método <code class="inline-code">getStringExtra</code>, brinda una forma de acceder a todos los extras de tipo <code class="inline-code">String </code>pasados al intent. El retorno de este método puede ser nulo por lo que utilizamos el operador&nbsp; Elvis (<code class="inline-code">?:</code>) que nos ayuda a devolver un valor predeterminado cuando el que se retorne sea nulo.

Una vez obtenido el valor de la letra enviada desde la <code class="inline-code">MainActivity</code>, continuaremos con la implementación de las funciones marcadas como TODO pertenecientes a la <code class="inline-code">DetailActivity</code>.

Iniciaremos implementando la obtención de las palabras que inicien con la letra enviada junto con el <code class="inline-code">Intent</code>. El primer paso es acceder a nuestro conjunto de datos, que, en este caso, es un <code class="inline-code">StringArray</code> definido en nuestros resources con el nombre "words". Una vez obtenidas las palabras utilizamos el método <code class="inline-code">filter</code> para seleccionar solo aquellas palabras que comienzan con la letra especificada.

Ahora seguiremos con la implementación del intent implícito que nos permitirá realizar una búsqueda en Google para obtener la definición de la palabra seleccionada. Primero, crea un <code class="inline-code">Uri</code> para la búsqueda. Cuando llamas <code>a </code><code class="inline-code">parse()</code> con el fin de crear un <code class="inline-code">Uri</code> desde una <code class="inline-code">String</code>, debes usar el formato de cadena de modo que la palabra se agregue al <code class="inline-code">SEARCH_PREFIX</code>.

En lugar de pasar un contexto y una actividad, pasas <code class="inline-code">Intent.ACTION_VIEW</code> (una acción del dispositivo) junto con el <code class="inline-code">URI</code>.

Por último, aunque no inicies una actividad en particular en tu app, puedes indicar al sistema que inicie otra app llamando a <code class="inline-code">startActivity()</code> y pasando la referencia del <code class="inline-code">intent</code>.

Si te preguntas qué es un <code class="inline-code">URI</code>, no es un error tipográfico, sino un <code class="inline-code">identificador uniforme de recursos</code>. Es posible que sepas que una <code class="inline-code">URL</code>, o localizador uniforme de recursos, es una cadena que apunta a una página web. Un <code class="inline-code">URI</code> es un término más general para el formato. Todas las URLs son URIs, pero no todos los URIs son URLs. Otros URIs (por ejemplo, una dirección relacionada con un número de teléfono), comenzarán con <code class="inline-code">tel:</code>, pero estos se consideran <code class="inline-code">URN</code> o nombres uniformes de recursos y no <code class="inline-code">URL</code>. El tipo de datos que se usa para representar ambos se denomina <code class="inline-code">URI</code>.

<code class="inline-code">ACTION_VIEW</code> es un intent genérico que recibe un <code class="inline-code">URI</code>, en tu caso, una dirección web. Luego, el sistema sabrá que debe procesar este intent abriendo el <code class="inline-code">URI</code> en el navegador web del usuario.

Entre otros tipos de intents, se incluyen los siguientes:

Para obtener más información, consulta la documentación sobre algunos<a href="https://developer.android.com/guide/components/intents-common?hl=es-419"> intents de uso frecuente</a>.

Configura la DetailActivity

Iniciar otra actividad, ya sea dentro de tu app o desde otra, no tiene por qué ser una operación unidireccional. También puedes iniciar una actividad y recibir un resultado. Por ejemplo, tu app puede iniciar una app de cámara y recibir la foto tomada como resultado. También puedes iniciar la App de Contactos para que el usuario seleccione un contacto y, luego, recibir los detalles correspondientes como resultado.

Para practicar el funcionamiento de este API crearás una tercera actividad y la llamarás <code class="inline-code">CameraActivity</code>, borra las composables generadas por el IDE.

Para comenzar, se define un <code class="inline-code">ActivityResultContract</code>, que especifica el tipo de acción a realizar y el tipo de resultado esperado. Por ejemplo, <code class="inline-code">ActivityResultContracts.TakePicture</code> puede usarse para capturar una imagen. Este contrato asegura que la actividad que se lanza y el resultado esperado estén claramente definidos.

Posteriormente, se crea un <code class="inline-code">ActivityResultLauncher</code> utilizando <code class="inline-code">rememberLauncherForActivityResult</code>, pasando el contrato definido anteriormente y un callback que manejará el resultado. Este lanzador se encarga de iniciar la actividad y recibir el resultado una vez que la actividad finaliza.

Dentro de un composable, se puede invocar el método <code class="inline-code">launch</code> del <code class="inline-code">ActivityResultLauncher</code>, generalmente en respuesta a una acción del usuario, como hacer clic en un botón. Este método inicia la actividad correspondiente al contrato.

Cuando la actividad lanzada concluye, el callback proporcionado al crear el <code class="inline-code">ActivityResultLauncher</code> se invoca con el resultado. Este callback permite manejar el resultado dentro del contexto de Compose, actualizando el estado de la UI o realizando otras acciones necesarias.

Crea un archivo de kotlin en el paquete <code class="inline-code">screens</code> nombrado <code class="inline-code">CameraResultScreen</code>, dentro crearás la siguiente función que define la vista de presente en <code class="inline-code">CameraActivity</code>.

Ahora utiliza la composable previamente definida en la función <code class="inline-code">setContent</code> de la <code class="inline-code">CameraActivity</code>.

Por último te moverás a la <code class="inline-code">MainActivity</code> e implementarás el método <code class="inline-code">onCameraClick</code> para que mediante un intent explícito navegues hacia la <code class="inline-code">CameraActivity</code>.

Intents y Actividades

Yael Alejandro Anaya Orozco

Introducción

Requisitos previos

¿Qué aprenderás?