> ## Documentation Index > Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt > Use this file to discover all available pages before exploring further. # Enrolar un kiosco en MDM > Adjunta Spark MDM a una tablet ya vinculada, escanea el QR después del factory reset y desbloquea los releases de la app privada. Vincular una tablet le permite tomar pedidos. **Spark MDM** es el paso extra que la convierte en un Android administrado para bloquearla a tu app privada y publicar releases desde el panel. Esta página es para operaciones que ya tienen una tablet **vinculada** (`LINKED`) y una conexión de Google Play activa. No necesitas ser desarrollador. Si Play aún no está conectado, empieza por [Conectar una cuenta de Google Play](https://firespark.cloud/docs/es/guides/channels/kiosk/connect-google-play.md). Si aún no tienes un canal de kiosco, empieza por [Configurar kioscos](https://firespark.cloud/docs/es/guides/channels/kiosk.md). > [!WARNING] > > El QR de enrolamiento no lo escanea la app del kiosco. Haces factory reset > de la tablet y escaneas el QR en el asistente de Android, mirando el > panel. La tablet que está tomando pedidos ahora se va a borrar. ## Qué desbloquea el enrolamiento | Antes del MDM (`LINKED`) | Después del MDM (`ENROLLED`) | | - | - | | Toma pedidos con la app sideloaded o ya instalada | Queda bloqueada en la app privada de Managed Play | | Refresh cache, reload y unlink desde el panel | Esos comandos, más reboot remoto y wipe de fábrica | | Releases no puede instalar por Play | **Releases** publica el APK privado y lo despliega en tablets enroladas | Una tablet vinculada no se enrola sola cuando conectas Play. Adjuntas MDM en ese dispositivo y luego provisionas Android con el QR. > [!NOTE] > > Android no deja que una app normal tome el control de la tablet ni haga > factory reset por ti. El QR (o `afw#setup` más el setup token) es la única > forma en que Android acepta a Spark como device owner. ## Qué necesitas antes de empezar * Acceso al panel de ese comercio, con permiso para gestionar dispositivos de kiosco * Un canal **Kiosk**, con al menos una tablet ya reclamada en **Devices** (status `LINKED`) * Una cuenta de Google Play **activa** en este comercio. Ver [Conectar una cuenta de Google Play](https://firespark.cloud/docs/es/guides/channels/kiosk/connect-google-play.md) * Un **Package name** guardado en **Settings** (el id de la app en Managed Play, por ejemplo `com.merchant.kiosk`). Attach MDM falla si falta * Una segunda pantalla (laptop o teléfono) que pueda quedarse en la página del dispositivo. Vas a apuntar la tablet reseteada a ese QR * Unos 20 minutos, y una tablet que puedas sacar de piso mientras se resetea > [!TIP] > > No hagas unlink de la tablet antes de enrolar. Fire spark reutiliza esa > misma fila cuando Android reporta el enrolamiento. Unlink borra la fila a > la que está atado el QR. ## 1. Confirma Play y el package name **1. Abre el hub de kiosco** En el [panel](https://firespark.cloud/dashboard), elige la organización y el comercio. Ve a **Channels** y abre el canal **Kiosk**. **2. Confirma que Google Play está activo** La tarjeta de arriba del hub debe mostrar **Google Play account** más un nombre o correo de admin. Si todavía pide conectar Play, termina esa guía primero. **3. Guarda el package name** Abre **Settings**. En **MDM**, pon **Package name** con el id de la app privada que vas a publicar en **Releases**. Guarda. Deja **Kiosk mode** en **Single app** salvo que te hayan pedido un custom launcher. > [!TIP] > > Attach MDM solo aparece en un dispositivo `LINKED` cuyo comercio ya tiene > Play activo. ## 2. Attach MDM y deja el QR en pantalla **1. Abre la tablet vinculada** Ve a **Devices** y abre la tablet que quieres enrolar. El badge debe decir `LINKED`. **2. Haz clic en Attach MDM** Abre el menú de acciones (`⋯`) y pulsa **Attach MDM**. Espera **MDM enrollment created**. **3. No salgas de esta página** Aparece el bloque **Attach MDM** con un QR y un **Setup token**. No recargues ni navegues a otra pantalla. El QR sale de esa acción. Si sales, vuelve al dispositivo y pulsa **Attach MDM** para crear un QR nuevo. El token dura **24 horas** y sirve **una vez**. El código de pairing de 6 caracteres de dispositivos pending no es el setup token. Usa el valor etiquetado **Setup token**. ## 3. Factory reset de la tablet **1. Saca la tablet del piso** Los clientes no pueden usarla en este paso. La app de kiosco actual y sus datos de vínculo local se van a borrar. **2. Borra todos los datos** En la tablet ve a **Settings → System → Reset options → Erase all data (factory reset)**. Confirma. Espera a que Android reinicie en la pantalla de bienvenida. > [!WARNING] > > No hagas unlink del dispositivo en Fire spark mientras reseteas. La fila > del panel debe quedarse para que Android se adjunte a ella después del > scan. ## 4. Escanea el QR en el setup de Android Deja el QR del panel visible en la segunda pantalla. Trabaja en la tablet ya reseteada. **1. Abre el scanner de QR** En la pantalla de bienvenida de Android, toca el texto de welcome **seis veces**. Se abre la cámara / scanner de QR. Conecta el Wi‑Fi si Android lo pide. **2. Escanea el QR del panel** Apunta la tablet al QR de **Attach MDM** en el dashboard. No lo escanees con la app vieja del kiosco: esa app ya no está después del reset. **3. Termina las pantallas de Android** Se instala Android Device Policy y queda como device owner. Acepta las pantallas de dispositivo de trabajo. Quédate en la tablet hasta que el setup termine. ### Si no abre el scanner de seis toques **1. Avanza hasta la cuenta de Google** Sigue el welcome hasta que Android pida una cuenta de Google. **2. Escribe afw#setup** Escribe `afw#setup` como cuenta y continúa. **3. Pega el setup token** Ingresa el **Setup token** que está debajo del QR en el panel. No es el device code de la tablet ni el código de pairing de 6 caracteres. ## Si el asistente de Android no aparece Algunas imágenes de kiosco, sobre todo paneles grandes sin botones de volumen, arrancan directo al escritorio después del factory reset. No hay selector de idioma ni pantalla de “Hello”. Los seis toques y `afw#setup` viven solo dentro del asistente de Google. Si ese asistente no arranca, el QR de Attach MDM no tiene dónde ingresarse. Play Store puede estar instalada. Eso confirma que la tablet tiene servicios de Google. El asistente es otra app del sistema, y la imagen puede dejar el setup marcado como ya terminado. > [!WARNING] > > Este paso es para soporte, con una computadora. Un local que recibe la > tablet ya en el escritorio no puede enrolarla solo. El enrolamiento > totalmente administrado ocurre dentro del asistente de primera vez. Para > esos locales, enrola la tablet antes de enviarla, o déjala en `LINKED` e > instala la app a mano. En `LINKED` sigue tomando pedidos y conserva las > apps de impresora y scanner que trajo el fabricante. **1. Confirma que el asistente existe** En la tablet abre **Ajustes → Aplicaciones → Mostrar apps del sistema** y busca **Asistente de configuración** (Setup Wizard). Si no está, esta imagen no puede escanear el QR. **2. Revisa las cuentas** En **Ajustes → Cuentas**, una cuenta de Google ya agregada impide que Spark quede como device owner. El asistente tiene que abrirse con la tablet sin cuentas. **3. Instala adb en la computadora** Hace falta Android platform-tools. En Mac: `brew install android-platform-tools`. Los comandos se corren en la computadora, no en la tablet. La computadora y la tablet tienen que estar en la misma red Wi‑Fi. **4. Activa el modo de desarrollador** En la tablet abre **Ajustes → Acerca del dispositivo** (a veces está dentro de **Sistema** y se llama **Acerca de la tablet**). Toca **Número de compilación** siete veces, hasta que Android diga que ya eres desarrollador. Si hay buscador en Ajustes, escribe `compilación`. Un mouse USB ayuda si el panel es difícil de tocar. Estos equipos suelen no tener botones de volumen, así que no hay combinación de teclas para recovery. **5. Abre Opciones de desarrollador** Vuelve a **Ajustes → Sistema → Opciones de desarrollador**. En otras tablets esa fila está al final de Ajustes, no dentro de Sistema. Si no aparece, el modo de desarrollador no quedó activo. **6. Entra a Depuración inalámbrica** Busca la fila **Depuración inalámbrica** y tócala para abrir su pantalla. Activa el interruptor. Arriba dice **Dirección IP y puerto**: esa es la de conexión, por ejemplo `192.168.1.50:41555`. Si esa fila no existe, esta versión de Android no trae depuración inalámbrica. **7. Saca el código de vinculación** En esa misma pantalla toca **Vincular dispositivo con código de vinculación** y deja el recuadro abierto. Muestra un código de 6 dígitos y otra **Dirección IP y puerto**, con el mismo IP y otro puerto, por ejemplo `192.168.1.50:37123`. Si cierras el recuadro, el puerto y el código cambian. **8. No actives Esperar al depurador** **Esperar al depurador** es otra fila. Si la enciendes, la tablet se queda en “esperando que se haga attach un debugger” y no muestra IP ni código. Apágala y deja **Seleccionar aplicación de depuración** en **Ninguna**. **9. Vuelve a abrir el asistente** En la computadora, sustituye los números de ejemplo por los de la tablet. `adb pair` usa el puerto del recuadro de vinculación y pide el código de 6 dígitos. `adb connect` usa el puerto de la pantalla principal de depuración inalámbrica. Estos comandos no borran la tablet ni desinstalan la impresora o el scanner. Solo marcan el setup como pendiente y reinician. ```bash theme={null} adb pair 192.168.1.50:37123 adb connect 192.168.1.50:41555 adb shell settings put global device_provisioned 0 adb shell settings put secure user_setup_complete 0 adb reboot ``` Al arrancar debe salir el idioma y después el “Hello”. Sigue el escaneo del QR de la sección anterior. > [!NOTE] > > Si al reiniciar vuelve el escritorio del fabricante, un script de esa > imagen está completando el setup al arrancar. El QR no se queda en ese > equipo. Enrolalo antes de entregarlo, o déjalo en `LINKED`. Para cerrar el asistente sin enrolar, con la misma conexión `adb`: ```bash theme={null} adb shell settings put global device_provisioned 1 adb shell settings put secure user_setup_complete 1 adb reboot ``` La tablet vuelve al escritorio. Las apps del fabricante siguen instaladas. > [!WARNING] > > Escanear el QR de Attach MDM, cuando el asistente ya está abierto, sí > provisiona el equipo. Android queda vacío y Spark pasa a ser device > owner. Las utilidades de impresora y scanner que trajo el fabricante se > borran. Un scanner USB que se comporta como teclado sigue escribiendo > dentro de la app de kiosco. Una impresora USB imprime si esa app habla > con ella directo. En modo **Single app** la tablet queda bloqueada en el > package de kiosco. ## 5. Espera ENROLLED y usa Releases **1. Espera a que Play instale la app de kiosco** Managed Play instala el package que pusiste en **Settings**. Si **Releases** sigue en **Publishing**, espera: Play está revisando el archivo (suele tardar unos 10 minutos). No hagas otro factory reset durante esa revisión. **2. Confirma el badge del dispositivo** En la página del dispositivo, el status debe pasar de `LINKED` a `ENROLLED`. En el menú de acciones aparece **Reboot** remoto. Recarga la página si el badge no cambió cuando el setup ya terminó. **3. Publica desde Releases** Abre **Releases** en el mismo hub. Sube el APK privado y elige un rollout normal o un hotfix de emergencia. Solo las tablets **enroladas** instalan por Managed Play. Mientras actualizan, no pueden tomar pedidos hasta que el build nuevo mande heartbeat. > [!TIP] > > El enrolamiento terminó cuando el dispositivo muestra `ENROLLED` y la > tablet está bloqueada en la app privada de kiosco. Los rollouts pasan por **Publishing → Ready → Installing → Done**. Las tablets offline toman la versión cuando se reconectan. ## Si algo sale mal > [accordion] No aparece Attach MDM > > La tablet debe estar `LINKED` y este comercio debe tener Play activo. > Conecta Play primero. Si Play está activo y la acción sigue sin > aparecer, el dispositivo puede tener ya un token: busca un QR en la > página, o pulsa **Attach MDM** otra vez después de recargar. > [accordion] El panel pide un kiosk package name > > Abre **Settings**, llena **Package name**, guarda y pulsa **Attach MDM** > otra vez. > [accordion] Después del reset no sale el idioma ni Hello > > La imagen arrancó directo al escritorio y el asistente de Google no > está corriendo. Sigue [Si el asistente de Android no aparece](#si-el-asistente-de-android-no-aparece). > Hace falta `adb` en una computadora. El local no puede hacer este paso. > [accordion] Recargué y desapareció el QR > > Quédate en la página del dispositivo y pulsa **Attach MDM** otra vez. > Eso crea un QR de un solo uso. El token anterior ya no sirve. > [accordion] El QR expiró o Android dice que ya se usó > > Los tokens duran 24 horas y sirven una vez. Pulsa **Attach MDM** otra > vez y escanea el QR nuevo. No reutilices el screenshot de un código > viejo. > [accordion] La tablet se quedó en LINKED después del scan > > El setup no terminó, o Fire spark aún no recibió el evento de > enrolamiento de Android. Confirma que escaneaste el QR de *este* > dispositivo. Espera un minuto y recarga la página. No hagas unlink. > [accordion] Después de enrolar vuelvo a ver la pantalla de link > > El factory reset borró la identidad vieja de la app. Mira el panel > primero: si el dispositivo está `ENROLLED`, no hagas unlink. Espera a > que Managed Play instale la app privada. Si la pantalla de link sigue > después de que Play instaló la app, escribe a > [soporte](mailto:soporte@trade.ec?subject=Fire%20spark%20MDM%20enroll). > [accordion] Hice unlink antes del reset > > Esa fila ya no existe. Vincula la tablet otra vez por código cuando > arranque, pulsa Attach MDM en la fila **nueva** y escanea ese QR. No > escanees el viejo. ## Siguiente > [card] [Configurar kioscos](https://firespark.cloud/docs/es/guides/channels/kiosk.md) > > Orden del hub: Settings, Devices, Releases, Health > [card] [Conectar una cuenta de Google Play](https://firespark.cloud/docs/es/guides/channels/kiosk/connect-google-play.md) > > Obligatorio para que Attach MDM aparezca en una tablet vinculada This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.