W2BIT logo
Publicado em

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

Read in English →

Autores
  • Davidson Simões
    Name
    Davidson Simões
    Twitter
    @davidsonsimoes
    Occupation

    Software Developer (BR) @ Davidson / W2BIT

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, fetch bá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.
Arquitetura de um app com o RSG 2.0 SDK: uma cena em BrightScript hospeda anchor nodes escritos em TypeScript com SolidJS, que rodam na thread do Hermes e enviam atualizações em lote para a thread de renderização do SceneGraph; o RAF e outros códigos BrightScript são acessados por uma ponte

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.

Linha do tempo do RSG 2.0 SDK: FAQ em junho, anúncio no Dev Summit em 23 de setembro, beta público em 29 de outubro (só sideload), Q&A ao vivo em 11 de novembro e publicação na Streaming Store com meta para o outono de 2027

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; AbortController nativo está nos planos e URL e URLSearchParams podem 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.

O que uma equipe de TV multiplataforma pode compartilhar com um app Roku no RSG 2.0 SDK: tipos, modelos, clientes de API e lógica de negócio são compartilháveis; a UI em SolidJS, os componentes SceneGraph, os focus boundaries e os shims em BrightScript são específicos do Roku; DOM, CSS, worker threads e fetch com streaming não estão disponíveis

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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

  1. 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
  2. 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
  3. 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
  4. 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
  5. 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
  6. 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
  7. Roku, "Focus boundary" (documentação). https://developer.roku.com/dev/docs/rsg-sdk-standing-docs-guides-focus-management-focus-boundary
  8. 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
  9. npm, "@roku-sdk/rsg-ts" (página do pacote). https://www.npmjs.com/package/@roku-sdk/rsg-ts
  10. Roku Developer Blog, "Developer repositories moved from GitHub to GitLab", 15 de outubro de 2026. https://blog.roku.com/developer/gitlab-move