google-services.json 配置指南¶
来源：非凡包网产品说明文档 更新日期：2026-04-12 用途：指导如何在 Firebase 控制台创建项目并获取 google-services.json 文件，用于非凡包网 APK 智能封装
概述¶
google-services.json 是 Firebase 为 Android 应用生成的配置文件，包含项目 ID、API 密钥、应用 ID 等信息。非凡包网的 APK 智能封装平台需要此文件来集成 Firebase 推送（FCM）等功能。
配置步骤¶
第 1 步：创建 Firebase 项目¶
- 打开浏览器，访问 Firebase 控制台
- 点击 创建项目（首次使用需登录 Google 账号）
第 2 步：输入项目名称¶
- 项目名称：输入项目名（例如
happy game） - Firebase 会自动生成唯一的项目 ID（例如
happy-game-4c6cb） - 如果有"是否启用 Google Analytics"的提示，先保持默认
- 点击 继续，直到进入 Firebase 项目概览页面
第 3 步：配置 Google Analytics¶
- 在配置页面中，选择或创建 Google Analytics 账号
- 建议选择：Default Account for Firebase（没有就选"创建新账号"）
- 确认后点击 创建项目，等待初始化完成
第 4 步：添加 Android 应用¶
- 在 Firebase 项目概览页面，找到 "+ 添加应用" 按钮
- 点击 Android 图标
第 5 步：注册应用¶
| 字段 | 示例值 | 说明 |
|---|---|---|
| Android 软件包名称 | com.happy.game2 |
必须与 APK 封装平台填写的包名完全一致 |
| 应用别名 | 99RRE |
可选，仅用于 Firebase 控制台显示 |
注意：包名可自定义，但一旦注册无法修改，且必须与 APK 打包平台填写的一致。
点击 注册应用。
第 6 步：下载并上传配置文件¶
- 注册成功后，页面会提供 下载 google-services.json 按钮
- 点击下载该文件
- 登录 智能封装 APK 后台
- 找到 Firebase 配置 / 上传配置文件的位置
- 将下载的
google-services.json文件上传
这一步替代了手动在 Android Studio 中放置文件的操作，封装平台会自动处理。
第 7 步：完成 SDK 配置¶
- 下载
google-services.json后，Firebase 控制台会进入"添加 Firebase SDK"页面 - 显示两种配置方式：
- Kotlin DSL（
build.gradle.kts）← 选择此项 - Groovy（
build.gradle） - 对于智能封装 APK 平台：不需要手动修改代码
- 确认页面显示"下一步"或"继续"按钮可用，点击 继续
- 点击 完成 或 前往控制台
至此，Firebase 控制台侧的配置全部完成。
常见问题¶
| 问题 | 解决方案 |
|---|---|
| 包名填错了怎么办？ | 无法修改，需要删除该应用并重新添加 |
| 需要手动配置 Gradle 吗？ | 不需要，智能封装平台会自动处理 |
| 一个项目可以添加多个应用吗？ | 可以，每个包名对应一个应用，各自下载独立的 json 文件 |
交叉引用： - FCM 核心概念 → 01-FCM核心概念与架构 - HTTP v1 API 认证 → 02-HTTP-v1-API与认证 - iGaming 多平台推送实战 → 08-iGaming多平台批量推送实战