清理 App × Launcher

三方怎么接

PUSH SDK 直接判断模式和提醒时机,并按产品资源组装 View。宿主转交成品 View、发送埋点,Launcher SDK 负责展示。

PUSH SDK ↔ 宿主 App → Launcher SDK

PUSH SDK 直接向 Android 查询 Launcher 模式,按产品资源组装 View。宿主按需提供桌面 Context,并把成品 View 交给 Launcher SDK 展示。PUSH SDK 回调埋点,宿主用自己的库直接上报。
看完整图下载 PNG手机上可横滑查看,也可打开原图放大。

模式由 PUSH SDK 自己查。 宿主和 Launcher 同 APK 时,Android 10+ 用 RoleManager.isRoleHeld(ROLE_HOME) 读本应用的默认桌面角色。启动、从系统设置返回及投递前都会复查。桌面此刻能否显示 View 是独立条件。 Android RoleManager

谁调用谁,传什么

调用方向接口草案传入的数据
宿主 → PUSH SDKinstall(app, callbacks)
bindStartup(activity) / bindHome(activity)
应用上下文、宿主回调、启动页与首页。发通知权限、Launcher 引导、首页补问和返回弹窗由 PUSH SDK 编排。
PUSH SDK → 宿主getDesktopContext()按需获取当前可展示桌面的 Context,暂不可展示时返回 null。归因和自有广告状态等宿主独有数据,也在需要时通过回调读取。
PUSH SDK → 宿主onDesktopNotice(command)Show(id, view) 携带 PUSH SDK 组装并绑定点击、关闭事件的成品 View。Dismiss(id) 携带待撤下的通知 ID。
宿主 → Launcher SDKsetDesktopNoticeView(view)宿主直接转交收到的 View,按 Launcher 现有接口接入。撤下时调用同一个桌面容器的清理能力。
PUSH SDK → 宿主onOpenRoute(request)
onTrack(eventName, params)
跳转传路由 ID、入口类型和事件 ID。PUSH SDK 决定埋点时机、来源与去重,宿主在回调里把事件名和参数直接交给现有上报库。

PUSH SDK 观察自己创建的 View,确认桌面窗口可见且 View 已挂载并绘制后才计次和回调展示埋点。用户点击后,PUSH SDK 回调宿主的 ICON 广告入口,埋点来源保留为桌面通知。

双模式怎么走

首次启动 先询问发通知权限,无论同意或拒绝,都继续引导设置 Launcher。回来后按实际默认桌面角色分流。

纯 App 未授权时首页提示一次。授权且满足条件才显示常驻与定时、解锁、转后台 PUSH。根页面返回时询问是否设为 Launcher。实际退出后的首次冷启动可再补问一次通知授权。

Launcher 模式 关闭系统 PUSH,App 根页面返回系统默认桌面。PUSH SDK 在解锁时判断桌面是否可见及间隔、次数。满足条件后,PUSH SDK 用产品资源创建 View,宿主将成品 View 设置到桌面。

推送资源包与 AAR

构建期 资源 ZIP 经 CI 校验打进产品 AAR。可配置文案、图标、按钮文字、按钮颜色、路由和频控,例如 titleKey、buttonTextKey 和 buttonColor。

运行期 PUSH SDK 选择自己的布局模板,读取 AAR 中的文案、图标和样式,组装 View 并绑定点击、关闭。宿主拿到成品 View 后交给 Launcher SDK。

ICON_TEXT 一个图标加文案,对应一个落地页。SHORTCUT_GRID 多个图标加名称,每项单独配置落地页。