--- title: Consola de depuración de BrightScript slug: develop/es/consola-de-depuracion-de-brightscript docTags: createdAt: 2025-03-11T07:07:17.199Z --- El lenguaje BrightScript, que es interpretado y no compilado, tiene dos CLI disponibles: - El shell de BrightSign que le permite iniciar scripts y algunas otras tareas de administración del dispositivo (consulte [¿Qué es el Shell de BrightSign?](docId\:VAtUx3SlQ6ZYYxtVxFQvn) para obtener más información). - El depurador BrightScript que se utiliza para examinar y manipular un proceso BrightScript en ejecución Esta página describe cómo acceder a estas CLI y al conjunto de herramientas del depurador BrightScript. ## Conexión al intérprete BrightScript Para acceder a ambas interfaces, necesita asociar una sesión de terminal desde su máquina local con la entrada y salida del proceso del intérprete BrightScript. En un entorno operativo estándar, la única interacción posible con el intérprete BrightScript es supervisar su salida, ya que no aceptará entrada, incluidas interrupciones. Para interactuar con cualquiera de las CLI, primero debe establecer `depuración de script activada`, lo cual puede hacerse de varias maneras. Por ejemplo, en la pestaña DWS Registry, introduzca `escritura en el registro depuración de brightscript 1` (lo cual es equivalente al comando del shell de BrightSign `depuración de script activada`). Cuando hay una conexión física disponible con el reproductor, se puede acceder a estas interfaces a través del puerto serie principal utilizando un programa de terminal y un cable null-modem (más detalles en [esta página](docId\:VAtUx3SlQ6ZYYxtVxFQvn)). Las interfaces del shell de BrightSign y del depurador también pueden enrutararse a través de [Habilitar Telnet y SSH](docId\:L0L_gyiHAvtdBci9FFcQh). ## Acceder al depurador :::hint{type="info"} Si no ha activado script debug, cualquier interrupción de la ejecución del intérprete BrightScript no dará acceso al depurador, sino que reiniciará el reproductor para intentar una ejecución limpia. ::: ### Acceso automático Si, mientras se está ejecutando un script, ocurre un error de tiempo de ejecución o se encuentra una instrucción `ALTO` , la aplicación BrightSign entrará en la consola de depuración BrightScript. ### Acceso durante el arranque También puede acceder a la consola de depuración durante el arranque: 1. Apague el reproductor. 2. Encienda el reproductor y espere entre 5 y 15 segundos. 3. Presione y mantenga presionado el botón **SVC** del lateral del reproductor. 4. Si está utilizando Telnet, deberá reiniciar Telnet ejecutando `telnet {{la dirección IP de tu reproductor}} 23` en la línea de comandos. 5. Espere hasta que aparezca el indicador `BrightSign>` en la terminal serie/Telnet/SSH (lo que indica que está en el [Shell de BrightSign](docId\:VAtUx3SlQ6ZYYxtVxFQvn)). Ahora puede soltar el botón **SVC** . 6. Introduzca `guion` en el indicador mientras está en el BrightSign Shell. Esto lo llevará a la consola de depuración BrightScript. ### Acceso si el reproductor no tiene un Autorun.brs El sistema operativo BrightSign no registra el evento del botón **SVC** si no hay un archivo `autorun.brs` en el dispositivo de almacenamiento. Si este es el caso, se puede utilizar uno de los siguientes métodos para acceder al indicador BrightSign o al depurador BrightScript: - Si la consola serie ha sido habilitada (ya sea temporal o persistentemente), aparecerá un mensaje `Iniciando la aplicación BrightSign...` después de que el reproductor se reinicie (lo que puede tardar hasta 30 segundos). Presione y mantenga presionado el botón **SVC** hasta que se muestre el indicador BrightSign. - Coloque un archivo `autorun.brs` que solo contenga `fin` en el dispositivo de almacenamiento. Una sola línea de `fin` es suficiente. El script se ejecutará y, cuando finalice según las instrucciones, quedará en el indicador del shell de BrightSign. - Si tiene almacenamiento extraíble como una tarjeta microSD, extráigala. Reinicie el reproductor y presione el botón **SVC** . Si está accediendo al reproductor a través de Telnet, tendrá que reiniciar la conexión Telnet después de que el reproductor se reinicie utilizando el comando `telnet {{la dirección IP de tu reproductor}} 23`. ## Consola BrightScript :::hint{type="info"} La consola de BrightScript solo debe utilizarse en entornos de desarrollo al escribir software o depurar el software de la aplicación de su reproductor. Debe deshabilitarse para implementaciones de producción. Cuando la consola de depuración de BrightScript está habilitada, si se encuentra un error de tiempo de ejecución en un script de BrightScript, el sistema operativo BrightSign se detiene en la línea del error de tiempo de ejecución, lo que le permite avanzar paso a paso por el archivo. ::: ### Ámbito de la consola El ámbito de la consola se establece en la función que se estaba ejecutando cuando se invoca el depurador de BrightScript, ya sea manualmente o automáticamente. Mientras está en la consola, puede escribir cualquier instrucción de BrightScript; luego se compilará y ejecutará en el contexto actual. Si el intérprete ha salido del script en ejecución, puede utilizar en su lugar el conjunto de comandos del shell de BrightSign. ### Comandos Los siguientes comandos de consola están disponibles actualmente en la consola de depuración de BrightScript: | **Comando** | **Descripción** | | ----------------------------- | ------------------------------------------------------------------------------- | | `bt` | Imprime un seguimiento de pila de los marcos de contexto de llamada de función. | | `clases` | Enumera todas las clases públicas. | | `cont` or `c` | Continúa la ejecución del script. | | `cuentas` | Enumera el recuento de instancias de Component de BrightScript. | | `da` | Muestra el desensamblado y el bytecode de esta función. | | `abajo` or `d` | Mueve una posición hacia abajo en la cadena de contexto de funciones. | | `salir` | Sale de la shell de depuración. | | `gc` | Ejecuta el recolector de basura y muestra estadísticas de recolección. | | `hash` | Imprime los histogramas internos de tablas hash. | | `último` | Muestra la última línea que se ejecutó. | | `métodos ` | Enumera los métodos proporcionados por la clase especificada. | | `métodos .` | Enumera los métodos proporcionados por la interfaz o clase especificada. | | `lista` | Enumera el código fuente actual de la función actual. | | `ld` | Muestra datos de líneas (registros fuente) | | `siguiente` | Muestra la siguiente línea que se ejecutará. | | `bsc` | Enumera todas las instancias de BrightScript Component asignadas. | | `estadísticas` | Muestra estadísticas. | | `paso` or `s` | Avanza una instrucción del programa. | | `t` | Avanza una instrucción y muestra cada opcode ejecutado. | | `arriba` or `u` | Sube una función en la cadena de contexto. | | `var` | Muestra las variables locales y sus tipos/valores. | | `imprimir` or `p` or `?` | Imprime el valor de la variable o expresión.\* | \*Los mensajes de `imprimir` de BrightScript se enrutan a la consola de la aplicación BrightSign, que es accesible a través del puerto serie principal o mediante Telnet/SSH, como se indicó anteriormente.