本教程详细介绍了如何在android webview应用中实现深度链接，使得通过whatsapp等应用分享的特定url能够直接在您的应用内打开，而非默认的浏览器。核心在于通过配置`androidmanifest.xml`中的`intent-filter`，声明应用能够处理特定scheme和host的url，从而实现无缝的用户体验和内容直达。
在Android应用开发中，尤其当应用包含WebView并展示网页内容时，一个常见的需求是实现深度链接（Deep Link）。这意味着当用户点击一个指向您应用特定内容的URL时，不是在外部浏览器中打开该URL，而是直接在您的应用内部启动并导航到相应内容。这对于提供流畅的用户体验至关重要，特别是在通过消息应用（如WhatsApp）分享链接的场景下。
理解外部链接与应用内打开的挑战
通常情况下，当用户点击一个URL时，Android系统会尝试使用默认的浏览器应用打开它。对于一个基于WebView的应用，即使这个URL指向的是应用内部WebView所加载的网站，系统也无法识别并自动在应用内打开。这就导致了用户体验的断裂：用户从一个应用跳转到浏览器，而不是直接回到或进入到提供该内容的源应用。
原有的分享机制，例如通过JavaScript调用Android原生分享接口（Intent.ACTION_SEND），虽然能够成功分享包含URL的文本内容，但它仅仅是将URL作为纯文本传递。当接收方点击这个URL时，系统仍然会根据其默认行为，将其视为一个普通的网页链接，从而在浏览器中打开。
解决方案核心：Android Intent Filter与深度链接
要解决这个问题，关键在于利用Android的Intent Filter机制。Intent Filter是AndroidManifest.xml文件中声明组件（如Activity、Service、Broadcast Receiver）能够响应特定Intent的一种方式。通过为您的Activity配置一个特殊的intent-filter，您可以告诉Android系统，您的应用能够处理特定类型的URL。当系统检测到用户点击的URL符合您定义的intent-filter模式时，它将提供一个选项（或直接）在您的应用中打开该URL。
这种机制就是所谓的“深度链接”（Deep Linking），它允许URL直接链接到应用内的特定内容，极大地提升了用户体验。
实现步骤
步骤一：配置AndroidManifest.xml
您需要在希望处理深度链接的Activity的AndroidManifest.xml文件中添加一个intent-filter。这个intent-filter将声明您的应用能够响应ACTION_VIEW类型的Intent，并且能够处理特定的URI数据。
<activity android:name=".MainActivity"
android:exported="true"> <!-- Android 12+ 要求为处理外部链接的Activity设置 exported="true" -->
<!-- 原有的主入口Intent Filter -->
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
<!-- 用于处理深度链接的Intent Filter -->
<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="tcg-wallet.ga" />
<!--
- android:scheme: 指定URL的协议部分，例如 "http" 或 "https"。
- android:host: 指定URL的主机名部分，例如 "tcg-wallet.ga"。
- 您可以添加多个 <data> 标签来处理不同的scheme或host。
- 还可以使用 android:pathPrefix, android:pathPattern, android:port 等属性来进一步细化匹配规则。
-->
</intent-filter>
</activity>关键属性解释：
: 表明此Activity可以显示指定URI的数据。这是处理深度链接的必要Action。 gory android:name="android.intent.category.DEFAULT" /> : 允许Activity接收不带特定Category的隐式Intent。这是系统默认行为，确保Activity能被发现。: 允许Activity被Web浏览器调用，以显示链接。这是使链接能够从浏览器或消息应用（如WhatsApp）中启动应用的关键。 -
: 这是URI匹配的核心。
- android:scheme="https": 告诉系统，此应用可以处理使用HTTPS协议的链接。
- android:host="tcg-wallet.ga": 告诉系统，此应用可以处理主机名为tcg-wallet.ga的链接。
- 当用户点击一个https://tcg-wallet.ga/...形式的链接时，系统就会知道您的应用可以处理它。
android:exported="true": 从Android 12 (API level 31) 开始，如果Activity包含intent-filter并且可能被其他应用启动（例如通过深度链接），则必须显式设置android:exported="true"。否则，应用可能会在运行时崩溃。
步骤二：在Activity中处理传入的URL数据
一旦您的应用被配置为处理特定URL，当用户点击匹配的链接时，相应的Activity将被启动（如果应用未运行）或被带到前台（如果应用已在运行），并且包含该URL的Intent将传递给它。您需要在Activity的onCreate()或onNewIntent()方法中获取并处理这个URL。
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
// 假设您有一个WebView实例
// private WebView webView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main); // 您的布局文件
// 初始化WebView等UI组件
// webView = findViewById(R.id.my_webview);
// webView.setWebViewClient(new WebViewClient()); // 配置WebViewClient
// 处理首次启动Activity时的Intent
handleIntent(getIntent());
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
// 当Activity已经在运行，但通过新的Intent启动时调用（例如，用户再次点击深度链接）
setIntent(intent); // 更新Activity的Intent
handleIntent(intent);
}
private void handleIntent(Intent intent) {
String action = intent.getAction();
Uri data = intent.getData(); // 获取传入的URI数据
if (Intent.ACTION_VIEW.equals(action) && data != null) {
// 此时，data就是被点击的URL，例如：https://tcg-wallet.ga/home?search=MP21-EN056&event=search
String scheme = data.getScheme(); // "https"
String host = data.getHost(); // "tcg-wallet.ga"
String path = data.getPath(); // "/home" 或其他路径
String query = data.getQuery(); // "search=MP21-EN056&event=search"
// 根据解析出的URL信息，在WebView中加载相应内容或执行其他逻辑
if (host != null && host.equals("tcg-wallet.ga")) {
// 示例：获取查询参数
String searchTerm = data.getQueryParameter("search");
if (searchTerm != null) {
// Log.d("DeepLink", "深度链接触发，搜索词: " + searchTerm);
// 例如，在WebView中加载带有特定搜索词的URL
// if (webView != null) {
// webView.loadUrl("https://tcg-wallet.ga/home?search=" + searchTerm);
// }
// 或者调用WebView的JavaScript接口来处理
// webView.evaluateJavascript("javascript:handleDeepLinkSearch('" + searchTerm + "')", null);
} else {
// 如果没有特定参数，加载完整的URL
// if (webView != null) {
// webView.loadUrl(data.toString());
// }
}
}
}
}
}在handleIntent方法中，您可以通过intent.getData()获取到完整的URI对象。然后，您可以解析这个URI，提取出协议（scheme）、主机（host）、路径（path）以及查询参数（query parameters），并根据这些信息在您的WebView中加载相应的页面或执行特定的应用内逻辑。
步骤三：现有分享逻辑的整合（无须修改）
您原有的分享逻辑，无论是通过JavaScript的navigator.share接口，还是通过JavascriptInterface将数据传递给Android原生代码，并使用Intent.ACTION_SEND来分享文本内容（包括URL），都不需要为实现深度链接的接收功能而修改。
// 原有的Android原生分享代码示例
@JavascriptInterface
public void shareSearch(String javascript_data) {
try {
JSONObject search = new JSONObject(javascript_data);
String title = search.getString("title");
String text = search.getString("text");
String url = search.getString("url");
String content = title + "\n" + text + "\n\n" + url;
Intent sendIntent = new Intent(Intent.ACTION_SEND);
sendIntent.setType("text/plain");
sendIntent.putExtra(Intent.EXTRA_TEXT, content);
app_context.startActivity(Intent.createChooser(sendIntent, "分享链接"));
} catch (Exception ex) {
// 错误处理
}
}这段代码的目的是将URL作为文本内容发送出去。一旦这个URL被发送并被用户点击，系统将根据您在AndroidManifest.xml中配置的intent-filter来决定是在浏览器中打开，还是在您的应用中打开。因此，这个分享功能和深度链接的接收功能是相互独立的，可以并行工作。
注意事项
- 唯一性与冲突解决： 确保您选择的scheme和host组合尽可能独特，以避免与其他应用或系统默认行为产生冲突。如果多个应用注册了相同的深度链接模式，系统会弹出一个选择器让用户选择打开方式。
- 测试全面性： 在不同品牌的Android设备、不同Android版本（尤其是Android 12+的exported属性要求）以及不同的消息应用（WhatsApp、Telegram、微信等）中进行充分测试，以确保深度链接按预期工作。
- 回退机制： 确保如果用户尚未安装您的应用，点击深度链接时，链接仍然能够在浏览器中正常打开，并引导用户下载您的应用（如果适用）。
- 安全性： 当从深度链接接收数据时，始终验证传入数据的合法性和安全性，以防止潜在的注入攻击或其他恶意行为。
- 用户体验： 深度链接应该将用户带到应用内最相关的页面或内容，而不是仅仅打开应用的首页。
总结
通过在AndroidManifest.xml中精心配置intent-filter，您的Android WebView应用可以轻松实现深度链接功能。这不仅能够将通过外部应用（如WhatsApp）分享的特定URL直接在应用内打开，显著提升用户体验，还能使您的应用内容更容易被用户发现和访问。理解并正确实施intent-filter是构建现代Android应用不可或缺的一部分，它为应用提供了更强大的内容导航能力。
