W2BIT logo
Publicado em

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

Read in English →

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

    Software Developer (BR) @ Davidson / W2BIT

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

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

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

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
  2. Roku, "Deprecated APIs" (documentação, seção "Deprecated developer tools: January 31, 2027"). https://developer.roku.com/dev/docs/deprecated-apis
  3. Roku, "SGDEX" (documentação, com aviso de encerramento). https://developer.roku.com/dev/docs/sgdex
  4. Roku, "SceneGraphDeveloperExtensions" (repositório no GitLab e README). 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
  6. Roku, "unit-testing-framework" (repositório no GitLab e README). 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
  8. Roku, "External Control Protocol (ECP)" (documentação). 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
  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
  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
  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
  13. RokuCommunity, "rooibos" (repositório no GitHub e README). https://github.com/rokucommunity/rooibos
  14. RokuCommunity, "roku-test-automation" (repositório no GitHub e README). https://github.com/rokucommunity/roku-test-automation
  15. RokuCommunity, "brighterscript" (repositório no GitHub e README). https://github.com/rokucommunity/brighterscript