HarmonyOS Next-元服务开发详解

元服务是一种更加高效便捷的应用形式,免安装,有独立的入口,说的简单一点就像是把微信小程序放到系统层面,相比微信小程序更加快捷,因为连微信也不用打开了。

官方链接:developer.huawei.com/consumer/cn...

创建项目

元服务的创建和普通应用有所区别,我们要创建的是Atomic Service,模版选择Empty Ability就可以。

接下来要为元服务注册App ID,元服务和微信小程序类似,必须要有App ID才能进行开发。

一个元服务工程如下:

配置图标

在entry文件夹右键新建Image Asset,选择一个1024*1024的图片就可以设置为元服务的图标了。

开发元服务页面

进入正式的开发环节,依然打开pages文件夹下的Index文件, 在元服务中页面的开发、页面之间的跳转和普通应用一样,初始化文件依旧是个"hello world"

在元服务中,网络请求除了需要配置网络权限外,还要在应用中心配置域名白名单,这一点又和微信小程序类似。

打开应用中心的开发管理就可以配置域名,不过这种方式是有延迟和缓存的,在开发阶段可以在手机的开发者选项中开发元服务豁免开关,取消对域名的访问限制,然后就可以进行网络请求了。

开发卡片页面

卡片是元服务的一种快捷操作和入口,现在我们尝试常见一个卡片,在entey文件夹右键新建Dynamic Widget,创建完成之后可以发现工程目录中除了新建的卡片,还新增了entryformability文件夹,这是卡片的生命周期函数。

真机:两个手指捏合屏幕,在列表里选择程序就可以把卡片添加到桌面。

模拟器: 在桌面按住ctrl 实现双指缩放,在列表里选择程序就可以把卡片添加到桌面

数据传递

元服务和卡片是两套进程,并不能直接进行通信。所以我们这里使用用户首选项,先在元服务中将数据保存,再从卡片中取出数据.

首先在主应用中保存数据:

javascript 复制代码
let preferen = await preferences.getPreferences(context, "CardData")
await preferen.put('city', result.data.city)
await preferen.put('tianqi', weatherItem.weather)
await preferen.put('pm', weatherItem.air_quality)
await preferen.put('wendu', weatherItem.temperature)
preferen.flush()

点击卡片空白事件

javascript 复制代码
.onClick(() => {    
    postCardAction(this, {        
        action: 'message',        
        params: { msgTest: 'messageEvent' }
    })
})

这时候点击图片会调用entryformability文件中的onFormEvent方法

javascript 复制代码
// EntryAbility.ets
onFormEvent(formId: string, message: string) {    
    this.updateUI(formId)
}
async updateUI(formId:string){    
    let preferen = await preferences.getPreferences(this.context,'CardData')   
    let cityStr = await preferen.get('city', '0')    
    let tianqi = await preferen.get('tianqi', '0')    
    let pm = await preferen.get('pm', '0')    
    let wendu = await preferen.get('wendu', '0') 
    // 处理逻辑
    class FormDataClass {        
        city = cityStr        
        tianqi = tianqi         
        pm =  pm         
        wendu = wendu     
    }    
    let formData = new FormDataClass();    
    let formInfo: formBindingData.FormBindingData = formBindingData.createFormBindingData(formData);    formProvider.updateForm(formId, formInfo).then(() => { }).catch((error: BusinessError) => {  })
}

使用router事件跳转到指定UIAbility

通常使用按钮控件来实现页面拉起,示例代码如下:

  • 在卡片页面中布局两个按钮,点击其中一个按钮时调用postCardAction向指定UIAbility发送router事件,并在事件内定义需要传递的内容
  • 在UIAbility中接收router事件并获取参数,根据传递的params不同,选择拉起不同的页面
相关推荐
码界奇点29 分钟前
基于Vue3与TypeScript的后台管理系统设计与实现
前端·javascript·typescript·vue·毕业设计·源代码管理
ashcn200134 分钟前
水滴按钮解析
前端·javascript·css
爱吃奶酪的松鼠丶41 分钟前
React长列表,性能优化。关于循环遍历的时候,key是用对象数据中的ID还是用索引
javascript·react.js·性能优化
xkxnq1 小时前
第二阶段:Vue 组件化开发(第 17天)
javascript·vue.js·ecmascript
豆苗学前端1 小时前
你所不知道的前端知识,html篇(更新中)
前端·javascript·面试
sophie旭1 小时前
内存泄露排查之我的微感受
前端·javascript·性能优化
Hilaku3 小时前
我用 Gemini 3 Pro 手搓了一个并发邮件群发神器(附源码)
前端·javascript·github
全栈前端老曹3 小时前
【包管理】npm init 项目名后底层发生了什么的完整逻辑
前端·javascript·npm·node.js·json·包管理·底层原理
HHHHHY3 小时前
mathjs简单实现一个数学计算公式及校验组件
前端·javascript·vue.js