برای دریافت Firebase Dynamic Links که ایجاد کردهاید ، باید SDK Dynamic Links را در برنامه خود قرار دهید و هنگامی که برنامه شما بارگیری میشود، متد FirebaseDynamicLinks.getDynamicLink()
را فراخوانی کنید تا دادهها در Dynamic Link ارسال شود.
Firebase و Dynamic Links SDK را راه اندازی کنید
اگر قبلاً این کار را نکردهاید، Firebase را به پروژه Android خود اضافه کنید .
هنگامی که برنامه خود را ثبت می کنید، کلید امضای SHA-1 خود را مشخص کنید. اگر از App Links استفاده می کنید، کلید SHA-256 خود را نیز مشخص کنید.
در فایل Gradle ماژول (سطح برنامه) خود (معمولا
<project>/<app-module>/build.gradle.kts
یا<project>/<app-module>/build.gradle
)، وابستگی را برای Dynamic Links اضافه کنید. کتابخانه برای اندروید توصیه میکنیم از Firebase Android BoM برای کنترل نسخهسازی کتابخانه استفاده کنید.برای تجربه بهینه با Dynamic Links ، توصیه میکنیم Google Analytics در پروژه Firebase خود فعال کنید و Firebase SDK برای Google Analytics را به برنامه خود اضافه کنید.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.4.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' }
با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخههای سازگار کتابخانههای Firebase Android استفاده میکند.
به دنبال یک ماژول کتابخانه خاص کاتلین هستید؟ از اکتبر 2023 ( Firebase BoM 32.5.0) ، توسعه دهندگان Kotlin و Java می توانند به ماژول کتابخانه اصلی وابسته باشند (برای جزئیات، به سؤالات متداول در مورد این ابتکار مراجعه کنید).(جایگزین) وابستگی های کتابخانه Firebase را بدون استفاده از BoM اضافه کنید
اگر تصمیم گرفتید از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.
توجه داشته باشید که اگر از چندین کتابخانه Firebase در برنامه خود استفاده می کنید، ما قویاً توصیه می کنیم از BoM برای مدیریت نسخه های کتابخانه استفاده کنید، که تضمین می کند همه نسخه ها سازگار هستند.
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' }
- در کنسول Firebase ، بخش Dynamic Links را باز کنید. اگر از شما خواسته شد شرایط خدمات را بپذیرید.
یک فیلتر قصد برای پیوندهای عمیق اضافه کنید
مانند پیوندهای عمیق ساده ، باید یک فیلتر قصد جدید به فعالیت اضافه کنید که پیوندهای عمیق را برای برنامه شما مدیریت می کند. فیلتر هدف باید پیوندهای عمیق دامنه شما را بگیرد، زیرا اگر برنامه شما نصب شود Dynamic Link به دامنه شما هدایت می شود. این برای دریافت دادههای Dynamic Link پس از نصب/بهروزرسانی از Play Store و یک ضربه زدن روی دکمه Continue، لازم است. در 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>
وقتی کاربران یک Dynamic Link با پیوند عمیق به طرح و میزبانی که مشخص کردهاید باز میکنند، برنامه شما فعالیت را با این فیلتر قصد شروع میکند تا پیوند را مدیریت کند.
پیوندهای عمیق را مدیریت کنید
برای دریافت لینک عمیق، متد 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); } });
در هر فعالیتی که ممکن است توسط پیوند راه اندازی شود، باید getDynamicLink()
فراخوانی کنید، حتی اگر پیوند ممکن است از طریق intent با استفاده از getIntent().getData()
در دسترس باشد. فراخوانی getDynamicLink()
پیوند را بازیابی میکند و آن دادهها را پاک میکند، بنابراین فقط یک بار توسط برنامه شما پردازش میشود.
شما معمولاً getDynamicLink()
در اکتیویتی اصلی و همچنین هر فعالیتی را که توسط فیلترهای intent راه اندازی می شود که با پیوند مطابقت دارد فراخوانی می کنید.
ثبت تجزیه و تحلیل
رویدادهای زیر را می توان به طور خودکار در Google Analytics دنبال کرد و در کنسول Firebase نشان داد.
-
dynamic_link_app_open
-
dynamic_link_first_open
-
dynamic_link_app_update
برای ثبت این رویدادها، قبل از بازیابی پیوند عمیق، باید Google Analytics پیکربندی کنید. بررسی کنید که شرایط زیر وجود دارد:
- با
FirebaseDynamicLinks.getDynamicLink()
در نقاط ورودی برنامه خود تماس بگیرید: - فعالیت های لانچر به عنوان مثال:
action="android.intent.action.MAIN"
,category="android.intent.category.LAUNCHER"
. - نقاط ورود به فعالیت به عنوان مثال:
onStart()
,onCreate()
. - فعالیت های پیوند عمیق
- راه اندازی و استفاده از Google Analytics :
- وابستگی Google Analytics را نیز لحاظ کنید. این معمولاً به طور خودکار توسط پلاگین
google-services
Gradle اضافه می شود. - فایل پیکربندی
google-services.json
را در برنامه خود قرار دهید . - قبل از فراخوانی
FirebaseDynamicLinks.getDynamicLink()
باFirebaseAnalytics.getInstance()
تماس بگیرید.
مدیریت Dynamic Links با استفاده از پیوندهای برنامه
در Android 6.0 (سطح API 23) و بالاتر، میتوانید برنامه خود را طوری تنظیم کنید که وقتی برنامه شما قبلاً نصب شده است، با استفاده از پیوندهای برنامه Android، مستقیماً Dynamic Links مدیریت کند.
مطمئن شوید که اثر انگشت گواهی SHA256 را برای برنامه خود به پروژه خود در کنسول Firebase اضافه کرده اید. Dynamic Links راه اندازی ارتباط وب سایت App Links را برای دامنه Dynamic Links شما انجام می دهد.
یک فیلتر هدف تأیید شده خودکار به Activity اضافه کنید که Dynamic Link مدیریت میکند، و میزبان را روی دامنه Dynamic Links پروژهتان همانطور که در کنسول Firebase یافت میشود، تنظیم کنید. در 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>
توجه داشته باشید که android:host
باید روی دامنه Dynamic Links شما تنظیم شود و نه دامنه پیوند عمیق شما.
همه فیلترهای هدف تأیید autoVerify
در مانیفست شما باید ثبت شوند تا پیوندهای برنامه درگیر شوند. Firebase به طور خودکار این کار را برای دامنههای Dynamic Links شما انجام میدهد، اما میتوانید با باز کردن فایل assetlinks.json
که در دامنه Dynamic Links میزبانی شده است، آن را بررسی کنید:
https://YOUR_DOMAIN/.well-known/assetlinks.jsonهمه نامهای بسته برنامههای Firebase شما باید درج شود.
اکنون Dynamic Links مستقیماً به برنامه شما ارسال می شود. با فراخوانی getDynamicLink()
در فعالیتی که فیلتر هدف App Links را به آن اضافه کردهاید، میتوانید پیوند عمیق و سایر دادههای Dynamic Link را دریافت کنید (همانطور که در Handle deep links توضیح داده شد).
توجه: از آنجایی که فراخوانی از طریق پیوندهای برنامه کاربر را مستقیماً به برنامه می برد، پیوند پویا نمی تواند حداقل نسخه مورد نیاز را رعایت کند. بنابراین پس از باز شدن برنامه، باید حداقل نسخه Dynamic Link ( getminimumappversion ) را با PackageInfo.versionCode مقایسه کنید و کاربر را برای ارتقاء برنامه در صورت لزوم با استفاده از getUpdateAppIntent هدایت کنید.