在 Firebase 中接收动态链接

2025年3月17日 | 阅读 3 分钟

在本节中，我们将讨论如何接收动态链接。因此，为了接收我们之前创建的 Firebase 动态链接，请在我们的应用中包含 Dynamic Links SDK。当我们的应用加载时，我们还需要调用 FirebaseDynamicLinks.getDynamicLink() 方法来获取动态链接中传递的数据。我们必须向处理我们应用深层链接的活动添加一个新的 Intent 过滤器。 Intent 过滤器应该捕获我们域的深层链接，因为如果安装了我们的应用，动态链接将重定向到我们的域。这是必需的，以便我们的应用在从 Play 商店安装/更新后，以及点击“继续”按钮后，接收动态链接数据。

当用户打开一个动态链接，其中包含指向我们指定的方案和主机的深层链接时，我们的应用将启动具有此 Intent 过滤器的活动来处理该链接。

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="kotlin.example.com"
                        	android:scheme="https"/>
</intent-filter>

Receiving Dynamic Links in Firebase

处理深层链接

为了处理深层链接，我们必须在可能由该链接启动的每个活动中调用 getDynamicLink() 方法，即使该链接可能通过 getIntent().getData() 从 Intent 中获得。当我们调用 getDynamicLink() 时，它会检索该链接并清除该数据，因此我们的应用只能收到一次。我们可以正常地在主活动以及与链接匹配的 Intent 过滤器启动的任何活动中调用 getDynamicLink()。

FirebaseDynamicLinks.getInstance()
    .getDynamicLink(intent)
    .addOnSuccessListener(this) { pendingDynamicLinkData ->
        // Getting 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, opening the linked
        // content, or applying promotional credit to the user's
        // account.
        // ...
}
.addOnFailureListener(this) { e -> Log.w(TAG, "getDynamicLink:onFailure", e) }

activity_main.xml

Receiving Dynamic Links in Firebase

MainActivity.kt

package com.example.dynamiclink

import android.content.Intent
import android.net.Uri
import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle
import android.util.Log
import android.widget.Toast
import com.google.firebase.dynamiclinks.DynamicLink
import com.google.firebase.dynamiclinks.FirebaseDynamicLinks
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Creating a deep link and display it in the UI
        val newDeepLink = buildDeepLink(Uri.parse(DEEP_LINK_URL))
        linkViewSend.text = newDeepLink.toString()

        // Share button click listener
        buttonShare.setOnClickListener {  shareDeepLink(newDeepLink.toString())  }

        FirebaseDynamicLinks.getInstance()
            .getDynamicLink(intent)
            .addOnSuccessListener(this) { pendingDynamicLinkData ->
                // Getting 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, opening the linked
                // content, or applying promotional credit to the user's
                // account.
                // ...

                // Display deep link in the UI
                if (deepLink != null) {
                    Toast.makeText(getApplicationContext(),"Found Deep Link!", Toast.LENGTH_LONG).show()
                    linkViewReceive.text = deepLink.toString()
                } else {
                    Log.d(TAG, "getDynamicLink: no link found")
                }
            }
            .addOnFailureListener(this) { e -> Log.w(TAG, "getDynamicLink:onFailure", e) }
    }

    fun buildDeepLink(deepLink: Uri): Uri {
        val dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink()
            .setLink(Uri.parse(deepLink.toString()))
            .setDomainUriPrefix("https://rastogi.page.link")
            // Open links with this app on Android
            .setAndroidParameters(DynamicLink.AndroidParameters.Builder().build())
            // Open links with com.example.ios on iOS
            .setIosParameters(DynamicLink.IosParameters.Builder("com.example.ios").build())
            .buildDynamicLink()

        val dynamicLinkUri = dynamicLink.uri

        return dynamicLinkUri;
    }

    private fun shareDeepLink(deepLink: String) {
        val intent = Intent(Intent.ACTION_SEND)
        intent.type = "text/plain"
        intent.putExtra(Intent.EXTRA_SUBJECT, "Firebase Deep Link")
        intent.putExtra(Intent.EXTRA_TEXT, deepLink)

        startActivity(intent)
    }

    companion object {

        private const val TAG = "MainActivity"
        private const val DEEP_LINK_URL = "https://kotlin.example.com/deeplinks"
    }
}

输出

Receiving Dynamic Links in Firebase