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

Il framework Cast supporta iOS 16 e versioni successive ed è disponibile sia in framework statici che 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 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, importa 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, dovrai aggiungere sia _googlecast._tcp sia _<your-app-id>._googlecast._tcp come servizi.

    L'appID è il tuo receiverID, che corrisponde all'ID definito nel tuo GCKDiscoveryCriteria.

    Aggiorna la seguente definizione di esempio NSBonjourServices 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 nel prompt della rete locale aggiungendo una stringa di autorizzazione specifica per l'app nel file Info.plist dell'app per NSLocalNetworkUsageDescription, ad esempio per descrivere il rilevamento di Cast 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 nel modello.

    Immagine della finestra di dialogo delle autorizzazioni di accesso alla rete locale di Cast
  4. Ripubblica l'app nell'App Store di Apple

    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 versione principale successiva con una versione minima 4.8.6 per ricevere aggiornamenti compatibili senza modifiche che provocano un errore impreviste.
  4. Fai clic su Aggiungi pacchetto.
  5. Seleziona il prodotto GoogleCastDynamic o GoogleCastStatic e aggiungilo al target dell'app.

Scegli una variante del framework

Il pacchetto SDK Cast per iOS fornisce due prodotti:

  • GoogleCastDynamic: il framework dinamico. Include tutte le risorse degli asset richieste dai componenti dell'interfaccia utente di Cast e non richiede flag aggiuntivi del linker. Le app che supportano Mac Catalyst devono utilizzare il framework dinamico. Per saperne di più, consulta 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 di 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 della UI di 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 alla versione 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 aggiungi a tutte le destinazioni.

Configurazione di CocoaPods

Configurazione manuale

Le seguenti istruzioni spiegano come aggiungere l'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 SDK Cast iOS Sender 4.8.6:

Static Dynamic

Procedura di configurazione

Per installare la libreria:

  1. Scarica ed estrai l'SDK appropriato per il tuo progetto.
  2. Configura la libreria GoogleCastSDK dinamica:
  3. Trascina il file .xcframework decompresso nel progetto principale nel navigatore del progetto Xcode. Seleziona "Copia tutti gli elementi se necessario" e aggiungi a tutte le destinazioni.
  4. Nella destinazione 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 corrente 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 file GoogleCast.xcframework che hai aggiunto in precedenza. Seleziona "Copia tutti gli elementi, se necessario" e aggiungi a tutte le destinazioni.

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 di Apple. Le librerie statiche sono precompilate per l'architettura iOS, il che causa un errore del linker durante la creazione per il target Mac.

Avanti
Privacy