¿Qué hace store-pack?
Genera la carpeta store/ en la raíz del proyecto: iconos, capturas de pantalla enmarcadas, un gráfico destacado, texto de ficha, respuestas de formularios de consola y un README con bloqueos. Nunca envíes, hagas commit ni despliegues; deja eso al usuario.
Requisitos: Python 3, Flutter SDK (el compositor de imágenes es un test de Flutter, no necesita una app), y macOS (sips para comprobaciones de imágenes y tamaños de iconos). Las capturas de pantalla sin procesar provienen de la propia aplicación.
Flujo de trabajo
- Inspecciona la aplicación para obtener datos reales (nunca inventes): ID del paquete/bundle, versión, permisos (AndroidManifest, Info.plist), SDKs en pubspec, Cargo.toml o package.json (anuncios, analíticas, informes de fallos, facturación, inicio de sesión), cómo funcionan las cuentas y los pagos, URL de política de privacidad y soporte, configuración de firma, familias de dispositivos. Lee la documentación de contribución del proyecto para conocer sus reglas.
- Capturas de pantalla sin procesar. Captúralas desde la aplicación real con datos inventados realistas. Nunca uses datos de producción ni una cuenta de producción.
- Flutter: un test harness de widgets con fuentes reales (
debugDisableShadows = false, o las sombras se renderizan como contornos duros); teléfono 440x956 a 3x = 1320x2868. - Aplicaciones web, de escritorio o híbridas: ejecuta el servidor propio de la aplicación en una base de datos temporal, siémbrala a través de la API y maneja la interfaz con una herramienta de automatización del navegador. Usa un contexto de navegador separado con
deviceScaleFactor3 (teléfono, viewport 440x956) o 2 (tableta, 1032x1376) y oculta las barras de desplazamiento con*::-webkit-scrollbar{display:none!important}*{scrollbar-width:none!important}antes de cada captura. - Mata solo el proceso que escucha en tu propio puerto temporal (
lsof -ti tcp:PORT -sTCP:LISTEN), nunca por nombre. - Revisa cada captura a simple vista. Descarta las que estén rotas en ese ancho e informa al usuario.
- Flutter: un test harness de widgets con fuentes reales (
store/app.json(consultadocs/config-reference.md), luego ejecutapython3 scripts/make_pack.py store/app.json. Enmarca las capturas sobre un degradado de marca con un pie de foto, construye un gráfico destacado e iconos, y ejecutascripts/check_pack.py.- Icono: normalmente solo existe arte con esquinas redondeadas integradas o texto; el trabajo
iconrecorta la marca sobre un fondo plano sin sangría. Informa al usuario de que aún se necesita un vector o una fuente limpia de 1024 px.
- Icono: normalmente solo existe arte con esquinas redondeadas integradas o texto; el trabajo
- Texto de ficha:
store/listings.json, luegopython3 scripts/write_listings.py store/listings.json(formato fastlane, límites aplicados). Describe solo lo que realmente hace la compilación y lo que incluye la compilación de la plataforma. - Documentación:
store/README.md(tabla de bloqueos primero),google-play/console-forms.md,app-store/connect-forms.md.
Especificaciones de las tiendas (confírmalas en las consolas; la página de Apple puede no cargar)
- Play: icono 512 px (<= 1 MB); gráfico destacado 1024x500, sin alfa; 2-8 capturas de teléfono, cada lado 320-3840 px y lado largo <= 2x lado corto (usa 1080x1920); opcionalmente capturas de tableta 7"/10" (1200x1920, 1600x2560); título 30, corto 80, completo 4000.
- App Store: iPhone 6.9" 1320x2868 (obligatorio), 6.5" 1284x2778; iPad 13" 2064x2752 si se admite iPad; hasta 10 cada una; sin alfa; icono 1024 px, sin alfa; nombre 30, subtítulo 30, promo 170, palabras clave 100.
- Ambas rechazan capturas con canal alfa; el compositor escribe PNG RGB.
Bloqueos a buscar en cada aplicación (aprendidos)
- Pagos: vender desbloqueos digitales o licencias a través de un proveedor de pagos web dentro de la aplicación infringe las reglas de Play Billing / Apple IAP. Para iOS, envía sin interfaz de compra o añade StoreKit. Sin precios ni enlaces de compra en compilaciones móviles.
- Eliminación de cuenta: cualquier aplicación que cree cuentas necesita una ruta de eliminación dentro de la aplicación y (Play) una URL web pública que la describa.
- Inicio de sesión con Apple: obligatorio siempre que se ofrezca inicio de sesión con Google u otros terceros en iOS.
- IDs de anuncios de prueba dejados en una versión de lanzamiento; IDs reales faltantes.
- Play App Signing: añade el SHA-1 de firma de Play a los clientes de OAuth de Android, o el inicio de sesión fallará en instalaciones desde Play.
- Permisos restringidos o declarados:
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS, tipos de servicio en primer plano (necesitan declaración y un video), ubicación (incluso conmaxSdkVersion), BluetoothneverForLocation. - Acceso del revisor: las aplicaciones que necesitan un servidor o licencia necesitan un servidor de demostración, PIN y pasos (Acceso a la aplicación de Play, directriz de Apple 2.1).
- La URL de la política de privacidad debe existir; dirección de contacto y teléfono para el estado de comerciante (UE/REINO UNIDO).
- Firma de lanzamiento configurada; aumento de versión; AAB para Play; equipo de Apple y bundle ID;
ITSAppUsesNonExemptEncryption; manifiesto de privacidad. - Nuevas cuentas personales de Play: se requiere una prueba cerrada de 14 días con 12 probadores antes de la producción.
- Seguridad de datos: "procesado efímeramente" solo para datos usados en memoria y nunca almacenados (por ejemplo, una foto enviada a un servicio de IA); el correo electrónico o los ID guardados en un servidor no son efímeros. ID de publicidad: responde "No" solo si no hay SDK de anuncios o conversión presente y se ha eliminado el permiso de ID de publicidad.
- Audiencia objetivo mayores de 18 años a menos que la aplicación sea realmente para niños.
- Un shrinker de tamaño mínimo (R8) puede fallar en bibliotecas opcionales: si una compilación de lanzamiento falla con "Missing classes", añade reglas
-dontwarnpara los paquetes nombrados.
Archivos
scripts/make_pack.pylo ejecuta todo;scripts/compose/es el compositor de Flutter (STORE_JOBS=jobs.json flutter test);scripts/build_icons.py;scripts/check_pack.py;scripts/write_listings.py.templates/app.example.json,templates/listings.example.json- configuraciones para copiar.examples/- un ejemplo completo con una aplicación ficticia y su resultado.docs/- introducción, referencia de configuración, cómo funciona.