← 美洽首页 帮助中心 · 接诊台
App 与小程序

Android App 怎么集成美洽 SDK

思路和 iOS 一样:引依赖、初始化、调起会话。但安卓有安卓的坑——混淆、权限、机型碎片化,这篇专讲安卓。

约 6 分钟读完深度详解

先搞懂安卓和 iOS 差在哪

集成的主干三步两边一模一样,都是把 SDK 装进工程、用密钥初始化、在客服入口调起会话页。但安卓这边有三件事明显更磨人:构建时的混淆配置、杂乱的权限管理、还有海量机型系统的兼容。所以安卓的发版前验证要比 iOS 更舍得花时间。

你的角色不变:在「设置 → 渠道管理」建好 App 渠道拿到密钥,交给安卓开发,然后盯着验收。好消息是要准备的东西和 iOS 那边是同一份:密钥、入口位置、要不要传资料,一次说清两边通用。

安卓集成三步
图:安卓集成三步

跟着做:三步跑完

  1. 加依赖:开发在 Gradle 配置里把 SDK 依赖引进来,按官方文档对齐版本。
  2. 初始化:App 启动时用后台拿的密钥初始化,动作要在调起会话之前完成。
  3. 调起会话:「联系客服」按钮里调 SDK 的方法,把会话页拉起来。

三步走完先别急着发版,让开发自己拿测试包全流程聊一遍。安卓的毛病大多出在打包和机型上,自测能拦住一大半。

提醒:安卓打包如果开了代码混淆,SDK 的混淆规则一定要按官方文档配全。漏配的典型症状是:开发环境跑得好好的,打个正式包就崩。

安卓特有的几处坑

  • 混淆:如上,规则漏配会出玄学崩溃,先查这个。
  • 权限:网络权限是基础,通知类权限在新系统上要单独申请,不申请消息可能被静默吞掉。
  • 推送通道:各厂商推送环境不一样,坐席回复能不能及时推到,要按你们接的推送方案验。
  • 机型碎片化:别只在一两台旗舰机上测,中低端机、旧系统版本都得过一遍。
点了没反应
图:点了没反应

发版前的验证清单

  • 开发包和正式混淆包各验一遍,两个都得能聊。
  • 发消息后台收得到,坐席回了 App 收得到。
  • 权限申请时机正常,用户拒绝授权后有合理的兜底提示。
  • 用户资料传过来的话,后台能看到。

排查对照

  • 编译报错:先看依赖版本对不对、最低系统版本够不够、混淆规则全不全。
  • 发得出收不到:查网络权限、坐席在不在线、推送配置。
  • 点按钮闪退:先怀疑初始化顺序,再怀疑混淆。

自己排不出来,就把报错原文、机型、系统版本记下来找官方技术支持,信息越全解决越快。

具体的依赖坐标、方法名和版本要求,以美洽官方的开发者文档为准,别拿这篇当接口文档用。

同一块的接诊

← 回接诊台