UUID API
通过附加到 WebView URL 或经由 JavaScript 获取的唯一 UUID 来识别应用安装。
WebViewGold UUID API 允许您通过 JavaScript 获取一个非个人化的唯一设备 ID（UUID，即 "Universally Unique Identifier"，通用唯一标识符），它可以唯一标识一台 Android 设备。此功能在以下场景中很有帮助：
- 在服务器上存储用户专属设置
- 维护会话状态
- 在客户端调用已保存的数据
隐私注意事项：由于此功能涉及设备识别，请确保在使用时遵守当地及国际的隐私法律法规。
如何获取 UUID：
要从基于 WebView 的应用中获取 UUID，请使用以下代码：
<a href="get-uuid://">Get UUID</a>
<a href="#" onClick="alert(uuid);">Show UUID</a>
- Get UUID：向 WebViewGold 请求 UUID。
- Show UUID：通过 alert 弹窗显示 UUID，便于测试。
备选方法：将 UUID 追加到 WebView URL 中
如果您希望将 UUID 包含在 URL 参数中，请在 Config.java 中将 UUID_ENHANCE_WEBVIEW_URL 选项设置为 true。这样，在首次请求时会自动将 uuid=XYZ 追加到您的 WebView URL 上，使您可以直接在网页内容中访问 UUID：
- 示例：如果您的 WebView URL 为
https://www.example.org，则它将以https://www.example.org?uuid=XYZ的形式发起请求。 - 注意：只有首次 URL 请求会包含此 GET 参数，因此如果您需要稍后在应用中引用它，请考虑将其保存到会话或 cookie 中。
自动将 UUID 注入 JavaScript：
要在所有页面中自动使 UUID（以及其他变量）在 JavaScript 中可用，而无需修改 URL，请在 Config.java 中将 AUTO_INJECT_VARIABLES 设置为 true。这样您就可以在任何页面中直接访问 UUID 及其他值。
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 用户提供原生应用外壳。