因为经常会用到文件操作相关的功能,而uniapp提供的H5+ IO模块管理本地文件系统,局限性真的非常非常大 ,所以写了一个原生的安卓文件操作插件。

        功能包括:创建目录、创建txt文件并写入内容、复制/移动/重命名/删除目录或文件、调用本机应用打开或分享文件、压缩/解压目录或文件、base64数据和本地图片的相互转换、获取文件列表等。

下面放了示例apk的二维码,感兴趣的可以下载体验一下:

插件地址

安卓文件操作插件 - DCloud 插件市场 icon-default.png?t=M3K6https://ext.dcloud.net.cn/plugin?id=7983#detail

平台兼容性

AndroidiOS
适用版本区间:5.0 - 11.0 支持CPU类型:armeabi-v7a,arm64-v8a,x86×

1、权限接口

1.1 判断并授权所有文件的管理权限

getFileManagePermission(res=>{
    console.log(res);
    res={
        "hasPermission":true/false
    }
});

2、文件操作接口

在调用文件操作接口之前,请先获取所有文件的管理权限

2.1 获取公共目录路径

getPublicPath({
    type: 0, //见注释1,0:获取外部存储目录路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "获取成功",
        "data":"获取的路径"
    }
    res={
        "code": 1,
        "message": "获取失败",
    }
})

2.2 创建目录

createDirectory({
    dirPath:"",//目录,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "目录创建成功",
    }
    res={
        "code": 1,
        "message": "目录创建失败",
    }
    res={
        "code": 2,
        "message": "目录已存在",
    }
})

2.3 创建TXT文件,并写入内容

createTxtFile({
    dirPath: "", // 文件所在目录,目录不存在则自动创建,使用绝对路径
    fileName: "", // 文件名称,不要添加后缀名,例如:MyTestFile
    messages: [], // 文件内容,字符串数组格式,写入时自动换行,例如:["第一条信息","第二条信息"]
    append: true, // true:文件已存在时在原文件内追加内容,false:文件已存在时覆盖原文件
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "文件创建成功"
    }
    res={
        "code": 1,
        "message": "文件创建失败"
    }
})

2.4 复制目录或文件

copyFile({
    fromPath: "", //待复制的目录或文件,使用绝对路径
    toPath: "", //要粘贴到的目录,目录不存在时自动创建,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "复制成功",
    }
    res={
        "code": 1,
        "message": "复制失败",
    }
    res={
        "code": 2,
        "message": "目录或文件不存在",
    }
    res={
        "code": 3,
        "message": "其他错误原因",
    }
})

2.5 重命名目录或文件

renameFile({
    oldPath: "", //待重命名的目录或文件,使用绝对路径
    newPath: "", //新目录或文件,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "重命名成功",
    }
    res={
        "code": 1,
        "message": "重命名失败",
    }
    res={
        "code": 2,
        "message": "目录或文件不存在",
    }
})

2.6 移动目录或文件

(本质上是先复制,再删除原文件)

moveFile({
    fromPath: "", //待移动的目录或文件,使用绝对路径
    toPath: "", //要移动到的目录,目录不存在时自动创建,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "移动成功"
    }
    res={
        "code": 1,
        "message": "移动失败",
    }
    res={
        "code": 2,
        "message": "目录或文件不存在",
    }
})

2.7 删除目录或文件

deleteFile({
    path: "", //目录或文件,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "删除成功",
    }
    res={
        "code": 1,
        "message": "删除失败",
    }
    res={
        "code": 2,
        "message": "目录或文件不存在",
    }
})

2.8 获取"当前目录"或"当前文件所在目录"下的所有文件和文件夹列表

getFileList({
    path: "", //目录或文件,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "读取成功",
        "data":[
            {
                "name":"文件名",
                "path":"文件绝对路劲",
                "isFile":"是否是文件",
                "isDirectory":"是否是目录",
                "lastModified":"最后一次修改时间",
                "length":"文件大小",
            }
            ……
        ]
    }
    res={
        "code": 1,
        "message": "读取失败",
    }
    res={
        "code": 2,
        "message": "目录或文件不存在",
    }
})

2.9 调用本机应用打开文件

openFile({
    filePath: '', //文件绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "调用成功",
    }
    res={
        "code": 1,
        "message": "调用失败",
    }
})

2.10 调用本机应用分享文件

shareFile({
    filePath: '', //文件绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "调用成功",
    }
    res={
        "code": 1,
        "message": "调用失败",
    }
})

2.11 Base64Data转本地图片

调用saveBase64Data方法时,'data:image/jpeg;base64,' 需要替换成''

saveBase64Data({
    base64Data: "", //base64数据,去掉开头的数据类型字符串"data:image/jpeg;base64,"
    filePath: "",//输出的图片文件路径,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "转换成功",
    }
    res={
        "code": 1,
        "message": "转换失败",
    }
})

2.12 本地图片转Base64Data

getBase64Data({
    filePath: '', //待处理的本地图片文件路径,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "转换成功",
        "data":'完整的base64数据'
    }
    res={
        "code": 1,
        "message": "转换失败",
    }
})

2.13 压缩目录或文件

compressFile({
    path:"", //要压缩的目录或文件,使用绝对路径
    zipFilePath: "", //压缩完成的Zip文件路径,使用绝对路径,允许重命名压缩文件
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "压缩成功",
    }
    res={
        "code": 1,
        "message": "压缩失败",
    }
})

2.14 解压zip文件

extractFile({
    zipFilePath: "", //要解压的Zip文件路径,使用绝对路径
    dirPath: "", //输出目录,即解压后的目录或文件所在目录,使用绝对路径
    rename: "",//重命名解压文件,可选参数
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "解压成功",
    }
    res={
        "code": 1,
        "message": "解压失败",
    }
})

2.15 通过安卓存储访问框架打开目录

openDirectoryBySAF({
    dirPath: "", //目录,使用绝对路径
},res=>{
    console.log(res);
    res={
        "code": 0,
        "message": "打开成功",
    }
    res={
        "code": 1,
        "message": "打开失败",
    }
})

3、注释

3.1 获取公共目录路径

type说明
0获取外部存储目录
1获取应用私有目录
2获取公共文档目录
3获取公共下载目录
4获取DCIM(相册)目录
5获取公共图片目录
6获取公共视频目录
7获取公共音乐目录
Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐