ShareIntent API
通过 Share Intent 在您的 WebView 应用中直接接收从其他 Android 应用分享的内容。
WebViewGold 的 ShareIntent API 让您的应用能够作为目标出现在 Android 的原生分享对话框中。这样,用户就可以将文本、URL 或图片(以 base64 字符串形式)等内容从任何其他应用直接分享到您基于 WebView 的应用中。
使用场景:
- 将指向用户个人资料、笔记或文章的链接直接分享到您的应用中
- 接收来自消息或浏览器应用的内容
- 将图库中的图片发送到您的 WebView 界面(base64 编码)
步骤 1:在 AndroidManifest.xml 中启用分享支持
若要让您的应用能够接收分享的数据,请取消您 AndroidManifest.xml 文件中相关 intent 过滤器的注释:
<!-- Receive shared text (e.g., URLs or notes) -->
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="text/plain" />
</intent-filter>
<!-- Receive a single shared image -->
<intent-filter>
<action android:name="android.intent.action.SEND" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="image/*" />
</intent-filter>
<!-- Receive multiple shared images -->
<intent-filter>
<action android:name="android.intent.action.SEND_MULTIPLE" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="image/*" />
</intent-filter>
这些过滤器生效后,每当用户从其他应用分享内容时,您基于 WebViewGold 的应用图标就会作为分享目标出现。
步骤 2:在 WebView 中处理分享的数据
当用户向您的应用分享内容时,WebViewGold 会自动将分享的内容注入到名为 sharedData 的 JavaScript 变量中。
<script>
alert(sharedData); // Displays the shared content (text or base64 image)
</script>
- 文本或 URL: 将作为纯文本传入
sharedData - 图片: 将被转换为 base64 编码的字符串并传入
sharedData
使用示例: 根据接收到的内容自动填充表单或预览图片:
<script>
if (sharedData) {
document.getElementById("myInput").value = sharedData;
}
</script>
注意: 请确保您的 JavaScript 已准备好同时处理纯文本和较长的 base64 字符串。您也可以实现客户端检查,以区分不同的内容类型。
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 用户提供原生应用外壳。