Wichtigste Erkenntnisse
- RSG 2.0 bringt TypeScript- und TSX-Entwicklung zu Roku, ergänzt das traditionelle BrightScript und ermöglicht moderne Entwicklungspraktiken.
- Voraussetzungen sind ein Roku-Gerät mit OS 16.0 oder höher, Node.js 24+ und pnpm 11 für die Entwicklungsumgebung.
- Entwickler müssen den Entwicklermodus auf Roku-Geräten aktivieren und den Entwicklungsrechner so konfigurieren, dass Sideloading und Anwendungstests ermöglicht werden.
- Das Kommandozeilenwerkzeug rk vereinfacht das Erstellen, Bauen, Testen und Bereitstellen von RSG 2.0-Anwendungen auf Roku-Geräten.
- RSG 2.0 befindet sich in der öffentlichen Beta; Anwendungen können derzeit nicht im Roku Streaming Store veröffentlicht und müssen per Sideloading installiert werden.
- TypeScript-Komponenten können in derselben Anwendung neben traditionellem BrightScript koexistieren, wodurch eine schrittweise Migration von älteren Entwicklungsansätzen ermöglicht wird.
Einführung
Roku hat traditionell die Anwendungsentwicklung mit BrightScript und XML unterstützt, wobei Roku SceneGraph als zugrundeliegendes Framework zum Erstellen von Benutzeroberflächen für Fernseher dient.
Da sich die Anforderungen an die Anwendungsentwicklung weiterentwickeln, suchen Entwickler zunehmend nach modernen Programmiersprachen, strukturierendem Code, wiederverwendbaren Komponenten und verbesserten Entwicklungstools.
Um diese Weiterentwicklung zu unterstützen, hat Roku das Roku SceneGraph 2.0 (RSG 2.0) SDK eingeführt, das eine auf TypeScript basierende Entwicklung auf der Roku-Plattform ermöglicht.
Mit RSG 2.0 können Entwickler Roku-Anwendungen mit TypeScript und TSX erstellen und gleichzeitig das bestehende SceneGraph-Rendering-Framework weiterhin nutzen.
Ein wichtiger Punkt ist, dass RSG 2.0 BrightScript nicht ersetzt. Stattdessen bietet es einen zusätzlichen Entwicklungsansatz, der es ermöglicht, TypeScript- und traditionelle BrightScript-Komponenten innerhalb derselben Anwendung nebeneinander zu verwenden.
Dies macht das SDK sowohl für neue Roku-Projekte als auch für Entwicklungsteams relevant, die einen schrittweisen Übergang von der traditionellen Roku-Entwicklung erkunden.
In diesem Artikel führen wir Sie durch die Voraussetzungen, die Einrichtung der Umgebung, die SDK-Installation, die Projekterstellung und die Schritte, die zum Ausführen Ihrer ersten RSG 2.0-Anwendung erforderlich sind.
Was ist das Roku RSG 2.0 SDK?
RSG 2.0 ist das TypeScript-basierte Entwicklungs-SDK von Roku zur Erstellung von Anwendungen mit dem Roku SceneGraph-Framework.
Traditionell verwendeten Entwickler:
- BrightScript: Zur Implementierung der Anwendungslogik, API-Integrationen und Geschäfts-funktionalitäten.
- XML: Zur Definition von UI-Komponenten, deren Eigenschaften und Beziehungen.
- SceneGraph: Zur Darstellung der Benutzeroberfläche der Anwendung.
RSG 2.0 führt TypeScript und TSX als weitere Möglichkeit zur Entwicklung von Anwendungslogik und Benutzeroberflächen-komponenten ein.
Einige seiner wichtigsten Funktionen umfassen:
- TypeScript-basierte Anwendungsentwicklung.
- TSX-Unterstützung zur Erstellung von UI-Komponenten.
- Integration von SolidJS für reaktive UI-Entwicklung.
- Wiederverwendbare TypeScript-Komponenten.
- Unterstützung bestehender BrightScript- und XML-Komponenten.
- TypeScript-basierte Anwendungs-konfiguration.
- Fähigkeiten für Unit- und Integrationstests.
- Moderne Entwicklungs- und Debugging-Tools.
Wichtig ist, dass RSG 2.0 kein webbasiertes Framework ist. Es verwendet weder HTML, CSS noch Browser-Rendering. TypeScript-Komponenten erzeugen letztlich SceneGraph-Knoten, die von der Roku-Plattform dargestellt werden.
Für ein umfassenderes Verständnis siehe den offiziellen RSG 2.0 SDK-Überblick.
Voraussetzungen für die Entwicklung von RSG 2.0
Bevor Entwickler eine RSG 2.0-Anwendung erstellen, müssen sie die erforderliche Entwicklungsumgebung vorbereiten.
Die folgenden Voraussetzungen sind im aktuellen Einstiegshandbuch von Roku dokumentiert.
Anforderung | Zweck |
Roku-Gerät | Ausführung und Testen der Anwendung |
Roku OS 16.0 oder neuer | Erforderliche Softwareversion des Geräts |
Node.js 24 oder neuer | Ausführung der Entwicklungsumgebung |
pnpm Version 11 | Verwaltung der Projektabhängigkeiten |
Code-Editor | Schreiben und Pflegen von TypeScript-Code |
Entwicklermodus | Installation von Anwendungen per Sideloading |
Zugriff auf das npm-Registry | Herunterladen von SDK-Paketen |
Empfohlenes technisches Wissen
Entwickler sollten außerdem grundlegende Kenntnisse in folgenden Bereichen haben:
- Grundlagen von JavaScript und TypeScript.
- TSX und komponentenbasierte Entwicklung.
- Roku SceneGraph.
- Grundlegende Konzepte der asynchronen Programmierung.
- Grundlagen von SolidJS für die reaktive UI-Entwicklung.
Entwickler mit BrightScript-Erfahrung können das TypeScript-Programmiermodell schrittweise erlernen und dabei weiterhin ihr bestehendes Roku-Wissen nutzen.
Geräteanforderung: Das Roku-Gerät und der Entwicklungscomputer sollten mit demselben Netzwerk verbunden sein, damit die Entwicklungstools mit dem Gerät kommunizieren können.
Für weitere Informationen konsultieren Sie die offizielle Einführung in das RSG 2.0 SDK von Roku.
Einrichten der Roku-Entwicklungsumgebung
Sobald die Voraussetzungen erfüllt sind, besteht der nächste Schritt darin, das Roku-Gerät und die Entwicklungsumgebung einzurichten.
Schritt 1: Entwickler-Modus auf Roku aktivieren
Roku-Anwendungen, die mit RSG 2.0 entwickelt wurden, werden auf Entwicklungsgeräten über einen Prozess namens Sideloading installiert.
Um den Entwickler-Modus zu aktivieren:
- Verwenden Sie die Roku-Fernbedienung und drücken Sie dreimal die Home-Taste, zweimal nach oben, anschließend Rechts, Links, Rechts, Links und Rechts.
- Der Bildschirm für Entwickler-Einstellungen wird angezeigt.
- Notieren Sie die IP-Adresse des Roku-Geräts.
- Aktivieren Sie den Installer für Entwicklungsanwendungen.
- Akzeptieren Sie die Lizenzvereinbarung für Entwickler-Tools.
- Legen Sie ein Entwickler-Passwort fest.
- Erlauben Sie dem Roku-Gerät, neu zu starten.
Nach dem Neustart ist das Gerät bereit für die Anwendungsentwicklung und das Sideloading.
Detaillierte Anweisungen finden Sie unter Entwicklermodus auf Roku aktivieren.
Schritt 2: Node.js und pnpm installieren
RSG 2.0 verwendet Node.js und pnpm zur Verwaltung der Entwicklungsumgebung und der Projektabhängigkeiten.
Stellen Sie sicher, dass die folgenden Versionen installiert sind:
- Node.js 24 oder höher.
- pnpm 11.
Sie können die installierten Versionen im Terminal mit folgenden Befehlen überprüfen:
node -v
pnpm -v
Wenn die installierten Versionen den Roku-Anforderungen entsprechen, können Sie mit der Erstellung Ihrer ersten Anwendung fortfahren.
Schritt 3: Zugriff auf npm-Registry sicherstellen
Die RSG 2.0 SDK-Pakete werden über die npm-Paket-Registry unter dem Namespace @roku-sdk verteilt.
Daher muss die Entwicklungsmaschine Zugriff auf folgende Adresse haben:
https://registry.npmjs.org
Die offizielle Einsteiger-Dokumentation besagt, dass die SDK-Pakete öffentlich verfügbar sind, sodass kein separater Registry-Account oder Authentifizierungstoken zum Herunterladen erforderlich ist.
Erstellung Ihrer ersten RSG 2.0-Anwendung
Roku stellt ein Kommandozeilen-Tool namens rk zur Verfügung, mit dem RSG 2.0-Anwendungen erstellt, gebaut, getestet und ausgeführt werden können.
Das Tool wird über das @roku-sdk/tooling-Paket verteilt.
Folgen Sie diesen Schritten, um Ihre erste Anwendung zu erstellen.
Schritt 1: Neues Projekt erstellen
Öffnen Sie das Terminal und führen Sie aus:
npx --package @roku-sdk/tooling rk create my-first-app
Hierbei gilt:
- npx führt das benötigte Paket aus, ohne dass eine separate globale Installation erforderlich ist.
- @roku-sdk/tooling stellt Rokus Kommandozeilen-Entwicklertools bereit.
- rk create generiert eine neue Anwendung.
- my-first-app ist der Projektname.
Der Befehl erzeugt die Anwendungsstruktur und installiert die notwendigen SDK-Abhängigkeiten.
Schritt 2: Zum Projektverzeichnis wechseln
Nachdem das Projekt erstellt wurde, wechseln Sie in das Verzeichnis:
cd my-first-app
Schritt 3: Anwendung ausführen
Führen Sie den folgenden Befehl aus:
npx rk dev
Dieser Entwicklungsbefehl führt den erforderlichen Entwicklungsbuild, die Typüberprüfung, das Sideloading und den Start der Anwendung auf dem konfigurierten Roku-Gerät durch.
Entwickler können optional den CLI-Launcher installieren, um rk direkt auszuführen, ohne jedes Mal den npx-Präfix zu verwenden.
Weitere Informationen finden Sie im offiziellen RSG 2.0 Einstiegshandbuch.
Verstehen der generierten Projektstruktur
Nach der Erstellung der Anwendung generiert Roku eine vordefinierte Projektstruktur, die die wesentlichen Konfigurations- und Quelldateien enthält.
Im Folgenden sind einige wichtige Dateien und Verzeichnisse aufgeführt:
Datei / Verzeichnis | Zweck |
package.json | Enthält Projektabhängigkeiten und Skripte für Build, Tests, Linting und Typüberprüfung. |
pnpm-workspace.yaml | Definiert die pnpm-Workspace-Konfiguration und erforderliche Installationsskript-Einstellungen. |
roku-config.ts | Enthält die Build-Konfiguration der Anwendung, den Einstiegspunkt und Manifest-Einstellungen. |
src/index.ts | Anwendungseinstiegspunkt, der für die Registrierung der TypeScript-Ankernodes verantwortlich ist. |
src/components/ | Enthält TypeScript-Komponenten der Anwendung. |
src/compiled-components/ | Enthält generierte SceneGraph-Komponentendateien. |
pkg/ | Enthält Roku-Anwendungsressourcen und Verpackungsdateien. |
Das Verständnis dieser Dateien hilft Entwicklern, zu erkennen, wo Anwendungs-, Komponentenimplementierung und build-bezogene Ressourcen gepflegt werden.
Beispielsweise ist src/index.ts ein wichtiger Ausgangspunkt, da es die TypeScript-Anwendung initialisiert und die Komponenten registriert, die in SceneGraph eingebunden werden müssen.
Ebenso bietet roku-config.ts eine zentrale Stelle zur Verwaltung der Anwendungs- und Build-Konfiguration.
Die genaue Projektstruktur kann je nach SDK-Version und Projektanforderungen variieren.
Verbinden eines Roku-Geräts mit der Entwicklungsumgebung
Nachdem die Anwendung erstellt wurde, müssen Entwickler das Roku-Gerät so konfigurieren, dass das rk-Tool Anwendungen darauf installieren und starten kann.
Fügen Sie zunächst das Roku-Gerät mit seiner IP-Adresse hinzu:
rk device add 192.168.1.42 --name living-room
Ersetzen Sie die Beispiel-IP-Adresse durch die tatsächliche IP-Adresse Ihres Roku-Geräts.
Konfigurieren Sie anschließend das Entwicklerpasswort:
rk device update living-room --password
Setzen Sie das Gerät als aktives Entwicklungsziel:
rk device set-active living-room
Überprüfen Sie abschließend die Geräte-Konfiguration:
rk device ls
Sobald das Gerät als aktiv angezeigt wird, ist die Entwicklungsumgebung bereit, die Anwendung bereitzustellen.
Ausführen und Überprüfen Ihrer ersten Anwendung
Mit konfiguriertem Projekt und Roku-Gerät führen Sie aus:
rk dev
Der Befehl führt folgende Schritte aus:
- Überprüft die TypeScript-Typen.
- Erstellt die Anwendung.
- Installiert die Anwendung auf dem aktiven Roku-Gerät.
- Startet die Anwendung.
Wenn alles korrekt konfiguriert ist, sollte die Anwendung auf dem Fernseher starten und einen zentrierten Titel und Untertitel anzeigen.
Falls die Anwendung nicht erfolgreich startet, können Entwickler folgende Option verwenden:
rk dev --console
Dieser Befehl bietet Zugriff auf die Konsolenausgabe des Geräts und hilft Entwicklern, Startfehler und andere Probleme zu erkennen.
Der rk dev-Befehl unterstützt zudem nützliche Optionen wie:
- --device: Wählt ein bestimmtes Roku-Gerät aus.
- --watch: Baut und bereitstellt die Anwendung automatisch neu, wenn sich Dateien ändern.
- --console: Überträgt die Konsolenausgabe des Geräts.
- --debug: Führt die Anwendung im Debug-Modus aus, um Debugger anzubinden.
Diese Optionen machen den Entwicklungsworkflow beim Erstellen und Validieren von Anwendungen komfortabler.
Wichtige Überlegungen vor Beginn der Entwicklung
Bevor Entwickler RSG 2.0 für ein Projekt einsetzen, sollten sie über die aktuelle Verfügbarkeit und Einschränkungen informiert sein.
Beta-Verfügbarkeit: Stand November 2026 befindet sich RSG 2.0 in einer öffentlichen Beta. Die Dokumentation von Roku weist darauf hin, dass sich APIs und Dokumentation während dieser Zeit ändern können.
Anwendungs-Publikation: Anwendungen, die mit RSG 2.0 entwickelt wurden, können während der Beta-Phase derzeit nicht im Roku Streaming Store veröffentlicht werden. Anwendungen können über Sideloading installiert und getestet werden.
Gerätekompatibilität: Die dokumentierten Entwicklungsvoraussetzungen geben Roku OS 16.0 oder höher an. Entwickler sollten die aktuellsten offiziellen Anforderungen vor Beginn der Implementierung prüfen.
Schrittweise Einführung: Bestehende BrightScript- und XML-Anwendungen müssen nicht unmittelbar neu geschrieben werden. TypeScript-Komponenten können schrittweise neben bestehenden Komponenten eingeführt werden.
Für die Projektplanung ist es wichtig, zwischen der Evaluierung des SDK, der Entwicklung einer Anwendung und der Einführung für die Produktionsverteilung zu unterscheiden.
Fazit
Der Einstieg in das Roku RSG 2.0 SDK erfordert das Verständnis seines Entwicklungsmodells, die Vorbereitung der benötigten Umgebung, die Installation der SDK-Tools, das Erstellen eines Projekts und das Verbinden eines Roku-Geräts.
Die Einführung von TypeScript und TSX bietet Roku-Entwicklern einen weiteren Ansatz zum Erstellen von SceneGraph-Anwendungen, während die Kompatibilität mit traditioneller BrightScript- und XML-Entwicklung erhalten bleibt.
Das Befehlszeilenwerkzeug rk vereinfacht zudem wichtige Entwicklungsaktivitäten wie Projekterstellung, Typprüfung, Build-Prozesse, Sideloading und Ausführung der Anwendung.
Für Entwickler, die neu bei RSG 2.0 sind, wird empfohlen, zunächst eine kleine Anwendung zu erstellen, die erzeugte Projektstruktur zu verstehen und diese erfolgreich auf einem Roku-Gerät auszuführen, bevor komplexere Anwendungsentwicklungen angegangen werden.
Nach der ersten Einrichtung können Entwickler die Kernkonzepte des SDK, UI-Entwicklungsmöglichkeiten, Testtools und erweiterte Funktionen im Detail erkunden.
Offizielle Roku-Dokumentation und Referenzen
Die folgenden offiziellen Ressourcen wurden bei der Erstellung dieses Artikels verwendet:
- RSG 2.0 SDK Übersicht
- Einstieg in das RSG 2.0 SDK
- Aktivierung des Entwicklermodus
- Einstieg – RSG 2.0 Dokumentationsabschnitt
Redaktioneller Hinweis: RSG 2.0 befindet sich während seiner Beta-Phase in Entwicklung. Entwickler sollten stets die aktuellste offizielle Roku-Dokumentation zu SDK-Anforderungen, Paketversionen, Befehlen und Veröffentlichungsbeschränkungen konsultieren.
