Firebase Crashlytics
Ship crash reports and non-fatal events to your Firebase project, with runtime opt-in / opt-out from your web app.
Firebase Crashlytics 集成会将匿名崩溃报告和非致命事件发送到您的 Firebase 项目,从而帮助您发现生产环境中的稳定性问题。
如何启用:
- 为您的应用设置 Firebase,并将
google-services.json放到AndroidStudioSourceCode/app/中。 - 在 Config.java 中启用跟踪:
public static final boolean TRACKING_EVENT = true;
TRACKING_EVENT = false 会禁用所有与跟踪相关的功能,包括 Crashlytics 事件日志记录以及 starttracking:// / endtracking:// 触发器。
从您的 Web 应用运行时选择加入/退出:
WebViewGold 会遵循持久保存在设备上的每用户跟踪标志。使用标准的跟踪触发器在运行时更改它:
<a href="starttracking://">Enable analytics & crash reports</a> <a href="endtracking://">Disable analytics & crash reports</a>
当用户选择退出时,Crashlytics 采集将被关闭 — 不会上传任何内容。
报告内容:
- 未处理的崩溃(堆栈跟踪、设备型号、操作系统版本)。
- 由应用外壳内部记录的非致命异常。
- 默认不附带任何个人用户数据。
查看报告的位置: 打开您的 Firebase 控制台 → Crashlytics 仪表板。报告通常会在崩溃后几分钟内出现。
说明: Crashlytics 初始化采用尽力而为策略 — 即使 Firebase 配置有误,应用仍能正常运行。请考虑在首次调用 starttracking:// 之前添加同意屏幕(GDPR / CCPA)。
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 用户提供原生应用外壳。