Veröffentlichen im Apple TV App Store

Artikel
07/13/2023

Um Anwendungen an alle Apple TV-Geräte zu verteilen, erfordert Apple, dass Apps über die Apple TV-App Store veröffentlicht werden, sodass die App Store der One-Stop-Shopping-Standort für tvOS-Apps ist. Entwickler vieler Arten von Apps können den massiven Erfolg dieses einzelnen Verteilungspunkts nutzen. Das Apple TV App Store ist eine schlüsselfertige Lösung, die App-Entwicklern sowohl Distributions- als auch Zahlungssysteme bietet.

Der Prozess der Einreichung eines Antrags an die Apple TV-App Store umfasst Folgendes:

Erstellen einer App-ID und Auswählen von Berechtigungen
Erstellen eines Verteilungsbereitstellungsprofils
Verwenden Sie dieses Profil, um Ihre App zu erstellen.
Übermitteln Ihrer App über iTunes Connect.

In diesem Artikel behandeln wir alle Erforderlichen Schritte zum Bereitstellen, Erstellen und Übermitteln einer App für Apple TV App Store Verteilung.

Vor dem Übermitteln der Anwendung

Nachdem Sie eine App zur Veröffentlichung an die Apple TV-App Store übermittelt haben, durchlaufen sie einen Überprüfungsprozess von Apple, um sicher zu stellen, dass sie die Apple-Richtlinien für Qualität und Inhalt erfüllt. Erfüllt Ihre Anwendung diese Richtlinien nicht, wird sie von Apple abgelehnt. In diesem Fall müssen Sie die von Apple angeführten Nichtübereinstimmungen beheben und die Anwendung erneut übermitteln. Daher sollten Sie sich mit diesen Richtlinien vertraut machen und Ihre Anwendung bestmöglich anpassen, um Ihre Chancen bei der Überprüfung durch Apple zu erhöhen. Die Apple-Richtlinien finden Sie unter App Store Richtlinien überprüfen und Ihre App-Übermittlung für das neue Apple TV vorbereiten.

Beachten Sie bei der Übermittlung einer App Folgendes:

Stellen Sie sicher, dass die Beschreibung der App mit der in der App enthaltenen Funktionalität übereinstimmt.
Stellen Sie sicher, dass die App bei normaler Nutzung nicht abstürzt. Dies schließt die Verwendung auf jedem apple TV-Gerät ein, das Sie unterstützen.

Apple verwaltet auch eine Liste mit Apple TV App Store Übermittlungstipps. Diese Tipps finden Sie unter Distributing on the App Store (Verteilen im App Store).

Konfigurieren der Anwendung in iTunes Connect

iTunes Connect ist eine Suite von webbasierten Tools zum Verwalten Ihrer tvOS-Apps auf dem Apple TV-App Store. Ihre Xamarin.tvOS-App muss ordnungsgemäß in iTunes Connect eingerichtet und konfiguriert werden, bevor sie zur Überprüfung an Apple übermittelt werden kann und letztendlich zum Verkauf oder als kostenlose App im Apple TV-App Store veröffentlicht werden kann.

Gehen Sie folgendermaßen vor:

Gehen Sie in iTunes Connect zum Abschnitt Vereinbarungen, Steuern und Bankgeschäfte. Stellen Sie sicher, dass die Vereinbarungen richtig eingerichtet und auf dem neuesten Stand sind, um eine iOS-Anwendung kostenlos oder zum Verkauf freizugeben.
Erstellen Sie einen neuen iTunes Connect Record für die Anwendung, und geben Sie den Anzeigenamen an (siehe Apple TV-App Store).
Wählen Sie einen Verkaufspreis aus, oder geben Sie an, dass die Anwendung kostenlos veröffentlicht wird.
Stellen Sie auf den unterstützten Apple TV-Geräten ein App Store-Symbol (großes Symbol) und Screenshots Ihrer Anwendung in Aktion bereit. Weitere Informationen finden Sie in unserem Leitfaden zum Arbeiten mit Symbolen und Bildern .
Stellen Sie dem Endbenutzer eine klare, prägnante Beschreibung der App einschließlich ihrer Features und vorteile bereit.
Geben Sie Kategorien, Unterkategorien und Schlüsselwörter an, damit der Benutzer Ihre App im Apple TV-App Store finden kann.
Geben Sie Kontakt- und Support-URLs für Ihre Website an, die von Apple benötigt werden.
Legen Sie die Bewertung Ihrer Anwendung fest, die von der Kindersicherung auf der Apple TV-App Store verwendet wird.
Konfigurieren Sie optionale App Store Technologien wie Game Center und In-App-Kauf.

Weitere Informationen finden Sie in der Dokumentation Konfigurieren Ihrer tvOS-App in iTunes Connect .

Vorbereiten für die Verteilung im App Store

Um eine App im Apple TV-App Store zu veröffentlichen, müssen Sie sie zunächst für die Verteilung erstellen, was viele Schritte umfasst. Die folgenden Abschnitte behandeln alles, was erforderlich ist, um eine Xamarin.tvOS-App für die Veröffentlichung vorzubereiten, damit sie erstellt und an die Apple TV-App Store zur Überprüfung und Veröffentlichung übermittelt werden kann.

Bereitstellung für Anwendungsdienste

Apple bietet eine Auswahl von speziellen Application Services, auch Berechtigungen genannt, die für Ihre tvOS-App aktiviert werden können, wenn Sie eine eindeutige ID dafür erstellen. Unabhängig davon, ob Sie benutzerdefinierte Berechtigungen verwenden oder nicht, müssen Sie dennoch eine eindeutige ID für Ihre Xamarin.tvOS-App erstellen, bevor sie auf dem Apple TV-App Store veröffentlicht werden kann.

Führen Sie die folgenden Schritte mithilfe des webbasierten iOS-Bereitstellungsportals von Apple aus, um eine App-ID zu erstellen und optional Berechtigungen auszuwählen:

Wählen Sie Bereitstellungsentwicklung>aus.
Klicken Sie auf die +-Schaltfläche, und stellen Sie einen Namen und eine Bündel-ID für die neue Anwendung bereit.
Scrollen Sie zum unteren Bildschirmrand, und wählen Sie alle App Services aus, die für Ihre Xamarin.tvOS-App erforderlich sind.
Klicken Sie auf die Schaltfläche Weiter, und folgen Sie den Anweisungen auf dem Bildschirm, um die neue App-ID zu erstellen.

Zusätzlich zum Auswählen und Konfigurieren der erforderlichen Application Services beim Definieren Ihrer App-ID müssen Sie auch die App-ID und die Berechtigungen in Ihrem Xamarin.tvOS-Projekt konfigurieren, indem Sie sowohl die Dateien als auch bearbeiten Info.plistEntitlements.plist .

Gehen Sie in Visual Studio für Mac wie folgt vor:

Doppelklicken Sie im Projektmappen-Explorer auf die Datei Info.plist, um sie zur Bearbeitung zu öffnen.
Geben Sie im Abschnitt tvOS-Anwendungsziel einen Namen für Ihre Anwendung ein, und geben Sie den Bundle-Bezeichner ein, den Sie beim Definieren der App-ID erstellt haben.
Speichern Sie die Änderungen an der Datei Info.plist.
Doppelklicken Sie im Projektmappen-Explorer auf die Datei Entitlements.plist, um sie zur Bearbeitung zu öffnen.
Wählen Sie die für Ihre Xamarin.tvOS-App erforderlichen Berechtigungen aus, und konfigurieren Sie sie so, dass sie mit dem Setup übereinstimmen, das Sie beim Definieren der App-ID oben ausgeführt haben.
Speichern Sie die Änderungen an der Datei Entitlements.plist.

Eine ausführliche Anleitung finden Sie in der Dokumentation unter Provisioning for Application Services (Bereitstellung für Anwendungsdienste). Während dieses Dokuments für iOS geschrieben wurde, werden die gleichen Schritte zum Bereitstellen einer Xamarin.tvOS-App verwendet.

Festlegen der App-Symbole, Des Bilds "Starten" und des Bilds "Oberstes Regal"

Damit eine tvOS-App von Apple zur Aufnahme in die Apple TV-App Store akzeptiert wird, erfordert sie für alle Apple TV-Geräte, auf denen sie ausgeführt wird, richtige Symbole, Start- und Top Shelf-Bilder. Sie müssen die erforderlichen Bildobjekte hinzufügen, die in eine Assets.car Datei kompiliert und im Paket Ihrer Xamarin.tvOS-App enthalten sind, bevor sie in iTunes Connect hochgeladen werden.

Ausführliche Anweisungen finden Sie in der Dokumentation Arbeiten mit Symbolen und Bildern .

Erstellen und Installieren eines Verteilungsprofils

tvOS verwendet Bereitstellungsprofile , um zu steuern, wie ein bestimmter Anwendungsbuild bereitgestellt werden kann. Hierbei handelt es sich um Dateien mit Informationen zu dem Zertifikat, das zum Signieren einer App verwendet wurde, der Anwendungs-ID sowie dem Ort, an dem die App installiert werden kann. Für die Entwicklung und Ad-hoc-Verteilung enthält das Bereitstellungsprofil auch eine Liste der zulässigen Geräte, auf denen die App bereitgestellt werden kann. Für die Verteilung von Apple TV App Store sind jedoch nur Zertifikat- und App-ID-Informationen enthalten, da der einzige Mechanismus für die öffentliche Verteilung über die Apple TV-App Store ist.

Führen Sie für die Bereitstellung die folgenden Schritte mithilfe des webbasierten iOS-Bereitstellungsportals von Apple aus:

Wählen Sie Bereitstellungsverteilung>aus.
Klicken Sie auf die + Schaltfläche, und wählen Sie den Typ des Verteilungsprofils aus, das Sie als Apple TV-App Store erstellen möchten.
Wählen Sie aus der Dropdownliste die App-ID aus, für die Sie ein Verteilungsprofil erstellen möchten.
Wählen Sie zum Signieren der Anwendung erforderliches Zertifikat aus.
Geben Sie einen Namen für das neue Verteilungsprofil ein, und generieren Sie das Profil.
Aktualisieren Sie die Liste der verfügbaren Profile in Xcode.
Wählen Sie das Verteilungsbereitstellungsprofil in Visual Studio für die App StoreBuildkonfiguration aus.

Eine ausführliche Anleitung finden Sie unter Creating a Distribution Profile (Erstellen eines Verteilungsprofils) und Selecting a Distribution Profile in a Xamarin.iOS Project (Auswählen eines Verteilungsprofils in einem Xamarin.iOS-Projekt). Auch hier sind beide Dokumente iOS-spezifisch, aber die gleiche Technik wird für tvOS-Apps verwendet.

Festlegen der Buildkonfiguration für die Anwendung

Wenn Sie eine neue Xamarin.tvOS-App erstellen, werden Buildkonfigurationen standardmäßig automatisch sowohl für die Debug - als auch für die Releasebereitstellung erstellt. Bevor Sie den endgültigen Build Ihrer App durchführen, den Sie an Apple übermitteln, müssen Sie einige Änderungen an der Basisversionskonfiguration vornehmen.

Gehen Sie folgendermaßen vor:

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und wählen Sie Optionen aus, um sie zur Bearbeitung zu öffnen.
Wenn Sie auf eine bestimmte Version von tvOS abzielen, wählen Sie sie unter tvOS Build>iOS SDK Version aus. Lassen Sie für die Vorschauversion des tvOS-Supports diesen Wert auf Standard festgelegt.
Das Verknüpfen reduziert die Gesamtgröße der Verteilung Ihrer App, indem nicht verwendete Methoden, Eigenschaften, Klassen usw. entfernt werden. und sollte in den meisten Fällen nur dem Standardwert des Link Framework SDK überlassen werden. In einigen Situationen, z. B. bei Verwendung bestimmter Drittanbieterbibliotheken, sind Sie möglicherweise gezwungen, diesen Wert auf Nicht verknüpfen festzulegen, damit das erforderliche Element nicht entfernt wird.
Zum Versand einer Xamarin.tvOS-App müssen Sie den LLVM-Optimierungscompiler verwenden. Stellen Sie sicher, dass das Kontrollkästchen Verwenden des LLVM-Optimierungscompilers unter der Releasekonfiguration aktiviert ist.
Apple verlangte auch, dass tvOS-Apps Bitcode verwenden. Fügen Sie erneut unter der Releasekonfiguration dem Feld Zusätzliche mtouch-Argumente hinzu--bitcode=asmonly.
Das Kontrollkästchen PNG-Bilddateien für iOS optimieren sollte aktiviert sein, da dies dazu bei hilft, die Liefergröße Ihrer App weiter zu verringern.
Das Debuggen sollte nicht aktiviert werden, da der Build dadurch unnötig größer wird.

Erstellen und Übermitteln der verteilbaren Anwendung

Nachdem Ihre Xamarin.tvOS-App ordnungsgemäß konfiguriert ist, können Sie nun den endgültigen Distributionsbuild ausführen, den Sie zur Überprüfung und Veröffentlichung an Apple übermitteln.

Erstellen des Archivs

Wählen Sie in Visual Studio für Mac die Konfiguration Release | Gerät aus:
Wählen Sie aus dem Build-Menü die Option Zur Veröffentlichung aktivieren:
Sobald das Archiv erstellt wurde, wird die Archivansicht angezeigt:

Signieren und Verteilen Ihrer App

Beim Erstellen Ihrer Anwendung für das Archiv wird automatisch die Archivansicht geöffnet. Darin werden alle archivierten Projekte nach Projektmappe gruppiert angezeigt. Standardmäßig wird in dieser Ansicht nur die aktuelle geöffnete Projektmappe angezeigt. Klicken Sie auf Alle Archive anzeigen, um alle Projektmappen mit Archiven anzuzeigen.

Es wird empfohlen, Archive beizubehalten, die bei den Kunden bereitgestellt wurden (App Store- oder Unternehmensbereitstellungen). Dadurch können alle generierten Debuginformationen zu einem späteren Zeitpunkt symbolisiert werden.

Gehen Sie folgendermaßen vor, um Ihre App für die Verteilung zu signieren und vorzubereiten:

Wählen Sie sign and Distribute... (Sign and Distribute...) aus, die unten dargestellt ist:
Dadurch wird der Veröffentlichungs-Assistent geöffnet. Wählen Sie den App Store Verteilungskanal aus, um ein Paket zu erstellen, und öffnen Sie Application Loader:
Wählen Sie auf dem Bildschirm Bereitstellungsprofil Ihre Signaturidentität und das entsprechende Bereitstellungsprofil aus, oder melden Sie sich erneut mit einer anderen Identität an:
Überprüfen Sie die Details Ihres Pakets, und klicken Sie zum Speichern des .ipa-Pakets auf Veröffentlichen:
Sobald die .ipa gespeichert wurde, kann Ihre App über den Application Loader in iTunes Connect hochgeladen werden:

Nachdem Ihr Verteilungsbuild erstellt und archiviert wurde, können Sie nun Ihre Anwendung an iTunes Connect übermitteln.

Übermitteln der App an Apple

Nach Abschluss des Verteilungsbuilds können Sie Ihre iOS-Anwendung nun zur Überprüfung und Freigabe im App Store an Apple übermitteln.

Der Archivworkflow in Visual Studio für Mac öffnet den Application Loader automatisch, nachdem Sie folgendes .ipagespeichert haben:

Wählen Sie Ihre App übermitteln aus, und klicken Sie auf die Schaltfläche Auswählen:
Wählen Sie die zuvor erstellte ZIP- oder IPA-Datei aus, und klicken Sie auf die Schaltfläche OK.
Die Datei wird durch den Application Loader überprüft:
Klicken Sie auf die Schaltfläche Weiter. Die Anwendung wird nun für den App Store überprüft:
Klicken Sie auf die Schaltfläche Senden, um die Anwendung zur Überprüfung an Apple zu senden.
Sie werden vom Application Loader informiert, sobald die Datei erfolgreich hochgeladen wurde.

Status in iTunes Connect

Wenn Sie sich wieder bei iTunes Connect anmelden und Ihre App aus der Liste der verfügbaren Apps auswählen, sollte die status in iTunes Connect nun anzeigen, dass es sich um Warten auf Überprüfung handelt (möglicherweise wird während der Verarbeitung vorübergehend "Empfangen hochladen" angezeigt):

Problembehandlung

Wenn Sie Probleme beim Übermitteln Ihrer Xamarin.tvOS-App an die Apple TV-App Store haben, lesen Sie unseren Leitfaden zur Problembehandlung. Es enthält mehrere bekannte Probleme, die möglicherweise auftreten, und wie sie in Xamarin.tvOS gelöst werden können.

Zusammenfassung

Dieser Artikel enthält eine schrittweise Anleitung zum Konfigurieren, Erstellen und Übermitteln einer App für Apple TV App Store Veröffentlichung. Zuerst wird die Vorgehensweise zum Erstellen und Installieren eines Verteilungsbereitstellungsprofils erklärt. Als Nächstes wurde beschrieben, wie Sie Visual Studio für Mac verwenden, um einen Verteilungsbuild zu erstellen. Schließlich wurde gezeigt, wie Sie iTunes Connect und das Xcode-Archivtool verwenden, um eine Anwendung an die Apple TV-App Store zu übermitteln.