pbojinov / TVMLCatalogUsingTVMLTemplates

Feb 5, 2022
admin

Anforderungen

Build-Anforderungen: Xcode 7.1, tvOS 9.0 SDKRuntime-Anforderungen: tvOS 9.0 oder höher

Einführung

Dieses Beispiel zeigt, wie das TVMLKit-Framework zum Anzeigen von TVML-Inhalten in einer tvOS-Anwendung verwendet wird, und enthält einen Katalog der primären TVML-Vorlagen. Eine vollständige Liste der Vorlagen und verfügbaren Elemente finden Sie in der Apple TV Markup Language Reference.

Struktur

Das Projekt ist in zwei Teile gegliedert:

  • TVMLCatalog: Dieses Verzeichnis enthält das Xcode-Projekt und die zugehörigen Dateien. Das AppDelegate.die Swift-Datei übernimmt die Einrichtung des TVMLKit-Frameworks und das Starten des JavaScript-Kontexts zur Verwaltung der App.
  • Client: Dieses Verzeichnis enthält die JavaScript- und XML-Dateien, die zum Rendern der Anwendung benötigt werden. Der Inhalt dieses Verzeichnisses muss auf einem Server gehostet werden, auf den vom Gerät aus zugegriffen werden kann.

Nachdem die Anwendung eingerichtet wurde und ausgeführt wird, arbeiten Sie hauptsächlich im Client-Verzeichnis. Hier definieren Sie die Vorlagen, die Sie dem Benutzer präsentieren möchten, und steuern die Präsentation und den Lebenszyklus der Anwendung mit JavaScript. Experimentieren Sie beim Definieren neuer Vorlagen mit den verfügbaren Stilen, um ein Gefühl für die Flexibilität von TVMLKit und deren Anpassbarkeit zu erhalten.

Um das Debuggen und Experimentieren zu erleichtern, können Sie den Safari WebInspector verwenden, um ihn an den JavaScript-Kontext anzuhängen. WebInspector bietet Ihnen eine vollständige JavaScript-Debugging-Umgebung. Sie müssen das Menü Entwickeln in Safari > Einstellungen > Erweitert aktivieren. Wählen Sie Ihr Gerät aus dem Dropdown-Menü Entwickeln aus, um eine Liste der ausgeführten JavaScript-Kontexte anzuzeigen.

Wenn Sie Ihrer Anwendung erweiterte Funktionen hinzufügen möchten, öffnen Sie die Clientdateien und lesen Sie die Apple TV Markup Language-Referenz durch. Sie können neue JavaScript-APIs hinzufügen, neue XML-Vorlagen oder -Elemente erstellen und beim Start zusätzliche Informationen an den JavaScript-Kontext übergeben. Sie können die Funktionen Ihrer Anwendung auch erweitern, indem Sie eine topshelfextension zum Anzeigen von Elementen im obersten Regal erstellen, wenn Ihre Anwendung in die erste Zeile des Apple TV-Hauptmenüs verschoben wird.

Installationsanweisungen:

Um einen lokalen Server zu starten, führen Sie den folgenden Befehl in einem Terminal im Ordner ‚client‘ aus, um einen einfachen Webserver zu erstellen.

python -m SimpleHTTPServer 9001
  • Öffnen Sie den TVMLCatalog.xcodeproj-Projekt in Xcode
  • Wenn der Clientcode auf einem Remoteserver gehostet wird oder Sie diese App auf dem Apple TV ausführen, ändern Sie die folgende Eigenschaft in AppDelegate.swift:
    • Ändern Sie den TVBaseURL-Wert in die URL, die den Inhalt des Client-Verzeichnisses hostet
    • Beachten Sie, dass die Info.plist deaktiviert derzeit die App-Transportsicherheit über NSAllowsArbitraryLoads. Dies dient nur dazu, den Überprüfungsprozess der Probe zu vereinfachen. Ihre eigenen Apps sollten sich auf ordnungsgemäß gesicherte Server verlassen, für die die App-Transportsicherheit nicht deaktiviert werden muss.
  • Erstellen und Ausführen der Anwendung
  • Wenn Sie diese Anwendung auf einem Gerät ausführen, müssen Sie in den Build-Einstellungen des Projekts ein Signierprofil hinzufügen.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.