uniapp 本地离线打包文件读取权限如何获取

在uniapp中进行本地离线打包时，如何获取文件读取权限？我在Android平台上测试发现无法访问本地存储的文件，manifest.json中已经配置了android.permission.READ_EXTERNAL_STORAGE权限，但依然报错。请问还需要在哪里进行配置？是否需要修改原生代码？具体应该怎么操作？

2 回复

在uniapp离线打包中，获取文件读取权限需要在原生配置文件中添加权限声明：

Android：在AndroidManifest.xml中添加

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

iOS：在Info.plist中添加

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册</string>

同时需要在代码中动态申请权限，建议使用uni-app的权限API或原生权限申请方法。


在 UniApp 中进行本地离线打包时，文件读取权限的获取主要依赖于原生平台的权限申请机制。以下是针对 Android 和 iOS 平台的实现方法：

Android 平台

  1. 在 AndroidManifest.xml 中添加权限声明：

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

    对于 Android 10（API 29）及以上版本，若仅访问应用专属文件，可使用：

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

  2. 动态申请权限（在 Activity 中）：

    if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) 
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this, 
        new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 
        REQUEST_CODE);
}

  3. 处理权限回调：

    [@Override](/user/Override)
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) {
    if (requestCode == REQUEST_CODE) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限已授予
        }
    }
}

iOS 平台

  1. 在 Info.plist 中添加权限描述：

    <key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册以读取文件</string>
<key>NSDocumentsFolderUsageDescription</key>
<string>需要访问文档目录</string>

  2. 使用原生代码申请权限（如访问相册）：

    [PHPhotoLibrary requestAuthorization:^(PHAuthorizationStatus status) {
    if (status == PHAuthorizationStatusAuthorized) {
        // 权限已授予
    }
}];

UniApp 中通过条件编译调用原生方法

在 UniApp 的 .nvue 或通过 uni.requireNativePlugin() 调用原生模块，结合条件编译实现跨平台权限处理。

注意事项

  • Android 存储权限策略：从 Android 11 开始，使用分区存储，对外部存储访问受限，优先使用应用专属目录。
  • iOS 权限提示：确保 Info.plist 中描述清晰，避免审核被拒。
  • 测试：在真机上测试权限流程，模拟器可能无法完全模拟权限行为。

通过以上步骤，可在离线打包中正确获取文件读取权限。

回到顶部