Ejecuta en un dispositivo

koru run compila tu app, la instala en un móvil o emulador conectado y la abre. Úsalo cada vez que quieras ver el comportamiento real de Android: plugins nativos, permisos, el menú de compartir y las notificaciones.

koru run

Built com.example.miapp 1.0.0 (20 KB) in 35ms
Installed on sdk gphone64 x86 64 (emulator-5554)
Opened Mi App on sdk gphone64 x86 64 (emulator-5554); inspect it at chrome://inspect

koru run y koru devices son nuevos. Están probados contra un programa que implementa el protocolo del servidor adb, pero todavía no se han registrado en hardware físico. Si algo no funciona en tu equipo, los comandos manuales del final de esta página siempre funcionan.

Prepara un dispositivo

Móvil. Activa las opciones para desarrolladores y la depuración USB, conecta el cable y acepta en el móvil el aviso «¿Permitir depuración USB?».

Emulador. Crea e inicia un dispositivo virtual desde el Device Manager de Android Studio. Las imágenes con API 26 o posterior funcionan con el rango de minSdk de koru.

koru se comunica con el servidor adb, el servicio en segundo plano de las platform tools de Android que Android Studio inicia por ti. koru no inicia programas por su cuenta. Si no hay ningún servidor activo:

adb start-server

Comprueba qué ve koru:

koru devices

emulator-5554            device        sdk gphone64 x86 64
R5CT1234567              unauthorized

device significa listo. unauthorized indica que el móvil espera que aceptes el aviso de depuración. offline suele resolverse reconectando el cable o reiniciando el emulador.

Elige un dispositivo

Con un solo dispositivo listo, koru run lo usa. Si hay varios, elige uno por su número de serie:

koru run --device emulator-5554

También puedes definir ANDROID_SERIAL=emulator-5554. koru respeta ANDROID_ADB_SERVER_PORT y ADB_SERVER_SOCKET=tcp:host:puerto, las mismas variables que adb, por ejemplo para usar un servidor en otra máquina.

Depura el WebView

Las builds de depuración (las que usa koru run por defecto) activan la depuración del WebView. Con la app abierta, visita chrome://inspect en Chrome en tu ordenador y elige tu app para usar DevTools: consola, red, elementos y puntos de interrupción.

koru run --release instala en cambio una build release. La depuración queda desactivada, como en el APK que distribuyes.

Mira los logs de la app

koru logs
koru run --logs     # compila, instala, abre y sigue mostrando logs

koru logs muestra en tu terminal lo que la app en ejecución escribe en el log de Android, incluidas las líneas console.log, console.warn y console.error del WebView. La app debe estar abierta; pulsa Ctrl+C para detenerlo. koru imprime primero esta línea de estado (el pid y el número de serie son ilustrativos):

Logs com.example.myapp (pid 1234) on emulator-5554; press Ctrl+C to stop

Las líneas siguientes usan el formato brief de logcat de Android. koru las lee a través del servidor adb (ejecutando pidof y logcat en el dispositivo), no con un adb local. El formato real de línea no se ha validado en un dispositivo: esta función se probó contra un servidor adb simulado. Si falla o la salida se ve mal, recurre a chrome://inspect, descrito arriba. Las opciones están en Comandos CLI.

Si la instalación falla

koru explica los errores habituales de Android:

Instala a mano

Cualquier APK de koru build se puede instalar también directamente con las platform tools:

koru build --output app.apk
adb install -r app.apk
adb shell am start -W -n com.example.miapp/com.koru.runtime.MainActivity

Sustituye com.example.miapp por tu appId. Para compartir la app con otras personas, consulta Distribuye tu app.