Clase 02 · Módulo 09
Cámara, galería y subir archivos
Cámara, galería y subir archivos
Qué logras en esta clase
Tu app recibe una imagen del usuario y la deja guardada en la nube, liviana y protegida.
- Abres la galería o la cámara con pocas líneas.
- Reduces la imagen antes de subirla.
- Eliges entre bucket público y privado.
- Escribes la regla que impide ver archivos ajenos.
02
El recorrido de una imagen
Cada paso tiene una librería y un error típico. La clase los recorre en ese orden.
03
Dos librerías para dos necesidades
expo-image-picker | expo-camera | |
|---|---|---|
| Qué muestra | La galería y la cámara del sistema | La cámara dentro de tu propia pantalla |
| Esfuerzo | Bajo | Medio |
| Conviene para | Avatares, fotos de productos, comprobantes | Escáner de códigos, visor con guías propias |
Empieza con el selector. Pasa a expo-camera solo si necesitas controlar lo que se ve mientras se apunta.
04
Instalar y declarar
- Ejecuta
npx expo install expo-image-picker. - Agrega el plugin en
app.jsoncon tus textos:cameraPermissionyphotosPermission. - Si no grabas video, pon
microphonePermissionenfalsepara que Android no declare el micrófono. - Genera un nuevo development build.
05
La galería no necesita permiso
Para elegir una foto, el selector del sistema no requiere pedir permiso: el usuario entrega solo la imagen que escoge.
06
Por qué importa usar el selector
Con el selector, tu app nunca ve el resto de la galería. Menos datos, menos riesgo y una pregunta menos al usuario.
Las tiendas empujan en la misma dirección:
- Apple pide usar el selector del sistema cuando basta.
- Google Play reserva el acceso amplio a fotos y videos para apps cuya función central lo exige, como una galería.
07
La cámara sí necesita permiso
const permiso = await ImagePicker.requestCameraPermissionsAsync();
if (!permiso.granted) return ofrecerGaleria();
const resultado = await ImagePicker.launchCameraAsync({ quality: 0.8 });launchImageLibraryAsync abre la galería con las mismas opciones y el mismo tipo de resultado.
08
Qué devuelve el selector
canceled:truesi el usuario cerró sin elegir. Revísalo primero.assets: la lista de elementos elegidos. Cada uno trae:uri: la ubicación del archivo dentro del teléfono.widthyheight: el tamaño en píxeles.mimeTypeyfileSize: el tipo de archivo y su peso en bytes.
La uri es local: solo sirve en ese teléfono. Para que otros vean la imagen hay que subirla.
09
Opciones que más vas a usar
| Opción | Qué hace |
|---|---|
mediaTypes | Qué se puede elegir: ['images'], ['videos'] o ambos |
allowsEditing | Muestra un recorte antes de confirmar |
quality | Compresión de 0 a 1; más bajo pesa menos |
allowsMultipleSelection | Permite elegir varias a la vez |
El recorte y la selección múltiple no se pueden activar juntos.
10
Android puede cerrar tu app mientras eliges
En teléfonos con poca memoria, Android puede cerrar tu pantalla mientras la cámara está abierta. Al volver, el resultado se perdió.
La librería ofrece getPendingResultAsync para recuperarlo al reabrir.
11
Nadie necesita doce megapíxeles en un avatar
Una foto recién tomada pesa varios megabytes. Subirla tal cual gasta datos del usuario, espacio tuyo y tiempo de todos.
12
Reducir antes de subir
Con expo-image-manipulator (se instala con npx expo install):
- Cargas la imagen desde su
uri. - Encadenas las transformaciones: cambiar tamaño, recortar, rotar.
- Generas el resultado.
- Lo guardas eligiendo formato y compresión.
Si indicas solo el ancho al cambiar tamaño, el alto se ajusta solo y la imagen no se deforma.
13
Reducir, en código
const contexto = ImageManipulator.manipulate(uri);
const imagen = await contexto.resize({ width: 1280 }).renderAsync();
const lista = await imagen.saveAsync({
compress: 0.7, format: SaveFormat.JPEG, base64: true,
});compress va de 0 (máxima compresión) a 1 (sin comprimir). base64: true deja el contenido listo para el paso de subida.
14
Cuánto reducir: un punto de partida
| Uso | Ancho sugerido | Motivo |
|---|---|---|
| Avatar | 400 px | Se muestra pequeño |
| Foto en una lista o ficha | 1.200 px | Cubre el ancho de la pantalla |
| Documento que se debe leer | 1.600 px o más | El texto no puede quedar borroso |
Son valores para empezar, no reglas. Sube una prueba, mírala en un teléfono real y ajusta.
15
Storage y sus buckets
Storage es el servicio de archivos de Supabase. Los archivos se guardan en buckets, contenedores con nombre y reglas propias.
- Cada archivo tiene una ruta:
carpeta/nombre.jpg. - Un bucket nuevo es privado salvo que lo marques como público.
- Cada bucket puede limitar el tamaño máximo y los tipos de archivo aceptados.
Al 18-11-2026 el plan Free incluye 1 GB en total y 50 MB por archivo. Compruébalo en supabase.com/pricing.
16
Bucket público o privado
| Público | Privado | |
|---|---|---|
| Quién lee | Cualquiera que tenga la URL | Solo quien cumple una política |
| Quién sube o borra | Solo quien cumple una política | Solo quien cumple una política |
| Rendimiento | Mejor: se guarda en caché | Menor |
| Conviene para | Logos, fotos de catálogo | Comprobantes, documentos, fotos personales |
Si dudas, es privado.
17
Sin política, nadie sube nada
Por defecto, Storage rechaza cualquier subida a un bucket que no tenga políticas. Las reglas son RLS, la misma idea vista en el módulo 8, sobre la tabla storage.objects.
- Subir un archivo requiere permiso de
insert. - Sobrescribir uno existente requiere además
selectyupdate. - Leer de un bucket privado requiere
select.
18
El patrón «carpeta por usuario»
Cada usuario sube a una carpeta que se llama como su identificador: <id-usuario>/comprobante-0412.jpg.
create policy "subir a mi carpeta" on storage.objects
for insert to authenticated
with check (
bucket_id = 'comprobantes'
and (storage.foldername(name))[1] = (select auth.jwt()->>'sub')
);auth.jwt()->>'sub' es el identificador del usuario dentro de su token, el mismo que entrega auth.uid().
19
Subir desde la app
import { decode } from 'base64-arraybuffer';
const { error } = await supabase.storage
.from('comprobantes')
.upload(ruta, decode(lista.base64), { contentType: 'image/jpeg' });rutaempieza con el identificador del usuario.decodeconvierte el texto base64 en datos binarios.contentTypedeclara el tipo de archivo.- Si
errortrae algo, muéstralo y permite reintentar.
20
Guarda la ruta, no la URL
En tu tabla se guarda la ruta del archivo. La URL se genera cuando hay que mostrarlo, porque puede cambiar o vencer.
21
Mostrar la imagen
| Bucket | Cómo obtienes la URL |
|---|---|
| Público | getPublicUrl(ruta): una URL estable |
| Privado | createSignedUrl(ruta, segundos): una URL que vence |
Con la URL en mano, la imagen se dibuja con expo-image, visto en el módulo 5.
22
Dos errores que salen caros
Otro frecuente: subir todos los archivos con el mismo nombre, como foto.jpg. Cada subida choca con la anterior y la caché muestra la imagen vieja. Usa un nombre único por archivo, por ejemplo con la fecha o un identificador.
23
Cuando falla la subida
- Muestra el progreso o al menos un estado «Subiendo».
- Si falla, conserva la imagen elegida y ofrece «Reintentar».
- Un rechazo de política significa que la ruta o la sesión no calzan con la regla: revisa ambas antes de tocar la política.
24
Lo que te llevas
- El selector del sistema entrega una imagen sin pedir permiso de galería; la cámara sí lo pide.
- Toda imagen se reduce antes de subir.
- Privado por defecto; público solo para lo que cualquiera puede ver.
- La política decide quién sube y quién lee; la carpeta por usuario es el patrón base.
- En la tabla va la ruta; la URL se genera al mostrar.
25
Hazlo ahora
En 15 minutos, con tu proyecto de pruebas:
- Crea un bucket privado y la política de carpeta por usuario.
- Pídele a Claude Code una pantalla que elija una imagen, la reduzca a 1.200 px de ancho y la suba.
- Compara el peso del archivo original con el subido.
- Entra con un segundo usuario e intenta leer el archivo del primero. Debe fallar.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Expo: ImagePickerdocs.expo.dev ↗
- Expo: ImageManipulatordocs.expo.dev ↗
- Supabase: Storagesupabase.com ↗
- Supabase: Storage, fundamentos de bucketssupabase.com ↗
- Supabase: Storage, control de accesosupabase.com ↗
- Supabase: referencia de upload en JavaScriptsupabase.com ↗
- Supabase: precios y límitessupabase.com ↗
- Google Play: política de permisos de fotos y videossupport.google.com ↗