WebViewGold 文档 · Android
🇨🇳 中文
获取 WebViewGold

App Links 与深度链接 API

借助 App Links 和自定义 URL scheme 深度链接,将指向您域名的链接直接在 Android 应用中打开。

WebViewGold 的应用链接 (App Links) / 深度链接 API 让用户能够从电子邮件、社交媒体或消息应用等外部来源打开您应用中的特定页面。

适用于 Android 的 WebViewGold 支持两种深度链接方式:

  • 基于标准 URL 的深度链接: 例如 https://www.example.org/subpages/example1
  • 自定义 Scheme 深度链接: 例如 webviewgold://https://www.example.org/subpages/example2

步骤 1:在 AndroidManifest.xml 中配置链接 Scheme

若要支持标准深度链接,请配置您的 AndroidManifest.xml,以将您的域名与应用关联起来。请将 www.webviewgold.com 替换为您的实际域名(例如 www.example.org):

用于应用链接配置的 AndroidManifest.xml

步骤 2:在 Config.java 中启用深度链接

在您的 Config.java 文件中,启用深度链接功能:

// Enables standard deep linking (https:// links)
public static final boolean IS_DEEP_LINKING_ENABLED = true;

// Enables custom scheme deep linking (e.g., webviewgold://)
public static final boolean IS_CUSTOM_SCHEME_ENABLED = true;

// Set your desired scheme prefix (must match AndroidManifest.xml)
public static final String CUSTOM_DEEPLINK_SCHEME = "webviewgold";

用于应用链接配置的 Config.java

步骤 3:验证域名所有权(针对基于 URL 的深度链接)

若要使用 HTTPS URL 启用深度链接,您必须向 Google 验证域名所有权。请遵循 Google 网站验证指南

测试您的应用链接

您可以通过 Android Studio 或终端测试这两种类型的链接:

  • 使用 Android Studio:Tools 菜单打开 App Links Assistant,以进行模拟和排查故障。
  • 使用终端或命令提示符:
    1. 运行以下命令:
      adb shell am start -a android.intent.action.VIEW -d "webviewgold://https://www.example.org/subpages/example2" com.webviewgold.myappname
                      
      • 请将 com.webviewgold.myappname 替换为您的实际应用包名。
      • 您也可以使用类似 https://www.example.org/subpages/example1 的 URL 链接进行测试。

一切设置完成后,用户就可以使用如下深度链接直接打开您应用中的任意特定页面:

  • https://www.example.org/subpages/example1
  • webviewgold://https://www.example.org/subpages/example2


有疑问? 随时联系我们!

SDK 风格的实现说明

将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 Android 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for Android 以及其他 WebViewGold 平台。

为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。

  • 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
  • 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
  • SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 Android 用户提供原生应用外壳。

太忙了?我们替您搭建应用。

我们的团队为您配置、构建并提交 WebViewGold 应用——全程代劳、交付迅速、德国制造。

让我们搭建应用 →

在浏览器中构建

无需 Mac、无需 IDE:WebViewGold Cloud Builder 在线为您配置、构建并上传应用。

了解 Cloud Builder →