如何使用Storage Attach Service实现公共存储访问替代私有存储访问

核心原因 #

Android 10（API 29）默认引入分区存储机制，仅声明读写外部存储权限无法直接访问公共目录，需要额外兼容配置。同时存储权限属于Android系统危险权限，仅在Manifest中声明无效，需要应用主动发起运行时权限申请。

第一步：修改AndroidManifest.xml配置 #

将复制到src/android/目录下的AndroidManifest.xml做两处修改：

1. 在<manifest>节点下保留已添加的权限声明：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

2. 在<application>节点中添加分区存储兼容属性：

<application
    android:requestLegacyExternalStorage="true"
    <!-- 原有其他属性保持不变 -->
    >

该属性仅对Android 10生效，Android 11及以上系统会自动忽略。

第二步：新增运行时权限申请逻辑 #

不能在静态代码块中直接初始化公共存储目录，静态代码块执行时权限还未完成申请，需要调整初始化逻辑，依赖Gluon Attach的PermissionsService完成动态权限申请：

1. 首先在pom.xml中引入PermissionsService依赖：

<dependency>
    <groupId>com.gluonhq.attach</groupId>
    <artifactId>permissions</artifactId>
    <version>4.0.13</version>
</dependency>

2. 调整原有代码逻辑：
   修改com.gluonhq.samples.connect.file.Main.java中的静态代码块，将存储初始化逻辑移动到权限申请成功之后执行：

// 先移除原有的static静态初始化块
private static File ROOT_DIR;

@Override
public void init() {
    // 申请存储权限
    Services.get(PermissionsService.class)
        .ifPresent(permissionsService -> {
            permissionsService.requestPermissions(
                PermissionsService.Permission.STORAGE,
                granted -> {
                    if (granted) {
                        // 权限申请成功后再初始化公共存储目录
                        ROOT_DIR = Services.get(StorageService.class)
                                    .flatMap(s -> s.getPublicStorage("Gluon"))
                                    .orElseThrow(() -> new RuntimeException("Error retrieving public storage"));
                        if (!ROOT_DIR.exists()) {
                            ROOT_DIR.mkdirs();
                        }
                        // 后续原有初始化逻辑（如加载user.json等）移到此处执行
                    } else {
                        throw new RuntimeException("存储权限未授予，无法使用公共存储");
                    }
                }
            );
        });
}

验证 #

重新执行mvn -Pandroid gluonfx:nativerun部署到设备，启动应用时会弹出存储权限申请弹窗，同意后即可正常创建Gluon公共目录并读写文件。

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