ในการรับ Firebase Dynamic Links ที่ คุณสร้างขึ้น คุณต้องรวม Dynamic Links SDK ในแอปของคุณและเรียกใช้ handleUniversalLink:
และ dynamicLinkFromCustomSchemeURL:
เมื่อแอปโหลดเพื่อรับข้อมูลที่ส่งผ่านใน Dynamic Link
ข้อกำหนดเบื้องต้น
ก่อนที่คุณจะเริ่มต้น อย่าลืม เพิ่ม Firebase ในโครงการ iOS ของคุณ
ตั้งค่า Firebase และ Dynamic Links SDK
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการพึ่งพา Firebase
- ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Packages
- เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ SDK ของแพลตฟอร์ม Firebase Apple:
- เลือกไลบรารีไดนามิกลิงก์
- เพื่อประสบการณ์การใช้งานที่ดีที่สุดกับลิงก์แบบไดนามิก เราขอแนะนำให้ เปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม Firebase SDK สำหรับ Google Analytics ในแอปของคุณ คุณสามารถเลือกไลบรารีที่ไม่มีการรวบรวม IDFA หรือคอลเลกชัน IDFA
- เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการพึ่งพาของคุณในเบื้องหลังโดยอัตโนมัติ
https://github.com/firebase/firebase-ios-sdk
ตอนนี้ ดำเนินการตามขั้นตอนการกำหนดค่า:
- ใน คอนโซล Firebase ให้เปิดส่วน ลิงก์แบบไดนามิก ยอมรับข้อกำหนดในการให้บริการหากคุณได้รับแจ้งให้ดำเนินการดังกล่าว
ตรวจสอบให้แน่ใจว่าได้ระบุ App Store ID ของแอปและคำนำหน้า App ID ในการตั้งค่าของแอป หากต้องการดูและแก้ไขการตั้งค่าของแอป ให้ไปที่ หน้าการตั้งค่า ของโปรเจ็กต์ Firebase แล้วเลือกแอป iOS
คุณยืนยันได้ว่าโปรเจ็กต์ Firebase ได้รับการกำหนดค่าอย่างถูกต้องเพื่อใช้ลิงก์แบบไดนามิกในแอป iOS โดยเปิด URL ต่อไปนี้
https://your_dynamic_links_domain/apple-app-site-association
หากแอปของคุณเชื่อมต่ออยู่ ไฟล์
apple-app-site-association
จะมีการอ้างอิงถึง App ID นำหน้าและ ID ของบันเดิล ตัวอย่างเช่น:{"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["NOT /_/*","/*"]}]}}
หากช่อง
details
ว่างเปล่า ให้ตรวจสอบอีกครั้งว่าคุณได้ระบุคำนำหน้ารหัสแอปแล้ว โปรดทราบว่าคำนำหน้า App ID ของคุณอาจไม่เหมือนกับรหัสทีมของคุณไม่บังคับ : ปิดใช้งานการใช้ Pasteboard iOS ของ Dynamic Links SDK
โดยค่าเริ่มต้น Dynamic Links SDK จะใช้แผ่นแปะเพื่อปรับปรุงความน่าเชื่อถือของลิงก์ในรายละเอียดหลังการติดตั้ง เมื่อใช้ Pasteboard จะทำให้ Dynamic Links สามารถมั่นใจได้ว่าเมื่อผู้ใช้เปิด Dynamic Link แต่จำเป็นต้องติดตั้งแอพของคุณก่อน ผู้ใช้สามารถไปที่เนื้อหาที่ลิงก์เดิมได้ทันทีเมื่อเปิดแอพในครั้งแรกหลังการติดตั้ง
ข้อเสียคือการใช้แผ่นแปะจะทริกเกอร์การแจ้งเตือนใน iOS 14 และใหม่กว่า ดังนั้น ในครั้งแรกที่ผู้ใช้เปิดแอปของคุณ หากแผ่นแปะมี URL พวกเขาจะเห็นการแจ้งเตือนว่าแอปของคุณเข้าถึงกระดานวาง ซึ่งอาจทำให้เกิดความสับสน
หากต้องการปิดการทำงานนี้ ให้แก้ไขไฟล์
Info.plist
ของโปรเจ็กต์ Xcode และตั้งค่าคีย์FirebaseDeepLinkPasteboardRetrievalEnabled
เป็นNO
เปิดลิงก์แบบไดนามิกในแอปของคุณ
- ในแท็บ ข้อมูล ของโปรเจ็กต์ Xcode ของแอป ให้สร้างประเภท URL ใหม่เพื่อใช้สำหรับลิงก์แบบไดนามิก ตั้งค่าฟิลด์ ตัวระบุ เป็นค่าที่ไม่ซ้ำกัน และฟิลด์ แบบแผน URL เป็นตัวระบุบันเดิลของคุณ ซึ่งเป็นแบบแผน URL เริ่มต้นที่ใช้โดยไดนามิกลิงก์
- ในแท็บ Capabilities ของโปรเจ็กต์ Xcode ของแอปของคุณ ให้เปิดใช้งาน Associated Domains และเพิ่มรายการต่อไปนี้ไปยังรายการ Associated Domains :
applinks:your_dynamic_links_domain
- หากคุณต้องการรับลิงก์แบบไดนามิกที่มี โดเมนที่กำหนดเอง ทั้งหมด ในไฟล์
Info.plist
ของโปรเจ็กต์ Xcode ให้สร้างคีย์ชื่อFirebaseDynamicLinksCustomDomains
และตั้งค่าเป็นคำนำหน้า URL ลิงก์แบบไดนามิกของแอป ตัวอย่างเช่น:FirebaseDynamicLinksCustomDomains https://example.com/promos https://example.com/links/share - นำเข้าโมดูล
FirebaseCore
ในUIApplicationDelegate
ของคุณ รวมถึง โมดูล Firebase อื่นๆ ที่ผู้รับมอบสิทธิ์แอปของคุณใช้ ตัวอย่างเช่น ในการใช้ Cloud Firestore และการตรวจสอบสิทธิ์:Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
วัตถุประสงค์-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- กำหนดค่าอินสแตนซ์ที่ใช้ร่วมกันของ
FirebaseApp
โดยทั่วไปในเครื่องมือเริ่มต้นของApp
ปหรือวิธีการของapplication(_:didFinishLaunchingWithOptions:)
ของแอปหรือผู้รับมอบสิทธิ์แอป:Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
วัตถุประสงค์-C
// Use Firebase library to configure APIs [FIRApp configure];
- ถัดไป ในเมธอด
application:continueUserActivity:restorationHandler:
จัดการลิงก์ที่ได้รับเป็น Universal Links เมื่อติดตั้งแอปแล้ว:Swift
หมายเหตุ: ผลิตภัณฑ์นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS, Mac Catalyst, tvOS หรือ watchOSfunc application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool { let handled = DynamicLinks.dynamicLinks() .handleUniversalLink(userActivity.webpageURL!) { dynamiclink, error in // ... } return handled }
วัตถุประสงค์-C
หมายเหตุ: ผลิตภัณฑ์นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS, Mac Catalyst, tvOS หรือ 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<UIUserActivityRestoring>> *_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; }
- สุดท้าย ใน
application:openURL:options:
จัดการลิงก์ที่ได้รับผ่านรูปแบบ URL ที่กำหนดเองของแอป วิธีนี้เรียกว่าเมื่อมีการเปิดแอปของคุณเป็นครั้งแรกหลังการติดตั้งหากไม่พบลิงก์แบบไดนามิกในการเปิดใช้แอปครั้งแรก ระบบจะเรียกใช้เมธอดนี้โดยตั้งค่า
url
ของDynamicLink
เป็นnil
ซึ่งแสดงว่า SDK ไม่พบลิงก์แบบไดนามิกที่รอดำเนินการที่ตรงกันSwift
หมายเหตุ: ผลิตภัณฑ์นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS, Mac Catalyst, tvOS หรือ 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 }
วัตถุประสงค์-C
หมายเหตุ: ผลิตภัณฑ์นี้ไม่พร้อมใช้งานบนเป้าหมาย macOS, Mac Catalyst, tvOS หรือ watchOS- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<NSString *, id> *)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; }