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

> O RSG 2.0 SDK leva TypeScript e SolidJS ao Roku, em código aberto sob MIT. O que o beta e o Q&A de 11 de novembro revelam, o que ainda falta e como planejar.

- URL: https://blog.w2bit.com/blog/roku-rsg-2-sdk-typescript-apps-de-tv
- Autor: Davidson Simões
- Publicado em: 2026-11-18
- Idioma: pt-BR
- Tags: smarttv, roku, typescript, brightscript, javascript, desenvolvimento
- Também disponível em inglês: https://blog.w2bit.com/en/blog/roku-rsg-2-sdk-typescript-tv-apps

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](https://blog.w2bit.com/static/images/roku-rsg-2-typescript/architecture.pt-br.webp)

_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](https://blog.w2bit.com/static/images/roku-rsg-2-typescript/timeline.pt-br.webp)

_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](https://blog.w2bit.com/static/images/roku-rsg-2-typescript/sharing.pt-br.webp)

_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](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](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](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](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](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](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](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](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](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](https://blog.roku.com/developer/gitlab-move)
