更新记录
0.0.2(2024-07-29)
增加删除系统相册中空相薄功能:removeEmptyAlbums
0.0.1(2024-05-31)
插件首发
平台兼容性
Android | iOS |
---|---|
× | 适用版本区间:13 - 17 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
插件使用注意事项
1、插件实现读取当前App在沙盒中的目录结构
2、用户可以通过选取系统“文件”App中文件项下载到当前App中,也可以从当前App中指定路径文件下载到系统“文件”App中
3、添加删除系统相册空相薄功能(注意:由于苹果系统原因,在程序循环删除过程中,会出现是否删除弹框,需要用户手动确认,用此功能需要添加访问相册权限)
4、使用过程如有需要增加接口、特殊版本兼容等问题,请联系我WX:YoungLNN,或者留言
5、接口使用说明见最下面 “API列表说明”
代码示例
API列表说明
1、下载系统“文件”App中数据到当前应用沙盒,注意:需要用户手动选择指定文件
API:downloadFileAppToCurrentApp
2、下载当前应用指定路径文件到系统“文件”App
注意:路径为网络地址URL或者沙盒绝对路径
a、如果为网络地址URL插件首先会异步网络请求数据下载到沙盒Documents/download目录下,然后在进行导入系统“文件”APP操作
b、如果为本地绝对路径,则直接进行导入系统“文件”APP操作
API:downloadFileToFileAppWithFilePath('xxx')
3、获取Documents目录下所有文件夹或者文件,返回数据为list
API:loadListItemsInDocumentsDirectoryCallback(ret=>{})
4、获取ApplicationSupport目录下所有文件夹或者文件,返回数据为list
API:loadListItemsInApplicationSupportDirectoryCallback(ret=>{})
5、获取Caches目录下所有文件夹或者文件,返回数据为list
API:loadListItemsInCachesDirectoryCallback(ret=>{})
6、获取Library目录下所有文件夹或者文件,返回数据为list
API:loadListItemsInLibraryDirectoryCallback(ret=>{})
7、获取MainBundle目录下所有文件夹或者文件
API:loadListItemsInMainBundleDirectoryCallback(ret=>{})
8、获取Temporary目录下所有文件夹或者文件,返回数据为list
API:loadListItemsInTemporaryDirectoryCallback(ret=>{})
9、获取指定目录下所有文件夹或者文件,返回数据为list
API:loadListItemsInDirectory("xxx",ret=>{})
10、判断路径是否为文件夹或者文件
API:checkPathIsDirectoryByPath("xxx",ret=>{})
11、删除系统相册中空相薄
API:removeEmptyAlbums