使用RoleManager唤起默认启动器选择器 替换废弃API后应用崩溃如何解决

核心原因 #

90%以上的该类崩溃是由 Activity Result API的注册时机不符合要求 导致：
registerForActivityResult 方法必须在Activity/Fragment的生命周期进入STARTED状态之前完成注册（通常在onCreate/onAttach阶段注册），你当前的代码是在唤起选择器的触发逻辑中临时注册回调，完全不符合API调用规范，会直接抛出异常导致崩溃。

其他可能的诱因：

• 项目依赖的androidx.activity/androidx.fragment版本过低，Activity Result API未正式支持
• 未对RoleManager做非空判断，部分定制ROM阉割了该系统服务会触发空指针异常
• 未兼容Android 10以下系统版本的逻辑

解决建议 #

1. 提前注册ActivityResultLauncher为类成员变量，禁止在触发逻辑中动态注册

// 声明为Activity/Fragment的全局成员变量
private ActivityResultLauncher<Intent> homeRoleRequestLauncher;

2. 在onCreate阶段完成回调注册

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.your_layout);
    
    // 提前注册结果回调，必须在此阶段完成
    homeRoleRequestLauncher = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (result.getResultCode() != Activity.RESULT_OK) {
                // 处理授权失败逻辑
            }
        }
    );
    
    // 其他初始化逻辑
}

3. 在需要唤起选择器的位置只执行启动逻辑，补充非空判断和状态校验

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
    RoleManager roleManager = (RoleManager) getSystemService(Context.ROLE_SERVICE);
    // 补充非空判断、角色可用判断、未持有角色判断，避免无效调用
    if (roleManager != null 
        && roleManager.isRoleAvailable(RoleManager.ROLE_HOME)
        && !roleManager.isRoleHeld(RoleManager.ROLE_HOME)) {
        Intent intent = roleManager.createRequestRoleIntent(RoleManager.ROLE_HOME);
        homeRoleRequestLauncher.launch(intent);
    }
} else {
    // 保留Android 10以下版本原有兼容逻辑即可
}

4. 依赖版本校验
   确保项目依赖版本满足最低要求：

• androidx.activity:activity:1.2.0 及以上
• androidx.fragment:fragment:1.3.0 及以上

内容的提问来源于stack exchange，提问作者Alcachofra