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.

Nota: nuove versioni dell'SDK Cast iOS XCFrameworks, che supportano lo sviluppo su computer Apple Silicon.

Configurazione Xcode

Avviso: impostazione del flag Apple Clang - Code Generation Optimization Level a -Ofast per "Ottimizzazioni più rapide e aggressive" farà sì che le app che usano Trasmetti SDK per iOS in modo anomalo a causa di incompatibilità con le ottimizzazioni. L'SDK supporta il valore predefinito -Os per "Più veloce, più piccolo".

iOS 14

Avviso su iOS 14: modifiche riguardanti iOS 14 le autorizzazioni di accesso alla rete locale hanno influito sull'SDK Google Cast per iOS in un in vari modi. Consulta le Modifiche relative a iOS 14 documento per vedere in che modo la tua app è interessata.

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.

   Altrimenti, eseguire il pull manuale dell'SDK.

   Nota: se hai creato un selettore dispositivo personalizzato nella tua app, dovrai per chiamare esplicitamente il metodo startDiscovery sul GCKDiscoveryManager per avviare il rilevamento dei dispositivi. La scansione automatica è stata disattivata da per impostazione predefinita a partire dalla release 4.5.0 dell'SDK Cast.
2. Aggiungi NSBonjourServices a Info.plist

   Specifica NSBonjourServices in Info.plist per consentono il rilevamento della rete locale su iOS 14.

   Dovrai aggiungere sia _googlecast._tcp che _<your-app-id>._googlecast._tcp come servizi per il dispositivo che il rilevamento 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. 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.3 as soon as possible.

iOS 13

iOS 13 Warning: Apple permissions changes to iOS 13 and Xcode 11 have impacted the Google Cast iOS SDK in a number of ways. Please see the iOS 13 Changes document to see how your app will be impacted.

iOS 12

iOS 12 Warning: If developing using Xcode 10, the "Access WiFi Information" capability is required in order to discover and connect to Cast devices.

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

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:

Punto chiave: a partire dalla versione 4.3.1, CocoaPods utilizza librerie statiche per evitare avvisi di simboli duplicati causati da un dipendenza dalla libreria Protobuf condivisa quando si utilizzano gli SDK Firebase e Cast. in sinergia. Anche se questo cambiamento comporterà un download più grande, l'ultima app dimensioni non aumenteranno.

Se la differenza di dimensioni costituisce un problema per la tua situazione, scarica libreria dinamica per ottenere una dimensione simile a quella delle versioni precedenti alla 4.3.1 di CocoaPods libreria.

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 aggiungi a tutti 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.