转到控制台

将 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 功能。

Gradle 依赖项行 服务
com.google.firebase:firebase-core:16.0.7 Analytics
com.google.firebase:firebase-database:16.0.6 实时数据库
com.google.firebase:firebase-firestore:18.0.1 Cloud Firestore
com.google.firebase:firebase-storage:16.0.5 Storage
com.crashlytics.sdk.android:crashlytics:2.9.9 Crashlytics
com.google.firebase:firebase-auth:16.1.0 身份验证
com.google.firebase:firebase-messaging:17.3.4 云消息传递
com.google.firebase:firebase-config:16.3.0 远程配置
com.google.firebase:firebase-invites:16.1.0 邀请和动态链接
com.google.firebase:firebase-ads:17.1.3 AdMob
com.google.firebase:firebase-appindexing:17.1.0 App Indexing
com.google.firebase:firebase-perf:16.2.3 性能监控
com.google.firebase:firebase-functions:16.1.3 Cloud Functions for Firebase 客户端 SDK
com.google.firebase:firebase-ml-vision:19.0.2 机器学习套件 (Vision)
com.google.firebase:firebase-ml-model-interpreter:17.0.3 机器学习套件(自定义模型)
com.google.firebase:firebase-ml-natural-language:18.1.1 机器学习套件(自然语言)
com.google.firebase:firebase-ml-natural-language-language-id-model:18.0.2 机器学习套件(自然语言 ID 模型)

后续步骤

了解 Firebase:

向您的应用添加 Firebase 功能: