VueFire

外观

环境变量 ​

Nuxt VueFire 会自动从您的 .env 文件中获取一些环境变量来配置 Firebase。这些变量通常优先于在 nuxt.config.ts 中定义的其他选项。它们通常试图更好地支持现有的 Firebase 环境变量。

Admin SDK ​

在开发过程中，如果您正在进行 SSR，则必须提供 GOOGLE_APPLICATION_CREDENTIALS 环境变量，其中包含服务帐户文件的路径。这通常是一个 JSON 文件，您可以从 Firebase Console > 项目设置 > 服务帐户 > 生成新的私钥下载。

GOOGLE_APPLICATION_CREDENTIALS=service-account.json

确保将 .env 和 service-account.json 文件从您的版本控制系统中排除。此变量将在 Firebase 和 Google Cloud 部署中自动设置。

提示

当部署到除 Firebase 或 Google Cloud 之外的其他地方时，必须手动设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量。您可以将其设置为服务帐户文件的内容，而不是将其设置为服务帐户文件的路径。请注意，它必须放在一行中

GOOGLE_APPLICATION_CREDENTIALS='{"type":"service_account","project_id":"...","private_key_id":"...","private_key":"-----BEGIN PRIVATE KEY-----\n[redacted]\n-----END PRIVATE KEY-----\n"}'

AppCheck ​

如果您使用的是 AppCheck，则可以指定 FIREBASE_APPCHECK_DEBUG_TOKEN 环境变量以在开发中使用调试令牌。这在受保护的 CI 环境中很有用，或者如果您在机器上运行多个 Firebase 项目并且不想依赖本地调试令牌的生成。

FIREBASE_APPCHECK_DEBUG_TOKEN=********-****-****-****-************

这些可以在 Firebase Console > AppCheck > 应用 > 管理调试令牌中生成。

此变量不会在生产中使用，除非在构建或生成命令期间传递 debug: true。这使您可以在本地使用调试令牌进行测试，而无需担心意外将其部署到生产环境。

调试工具 ​

您可以在本地开发或构建时通过在运行命令之前设置它们来激活它们

bash
VUEFIRE_APPCHECK_DEBUG=true VUEFIRE_EMULATORS=true pnpm run build
  • VUEFIRE_APPCHECK_DEBUG=true 将即使在生产环境中也激活 AppCheck 调试。
  • VUEFIRE_EMULATORS=true 将即使在生产环境中也激活 Firebase 模拟器。