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
-
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 <ph type="x-smartling-placeholder"></ph> und laden Sie das SDK manuell herunter.
<ph type="x-smartling-placeholder"> -
NSBonjourServices
zu deinemInfo.plist
hinzufügenGeben Sie
NSBonjourServices
in IhremInfo.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. -
Add
NSLocalNetworkUsageDescription
to yourInfo.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 theNSLocalNetworkUsageDescription
such as to describe Cast discovery and other discovery services, like DIAL.This message will appear as part of the iOS Local Network Access dialog as shown in the mock.
-
Re-release your app to the Apple App Store
We recommend you also re-release your app using 4.8.3 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.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:
Einrichtungsschritte
So installieren Sie die Bibliothek:
- Laden Sie das entsprechende SDK für Ihr Projekt herunter und extrahieren Sie es.
- Richte die dynamische GoogleCastSDK-Bibliothek ein:
-
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. -
Wählen Sie in Ihrem Xcode-Ziel auf dem Tab
General
die OptionEmbed and Sign
fürGoogleCast.xcframework
aus.
Wenn Sie die statische Bibliothek einrichten, führen Sie zusätzlich zu vorherigen Schritten:
- Protobuf-Bibliothek mit der Mindestversion einrichten Version 3.13.
- Wenn in Ihrem Projekt CocoaPods verwendet werden:
-
Öffne dein Gerät (
Podfile
) und entferne dasgoogle-cast-sdk
, falls vorhanden:pod 'google-cast-sdk'
-
Fügen Sie die
Protobuf
-Bibliothek hinzu, falls nicht vorhanden:pod 'Protobuf', '3.13'
-
Führen Sie
pod install
im Stammverzeichnis Ihres Projekts aus. - Wenn in Ihrem Projekt keine CocoaPods verwendet werden:
-
Entfernen Sie die aktuelle Version von
GoogleCastSDK
, falls vorhanden. - Fügen Sie die Protobuf-Bibliothek ab Version 3.13 hinzu, befolgen Sie die Anleitung auf der Protobuf GitHub Repository.
-
Fügen Sie in Ihrem Xcode-Projekt die Flags
-ObjC -lc++
zu Build-Einstellungen > Andere Verknüpfungs-Flags. -
Suchen Sie im entpackten Verzeichnis den Ordner „Resources“ und
ziehen
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
undMaterialDialogs.bundle
in Ihr Projekt neben derGoogleCast.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.