文档中心>即时通信 IM

uni-app 推送排障指引

最近更新时间:2024-02-01 09:58:51

我的收藏

相关参数配置

请按照官网文档配置相关参数,详情请参见 离线推送(uni-app)

查看本地插件是否引入




重新自定义基座

1. 选择自定义基座



2. 填写相关信息



3. 选择自定义运行







插件信息确认

1. 本地插件是否注册成功 (必须在登录后)
本地打印相关日志确认
uni.$TUIOfflinePush = uni.requireNativePlugin("TencentCloud-TUIOfflinePush");
console.warn(uni.$TUIOfflinePush, "---TUIOfflinePush | ok");



注册插件具体信息确认:



2. 本地插件未注册成功




获取并上报 token

步骤1:调用 getDeviceToken (确认各个手机平台的所需信息是否填写完整)





步骤2:原生插件回调

确认成功:



失败情况:
处理方案:根据错误码,在对应的厂商平台:
华为错误码:错误码
小米错误码:错误码
OPPO 官网常见问题: OPPO 开放平台-OPPO开发者服务中心
vivo 错误码: 错误码
注意:
无回调情况:
如果执行了第一步,没有执行第二步:
1. 首先确认 offlinePushConfig 中对应平台的信息是否正确,并且填写完整。
2. 查看 HBuilder 是否有升级 ,对比稳定版本,确认是否是 HBuilder 升级的版本问题。
3. 确认是否登录,必须要先登录。

步骤3:上报token (有相关携带的信息)

上报成功确认:



遇到证书错误问题:
证书ID 需要一一对应, Debug 和 Release的证书ID不一样,自检证书:




切换前后台




注意:
部分手机厂商本地测试离线推送无效,要求上架才支持。
厂商通道
是否需要上架
账号说明
小米
需要注册企业开发者账号
华为
个人开发者账号即可
魅族
个人开发者账号即可
vivo
需要注册企业开发者账号
OPPO
需要注册企业开发者账号

其他问题:

华为离线推送有报错



原因:请检查 agconnect-services.json 文件是否填写。
注意:
华为推送需要将官网下载的 agconnect-services.json 文件放到 nativeplugins/TencentCloud-TUIOfflinePush/android/assets/路径下。
离线推送插件 TUIOfflinePush 和 uniPush2 冲突了,不能共用该如何处理?
TUIOfflinePush不支持与其他离线推送通道共用,这里推荐仅使用 TUIOfflinePush 即可。