为 Android 配置 FCM

Firebase Cloud Messaging (FCM) 会启用 Avalanche 的智能设备服务器,以创建与 Android 设备的通信。要在智能设备服务器上启用 FCM 支持,您必须从 Google 获取凭据,以验证您的服务器。该流程包括创建 Firebase 项目,将 Avalanche 应用程序添加至项目,获取 FCM 凭据,并向 Avalanche 提供 FCM 凭据。要完成此过程,必须具有 Google 账号。

目前,Avalanche 拥有两种使用 FCM 通信的应用程序,分别是标准 Avalanche 启用程序和 Android Enterprise 启用程序。一个 Firebase 项目同时支持两种应用程序。

如果您之前使用 GCM,并想迁移至 FCM,请参阅 Google 的迁移指南

FCM 仅适用于 6.3 或更新版本的启用程序。

FCM 端口

FCM 需要网络开放以下端口:5228、5229 和 5230。我们建议将这些端口列入白名单,不设置任何 IP 限制。如果您的组织必须限制连接,请参阅 Firebase 文章 FCM 端口和防火墙了解详细信息。

设置 FCM

要为 Avalanche 创建 Firebase 项目

1.在 Web 浏览器中,导航至 https://console.firebase.google.com

2.点击添加项目

3.输入 AvalancheFCM 作为项目名称。

4.(可选)为项目设置 Google Analytics。

5.点击创建项目

要将 Avalanche 应用程序添加至 Firebase 项目

1.在 AvalancheFCM Firebase 项目中,导航至项目设置

2.在“常规”选项卡上,选择该选项将 Android 应用程序添加到您的应用程序

3.如果使用标准 Avalanche 启用程序,请输入 com.wavelink.android 作为包名称。
-或-
如果使用 Android Enterprise 启用程序,请输入 com.ivanti.enterprise 作为包名称。

4.点击注册应用程序

5.下载 google-services.json 并点击下一步

6.点击继续控制台操作

获取 FCM 凭据

1.在 AvalancheFCM Firebase 项目中,导航至项目设置

2.在“服务帐户”选项卡上,点击生成新私钥

3.点击生成密钥
下载服务帐户私钥。

为 Avalanche 提供 FCM 凭据

1.从 Avalanche 控制台导航至“配置文件”选项卡。

2.点击想要编辑的智能设备服务器配置文件名称。

3.点击编辑

4.在 Google Firebase Cloud Messaging 部分,点击 Google-Services 文件旁的添加

5.打开将 Avalanche 应用程序添加到 Firebase 项目时下载的 google-services.json 文件。

6.点击“服务帐户文件”旁的添加

7.打开服务帐户私钥 JSON 文件。

8.点击配置文件顶部的保存

9.运行部署。

您的 Android 设备现可使用 Google Cloud 服务与 Avalanche 通信。同时必须持有智能设备服务器的 SSL 证书才能连接智能设备。有关证书的详细信息,请参阅 获取 SSL 证书

如果智能设备服务器日志生成 403 错误,可能需要在 https://console.developers.google.com/apis/library/fcm.googleapis.com 上启用 Firebase Cloud Messaging API。