借助 Web Share Target，PWA 可以接收设备上安装的其他应用共享的内容。例如，图片编辑器等应用可以使用此功能从相机应用接收图片，社交网络可以使用此功能接收要分享的图片或视频。
从 Chrome 86 开始，Web Share Target 现在也适用于使用 Trusted Web Activity 的应用。虽然 PWA 应该可以直接运行，但需要对 Android 应用进行一些更改。
本文假定开发者熟悉 Trusted Web Activity。刚开始接触该技术的读者可以先参阅集成指南。
同样，本文不会详细介绍如何在 PWA 中实现 Web Share Target，开发者可以参阅这篇文章了解详情。
本文将使用 https://scrapbook-pwa.web.app/ 中的演示版应用作为 PWA，其源代码可在 GitHub 上找到，Android 应用基于基本可信 Web Activity 演示版。
将 Web Share Target 添加到 Android 应用
若要修改基于 Trusted Web Activity 的现有应用以实现 Web Share Target，您需要修改三个不同的文件：
build.gradle
android-browser-helper 库已更新，支持 Web Share Target。首先，请更新应用以使用高于或等于 2.0.1 的版本。
dependencies {
...
implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.2.0'
}
res/strings.xml
应用需要告知 Trusted Web Activity 它支持接收的分享的详细信息，例如要打开的网址、要使用的方法和支持的 MIME 类型。
这通过 JSON 完成，并通过字符串资源提供给可信 Web 活动。这些字段与网站清单中提供的 share_target 字段相同，并且几乎可以按原样添加到 strings.xml 中的字符串中，但有以下两点需要注意：
- action 属性的值必须是完整网址，包括来源。
- 必须转义双引号，因此每个
"都会变为\"。
https://scrapbook-pwa.web.app/manifest.json 的 share_target 部分如下所示：
{
...
"share_target": {
"action": "/_share-target",
"enctype": "multipart/form-data",
"method": "POST",
"params": {
"files": [{
"name": "media",
"accept": [
"audio/*",
"image/*",
"video/*"
]
}]
}
},
...
}
新的字符串元素将如下所示：
<string name="share_target">
{
\"action\": \"https://twa-web-scrapbook.web.app/_share-target\",
\"method\": \"POST\",
\"enctype\": \"multipart/form-data\",
\"params\": {
\"files\": [{
\"name\": \"media\",
\"accept\": [\"image/*\", \"audio/*\", \"video/*\"]
}]
}
}
</string>
AndroidManifest.xml
需要对 Android 清单进行一些更改。首先，我们需要确保 DelegationService 已声明、导出和启用。
如果开发者根据基本演示版构建了应用，则该服务已包含在内，并且标记应位于应用标记内，如下所示：
<service
android:name="com.google.androidbrowserhelper.trusted.DelegationService"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="android.support.customtabs.trusted.TRUSTED_WEB_ACTIVITY_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</service>
最后，需要向 LauncherActivity activity 标记添加两个新项：
- 引用 strings.xml 中定义的 JSON 的 meta-data 标记。
- 一个 intent-filter，用于向设备上的其他应用声明应用能够处理哪些 MIME 类型。
<meta-data
android:name="android.support.customtabs.trusted.METADATA_SHARE_TARGET"
android:resource="@string/share_target"/>
<intent-filter>
<action android:name="android.intent.action.SEND" />
<action android:name="android.intent.action.SEND_MULTIPLE" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="audio/*" />
<data android:mimeType="image/*" />
<data android:mimeType="video/*" />
</intent-filter>
如上所示的标记中所示，应为 share_target JSON 中声明的每个 mime-type 添加一个 data 元素。
总结
借助 Web Share Target 集成，Trusted Web Activity 中的 PWA 可以与 Android 设备上安装的其他应用进行更深入的集成。
如上文所述，android-browser-helper 简化了在使用可信 Web Activity 的现有 Android 应用中添加对该 API 的支持所需的额外标记。
如需详细了解如何在 PWA 中使用该 API，请参阅 “Web Share Target”一文；如需了解如何从渐进式 Web 应用分享内容，请参阅 Web Share API。
问题排查
当我尝试通过其他应用共享文件时，我的应用未显示为选项。
如果应用未显示为选项，则表示 intent-filter 不正确。仔细检查 intent-filter 标记，确保其中包含应用处理的正确操作、类别和 mime-types。
我的应用显示为选项，PWA 已启动，但数据未分享。
导致这种情况的原因有多种。以下是需要检查的核对清单：
- 确保 Digital Asset Links 验证成功。
- 检查 strings.xml 中的 JSON 是否正确无误。