Ricevi link dinamici su iOS

Per ricevere il Firebase Dynamic Links che hai creato, devi includere l'SDK Dynamic Links nella tua app e chiamare i metodi handleUniversalLink: e dynamicLinkFromCustomSchemeURL: quando l'app viene caricata per ottenere i dati passati nel Dynamic Link.

Prerequisiti

Prima di iniziare, assicurati di aggiungere Firebase al tuo progetto iOS.

Configura Firebase e l'SDK Dynamic Links

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

1. In Xcode, con il progetto dell'app aperto, vai a File > Add Packages (File > Aggiungi pacchetti).
2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple di Firebase:

  https://github.com/firebase/firebase-ios-sdk.git

3. Scegli la libreria Dynamic Links.
4. Aggiungi il flag -ObjC alla sezione Other Linker Flags (Altri flag del linker) delle impostazioni di build del target.
5. Per un'esperienza ottimale con Dynamic Links, ti consigliamo di attivare Google Analytics nel tuo progetto Firebase e di aggiungere l'SDK Firebase per Google Analytics alla tua app. Puoi selezionare la libreria con o senza raccolta di IDFA. Consulta le nostre domande frequenti sulla più recente organizzazione dei moduli nell'SDK Google Analytics per Firebase.
6. Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Ora esegui alcuni passaggi di configurazione:

1. Nella consoleFirebase, apri la sezione Dynamic Links. Se ti viene richiesto, accetta i Termini di servizio.

2. Assicurati che l'ID App Store e il prefisso dell'ID app siano specificati nelle impostazioni dell'app. Per visualizzare e modificare le impostazioni dell'app, vai alla pagina Impostazioni del progetto Firebase e seleziona l'app per iOS.

   Puoi verificare che il tuo progetto Firebase sia configurato correttamente per l'utilizzo di Dynamic Links nella tua app per iOS aprendo il seguente URL:

   https://your_dynamic_links_domain/apple-app-site-association

   Se l'app è collegata, il file apple-app-site-association contiene un riferimento al prefisso dell'ID app e all'ID pacchetto dell'app. Ad esempio:

   {"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}

   Se il campo details è vuoto, verifica di aver specificato il prefisso dell'ID app. Tieni presente che il prefisso dell'ID app potrebbe non corrispondere all'ID team.

3. Facoltativo: disattiva l'utilizzo della tastiera iOS da parte dell'SDK Dynamic Links.

   Per impostazione predefinita, l'SDK Dynamic Links utilizza la clipboard per migliorare l'affidabilità dei deep link post-installazione. Utilizzando gli appunti, Dynamic Links può assicurarsi che quando un utente apre un Dynamic Link, ma deve prima installare la tua app, possa accedere immediatamente ai contenuti collegati originali quando apre l'app per la prima volta dopo l'installazione.

   Lo svantaggio è che l'utilizzo della bacheca attiva una notifica su iOS 14 e versioni successive. Pertanto, la prima volta che gli utenti aprono la tua app, se la bacheca contiene un URL, vedranno una notifica che indica che la tua app ha eseguito l'accesso alla bacheca, il che può causare confusione.

   Per disattivare questo comportamento, modifica il file Info.plist del progetto Xcode e imposta la chiave FirebaseDeepLinkPasteboardRetrievalEnabled su NO.

Apri Dynamic Links nell'app

1. Nella scheda Info del progetto Xcode della tua app, crea un nuovo tipo di URL da utilizzare per Dynamic Links. Imposta il campo Identificatore su un valore univoco e il campo Schema URL sull'identificatore pacchetto, che è lo schema URL predefinito utilizzato da Dynamic Links.
2. Nella scheda Capabilities del progetto Xcode della tua app, attiva Domini associati e aggiungi quanto segue all'elenco Domini associati:

   applinks:your_dynamic_links_domain

3. Se vuoi ricevere Dynamic Links con un dominio completamente personalizzato, nel file Info.plist del tuo progetto Xcode, crea una chiave denominata FirebaseDynamicLinksCustomDomains e impostala sui prefissi URL Dynamic Links della tua app. Ad esempio:

   FirebaseDynamicLinksCustomDomains
   
     https://example.com/promos
     https://example.com/links/share
   

4. Importa il modulo FirebaseCore nel tuo UIApplicationDelegate, nonché tutti gli altri moduli Firebase utilizzati dal tuo delegato dell'app. Ad esempio, per utilizzare Cloud Firestore e Authentication:

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

5. Configura un'istanza condivisa FirebaseApp nel metodo application(_:didFinishLaunchingWithOptions:) del tuo delegato dell'app:

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

6. Se utilizzi SwiftUI, devi creare un delegato dell'applicazione e collegarlo alla struttura App tramite UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor. Devi anche disattivare lo swizzling del delegato dell'app. Per maggiori informazioni, consulta le istruzioni di SwiftUI.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

7. In seguito, nel metodo application:continueUserActivity:restorationHandler: , gestisci i link ricevuti come link universali quando l'app è già installata:

   Swift

   Nota:questo prodotto non è disponibile su target macOS, Mac Catalyst, tvOS o watchOS.

   func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
     let handled = DynamicLinks.dynamicLinks()
       .handleUniversalLink(userActivity.webpageURL!) { dynamiclink, error in
         // ...
       }
   
     return handled
   }

   Objective-C

   Nota:questo prodotto non è disponibile su target macOS, Mac Catalyst, tvOS o watchOS.

   - (BOOL)application:(UIApplication *)application
   continueUserActivity:(nonnull NSUserActivity *)userActivity
    restorationHandler:
   #if defined(__IPHONE_12_0) && (__IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_12_0)
   (nonnull void (^)(NSArray<id> *_Nullable))restorationHandler {
   #else
       (nonnull void (^)(NSArray *_Nullable))restorationHandler {
   #endif  // __IPHONE_12_0
     BOOL handled = [[FIRDynamicLinks dynamicLinks] handleUniversalLink:userActivity.webpageURL
                                                             completion:^(FIRDynamicLink * _Nullable dynamicLink,
                                                                          NSError * _Nullable error) {
                                                               // ...
                                                             }];
     return handled;
   }

8. Infine, in application:openURL:options: gestisci i link ricevuti tramite lo schema URL personalizzato della tua app. Questo metodo viene chiamato quando la tua app viene aperta per la prima volta dopo l'installazione.

   Se Dynamic Link non viene trovato al primo avvio dell'app, questo metodo verrà chiamato con url di DynamicLink impostato su nil, a indicare che l'SDK non è riuscito a trovare un Dynamic Link in attesa corrispondente.

   Swift

   Nota:questo prodotto non è disponibile su target macOS, Mac Catalyst, tvOS o watchOS.

   @available(iOS 9.0, *)
   func application(_ app: UIApplication, open url: URL,
                    options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
     return application(app, open: url,
                        sourceApplication: options[UIApplication.OpenURLOptionsKey
                          .sourceApplication] as? String,
                        annotation: "")
   }
   
   func application(_ application: UIApplication, open url: URL, sourceApplication: String?,
                    annotation: Any) -> Bool {
     if let dynamicLink = DynamicLinks.dynamicLinks().dynamicLink(fromCustomSchemeURL: url) {
       // Handle the deep link. For example, show the deep-linked content or
       // apply a promotional offer to the user's account.
       // ...
       return true
     }
     return false
   }

   Objective-C

   Nota:questo prodotto non è disponibile su target macOS, Mac Catalyst, tvOS o watchOS.

   - (BOOL)application:(UIApplication *)app
               openURL:(NSURL *)url
               options:(NSDictionary *)options {
     return [self application:app
                      openURL:url
            sourceApplication:options[UIApplicationOpenURLOptionsSourceApplicationKey]
                   annotation:options[UIApplicationOpenURLOptionsAnnotationKey]];
   }
   
   - (BOOL)application:(UIApplication *)application
               openURL:(NSURL *)url
     sourceApplication:(NSString *)sourceApplication
            annotation:(id)annotation {
     FIRDynamicLink *dynamicLink = [[FIRDynamicLinks dynamicLinks] dynamicLinkFromCustomSchemeURL:url];
   
     if (dynamicLink) {
       if (dynamicLink.url) {
         // Handle the deep link. For example, show the deep-linked content,
         // apply a promotional offer to the user's account or show customized onboarding view.
         // ...
       } else {
         // Dynamic link has empty deep link. This situation will happens if
         // Firebase Dynamic Links iOS SDK tried to retrieve pending dynamic link,
         // but pending link is not available for this device/App combination.
         // At this point you may display default onboarding view.
       }
       return YES;
     }
     return NO;
   }