Clase 01 · Módulo 14
Preparar la app para las tiendas
Preparar la app para las tiendas
Qué logras en esta clase
Dejas tu proyecto con la identidad y la configuración que las tiendas van a recibir, antes de gastar un solo build de producción.
- Eliges un identificador que no tendrás que lamentar.
- Entiendes los dos números de versión.
- Preparas ícono y pantalla de inicio que cumplen.
- Repasas la configuración final con una lista corta.
02
Una decisión que no tiene vuelta
El identificador de tu app no se cambia después de publicar. El nombre, el ícono y los textos sí.
03
Qué queda fijo y qué puedes cambiar
| Dato | Dónde vive | Se puede cambiar |
|---|---|---|
| Identificador | app.json | No, trátalo como permanente |
| Nombre | app.json y ficha | Sí, con una versión nueva |
| Ícono y pantalla de inicio | app.json | Sí, con un build nuevo |
| Versión | app.json | Sube en cada lanzamiento |
Apple lo dice sin matices: el identificador queda bloqueado desde que subes el primer build.
04
El identificador: la cédula de tu app
Es un texto único en todo el mundo con el que cada tienda reconoce tu app. En iOS se llama bundleIdentifier; en Android, package. Se escribe como un dominio al revés.
{
"expo": {
"name": "Café Ronda",
"version": "1.0.0",
"ios": { "bundleIdentifier": "cl.caferonda.app" },
"android": { "package": "cl.caferonda.app" }
}
}05
Cómo elegir un buen identificador
- Parte de un dominio que controles, invertido:
cl.tunegocio.app. - Usa el mismo en iOS y Android: menos confusión.
- Solo minúsculas, números y puntos.
- No pongas «test», «demo» ni el año: te acompañará siempre.
06
El nombre: 30 caracteres en las dos tiendas
Hay dos nombres. El campo name de app.json aparece bajo el ícono en el teléfono: mejor corto, para que no se corte. El nombre de la tienda se escribe en cada consola y admite hasta 30 caracteres en Google Play y en App Store.
07
Tu app tiene dos números de versión
Uno lo ve el usuario en la tienda. El otro solo lo cuentan las tiendas, y nunca puede repetirse.
08
Qué es cada número
| Campo | Quién lo ve | Ejemplo |
|---|---|---|
version | El usuario, en la tienda | 1.0.0, 1.1.0 |
ios.buildNumber | Apple | 1, 2, 3 |
android.versionCode | 1, 2, 3 |
Cada archivo que subes necesita un buildNumber o versionCode nuevo, aunque version siga igual. Si repites el número, la tienda rechaza la subida.
09
Deja que EAS lleve la cuenta
EAS (los servicios en la nube de Expo) puede guardar y subir esos números por ti. Con la fuente de versión remote, el contador vive en los servidores de Expo; con autoIncrement, sube solo en cada build.
{
"cli": { "appVersionSource": "remote" },
"build": {
"production": { "autoIncrement": true }
}
}Tú solo decides cuándo cambia version.
10
Remoto o local: cuál conviene
| Fuente | Cómo funciona | Cuándo conviene |
|---|---|---|
remote | Expo guarda y aumenta el número | Casi siempre; es la recomendada por Expo |
local | Se lee de tu proyecto | Si quieres el número escrito en el repositorio |
11
El ícono para iOS
Requisitos que Expo indica para el archivo:
- Formato PNG, de 1024 × 1024 píxeles.
- Cuadrado exacto: 1023 × 1024 no sirve.
- Sin transparencias: el fondo va relleno.
- Sin esquinas redondeadas: el sistema aplica la máscara.
Los demás tamaños los genera el build. Tú entregas una sola imagen en el campo icon.
12
El ícono adaptable de Android
Android arma el ícono con capas y cada fabricante lo recorta distinto: círculo, cuadrado redondeado u otra forma.
Clave en android.adaptiveIcon | Qué es |
|---|---|
foregroundImage | Tu logo, con margen alrededor |
backgroundColor | Color de fondo (blanco si no dices nada) |
monochromeImage | Versión de un color para íconos con tema |
13
Prueba el ícono en chico
Un ícono se juzga a tamaño de pantalla de inicio, no a pantalla completa. Achícalo hasta el tamaño de una uña y míralo junto a otros.
- Se reconoce la forma sin leer nada.
- No depende de texto pequeño.
- Contrasta sobre fondo claro y oscuro.
Si no pasa esa prueba, simplifica antes de seguir.
14
La pantalla de inicio
Es lo que se ve mientras la app carga, también llamada «splash». Se configura con el plugin expo-splash-screen dentro de plugins en app.json.
image: tu logo en PNG, idealmente con fondo transparente.imageWidth: ancho con que se muestra.backgroundColor: color de fondo.dark: imagen y fondo para modo oscuro.
Solo se acepta PNG: otro formato hace fallar el build de producción.
15
Dónde se prueba de verdad
Lo mismo vale para el ícono y el nombre bajo el ícono: lo que ves en desarrollo no es lo que recibirá el usuario.
16
Estos cambios no viajan por aire
Identificador, ícono, pantalla de inicio y permisos son configuración nativa: cambiarlos exige un build nuevo.
17
El ciclo de un cambio de configuración
Por eso se revisa todo junto y una sola vez. Cada corrección suelta es un build más, y el plan gratuito de EAS trae 15 por plataforma al mes.
18
Repaso de configuración final
- Textos de permisos claros y solo los que usas (módulo 9).
- Variables de entorno apuntando al proyecto de producción de Supabase, no al de pruebas (módulo 7).
- Política de privacidad publicada y enlazada dentro de la app (módulo 13).
- Eliminación de cuenta funcionando, si hay cuentas (módulo 8).
- Sin pantallas vacías, textos de relleno ni botones que no hacen nada.
19
Decide si soportas iPad
Si tu app queda habilitada para iPad, Apple te pedirá capturas de iPad y los revisores pueden probarla ahí. La opción vive en la sección ios de la configuración: busca supportsTablet en la referencia de Expo y decide a conciencia.
20
Pasa el chequeo antes de compilar
Antes de pedir el build, ejecuta en la carpeta del proyecto:
npx expo-doctor@latestRevisa dependencias incompatibles con tu SDK y problemas de configuración. Si marca algo, pásale la salida completa a Claude Code y pídele que explique cada punto antes de corregir.
21
Errores comunes
- Dejar el identificador de la plantilla o uno con «test».
- Ícono con transparencia o esquinas redondeadas hechas a mano.
- Dar por buena la pantalla de inicio vista en desarrollo.
- Compilar producción con las variables del proyecto de pruebas.
- Repetir
versionCodeobuildNumberpor llevarlos a mano.
22
Lo que te llevas
- El identificador es permanente: se decide con calma y una vez.
versiones para personas;buildNumberyversionCode, para las tiendas.- Con fuente
remoteyautoIncrement, EAS numera por ti. - Ícono: PNG de 1024 × 1024, cuadrado, sin transparencia.
- La configuración nativa se revisa junta, en un build
preview.
23
Hazlo ahora
En 15 minutos:
- Abre
app.jsony anota nombre, identificadores y versión actuales. - Decide el identificador definitivo y escríbelo igual en iOS y Android.
- Pide a Claude Code que te muestre cómo está configurada la numeración en
eas.jsony qué cambiaría para dejarla automática. - Achica tu ícono al tamaño de una uña y aplica la prueba de las tres preguntas.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Expo: referencia de la configuración de la app (app.json)docs.expo.dev ↗
- Expo: pantalla de inicio e ícono de la appdocs.expo.dev ↗
- Expo: versiones de la app en EAS Builddocs.expo.dev ↗
- Expo: introducción a EAS Submitdocs.expo.dev ↗
- Apple: información de la app en App Store Connectdeveloper.apple.com ↗
- Google Play: crear y configurar tu appsupport.google.com ↗