Herramientas del editor

Cómo se abren las herramientas

Estas herramientas solo existen dentro del editor de código; no son páginas del pager principal. Abre antes un fichero o un proyecto y usa el botón de la llave inglesa de la parte superior del editor.

1. 1Toca el botón de la llave inglesa (Más opciones) en la barra superior del editor. Se abre una hoja con un campo de búsqueda, Buscar acción….
2. 2Elige una sección: Editar, Ver, Ir a, Git, IA o Herramientas, o escribe en el buscador para filtrar todas las acciones a la vez.
3. 3En Herramientas las acciones se agrupan en Ejecutar, Proyecto, Colaborar, Utilidades y Ayuda y ajustes. Depurar, Explorador de tests y Dependencias están en Ejecutar; Herramientas de Docker, Monitorización y Generadores de backend en Proyecto; Colaboración en directo en Colaborar.
4. 4Problemas y Esquema están en Ir a. Los Generadores de IA y las acciones de código con IA están en IA.
5. 5La paleta de comandos (Ctrl+Shift+P con teclado físico) lista exactamente las mismas acciones: el menú y la paleta comparten un único registro.

Dónde está cada herramienta

Hoja, panel acoplado, diálogo o columna

Atajos

Depurar

Depurar ejecuta el fichero abierto con un depurador conectado y muestra lo que hace el programa en un panel acoplado bajo el editor. El depurador es real solo para JavaScript (.js, .mjs, .cjs, .jsx, ejecutados en el Node.js integrado). Para cualquier otro lenguaje, Depurar archivo simplemente ejecuta el fichero.

Breakpoints

• Toca un número de línea del editor para añadir o quitar un breakpoint, o pulsa F9 en la línea del cursor (Alternar breakpoint). Puedes ponerlos antes de iniciar la sesión.
• Los breakpoints viven solo en memoria: al cerrar la app se olvidan.
• La pestaña Breakpoints lista cada breakpoint con una casilla de activado. Toca una fila para saltar a su línea en el fichero actual, usa el lápiz para editarlo, ✕ para quitarlo o Limpiar todo. Lista vacía: «Sin breakpoints. Toca un número de línea en el editor para añadir uno.»

Arrancar y avanzar

Node arranca en pausa en su primera línea (--inspect-brk), el panel se conecta («Debugger attached on port N» aparece en la salida de ejecución) y lo libera; el programa corre hasta un breakpoint o hasta una excepción no capturada, que también lo pausa.

• Con una sesión activa la barra ofrece Continuar (o Pausar mientras corre), Paso por encima, Paso hacia dentro, Paso hacia fuera, Reiniciar y Detener. Los botones de paso solo están activos con el programa en pausa.
• Detener desconecta el depurador. El proceso en sí se detiene desde el panel de ejecución.
• El interruptor de la llama, Hot Reload: reiniciar la sesión al guardar un fichero del proyecto, viene apagado.

Las cuatro pestañas

Los nombres de las pestañas están siempre en inglés: la app no los traduce.

Condiciones y logpoints

El lápiz de un breakpoint abre Editar breakpoint. Condición («Parar solo cuando esta expresión JavaScript sea verdadera») hace que solo pare entonces. Mensaje de log («Registra en vez de parar. Usa {expresión} para insertar valores») lo convierte en un logpoint que escribe el mensaje y no pausa. Con los dos, escribe solo cuando la condición se cumple. Estos dos campos se ponen aquí, no desde el margen del editor.

Tests

El Explorador de tests encuentra los tests de tu proyecto, los ejecuta con el comando propio del framework y lista los resultados. No trae ningún lanzador de tests: ejecuta el comando con el shell del dispositivo (sh -c) en la carpeta del proyecto, así que las herramientas del framework tienen que existir en el dispositivo.

Frameworks y detección

Se admiten doce frameworks: Jest, Mocha, Vitest, pytest, unittest, JUnit, Go Test, Cargo Test, PHPUnit, RSpec, Dart Test y Swift XCTest. PocketCode elige uno por proyecto: el primero que encuentra por su fichero de configuración (por ejemplo jest.config.js, pytest.ini, build.gradle, go.mod, Cargo.toml, pubspec.yaml); si ninguno coincide, lee package.json para Jest, Vitest o Mocha. unittest no tiene fichero de configuración, así que nunca se elige solo. El subtítulo dice entonces «<framework> · N tests en M ficheros».

Las cuatro pestañas

Ejecutar

• El pie tiene Ejecutar todos, Solo fallidos y, mientras corre una ejecución, Detener.
• La cabecera tiene iconos para Refrescar, Alternar modo watch y Ejecutar con cobertura.
• El árbol de tests sale de leer tus ficheros con patrones de nombre (*.test.*, test_*.py, *_test.go, *Test.kt…), hasta 200 ficheros, saltándose node_modules, .git, build, dist, target, .gradle, __pycache__ y venv.
• El modo watch existe solo para Jest, Mocha y Vitest, y únicamente vuelca la salida del comando en Salida.

Herramientas de Docker

Las Herramientas de Docker son una interfaz para la herramienta de línea de comandos docker que ya esté en tu dispositivo. PocketCode no incluye Docker ni un demonio de Docker, y el panel no tiene campo para un host remoto. Por eso, en un móvil típico las pestañas que necesitan Docker muestran Docker no está disponible, mientras que los editores de Dockerfile y de Compose siguen funcionando.

Cuando no hay Docker

Al abrirse, el panel ejecuta docker --version. Si falla, Contenedores, Imágenes, Build y Registro muestran Docker no está disponible: «PocketCode ejecuta el comando docker en este dispositivo y no lo encuentra. Puedes seguir editando el Dockerfile y el fichero Compose.» Añade la causa real del fallo y dos botones, Reintentar y Editar Dockerfile. El subtítulo dice Docker no disponible.

Dockerfile y .dockerignore

Esta pestaña funciona sin Docker. Parte de una de 14 plantillas (Node.js App, Python App, Java App, Go App, Rust App, Static Site, React App, Next.js, FastAPI, Spring Boot, Django, Ruby on Rails, Laravel, Custom Multi-stage), edita el texto y pulsa Guardar para dejar el Dockerfile en el proyecto. Para .dockerignore puedes Generar un fichero y guardarlo.

Compose

Nueve plantillas: Full-stack Node.js, Full-stack Python, Full-stack Java, LAMP Stack, MEAN Stack, Monitoring Stack, ELK Stack, WordPress y Dev Tools. Edita el fichero y pulsa Guardar; siempre se guarda como docker-compose.yml, aunque el panel lee docker-compose.yml, docker-compose.yaml, compose.yml o compose.yaml. Con Docker presente, Compose up, Compose down, Compose build y Compose logs ejecutan docker compose up -d, down, build y logs --tail=100; siguen desactivados hasta que el proyecto tenga un fichero Compose.

Con Docker disponible

Límites de los comandos

Cada comando puede tardar 300 segundos como máximo. Los nombres y etiquetas se validan antes de llegar a Docker: letras, dígitos y _ : . / @ -, hasta 255 caracteres, sin empezar por -.

Monitorización

La monitorización mide la app en la que estás y el dispositivo donde corre, no un servidor. Toma muestras cada 2 segundos mientras el panel está abierto y se detiene al cerrarlo. Para ver tu propio servidor hay una pestaña aparte, Servidor.

Las cinco pestañas

Reglas de alerta

El formulario de la regla tiene Métrica, Condición (Mayor que o Menor que), Umbral (validado contra el rango de la métrica), Sostenido durante (segundos) y Severidad (Crítica, Aviso, Info). Los eventos de alerta se evalúan y se muestran solo mientras el panel está abierto; se conservan los últimos 100, como máximo uno por minuto y regla.

Servidor: tu propio Prometheus

Servidor funciona con Prometheus, VictoriaMetrics, Thanos, Mimir, Cortex o un proxy de Grafana. Escribe la Dirección, elige Autenticación (Ninguna, Usuario y contraseña o Token bearer), pon el refresco (de 5 a 300 segundos, 15 por defecto) y añade hasta 12 consultas; cada una es una consulta PromQL instantánea que debe devolver un solo valor. Probar conexión comprueba la configuración. Mientras no la configures, la pestaña dice «No hay servidor configurado. Hasta que configures uno no sale nada de este dispositivo.»

Librerías

Librerías (el menú la llama Dependencias) no es un gestor de paquetes. Lista las librerías Kotlin/JVM que un proyecto declara en .pocketcode/dependencies.json y te deja elegir de un catálogo cerrado de cuatro librerías que viajan dentro de la app de PocketCode. Solo las usa el runner completo de Kotlin.

Catálogo

La pestaña Catálogo lista las cuatro librerías que PocketCode incluye: kotlinx.coroutines 1.10.2, kotlinx.serialization · JSON 1.7.3, kotlinx.serialization · core 1.7.3 y Okio 3.9.1. El icono + de una fila (Añadir más el nombre de la librería) la añade al proyecto.

Declaradas

La pestaña Declaradas lista lo que declara el JSON del proyecto, con los filtros Todas, Actualizables y No incluidas. Cada fila muestra grupo:artefacto y si PocketCode la incluye («Incluida en PocketCode.», o «a → b» cuando el proyecto pide otra versión), con un icono de actualizar y otro de quitar. Actualizar las N al pie actualiza todas las actualizables, es decir, las deja en la versión que PocketCode incluye. El icono de refrescar de la cabecera (Resolver ahora) vuelve a preparar las librerías, con los estados «Preparando las librerías…» y «Listo: las librerías de este proyecto están preparadas.» Sin declaraciones dice Sin dependencias.

Una librería que no está incluida

Si el JSON nombra algo fuera del catálogo, la fila avisa de que no viene incluida en PocketCode, «así que este proyecto se ejecuta en modo sencillo. Quítala o usa una de las de arriba.»

Generadores de backend

Los generadores de backend escriben código de servidor a partir de plantillas guardadas en la app. No es IA: los mismos ajustes dan siempre los mismos ficheros (los botones Generar solo esperan un momento antes). Lees el resultado en la hoja y, con un proyecto abierto, lo guardas bajo backend/.

Las pestañas

Guardar en el proyecto

Guardar en el proyecto escribe los ficheros generados bajo backend/ en el proyecto; las migraciones pasan a backend/up.sql y backend/down.sql, y la especificación a backend/openapi.yaml o backend/openapi.json. Las rutas no pueden salir de la carpeta del proyecto. Si ya existen ficheros pregunta ¿Sobrescribir ficheros? («N ficheros ya existen en el proyecto y se sobrescribirán.»). Si todo va bien dice «Guardados N ficheros en backend/ del proyecto», y si la escritura falla «No se pudieron guardar los ficheros generados». Necesita un proyecto abierto.

Generadores de IA

Generadores IA tiene cinco pestañas, pero solo tres usan IA. API y Esquema son plantillas sin conexión que corren en el dispositivo; Traducir, Seguridad y Rendimiento envían el código que pegas a tu proveedor de IA conectado.

Las cinco pestañas

Qué necesitan las pestañas con IA

Un proveedor de IA conectado y acceso a internet. La primera vez, un aviso pregunta ¿Enviar a <proveedor>?; Enviar comparte el código que pegaste, Cancelar no comparte nada. API y Esquema no necesitan proveedor ni red. Antes de generar, la zona de resultado dice «El resultado aparecerá aquí en cuanto se genere.»

Acciones de código con IA

La sección IA del menú tiene acciones que trabajan sobre tu código: explicar, tests, documentación, código desde comentarios, refactorizar y cinco acciones rápidas. Envían el código a tu proveedor de IA conectado, tras un aviso que aceptas, y muestran la respuesta.

Las acciones

Aplicar e Insertar en el panel acoplado

El panel acoplado mide como mucho 300 dp de alto y tiene una ✕ para cerrarlo. Insertar pone la respuesta en el cursor. Aplicar sustituye solo el trozo de código que se envió a la IA (la función en Generar documentación; la selección en Refactorizar, o el fichero entero si no había nada seleccionado) por la respuesta, sin vista previa y en un solo paso de deshacer. Si cambiaste ese código mientras la IA respondía y ya no se encuentra, no se toca nada y el panel dice «El código cambió mientras la IA respondía, así que no se aplicó el resultado. Cópialo en su lugar.» Copiar, junto al código generado, lo copia al portapapeles («Copiado al portapapeles»); la hoja inferior tiene su propio Copiar para toda la respuesta.

Colaboración en vivo

La colaboración en vivo permite que dos o más dispositivos editen un mismo fichero a la vez en la misma red Wi-Fi. Es gratis, no pide cuenta y no tiene servidor: el móvil anfitrión escucha en tu red local, los invitados lo encuentran, escriben un código de seis dígitos y el anfitrión los deja entrar. Nada va por internet.

Hostear una sesión

1. 1En Hostear en este dispositivo escribe un nombre de sesión y toca Comenzar a hostear. La sesión comparte el texto del fichero que tienes abierto.
2. 2Da el Código de emparejamiento de seis dígitos a quien se una («Dile este código a quien se una»).
3. 3Cuando alguien escribe el código correcto, tu dispositivo pregunta Alguien quiere unirse: «<nombre> ha escrito el código correcto. Si le dejas entrar, compartes el fichero con su dispositivo.» Elige Dejar entrar o Rechazar. Tienes hasta 90 segundos.
4. 4Termínala con Finalizar sesión en la cabecera.

Unirte a una sesión

1. 1Abre el panel en la misma Wi-Fi. Pares en tu red escanea la LAN (Escaneando la LAN…) y dice Sin pares encontrados si nadie hostea.
2. 2Escribe los seis dígitos del anfitrión en Código del anfitrión («Sin él nadie puede entrar. La sesión no sale de tu red.»).
3. 3Toca al anfitrión y espera a que te deje entrar (hasta 120 segundos). El contenido del fichero que tenías abierto se sustituye por el texto del anfitrión.
4. 4Sal con Salir en la cabecera.

Dentro de una sesión

Qué se comparte

• El texto del fichero activo del anfitrión en el momento de empezar la sesión. Una sesión comparte un único búfer: ni el árbol del proyecto ni otros ficheros.
• Después, las ediciones de todos se fusionan (CRDT) y los cursores remotos aparecen en el editor con nombre y color.
• El anfitrión retransmite todo: los invitados hablan con el anfitrión, no entre sí.
• Todo invitado al que el anfitrión deja entrar puede editar el texto compartido.
• Si se cae la conexión de un invitado, la app reintenta hasta seis veces (de 1 s a 15 s) y reconcilia lo escrito mientras tanto.

Red y permiso

Desde Android 13, hostear y unirse necesitan el permiso de dispositivos cercanos de Android (en las versiones más nuevas es un permiso de red local). Cuando empiezas a hostear, buscas o te unes y falta, se abre el diálogo de permisos de Android: permítelo y toca otra vez. Si lo rechazas, hostear y unirse siguen rechazados (el siguiente intento vuelve a mostrar la explicación) hasta que lo permitas en los ajustes de Android para la app. La explicación del permiso y los errores de conexión salen en el idioma de la app.

Problemas

Problemas es una sola lista de todo lo que el editor ha encontrado mal en cada pestaña abierta, agrupado por fichero. Es un diálogo a pantalla completa, no una hoja.

Filtros

Filtra por origen (Compilador/LSP, Marcadores y Estilo, cada uno con su recuento) y por severidad (Errores, Avisos, Info y Sugerencias). Compilador/LSP y Marcadores vienen activados. Estilo (las reglas del linter) se calcula solo cuando lo activas, con «Analizando el estilo…», y no se calcula nada mientras el diálogo está cerrado.

Filas

Los problemas se deduplican y se ordenan por severidad y luego por línea. Toca una fila para ir a «Línea N, Col M». El grupo del fichero activo tiene Arreglos rápidos, que abre el panel de correcciones. F8 y Shift+F8 saltan al siguiente o al anterior error, aviso o marcador TODO sin abrir el diálogo. Sin nada que mostrar dice Sin problemas.

Esquema

El Esquema es una columna a la derecha del editor que lista las clases, interfaces, funciones, bloques de imports y secciones // region del fichero y salta a ellas. Lo construye un analizador sencillo; no usa el servidor de lenguaje.

Qué reconoce

• Líneas que empiezan por class, interface, object, enum class, fun o suspend fun y abren una {: declaraciones al estilo de Kotlin.
• Bloques de tres o más líneas seguidas que empiezan por import .
• Regiones escritas como // region Nombre y cerradas con // endregion.
• Se refresca 0,8 segundos después de dejar de escribir.

Cómo usarlo

Escribe en Filtrar símbolos… (coincide con parte del texto, no es difuso) y toca una entrada para ir a su línea. Sin símbolos aparece cuando el filtro no coincide con nada.