基于 OpenHarmony Matisse 三方件开发指南

2024-08-05 本文已影响0人迪士尼在逃程序员

1. Matisse 组件功能介绍

1.1. 功能介绍：

Matisse 组件是一个图片选择框架，实现图片的选择及使用相机进行拍摄，最后将选择
或拍摄的照片显示在 ability 中（目前初版还未实现所有功能）。

1.2. 模拟器上运行效果：

2. Matisse 使用方法

2.1. 新建工程，增加组件 Har 包依赖

在应用模块中添加 HAR，只需要将 Matisse.har 复制到 entry\libs 目录下即可（由于 build.gradle
中已经依赖的 libs 目录下的*.har，因此不需要在做修改）。

2.2. 修改主页面代码成为请求方

在 MainAbilitySlice 中构造 Intent 以及包含 Action 的 Operation 对象，并调用
startAbilityForResult()方法发起请求。然后重写 onAbilityResult()回调方法，对请求结果进行处
理。

private void pickPicture() {
    Intent intent = new Intent();
      Operation operation = new Intent.OperationBuilder()
        .withAction("action.pick_pic")
        .withBundleName("com.example.matisse")
        .withAbilityName("com.example.matisse.MatisseAbility")
        .build();
    intent.setOperation(operation);
    startAbilityForResult(intent, REQ_CODE_PICK_PIC);
}
@Override
protected void onAbilityResult(int requestCode, int resultCode, Intent resultData)
{
    switch (requestCode) {
    case REQ_CODE_PICK_PIC:
    // Do something with result.
    ...
    return;
    default:
    ...
  }
}

3. Matisse 开发实现

3.1. 新建一个 Module

新建一个 Module，类型选择 HarmonyOS Library，模块名为 Matisse，如图

3.2. 获得媒体库所有图片

新建一个 MatisseAbility 在其 slice 的 onStart 方法中申请权限并配制 config.json：

@Override
public void onStart(Intent intent) {
super.onStart(intent);
super.setUIContent(ResourceTable.Layout_ability_matisse);
String[] per={"ohos.permission.READ_USER_STORAGE"};
requestPermissionsFromUser(per,0);
}

为了获得媒体库所有图片（的 URI），需要定义一个 DataAbilityHelper，并设置 resultSet，代码如下：

DataAbilityHelper helper = DataAbilityHelper.creator(this);
try {
ResultSet resultSet =
helper.query(AVStorage.Images.Media.EXTERNAL_DATA_ABILITY_URI, null, null);
while (resultSet != null && resultSet.goToNextRow()) {
int mid =
resultSet.getInt(resultSet.getColumnIndexForName(AVStorage.Images.Media.ID))
;
Uri uri =
Uri.appendEncodedPathToUri(AVStorage.Images.Media.EXTERNAL_DATA_ABILITY_URI,
"" + mid);
FileDescriptor fileDescriptor = null;
fileDescriptor = helper.openFile(uri, "r");
ImageSource.DecodingOptions decodingOptions = new ImageSource.DecodingOptions();
decodingOptions.desiredSize = new Size(180, 320);
ImageSource imageSource = ImageSource.create(fileDescriptor, null);
PixelMap pixelMap =
imageSource.createThumbnailPixelmap(decodingOptions, true);
uris.add(new UriModel(uri, pixelMap));
}
} catch (DataAbilityRemoteException | FileNotFoundException e) {
e.printStackTrace();
}

由于 Listcontainer 目前不支持 grid 布局，所以取得所有图片的 uri 后对结果进行分组：

if(uris.size()>3) {
List<List<UriModel>> newList = arraySplitUtil.splistList(uris, 3);
for (List<UriModel> uriModel : newList) {
nestedLists.add(new NestedList(uriModel));
}
}else {
nestedLists.add(new NestedList(uris));
}

3.3. 新建 Listconainer 并使用嵌套方式实现相册视图：

listContainer = (ListContainer)
findComponentById(ResourceTable.Id_galley);
UltimateProvider ultimateProvider=new
UltimateProvider(nestedLists,getContext());
listContainer.setItemProvider(ultimateProvider);

这里使用了三方件 UltimateProvider 减少代码量编写。

3.4. 点击事件和回调处理

使用 DependentLayout 在图片布局右上方加上 checkbox，代码中 id_icon 为图片:

checkbox=(Checkbox)findComponentById(ResourceTable.Id_checked);
checkbox.setChecked(false);
icon.setClickedListener(new Component.ClickedListener() {
@Override
public void onClick(Component component) {
checkbox.toggle();
// getModel().getUri()
}
});
checkbox.setCheckedStateChangedListener((view, state) -> {
if (state) {
MatisseAbilitySlice.selectedSet.add(getModel());
}else {
MatisseAbilitySlice.selectedSet.remove(getModel());
}
});

回调：在 config.json 中增加"action.pick_pic"并在 MatisseAbility 中添加如下路由：

addActionRoute("action.pick_pic", MatisseAbilitySlice.class.getName());

新建使用按钮，并增加如下代码：

use.setClickedListener(new Component.ClickedListener() {
@Override
public void onClick(Component component) {
if (selectedSet.size()==0){
return;
}
else {
Intent resultIntent = new Intent();
resultIntent.setParam("model", (Serializable) selectedSet);
// Intent resultIntent = new Intent();
setResult(resultIntent);
}
}
});

3.5. 编译 HAR 包

利用 Gradle 可以将 HarmonyOS Library 库模块构建为 HAR 包，构建 HAR 包的方法如下：

在 Gradle 构建任务中，双击 PackageDebugHar 或PackageReleaseHar 任务，构建 Debug 类型或 Release 类型的 HAR。

待构建任务完成后，可以在工程目录中的 Matisse> bulid > outputs > har 目录中，获取生成的HAR 包。

写在最后

如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我三个小忙：
点赞，转发，有你们的『点赞和评论』，才是我创造的动力。
关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
想要获取更多完整鸿蒙最新学习知识点，请移步前往小编：https://gitee.com/MNxiaona/733GH/blob/master/jianshu