Diese Seite wurde von der Cloud Translation API übersetzt.

Dynamische Links unter iOS erhalten

Damit Sie die Firebase Dynamic Links erhalten, die Sie erstellt haben, müssen Sie das Dynamic Links SDK in Ihre App einbinden und die Methoden handleUniversalLink: und dynamicLinkFromCustomSchemeURL: aufrufen, wenn Ihre App geladen wird, um die in der Dynamic Link übergebenen Daten abzurufen.

Vorbereitung

Bevor Sie beginnen, müssen Sie Firebase zu Ihrem iOS-Projekt hinzufügen.

Firebase und das Dynamic Links SDK einrichten

Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.

Öffnen Sie Ihr App-Projekt und gehen Sie in Xcode zu File > Add Packages (Datei > Pakete hinzufügen).
Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:

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

Wählen Sie die Dynamic Links-Bibliothek aus.
Fügen Sie das Flag -ObjC dem Abschnitt Other Linker Flags (Weitere Linker-Flags) der Build-Einstellungen Ihres Ziels hinzu.
Für eine optimale Nutzung von Dynamic Links empfehlen wir, Google Analytics in Ihrem Firebase-Projekt zu aktivieren und das Firebase SDK für Google Analytics in Ihre App einzubinden. Sie können entweder die Bibliothek ohne IDFA-Erfassung oder mit IDFA-Erfassung auswählen. Häufig gestellte Fragen zur aktuellen Organisation von Modulen im Google Analytics für das Firebase SDK
Wenn Sie fertig, beginnt Xcode automatisch, Ihre Abhängigkeiten im Hintergrund aufzulösen und herunterzuladen.

Führen Sie nun einige Konfigurationsschritte aus:

Öffnen Sie in der Firebase Console den Bereich Dynamic Links. Akzeptieren Sie die Nutzungsbedingungen, wenn Sie dazu aufgefordert werden.
Die App Store-ID und das App-ID-Präfix Ihrer App müssen in den Einstellungen der App angegeben sein. Wenn Sie die Einstellungen Ihrer App aufrufen und bearbeiten möchten, rufen Sie die Einstellungsseite Ihres Firebase-Projekts auf und wählen Sie Ihre iOS-App aus.

Sie können prüfen, ob Ihr Firebase-Projekt richtig für die Verwendung von Dynamic Links in Ihrer iOS-App konfiguriert ist, indem Sie die folgende URL öffnen:
```
https://your_dynamic_links_domain/apple-app-site-association
```
Wenn Ihre App verbunden ist, enthält die apple-app-site-association-Datei einen Verweis auf das App-ID-Präfix und die Paket-ID Ihrer App. Beispiel:
```
{"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}
```
Wenn das Feld details leer ist, prüfen Sie, ob Sie Ihr App-ID-Präfix angegeben haben. Das App-ID-Präfix ist möglicherweise nicht mit Ihrer Team-ID identisch.
Optional: Deaktivieren Sie die Verwendung der iOS-Zwischenablage durch das Dynamic Links SDK.

Standardmäßig verwendet das Dynamic Links SDK die Zwischenablage, um die Zuverlässigkeit von Deeplinks nach der Installation zu verbessern. Durch die Verwendung der Zwischenablage kann Dynamic Links dafür sorgen, dass Nutzer, die eine Dynamic Link öffnen, aber zuerst Ihre App installieren müssen, nach der Installation beim ersten Öffnen der App sofort zu den ursprünglich verlinkten Inhalten weitergeleitet werden.

Der Nachteil ist jedoch, dass die Verwendung der Zwischenablage unter iOS 14 und höher eine Benachrichtigung auslöst. Wenn Nutzer Ihre App also zum ersten Mal öffnen und die Zwischenablage eine URL enthält, sehen sie eine Benachrichtigung, dass Ihre App auf die Zwischenablage zugegriffen hat. Das kann zu Verwirrung führen.

Wenn Sie dieses Verhalten deaktivieren möchten, bearbeiten Sie die Datei Info.plist Ihres Xcode-Projekts und legen Sie den Schlüssel FirebaseDeepLinkPasteboardRetrievalEnabled auf NO fest.

Wenn Sie diese Funktion deaktivieren, hat die Dynamic Links, die Sie erhalten, bestenfalls eine matchType von weak. Passen Sie die Logik Ihrer App entsprechend an.

Dynamic Links in Ihrer App öffnen

Erstellen Sie im Xcode-Projekt Ihrer App auf dem Tab Info einen neuen URL-Typ für Dynamic Links. Legen Sie für das Feld Identifier (Kennung) einen eindeutigen Wert und für das Feld URL scheme (URL-Schema) Ihren Paket-Identifier fest. Das ist das Standard-URL-Schema, das von Dynamic Links verwendet wird.
Aktivieren Sie im Xcode-Projekt Ihrer App auf dem Tab Capabilities (Funktionen) die Option „Associated Domains“ (Verknüpfte Domains) und fügen Sie der Liste Associated Domains (Verknüpfte Domains) Folgendes hinzu:
```
applinks:your_dynamic_links_domain
```
Wenn Sie Dynamic Links mit einer vollständig benutzerdefinierten Domain empfangen möchten, erstellen Sie in der Datei Info.plist Ihres Xcode-Projekts einen Schlüssel mit dem Namen FirebaseDynamicLinksCustomDomains und legen Sie ihn auf die Dynamic Links-URL-Präfixe Ihrer App fest. Beispiel:
```
FirebaseDynamicLinksCustomDomains

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

Importieren Sie das FirebaseCore-Modul in Ihre UIApplicationDelegate sowie alle anderen Firebase-Module, die von Ihrem App-Delegaten verwendet werden. So verwenden Sie beispielsweise Cloud Firestore und 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;
// ...

Konfigurieren Sie eine freigegebene FirebaseApp-Instanz in der Methode application(_:didFinishLaunchingWithOptions:) des App-Delegaten:

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];

Wenn Sie SwiftUI verwenden, müssen Sie ein Anwendungs-Delegate erstellen und es über UIApplicationDelegateAdaptor oder NSApplicationDelegateAdaptor an Ihre App-Struktur anhängen. Außerdem müssen Sie das Swizzling von App-Delegaten deaktivieren. Weitere Informationen finden Sie in der SwiftUI-Anleitung.

SwiftUI

@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

Als Nächstes müssen Sie in der

application:continueUserActivity:restorationHandler:

-Methode Links verarbeiten, die als universelle Links empfangen werden, wenn die App bereits installiert ist:

Swift

Hinweis:Dieses Produkt ist nicht für macOS-, Mac Catalyst-, tvOS- oder watchOS-Ziele verfügbar.

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

Hinweis:Dieses Produkt ist nicht für macOS-, Mac Catalyst-, tvOS- oder watchOS-Ziele verfügbar.

- (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;
}

Schließlich müssen Sie in application:openURL:options: Links verarbeiten, die über das benutzerdefinierte URL-Schema Ihrer App empfangen werden. Diese Methode wird aufgerufen, wenn Ihre App nach der Installation zum ersten Mal geöffnet wird.

Wenn die Dynamic Link beim ersten Start Ihrer App nicht gefunden wird, wird diese Methode mit dem url des DynamicLink auf nil gesetzt aufgerufen. Das bedeutet, dass das SDK keine passende ausstehende Dynamic Link gefunden hat.

Swift

Hinweis:Dieses Produkt ist nicht für macOS-, Mac Catalyst-, tvOS- oder watchOS-Ziele verfügbar.

@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

Hinweis:Dieses Produkt ist nicht für macOS-, Mac Catalyst-, tvOS- oder watchOS-Ziele verfügbar.

- (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;
}

Dynamische Links unter iOS erhalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Vorbereitung

Firebase und das Dynamic Links SDK einrichten

Dynamic Links in Ihrer App öffnen

SwiftUI

Swift

Objective-C

SwiftUI

Swift

Objective-C

SwiftUI

Swift

Objective-C

Swift

Objective-C

Dynamische Links unter iOS erhalten