Configurazione per lo sviluppo con Cast Application Framework (CAF) per iOS

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

1. 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.

2. Aggiungi NSBonjourServices a Info.plist

   Specifica NSBonjourServices in Info.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.

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

3. Aggiungi NSLocalNetworkUsageDescription al tuo Info.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 per NSLocalNetworkUsageDescription, ad esempio per descrivere Cast rilevamento e altri servizi di rilevamento, come DIAL.

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

   Questo messaggio verrà visualizzato nella finestra di dialogo Accesso alla rete locale di iOS come mostrato nella simulazione.

   
4. 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:

Statico Dinamico

Procedura di configurazione

Per installare la libreria:

1. Scarica ed estrai l'SDK appropriato per il tuo progetto.
2. Configura la libreria dinamica GoogleCastSDK:
3. 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.
4. Nel target Xcode, nella scheda General, seleziona Embed and Sign per GoogleCast.xcframework.

Se configuri la libreria statica, segui questi passaggi, oltre a i passaggi precedenti:

1. Configura la libreria Protobuf con la versione minima Versione 3.13.
1. Se il tuo progetto utilizza CocoaPods:
1. Apri Podfile e rimuovi google-cast-sdk se presente:

   pod 'google-cast-sdk'

2. Aggiungi la libreria Protobuf se non presente:

   pod 'Protobuf', '3.13'

3. Esegui pod install nella cartella principale del progetto.
2. Se il tuo progetto non utilizza CocoaPods:
1. Rimuovi la versione corrente di GoogleCastSDK, se presente.
2. Aggiungi la libreria Protobuf 3.13 o versioni successive, seguendo le istruzioni riportate nella Protobuf GitHub un repository completo.
2. Nel progetto Xcode, aggiungi i flag -ObjC -lc++ a Impostazioni build > Altri flag linker.
3. Nella directory decompressa, individua la cartella Resources. trascina GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle e MaterialDialogs.bundle nel tuo progetto accanto a GoogleCast.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.