# Roku aposenta o SGDEX e suas ferramentas de teste em 31 de janeiro de 2027: o que fazer com seu app de TV

> A Roku encerra o suporte ao SGDEX, ao Unit Test Framework e ao Automated App Testing em 31/01/2027. O que quebra de verdade, o que não quebra e um plano de migração.

- URL: https://blog.w2bit.com/blog/fim-do-sgdex-roku-o-que-fazer-ate-janeiro-2027
- Autor: Davidson Simões
- Publicado em: 2026-11-20
- Idioma: pt-BR
- Tags: smarttv, roku, brightscript, sgdex, testes, desenvolvimento
- Também disponível em inglês: https://blog.w2bit.com/en/blog/roku-sgdex-sunset-what-to-do-before-january-2027

Em 19 de novembro de 2026 a Roku anunciou a aposentadoria de três ferramentas legadas para desenvolvedores: o SceneGraph Developer Extensions (SGDEX), o Unit Test Framework e o Automated App Testing. Em 31 de janeiro de 2027 o suporte termina, as ferramentas deixam de poder ser baixadas da Roku, os repositórios no GitLab passam a ser somente leitura e a documentação sai do site de desenvolvedores. A Roku não oferece substituto direto. Para quem tem um app construído sobre o SGDEX, a notícia prática é melhor do que a manchete: o SGDEX é empacotado dentro do seu próprio app, então o que está publicado continua rodando, e os repositórios são arquivados, não apagados. O que muda é a propriedade. A partir de fevereiro de 2027, o código que desenha suas grades, telas de detalhe e player passa a ser seu para manter, e as duas ferramentas de teste das quais muitos pipelines de CI para Roku dependem precisam de substitutas. A seguir, o que o anúncio diz, o que não diz e como planejaríamos as próximas dez semanas.

## Resumo rápido

- **Três ferramentas, uma data.** SGDEX, Unit Test Framework e Automated App Testing perdem o suporte em 31 de janeiro de 2027. Repositórios arquivados, downloads e documentação removidos.
- **Apps publicados não são desligados.** O SGDEX é copiado para `pkg:/components/SGDEX` do seu app. Nada no anúncio muda como apps publicados rodam.
- **Sem substituto oficial.** A orientação da Roku: copie os componentes do SGDEX que você usa para o seu projeto e leve testes unitários e automação para outra abordagem.
- **Rooibos para testes unitários, ECP para automação.** O Rooibos é o framework da comunidade que os próprios engenheiros da Roku disseram querer integrar ao RSG 2.0 SDK; o WebDriver da Roku era só um tradutor para o External Control Protocol.
- **O RSG 2.0 ainda não é destino de migração.** O SDK em TypeScript só aceita sideload durante o beta, e a publicação na Streaming Store tem como meta o outono de 2027 no hemisfério norte.

![O que é o SGDEX dentro de um app Roku: views de tela cheia como GridView, DetailsView e MediaView, o ContentManager com seus ContentHandler, RAFHandler e EntitlementHandler, o ComponentController com o ViewStack e o ButtonBar, todos copiados para pkg:/components/SGDEX do pacote do app](https://blog.w2bit.com/static/images/roku-sgdex-sunset/anatomy.pt-br.webp)

_O SGDEX já mora no seu pacote: 117 arquivos, 48 componentes SceneGraph em XML e 53 arquivos BrightScript na versão atual. A aposentadoria muda quem os mantém, não onde eles rodam._

## O que a Roku anunciou em 19 de novembro

O post no Roku Developer Blog é curto e específico. Em 31 de janeiro de 2027 a Roku para de corrigir problemas e de responder perguntas sobre as três ferramentas, os downloads saem do ar, os repositórios no GitLab (com seus exemplos) viram somente leitura e a documentação é removida. Até lá, tudo continua disponível; a página Developer Tools já marca as três como descontinuadas, e as páginas de documentação do SGDEX e do Automated App Testing ganharam um aviso de encerramento.

A justificativa declarada é que são "ferramentas legadas com baixo uso" e que a Roku está "caminhando para ferramentas de desenvolvimento públicas e de código aberto", concentrando a engenharia no que mais desenvolvedores usam. A orientação de preparo tem uma linha por ferramenta: copie os componentes do SGDEX de que precisa para o seu projeto antes de o repositório ser arquivado; identifique as suítes que dependem do Unit Test Framework e leve-as para outra abordagem; identifique os testes e fluxos automatizados que dependem do Automated App Testing e substitua-os. Como os repositórios são arquivados e não apagados, dá para cloná-los antes de 31 de janeiro e guardar uma cópia.

## O que o SGDEX é, e por que o runtime não muda

A Roku descreve o SGDEX como "uma coleção de código de exemplo para desenvolvedores" feita de componentes SceneGraph reutilizáveis e pré-construídos, para montar apps rapidamente com uma UX consistente. A Roku chama de código de exemplo; para as equipes que o adotaram, é o framework de UI sobre o qual o app foi construído. O repositório oferece views de tela cheia (GridView, DetailsView, MediaView, SearchView, TimeGridView, CategoryListView, EntitlementView, ParagraphView e SlideShowView), um Content Manager que conecta uma view a um feed ou API e cuida dos Task nodes do SceneGraph por você, um Component Controller que gerencia a pilha de telas, um ButtonBar e handlers para o Roku Advertising Framework e para assinaturas e entitlement via Roku Pay. O último release, v2.9.1, é de 3 de novembro de 2023; o último commit, uma correção de link na documentação, é de fevereiro de 2024. A licença é Apache 2.0.

As instruções de instalação são a chave para ler essa aposentadoria corretamente. Para usar o SGDEX você copia a pasta `extensions/SGDEX` para dentro do app em `pkg:/components/SGDEX`, copia `SGDEX.brs` para `pkg:/source` e adiciona `bs_libs_required=roku_ads_lib` ao manifest. Não existe dependência em tempo de execução de um servidor da Roku nem do repositório: os componentes são compilados no seu pacote como qualquer outro componente SceneGraph (117 arquivos e cerca de 1,2 MB de código-fonte na versão atual). Nossa leitura, portanto, é que nenhum app publicado para de funcionar em 1º de fevereiro de 2027. O que acaba é o upstream: se uma versão futura do Roku OS mudar um comportamento do qual o SGDEX dependia, ninguém na Roku vai lançar a v2.9.2.

Esse upstream já fez diferença. O changelog do SGDEX registra uma correção na MediaView para um problema com o RAFHandler que apareceu no Roku OS 10.5, e um release anterior que "corrigiu vários problemas em que o Static Analysis da Roku reportava erros indevidos em canais SGDEX". Os dois tipos de mudança, comportamento do OS e regras de certificação, continuam acontecendo. A página de APIs descontinuadas da Roku afirma que o Static Analysis reporta APIs descontinuadas como erros e que todos os erros precisam ser resolvidos para publicar; a entrada mais nova, `roHttpAgent.InitClientCertificates()`, é um aviso hoje e vira erro que bloqueia a publicação em 1º de abril de 2027. O núcleo do SGDEX não chama essa função (três dos seus apps de exemplo chamam), mas o padrão é a lição: quem é dono da cópia no seu repositório é dono da próxima descontinuação.

## As duas ferramentas de teste e o que as substitui

O Unit Test Framework é um executor de testes em BrightScript: as suítes estendem um `BaseTestSuite`, um runner as coleta, executa no dispositivo e imprime um relatório, e uma "abordagem por anotações" mais nova empresta `@Test`, `@BeforeEach` e `@ParameterizedTest` do JUnit 5. O repositório mescla correções da comunidade até hoje (a última há um mês), mas depois de janeiro fica congelado.

O destino natural é o Rooibos, o framework de testes mantido pelo grupo RokuCommunity. O README o chama de "simples, inspirado em mocha e junit", a licença é MIT, e ele se descreve como "um projeto open source independente mantido exclusivamente por voluntários", com dezenas de milhares de testes em produção. Está atualizado: a versão 5.17.0 saiu em outubro de 2026, uma linha 6.0 em alpha está sendo publicada (alpha 58 em 16 de novembro) e uma mudança de outubro adicionou suporte ao Roku Cloud Emulator na CLI. Ele roda como plugin do BrighterScript, o superconjunto comunitário do BrightScript que compila para BrightScript padrão. O endosso mais forte vem da própria Roku. Questionados no Q&A do RSG 2.0 de 11 de novembro sobre qual é a ferramenta recomendada para testes unitários, os engenheiros da Roku disseram que usam Jest internamente para o SDK, que o Jest não roda no dispositivo, e que a equipe "gostaria de integrar o framework de testes BrightScript Rooibos" ao Jest para que testes JavaScript e SceneGraph rodem juntos, o que ainda não aconteceu "por falta de banda". Levar as suítes para o Rooibos agora é um passo na direção em que as ferramentas da própria Roku estão indo.

O Automated App Testing é outro tipo de ferramenta. A Roku distribuía um binário WebDriver no estilo Selenium com um servidor HTTP e um cliente ECP: seu teste em Robot Framework, JavaScript ou Python enviava comandos pelo JSON Wire Protocol, o WebDriver os traduzia em requisições do External Control Protocol, e o dispositivo respondia com o XML do SceneGraph do que estava na tela. O changelog para na v2.3.0, de setembro de 2021. O que vai embora é o tradutor; o ECP em si é uma API REST documentada e suportada na rede local, e é o que todo o resto usa também. Dois detalhes da documentação do ECP importam para a reconstrução: desde o Roku OS 14.1 a configuração "Control by mobile apps" precisa estar habilitada para receber `keypress`, e a família `query/sgnodes` exige modo desenvolvedor. Comandos ECP não podem partir de dentro de um app; o Static Analysis bloqueia quem tenta.

Há três rotas realistas. O Roku Test Automation (RTA), também sob a RokuCommunity e com licença MIT, controla dispositivos via ECP mais um componente no dispositivo que lê e define campos de nós, chama funções e consulta o foco; o README diz que ele tem mais recursos que a opção oficial da Roku e "não exige um servidor Go no meio para converter comandos ECP". O Roku Cloud Emulator, anunciado no Developer Summit de setembro e em distribuição por fases, expõe players e TVs virtuais por APIs REST e WebSocket feitas, nas palavras da Roku, para merge checks e execuções noturnas: iniciar um dispositivo a partir de um snapshot, fazer sideload do build, controlá-lo com comandos de tecla ECP, capturar os logs do firmware, parar e apagar. Para hardware real no circuito, a própria documentação da Roku aponta o stb-tester, um dispositivo de terceiros. É a mesma arquitetura que a Roku descreveu para testar o RSG 2.0 SDK: Jest em um laptop, app de teste em sideload, ECP para mexer nos campos e ler a árvore de volta.

![Linha do tempo do último release do SGDEX até a meta de publicação do RSG 2.0: v2.9.1 em 3 de novembro de 2023; Roku Cloud Emulator e RSG 2.0 anunciados em 23 de setembro de 2026; aposentadoria anunciada em 19 de novembro de 2026; blackouts da Streaming Store de 20 a 29 de novembro e de 18 de dezembro a 4 de janeiro; fim do suporte em 31 de janeiro de 2027; InitClientCertificates bloqueia a publicação a partir de 1º de abril de 2027; publicação de apps TypeScript na loja com meta para o outono de 2027](https://blog.w2bit.com/static/images/roku-sgdex-sunset/timeline.pt-br.webp)

_A aposentadoria cai entre dois blackouts da loja e bem antes de o SDK em TypeScript poder publicar. Planeje pelas janelas de publicação, não pela data do encerramento._

## As datas que moldam o plano

31 de janeiro é uma data para clonar e para o suporte, não para publicar. A Roku Streaming Store fica em blackout de 20 a 29 de novembro de 2026 e de 18 de dezembro de 2026 a 4 de janeiro de 2027. Submissões durante um blackout são certificadas, mas só publicadas depois, e a Roku diz que a certificação costuma levar ao menos cinco dias úteis. Se você quer um build com o SGDEX internalizado e a nova configuração de testes em produção antes do encerramento, as janelas realistas de submissão são de 30 de novembro a 17 de dezembro e de 5 a mais ou menos 22 de janeiro. Como o runtime não muda, perder essas janelas não custa nada em produção; o que não pode ser perdido é o clone.

Duas datas posteriores pertencem ao mesmo plano. 1º de abril de 2027 é quando `InitClientCertificates()` passa a bloquear a publicação, um lembrete para rodar o Static Analysis sobre a sua cópia do SGDEX em todo release. E o outono de 2027 no hemisfério norte, entre setembro e novembro, é a meta da Roku para a publicação pública de apps TypeScript feitos com o RSG 2.0 SDK. Até lá esse SDK só aceita sideload, a menos que uma equipe de parceria da Roku habilite um canal beta privado, e nada na lista de componentes anunciada, FlexGrid, gestão de foco e integração com SolidJS, é equivalente direto de uma GridView ou MediaView do SGDEX. Na nossa leitura, o RSG 2.0 é onde a nova UI para Roku deve ser desenhada, não um lugar para mover um app SGDEX antes do encerramento.

## Um plano de migração que cabe em dez semanas

Comece por um inventário, porque as três ferramentas se escondem em lugares diferentes. Para o SGDEX, procure componentes que estendem views e handlers do SGDEX (`GridView`, `DetailsView`, `MediaView`, `ContentHandler`, `RAFHandler`, `EntitlementHandler`), verifique se `pkg:/components/SGDEX` está commitado ou é baixado por um script de build, e registre qual versão você carrega. Para o Unit Test Framework, procure `UnitTestFramework.brs`, `BaseTestSuite` e a chamada do runner. Para o Automated App Testing, procure o binário `RokuWebDriver`, as bibliotecas Robot ou JavaScript e qualquer job de CI que os inicie.

Depois assuma a propriedade do SGDEX de forma deliberada. Clone o repositório completo, documentação incluída, já que a pasta `documentation`, com a referência de componentes, o guia de ContentHandlers e o guia do ViewStack, some do site da Roku junto com o resto. Commite a cópia que você distribui, fixe a versão e o hash do commit em um README e não conte com acompanhar um upstream: o projeto no GitLab mostra quatro branches importados da comunidade e nenhum commit desde fevereiro de 2024. Inclua a sua cópia na mesma rotina de lint, Static Analysis e beta do OS que o resto do código. Se você usa só duas ou três views, este é o momento de apagar o restante.

Para testes unitários, migre suíte por suíte para o Rooibos; a toolchain do BrighterScript dá uma CLI que roda em um dispositivo físico ou, desde outubro, em uma instância do Roku Cloud Emulator. Para automação, reconstrua sobre o ECP. Se seus testes eram principalmente sequências de teclas mais verificações de qual nó SceneGraph está na tela, o RTA cobre isso com menos infraestrutura. Se a meta é CI sem uma prateleira de dispositivos, peça acesso ao Roku Cloud Emulator ao Partner Success e prototipe um merge check: snapshot, sideload, ECP, logs. Mantenha uma passagem pequena em hardware para playback e DRM, para os quais emuladores não são a ferramenta certa.

## O que isso significa para equipes de TV multiplataforma

Nossa leitura, não uma declaração da Roku: essa aposentadoria combina com o resto dos movimentos da Roku em 2026. Os repositórios saíram do GitHub para o GitLab, o RSG 2.0 SDK foi lançado como código aberto sob MIT, o Cloud Emulator expõe dispositivos como APIs, e a Roku acaba de nomear o Rooibos como o framework que quer integrar. A plataforma está recuando dos andaimes opinativos de primeira parte e se apoiando em ferramentas abertas, da comunidade, mais um futuro em TypeScript. Para equipes que entregam o mesmo catálogo em Tizen, webOS, Android TV, Fire TV e Roku, isso é familiar: nas plataformas de TV baseadas em web, o framework de UI e as ferramentas de teste sempre foram seus.

A decisão a tomar agora não é "SGDEX ou RSG 2.0". É se vale continuar investindo em uma UI BrightScript que agora é sua, com orçamento de manutenção e uma suíte de testes que roda em CI, ou tratar o SGDEX internalizado como uma camada congelada e colocar as telas novas no SDK em TypeScript conforme o caminho de publicação abrir em 2027. De qualquer forma, a migração dos testes paga duas vezes: Rooibos e automação via ECP são as ferramentas que os engenheiros da Roku descreveram para o mundo TypeScript, então as suítes construídas agora acompanham você na transição.

![Mapa de migração das três ferramentas que a Roku está aposentando: o SGDEX vira código que você internaliza e mantém, com repositório clonado, versão fixada e Static Analysis em todo release; o Unit Test Framework vai para o Rooibos na toolchain do BrighterScript; o Automated App Testing é reconstruído sobre o ECP com Roku Test Automation, as APIs do Roku Cloud Emulator ou uma bancada de hardware como o stb-tester](https://blog.w2bit.com/static/images/roku-sgdex-sunset/migration.pt-br.webp)

_Um destino por ferramenta: assumir o código da UI, levar os testes unitários para o Rooibos, reconstruir a automação direto no ECP._

## Perguntas frequentes

### Meu app Roku vai parar de funcionar quando o SGDEX for aposentado em 31 de janeiro de 2027?

Não. O SGDEX é instalado copiando seus componentes para dentro do pacote do app, em `pkg:/components/SGDEX`, então um app publicado não tem dependência em tempo de execução do repositório da Roku. O que termina em 31 de janeiro de 2027 é o suporte, o download e a documentação; o repositório no GitLab vira somente leitura. Mudanças futuras no Roku OS ou na certificação que afetem o SGDEX terão de ser corrigidas na sua própria cópia.

### Pelo que devo substituir o Unit Test Framework da Roku?

A escolha mais comum é o Rooibos, framework de testes BrightScript com licença MIT mantido pelos voluntários da RokuCommunity, que teve o release 5.17.0 em outubro de 2026 e uma linha 6.0 em alpha em novembro. No Q&A do RSG 2.0 de 11 de novembro de 2026, os engenheiros da Roku disseram que gostariam de integrar o Rooibos ao Jest para o SDK em TypeScript. A própria Roku não nomeia substituto oficial.

### O que substitui o Automated App Testing e o WebDriver da Roku?

Qualquer coisa que fale o External Control Protocol (ECP), que o WebDriver da Roku apenas traduzia. As opções incluem o projeto comunitário Roku Test Automation, as APIs REST e WebSocket do Roku Cloud Emulator para CI, e bancadas de hardware como o stb-tester, que a documentação da Roku cita como alternativa de terceiros. Os dispositivos precisam de "Control by mobile apps" habilitado para teclas e de modo desenvolvedor para consultas de nós.

### Devo migrar um app SGDEX para o RSG 2.0 SDK em TypeScript em vez disso?

Não antes do encerramento. O RSG 2.0 SDK está em beta público, só aceita sideload, e a meta da Roku para a publicação pública de apps TypeScript na Streaming Store é o outono de 2027 no hemisfério norte. Seus componentes (FlexGrid, gestão de foco, SolidJS) não são substitutos diretos das views do SGDEX. Internalize o SGDEX agora e planeje as telas novas em TypeScript conforme o caminho de publicação abrir.

## Fontes

1. Roku Developer Blog, "Legacy Roku developer tools being sunset", 19 de novembro de 2026. [https://blog.roku.com/developer/tools-sunset](https://blog.roku.com/developer/tools-sunset)
2. Roku, "Deprecated APIs" (documentação, seção "Deprecated developer tools: January 31, 2027"). [https://developer.roku.com/dev/docs/deprecated-apis](https://developer.roku.com/dev/docs/deprecated-apis)
3. Roku, "SGDEX" (documentação, com aviso de encerramento). [https://developer.roku.com/dev/docs/sgdex](https://developer.roku.com/dev/docs/sgdex)
4. Roku, "SceneGraphDeveloperExtensions" (repositório no GitLab e README). [https://gitlab.com/rokudev/SceneGraphDeveloperExtensions](https://gitlab.com/rokudev/SceneGraphDeveloperExtensions)
5. Roku, "SceneGraphDeveloperExtensions CHANGELOG.md" (v2.9.1, 3 de novembro de 2023). [https://gitlab.com/rokudev/SceneGraphDeveloperExtensions/-/blob/master/CHANGELOG.md](https://gitlab.com/rokudev/SceneGraphDeveloperExtensions/-/blob/master/CHANGELOG.md)
6. Roku, "unit-testing-framework" (repositório no GitLab e README). [https://gitlab.com/rokudev/unit-testing-framework](https://gitlab.com/rokudev/unit-testing-framework)
7. Roku, "Automated App Testing" (documentação, com aviso de encerramento). [https://developer.roku.com/dev/docs/automated-channel-testing](https://developer.roku.com/dev/docs/automated-channel-testing)
8. Roku, "External Control Protocol (ECP)" (documentação). [https://developer.roku.com/dev/docs/external-control-api](https://developer.roku.com/dev/docs/external-control-api)
9. Roku Developer Blog, "Roku Cloud Emulator announced", 23 de setembro de 2026. [https://blog.roku.com/developer/rce](https://blog.roku.com/developer/rce)
10. Roku Developers forum, "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)
11. Roku Developer Blog, "RSG 2.0 SDK available for beta testing on October 29th", 23 de setembro de 2026. [https://blog.roku.com/developer/rsg-2-0-sdk-beta](https://blog.roku.com/developer/rsg-2-0-sdk-beta)
12. Roku Developer Blog, "2026 Roku Streaming Store publishing blackout periods announced", 25 de agosto de 2026. [https://blog.roku.com/developer/channel-store-blackouts-2026](https://blog.roku.com/developer/channel-store-blackouts-2026)
13. RokuCommunity, "rooibos" (repositório no GitHub e README). [https://github.com/rokucommunity/rooibos](https://github.com/rokucommunity/rooibos)
14. RokuCommunity, "roku-test-automation" (repositório no GitHub e README). [https://github.com/rokucommunity/roku-test-automation](https://github.com/rokucommunity/roku-test-automation)
15. RokuCommunity, "brighterscript" (repositório no GitHub e README). [https://github.com/rokucommunity/brighterscript](https://github.com/rokucommunity/brighterscript)
