将 Firebase 添加到您的 Android 项目

前提条件

• 运行 Android 4.0 (Ice Cream Sandwich) 或更高版本以及 Google Play 服务 15.0.0 或更高版本的设备。
• 最新版本的 Android Studio

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

将 Firebase 添加至您的应用

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

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

使用 Firebase 智能助理

要在 Android Studio 中打开 Firebase 智能助理，请执行以下操作：

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

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

手动添加 Firebase

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

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

1. 如果您还没有 Firebase 项目，请在 Firebase 控制台中创建一个。为此，请点击添加项目。如果您已经有与自己的移动应用相关联的现有 Google 项目，请从项目名称下拉菜单中选择该项目。否则，请输入项目名称以创建新项目。
2. 可选：修改您的项目 ID。系统会自动为您的项目指定唯一 ID，此 ID 将用在公开显示的 Firebase 功能（例如数据库网址）以及您的 Firebase 托管子域名中。如果您想使用特定子域名，现在就可以更改此 ID。
3. 执行其余的设置步骤，然后点击创建项目（如果您使用现有的项目，则点击添加 Firebase），开始为您的项目配置资源。这通常需要几分钟的时间。此过程完成后，您就会看到项目概览。

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

1. 点击将 Firebase 添加到您的 Android 应用，然后按设置步骤操作。如果您是导入现有 Google 项目，系统可能会自动执行这些操作，您只需下载配置文件即可。
2. 看到提示时，输入应用的软件包名称。请务必输入应用在使用的软件包名称；只有在将应用添加到 Firebase 项目时您才能进行此设置。
3. 在此过程中，您要下载一个 google-services.json 文件。您可以随时重新下载此文件。
4. 添加初始化代码后，运行您的应用以便向 Firebase 控制台发送验证信息，证明您已成功安装 Firebase。

添加 SDK

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

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

buildscript {
    // ...
    dependencies {
        // ...
        classpath 'com.google.gms:google-services:4.1.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.4'

  // 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 数据。
• 借助云消息传递功能向用户发送通知。
• 借助崩溃报告功能确定应用崩溃的时间和原因。