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.

Xcode-Einrichtung

iOS 14

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.

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 12

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:

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.