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 名称,类似于 httphttps。你可以设置为任何唯一的值,比如 myapp
  • android:host:这是你的域名或标识符。可以是你应用的名字或相关的词汇,例如 example
  • android:pathPrefix:这是 URL 中的路径前缀。它可以指定一个具体的路径,例如 /open,这样只有匹配这个路径的 URL 才会触发 APP 的打开。
3. 完整的 URL 示例

根据上述配置,假设你配置的 schememyapphostexamplepathPrefix/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 来打开你的应用并执行相应的操作。

感谢阅读

相关推荐
Ronin30527 分钟前
【C++】类型转换
开发语言·c++
mrbone1143 分钟前
Git-git worktree的使用
开发语言·c++·git·cmake·worktree·gitab
小蜜蜂嗡嗡1 小时前
Android Studio flutter项目运行、打包时间太长
android·flutter·android studio
aqi001 小时前
FFmpeg开发笔记(七十一)使用国产的QPlayer2实现双播放器观看视频
android·ffmpeg·音视频·流媒体
浪裡遊1 小时前
Sass详解:功能特性、常用方法与最佳实践
开发语言·前端·javascript·css·vue.js·rust·sass
真实的菜1 小时前
JVM类加载系统详解:深入理解Java类的生命周期
java·开发语言·jvm
代码讲故事1 小时前
多种方法实现golang中实现对http的响应内容生成图片
开发语言·chrome·http·golang·图片·快照·截图
虾球xz2 小时前
CppCon 2018 学习:EFFECTIVE REPLACEMENT OF DYNAMIC POLYMORPHISM WITH std::variant
开发语言·c++·学习
Allen_LVyingbo2 小时前
Python常用医疗AI库以及案例解析(2025年版、上)
开发语言·人工智能·python·学习·健康医疗
小哈龙2 小时前
裸仓库 + Git Bash 搭建 本地 Git 服务端与客户端
开发语言·git·bash