android 配置deeplink

原创

mob64ca12f31496 2024-07-31 06:31:01 ©著作权

文章标签 App xml android 文章分类 Android 移动开发

©著作权归作者所有：来自51CTO博客作者mob64ca12f31496的原创作品，请联系作者获取转载授权，否则将追究法律责任

Android 配置 Deep Link 的入门指南

引言

随着移动应用的普及，Deep Link（深度链接）技术已经成为应用程序设计中不可或缺的一部分。Deep Link 允许外部链接直接打开应用的特定页面，从而提高用户体验和应用的可访问性。本文将指导你如何在 Android 应用中实现 Deep Link，适合刚入行的小白开发者。

整体流程

在实现 Deep Link 的过程中，我们需要完成以下几个步骤：

步骤	描述
1. 配置 AndroidManifest.xml	在 Manifest 文件中声明支持 Deep Link
2. 处理 Intent	在目标 Activity 中处理接收到的 Deep Link 请求
3. 测试 Deep Link	使用特定工具或方法来验证 Deep Link 的有效性

第1步：配置 AndroidManifest.xml

首先，我们需要在 AndroidManifest.xml 文件中声明支持 Deep Link 的内容。代码示例如下：

<activity android:name=".MyActivity">
    <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:scheme="https"
            android:host="www.example.com" 
            android:pathPrefix="/content" />
    </intent-filter>
</activity>

代码解释：

<activity>：声明一个 Activity。
<intent-filter>：定义一个 Intent 过滤器，允许特定的 Intent 启动此 Activity。
<action>：指定该 Intent 的动作，这里是 VIEW，用于查看数据。
<category>：定义此 Intent 的类别，DEFAULT 和 BROWSABLE 是必要的。BROWSABLE 让链接可以通过浏览器打开。
<data>：这里定义了 Deep Link 的具体格式，包括 android:scheme、android:host 和 android:pathPrefix。

第2步：处理 Intent

接下来，在 MyActivity 中处理从 Deep Link 传递过来的 Intent。代码示例如下：

public class MyActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);

        // 获取 Intent
        Intent intent = getIntent();
        Uri data = intent.getData();

        // 处理 Deep Link
        if (data != null) {
            String contentId = data.getLastPathSegment(); // 获取内容 ID
            displayContent(contentId); // 利用内容 ID 加载相应内容
        }
    }

    private void displayContent(String contentId) {
        // 这里可以添加代码来展示与 contentId 相关的内容
        TextView textView = findViewById(R.id.textView);
        textView.setText("Displaying content for ID: " + contentId);
    }
}

代码解释：

getIntent()：获取当前 Activity 的 Intent。
getData()：从 Intent 中提取传入的数据 URI。
getLastPathSegment()：获取 URI 中的最后一部分作为内容 ID。
displayContent(contentId)：调用自定义方法，利用内容 ID 加载对应内容。

第3步：测试 Deep Link

可以使用 adb 命令测试 Deep Link。下面是命令示例：

adb shell am start -W -a android.intent.action.VIEW -d " com.example.myapp

代码解释：

adb shell am start：启动一个 Activity。
-a android.intent.action.VIEW：指定 Intent 动作。
-d：后面跟 Deep Link URL。
com.example.myapp：指定需要启动的应用包名。

流程图

用序列图表示整个流程，如下所示：

sequenceDiagram
    participant User as 用户
    participant Browser as 浏览器
    participant App as 应用
    User->>Browser: 点击链接
    Browser->>App: 发送 Deep Link Intent
    App->>App: 处理 Intent
    App->>User: 显示相应内容

项目计划

使用甘特图来展示整个项目的进度，如下所示：

gantt
    title Android Deep Link 实现流程
    dateFormat  YYYY-MM-DD
    section 准备工作
    配置 AndroidManifest.xml   :done,    des1, 2023-10-01, 1d
    处理 Intent               :done,    des2, 2023-10-02, 1d
    测试 Deep Link             :active,  des3, 2023-10-03, 1d