- Publicado em
TypeScript no Roku: o que o beta do RSG 2.0 SDK muda para quem desenvolve apps de TV
- Autores

- Name
- Davidson Simões
- @davidsonsimoes
- Occupation
Software Developer (BR) @ Davidson / W2BIT
Table of Contents
- 1 Resumo rápido
- 2 O que a Roku lançou em 29 de outubro
- 3 Anchor nodes, SolidJS e duas threads
- 4 Foco é onde o modelo mais muda
- 5 O que o Q&A de 11 de novembro deixou explícito
- 6 Limites para incluir no planejamento
- 7 O que isso significa para quem publica em várias plataformas de TV
- 8 Perguntas frequentes
- 9 Fontes
O RSG 2.0 SDK da Roku, em beta público desde 29 de outubro de 2026, permite escrever componentes Roku SceneGraph em TypeScript em vez de BrightScript. A UI é SolidJS, o código roda no motor JavaScript Hermes e o SDK é código aberto sob licença MIT. Em 11 de novembro a Roku fez um Q&A ao vivo sobre o beta e publicou um resumo no dia seguinte. É o documento mais útil até agora para quem precisa decidir o que fazer: apps em TypeScript exigem o Roku OS 16.0, ainda não há threads, o Roku Advertising Framework é acessado por uma ponte em BrightScript e a meta para publicar apps TypeScript na Streaming Store é o outono de 2027 no hemisfério norte, entre setembro e novembro. Para equipes que já entregam apps de TV em TypeScript para Samsung, LG, Android TV e Fire TV, o Roku deixa de ser a plataforma onde o código compartilhado termina. Mas ele não vira uma plataforma React, e essa diferença define o plano.
Resumo rápido
- TypeScript agora é um caminho oficial no Roku. O SDK está no GitLab e no npm, sob MIT. O BrightScript continua, e os dois convivem no mesmo app.
- É beta, e só funciona por sideload. A publicação na Streaming Store é esperada para 2027; no Q&A, a meta foi o outono de 2027.
- A UI é SolidJS, não React. A Roku avaliou o React Native e descartou. Não há DOM, CSS nem navegador.
- As lacunas são conhecidas. Sem threads,
fetchbásico, crashes sem stack trace e limite de 4 MB por pacote. - A gestão de foco migra para o TypeScript, com um único ponto de ponte para o BrightScript.

Como as peças se encaixam: a cena continua sendo SceneGraph, a UI em TypeScript entra por anchor nodes e as atualizações cruzam para a thread de renderização uma vez por tick.
O que a Roku lançou em 29 de outubro
O SDK é publicado como pacotes @roku-sdk/* no registro público do npm, com o código em gitlab.com/rokudev/rsg-sdk; o pacote central, @roku-sdk/rsg-ts, está na versão 2.19.1. A Roku migrou seus repositórios do GitHub para o GitLab em outubro e aceita merge requests no SDK e na documentação.
A ferramenta de linha de comando rk faz o trabalho do dia a dia: rk create cria o app, rk device add registra um Roku na rede, rk dev checa tipos, compila, faz o sideload e abre o app, e rk mcp conecta um assistente de IA. Os pré-requisitos: um Roku com OS 16.0 ou superior em modo desenvolvedor, Node.js 24 ou superior e pnpm 11. O projeto gerado mantém um mínimo de BrightScript, um Main.brs e uma cena XML, e o resumo do Dev Summit diz que uma versão futura vai remover até isso.
Duas regras do beta pesam no planejamento. Só dá para fazer sideload: a Roku ainda constrói o lado da loja (compilação no servidor, analytics com stack traces, análise estática), e um anúncio separado vai marcar o fim do beta. E as APIs podem mudar: compatibilidade retroativa é meta declarada, mas durante o beta ainda pode haver quebras.
Anchor nodes, SolidJS e duas threads
O ponto de integração entre os dois mundos é o anchor node: um componente SceneGraph cujo conteúdo é escrito em TypeScript. Você registra os anchor nodes quando o motor TypeScript inicia e depois os coloca na cena pelo nome, como qualquer outro componente. Cada um declara campos de entrada e de saída, então uma cena em BrightScript observa e define os campos de um componente TypeScript como faria com qualquer outro. Abaixo do anchor node, tudo é SolidJS. O guia é explícito: importe de @roku-sdk/solid, nunca de solid-js, e o resumo do Dev Summit informa a versão como Solid 1.9. Os engenheiros da Roku explicaram a escolha: o Solid usa muito menos memória que o React, e o renderizador do React Native não mapeia bem para o SceneGraph. O mesmo resumo insiste que o SDK "não é um framework web". Seu JSX produz nós SceneGraph como rectangle, label e group, em coordenadas de 1920x1080.
O modelo de threads é a parte a internalizar primeiro. O TypeScript roda na própria thread, com a própria árvore. As atualizações para o SceneGraph entram em fila e são aplicadas no início do próximo tick de renderização, em ordem, como uma transação, então o último valor escrito vence. No sentido contrário, o TypeScript não consulta atributos de nós do SceneGraph em tempo de execução. A orientação da Roku no Q&A: se você se pega consultando nós, provavelmente está fazendo errado. Empurre os dados para os nós a partir dos seus modelos e, para estado que muda do lado nativo, como um nó Video, registre um callback de evento e guarde o valor. A definição de tipos de cada componente diz quais campos chegam como eventos e quais são definidos via props.
Foco é onde o modelo mais muda
Quem já construiu uma interface para TV sabe que o tratamento de foco é onde o tempo vai. A resposta do SDK é o focus boundary: um único nó SceneGraph detém o foco real, e todo o roteamento e tratamento de teclas dentro daquela subárvore acontece em TypeScript, com signals do SolidJS. Os componentes entram com o hook useFocusable, leem isFocused() como um acessor reativo para controlar o visual e declaram em um mapa as teclas que tratam. Boundaries se aninham: um menu lateral e uma área de conteúdo cuidam da própria navegação enquanto um boundary raiz delega entre eles.
A ponte para o BrightScript é pequena de propósito: o boundary raiz escreve um campo handledKeys, e a função onKeyEvent em BrightScript o lê de forma síncrona e retorna na hora, sem ida e volta. A Roku contrasta isso com o foco nativo do SceneGraph, em que mover o foco significa setFocus(true) via observação de campos e o tratamento de teclas fica espalhado por muitos componentes.
Os limites documentados valem ser lidos antes de portar uma tela: o boundary não detecta um diálogo nativo tomando o foco, um componente SceneGraph filho que chama setFocus(true) internamente (um RowList, por exemplo) deixa o foco virtual desatualizado, e múltiplos boundaries raiz na mesma cena não se coordenam. No Q&A, a recomendação da Roku para componentes nativos foi entregar o foco pelo boundary, e não chamar set focus diretamente. Nossa leitura: na forma, isso lembra as bibliotecas de foco que equipes de TV já usam em apps web para Tizen e webOS, em que uma camada JavaScript é dona do foco e a plataforma só vê eventos de tecla. O modelo mental é portável, mesmo que o código não seja.

Do anúncio à publicação: o beta está aberto agora, mas publicar apps TypeScript na loja é um evento de 2027.
O que o Q&A de 11 de novembro deixou explícito
O resumo publicado em 12 de novembro merece leitura completa. Estas são as respostas que colocaríamos em um documento de planejamento:
- O Roku OS 16.0 é obrigatório para fazer sideload de um app TypeScript. A documentação dizia o contrário e foi corrigida depois que um desenvolvedor recebeu o erro "not permitted to run TypeScript" em um aparelho no OS 15.3. A Roku diz que o 16.0 e o TypeScript rodam nos aparelhos mais básicos da linha, conhecidos como Liberty e Littlefield.
- A publicação vem em 2027. A meta para publicar apps TypeScript publicamente é o outono de 2027. Canais beta privados podem ser habilitados por um time de parceria; quem não tem gerente de parceria fica restrito ao sideload.
- Não há threads a partir do TypeScript hoje. A Roku reconhece o problema, sem prazo. O resumo do Dev Summit descreve a interface planejada como parecida com Web Workers, e um parceiro observou que ainda não existe equivalente ao task node, então trabalho pesado disputa a única thread.
- O RAF continua em BrightScript. O Roku Advertising Framework roda como plugin BrightScript, acessado por uma ponte. O limite de rastreamento de anúncios só existe no RAF, então você o lê em BrightScript e passa pela ponte.
- O
fetché básico por enquanto. Sem streaming;AbortControllernativo está nos planos eURLeURLSearchParamspodem virar polyfill. Não há referência de quais recursos de ECMAScript o Hermes suporta; sintaxe não suportada é rebaixada com Babel, caso a caso. - Teste é Jest, fora do aparelho. Os testes de integração da Roku rodam Jest em um laptop, fazem sideload de um app de teste, alteram campos via ECP e leem a árvore de volta.
Limites para incluir no planejamento
O resumo do Q&A do Dev Summit, publicado em 29 de outubro, completa o quadro. A Roku mantém por enquanto o tamanho máximo de pacote de 4 MB. Analytics de crash para TypeScript é algo que a Roku quer ter pronto antes de liberar a publicação, e a Crunchyroll observou que crashes de componentes TypeScript hoje não têm stack trace. Não existe hot reload de verdade: rk dev --watch recompila e envia o pacote inteiro a cada salvamento.
Sobre desempenho, a Roku diz que o Hermes executa TypeScript mais rápido que BrightScript "na maioria das áreas", com benchmarks que não publicou. O resumo também registra que Liberty e Littlefield não têm GPU e não chegam a 60 fps, e que Tim Lee, da Disney, mediu a ida e volta no Littlefield entre duas e quatro vezes mais longa. O FlexGrid, a grade virtualizada vitrine do SDK, roda apenas no Hermes e só é controlado do TypeScript, mas reutiliza tiles em BrightScript importados do XML, o que torna uma migração gradual realista.
Bibliotecas JavaScript de terceiros funcionam, com a ressalva dos parceiros de que muitas trazem dependências de navegador ou de Node que precisam ser trocadas, já que o Hermes roda JavaScript puro.

Onde o código compartilhado termina. A linha anda bastante em relação ao BrightScript, mas a camada de UI continua sendo escrita para o Roku.
O que isso significa para quem publica em várias plataformas de TV
Na W2BIT, desenvolvemos apps para Smart TV com React e React Native para plataformas como Android TV, LG webOS e Samsung Tizen. Nesse arranjo, o Roku sempre foi o ponto fora da curva: outra linguagem, outra toolchain e, na prática, outro time ou fornecedor. O RSG 2.0 SDK muda a linha. Um monorepo TypeScript agora pode abrigar o app Roku, e as partes de um produto de TV que não são UI, que na nossa experiência concentram a lógica mais difícil, podem ser compartilhadas: tipos de domínio, modelos de catálogo, clientes de API, estado de entitlement e de reprodução, mapeamento de analytics. Isso é interpretação nossa, não afirmação da Roku, e a ressalva sobre Hermes e bibliotecas dependentes de navegador vale para todo pacote compartilhado.
O que não dá para compartilhar é a UI. Um componente React escrito para Tizen ou Android TV não vira componente Roku; ele é reescrito em SolidJS sobre primitivas do SceneGraph, com o foco expresso por boundaries. Quem espera "React no Roku" vai se decepcionar; quem espera "TypeScript no Roku, com uma camada reativa enxuta" vai achar o trabalho previsível.
O plano que seguiríamos:
- Consiga um aparelho com Roku OS 16.0. Entre no programa beta de desenvolvedores se a atualização ainda não chegou ao seu hardware; nada em TypeScript roda no 15.3.
- Construa um anchor node, não um app. Escolha uma tela em que o FlexGrid compensa, como uma prateleira de catálogo, hospede-a na cena BrightScript existente e deixe o resto como está. É o caminho que a Roku desenhou.
- Inventarie o que fica em BrightScript. RAF, tudo que precisa de threads hoje e qualquer componente que toma o foco nativamente vão para a lista da ponte, não da portabilidade.
- Decida cedo a fronteira do código compartilhado. Mantenha os pacotes compartilhados livres de APIs de DOM, Node e navegador, e teste-os no Hermes.
- Não planeje lançamento em produção antes de a publicação abrir. O outono de 2027 é uma meta. Trabalho novo em BrightScript pode já nascer com interfaces de campo limpas, que migram com facilidade.
- Acompanhe o fórum. A Roku anuncia cada versão do beta na seção RSG 2.0 do fórum de desenvolvedores, onde os engenheiros respondem às perguntas.
Perguntas frequentes
O que é o Roku RSG 2.0 SDK?
É o SDK de código aberto da Roku, sob licença MIT, para construir apps Roku SceneGraph em TypeScript. Usa SolidJS na UI, roda no motor JavaScript Hermes e inclui a CLI rk, o componente FlexGrid e um sistema de gestão de foco. O beta público começou em 29 de outubro de 2026.
Já dá para publicar um app TypeScript na Roku Streaming Store?
Não. Durante o beta, apps feitos com o RSG 2.0 SDK só podem ser instalados por sideload. A Roku espera o suporte na Streaming Store em 2027 e, no Q&A de 11 de novembro, citou o outono de 2027 como meta. Canais beta privados exigem um time de parceria da Roku.
O RSG 2.0 SDK substitui o BrightScript?
Não. A Roku diz que o BrightScript continua suportado e sem data para ser descontinuado, embora a maior parte dos recursos vá para o TypeScript. Componentes TypeScript e BrightScript convivem no mesmo app por anchor nodes, então um app pode ser portado um componente de cada vez.
O RSG 2.0 SDK é baseado em React ou React Native?
Não. A UI é SolidJS, importada pelo pacote @roku-sdk/solid. Os engenheiros da Roku disseram que avaliaram o React Native e o descartaram porque o React é maior que o Solid e seu renderizador não mapeia bem para o SceneGraph.
Fontes
- Roku Developer Blog, "RSG 2.0 SDK available for beta testing", 29 de outubro de 2026. https://blog.roku.com/developer/rsg-2-0-sdk-beta-starts
- Nicole Sumrall, "RSG 2.0 SDK – Live Q&A Session replay is now available!", Roku Developer Blog, 12 de novembro de 2026. https://blog.roku.com/developer/rsg-2-0-sdk-live-qa-session-replay-is-now-available
- Fórum Roku Developers, "RSG 2.0 Live Q&A - Recap", 12 de novembro de 2026. https://forum.developer.roku.com/t/rsg-2-0-live-q-a-recap/11817
- Fórum Roku Developers, "Dev Summit 2026 - Q&A Recap", 29 de outubro de 2026. https://forum.developer.roku.com/t/dev-summit-2026-q-a-recap/11740
- Fórum Roku Developers, "RSG 2.0 SDK FAQs", 10 de junho de 2026. https://forum.developer.roku.com/t/rsg-2-0-sdk-faqs/11453
- Roku, "Getting started with the RSG 2.0 SDK" (documentação). https://developer.roku.com/dev/docs/rsg-sdk-standing-docs-getting-started-first-app
- Roku, "Focus boundary" (documentação). https://developer.roku.com/dev/docs/rsg-sdk-standing-docs-guides-focus-management-focus-boundary
- Fórum Roku Developers, "RSG 2.0 public beta: 'not permitted to run TypeScript' on a sideloaded rk create app", 30 de outubro de 2026. https://forum.developer.roku.com/t/rsg-2-0-public-beta-not-permitted-to-run-typescript-on-a-sideloaded-rk-create-app/11748
- npm, "@roku-sdk/rsg-ts" (página do pacote). https://www.npmjs.com/package/@roku-sdk/rsg-ts
- Roku Developer Blog, "Developer repositories moved from GitHub to GitLab", 15 de outubro de 2026. https://blog.roku.com/developer/gitlab-move