Utilizando React Hooks + Capacitor para acceder a las API nativas móviles

Hola, mi nombre es Thomas Vietas y soy un Ingeniero de Experiencia de Desarrollo de Capacitor que trabaja en Ionic y hoy voy a explicar cómo puedes usar los hooks de React y Capacitor juntos para acceder a las API nativas móviles.

Primero que nada, es posible que estés pensando, ¿qué diablos es Capacitor? Nunca había oído hablar de esto. ¡No te preocupes! Capacitor es una herramienta creada por Ionic que te permite compilar tus aplicaciones web en un proyecto nativo de iOS o un proyecto nativo de Android. Es de código abierto, con licencia MIT. Puedes pensar en ello como React Native o como Flutter. La gran diferencia es que estamos tomando tu HTML, tu CSS, tu JavaScript y colocándolo en un proyecto de iOS o Android. Si funciona en la web, funcionará con Capacitor.

Es muy poderoso. Capacitor viene con un conjunto de complementos, por lo que puedes acceder a cosas como el almacenamiento, el sistema de archivos, la información del dispositivo o, en este ejemplo, la cámara. También proporcionamos una API para que puedas comunicarte a través de nuestro puente de JavaScript. Puedes hacer cosas en la web, llamar a nuestro puente y eso hará cosas en el nativo. Es bastante sencillo y tenemos toneladas de documentación sobre cómo construir tus propios complementos, así como una gran comunidad de complementos existentes.

Usar el complemento de Capacitor es bastante sencillo, así que veamos cómo usar el complemento de la cámara. Importamos nuestra cámara desde el paquete de cámara de Capacitor y tenemos un objeto de cámara en este tipo de resultado, que simplemente nos dice si esto es una URI, es Base64, cosas así. Echemos un vistazo a nuestro objeto de cámara. Una cámara tiene un objeto de función llamado getphoto. Getphoto nos permite tomar una nueva foto o acceder a nuestra galería a través de una sola llamada de función, y eso nos permite establecer la calidad o si queremos abrir la edición en el editor nativo. Esto es algo que no podemos hacer en la web o en una PWA, por lo que es una herramienta muy poderosa para abrir el editor nativo y hacer que se sienta realmente nativo. Así que volvamos al código. La cámara.getphoto devuelve una imagen y a partir de ahí, buscamos el elemento de imagen HTML, como una etiqueta de imagen, y establecemos ese elemento de imagen HTML en los datos de imagen que hemos seleccionado de la galería. Esto funciona muy bien en cualquier aplicación de React o cualquier aplicación web, pero esto puede no sentirse muy Reactivo o muy hooky si estás usando hooks de manera intensiva en tu proyecto.

Tenemos una gran comunidad, nuestra organización de comunidad de Capacitor, que ha creado un paquete de hooks de React. Los hooks de React envuelven todos nuestros complementos oficiales, como los que mencioné antes, el almacenamiento, el sistema de archivos, en este caso, la cámara, y los hacen sentir como en casa en tu aplicación de React que utiliza hooks de manera intensiva. Echemos un vistazo a la API del complemento de cámara de los hooks de React. Tenemos useCallback, que es un hook nativo de React, y tenemos useCamera, que es nuestro hook de cámara de la comunidad de Capacitor. Tenemos nuestro tipo de resultado que teníamos antes de nuestro paquete de cámara de Capacitor. Llamamos a nuestro hook useCamera para obtener nuestra foto, que es nuestro objeto de foto, y nuestro getPhoto, que llama a esa función de cámara.getPhoto que mostré en el otro ejemplo. Puedes pensar en esto como algo muy similar a useState, donde tenemos nuestro estado y luego nuestro setState. Luego tenemos esta función triggerCamera, que llama a useCallback, llama a nuestra cámara.getPhoto con la opción de permitir la edición y el tipo de resultado que queremos.

Se siente mucho más familiar en una aplicación con muchos hooks de React. Pasemos a una demostración que preparé previamente. Así que aquí hay dos componentes importantes. Tenemos nuestra aplicación, que es simplemente nuestro archivo app.tsx que la mayoría de las aplicaciones tienen. Tenemos este otro componente personalizado llamado nuestro botón de gancho de cámara, al que vamos a ir. Este es solo un componente que tiene un div que muestra condicionalmente nuestra imagen si seleccionamos una foto y un botón que podemos hacer clic para activar nuestra cámara que dice, haz clic en mí. Vamos a pasar a las cosas buenas. En nuestro ejemplo de diapositivas, tenemos foto y getphoto, que llama a nuestro gancho useCamera. Y a partir de ahí tenemos triggerCamera, que llama a nuestro gancho useCallback, que llama a, puedes pensar en esto como camera.getphoto, pero obteniéndolo del gancho. Es solo getphoto, es calidad del 100 por ciento. No quieres abrir el editor nativo con nuestro tipo de resultado, que es una URL de datos. Una vez que hemos seleccionado, una vez que activamos nuestra cámara, hemos cambiado este botón, hemos seleccionado algo que establecerá esta foto en un valor que luego mostrará condicionalmente esta etiqueta de imagen.

Así que vamos a ver esto en acción. Ya he compilado la aplicación iOS y la he puesto en este simulador de iOS. Esto está ejecutando el simulador de iOS. Viene incluido con Xcode, puedes obtenerlo de forma gratuita en cualquier Mac, Apple lo proporciona, es genial para probar, incluso solo tu aplicación web para ver cómo se ve en iOS. Tenemos nuestra aplicación Hello React Summit. Esta es una aplicación nativa, así que aquí, React Summit. Dice, Hola React Summit, y este botón Haz clic en mí, a partir de lo que tenemos aquí. Haz clic en mí. Así que vamos a hacer clic en él, así activamos el gancho de devolución de llamada de la cámara. Seleccionaré más fotos y elegiré esta hermosa cascada. Y a partir de ahí, ¡tada! Tenemos esta cascada. Es genial. Este código se siente mucho más familiar. Me encantan los hooks de React, esto se siente mucho más familiar al escribir mucho del otro código. Podemos configurar esto con useEffect para que se active automáticamente cuando se cargue por primera vez. O podemos configurarlo con useState para poder seleccionar varias fotos. Es realmente poderoso y se siente como en casa con cualquier otro código de React.

Así que voy a mencionar nuestra comunidad en github.com/capacitor. Esto es mantenido por Ionic, pero todos estos desarrolladores y todos estos complementos son mantenidos por nuestra gran comunidad de Ionic. Tenemos algunos complementos geniales de Capacitor, como la integración con Stripe. Cosas como un complemento de hooks de React, reproductores de audio o video nativos, HTTP nativo. Es realmente poderoso. Echa un vistazo si tienes una aplicación web de React que deseas convertir en una aplicación de Android e iOS. Nuevamente, soy Thomas Betus de Ionic, y muchas gracias por quedarte en mi Charla Relámpago, y estaré en el chat si tienen alguna pregunta. Gracias.