将 Firebase 添加到您的 Android 项目

前提条件

  • 运行 Android 4.0 (Ice Cream Sandwich) 或更高版本以及 Google Play 服务 11.0.4 或更高版本的设备
  • Google 代码库中的 Google Play Services SDK,可通过 Android SDK Manager 获得
  • 最新版本的 Android Studio,1.5 版或更高版本

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

将 Firebase 添加至您的应用

如果您使用最新版本的 Android Studio(2.2 版或更高版本),我们建议使用 Firebase 智能助理来将您的应用关联至 Firebase。Firebase 智能助理可以关联您现有的项目,或者为您创建一个新项目,并自动安装任何必要的 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 添加到您的应用,您需要有一个 Firebase 项目以及适用于您的应用的 Firebase 配置文件。

  1. 如果还没有 Firebase 项目,请在 Firebase 控制台中创建一个。如果已经有与您的移动应用关联的现有 Google 项目,可点击导入 Google 项目。否则,请点击新建项目
  2. 点击将 Firebase 添加到您的 Android 应用,然后按设置步骤操作。如果您要导入的是现有 Google 项目,系统可能会自动执行这些操作,您只需下载配置文件即可。
  3. 当出现提示时,输入您的应用的软件包名称。请务必输入应用使用的软件包名称,因为您只有在将应用添加至 Firebase 项目时才能进行此设置。
  4. 最后,您要下载一个 google-services.json 文件。您可以随时重新下载此文件
  5. 如果尚未将此文件复制到项目的模块文件夹(通常是 app/),请执行此操作。
添加 SDK

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

首先,向您的根级 build.gradle 文件添加规则,以纳入 Google 服务插件:

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

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

apply plugin: 'com.android.application'

android {
  // ...
}

dependencies {
  // ...
  compile 'com.google.firebase:firebase-core:11.0.4'

  // Getting a "Could not find" error? Make sure you have
  // the latest Google Repository in the Android SDK manager
}

// 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:11.0.4 Analytics
com.google.firebase:firebase-database:11.0.4 实时数据库
com.google.firebase:firebase-storage:11.0.4 存储
com.google.firebase:firebase-crash:11.0.4 崩溃报告
com.google.firebase:firebase-auth:11.0.4 身份验证
com.google.firebase:firebase-messaging:11.0.4 云消息传递
com.google.firebase:firebase-config:11.0.4 远程配置
com.google.firebase:firebase-invites:11.0.4 邀请和动态链接
com.google.firebase:firebase-ads:11.0.4 AdMob
com.google.firebase:firebase-appindexing:11.0.4 App Indexing
com.google.firebase:firebase-perf:11.0.4 性能监控

后续步骤

了解 Firebase:

向您的应用添加 Firebase 功能:

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面