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

Das Cast-Framework unterstützt iOS 14 und höher und ist in statischen und dynamischen Frameworks enthalten.

Beschreibungen aller Klassen und Methoden finden Sie in der Referenz zur Google Cast iOS API.

Hinweis:Es sind neue Versionen der XCFrameworks für das Cast iOS SDK verfügbar, die die Entwicklung auf Apple Silicon-Computern unterstützen.

Xcode-Einrichtung

Warnung :Wenn du das Optimization Level-Flag Apple Clang - Code Generation für „Schnellste, aggressive Optimierungen“ auf -Ofast setzt, stürzen Apps, die das Cast iOS SDK verwenden, aufgrund von Inkompatibilitäten mit den Optimierungen ab. Das SDK unterstützt den Standardwert -Os für „Fastest, Smallest“.

iOS 14

iOS 14-Warnung: Änderungen an den Zugriffsberechtigungen für das lokale Netzwerk unter iOS 14 haben sich in vielerlei Hinsicht auf das Google Cast iOS SDK ausgewirkt. Im Dokument Änderungen bei iOS 14 findest du weitere Informationen zu den Auswirkungen auf deine App.

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

   Wenn du CocoaPods verwendest, verwende pod update, um deinem Projekt das 4.8.1 SDK hinzuzufügen.

   Alternativ können Sie das SDK manuell abrufen.

   Hinweis: Wenn du in deiner App eine benutzerdefinierte Geräteauswahl erstellt hast, musst du die Methode startDiscovery für die Klasse GCKDiscoveryManager explizit aufrufen, um die Geräteerkennung zu starten. Das automatische Scannen war ab Version 4.5.0 des Cast SDK standardmäßig deaktiviert.
2. NSBonjourServices zu deinem Info.plist hinzufügen

   Geben Sie NSBonjourServices in Ihrer Info.plist an, damit die Erkennung des lokalen Netzwerks unter iOS 14 erfolgen kann.

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

   Die appID ist Ihre ReceiverID, also dieselbe ID, die in GCKDiscoveryCriteria definiert ist.

   Aktualisieren Sie die folgende NSBonjourServices-Beispieldefinition und ersetzen Sie „ABCD1234“ durch Ihre appID.

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

3. Add NSLocalNetworkUsageDescription to your Info.plist

   We strongly recommend that you customize the message shown in the Local Network prompt by adding an app-specific permission string in your app's Info.plist file for the NSLocalNetworkUsageDescription such as to describe Cast discovery and other discovery services, like DIAL.

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

   This message will appear as part of the iOS Local Network Access dialog as shown in the mock.

   
4. Re-release your app to the Apple App Store

   We recommend you also re-release your app using 4.8.1 as soon as possible.

iOS 13

iOS 13 Warning: Apple permissions changes to iOS 13 and Xcode 11 have impacted the Google Cast iOS SDK in a number of ways. Please see the iOS 13 Changes document to see how your app will be impacted.

iOS 12

iOS 12 Warning: If developing using Xcode 10, the "Access WiFi Information" capability is required in order to discover and connect to Cast devices.

Ensure that the Access WiFi Information switch in the Capabilities section of the target is set to "On".

Additionally, your provisioning profile will need to support the Access WiFi Information capability. This can be added in the Apple Developer Portal.

CocoaPods setup

The recommended way of integrating Google Cast is using CocoaPods. For integration, use the google-cast-sdk CocoaPods.

To get started, follow the getting started guide.

Once CocoaPods is set up, follow the using CocoaPods guide to get your Podfile created and your project ready to use with the Google Cast SDK.

Here's an example of how to add the google-cast-sdk CocoaPod to your Podfile:

use_frameworks!

platform :ios, '14.0'

def target_pods
  pod 'google-cast-sdk'
end

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

In Ihrem Projekt sollten Sie einen Bereich für die Pods angeben, um unerwartete abwärtskompatible Änderungen zu vermeiden, wie im Podfile-Leitfaden beschrieben.

In diesem Snippet sind Version 4.8.1 und die Versionen bis zur nächsthöheren Hauptversion (major.minor.patch) zulässig:

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

Zum Beispiel enthält '~> 1.6.7' alle Versionen von 1.6.7 bis, aber nicht einschließlich, Version 2.0.0.

Manuelle Einrichtung

So fügen Sie Ihrem Projekt das Cast iOS SDK hinzu, ohne CocoaPods zu verwenden:

Wichtiger Hinweis:Ab Version 4.3.1 verwendet CocoaPods statische Bibliotheken, um doppelte Symbolwarnungen aufgrund einer gemeinsamen Protobuf-Bibliotheksabhängigkeit zu vermeiden, wenn das Firebase SDK und das Cast SDK zusammen verwendet werden. Diese Änderung führt zwar zu einem größeren Download, die endgültige Größe der Anwendung wird sich jedoch nicht erhöhen.

Wenn der Größenunterschied für Ihre Situation relevant ist, laden Sie die dynamische Bibliothek herunter, um eine Größe zu erhalten, die der CocoaPods-Bibliothek vor Version 4.3.1 ähnelt.

Downloads

Nachdem Sie unten die entsprechende Bibliothek heruntergeladen haben, führen Sie die Einrichtungsschritte aus, um das Framework Ihrem Projekt hinzuzufügen.

Cast-Bibliotheken des Sender SDK 4.8.1 für iOS:

Statisch Dynamisch

Einrichtungsschritte

So installieren Sie die Bibliothek:

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

Wenn Sie die static-Bibliothek einrichten, führen Sie zusätzlich zu den vorherigen Schritten folgende Schritte aus:

1. Richten Sie die Protobuf-Bibliothek mit der Mindestversion v3.13 ein.
1. Wenn in Ihrem Projekt CocoaPods verwendet werden:
1. Öffnen Sie Podfile und entfernen Sie google-cast-sdk, falls vorhanden:

   pod 'google-cast-sdk'

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

   pod 'Protobuf', '3.13'

3. Führen Sie pod install im Stammverzeichnis Ihres Projekts aus.
2. Wenn in Ihrem Projekt keine CocoaPods verwendet werden:
1. Entfernen Sie die aktuelle Version von GoogleCastSDK, falls vorhanden.
2. Fügen Sie die Protobuf-Bibliothek ab Version 3.13 hinzu. Folgen Sie dazu der Anleitung im GitHub-Repository für Protobuf.
2. Fügen Sie in Ihrem Xcode-Projekt die Flags -ObjC -lc++ unter Build Settings > Other Linker Flags (Build-Einstellungen > Andere Verknüpfungs-Flags) hinzu.
3. Suchen Sie im entpackten Verzeichnis den Ordner „Resources“ und ziehen Sie GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle und MaterialDialogs.bundle in Ihr Projekt neben dem zuvor hinzugefügten GoogleCast.xcframework. Aktivieren Sie „Bei Bedarf alle Elemente kopieren“ und fügen Sie sie allen Zielen hinzu.

Einrichtung von Mac Catalyst

Verwende für Apps, die Mac Catalyst unterstützen, die dynamische Bibliothek des Cast SDK. Folgen Sie dem manuellen Einrichtungsprozess, um das Framework Ihrem Projekt hinzuzufügen. Schließen Sie dann das Cast SDK bedingt aus dem Mac-Ziel aus, wie in der Apple-Dokumentation beschrieben. Statische Bibliotheken werden für die iOS-Architektur vorkompiliert. Dadurch wird beim Erstellen für das Mac-Ziel ein Verknüpfungsfehler ausgelöst.