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 beiden statische und dynamische Frameworks.

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

Hinweis:Neue Versionen der Cast iOS SDK XCFrameworks sind jetzt verfügbar, die die Entwicklung unterstützen. auf Apple Silicon-Computern.

Xcode-Einrichtung

Warnung: Wenn du das Flag Apple Clang - Code Generation Optimization Level auf -Ofast für „Schnellste, aggressive Optimierungen“ 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

Warnung zu iOS 14: Die Änderungen an den Berechtigungen für den lokalen Netzwerkzugriff in iOS 14 haben sich auf verschiedene Weise auf das Google Cast SDK für iOS ausgewirkt. In der Änderungen bei iOS 14 Dokument, um zu erfahren, inwiefern deine App betroffen ist.

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

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

   Andernfalls und laden Sie das SDK manuell herunter.

   Hinweis: Wenn Sie in Ihrer App eine benutzerdefinierte Geräteauswahl erstellt haben, benötigen Sie um explizit die Methode startDiscovery für die GCKDiscoveryManager um die Geräteerkennung zu starten. Das automatische Scannen wurde deaktiviert von ab Version 4.5.0 des Cast SDK.
2. NSBonjourServices zu deinem Info.plist hinzufügen

   Geben Sie NSBonjourServices in Ihrem Info.plist an, um ermöglichen die erfolgreiche Erkennung lokaler Netzwerke unter iOS 14.

   Sie müssen sowohl _googlecast._tcp als auch _<your-app-id>._googlecast._tcp als Dienste für das Gerät damit die Erkennung ordnungsgemäß funktioniert.

   Die appID ist Ihre ReceiverID, also die ID, die in Ihrem GCKDiscoveryCriteria

   Aktualisieren Sie die folgende Beispieldefinition für NSBonjourServices und „ABCD1234“ ersetzen durch Ihre appID.

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

3. NSLocalNetworkUsageDescription hinzufügen zu deinem Info.plist

   Wir empfehlen dringend, dass Sie die Nachricht anpassen, die in der lokalen Netzwerk-Aufforderung durch Hinzufügen eines App-spezifischen Berechtigungsstrings in der Info.plist-Datei für den NSLocalNetworkUsageDescription, z. B. zur Beschreibung von Cast Discovery- und andere Erkennungsdienste wie DIAL.

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

   Diese Meldung wird als Teil des iOS-Dialogfelds für den lokalen Netzwerkzugriff angezeigt als die im Beispiel dargestellt werden.

   
4. App im Apple App Store neu veröffentlichen

   Wir empfehlen dir außerdem, deine App mit Version 4.8.3 so schnell wie möglich.

iOS 13

iOS 13-Warnung: Apple Änderungen der Berechtigungen für iOS 13 und Xcode 11 haben sich auf die SDK in vielerlei Hinsicht nutzen. In der Änderungen bei iOS 13 Dokument, um zu erfahren, wie deine App betroffen sein wird.

iOS 12

iOS 12-Warnung: Bei der Entwicklung mit Xcode 10, der Funktion "Zugriff auf WLAN-Informationen" Funktionalität erforderlich ist, um Übertragungsgeräte zu finden und sich mit ihnen zu verbinden.

Stellen Sie sicher, dass der Schalter Zugriff auf WLAN-Informationen in den Funktionen des Ziels auf „An“ festgelegt ist.

Außerdem muss Ihr Bereitstellungsprofil die Funktion Auf WLAN-Informationen zugreifen unterstützen. Dies kann im Feld Apple-Entwicklerportal

CocoaPods-Einrichtung

Wir empfehlen zur Integration von Google Cast CocoaPods Verwenden Sie für die Integration die google-cast-sdk CocoaPods.

Folgen Sie für den Einstieg den Startleitfaden.

Sobald CocoaPods eingerichtet ist, folgen Sie der Leitfaden zur Verwendung von CocoaPods um Podfile zu erstellen und dein Projekt für Google Cast zu verwenden SDK.

Hier ist ein Beispiel für das Hinzufügen des CocoaPods google-cast-sdk zu 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

Für Ihr Projekt sollten Sie einen Bereich für Ihre Pods angeben, um unerwartete funktionsgefährdende Änderungen, wie in den podfile-Anleitung

In diesem Snippet werden Version 4.8.3 und die Versionen bis Hauptversion (major.minor.patch) ist zulässig:

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

Beispiel: '~> 1.6.7' umfasst alle Versionen von 1.6.7 und bis, aber nicht einschließlich Version 2.0.0.

Manuelle Einrichtung

Die folgende Anleitung bezieht sich auf das Hinzufügen des Cast iOS SDK zu deinem Projekt. ohne CocoaPods:

Wichtig:Ab Version 4.3.1 CocoaPods verwendet statische Bibliotheken, um doppelte Symbolwarnungen aufgrund eines Abhängigkeit von einer freigegebenen Protobuf-Bibliothek bei Verwendung des Firebase SDKs und des Cast SDKs miteinander verbinden. Diese Änderung führt zwar zu einem größeren Download, nimmt die Größe nicht zu.

Wenn der Größenunterschied in Ihrer Situation ein Problem darstellt, laden Sie die dynamische Bibliothek verwenden, um eine Größe zu erhalten, die den CocoaPods-Versionen vor 4.3.1 ähnelt. Bibliothek.

Downloads

Lade die entsprechende Bibliothek herunter und folge der Einrichtungsschritte zum Hinzufügen des Frameworks zu Ihrem Projekt arbeiten.

Cast-Bibliotheken des Sender SDK 4.8.3 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 in Ihr Hauptprojekt im Xcode-Projektnavigation (nicht zum 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 statische Bibliothek einrichten, führen Sie zusätzlich zu vorherigen Schritten:

1. Protobuf-Bibliothek mit der Mindestversion einrichten Version 3.13.
1. Wenn Ihr Projekt CocoaPods verwendet:
1. Öffne dein Gerät (Podfile) und entferne das 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, befolgen Sie die Anleitung auf der Protobuf GitHub Repository.
2. Fügen Sie in Ihrem Xcode-Projekt die Flags -ObjC -lc++ unter Build-Einstellungen > Weitere Linker-Flags hinzu.
3. Suchen Sie im entpackten Verzeichnis den Ordner „Resources“ und ziehen GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle und MaterialDialogs.bundle in Ihr Projekt neben der GoogleCast.xcframework das zuvor hinzugefügt wurde. Aktivieren Sie das Kontrollkästchen "Bei Bedarf alle Elemente kopieren" und fügen Sie alle Elemente hinzu Ziele.

Mac Catalyst-Einrichtung

Verwende für Apps, die Mac Catalyst unterstützen, die dynamische Bibliothek des Cast SDK. Folgen Sie der manuellen Einrichtung, um den zu Ihrem Projekt hinzufügen. Schließen Sie dann das Cast SDK auf dem Mac bedingt aus. wie in den Apple-Dokumentation Statische Bibliotheken werden für die iOS-Architektur vorkompiliert. Das führt zu einer Verknüpfung Fehler beim Erstellen für das Mac-Ziel.