HarmonyOS元服务开发实践：桌面卡片字典

HarmonyOS开发者

发布于 2023-8-24 16:45

浏览

0收藏

本文转载分享自华为开发者论坛《HarmonyOS元服务开发实践：桌面卡片字典》，作者：蛟龙腾飞

一、项目说明

1.DEMO创意为卡片字典。

2.不同卡片显示不同内容：微卡、小卡、中卡、大卡，根据不同卡片特征显示同一个字的不同内容，基于用户习惯可选择喜欢的卡片。

3.万能卡片刷新：用户点击卡片刷新按钮查看新内容，同时卡片设置了定时刷新，让用户每天看到的卡片都是新的文字，便于用户学习和查阅。

4.元服务内具有搜索功能，用户可以通过搜索查询相应的字和解释，采用了类似现在用户习惯的上下滑动方式来进行逐字详细阐述。

5.基于API9、ArkTS语言开发，通过serverless云服务实现注册、登录等功能。

二、元服务效果

1. 万能卡片效果

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

2.元服务内页

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

三、项目开发

1. 环境搭建

软件要求：

DevEco Studio版本：DevEco Studio 3.1 Release及以上版本。

HarmonyOS SDK版本：API version 9及以上版本。

硬件要求：

设备类型：华为手机或运行在DevEco Studio上的华为手机设备模拟器。

HarmonyOS系统：3.1.0 Developer Release及以上版本。

2.主要代码结构解读

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

entry/src/main/ets: 文件入口

common：公共资源文件

images：公共图片资源

Constants.ts：公共常量

CountryViewModel.ts：国家号码类

LazyFE_Class.ets：懒数据加载类

Log.ts：日志类

components：封装组件文件

database：数据库封装类

data_cyhz.ets：数据文件

entryability：应用/服务入口

entryformability：卡片服务

pages：应用/服务页面

Auth.ets：认证授权

CloudFunction.ets：云函数

CloudProject.ets：云项目

CloudStorage.ets：云存储

Index.ets：主页

User_Login.ets：登录页

User_SignUp.ets：注册页

User_VerifyCodeLogin.ets：验证码登录页

services：后台操作类

widget：服务卡片

resources：资源文件目录

3.进入应用说明

由于创建的是云模板项目，所以无需额外配置SDK依赖，只需要注意的是，云模板的初始集成sdk位置不一样，所以我们还是在应用初始化阶段使用context初始化SDK，推荐在entryability的onCreate中进行。

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

4.首页

我们需要给应用添加底部菜单栏，用于切换不同的应用模块，由于各个模块之间属于完全独立的情况，并且不需要每次切换都进行界面的刷新，所以我们用到了Tabs，TabContent组件。

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

本应用一共有首页、我的两个模块，分别对应Tabs组件的两个子组件TabContent。

首页包含搜索文字和滑动浏览信息两个模块，具体代码实现我们将在下边分模块进行说明。

搜索文字：主要用到Search组件，通过搜索文字来跳转到相应的文字展示信息，主要代码如下：

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

浏览信息模块：主要用到swiper组件，通过数据的懒加载行为，来预缓存数据，通过滑动页面来展示文字信息，主要代码如下：

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

5.我的

我的页包含游客登陆、用户登录两个模块。

其中游客登陆不显示登录信息以及应用部分功能，仅能使用部分应用能力；

用户登录显示用户部分信息，并展开应用所有功能，需要用户注册登录；

具体代码实现我们将在下边分模块进行说明。

游客登录：

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

用户登录：

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

6.注册登录页面让用户进行账号注册，能够完全使用应用。

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区

核心代码：

...

.onClick(() => {
  if (this.phoneNumber !== '' && this.password !== '') {
    let verifyCodeSettings = new VerifyCodeSettingBuilder()
      .setAction(VerifyCodeAction.REGISTER_LOGIN)
      .setLang('zh_CN')
      .setSendInterval(60)
      .build();
    agconnect.auth().requestPhoneVerifyCode(this.countryCode, this.phoneNumber, verifyCodeSettings)
      .then(verifyCodeResult => {
        this.startTimer()
        //验证码申请成功
      }).catch(error => {
      //验证码申请失败
      Prompt.showToast({ message: "请输入正确的手机号和密码" + JSON.stringify(error) })
    });
  }else {
    Prompt.showToast({ message: "手机号和密码不能为空" })
  }
})

......
......

.onClick(() => {
  if (this.phoneNumber !== '' && this.password !== '') {
    let user = new PhoneUserBuilder()
      .setCountryCode(this.countryCode)
      .setPhoneNumber(this.phoneNumber)
      .setPassword(this.password) //可以给用户设置初始密码。填写后后续可以用密码来登录
      .setVerifyCode(this.VerifyCode)
      .build();
    agconnect.auth().createPhoneUser(user)
      .then(result => {
        // 创建用户成功
        AppStorage.Set('phoneNumber', user.phoneNumber)
        AppStorage.Set('password', user.password)
        AppStorage.Set('isVisitor', false)
        AppStorage.Set('isLogin', true)
        AppStorage.Set('userName', user.phoneNumber)
        router.pushUrl({
          url: "pages/Index"
        })
      })
      .catch(error => {
        // 创建用户失败
        Prompt.showToast({ message: "注册失败," + JSON.stringify(error),duration:4 })
      })
  } else {
    Prompt.showToast({ message: "手机号和密码不能为空" })
  }
})

7.其他云服务

说明：这是云模板初始业务，如有其他业务需求，可自行添加。

HarmonyOS元服务开发实践：桌面卡片字典-鸿蒙开发者社区