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.1 zu Ihrem Projekt hinzufügen

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

   Andernfalls <ph type="x-smartling-placeholder"></ph> und laden Sie das SDK manuell herunter.

   <ph type="x-smartling-placeholder">
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. 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 12

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

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.1 und die Versionen bis Hauptversion (major.minor.patch) ist zulässig:

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

Beispiel: '~> 1.6.7&#39; 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.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 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 in Ihrem Projekt CocoaPods verwendet werden:
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++ zu Build-Einstellungen > Andere Verknüpfungs-Flags.
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.

Einrichtung von Mac Catalyst

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.