Aggiungere l'SDK Audience Network all'app Unity

Questa guida spiega come includere l'SDK Audience Network nella tua app iOS in modo da poter chiamare le API di Audience Network. Il metodo preferito è usare CocoaPods per gestire le dipendenze; tuttavia, vengono forniti anche percorsi di download per l'integrazione manuale.

CocoaPods (metodo di download consigliato)

Aggiungi la linea seguente al Podfile del tuo progetto.

pod 'FBAudienceNetwork'

Esegui questo comando:

pod install

Download manuale

Se l'utilizzo di CocoaPods non è un'opzione, puoi scaricare l'SDK Audience Network da uno dei percorsi nella tabella seguente.

Dopo aver scaricato l'SDK di Audience Network, completa l'integrazione nel modo seguente:

1. Apri il tuo progetto in XCode.
2. Trascina e rilascia FBAudienceNetwork.xcframework dalla cartella Dynamic (Dinamico) nel tuo archivio dell'SDK di Audience Network per iOS scaricato in XCode.
3. Nella tab General (Generale) nelle impostazioni target della tua app, seleziona Embed & Sign (Incorpora e firma) per FBAudienceNetwork.xcframework

Note

• Puoi anche utilizzare la variante statica dell'SDK di Audience Network fornita durante il download. Per farlo, trascina e rilascia FBAudienceNetwork.xcframework dalla cartella Static (Statico).
• Se vuoi utilizzare la variante Static (Statico), assicurati che il tuo progetto stia utilizzando Swift. Se il tuo progetto non utilizza Swift, aggiungi un file swift vuoto selezionando File -> New -> Swift (File -> Nuovo -> Swift) in XCode al tuo progetto
• Se il tuo progetto sta targetizzando una versione di iOS precedente alla 12.4, assicurati di impostare Always embed Swift standard libraries (Incorpora sempre le librerie standard Swift) su YES (Sì) in Build settings (Impostazioni build) del target della tua app in XCode.
• Per evitare di aggiungere ulteriori modifiche dopo l'installazione manuale, utilizza CocoaPods.

Risoluzione dei problemi per la versione 6.9.0 dell'SDK e successive

A partire dalla versione 6.9.0, l'SDK di Audience Network è stato abilitato per Swift. Consulta i seguenti punti per sapere come gestire i problemi più comuni relativi all'installazione dell'SDK e all'interoperabilità di Swift:

• XCode emette gli errori: "Undefined symbol: __swift_FORCE_LOAD_$_swiftDataDetection" (Simbolo non definito: __swift_FORCE_LOAD_$_swiftDataDetection) e "Undefined symbol: __swift_FORCE_LOAD_$_swiftFileProvider" (Simbolo non definito: __swift_FORCE_LOAD_$_swiftFileProvider). Questi errori indicano che non stai utilizzando l'ultima versione di XCode. Aggiorna a XCode 13 o versioni successive per correggere questi errori.
• XCode emette molti errori Undefined symbol__swift_FORCE_LOAD_$_. Questi errori indicano che il supporto Swift non è stato abilitato per il tuo progetto. Il modo più semplice per correggere questo errore è aggiungere un file Swift vuoto selezionando "File" -> "New" -> "Swift file" (File -> Nuovo -> File Swift) in XCode.
• Quando è in esecuzione sul dispositivo, l'app si arresta in modo anomalo subito dopo l'avvio restituendo l'errore: "dyld: Library not loaded: @rpath/FBAudienceNetwork.framework" (dyld: Libreria non caricata: @rpath/FBAudienceNetwork.framework). Questo errore indica che non hai incorporato l'SDK di Audience Network nella tua app. Accedi alle impostazioni target e scegli "Embed & Sign" (Incorpora e firma) per "FBAudienceNetwork.xcframework" nella tab "General" (Generale).
• L'app si arresta in modo anomalo subito dopo l'avvio restituendo l'errore: "dyld: Library not loaded: @rpath/libswiftCore.dylib" (dyld: Libreria non caricata: @rpath/libswiftCore.dylib). Questo errore indica che stai eseguendo un'app su una versione di iOS precedente alla 12.4 e che non hai impostato "Always embed Swift standard libraries" (Incorpora sempre le librerie standard Swift) su "YES" (Sì). Assicurati di impostare "Always embed Swift standard libraries" (Incorpora sempre le librerie standard Swift) su YES (Sì) in "Build settings" (Impostazioni build) del target della tua app in XCode.