Android Kotlin - 通过 URL Scheme 打开应用

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

1. 配置 AndroidManifest.xml

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

xml 复制代码
<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 将会是:

bash 复制代码
myapp://example/open

4. 在代码中处理 URL

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

kotlin 复制代码
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 的行为:

bash 复制代码
adb shell am start -a android.intent.action.VIEW -d "myapp://example/open"
使用 HTML 链接

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

html 复制代码
<a href="myapp://example/open">Open My App</a>

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

在 Android 应用中使用

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

kotlin 复制代码
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 来打开你的应用并执行相应的操作。

感谢阅读

相关推荐
吃我一窝jio11 分钟前
Python与Go线程模型深度对比
java·开发语言·python
eggwyw35 分钟前
C++ union 的一种妙用法
开发语言·c++
starzy19903 小时前
深入理解Scala隐式函数:自动类型转换
开发语言·后端·scala
布莱克6055 小时前
Swift 循环与控制转移详解:从 for-in 到标签跳转
开发语言·ssh·swift·循环
二流小码农5 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
敲上瘾5 小时前
Qt核心机制:信号与槽详解
开发语言·c++·qt·ui·qt6.3
联犀6 小时前
ai时代复杂项目的golang项目如何更好的与ai共舞:monorepo+gozero
开发语言·人工智能·golang
阿杰m7 小时前
Android源码第十七章:PowerManager 与后台任务——锁屏后怎么跑?
android
JMchen1237 小时前
【Android 性能优化实战 60 讲】10 Jetpack App Startup 内核魔改:手写异步懒加载启动框架,根治串行初始化耗时
android·性能优化·源码分析·启动优化·kotlin协程·app startup
2601_967980117 小时前
python+appium自动化测试如何控制App的启动和退出
android·自动化测试·python·appium·设备调试