关于元服务项目的创建与多线程

1. 元服务项目 刚建立的元服务项目类似一个微信小程序它需要创建一个卡片来建立联系通过点击卡片可以进入元服务项目。 例如该项目只有一个HelloWorld页面如果不建立卡片在退出该元服务项目页面并清空后台将无法再次进入该元服务项目。 2. 创建卡片 在根目录的src/main/ets下新建Service Widget下的Service Widget文件选择完模版格式后编译器会提供两个文件entryformability和你自己命 名的卡片文件名 如我的文件名是mywideget那么编译器会在这两个文件夹生成两个文件mywidget.ts和entryformability.ts 3. EntryFormAbility文件 该文件是卡片的入口文件里面定义了卡片的属性比如卡片的图标名称描述以及卡片的启动方式 onAddForm(want: Want){...}是卡片启动方式当点击卡片时会调用这个方法 用户添加卡片到桌面时系统会创建并初始化 EntryFormAbility执行 onAddForm 完成卡片数据绑定。 生命周期回调执行完毕后EntryFormAbility 不会一直运行大约 10 秒后会被系统回收销毁 !-----------------------------------------------------------------------------------formBindingData.createFormBindingData(formDate2) formBindingData: 鸿蒙提供的表单数据绑定模块可以将数据绑定到表单中。 createFormBindingData: 将普通的 JS/TS 对象 (formDate2) 转换成系统能识别的 FormBindingData 对象。 这一步是卡片运行在桌面进程你的应用运行在应用进程数据需要序列化打包才能跨进程传递formDate2是普通对象需要转换成FormBindingData对象。 return formBindingData.createFormBindingData(formData); 可以返回数据给卡片卡片接收到数据后会显示在卡片上。 wantParams: Recordstring, Object 是一种用于在 Ability 之间传递数据的键值对参数类型它是 Want 对象中 parameters 属性的类型定义。 !------------------------------------------------------------------------------------ formProvider.updateForm(formId, bindData); formProvider: 表单提供者模块。 updateForm: 这是真正触发桌面卡片刷新的 API。 参数: formId: 告诉系统更新哪一张卡片。 bindData: 告诉系统用什么新数据来渲染。 结果: 执行后用户桌面上的卡片文字会从“卡片标题 1和“卡片内容 1立刻变成“卡片标题 2和“卡片内容 2。 !----------------------------------------------------------------------------------- wantParams[formInfo.FormParam.IDENTITY_KEY] as string formInfo.FormParam.IDENTITY_KEY: 这是一个系统常量通常对应字符串 formId。 wantParams[...]: 从参数中取出这个 key 对应的值。 formId: 这是当前卡片实例的唯一身份证。 如果用户在桌面上添加了两个相同的卡片它们会有不同的 formId。 你要更新哪一个卡片就必须知道它的 formId 4. mywidget.ts文件 该文件是卡片的逻辑文件里面定义了卡片的逻辑比如点击卡片后跳转到新的页面点击卡片后执行某个方法点击卡片后显示某个弹窗等等 !------------------------------------------------------------------------------------ Entry(localStorage) 将 LocalStorage 实例注入到页面根组件使得 当前页面内所有子组件自动获得对该 LocalStorage 实例的访问权限 无需逐层传递状态子组件通过 LocalStorageProp 或 LocalStorageLink 即可绑定状态 实现跨组件状态同步兄弟组件、父子组件可通过同一个 LocalStorage 实例通信 !------------------------------------------------------------------------------------ 5. dataPreferences 是鸿蒙提供的 轻量级键值对key-value持久化存储。简单理解一个可以跨进程访问的公共记事本。 适用场景 保存少量简单数据formId、用户名、设置项 主应用 ↔ 卡片 之间共享数据多进程场景 重启 APP 数据不丢失 特点 键值对存储简单好用 异步 API必须用 async/await 跨进程共享卡片 主应用都能读写 持久化存在手机本地文件 AppStorage与其不同AppStorage是只能在同一进程下使用卡片和主页面是两个独立进程共享数据必须用公共存储 dataPreferences 卡片和主页面 不在同一个房间进程隔离卡片 房间 A主页面 房间 B两个房间完全隔离不能互相看见对方的变量AppStorage 是房间内的备忘录 只能在自己房间用不能跨房间共享 导入模块 EntryFormAbility与Index都要加 import dataPreferences from ohos.data.preferences; 异步保存到 dataPreferences不阻塞卡片加载卡片中保存 formId (async () { let pref await dataPreferences.getPreferences(this.context, my_form_store); await pref.put(formId, formId); console.log(卡片保存 formId 成功, formId); })(); 主页面读取 formId 并更新卡片 let pref await dataPreferences.getPreferences(getContext(), my_form_store); this.formId await pref.get(formId, ) as string; 上下文 context 区别 卡片中EntryFormAbility使用this.context 主页面中Index.ets使用getContext() 为什么卡片保存要用 (async () {})() 包裹 onAddForm 是同步生命周期方法不允许加 async 包裹异步函数可以不阻塞卡片初始化保证卡片正常显示 存储名称必须一致 保存和读取时第二个参数必须相同如 my_form_store 名称不同会导致数据找不到formId 读取为空 数据类型说明 dataPreferences 支持存储字符串、数字、布尔等简单类型 不支持直接存储对象复杂数据需转为 JSON 字符串 删除某条数据await pref.delete(formId) 清空所有数据await pref.clear() !--------------------------------------------------------------------------------