Để nhận Firebase Dynamic Links mà bạn đã tạo, bạn phải đưa SDK Dynamic Links vào ứng dụng và gọi phương thức FirebaseDynamicLinks.getDynamicLink() khi ứng dụng tải để nhận dữ liệu được truyền trong Dynamic Link.
Thiết lập Firebase và SDK Dynamic Links
Nếu bạn chưa làm như vậy, thêm Firebase vào dự án Android của bạn.
Khi đăng ký ứng dụng, hãy chỉ định khoá ký SHA-1. Nếu bạn sử dụng Liên kết trong ứng dụng, hãy chỉ định khoá SHA-256.
-
Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là
<project>/<app-module>/build.gradle.ktshoặc<project>/<app-module>/build.gradle), thêm phần phụ thuộc cho thư viện Dynamic Links cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.Để có trải nghiệm tối ưu với Dynamic Links, bạn nên bật Google Analytics trong dự án Firebase và thêm SDK Firebase cho Google Analytics vào ứng dụng.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.5.0")) // Add the dependencies for the Dynamic Links and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links' implementation 'com.google.firebase:firebase-analytics' }
Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng những phiên bản tương thích của thư viện Android trên Firebase.
(Phương án thay thế) Thêm các phần phụ thuộc thư viện Firebase mà không sử dụng BoM
Nếu chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phần phụ thuộc của thư viện đó.
Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự bạn nên sử dụng BoM để quản lý các phiên bản thư viện. Việc này đảm bảo rằng tất cả các phiên bản đều tương thích.
dependencies { // Add the dependencies for the Dynamic Links and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links:22.1.0' implementation 'com.google.firebase:firebase-analytics:22.1.2' }
- Trong bảng điều khiển Firebase, hãy mở phần Dynamic Links. Chấp nhận điều khoản dịch vụ nếu bạn được nhắc.
Thêm bộ lọc ý định cho đường liên kết sâu
Giống như
đường liên kết sâu thuần tuý, bạn phải thêm bộ lọc ý định mới vào hoạt động xử lý
liên kết sâu cho ứng dụng của bạn. Bộ lọc ý định sẽ nắm bắt các liên kết sâu của miền, vì
Dynamic Link sẽ chuyển hướng đến miền của bạn nếu ứng dụng của bạn đã được cài đặt. Đây là yêu cầu bắt buộc để ứng dụng của bạn
nhận dữ liệu Dynamic Link sau khi ứng dụng đó được cài đặt/cập nhật từ Cửa hàng Play và một lần nhấn vào
Nút Tiếp tục. Sau AndroidManifest.xml:
<intent-filter> <action android:name="android.intent.action.VIEW"/> <category android:name="android.intent.category.DEFAULT"/> <category android:name="android.intent.category.BROWSABLE"/> <data android:host="example.com" android:scheme="https"/> </intent-filter>
Khi người dùng mở một Dynamic Link có đường liên kết sâu đến giao thức và máy chủ lưu trữ mà bạn chỉ định, ứng dụng của bạn sẽ bắt đầu hoạt động bằng bộ lọc ý định này để xử lý đường liên kết.
Xử lý đường liên kết sâu
Để nhận đường liên kết sâu, hãy gọi phương thức getDynamicLink():
Kotlin+KTX
Firebase.dynamicLinks .getDynamicLink(intent) .addOnSuccessListener(this) { pendingDynamicLinkData: PendingDynamicLinkData? -> // Get deep link from result (may be null if no link is found) var deepLink: Uri? = null if (pendingDynamicLinkData != null) { deepLink = pendingDynamicLinkData.link } // Handle the deep link. For example, open the linked // content, or apply promotional credit to the user's // account. // ... } .addOnFailureListener(this) { e -> Log.w(TAG, "getDynamicLink:onFailure", e) }
Java
FirebaseDynamicLinks.getInstance() .getDynamicLink(getIntent()) .addOnSuccessListener(this, new OnSuccessListener<PendingDynamicLinkData>() { @Override public void onSuccess(PendingDynamicLinkData pendingDynamicLinkData) { // Get deep link from result (may be null if no link is found) Uri deepLink = null; if (pendingDynamicLinkData != null) { deepLink = pendingDynamicLinkData.getLink(); } // Handle the deep link. For example, open the linked // content, or apply promotional credit to the user's // account. // ... // ... } }) .addOnFailureListener(this, new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "getDynamicLink:onFailure", e); } });
Bạn phải gọi getDynamicLink() trong mọi hoạt động có thể được liên kết khởi chạy, ngay cả khi liên kết có thể có sẵn từ ý định sử dụng getIntent().getData(). Việc gọi getDynamicLink() sẽ truy xuất đường liên kết và xoá dữ liệu đó để ứng dụng của bạn chỉ xử lý một lần.
Bạn cũng thường gọi getDynamicLink() trong hoạt động chính
như bất kỳ hoạt động nào được khởi chạy bởi các bộ lọc ý định khớp với đường liên kết.
Ghi lại số liệu phân tích
Các sự kiện sau đây có thể được tự động theo dõi trong Google Analytics và hiển thị trong bảng điều khiển Firebase.
dynamic_link_app_opendynamic_link_first_opendynamic_link_app_update
Để đăng ký các sự kiện này, bạn cần định cấu hình Google Analytics trước khi truy xuất đường liên kết sâu. Kiểm tra xem các điều kiện sau có được đáp ứng hay không:
- Gọi
FirebaseDynamicLinks.getDynamicLink()tại điểm truy cập của ứng dụng: - Hoạt động của trình chạy. Ví dụ:
action="android.intent.action.MAIN"!category="android.intent.category.LAUNCHER". - Điểm truy cập hoạt động. Ví dụ:
onStart(),onCreate(). - Hoạt động liên kết sâu.
- Thiết lập và sử dụng Google Analytics:
- Thêm phần phụ thuộc Google Analytics. Trình bổ trợ Gradle
google-servicesthường tự động thêm phần này. - Thêm tệp cấu hình
google-services.jsonvào ứng dụng. - Hãy gọi
FirebaseAnalytics.getInstance()trước khi gọiFirebaseDynamicLinks.getDynamicLink().
Xử lý Dynamic Links bằng Đường liên kết trong ứng dụng
Trên Android 6.0 (API cấp 23) trở lên, bạn có thể thiết lập ứng dụng để xử lý Dynamic Links ngay khi ứng dụng đã được cài đặt bằng cách sử dụng Đường liên kết trong ứng dụng Android.
Đảm bảo rằng bạn đã thêm dấu vân tay chứng chỉ SHA256 cho ứng dụng vào dự án trong bảng điều khiển Firebase. Dynamic Links sẽ xử lý việc thiết lập mối liên kết trang web Đường liên kết đến ứng dụng cho miền Dynamic Links của bạn.
Thêm một bộ lọc ý định được xác minh tự động vào Hoạt động sẽ xử lý Dynamic Link, đặt máy chủ lưu trữ thành miền Dynamic Links của dự án như tìm thấy trong bảng điều khiển Firebase. Ngang bằng
AndroidManifest.xml:
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="android.intent.category.BROWSABLE"/>
<data android:host="example.com/link" android:scheme="http"/>
<data android:host="example.com/link" android:scheme="https"/>
</intent-filter>Xin lưu ý rằng bạn phải đặt android:host thành miền Dynamic Links, chứ không phải miền
của đường liên kết sâu.
Bạn phải đăng ký tất cả bộ lọc ý định autoVerify trong tệp kê khai của mình để Ứng dụng
Đường liên kết để tương tác. Firebase tự động xử lý việc này cho Dynamic Links miền của bạn, nhưng bạn có thể kiểm tra
thao tác này bằng cách mở tệp assetlinks.json được lưu trữ trên miền Dynamic Links của bạn:
https://YOUR_DOMAIN/.well-known/assetlinks.json
Dynamic Links hiện sẽ được gửi trực tiếp đến ứng dụng của bạn. Bạn có thể lấy đường liên kết sâu và dữ liệu Dynamic Link khác bằng cách gọi getDynamicLink() trong Hoạt động mà bạn đã thêm bộ lọc ý định Đường liên kết trong ứng dụng (như mô tả trong phần Xử lý đường liên kết sâu).
Lưu ý: Vì việc gọi thông qua Đường liên kết trong ứng dụng sẽ đưa người dùng đến thẳng ứng dụng, nên Đường liên kết động không thể tuân thủ phiên bản tối thiểu bắt buộc. Vì vậy, sau khi mở ứng dụng, bạn cần so sánh phiên bản tối thiểu của Liên kết động ( getminimumappversion) so với PackageInfo.versionCode và chuyển hướng người dùng để nâng cấp ứng dụng nếu cần bằng cách sử dụng getUpdateAppIntent.