Web Apps 的火地崩溃器 - 设置指南
[大 Web Apps 的崩溃程序正在使用中 私密预览 仅供已注册的EAP(早期访问方案)客户使用。 尚未入学的,请填写 注册表单 在配置应用程序之前请求访问.
并分享你的反馈!
崩溃分析 Next.js, React, Angular, React 路由器和 TanStack 路由器应用程序 包括客户端错误报告,去微缩堆栈痕迹,以及火地崩溃控制台的专用仪表板.
用于网络应用的Crashlytics使用Cloud Digging进行遥测存储并使用Cloud存储在引擎盖下进行源图存储,这些是付费产品,具有宽大的免费分级. 学习更多关于 伐木定价 财务报告和审定财务报表 储存定价。 。 。 .
作为一个私人的预览客户,你的经验对我们团队来说是非常宝贵的. 请通过电子邮件直接向我们的团队提交错误、 API 反馈或特性请求 崩盘- [email protected] 或填写此选项 反馈表单。 。 。 .
目录
代理设置提示
你可以叫你的编码代理 为你做一切! 使用下面的样本提示为您的网络应用自动设置 Crashlytics .
当您将此复制到您的编码代理中时, 请在运行前确保做到以下操作 :
- 填写正确的
apiKey财务报告和审定财务报表appId用于您的网络应用程序firebaseConfig,可见于 设置 > 常规。 。 。 . 说明: 假设您已经用网络应用程序创建了一个 Firebase 项目 . - 将您的编码代理指向 GitHub README 文件
packages/crashlytics/。 。 。 .
I would like to set up the Crashlytics JS SDK to my app. My firebase app config is as follows:
const firebaseConfig = {
apiKey: "<YOUR_FIREBASE_API_KEY>",
authDomain: "YOUR_PROJECT_NAME.firebaseapp.com",
projectId: "YOUR_PROJECT_NAME",
storageBucket: "YOUR_PROJECT_NAME.firebasestorage.app",
appId: "<YOUR_FIREBASE_APP_ID>"
};
Follow the instructions in the Firebase Crashlytics Web Setup Guide GitHub READMEs for setting up the Crashlytics Web SDK. Start with the Cloud Project Setup (using the Firebase CLI), initialize the SDK, and then follow the Setup Guide for my app’s framework to enable automatic error collection. Do not set up programmatic error capturing for this project. Replace any of the "<SOME_VARIABLE>" values in the instructions with the appropriate values based on my Firebase app config above. Also make sure to set up source map uploading for stack trace de-obfuscation. If you encounter any issues during the setup process, please ask me and I can assist you further. Ensure that you have the necessary permissions to access the Firebase project and that you have the Firebase CLI installed and configured on your machine, logged in as me (ask me to log in on your behalf).
步骤1:配置防火基地/云层项目
用于网络杠杆的崩溃分析 Google Cloud Loging, Error Reporting, 并存储在引擎盖下. 您可以使用Firebase Console(推荐)或Firebase CLI(特别是在使用编码代理时有用)自动配置您的工程.
[注] 如果您来自一个已有的 Google Cloud 工程, 并且之前没有使用过 Firebase 工程, 在开始项目设置之前, 您必须接受 Firebase Console 的 Firebase 服务条款 .
备选案文1:使用火地站(建议)
- 导航到 Firebase 控制台崩溃页面。 。 。 .
- 选择您的项目 .
- 点击 设置 跟着控制台的台阶走.
备选案文2:使用火基地CLI
如果您喜欢通过终端配置您的项目或使用AI编码代理,则运行以下命令:
firebase crashlytics:setup <YOUR_FIREBASE_APP_ID> --project <YOUR_FIREBASE_PROJECT_ID>
[注] 先决条件: 要求 火基地CLI v15.34.2或以后,所有者/编辑器项目许可,并启用了烈火计费. 认证: 确保您得到认证并使用正确的工程:
firebase login firebase use <YOUR_FIREBASE_PROJECT_ID>自动设置: 此命令自动启用所需的遥测 API(
clienttelemetry.googleapis.com, (中文(简体) ),firebasetelemetry.googleapis.com, (中文(简体) ),firebasetelemetryadmin.googleapis.com,以及firebasecrashlytics.googleapis.com,更新 API 密钥限制clienttelemetry.googleapis.com(如果有限制)firebase-telemetryCloud 日志桶和路由槽, 配置您的网络应用程序的遥测设置, 并选择为新问题和后退问题设置电子邮件提醒 .
第2步:核心SDK安装和初始化
在配置框架特定集成之前,完成核心包安装和Firebase App单通设置:
安装软件包
安装防火基地 JS SDK:
npm install firebase
初始化火基地 App Singleton
创建中央配置工具文件( C)src/lib/firebase.ts)使用在Firebase Console中发现的证书 设置 > 常规. 手动跟踪器和框架接口利用已初始化 FirebaseApp 举个例子.
// src/lib/firebase.ts
import { initializeApp, getApps, getApp } from 'firebase/app';
const firebaseConfig = {
apiKey: "<YOUR_FIREBASE_API_KEY>",
authDomain: "<YOUR_AUTH_DOMAIN>",
projectId: "<YOUR_FIREBASE_PROJECT_ID>",
storageBucket: "<YOUR_STORAGE_BUCKET>",
messagingSenderId: "<YOUR_MESSAGING_SENDER_ID>",
appId: "<YOUR_FIREBASE_APP_ID>"
};
// Guarantee singleton initialization
export const app = getApps().length === 0
? initializeApp(firebaseConfig)
: getApp();
第3步:框架特定设置指南
[大 确定你已经完成 步骤1(配置防火基地/云层项目) 财务报告和审定财务报表 步骤2( 核心 SDK 安装和初始化) 开始使用下面的框架设置指南!
选择匹配您的应用程序框架的指南 :
- 🅰️ 角设置指南
- ⚛️ 反应设置指南
- 🛣️ 反应路由器设置指南
- 🌼 TanStack 路由器设置指南
- 🔺 Next.js 设置指南
步骤 4: 强制初始崩溃
为了验证您的设置是否有效, 并且撞车是否被妥善交付给 Firebase Crashlytics, 您可以在您的应用程序中强制进行测试崩溃 .
为确保崩溃是按要求被触发的(并且不会阻断应用程序启动或服务器侧构建失败),在您的应用程序中,在用户交互处理器(例如点击处理器或事件倾听器)中添加以下一行:
throw new Error("Test Crash");
校验控制台的崩溃
- 运行您的应用程序并通过执行动作(例如点击测试按钮)来触发崩溃.
- 打开 Firebase 控制台崩溃仪表板。 。 。 .
- 选择您查看新登录的崩溃报告的项目 .
[注] 新的坠机报告可能要花几分钟时间才能出现在"火地崩溃"控制台上.
与 AI 代理调试
AI编码代理可以帮助在您开发环境中直接诊断和解决网络崩溃.
MCP 工具 (crashlytics:connect(中文(简体) )
崩溃分析提供 示范背景协议(MCP) 工具可以让代理查询崩溃数据——包括问题、报告组、事件有效载荷和堆放痕迹——而无需手工复制.
crashlytics:connect提示:一个引导性互动工作流程,该工作流程优先处理顶级问题,针对您本地代码库调查已解析的源图,并帮助代理起草修正. 学习更多在 人工智能协助编制MCP文件。 。 。 .
REST API 和 Web 浏览器元数据
你和你的探员也可以按程序查询 Firebase Crashlytics RIST API 数据库崩溃分析软件。 。 。 .
网页出错事件及报告组曝光特定浏览器遥测维度 帮助识别平台异常:
| 外地 | 说明 | 示例 |
|---|---|---|
browser.platform | 客户端 OS / 平台架构 | "macintosh", (中文(简体) ), "windows", (中文(简体) ), "linux" |
user_agent.name | 浏览器客户端应用程序名称 | "chrome", (中文(简体) ), "firefox", (中文(简体) ), "safari", (中文(简体) ), "edge" |
user_agent.version | 浏览器客户端的主要/ 小版本 | "150" |
user_agent.original | 来自客户端请求的 Raw 用户代理字符串 | "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)..." |
附加配置参考文件( T)
关于高级使用选项和项目配置细节,请参考以下指南: