* ## 关于uniapp实现app端文件管理
* #### 前言
* #### 安卓是如何实现的
* #### uniapp中几种实现方式
* #### 文档里需要用到的主要api介绍
* #### 实现
### 前言
最近,用uniapp写一个app,其中有个功能,需要访问SDcard中的目录和文件,在查阅uniapp官方文档后,发现文档给出的api不支持app端,只能用html5+native.js去获取。于是,在踩了无数坑之后,就有了这篇记录。
### 安卓是如何实现的
> 安卓针不同的版本实现的方法有所不同, Android 6 (API 23) 之前应用的权限在安装时全部授予,运行时应用不再需要询问用户。在 Android 6.0 或更高版本对权限进行了分类,对某些涉及到用户隐私的权限可在运行时根据用户的需要动态授予
#### Android 10
1. 需要在 AndroidManifest.xml 中添加 android.permission.WRITE_EXTERNAL_STORAGE 和 android.permission.READ_EXTERNAL_STORAGE 进行权限申请。
2. application 中设置 android:requestLegacyExternalStorage="true"
3. 然后需要动态的请求权限
#### Android 11
1. 需要在 AndroidManifest.xml 中添加 android.permission.MANAGE_EXTERNAL_STORAGE
2. 需要动态获取权限
3. 参考 [android 11 获取全部文件权限](https://blog.csdn.net/MoonAndroid/article/details/122824697)
4. 参考 [Android 10、11 存储完全适配](https://blog.csdn.net/xhmj12/article/details/119121528)
5. 参考 [Android Q中文件沙盒模式读写文件 08-16](https://www.jianshu.com/p/15520bc3f5c6)
6. 参考 [Android开发之 permission动态权限获取](https://blog.csdn.net/generallizhong/article/details/99716283)
7. 参考 [Android 获取某个文件夹下的所有文件](https://blog.csdn.net/qq_19688207/article/details/112926785)
8. 参考 [Java--getAbsolutePath()获取绝对路径和相对路径getPath()getName()listFiles()](https://www.cnblogs.com/shunguo/p/14508543.html)
### uniapp中几种实现方式
> 1. 使用 web-view , 指向一个 html 文件, 在html文件里面用input实现
> 2. 用 html5+和native.js
> 3. 参考 [HTML5+规范5+Specification](https://www.html5plus.org/doc/h5p.html)
### 文档里需要用到的主要api介绍
> 1. [requestPermissions](https://www.html5plus.org/doc/zh_cn/android.html) 获取授权 !!!!此api十分重要,如果不用这个api获取权限的话,就只能读取沙盒或公共媒体文件夹里的文件, requestPermissions 需要传入三个参数 第一个是权限数组,第二个成功回调方法,第三个是失败回调
> 2. [runtimeMainActivity](https://www.html5plus.org/doc/zh_cn/android.html#plus.android.requestPermissions) 我原本以为之只是获取一个Activity实例后来才发现它相当于 Android中的 Context
> 3. [importClass](https://www.html5plus.org/doc/zh_cn/android.html#plus.android.requestPermissions) 这个api是导入包的api 你可以到导入java包写原生
> 4. [newObject](https://www.html5plus.org/doc/zh_cn/android.html#plus.android.newObject) 有了这个api感觉可以将 importClass 丢一边去了,这个api是将导入和实例化合并了,第一次参数填要导入的包,第二个填实例化的需要传递的参数
> 5. [invoke](https://www.html5plus.org/doc/zh_cn/android.html#plus.android.invoke) 这个api是调用方法!!!十分重要
> 6. [IO](https://www.html5plus.org/doc/zh_cn/io.html) IO模块管理本地文件系统,用于对文件系统的目录浏览、文件的读取、文件的写入等操作
### 实现
1. #### 打开文件管理器
``` js
// 获取应用主Activity实例对象
const MAIN = plus.android.runtimeMainActivity();
const INTENT = plus.android.importClass('android.content.Intent'); // 导入 Intent 类
const INTENT_OBJ = new INTENT(INTENT.ACTION_GET_CONTENT);
INTENT_OBJ.addCategory(INTENT.CATEGORY_OPENABLE); // 创建分类
INTENT_OBJ.setType("*/*"); // 设置类型, 任意类型 image/* video/* ....
// intent.putExtra(Intent.EXTRA_MIME_TYPES, 'image/*'); 设置多个类型
// intent.setDataAndType(mUri,"image/*");
MAIN.onActivityResult = (requestCode, resultCode, data) => {
// ... 选择的文件data
MAIN.startActivityForResult(INTENT_OBJ, 1);
-
获取外部存储权限
const permissionsList = [ "android.permission.WRITE_EXTERNAL_STORAGE", "android.permission.READ_EXTERNAL_STORAGE" ]; plus.android.requestPermissions(permissionsList,(e)=>{ // ... 注: e里面包括了永久拒绝,拒绝,同意授权这些信息 })
-
判断安卓版本
let Build = plus.android.importClass('android.os.Build'); let isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT;
-
判断格式是否是uri类型的
let DocumentsContract = plus.android.importClass('android.provider.DocumentsContract'); // 判断是否是这个格式的url content://com.android.providers.media.documents/document/image%3A82482 let isSystemUri = DocumentsContract.isDocumentUri(MAIN, uri);
-
打开文件文件管理器选择文件返回绝对路径
/** * TODO 系统自带的文件管理器 中 最近/图片/视频。。。等直接获取 codid会是类型+文件id 没有之前的路径 需要检测添加 * https://blog.csdn.net/qq_43278826/article/details/101672670 * https://www.runoob.com/w3cnote/android-tutorial-intent-base.html * https://juejin.cn/post/7012108220982362149 * @method openFileManager 打开系统文件管理器 选择文件放回文件路径 * @description uniapp 没有提供打开安卓文件管理器的api 必须使用 input 或 plus * */ openFileManager: function() { // platform 系统 browserVersion 系统版本 const {platform, browserVersion} = uni.getSystemInfoSync(); if(platform == 'android') { const Activity = plus.android.runtimeMainActivity(); // 获取 Activity const Intent = plus.android.importClass("android.content.Intent"); // 导入 Intent let initen_new = new Intent(Intent.ACTION_GET_CONTENT, null); // 实例化 Intent 并允许 获取的是所有本地文件 可设置文件格式用于限制 initen_new.setType("*/*"); // 设置类型 */* 无类型限制 initen_new.addCategory(Intent.CATEGORY_OPENABLE); // Activity.startActivityForResult(initen_new, 1); // 启动Activity 打开系统的文件管理器 /** * onActivityResult 安卓中 用于从其他页面返回时带回数据 * */ Activity.onActivityResult = (requestCode, resultCode, data) => { // console.log("打开文件管理器后选择的文件返回了", requestCode, resultCode, data); // 打开文件管理器后选择的文件返回了 const Uri = data.getData(); plus.android.importClass(Uri); const DocumentsContract =plus.android.importClass("android.provider.DocumentsContract"); const Build = plus.android.importClass('android.os.Build'); let isKitKat = Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT; // 判断安卓版本是否大于 4.4 /** * uri=content://com.android.providers.media.documents/document/image%3A293502 4.4以后 * uri=file:///storage/emulated/0/temp_photo.jpg * uri=content://media/external/images/media/193968 * * uri=content://media/external/images/media/13 4.4以前 */ if(DocumentsContract.isDocumentUri(Activity, Uri)){ // 获取文件类型和id const DocId = DocumentsContract.getDocumentId(Uri); const [Type, Id] = DocId.split(":"); // 解析出数字格式的id // console.log("文件类型和id",Type, Id); let authority = Uri.getAuthority(); // if(authority == "com.android.providers.media.documents") { const MediaStore = plus.android.importClass('android.provider.MediaStore'); let contentUri = null; let selection = "_id=?"; let selectionArgs = [Id]; // TODO 有些文件夹下文件无法获取uri应当是此处问题 switch(Type) { case 'image': contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI ;break; case 'video': contentUri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI ;break; case 'audio': contentUri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI ;break; } this.getDataColumn(Activity, contentUri, selection, selectionArgs); } else if(authority == "com.android.providers.downloads.documents"){ const ContentUris = plus.android.importClass('android.content.ContentUris'); let contentUri = ContentUris.withAppendedId(Uri.parse("content://downloads/public_downloads"), DocId); this.getDataColumn(Activity, contentUri); } else if(authority == "com.android.externalstorage.documents"){ const Environment = plus.android.importClass('android.os.Environment'); if("primary" == Type) { console.log("类型为primary的文件地址:", `${Environment.getExternalStorageDirectory()}/${Id}`); } else { const System = plus.android.importClass('java.lang.System'); console.log("类型非primary的文件地址",`${System.getenv("SECONDARY_STORAGE")}/${Id}`); } } } else if("content" == Uri.getScheme()) { this.getDataColumn(Activity, Uri); } else if("file" == Uri.getScheme()) { console.log("文件路径:", uri.getPath()); } } } console.log("当前手机的系统是",platform); }, /** * uri转路径转换 * @method getDataColumn uri转路径转换 * @param {Obejct} activity 安卓的实例 * @param {Obejct} uri 获取到的文件地址 * @param {String} selection * @param {Array} selectionArgs 文件的id数组 * */ getDataColumn: function(activity, uri, selection = null, selectionArgs = null) { /** * 官方,提供了两个, 用来将绝对路径和平台路径互相转换的api * plus.io.convertAbsoluteFileSystem(path) 将平台绝对路径转换成本地URL路径 * plus.io.convertLocalFileSystemURL(url) 本地URL路径转换成平台绝对路径 * 绝对路径符合各平台文件路径格式,通常用于Native.JS调用系统原生文件操作API,也可以在前面添加“file://”后在html页面中直接使用。 */ plus.android.importClass(activity.getContentResolver()); let cursor = activity.getContentResolver().query(uri, ['_data'], selection, selectionArgs, null); plus.android.importClass(cursor); if (cursor != null && cursor.moveToFirst()) { let column_index = cursor.getColumnIndexOrThrow('_data'); let result = cursor.getString(column_index) cursor.close(); uni.getFileInfo({ filePath: result, success: (res) => { console.log(res); } }) return result; } return null; }
-
获取用户所有以安装程序
/** * @method getAllApply 获取用户所有已安装程序 * */ getAllApply: function() { const main = plus.android.runtimeMainActivity(); // 此处相当于 context let pManager = plus.android.invoke(main, 'getPackageManager'); let pInfo = plus.android.invoke(pManager, 'getInstalledPackages', 0); let total = plus.android.invoke(pInfo, 'size'); // 遍历获取包名和应用名称 for (let i = 0; i < total; i++) { // 获取包名 let packName = plus.android.getAttribute(plus.android.invoke(pInfo, 'get', i), 'packageName'); // 获取包名对应的应用名 let obj = plus.android.invoke(pManager, 'getApplicationInfo', packName, 0); let appName = plus.android.invoke(pManager, 'getApplicationLabel', obj); console.log(packName, appName); } }
-
获取根目录
/** * @method getRootSDCar 获取手机外部存储目录 * @description 用于获取手机的外部存储目录 * */ getRootSDCar: function() { // .... 在只用之前一定要仙获取权限 不然只能访问到沙盒里的内容 // 获取root目录路径 const Environment = plus.android.importClass("android.os.Environment"); // getExternalStorageDirectory 获取外部存储目录即 SDCard // getRootDirectory 获取 Android 的根目录 即系统主目录 let data = Environment.getExternalStorageDirectory(); let rootPath = plus.android.invoke(data, "getAbsolutePath"); console.log("根目录", rootPath); }
-
获取绝对路径
/** * @method getAbsolutePath 获取绝对路径 * */ getAbsolutePath: function() { /* StorageEventListener中有onStorageStateChanged()方法,当sd卡状态改变时, 此方法会调用,对各状态的判断一般会用到Environment类,此类中包含的有关sd卡状态的常量有: MEDIA_BAD_REMOVAL: 表明SDCard 被卸载前己被移除 MEDIA_CHECKING: 表明对象正在磁盘检查 MEDIA_MOUNTED: 表明sd对象是存在并具有读/写权限 MEDIA_MOUNTED_READ_ONLY: 表明对象权限为只读 MEDIA_NOFS: 表明对象为空白或正在使用不受支持的文件系统 MEDIA_REMOVED: 如果不存在 SDCard 返回 MEDIA_SHARED: 如果 SDCard 未安装 ,并通过 USB 大容量存储共享 返回 MEDIA_UNMOUNTABLE: 返回 SDCard 不可被安装 如果 SDCard 是存在但不可以被安装 MEDIA_UNMOUNTED: 返回 SDCard 已卸掉如果 SDCard 是存在但是没有被安装 */ const main = plus.android.runtimeMainActivity(); // 此处相当于 context const Build = plus.android.importClass('android.os.Build'); const Environment = plus.android.importClass("android.os.Environment"); let state = Environment.getExternalStorageState(); // 返回sd卡状态 let isState = plus.android.invoke(state,'equals', Environment.MEDIA_MOUNTED); let dir = null; if(isState) { if(Build.VERSION.SDK_INT >= 29) { /* DIRECTORY_MUSIC 音乐存放 DIRECTORY_PODCASTS 系统广播 DIRECTORY_RINGTONES 系统铃声 DIRECTORY_ALARMS 系统提醒铃声 DIRECTORY_NOTIFICATIONS 系统通知铃声 DIRECTORY_PICTURES 图片存放 DIRECTORY_MOVIES 电影存放 DIRECTORY_DOWNLOADS 下载 DIRECTORY_DCIM 相机拍摄照片和视频 */ // dir = main.getExternalFilesDir(Environment.DIRECTORY_MUSIC) // 获取音乐; // dir = main.getDataDir(); // > data/形式的路径 // getDataDirectory dir = main.getExternalFilesDir(null); // 获取当前app下面的flies文件夹 this.path = plus.android.invoke(dir,"getAbsolutePath"); // 获取绝对路径 console.log("获取此应用下Flies文件夹路径",plus.android.invoke(dir,"getAbsolutePath")); /* // 获得父目录 this.filePath = plus.android.invoke(dir, "getParentFile"); console.log("父目录",plus.android.invoke(this.filePath, "getName")); // 拥有的文件 let child = plus.android.invoke(dir, "listFiles"); for(let i = 0 ;i<child?.length;i++){ this.childPath.push(plus.android.invoke(child[i], "getAbsolutePath")) console.log("是子文件",plus.android.invoke(child[i], "getAbsolutePath")); } */ } else { dir = Environment.getRootDirectory() } } },
-
通过绝对路径获取此路径下所有子文件 HTML5+ 实现
plus.io.resolveLocalFileSystemURL(`/storage/emulated/0/`,(metadata)=>{ // ... 需要获取权限 // metadata.isDirectory // 判断是是否是文件夹 // metadata.isFile();//判断是是否是文件 let directoryReader = metadata.createReader(); // 创建一个目录对象 获取下面的子文件 directoryReader.readEntries((entries)=>{ for (var i = 0; i < entries.length; i++) { console.log("文件信息:" + entries[i].name); } }, (err)=>{})
-
通过绝对路径获取此路径下所有子文件 偏向与原生 实现
getAllTheChildFiles: function(path){ this.childPath = [] const main = plus.android.runtimeMainActivity(); // 此处相当于 context const Build = plus.android.importClass('android.os.Build'); // 判断 sd卡状态 const Environment = plus.android.importClass("android.os.Environment"); const state = Environment.getExternalStorageState(); const isState = plus.android.invoke(state,'equals', Environment.MEDIA_MOUNTED); if(isState) { // 调用java File包实现 // let File = plus.android.importClass("java.io.File"); // let File_new = new File(metadata.toLocalURL()); const File = plus.android.newObject("java.io.File", `${path}`); // 导入包并new这个类 const exists = !plus.android.invoke(File, "exists"); // 判断路径是否存在 if(exists) return; const listFiles = plus.android.invoke(File, "listFiles");// 获取子文件列表 this.filePath = `${path}` for(let i = 0; i<listFiles.length;i++){ const name = `${plus.android.invoke(listFiles[i], "getName")}`; const isFile = plus.android.invoke(listFiles[i], "isDirectory"); } } }
标签:uniapp,01,const,文件,获取,plus,let,android
From: https://www.cnblogs.com/tsuru/p/16871813.html