Einrichtung für die Entwicklung mit dem Cast Application Framework (CAF) für iOS

Das Cast-Framework unterstützt iOS 15 und höher und ist sowohl als statisches als auch als dynamisches Framework verfügbar.

Beschreibungen aller Klassen und Methoden finden Sie in der Google Cast iOS API-Referenz für.

Xcode-Einrichtung

iOS 14

1. Cast iOS SDK 4.8.4 zu Ihrem Projekt hinzufügen

   Wenn Sie CocoaPods verwenden, fügen Sie das SDK 4.8.4 mit pod update zu Ihrem Projekt hinzu.

   Andernfalls müssen Sie das SDK manuell einbinden.

2. NSBonjourServices zu Info.plist hinzufügen

   Geben Sie NSBonjourServices in Ihrer Info.plist an, damit die Suche im lokalen Netzwerk unter iOS 14 erfolgreich ist.

   Sie müssen sowohl _googlecast._tcp als auch _<your-app-id>._googlecast._tcp als Dienste hinzufügen, damit die Gerätesuche ordnungsgemäß funktioniert.

   Die App-ID ist Ihre Empfänger-ID, die mit der ID identisch ist, die in Ihrem GCKDiscoveryCriteria definiert ist.

   Aktualisieren Sie die folgende NSBonjourServices Definition und ersetzen Sie „ABCD1234“ durch Ihre App-ID.

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. NSLocalNetworkUsageDescription zu hinzufügenInfo.plist

   Wir empfehlen dringend, die Meldung anzupassen, die in der Eingabeaufforderung für das lokale Netzwerk angezeigt wird. Fügen Sie dazu in der Info.plist Datei Ihrer App einen app-spezifischen Berechtigungsstring für die NSLocalNetworkUsageDescription hinzu, um beispielsweise die Cast Suche und andere Suchdienste wie DIAL zu beschreiben.

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   Diese Meldung wird im Dialogfeld für den Zugriff auf das lokale Netzwerk von iOS angezeigt, wie im Mock-up zu sehen.

   
4. App im Apple App Store neu veröffentlichen

   Wir empfehlen, Ihre App so bald wie möglich mit Version 4.8.4 neu zu veröffentlichen.

iOS 13

iOS 12

Achten Sie darauf, dass die Option Zugriff auf WLAN-Informationen im Bereich Funktionen des Ziels auf „Ein“ gesetzt ist.

Außerdem muss Ihr Bereitstellungsprofil die Funktion Zugriff auf WLAN-Informationen unterstützen. Sie können sie im Apple Developer Portal hinzufügen.

CocoaPods-Einrichtung

Die empfohlene Methode zur Einbindung von Google Cast ist die Verwendung von CocoaPods. Verwenden Sie für die Einbindung die google-cast-sdk CocoaPods.

Folgen Sie der Anleitung im Startleitfaden.

Nachdem Sie CocoaPods eingerichtet haben, folgen Sie der Anleitung unter CocoaPods verwenden , um Ihre Podfile zu erstellen und Ihr Projekt für die Verwendung mit dem Google Cast SDK vorzubereiten.

Hier ist ein Beispiel dafür, wie Sie die CocoaPod google-cast-sdk zu Ihrer Podfile-Datei hinzufügen:

use_frameworks!

platform :ios, '15.0'

def target_pods
  pod 'google-cast-sdk'
end

target 'CastVideos-objc' do
  target_pods
end
target 'CastVideos-swift' do
  target_pods
end

Für Ihr Projekt sollten Sie einen Bereich für Ihre Pods angeben, um unerwartete Breaking Changes zu vermeiden. Weitere Informationen finden Sie im Leitfaden zur Podfile-Datei.

In diesem Snippet sind Version 4.8.4 und die Versionen bis zur nächsten Hauptversion (major.minor.patch) zulässig:

pod 'google-cast-sdk', '~> 4.8.4'

Beispiel: „~> 1.6.7“ umfasst alle Versionen ab 1.6.7 bis einschließlich 1.9.9.

Manuelle Einrichtung

Die folgende Anleitung beschreibt, wie Sie das Cast iOS SDK ohne CocoaPods zu Ihrem Projekt hinzufügen:

Downloads

Nachdem Sie die entsprechende Bibliothek unten heruntergeladen haben, folgen Sie der Anleitung zur Einrichtung, um das Framework zu Ihrem Projekt hinzuzufügen.

Cast iOS Sender SDK 4.8.4-Bibliotheken:

Statisch Dynamisch

Einrichtungsschritte

So installieren Sie die Bibliothek:

1. Laden Sie das entsprechende SDK für Ihr Projekt herunter und extrahieren Sie es.
2. Richten Sie die dynamische GoogleCastSDK-Bibliothek ein:
3. Ziehen Sie die entpackte .xcframework im Xcode-Projektnavigator in Ihr Hauptprojekt (nicht in das Pods-Projekt, falls vorhanden). Aktivieren Sie das Kästchen „Copy all items if needed“ (Alle Elemente bei Bedarf kopieren) und fügen Sie sie allen Zielen hinzu.
4. Wählen Sie in Ihrem Xcode-Ziel auf dem General Tab die Option Embed and Sign für GoogleCast.xcframework aus.

Wenn Sie die dynamische Bibliothek einrichten, führen Sie zusätzlich zu den vorherigen Schritten die folgenden Schritte aus:

1. Richten Sie die Protobuf-Bibliothek mit Version 3.13 oder höher ein.
1. Wenn Ihr Projekt CocoaPods verwendet:
1. Öffnen Sie Ihre Podfile und entfernen Sie die google-cast-sdk falls vorhanden:

   pod 'google-cast-sdk'

2. Fügen Sie die Protobuf-Bibliothek hinzu, falls sie nicht vorhanden ist:

   pod 'Protobuf', '3.13'

3. Führen Sie im Stammordner Ihres Projekts pod install aus.
2. Wenn Ihr Projekt CocoaPods nicht verwendet:
1. Entfernen Sie die aktuelle Version von GoogleCastSDK, falls vorhanden.
2. Fügen Sie die Protobuf-Bibliothek Version 3.13 oder höher hinzu. Folgen Sie dazu der Anleitung im Protobuf-GitHub-Repository.

Wenn Sie die statische Bibliothek einrichten, führen Sie zusätzlich zu den vorherigen Schritten die folgenden Schritte aus:

1. Fügen Sie in Ihrem Xcode-Projekt die Flags -ObjC -lc++ unter Build Settings > Other Linker Flags (Build-Einstellungen > Andere Linker-Flags) hinzu.
2. Suchen Sie im entpackten Verzeichnis den Ordner „Resources“ (Ressourcen) und ziehen Sie alle .bundle Dateien neben die GoogleCast.xcframework Datei, die Sie zuvor hinzugefügt haben, in Ihr Projekt. Aktivieren Sie das Kästchen „Copy all items if needed“ (Alle Elemente bei Bedarf kopieren) und fügen Sie sie allen Zielen hinzu.

Mac Catalyst-Einrichtung

Verwenden Sie für Apps, die Mac Catalyst unterstützen, die dynamische Bibliothek des Cast SDK. Folgen Sie der Anleitung zur manuellen Einrichtung, um das Framework zu Ihrem Projekt hinzuzufügen. Schließen Sie das Cast SDK dann bedingt aus dem Mac Ziel aus, wie in der Apple-Dokumentation beschrieben. Statische Bibliotheken sind für die iOS-Architektur vorkompiliert, was beim Erstellen für das Mac-Ziel zu einem Linker-Fehler führt.