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

Il framework Cast supporta iOS 16 e versioni successive ed è disponibile in framework statici e dinamici.

Consulta il riferimento API Google Cast per iOS per le descrizioni di tutte le classi e di tutti i metodi.

Configurazione di Xcode

  1. Aggiungi l'SDK Cast per iOS 4.8.6 al tuo progetto

    Se utilizzi Swift Package Manager, aggiorna il pacchetto google-cast-ios-sdk alla versione 4.8.6.

    In caso contrario, inserisci l'SDK manualmente.

  2. Aggiungi NSBonjourServices al tuo Info.plist

    Specifica NSBonjourServices nel tuo Info.plist per consentire il rilevamento della rete locale.

    Per il corretto funzionamento del rilevamento dei dispositivi, devi aggiungere sia _googlecast._tcp sia _<your-app-id>._googlecast._tcp come servizi.

    L'appID è il tuo receiverID, ovvero lo stesso ID definito nel tuo GCKDiscoveryCriteria.

    Aggiorna la seguente definizione di NSBonjourServices e sostituisci "ABCD1234" con il tuo appID. 

    <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 nel prompt della rete locale aggiungendo una stringa di autorizzazione specifica dell'app nel file Info.plist dell'app per NSLocalNetworkUsageDescription, ad esempio per descrivere l'individuazione di Cast e altri servizi di individuazione, 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 di accesso alla rete locale di iOS come mostrato nel mock-up.

    Immagine della finestra di dialogo delle autorizzazioni di accesso alla rete locale per la trasmissione
  4. Ripubblicare l'app sull'Apple App Store

    Ti consigliamo inoltre di ripubblicare la tua app utilizzando la versione 4.8.6 il prima possibile.

Configurazione di Swift Package Manager

Il modo consigliato per integrare Google Cast è utilizzare Swift Package Manager (SPM). Il pacchetto SDK Cast per iOS è disponibile nel repository GitHub google-cast-ios-sdk.

Per aggiungere l'SDK Cast per iOS al tuo progetto in Xcode:

  1. In Xcode, seleziona File > Add Packages… (Aggiungi pacchetti…).
  2. Inserisci l'URL del repository: https://github.com/googlecast/google-cast-ios-sdk.
  3. Seleziona le regole di controllo delle versioni. Ad esempio, seleziona Fino alla prossima versione principale con una versione minima di 4.8.6 per ricevere aggiornamenti compatibili senza modifiche che causano interruzioni impreviste.
  4. Fai clic su Aggiungi pacchetto.
  5. Seleziona il prodotto GoogleCastDynamic o GoogleCastStatic e aggiungilo al target dell'app.

Scegliere una variante del framework

Il pacchetto SDK Cast per iOS fornisce due prodotti:

  • GoogleCastDynamic: il framework dinamico. Include tutte le risorse delle risorse richieste dai componenti della UI di Cast e non richiede flag del linker aggiuntivi. Le app che supportano Mac Catalyst devono utilizzare il framework dinamico. Per saperne di più, consulta la sezione Configurazione di Mac Catalyst.
  • GoogleCastStatic: il framework statico. Richiede i passaggi di configurazione aggiuntivi descritti in Configurazione del framework statico.

Configurazione del framework statico

I framework statici non possono includere bundle di risorse. Di conseguenza, Swift Package Manager non può raggruppare automaticamente le risorse degli asset richieste dai componenti dell'interfaccia utente Cast (come immagini dell'interfaccia utente, storyboard e file di localizzazione) con il prodotto GoogleCastStatic. Se aggiungi GoogleCastStatic al target, completa i seguenti passaggi:

  1. Nel progetto Xcode, aggiungi i flag -ObjC -lc++ a Build Settings (Impostazioni di build) > Other Linker Flags (Altri flag del linker).
  2. Se la tua app utilizza i componenti dell'interfaccia utente Cast, aggiungi manualmente i bundle di asset al tuo progetto:
    1. Scarica la libreria statica da Download. Assicurati che la versione della libreria statica corrisponda a quella del pacchetto che hai aggiunto.
    2. Individua la cartella Resources nella directory decompressa e trascina tutti i file .bundle nel progetto Xcode. Seleziona "Copia tutti gli elementi se necessario" e aggiungili a tutti i target.

Configurazione di CocoaPods

Configurazione manuale

Le seguenti istruzioni riguardano l'aggiunta dell'SDK Cast per iOS al tuo progetto senza utilizzare Swift Package Manager:

Download

Dopo aver scaricato la libreria appropriata di seguito, segui i passaggi di configurazione per aggiungere il framework al tuo progetto.

Librerie dell'SDK Cast iOS Sender 4.8.6:

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 il file .xcframework decompresso nel progetto principale nel navigatore del progetto Xcode. 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 stai configurando la libreria dinamica, segui questi passaggi oltre a quelli precedenti:

  1. Rimuovi la versione attuale di GoogleCastSDK, se presente.
  2. Aggiungi la libreria Protobuf v3.13 o versioni successive, seguendo le istruzioni riportate nel repository GitHub di Protobuf.

Se stai configurando la libreria statica, segui questi passaggi oltre a quelli precedenti:

  1. Nel progetto Xcode, aggiungi i flag -ObjC -lc++ a Build Settings (Impostazioni di build) > Other Linker Flags (Altri flag del linker).
  2. Individua la cartella Resources nella directory decompressa e trascina tutti i file .bundle nel progetto accanto al GoogleCast.xcframework che hai aggiunto in precedenza. Se necessario, seleziona "Copia tutti gli elementi" 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 il framework al tuo progetto. Poi escludi in modo condizionale l'SDK Cast dal target Mac come indicato nella documentazione Apple. Le librerie statiche sono precompilate per l'architettura iOS, il che causa un errore del linker durante la compilazione rispetto al target Mac.

Avanti
Privacy