Skip to content

Commit

Permalink
modify
Browse files Browse the repository at this point in the history
  • Loading branch information
haoxiuwen committed Jan 19, 2024
1 parent 72c1208 commit a5a1b31
Showing 1 changed file with 12 additions and 11 deletions.
23 changes: 12 additions & 11 deletions docs/document/android/push.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ SDK 内部会按照该顺序检测设备的推送支持情况。如果未设置

### 上传到设备证书到环信即时通讯云控制台

![image](@static/images/android/push/push_android_certificate_add.png)
![image](@static/images/android/push/fcm_certificate_v1.png)

## 在客户端实现推送

Expand Down Expand Up @@ -98,16 +98,11 @@ EMClient.getInstance().init(this, options);

#### FCM 推送集成

**步骤一:在 [Firebase 控制台](https://console.firebase.google.com/)添加 Firebase。**
##### **步骤一:在 [Firebase 控制台](https://console.firebase.google.com/)添加 Firebase。**

详见 [FCM 的官网介绍](https://firebase.google.com/docs/android/setup?hl=zh-cn#console)。<br/>

**步骤二:获取 FCM V1 版本证书。**

:::tip
- 旧版 HTTP 或 XMPP API 于 2024 年 6 月 20 日停用,请尽快迁移到最新的 FCM API(HTTP v1)版本证书。详见 [FCM 控制台](https://console.firebase.google.com)
- 请确保 V1 证书可用,因为执行转换证书后,旧证书会被删除,若此时新证书不可用,会导致推送失败。
:::
##### **步骤二:获取 FCM V1 版本证书。**

![image](@static/images/android/push/deadline.png)

Expand Down Expand Up @@ -145,13 +140,13 @@ EMClient.getInstance().init(this, options);
}
```

**步骤三:上传推送证书。**
##### **步骤三:上传推送证书。**

1.[环信即时通讯云控制台](https://console.easemob.com/user/login)上传推送证书,选择你的应用 > **即时通讯** > **功能配置** > **消息推送** > **证书管理**,点击 **添加推送证书**。默认打开 **谷歌** 页签
1.[环信即时通讯云控制台](https://console.easemob.com/user/login)上传推送证书,选择你的应用 > **即时通讯** > **功能配置** > **消息推送** > **证书管理**

![image](@static/images/android/push/fcm_certificate_v1.png)

2. 配置 FCM 推送:
2. 点击 **添加推送证书**。在默认打开的 **谷歌** 页签中,配置 FCM 推送:
- **证书类型** 选择 **V1**
- 点击 **上传证书** 上传获取的 FCM V1 版本证书文件(.json 文件)。
- **证书名称** 设置为 FCM 的发送者 ID。你需要在[Firebase 控制台](https://console.firebase.google.com/?hl=zh-cn)**项目设置** > **云消息传递** 页面中,在 **Firebase Cloud Messaging API(V1)** 区域中获取发送者 ID,如下图所示。
Expand All @@ -163,6 +158,12 @@ EMClient.getInstance().init(this, options);

![image](@static/images/android/push/fcm_old_version.png)

**旧版 HTTP 或 XMPP API 于 2024 年 6 月 20 日停用,请尽快迁移到最新的 FCM API(HTTP v1)版本证书。**详见 [FCM 控制台](https://console.firebase.google.com)**请确保 V1 证书可用,因为执行转换证书后,旧证书会被删除,若此时新证书不可用,会导致推送失败。**

若要从旧版证书无缝切换到 V1 新证书,你可以在 **证书管理** 页面的 FCM 旧版证书的 **操作** 栏中点击 **编辑**,在弹出的 **编辑推送证书** 窗口的 **谷歌** 页签进行 V1 证书配置。

![image](@static/images/android/push/hxconsoleedit.png)

**步骤四:FCM 推送集成。**

1. 在项目根目录下的 `build.gradle` 中添加 FCM 服务插件。
Expand Down

0 comments on commit a5a1b31

Please sign in to comment.