Android 12及以下Intent.ACTION_CHOOSER与LabeledIntent兼容异常问题

问题场景 #

• 需求：WebView触发文件输入时，展示包含拍照、拍视频、图库选择的Action Chooser，该功能在Android 13上运行正常
• 实现逻辑：重写AccompanistWebChromeClient的onShowFileChooser()方法，创建Intent.ACTION_CHOOSER，将图库选择Intent设为contentSelectionIntent，同时用LabeledIntent包装拍照、拍视频Intent，放入EXTRA_INITIAL_INTENTS后通过pickMediaLauncher启动
• 异常表现：Android 12及以下设备上选择器不显示，直接打开图库；替换LabeledIntent为普通Intent（如Intent(MediaStore.ACTION_IMAGE_CAPTURE)）后，选择器正常显示三个选项

问题原因 #

Android 12及以下系统的选择器框架（ChooserActivity）对EXTRA_INITIAL_INTENTS中传入的LabeledIntent存在兼容性缺陷：

• LabeledIntent是Intent的包装类，用于自定义选择器选项的显示标签和图标，但旧版本系统在解析初始Intent列表时，未正确实现对LabeledIntent的解包与验证逻辑
• 这些被包装的Intent会被系统判定为无效选项而过滤，最终仅保留contentSelectionIntent直接启动，导致选择器界面被跳过

解决方案 #

针对不同Android版本做兼容处理：Android 12及以下直接使用普通Intent并通过setLabel()设置自定义名称；Android 13及以上可继续使用LabeledIntent实现更丰富的自定义（如图标）。

示例代码：

// 初始化初始Intent列表
val initialIntents = mutableListOf<Intent>()

// 处理拍照Intent
val captureImageIntent = Intent(MediaStore.ACTION_IMAGE_CAPTURE)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    // Android 13+ 使用LabeledIntent自定义标签和图标
    val labeledCaptureIntent = LabeledIntent(
        captureImageIntent,
        packageName,
        getString(R.string.take_photo),
        R.drawable.ic_camera
    )
    initialIntents.add(labeledCaptureIntent)
} else {
    // Android 12及以下 使用Intent.setLabel()设置自定义名称
    captureImageIntent.setLabel(getString(R.string.take_photo))
    initialIntents.add(captureImageIntent)
}

// 处理拍视频Intent（逻辑同拍照）
val captureVideoIntent = Intent(MediaStore.ACTION_VIDEO_CAPTURE)
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    val labeledVideoIntent = LabeledIntent(
        captureVideoIntent,
        packageName,
        getString(R.string.record_video),
        R.drawable.ic_video
    )
    initialIntents.add(labeledVideoIntent)
} else {
    captureVideoIntent.setLabel(getString(R.string.record_video))
    initialIntents.add(captureVideoIntent)
}

// 构建最终的选择器Intent
val chooserIntent = Intent.createChooser(contentSelectionIntent, "选择媒体来源")
chooserIntent.putExtra(Intent.EXTRA_INITIAL_INTENTS, initialIntents.toTypedArray())

// 启动选择器
pickMediaLauncher.launch(chooserIntent)

验证说明 #

• Android 12及以下：使用Intent.setLabel()可以让选择器正确识别并显示三个选项（拍照、拍视频、图库）
• Android 13及以上：LabeledIntent可正常生效，同时支持自定义图标，选择器显示正常

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