Consola de depuración de BrightScript
7 min
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 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 apague el reproductor encienda el reproductor y espere entre 5 y 15 segundos presione y mantenga presionado el botón svc del lateral del reproductor si está utilizando telnet, deberá reiniciar telnet ejecutando telnet {{la dirección ip de tu reproductor}} 23 en la línea de comandos 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 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 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 \<class> enumera los métodos proporcionados por la clase especificada métodos \<class> \<interface> 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