将 Firebase 添加到您的 Android 项目

前提条件

• 一台运行以下系统及应用的设备：
  • Android 4.1（API 级别 16，Jelly Bean）或更高版本
  • Google Play 服务 15.0.0 或更高版本
• 最新版本的 Android Studio

如果您还没有 Android Studio 项目，只是想试用一下某项 Firebase 功能，可以下载我们的快速入门示例。如果使用快速入门示例，请不要忘记从项目模块文件夹（通常是 app/）内的 build.gradle 文件中获取应用 ID，下一步中会用到此软件包名称。

将 Firebase 添加到您的应用

如果您使用的是 Android Studio 2.2 版或更高版本，则 Firebase Assistant 是将您的应用关联至 Firebase 的最简单方式。Firebase Assistant 可以关联您现有的项目，或者为您创建一个新项目，并自动添加所有必要的 Gradle 依赖项。

如果您使用的是旧版 Android Studio 或者您的项目配置较为复杂，您仍可以手动将 Firebase 添加至您的应用。

使用 Firebase Assistant

要在 Android Studio 中打开 Firebase Assistant，请执行以下操作：

• 依次点击 Tools > Firebase 以打开 Assistant 窗口。
• 点击以展开所列功能之一（例如 Analytics），然后点击所提供的教程链接（例如“Log an Analytics event”）。
• 点击 Connect to Firebase 按钮以关联至 Firebase，并向您的应用添加必要的代码。

大功告成！您可以跳至后续步骤。

手动添加 Firebase

现在需要将 Firebase 添加至您的应用。要执行此操作，您需要有一个 Firebase 项目和适用于您的应用的 Firebase 配置文件。

要创建 Firebase 项目，请执行以下操作：

1. 访问 Firebase 控制台。

2. 点击添加项目，然后选择或输入项目名称。

   • 如果您已经拥有一个与应用关联的 Google 项目，请从项目名称下拉菜单中选择该项目。
   • 如果您尚未创建 Google 项目，请输入新的项目名称。

3. （可选）修改项目 ID。

   Firebase 会自动为您的 Firebase 项目分配一个独一无二的 ID。此 ID 会显示在公众可见的 Firebase 服务中，例如：

   • 默认实时数据库网址：your-project-id.firebaseio.com
   • 默认 Cloud Storage 存储分区名称：your-project-id.appspot.com
   • 默认托管子网域：your-project-id.firebaseapp.com

4. 在 Firebase 控制台中完成剩下的设置步骤，然后点击创建项目（如果您使用的是现有 Google 项目，则点击添加 Firebase）。

Firebase 会自动为您的 Firebase 项目预配资源。此过程通常需要几分钟。完成此过程后，您将进入 Firebase 控制台中 Firebase 项目的概览页面。

创建项目之后，您就可以向其中添加 Android 应用了：

1. 点击将 Firebase 添加到您的 Android 应用，然后按设置步骤操作。如果您是导入现有 Google 项目，系统可能会自动执行这些操作，您只需下载配置文件即可。

2. 出现提示时，输入应用的软件包名称。请务必输入应用使用的软件包名称；只有在将应用添加到 Firebase 项目时您才能进行此设置。

3. 将 Firebase Android 配置文件添加到您的应用：

   1. 点击下载 google-services.json 以获取 Firebase Android 配置文件 (google-services.json)。

      您可以随时再次下载 Firebase Android 配置文件。

   2. 将配置文件移至与根级 build.gradle 文件相同的目录中。

4. 添加初始化代码后，运行您的应用以便向 Firebase 控制台发送验证信息，证明您已成功安装 Firebase。

添加 SDK

如果希望将 Firebase 库集成至自己的某个项目中，您需要执行几项基本操作来准备 Android Studio 项目。您可能已经在将 Firebase 添加至应用时完成了这些操作。

首先，向您的根级 build.gradle 文件添加规则，以纳入 google-services 插件和 Google 的 Maven 代码库：

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.2.0' // google-services plugin
    }
}

allprojects {
    // ...
    repositories {
        google() // Google's Maven repository
        // ...
    }
}

然后，在您的模块 Gradle 文件（通常是 app/build.gradle）中，在文件的底部添加 apply plugin 代码行，以启用 Gradle 插件：

apply plugin: 'com.android.application'

android {
  // ...
}

dependencies {
  // ...
  implementation 'com.google.firebase:firebase-core:16.0.7'

  // Getting a "Could not find" error? Make sure you have
  // added the Google maven respository to your root build.gradle
}

// ADD THIS AT THE BOTTOM
apply plugin: 'com.google.gms.google-services'

您还应添加您希望使用的 Firebase SDK 的依赖项。建议从 com.google.firebase:firebase-core 开始，它可以提供 Google Analytics for Firebase 功能。请参阅可用库列表。

可用的库

以下库分别对应各种 Firebase 功能。

后续步骤

了解 Firebase：

• 探索 Firebase 应用示例。
• 借助 Firebase Android Codelab 获得实际上手经验。
• 报名参加周末学 Firebase 课程，加深对 Firebase 的了解。

向您的应用添加 Firebase 功能：

• 借助 Analytics 深入分析用户行为。
• 借助身份验证功能设置用户身份验证机制。
• 借助实时数据库功能存储用户信息，或通过 Cloud Storage 存储 blob 数据。
• 借助云消息传递功能向用户发送通知。
• 借助 Crashlytics 确定应用崩溃的时间和原因。