解决Android 13文件权限适配难题：Matisse相册选择器实战方案

原创 于 2025-09-13 00:37:07 发布 · 623 阅读 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

解决Android 13文件权限适配难题：Matisse相册选择器实战方案

【免费下载链接】Matisse :fireworks: A well-designed local image and video selector for Android 【免费下载链接】Matisse 项目地址: https://gitcode.com/gh_mirrors/mati/Matisse

你是否在Android 13设备上遇到过应用崩溃、图片无法加载或权限弹窗频繁出现的问题？随着Android系统对用户隐私保护的加强，文件访问权限机制发生了显著变化，许多应用在升级到Android 13后出现了兼容性问题。本文将详细介绍如何使用Matisse相册选择器（Matisse.java）优雅地解决Android 13文件权限适配问题，让你的应用在最新系统上稳定运行。

读完本文，你将获得：

  • Android 13文件权限变化的核心要点
  • Matisse相册选择器的权限适配方案
  • 完整的代码实现和配置示例
  • 常见问题的解决方案

Android 13文件权限变化概述

Android 13（API级别33）引入了新的文件权限模型，对应用访问媒体文件的方式进行了重大调整。主要变化包括：

  1. 新增照片和视频权限：将READ_EXTERNAL_STORAGE权限拆分为READ_MEDIA_IMAGES和READ_MEDIA_VIDEO，应用需要根据实际需求申请相应权限。

  2. 权限粒度更细：应用现在可以只请求访问照片或视频的权限，而不是之前的所有媒体文件。

  3. 权限申请时机：Android 13要求应用在实际需要访问媒体文件时才申请权限，而不是在应用启动时批量申请。

这些变化旨在增强用户隐私保护，但也给开发者带来了适配挑战。Matisse相册选择器作为一款优秀的开源图片选择库，提供了完善的权限适配方案。

Matisse相册选择器简介

Matisse是知乎开源的一款本地图片和视频选择器（项目描述），具有以下特点：

  • 简洁美观的UI设计，支持知乎主题和Dracula主题
  • 支持图片和视频选择，可配置多种过滤条件
  • 内置Glide和Picasso图片加载引擎（GlideEngine.java、PicassoEngine.java）
  • 完善的权限处理机制，适配Android 13及以上系统

Matisse界面预览

Matisse的核心优势在于其灵活的配置选项和对最新Android系统的及时适配。接下来，我们将重点介绍如何利用Matisse解决Android 13文件权限问题。

Matisse权限适配核心实现

Matisse通过MediaStoreCompat类（MediaStoreCompat.java）实现了对Android文件系统的兼容访问。该类封装了处理媒体文件URI和路径的关键逻辑，特别是针对Android 13的权限变化做了特殊处理。

1. 动态权限申请

在SampleActivity中（SampleActivity.java），Matisse使用RxPermissions库处理动态权限申请：

@SuppressLint("CheckResult")
@Override
public void onClick(final View v) {
    RxPermissions rxPermissions = new RxPermissions(this);
    rxPermissions.request(Manifest.permission.WRITE_EXTERNAL_STORAGE)
            .subscribe(aBoolean -> {
                if (aBoolean) {
                    startAction(v);
                } else {
                    Toast.makeText(SampleActivity.this, R.string.permission_request_denied, Toast.LENGTH_LONG)
                            .show();
                }
            }, Throwable::printStackTrace);
}

对于Android 13及以上设备，需要将权限申请代码修改为：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    rxPermissions.request(Manifest.permission.READ_MEDIA_IMAGES)
            .subscribe(/* 处理权限回调 */);
} else {
    rxPermissions.request(Manifest.permission.READ_EXTERNAL_STORAGE)
            .subscribe(/* 处理权限回调 */);
}

2. 文件存储策略

Matisse通过CaptureStrategy类（CaptureStrategy.java）实现了灵活的文件存储策略，支持公共存储和私有存储两种方式：

.captureStrategy(
    new CaptureStrategy(true, "com.zhihu.matisse.sample.fileprovider", "test")
)
  • 公共存储：文件保存在外部存储的公共目录（如Pictures），所有应用均可访问
  • 私有存储：文件保存在应用专属目录，只有当前应用可访问

3. FileProvider配置

为了在Android 13上安全地访问文件，Matisse使用FileProvider机制。在Sample项目中，提供了两种FileProvider配置：

公共存储配置（file_paths_public.xml）：

<paths>
    <external-path
        name="my_images"
        path="Pictures"/>
</paths>

私有存储配置（file_paths_private.xml）：

<paths>
    <external-path
        name="my_images"
        path="Android/data/com.zhihu.matisse.sample/files/Pictures"/>
</paths>

这两种配置分别对应了CaptureStrategy中的isPublic参数为true和false的情况。

完整适配步骤

下面我们将详细介绍如何在Android 13设备上集成和配置Matisse，实现完美的权限适配。

步骤1：添加依赖

首先，在你的项目中添加Matisse的依赖。具体方法请参考项目的README.md文件。

步骤2：配置权限

在AndroidManifest.xml中添加必要的权限声明：

<!-- Android 12及以下 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="28" />

<!-- Android 13及以上 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

步骤3：配置FileProvider

在AndroidManifest.xml中添加FileProvider配置：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths_public" />
</provider>

根据你的存储策略选择合适的paths文件（file_paths_public.xml或file_paths_private.xml）。

步骤4：初始化Matisse

在你的Activity中初始化Matisse，并配置权限策略：

Matisse.from(SampleActivity.this)
    .choose(MimeType.ofImage(), false)
    .countable(true)
    .capture(true)
    .captureStrategy(
        new CaptureStrategy(true, "com.zhihu.matisse.sample.fileprovider", "test")
    )
    .maxSelectable(9)
    .addFilter(new GifSizeFilter(320, 320, 5 * Filter.K * Filter.K))
    .gridExpectedSize(
        getResources().getDimensionPixelSize(R.dimen.grid_expected_size)
    )
    .restrictOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT)
    .thumbnailScale(0.85f)
    .imageEngine(new GlideEngine())
    .forResult(REQUEST_CODE_CHOOSE);

这段代码来自SampleActivity.java，展示了如何配置一个支持拍照功能的图片选择器。

步骤5：处理权限请求结果

在Activity中重写onRequestPermissionsResult方法，处理权限请求结果：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    // 处理权限请求结果
    if (requestCode == PERMISSION_REQUEST_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限授予成功，重新初始化Matisse
            initMatisse();
        } else {
            // 权限授予失败，显示提示信息
            Toast.makeText(this, "需要存储权限才能选择图片", Toast.LENGTH_SHORT).show();
        }
    }
}

步骤6：处理选择结果

在Activity中重写onActivityResult方法，处理图片选择结果：

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == REQUEST_CODE_CHOOSE && resultCode == RESULT_OK) {
        mAdapter.setData(Matisse.obtainResult(data), Matisse.obtainPathResult(data));
        Log.e("OnActivityResult ", String.valueOf(Matisse.obtainOriginalState(data)));
    }
}

这段代码来自SampleActivity.java，展示了如何获取用户选择的图片数据。

界面展示与用户体验

Matisse提供了两种主题风格：知乎主题和Dracula主题，满足不同应用的设计需求。

知乎主题界面

Dracula主题界面

你可以通过设置theme属性来选择主题：

// 知乎主题
Matisse.from(SampleActivity.this)
    .choose(MimeType.ofImage())
    .theme(R.style.Matisse_Zhihu)
    // 其他配置...

// Dracula主题
Matisse.from(SampleActivity.this)
    .choose(MimeType.ofImage())
    .theme(R.style.Matisse_Dracula)
    // 其他配置...

Matisse的界面设计遵循了现代Android应用的设计规范，提供了流畅的用户体验和直观的操作方式。在权限处理方面，Matisse会在适当的时机请求必要的权限，避免频繁弹窗打扰用户。

常见问题解决方案

问题1：Android 13设备上图片无法加载

解决方案：检查是否正确申请了READ_MEDIA_IMAGES权限，确保使用FileProvider获取图片URI。

// 正确的权限申请代码
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    rxPermissions.request(Manifest.permission.READ_MEDIA_IMAGES)
        .subscribe(granted -> {
            if (granted) {
                // 初始化Matisse
            } else {
                // 显示权限申请失败提示
            }
        });
}

问题2：拍照功能在Android 13上无法使用

解决方案：检查CaptureStrategy配置是否正确，确保使用了正确的FileProvider authorities。

.captureStrategy(
    new CaptureStrategy(true, "com.zhihu.matisse.sample.fileprovider", "test")
)

同时，确保FileProvider在AndroidManifest.xml中正确配置，并且对应的paths文件存在。

问题3：应用在Android 13上崩溃，日志提示权限拒绝

解决方案：检查是否在AndroidManifest.xml中声明了所有必要的权限，包括READ_MEDIA_IMAGES和READ_MEDIA_VIDEO（如果需要）。

另外，确保在运行时动态申请了这些权限，而不仅仅是在清单文件中声明。

总结与展望

本文详细介绍了如何使用Matisse相册选择器解决Android 13文件权限适配问题。通过合理配置权限、使用FileProvider和遵循最新的Android开发规范，我们可以确保应用在Android 13及以上设备上稳定运行。

Matisse作为一款优秀的开源库，不仅提供了完善的权限适配方案，还提供了丰富的功能和优美的界面。如果你正在开发需要图片选择功能的Android应用，Matisse绝对是一个值得考虑的选择。

未来，随着Android系统的不断更新，文件权限机制可能会继续变化。我们需要保持关注，及时更新我们的应用以适应新的变化。同时，也可以关注Matisse项目的更新，获取最新的适配方案。

希望本文对你解决Android 13文件权限适配问题有所帮助！如果你有任何问题或建议，欢迎在评论区留言讨论。

点赞+收藏+关注，获取更多Android开发实战技巧和最佳实践！下期我们将介绍Matisse的高级用法，敬请期待！

【免费下载链接】Matisse :fireworks: A well-designed local image and video selector for Android 【免费下载链接】Matisse 项目地址: https://gitcode.com/gh_mirrors/mati/Matisse

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值