Puntos clave
- RSG 2.0 aporta desarrollo en TypeScript y TSX a Roku, complementando BrightScript tradicional y habilitando prácticas modernas de desarrollo.
- Los requisitos incluyen un dispositivo Roku con sistema operativo 16.0 o superior, Node.js 24+ y pnpm 11 para el entorno de desarrollo.
- Los desarrolladores deben habilitar el modo desarrollador en los dispositivos Roku y configurar la máquina de desarrollo para permitir carga lateral y pruebas de aplicaciones.
- La herramienta de línea de comandos rk simplifica la creación, construcción, prueba y despliegue de aplicaciones RSG 2.0 en dispositivos Roku.
- RSG 2.0 está en beta pública; actualmente no se pueden publicar aplicaciones en la Roku Streaming Store y deben instalarse mediante carga lateral.
- Los componentes TypeScript pueden coexistir con BrightScript tradicional en la misma aplicación, permitiendo una migración gradual desde enfoques de desarrollo heredados.
Introducción
Roku ha apoyado tradicionalmente el desarrollo de aplicaciones usando BrightScript y XML, con Roku SceneGraph sirviendo como el marco subyacente para construir interfaces de usuario para televisión.
A medida que evolucionan los requisitos de desarrollo de aplicaciones, los desarrolladores buscan cada vez más lenguajes de programación modernos, código estructurado, componentes reutilizables y herramientas de desarrollo mejoradas.
Para apoyar esta evolución, Roku presentó el Roku SceneGraph 2.0 (RSG 2.0) SDK, que integra el desarrollo basado en TypeScript en la plataforma Roku.
Con RSG 2.0, los desarrolladores pueden crear aplicaciones Roku usando TypeScript y TSX mientras continúan usando el marco de renderizado SceneGraph existente.
Un punto importante es que RSG 2.0 no reemplaza BrightScript. En cambio, proporciona un enfoque adicional de desarrollo que permite que componentes en TypeScript y BrightScript tradicionales coexistan dentro de la misma aplicación.
Esto hace que el SDK sea relevante tanto para nuevos proyectos Roku como para equipos de desarrollo que exploran una transición gradual desde el desarrollo tradicional de Roku.
En este artículo, repasaremos los requisitos previos, la configuración del entorno, la instalación del SDK, la creación del proyecto y los pasos necesarios para ejecutar tu primera aplicación RSG 2.0.
¿Qué es el SDK Roku RSG 2.0?
RSG 2.0 es el SDK de desarrollo basado en TypeScript de Roku para crear aplicaciones utilizando el framework Roku SceneGraph.
Tradicionalmente, los desarrolladores usaban:
- BrightScript: Para implementar la lógica de la aplicación, integraciones de API y funcionalidades de negocio.
- XML: Para definir los componentes de la interfaz de usuario, sus propiedades y relaciones.
- SceneGraph: Para renderizar la interfaz de usuario de la aplicación.
RSG 2.0 introduce TypeScript y TSX como otra forma de desarrollar la lógica de la aplicación y los componentes de la interfaz de usuario.
Algunas de sus capacidades clave incluyen:
- Desarrollo de aplicaciones basado en TypeScript.
- Soporte para TSX para crear componentes de la interfaz de usuario.
- Integración con SolidJS para el desarrollo reactivo de la interfaz de usuario.
- Componentes reutilizables en TypeScript.
- Soporte para componentes existentes en BrightScript y XML.
- Configuración de aplicaciones basada en TypeScript.
- Capacidades de pruebas unitarias e integradas.
- Herramientas modernas de desarrollo y depuración.
Es importante destacar que RSG 2.0 no es un framework basado en web. No utiliza HTML, CSS ni renderizado en navegador. Los componentes de TypeScript crean finalmente nodos SceneGraph, que son renderizados por la plataforma Roku.
Para una comprensión más amplia, consulte la Descripción general del SDK RSG 2.0 oficial.
Prerrequisitos para el desarrollo de RSG 2.0
Antes de crear una aplicación RSG 2.0, los desarrolladores deben preparar el entorno de desarrollo requerido.
Los siguientes requisitos previos están documentados en la guía actual para comenzar de Roku.
Requisito | Propósito |
Dispositivo Roku | Ejecutar y probar la aplicación |
Roku OS 16.0 o posterior | Versión requerida del software del dispositivo |
Node.js 24 o posterior | Ejecutar el entorno de desarrollo |
pnpm versión 11 | Gestionar las dependencias del proyecto |
Editor de código | Escribir y mantener código TypeScript |
Modo desarrollador | Instalar aplicaciones mediante sideloading |
Acceso al registro npm | Descargar paquetes SDK |
Conocimientos técnicos recomendados
Los desarrolladores también deberían tener un entendimiento básico de:
- Fundamentos de JavaScript y TypeScript.
- TSX y desarrollo basado en componentes.
- Roku SceneGraph.
- Conceptos básicos de programación asíncrona.
- Fundamentos de SolidJS para desarrollo de UI reactiva.
Los desarrolladores provenientes de BrightScript pueden aprender gradualmente el modelo de programación TypeScript mientras continúan trabajando con sus conocimientos existentes de Roku.
Requisito del dispositivo: El dispositivo Roku y la computadora de desarrollo deberían estar conectados a la misma red para que las herramientas de desarrollo puedan comunicarse con el dispositivo.
Para información adicional, consulte la Guía oficial de inicio con el SDK RSG 2.0 de Roku.
Configuración del entorno de desarrollo para Roku
Una vez que se cuenten con los prerrequisitos, el siguiente paso es configurar el dispositivo Roku y la máquina de desarrollo.
Paso 1: Activar el modo desarrollador en Roku
Las aplicaciones de Roku desarrolladas con RSG 2.0 se instalan en dispositivos de desarrollo mediante un proceso llamado sideloading.
Para activar el modo desarrollador:
- Usa el control remoto de Roku y presiona Inicio tres veces, Arriba dos veces, seguido de Derecha, Izquierda, Derecha, Izquierda y Derecha.
- Aparecerá la pantalla de configuración para desarrolladores.
- Anota la dirección IP del dispositivo Roku.
- Activa el Instalador de Aplicaciones en Desarrollo.
- Acepta el Acuerdo de Licencia de las Herramientas de Desarrollador.
- Configura una contraseña para desarrolladores.
- Permite que el dispositivo Roku se reinicie.
Después del reinicio, el dispositivo estará listo para el desarrollo de aplicaciones y el sideloading.
Para instrucciones detalladas, consulta Activar el modo desarrollador en Roku.
Paso 2: Instalar Node.js y pnpm
RSG 2.0 utiliza Node.js y pnpm para gestionar el entorno de desarrollo y las dependencias del proyecto.
Asegúrate de tener instaladas las siguientes versiones:
- Node.js 24 o superior.
- pnpm 11.
Puedes verificar las versiones instaladas usando la terminal:
node -v
pnpm -v
Si las versiones instaladas cumplen con los requisitos de Roku, puedes continuar creando tu primera aplicación.
Paso 3: Asegurar el acceso al registro npm
Los paquetes del SDK RSG 2.0 se distribuyen a través del registro de paquetes npm bajo el espacio de nombres @roku-sdk.
Por lo tanto, la máquina de desarrollo debe tener acceso a:
https://registry.npmjs.org
La documentación oficial para comenzar indica que los paquetes del SDK están disponibles públicamente, por lo que no se requiere una cuenta de registro ni un token de autenticación para descargarlos.
Creando tu primera aplicación RSG 2.0
Roku proporciona una herramienta de línea de comandos llamada rk para crear, compilar, probar y ejecutar aplicaciones RSG 2.0.
La herramienta se distribuye a través del paquete @roku-sdk/tooling.
Sigue estos pasos para crear tu primera aplicación.
Paso 1: Crear un nuevo proyecto
Abre la terminal y ejecuta:
npx --package @roku-sdk/tooling rk create my-first-app
Aquí:
- npx ejecuta el paquete requerido sin necesidad de una instalación global por separado.
- @roku-sdk/tooling proporciona las herramientas de línea de comandos de desarrollo de Roku.
- rk create genera una nueva aplicación.
- my-first-app es el nombre del proyecto.
El comando genera la estructura de la aplicación e instala las dependencias SDK necesarias.
Paso 2: Navegar al directorio del proyecto
Una vez que el proyecto está creado, navega hacia él:
cd my-first-app
Paso 3: Ejecutar la aplicación
Ejecuta el siguiente comando:
npx rk dev
El comando de desarrollo realiza la compilación necesaria para desarrollo, verificación de tipos, carga lateral y lanzamiento de la aplicación en el dispositivo Roku configurado.
Los desarrolladores también pueden instalar opcionalmente el lanzador CLI para ejecutar rk directamente sin usar el prefijo npx cada vez.
Para más información, consulta la guía oficial Guía de inicio rápido de RSG 2.0.
Comprendiendo la estructura del proyecto generado
Después de crear la aplicación, Roku genera una estructura de proyecto predefinida que contiene los archivos esenciales de configuración y fuente.
A continuación, algunos archivos y directorios importantes:
Archivo / Directorio | Propósito |
package.json | Contiene las dependencias del proyecto y los scripts para compilar, probar, analizar y verificar tipos. |
pnpm-workspace.yaml | Define la configuración del espacio de trabajo pnpm y los ajustes necesarios para el script de instalación. |
roku-config.ts | Contiene la configuración de compilación de la aplicación, el punto de entrada y los ajustes del manifiesto. |
src/index.ts | Punto de entrada de la aplicación responsable de registrar los nodos ancla de TypeScript. |
src/components/ | Contiene los componentes de la aplicación en TypeScript. |
src/compiled-components/ | Contiene los archivos generados de componentes SceneGraph. |
pkg/ | Contiene los recursos y archivos de empaquetado de la aplicación Roku. |
Comprender estos archivos ayuda a los desarrolladores a identificar dónde se mantiene la configuración de la aplicación, la implementación de componentes y los recursos relacionados con la compilación.
Por ejemplo, src/index.ts es un punto de partida importante porque inicializa la aplicación TypeScript y registra los componentes que deben montarse en SceneGraph.
De manera similar, roku-config.ts ofrece una ubicación centralizada para gestionar la configuración de aplicación y compilación.
La estructura exacta del proyecto puede variar según la versión del SDK y los requisitos del proyecto.
Conectando un dispositivo Roku al entorno de desarrollo
Después de crear la aplicación, los desarrolladores deben configurar el dispositivo Roku para que la herramienta rk pueda instalar y lanzar aplicaciones en él.
Primero, agrega el dispositivo Roku usando su dirección IP:
rk device add 192.168.1.42 --name living-room
Sustituye la dirección IP de ejemplo por la dirección IP real de tu dispositivo Roku.
A continuación, configura la contraseña del desarrollador:
rk device update living-room --password
Establece el dispositivo como el objetivo de desarrollo activo:
rk device set-active living-room
Finalmente, verifica la configuración del dispositivo:
rk device ls
Una vez que el dispositivo aparezca como activo, el entorno de desarrollo estará listo para desplegar la aplicación.
Ejecución y verificación de tu primera aplicación
Con el proyecto y el dispositivo Roku configurados, ejecuta:
rk dev
El comando realiza las siguientes operaciones:
- Verifica los tipos de TypeScript.
- Compila la aplicación.
- Instala la aplicación en el dispositivo Roku activo.
- Lanza la aplicación.
Si todo está configurado correctamente, la aplicación debería lanzarse en la televisión y mostrar un título y un subtítulo centrados.
Si la aplicación no se lanza correctamente, los desarrolladores pueden usar:
rk dev --console
Este comando proporciona acceso a la salida de la consola del dispositivo, ayudando a los desarrolladores a identificar errores de inicio y otros problemas.
El comando rk dev también soporta opciones útiles como:
- --device: Selecciona un dispositivo Roku específico.
- --watch: Reconstruye y vuelve a desplegar automáticamente cuando los archivos cambian.
- --console: Transmite la salida de la consola del dispositivo.
- --debug: Ejecuta la aplicación en modo depuración para adjuntar un depurador.
Estas opciones hacen que el flujo de trabajo de desarrollo sea más conveniente al construir y validar aplicaciones.
Consideraciones importantes antes de comenzar el desarrollo
Antes de adoptar RSG 2.0 para un proyecto, los desarrolladores deben entender su disponibilidad y limitaciones actuales.
Disponibilidad en beta: A noviembre de 2026, RSG 2.0 está en beta pública. La documentación de Roku indica que las API y la documentación pueden cambiar durante este período.
Publicación de aplicaciones: Las aplicaciones desarrolladas con RSG 2.0 actualmente no pueden publicarse en la Roku Streaming Store durante el período beta. Las aplicaciones pueden instalarse y evaluarse mediante sideloading.
Compatibilidad del dispositivo: Los requisitos de desarrollo documentados especifican Roku OS 16.0 o superior. Los desarrolladores deben verificar los requisitos oficiales más recientes antes de comenzar la implementación.
Adopción gradual: No es necesario reescribir de inmediato las aplicaciones existentes en BrightScript y XML. Los componentes TypeScript pueden introducirse de forma incremental junto con los componentes existentes.
Para la planificación del proyecto, es importante distinguir entre evaluar el SDK, desarrollar una aplicación y adoptarla para distribución en producción.
Conclusión
Comenzar con el Roku RSG 2.0 SDK implica comprender su modelo de desarrollo, preparar el entorno requerido, instalar las herramientas del SDK, crear un proyecto y conectar un dispositivo Roku.
La introducción de TypeScript y TSX ofrece a los desarrolladores de Roku otro método para construir aplicaciones SceneGraph manteniendo la compatibilidad con el desarrollo tradicional en BrightScript y XML.
La herramienta de línea de comandos rk también simplifica actividades importantes de desarrollo, como la creación de proyectos, la verificación de tipos, la compilación, la carga lateral y la ejecución de aplicaciones.
Para los desarrolladores que son nuevos en RSG 2.0, el punto de partida recomendado es crear una pequeña aplicación, comprender la estructura del proyecto generado y ejecutarla con éxito en un dispositivo Roku antes de avanzar hacia un desarrollo de aplicaciones más complejo.
Una vez completada la configuración inicial, los desarrolladores pueden explorar con mayor detalle los conceptos centrales del SDK, las capacidades de desarrollo de UI, las herramientas de prueba y las funciones avanzadas.
Documentación y referencias oficiales de Roku
Los siguientes recursos oficiales fueron usados para la preparación de este artículo:
- Visión general del RSG 2.0 SDK
- Comenzando con el RSG 2.0 SDK
- Activación del modo desarrollador
- Primeros pasos – sección de documentación RSG 2.0
Nota editorial: RSG 2.0 está en evolución durante su período beta. Los desarrolladores deben consultar siempre la documentación oficial más reciente de Roku para conocer los requisitos del SDK, versiones de paquetes, comandos y restricciones de publicación.
