Android Kotlin - 通过 URL Scheme 打开应用

在 Android 应用中，可以通过自定义 URL Scheme 或 Deep Links 打开应用。这允许你定义一个自定义的 URL 格式，使得当用户点击包含这个 URL 的链接时，系统可以识别并打开你的 APP。以下是详细的实现步骤和一些注意事项。

1. 配置 AndroidManifest.xml

首先，你需要在 AndroidManifest.xml 中为你想要处理的 Activity 添加一个 intent-filter，这样当用户点击特定的链接时，你的应用程序就会启动。

<activity android:name=".YourActivity">
 <intent-filter>
     <action android:name="android.intent.action.VIEW" />

     <category android:name="android.intent.category.DEFAULT" />
     <category android:name="android.intent.category.BROWSABLE" />

     <!-- 自定义URL scheme -->
     <data
         android:scheme="myapp"
         android:host="example"
         android:pathPrefix="/open" />
 </intent-filter>
</activity>

2. 参数说明

• android:scheme：这是你自定义的 scheme 名称，类似于 http 或 https。你可以设置为任何唯一的值，比如 myapp。
• android:host：这是你的域名或标识符。可以是你应用的名字或相关的词汇，例如 example。
• android:pathPrefix：这是 URL 中的路径前缀。它可以指定一个具体的路径，例如 /open，这样只有匹配这个路径的 URL 才会触发 APP 的打开。

3. 完整的 URL 示例

根据上述配置，假设你配置的 scheme 是 myapp，host 是 example，pathPrefix 是 /open，那么可以打开你的 APP 的 URL 将会是：

myapp://example/open

4. 在代码中处理 URL

当你的 APP 通过这个 URL scheme 打开时，你可以在 Activity 中通过 intent 获取传递的数据：

val intent: Intent = intent
val data: Uri = intent.data

data?.let {
val scheme = it.scheme // "myapp"
val host = it.host // "example"
val path = it.path // "/open"
// 处理接收到的URL
}

5. 测试自定义 URL Scheme

在浏览器的地址栏中输入自定义 URL scheme 链接时，通常情况下，浏览器会尝试将其作为搜索关键词处理，而不是直接打开你的应用。为了正确测试自定义 URL scheme，可以尝试以下几种方法：

使用命令行工具

你可以使用 adb 命令直接发送一个 Intent 到你的应用，模拟点击自定义 URL scheme 的行为：

adb shell am start -a android.intent.action.VIEW -d "myapp://example/open"

使用 HTML 链接

在一个 HTML 文件中创建一个链接，点击该链接将会触发自定义 URL scheme：

<a href="myapp://example/open">Open My App</a>

你可以把这个 HTML 文件加载到浏览器中，然后点击链接，这样就可以触发你的应用。

在 Android 应用中使用

如果你需要在 Android 应用内测试，可以在应用中使用如下代码来触发自定义 URL scheme：

val intent = Intent(Intent.ACTION_VIEW, Uri.parse("myapp://example/open"))
startActivity(intent)

6. 使用深度链接（Deep Links）和应用链接（App Links）

对于更广泛的应用，建议使用 Android 的深度链接（Deep Links）或应用链接（App Links）。App Links 可以直接在浏览器中点击链接打开应用，而不需要用户进行额外操作。你可以通过将 .well-known/assetlinks.json 文件配置在你的域名下来实现。

7. 注意事项

• iOS 用户体验差异： 自定义 URL scheme 在 iOS 中的行为可能会有所不同，特别是在浏览器和不同的应用中。
• 调试工具的使用： 使用 Android Studio 中的 Deep Links 测试工具，可以直接测试和调试你的深度链接设置。

通过这些方法，你可以成功测试和使用自定义的 URL scheme 来打开你的应用并执行相应的操作。

感谢阅读