Runbook • Roku Channel Store • SceneGraph

Einen Roku-Kanal im Roku Channel Store veröffentlichen

Um einen Roku-Kanal zu veröffentlichen, braucht man ein Roku-Gerät. Der Build im Panel ist ein sideloadbares Kanal-Zip, der Channel Store akzeptiert nur ein signiertes .pkg, und der Signaturschlüssel kann nur auf einem Roku-Gerät im Entwicklermodus erzeugt und verwendet werden. Die letzten beiden Schritte laufen daher auf dem eigenen Gerät: installieren, testen, paketieren und dann das .pkg im Entwickler-Dashboard hochladen.

Bedienfeld öffnen
Entwicklerkonto: kostenlos Auf deinem Roku signiert Live, Videos und Radio

Vorgehen

Roku benennt Dashboard-Seiten gelegentlich um; jeder Schritt beschreibt, was die Seite tut, und das übersteht eine Umbenennung. Die Tastenfolge und die Geräteseiten sind seit Jahren unverändert.

1

Als Roku-Entwickler registrieren

  1. Melde dich unter developer.roku.com mit dem Roku-Konto an, dem der Kanal gehören soll, und schließe die Entwicklerregistrierung ab. Für einen kostenlosen Kanal fällt keine Gebühr an.
  2. Akzeptiere die Entwicklervereinbarungen, wenn das Dashboard danach fragt. Der im Store angezeigte Herausgebername stammt aus diesem Profil.
2

Roku in den Entwicklermodus versetzen

  1. Drücke auf der Roku-Fernbedienung dreimal Home, zweimal Hoch und dann Rechts, Links, Rechts, Links, Rechts.
  2. Notiere die IP-Adresse auf dem Bildschirm „Developer Settings“, aktiviere den Installer, akzeptiere die Vereinbarung und lege ein Webserver-Passwort fest. Das Gerät startet neu.

Der Entwicklermodus hält jeweils einen sideloadbaren Kanal; die Installation eines anderen ersetzt ihn.

3

Zip sideloaden und testen

  1. Baue Roku unter Build your apps und lade den Roku channel (.zip) herunter. Entpacke ihn nicht.
  2. Rufe http://<roku-ip> von einem Computer im selben Netzwerk auf und melde dich als rokudev mit dem Passwort aus Schritt 2 an.
  3. Lade das Zip hoch und drücke Install. Der Kanal öffnet sich sofort auf dem Fernseher.
  4. Teste ihn: Live schauen, ein Video aus der Mediathek, Fortsetzen und die Merkliste, Suche, Über; bei einem Radiosender Live hören und Pause. Drücke vom ersten Bildschirm aus Zurück, um zu bestätigen, dass er sich beendet.
  5. Erstelle die Store-Screenshots über dieselbe Webseite (Utilities, Screenshot).
4

Signaturschlüssel erzeugen (einmalig)

  1. Öffne eine Telnet-Sitzung zu Port 8080 des Roku (telnet <roku-ip> 8080) und führe genkey aus.
  2. Bewahre das ausgegebene Passwort und die DevID sicher auf. Jedes Update des Kanals muss mit diesem Schlüssel signiert werden.

Auf einem anderen Roku oder nach einem Werksreset stelle den Schlüssel mit Rekey auf der Utilities-Seite des Geräts wieder her, unter Verwendung eines bereits damit signierten .pkg und seines Passworts. Ein verlorener Schlüssel bedeutet einen neuen Kanal.

5

Kanal paketieren

  1. Öffne bei installiertem Kanal den Packager auf der Webseite des Geräts.
  2. Gib einen App-Namen und eine Version ein (die Version entspricht dem Build: 1.0.7 für Build 7) sowie das genkey-Passwort und klicke auf Package.
  3. Lade das resultierende .pkg herunter.
6

Kanal anlegen und einreichen

  1. Lege im Entwickler-Dashboard einen neuen öffentlichen Kanal an, der mit dem SDK erstellt wurde und wie in der App benannt ist.
  2. Store-Eintrag: roku/poster-540x405.png als Kanalposter, die Beschreibung, Kategorie, die Screenshots aus Schritt 3 und die generierte URL der Datenschutzerklärung.
  3. Lade das .pkg hoch. Das Dashboard führt darauf Rokis statische Analyse aus; lies jeden Befund.
  4. Reiche zur Zertifizierung ein. Beantworte etwaige Zertifizierungshinweise im Dashboard; sobald genehmigt, veröffentliche.

Updates: Baue Roku im Panel neu, sideloade das neue Zip, paketiere es mit demselben Schlüssel und lade das .pkg als neue Version hoch. Videos, Streams und Links kommen aus dem Live-Feed und benötigen nie ein Update.

Häufige Fragen zum Veröffentlichen eines Roku-Kanals

Was der Store akzeptiert, was auf dem Gerät passieren muss und was Direct Publisher abgelöst hat.

Brauche ich ein eigenes Roku-Gerät, um einen Kanal zu veröffentlichen?

Ja. Der Signaturschlüssel stammt von genkey, das auf dem Roku selbst über Telnet läuft, und der Packager signiert nur einen Kanal, der bereits auf diesem Gerät installiert ist. Jeder aktuelle Roku-Player oder Roku-TV im selben Netzwerk wie dein Computer genügt. Jedes spätere Update wird mit demselben Schlüssel signiert; der Hinweis in Schritt 4 behandelt das Übertragen dieses Schlüssels auf ein anderes Roku.

Was hat Roku Direct Publisher abgelöst?

Ein SDK-Kanal. Roku hat Direct Publisher im Juli 2023 für neue Kanäle geschlossen und das Tool im Januar 2024 abgeschaltet, sodass ein Content-Feed allein keinen Kanal mehr ergibt. Der Build im Panel ist ein SceneGraph-Kanal, der gegen das Roku SDK geschrieben wurde – genau der Kanaltyp, den das Entwickler-Dashboard in Schritt 6 verlangt.

Was ist der Unterschied zwischen dem Kanal-.zip und dem .pkg?

Das .zip ist der unsignierte Kanal. Es wird zum Testen und für Screenshots auf ein Roku im Entwicklermodus sideloadet, und die nächste Installation ersetzt es. Das .pkg ist derselbe Kanal, auf dem Gerät paketiert und mit deinem Schlüssel signiert. Der Channel Store akzeptiert nur das .pkg, und das Dashboard führt seine statische Analyse auf dieser Datei aus.

Was zeigt der Roku-Kanal?

Live schauen, die Videomediathek mit Fortsetzen und einer Merkliste, Suche und einen Über-Bildschirm; ein Radiosender erhält stattdessen Live hören und Pause. Streams, Videos, Logo und Links werden aus dem Live-Feed gelesen und ändern sich daher ohne neue Einreichung – Name und Symbol sind im Build festgelegt. Das Panel erstellt denselben Sender für andere Bildschirme: die Smart-TV-App für Samsung und LG und die Radiosender-Apps für iPhone und Android.

Brauchst du Hilfe? Chatte mit uns

Ein Befund der statischen Analyse, zu dem du eine zweite Meinung möchtest, oder ein Roku, das das Zip nicht annimmt: Der Support ist rund um die Uhr im Chat erreichbar.

Alle Runbooks