文件下载 API
让用户将图片、PDF 及其他文件从您的 Web 应用下载到 Android 设备。
WebViewGold 的 Download API 允许您在 WebView 应用中提供文档、图片和音频文件的下载。以下步骤介绍了如何启用和自定义下载器功能：
1. 下载图片：
通过调用带有 savethisimage://?url= 前缀的链接，将图片保存到用户的相机胶卷中：
<a href="savethisimage://?url=IMAGE URL HERE">Download Image</a>
2. 下载 PDF 文件：
通过调用带有 .pdf 后缀的链接来保存 PDF 文件：
<a href="https://www.example.org/file.pdf">Download PDF</a>
3. 下载音乐文件：
只需调用带有 .mp3、.mp4 或 .wav 后缀的链接即可保存音乐文件：
<a href="https://www.example.org/file.mp3">Download MP3</a> <a href="https://www.example.org/file.mp4">Download MP4</a> <a href="https://www.example.org/file.wav">Download WAV</a>
4. 自定义支持的文件类型：
要向下载器添加其他文件格式，请将它们插入到 Config.java 中的 downloadableExtension 列表内。
5. 启用自动文件下载：
可以考虑在 Config.java 中设置 AUTO_DOWNLOAD_FILES 选项，以便对带有 Content-Disposition HTTP 标头标记的文件启用自动下载，而不受 downloadableExtension 列表的限制。这可确保文件根据服务器配置自动下载。
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 用户提供原生应用外壳。