Il framework Cast supporta iOS 14 e versioni successive ed è disponibile in framework statici e dinamici.
Consulta la documentazione di riferimento dell'API Google Cast iOS per le descrizioni di tutte le classi e di tutti i metodi.
Configurazione Xcode
iOS 14
-
Aggiungere l'SDK Cast iOS 4.8.3 al tuo progetto
Se usi CocoaPods, usa
pod update
per aggiungere l'SDK 4.8.3 al tuo progetto.In caso contrario, importa manualmente l'SDK.
-
Aggiungi
NSBonjourServices
aInfo.plist
Specifica
NSBonjourServices
inInfo.plist
per consentire il rilevamento della rete locale su iOS 14.Dovrai aggiungere sia
_googlecast._tcp
sia_<your-app-id>._googlecast._tcp
come servizi per il rilevamento dei dispositivi affinché funzioni correttamente.L'appID è il ricevitore ID, ovvero lo stesso ID definito nel
GCKDiscoveryCriteria
.Aggiorna la definizione di
NSBonjourServices
di esempio seguente e sostituisci "ABCD1234" con il tuo ID app. -
Aggiungi
NSLocalNetworkUsageDescription
al tuoInfo.plist
Ti consigliamo vivamente di personalizzare il messaggio mostrato nella Prompt di rete aggiungendo una stringa di autorizzazione specifica per l'app nel
Info.plist
perNSLocalNetworkUsageDescription
, ad esempio per descrivere Cast rilevamento e altri servizi di rilevamento, come DIAL.Questo messaggio verrà visualizzato nella finestra di dialogo Accesso alla rete locale di iOS come mostrato nella simulazione.
-
Rilasciare di nuovo l'app sull'App Store di Apple
Ti consigliamo inoltre di rilasciare di nuovo l'app utilizzando la versione 4.8.3 il prima possibile.
iOS 13
iOS 12
Assicurati che l'opzione Accedi alle informazioni Wi-Fi nella sezione Funzionalità del target sia impostata su "On".
Inoltre, il profilo di provisioning dovrà supportare la funzionalità Accedi alle informazioni sul Wi-Fi. Questa opzione può essere aggiunta Portale per sviluppatori Apple.
Configurazione di CocoaPods
La modalità consigliata per integrare Google Cast è l'utilizzo
CocoaPods. Per l'integrazione, utilizza
google-cast-sdk
CocoaPods.
Per iniziare, segui le Guida introduttiva.
Dopo aver configurato CocoaPods, segui le
guida sull'utilizzo di CocoaPods
per creare Podfile
e preparare il progetto per l'utilizzo con Google Cast
l'SDK.
Ecco un esempio di come aggiungere il dispositivo google-cast-sdk
CocoaPod al tuo
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
Per il tuo progetto, devi specificare un intervallo per i pod al fine di evitare imprevisti che interrompono le modifiche, come descritto guida dei podfile.
In questo snippet, la versione 4.8.3 e le versioni successive versione principale (major.minor.patch):
pod 'google-cast-sdk', '~> 4.8.3'
Ad esempio, '~> 1.6.7' include tutte le versioni dalla 1.6.7 in poi, ma non inclusa la versione 2.0.0.
Configurazione manuale
Le istruzioni che seguono consentono di aggiungere l'SDK Cast iOS al tuo progetto. senza utilizzare CocoaPods:
Download
Dopo aver scaricato la libreria appropriata tra quelle riportate di seguito, segui le passaggi di configurazione per aggiungere il framework progetto.
Librerie dell'SDK Cast iOS Sender 4.8.3:
Procedura di configurazione
Per installare la libreria:
- Scarica ed estrai l'SDK appropriato per il tuo progetto.
- Configura la libreria dinamica GoogleCastSDK:
-
Trascina l'elemento
.xcframework
decompresso nel tuo progetto principale nella Navigatore dei progetti Xcode (non nel progetto Pod, se disponibile). Seleziona "Copia tutti gli elementi se necessario" e aggiungili a tutti i target. -
Nel target Xcode, nella scheda
General
, selezionaEmbed and Sign
perGoogleCast.xcframework
.
Se configuri la libreria statica, segui questi passaggi, oltre a i passaggi precedenti:
- Configura la libreria Protobuf con la versione minima Versione 3.13.
- Se il tuo progetto utilizza CocoaPods:
-
Apri
Podfile
e rimuovigoogle-cast-sdk
se presente:pod 'google-cast-sdk'
-
Aggiungi la libreria
Protobuf
se non presente:pod 'Protobuf', '3.13'
-
Esegui
pod install
nella cartella principale del progetto. - Se il tuo progetto non utilizza CocoaPods:
-
Rimuovi la versione corrente di
GoogleCastSDK
, se presente. - Aggiungi la libreria Protobuf 3.13 o versioni successive, seguendo le istruzioni riportate nella Protobuf GitHub un repository completo.
-
Nel progetto Xcode, aggiungi i flag
-ObjC -lc++
a Impostazioni build > Altri flag linker. -
Nella directory decompressa, individua la cartella Resources.
trascina
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
eMaterialDialogs.bundle
nel tuo progetto accanto aGoogleCast.xcframework
che aggiunti in precedenza. Seleziona "Copia tutti gli elementi, se necessario" e aggiungili a tutti i target.
Configurazione di Mac Catalyst
Per le app che supportano Mac Catalyst, utilizza la libreria dinamica dell'SDK Cast. Segui la procedura di configurazione manuale per aggiungere al tuo progetto. Escludi poi in modo condizionale l'SDK Cast dal Mac target come indicato nelle documentazione Apple. Le librerie statiche sono precompilate per l'architettura iOS; di conseguenza viene creato un linker durante lo sviluppo rispetto al target Mac.