HarmonyOS实战开发：刷新本地图片和网络图片

码农世界 2024-06-17 后端 107 次浏览 0个评论

在卡片上通常需要展示本地图片或从网络上下载的图片，获取本地图片和网络图片需要通过FormExtensionAbility来实现，如下示例代码介绍了如何在卡片上显示本地图片和网络图片。

下载网络图片需要使用到网络能力，需要申请ohos.permission.INTERNET权限，配置方式请参见配置文件权限声明。

在EntryFormAbility中的onAddForm生命周期回调中实现本地文件的刷新。

import formBindingData from '@ohos.app.form.formBindingData';
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import fs from '@ohos.file.fs';
import Want from '@ohos.app.ability.Want';
import Base from '@ohos.base';
import fileFs from '@ohos.file.fs';
export default class EntryFormAbility extends FormExtensionAbility {
  ...
 // 在添加卡片时，打开一个本地图片并将图片内容传递给卡片页面显示
 onAddForm(want: Want) {
   // 假设在当前卡片应用的tmp目录下有一个本地图片：head.PNG
   let tempDir = this.context.getApplicationContext().tempDir;
   // 打开本地图片并获取其打开后的fd
   let file: fileFs.File;
   let imgBear: Record;
   try {
     file = fs.openSync(tempDir + '/' + 'head.PNG');
     imgBear = {
       'imgBear': file.fd
     }
   } catch (e) {
     console.error(`openSync failed: ${JSON.stringify(e as Base.BusinessError)}`);
   }
   class FormDataClass{
     text: string = 'Image: Bear'
     imgName: string = 'imgBear'
     loaded: boolean = true
     formImages: Record = imgBear
   }
   let formData = new FormDataClass();
   // 将fd封装在formData中并返回至卡片页面
   return formBindingData.createFormBindingData(formData);
 }
  ...
}

在EntryFormAbility中的onFormEvent生命周期回调中实现网络文件的刷新。

import formBindingData from '@ohos.app.form.formBindingData';
import formProvider from '@ohos.app.form.formProvider';
import FormExtensionAbility from '@ohos.app.form.FormExtensionAbility';
import request from '@ohos.request';
import fs from '@ohos.file.fs';
import Base from '@ohos.base';
import fileFs from '@ohos.file.fs';
export default class EntryFormAbility extends FormExtensionAbility {
  // 在卡片页面触发message事件时，下载一个网络图片，并将网络图片内容传递给卡片页面显示
  onFormEvent(formId: string, message: string) {
    let param: Record = {
      'text': '刷新中...'
    };
    let formInfo: formBindingData.FormBindingData = formBindingData.createFormBindingData(param);
    formProvider.updateForm(formId, formInfo);
    // 注意：FormExtensionAbility在触发生命周期回调时被拉起，仅能在后台存在5秒
    // 建议下载能快速下载完成的小文件，如在5秒内未下载完成，则此次网络图片无法刷新至卡片页面上
    let netFile = 'https://xxxx/xxxx.png'; // 需要在此处使用真实的网络图片下载链接
    let tempDir = this.context.getApplicationContext().tempDir;
    let fileName = 'file' + Date.now();
    let tmpFile = tempDir + '/' + fileName;
    request.downloadFile(this.context, {
      url: netFile, filePath: tmpFile, enableMetered: true, enableRoaming: true
    }).then((task) => {
      task.on('complete', () => {
        console.info('ArkTSCard download complete:' + tmpFile);
        let file: fileFs.File;
        let fileInfo: Record ={};
        try {
          file = fs.openSync(tmpFile);
          fileInfo[fileName] = file.fd;
        } catch (e) {
          console.error(`openSync failed: ${JSON.stringify(e as Base.BusinessError)}`);
        }
        class FormDataClass{
          text: string = 'Image: Bear' + fileName
          imgName: string = fileName
          loaded: boolean = true
          formImages: object = fileInfo
        }
        let formData = new FormDataClass();
        let formInfo = formBindingData.createFormBindingData(formData);
        formProvider.updateForm(formId, formInfo).then(() => {
          console.info('FormAbility updateForm success.');
        }).catch((error: Base.BusinessError) => {
          console.error('FormAbility updateForm failed: ' + JSON.stringify(error));
        });
      })
      task.on('fail', (err: number) => {
        console.info('ArkTSCard download task failed. Cause:' + err);
        let param: Record = {
          'text': '刷新失败'
        };
        let formInfo: formBindingData.FormBindingData = formBindingData.createFormBindingData(param);
        formProvider.updateForm(formId, formInfo);
      });
    }).catch((err: Base.BusinessError) => {
      console.error('Failed to request the download. Cause: ' + JSON.stringify(err));
    });
  }
};

在卡片页面通过Image组件展示EntryFormAbility传递过来的卡片内容。

let storage = new LocalStorage();
@Entry(storage)
@Component
struct WidgetCard {
  @LocalStorageProp('text') text: string = '加载中...';
  @LocalStorageProp('loaded') loaded: boolean = false;
  @LocalStorageProp('imgName') imgName: string = 'name';
  build() {
    Column() {
      Text(this.text)
        .fontSize('12vp')
        .textAlign(TextAlign.Center)
        .width('100%')
        .height('20%')
      Row() {
        if (this.loaded) {
          Image('memory://' + this.imgName)
            .width('50%')
            .height('50%')
            .margin('5%')
        } else {
          Image('common/start.PNG')
            .width('50%')
            .height('50%')
            .margin('1%')
        }
      }.alignItems(VerticalAlign.Center)
      .justifyContent(FlexAlign.Center)
      Button('刷新')
        .height('15%')
        .onClick(() => {
          postCardAction(this, {
            action: 'message',
            params: {
              info: 'refreshImage'
            }
          });
        })
    }
    .width('100%').height('100%')
    .alignItems(HorizontalAlign.Center)
    .padding('5%')
  }
}

说明：

Image组件通过入参(memory://fileName)中的memory://**标识来进行远端内存图片显示，其中fileName需要和EntryFormAbility传递对象('formImages': {key: fd})中的key**相对应。

Image组件通过传入的参数是否有变化来决定是否刷新图片，因此EntryFormAbility每次传递过来的imgName都需要不同，连续传递两个相同的imgName时，图片不会刷新。

文件使用完成后必须关闭，否则会出现内存泄漏问题。系统不会自动关闭文件，开发者可以使用fs.closeSync来关闭文件。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
  - 鸿蒙NaPi组件进阶
    - HarmonOS高级技能
      - 初识HarmonOS内核
      - 实战就业级设备开发
        
        有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
        
        获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料
        
        《鸿蒙 (OpenHarmony)开发入门教学视频》
        
        《鸿蒙生态应用开发V2.0白皮书》
        
        《鸿蒙 (OpenHarmony)开发基础到实战手册》
        
        OpenHarmony北向、南向开发环境搭建
        
        《鸿蒙开发基础》
        
        ArkTS语言
        安装DevEco Studio
        运用你的第一个ArkTS应用
        ArkUI声明式UI开发
        .……
        
        《鸿蒙开发进阶》
        
        Stage模型入门
        网络管理
        数据管理
        电话服务
        分布式应用开发
        通知与窗口管理
        多媒体技术
        安全技能
        任务管理
        WebGL
        国际化开发
        应用测试
        DFX面向未来设计
        鸿蒙系统移植和裁剪定制
        ……
        
        《鸿蒙进阶实战》
        
        ArkTS实践
        UIAbility应用
        网络案例
        ……
        
        获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料
        
        总结
        
        总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。