## Android 平台变更问题

今天这篇不聊抽象趋势，只盯一个值班场景：版本已经准备灰度，时间到了凌晨，负责上线的人需要在十几分钟内确认这次 Android 平台变更 会不会把关键链路打穿。真正危险的地方不是 API 改名，而是权限弹窗、前台服务、后台任务、通知行为和降级口这些东西在真实设备上一起叠加。

很多团队升级时爱做两件事：一是把验证放得太散，二是只看成功路径。结果到了灰度窗口，大家看着一堆零散记录，反而没人能回答“如果失败会怎么坏”。所以这篇直接按值班手册写，目标不是解释平台历史，而是让人拿着清单就能做最后一轮判断。

## 方案先给到

最短路径不是继续补测试，而是把上线前检查口压成 6 个：权限拒绝路径、前台服务类型、后台拉起限制、通知展示状态、账号迁移状态、回退开关可用性。只要这 6 项里有 1 项没有确定结论，这次 Android 平台变更 就不应该放大流量。

这套方法的优点是每个风险点都能落到一个具体问题：谁负责、怎么查、失败后怎么退。平台升级真正需要的不是“感觉上差不多”，而是最后十分钟里还能做出可验证判断。

## Android 平台变更关键实现

1. 值班检查对象

data class ReleaseGate(
    val item: String,
    val owner: String,
    val passed: Boolean,
    val fallback: String
)

2. 值班常用命令

adb shell dumpsys package com.example.app
adb shell dumpsys activity services
adb shell cmd jobscheduler get-job-state com.example.app 1000

3. 灰度闸门判断

fun canStartGray(permissionOk: Boolean, serviceOk: Boolean, rollbackReady: Boolean): Boolean {
    return permissionOk && serviceOk && rollbackReady
}

## Android 平台变更注意点

第一类值班错觉，是看到测试包能跑就默认权限链路没问题，实际上真正危险的是“用户拒绝权限以后会怎样”。第二类错觉，是前台服务能拉起就算完，没继续核对服务类型声明、通知可见性和系统限制。第三类错觉，是把所有问题都归到 targetSdk，忽略了灰度配置和账号状态本身也会放大风险。

所以值班时最重要的，不是把日志看得多细，而是别把“开发机正常”误当成“灰度正常”。

## Android 平台变更报错与排查

1. 灰度才出现异常

如果测试环境通过，灰度以后才出现服务起不来、任务不跑或权限路径异常，先查系统限制、灰度配置和真实账号状态，而不是立刻回头怀疑代码回归。很多问题不是写错了，而是上线条件和本地假设根本不是一回事。

adb shell dumpsys activity broadcasts
adb shell dumpsys jobscheduler
adb logcat -d | findstr /I "denied restriction foreground background"

2. 功能可用但退不回去

如果功能当前还能跑，但没有降级开关、回退配置和兜底动作，那这次升级也不算稳。Android 平台变更 最怕的不是出错，而是出错后没有撤退路线。真正靠谱的值班手册，一定会把“失败后怎么撤”写在和“成功后怎么放量”同样显眼的位置。

data class RollbackPlan(
    val key: String,
    val enabled: Boolean,
    val action: String
)

## Android 平台变更可运行片段

1. 最小状态对象

data class GrayCheckState(
    val gate: String,
    val ready: Boolean,
    val updatedAt: Long
)

2. 本地执行入口

fun runGrayCheck() {
    println(GrayCheckState("permission", true, System.currentTimeMillis()))
}

3. 最小验证命令

adb shell dumpsys package com.example.app
adb shell dumpsys activity services
adb logcat -d | findstr /I "permission denied foreground background"