Android Studio 中的 App Links Assistant：开发者指南

对于要构建适用于 App Connect 和应用互动广告系列的 Android 应用的开发者来说，确保深层链接已正确实现并经过验证至关重要。Android Studio 作为 Android 的官方集成开发环境 (IDE)，提供一个名为 App Links Assistant 的专用工具。该工具可简化深层链接的创建、测试和问题排查流程，尤其适用于 Android 清单配置和必要的网站关联文件 (assetlinks.json)。

本文详细介绍了如何使用 App Links Assistant 来确保应用的深层链接稳健且可用。

使用 App Links Assistant 的优势

更高的准确性和效率：帮助您减少在配置 intent 过滤器和 assetlinks.json 文件时的人为错误，并自动执行部分验证和修复流程。
全面检查：帮助您根据 Android 平台对深层链接和应用链接的要求进行验证。
集中管理：在 Android Studio 内提供统一界面，便于监督和管理应用的深层链接设置。

App Links Assistant 的工作原理

App Links Assistant 是 Android Studio 中的内置插件，旨在简化 Android 应用的深层链接实现流程。它可帮助您同时管理应用端配置（位于 AndroidManifest.xml 文件中）和网站端验证（assetlinks.json 文件），确保深层链接能够正常运行，尤其是使用 http 和 https 协议的 Android 应用链接。

App Links Assistant 的主要功能

App Links Assistant 提供多种功能，可帮助您管理和验证深层链接：

检测现有深层链接：该工具会扫描应用的 AndroidManifest.xml 文件，并以表格形式列出检测到的所有深层链接模式（配置为处理网址的 intent 过滤器）。这样您就可以快速了解通过网址进入应用的所有入口点。
验证 Android 清单配置（应用检查）：自动分析检测到的每个深层链接，以查找清单文件中的常见配置问题。包括：
- 是否存在必需的<data>代码属性，例如 android:scheme、android:host
- 是否进行了正确的 intent 操作，如 ACTION_VIEW
- 是否具备必要的类别，例如 BROWSABLE、DEFAULT
- Android 应用链接是否设置了 autoVerify="true" 属性
修复清单问题：对于许多常见的清单配置错误，App Links Assistant 会提供“Fix”按钮，可自动修复 AndroidManifest.xml 文件中的问题。如果问题无法自动修复，App Links Assistant 会引导您前往清单的相关部分，以便手动修复。
验证网站关联 (assetlinks.json)（网站检查）：App Links Assistant 可帮助验证您的网站是否已正确设置与应用的关联，这是 Android App Links (http/https 网址) 的关键步骤。检查内容包括：
- 文件存在与位置：确保 assetlinks.json 文件位于 https://your-domain.name/.well-known/assetlinks.json。
- HTTPS 可访问性：确认文件可通过安全的 HTTPS 连接访问。
- JSON 有效性和内容：验证 assetlinks.json 文件格式是否正确，是否包含正确的语句，包括应用的 package_name 和 sha256_cert_fingerprints。
- 内容类型标头：检查服务器提供的文件内容类型是否为 application/json。
- 无重定向：确保文件可直接访问，且不存在任何 HTTP 301 或 302 重定向。
生成和管理 assetlinks.json 文件：
- 生成：如果您没有 assetlinks.json 文件，或者您的文件格式不正确，App Links Assistant 可帮助您生成格式正确的文件。
- 对比视图：查看现有（已获取）assetlinks.json 文件与修复后或新生成版本的对比，以便轻松查看需要进行哪些更改。
- 下载：可直接从 App Links Assistant 下载更正后的 assetlinks.json 文件，方便上传到 Web 服务器。

如何使用 App Links Assistant

以下是使用 App Links Assistant 的通用流程，具体步骤可能会因任务不同而有所差异。

在 Android Studio 中，前往 View。
选择 Tool Windows，然后点击 App Links Assistant 或 Tools。
选择 App Links Assistant。
查看检测到的深层链接。
- App Links Assistant 会显示在项目清单中检测到的所有深层链接。
运行应用检查。
- 启动针对 Android 清单配置的验证。查看报告的错误或警告。
解决清单文件中存在的问题。
- 使用“Fix”选项进行自动修复，或根据指引手动修改清单文件。
运行针对 Android App Links 的网站检查。
- 针对 http/https 链接，启动 Web 关联验证。App Links Assistant 会尝试从清单文件中指定的网域获取并分析 assetlinks.json 文件。
查看网站检查结果。
- 解决所有已报告的问题，例如 assetlinks.json 文件的内容、托管或无障碍功能方面的问题。
生成或更新 assetlinks.json 文件。
- 如果需要，可使用 App Links Assistant 生成新的 assetlinks.json 文件，或对比并下载更新版本，然后将此文件上传至所有相关网域中的 /.well-known/ 目录。
重新验证。
- 修改清单文件或 assetlinks.json 文件后，在 App Links Assistant 中重新运行检查，确保所有问题均已解决。