Depurador BrightScript
16 min
esta página sirve como guía para acceder al depurador de brightscript de los reproductores brightsign se puede acceder al brightscript debugger mediante una conexión serial física o a través de la red mediante ssh o telnet para la conexión serial física, se recomiendan ciertos cables como se describe en esta página docid\ vatux3slq6zyyxtvxfqvn ¿qué es el brightscript debugger? el brightscript debugger a veces se denomina brightscript debug console sin embargo, en un esfuerzo por mantener la consistencia y evitar posibles confusiones, se utiliza predominantemente el término brightscript debugger o, más simplemente, debugger el brightscript debugger es una cli que permite la interacción con el intérprete brightscript está representado por el prompt depurador de brightscript> y es una herramienta poderosa para solucionar problemas y depurar inconvenientes con scripts brightscript o interactuar con objetos brightscript es similar a la consola de javascript en los navegadores web, así como a otros depuradores populares (por ejemplo, gdb) los desarrolladores pueden establecer instrucciones stop (un breakpoint), recorrer paso a paso un script brightscript y obtener acceso al ámbito actual o a las variables inicializadas si el brightscript debugger no ha sido habilitado, los errores de tiempo de ejecución a menudo harán que el reproductor se reinicie cuando el brightscript debugger está habilitado, los errores de tiempo de ejecución harán que el brightsignos se detenga en la línea del error de tiempo de ejecución, permitiendo recorrer el script paso a paso dado que habilitar el brightscript debugger provocará que el reproductor se quede bloqueado cuando se encuentren errores de tiempo de ejecución, el brightscript debugger solo debe usarse en entornos de desarrollo o situaciones de depuración; debe deshabilitarse para implementaciones de producción consola brightsign la consola brightsign (o más simplemente, console) permite acceder al brightsign shell, brightscript debugger y registros a través del puerto serial de 3 5 mm puede encontrar más información sobre la consola brightsign y cómo habilitarla en esta página docid\ vatux3slq6zyyxtvxfqvn habilitación del debugger el debugger se habilita escribiendo una clave de registro en el registro del reproductor esto puede hacerse de varias maneras, como se describe a continuación nota si no hay un autorun brs presente en el dispositivo de almacenamiento del reproductor, presionar el botón svc no tendrá efecto el propósito del debugger es ayudar a depurar su script / aplicación, que necesariamente debe contener el autorun brs por lo tanto, si no hay un autorun brs presente en el dispositivo de almacenamiento, no hay nada que depurar desde el brightsign shell escriba lo siguiente desde el shell de brightsign docid\ vatux3slq6zyyxtvxfqvn script debug on pestaña dws registry desde la pestaña dws registry en brightsign author, envíe el siguiente comando escritura de registro brightscript depuración 1 inclusión con autorun las siguientes líneas pueden incluirse como parte de un archivo autorun brs reg = createobject("roregistrysection", "brightscript") reg write("debug","1") acceso al debugger cuando está habilitado, el debugger está representado por el prompt depurador de brightscript> y es accesible mediante un cable serial, telnet o ssh navegue hasta el debugger mediante uno de los métodos descritos a continuación si no ha habilitado el debugger, cualquier interrupción de la ejecución del intérprete brightscript no dará acceso al debugger en cambio, el reproductor se reiniciará para intentar una ejecución limpia durante el tiempo de ejecución presione ctrl c en su teclado mientras el reproductor está encendido instrucción stop en tiempo de ejecución si el debugger ha sido habilitado, el reproductor ingresará al debugger si ocurre un error de tiempo de ejecución o si se encuentra una instrucción stop mientras un script se está ejecutando acceso durante el arranque apague el reproductor encienda el reproductor y espere de 5 a 15 segundos mantenga presionado el botón svc del reproductor durante 15 30 segundos hasta que el prompt brightsign> aparezca en la aplicación de terminal serial/telnet/ssh el prompt brightsign> indica que usted está en el brightsign shell ahora puede soltar el botón svc si está utilizando telnet o ssh, deberá reiniciar la instancia de telnet o ssh métodos adicionales presione ctrl c en su aplicación de terminal que está conectada al reproductor retire la tarjeta microsd y presione ya sea el botón svc del reproductor o ctrl c en su computadora si se ha habilitado la consola serie (ya sea temporal o persistentemente), iniciando la aplicación brightsign aparecerá después de que el reproductor se reinicie (tenga en cuenta que esto puede tardar hasta 30 segundos) mantenga presionado el botón svc hasta que se muestre el indicador brightsign> si tiene almacenamiento extraíble, como una tarjeta microsd, expúlselo reinicie el reproductor y presione el botón svc si está accediendo al reproductor mediante telnet, tendrá que reiniciar la conexión telnet después de que el reproductor se reinicie usando el comando telnet {{your player ip address}} 23 coloque un archivo autorun brs que contenga únicamente la palabra “end” (sin las comillas) en el dispositivo de almacenamiento el script se ejecutará y, cuando finalice según lo indicado, quedará en el indicador brightsign> esto interrumpirá la aplicación que se esté ejecutando en ese momento y redirigirá al indicador de brightsign comandos del depurador los siguientes comandos de shell están disponibles actualmente en el depurador comando descripción bt imprime un backtrace 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 recuentos enumera el conteo de instancias de componentes brightscript da muestra el desensamblado y el bytecode para 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ínea (registros de origen) siguiente mostrar la siguiente línea a ejecutar bsc listar todas las instancias asignadas de brightscript component estadísticas mostrar estadísticas paso or s avanzar una instrucción del programa t avanzar una instrucción y mostrar cada opcode ejecutado arriba or u mover una función hacia arriba en la cadena de contexto var mostrar las variables locales y sus tipos/valores imprimir or p or ? imprimir el valor de una variable o expresión los mensajes de imprimir de brightscript se enrutan a brightsignos, al cual se puede acceder mediante el puerto serie principal o telnet/ssh cambiar entre el shell y el debugger desde el prompt brightsign> , escriba script para navegar al debugger script desde el prompt depurador de brightscript> , escriba salir para navegar al brightsign shell exit telnet y ssh se puede acceder al debugger con telnet o ssh puede encontrar más información en esta página docid\ vatux3slq6zyyxtvxfqvn depuración de código brightscript esta sección cubrirá cómo depurar código brightscript en un reproductor brightsign, asumiendo que el debugger ha sido habilitado y es accesible consulte brightscript docid\ x8g0c2z7merulkkluhl1e para obtener información sobre la documentación de brightscript de brightsign nuestro intérprete se bifurcó del lenguaje brightscript de roku hace muchos años y desde entonces han divergido cómo depurar brightscript para comenzar a recorrer o depurar código brightscript, agregue una instrucción detener a la línea de código desde la que desea comenzar la depuración una instrucción detener es un breakpoint en el código brightscript cuando el reproductor brightsign encuentra una instrucción detener , se detendrá y entrará en el brightscript debugger cuando el debugger esté habilitado el brightscript debugger es similar a muchos otros debuggers, por ejemplo, gdb le permite recorrer el código, inspeccionar variables y evaluar expresiones escriba ayuda en el debugger para ver una lista de comandos disponibles escriba vars para ver las variables y sus valores depuración de javascript o node js para habilitar chrome devtools y agregar el inspector remoto de brightsign, consulte depuración de páginas web docid\ tkkedyuswbejhd0ljmhcs vaya a chrome //inspect agregando la dirección ip de su reproductor en la misma red que su computadora solución de problemas si encuentra dificultades para conectar su aplicación de terminal al reproductor brightsign, consulte los pasos de solución de problemas descritos en esta página docid\ vatux3slq6zyyxtvxfqvn