HarmonyOS服务卡片——残奥会卡片 原创 精华
引言
2021年7月23日,东京奥运会开幕,中国国歌响彻东京,最终拿下38枚金牌、88枚奖牌。
2021年8月24日,东京残奥会开幕,中国残疾运动员出征东京,精彩正在继续…
需求分析
奥运会是国民最关注的体育赛事,无论是稳扎稳打的乒乓球,还是独占鳌头的跳水,我们对体育赛事和参赛选手都如数家珍,然而十几天后的残奥会却鲜为人知。本APP旨在为用户打造一款能够快速了解残奥会动态和相关知识的应用,让更多人关注到残奥会,关注这群同样为国家争取荣誉的运动员们。
主要功能介绍
长按残奥会服务卡片应用,点击服务卡片选项,即可显示已开发的服务卡片。根据三种不同规格尺寸的服务卡片,可以分别查看残奥会奖牌榜、残奥会赛事、以及残奥会的中国运动员信息。具体如下:
1、服务卡片(2×2)
2×2的卡片样式为东京残奥会会标,效果如下图1所示:
图1 2×2卡片样式
点击该卡片即可跳转至奖牌榜页面,查看各国奖牌数量。如图2所示:
图2 奖牌榜
2、服务卡片(2×4)
在2×4的卡片中,左边对东京残奥会吉祥物进行展示;右边选取了四个东京残奥会赛事图片进行展示,效果如图3所示:
图3 2×4卡片样式
点击卡片即可进入应用的主界面查看具体项目,主界面如图4所示:
图4 主界面
点击主界面中的任意一个赛事图标即可进入赛事的详情界面,如图5所示:
图5 赛事项目简介
3、服务卡片(4×4)
在4×4的卡片中,上方展示的是东京残奥会吉祥物,下方展示的是我们选取的参加本次残奥会的中国运动员图片。点击卡片即可进入主界面查看各位中国运动员的详细信息。
图6 4×4卡片样式
技术实现
一.创建工程
打开DevEco Studio,点击File→New→New Project;选择Empty Ability(Java);点击”Next“按钮;即可进入项目配置界面。在此界面中,Project Name项目名称可自定义,此处命名为ParalympicGamesCard;Project Type项目类型选择应用Application;Package Name包名会根据前面的信息自动生成;Save Location存储路径可自行设置;Compatible API Version可兼容的API版本此处选择版本4;Device Type设备类型选择Phone。在完成配置信息设置后,点击”Finish“按钮,即可成功创建项目。具体配置信息可参考图7。
图7 配置项目
二.残奥会服务卡片实现
1.卡片生成
1)在项目包名上点击右键,选择New→Service Widget。
图8 创建卡片
2)选择服务卡片种类,用户可以选择Template下任意一种模板,选中后点击Next。
图9 选择模板
3)配置服务卡片信息。其中Service Widget Name卡片名称可以自定义;Description详细信息用户也可以自定义;Ability默认会使用MainAbility;Type类型可以根据实际开发情况选择JAVA或者JS语言;Support Dimensions支持的样式可以勾选后两个,这样就可以得到22、24、4*4三种尺寸的服务卡片。点击”Finish“按钮即可完成服务卡片的创建。
图10 配置服务卡片
2.卡片布局
本APP中三种卡片的布局分别在下图红框的xml文件中进行配置,文件名的尾数如”2_2“表示的是2*2服务卡片的布局文件,其余两个尾数分别为”2_4“和”4_4“的xml文件同理。
图11 xml文件
下面以2*2服务卡片为例讲解布局的实现。界面包含一张Image图片和一个Text文本框,将Text的文字设置为“残奥会奖牌榜”,并通过height、width、margin等设置两个控件的高度、宽度、间隔等属性。
3.卡片信息创建、更新、删除
对卡片进行操作时,需要对创建的卡片信息进行持久化操作,以便再次获取或更新卡片实例时能够直接使用,即需要存储卡片信息。主要采用对象关系型数据库来实现,需要重写如下几个函数:表示创建卡片的回调函数onCreateForm()、表示更新卡片信息的onUpdataForm()、以及表示销毁卡片和删除卡片信息onDeleteForm()。卡片需要的存储信息包括:卡片ID、卡片名称、卡片尺寸大小(22、24、4*4),这些回调函数在创建服务卡片时即可自动生成。回调函数代码如下:
4.将卡片在桌面上创建快捷方式
下面我们讲解如何在桌面上创建三种不同尺寸卡片的快捷方式。
第一步:长按APP图标,点击服务卡片。如图12所示:
图12 点击服务卡片
第二步:用户将喜爱的卡片选择“添加到桌面”,如图13所示:
图13 添加到桌面
第三步:用户选择喜欢的卡片添加到桌面上,则桌面会出现对应的服务卡片。如图14所示:
图14 添加桌面效果
5.卡片的点击跳转
点击 22服务卡片后默认跳转至奖牌榜显示页面,24服务卡片默认跳转至主界面,再点击主界面的各赛事图标按钮进入赛事项目详情页面。下面详细介绍一下如何实现上述提到的页面跳转功能。
1)AoyunhuiwidgetImpl文件设置
在widght文件下的AoyunhuiwidgetImpl卡片设置文件中,需要重写bindFormData()方法。通过switch…case…方式控制跳转的具体指向,当卡片尺寸为22时,跳转指向的Ability名称为MainAbility2;当卡片尺寸为24时,跳转指向的Ability名称为MainAbility。
图15AoyunhuiwidgetImpl文件位置
2)MainAbility2Slice文件设置
在MainAbility2Slice文件中,调用webview()方法,将url地址作为入参传入方法中,完成设置需要跳转的奖牌榜网页url地址,实现点击2*2卡片后跳转至奖牌榜显示页面的效果。
3)MainAbilitySlice文件设置
第一步:主界面布局
APP的主界面布局定义在ability_main.xml文件中,界面包含7个Image图片和6个Text文本框。其中,7个Image图片包括一个首页装饰图和六个赛事项目图标;6个Text文本框用于显示赛事项目的名称。在设置好各控件的相关属性之后,通过setUIContent()方法将ability_main.xml文件设置为APP的主界面布局。代码如下,布局效果可参考图16。
图16 主界面布局
第二步:主界面跳转至赛事项目详情界面
在MainAbilitySlice文件的onStart()方法中,通过findComponentById()的方法,实现上面1)AoyunhuiwidgetImpl文件设置小节中提到的赛事项目的定位。以举重项目为例,在主界面中,获取“举重”项目的图片控件,并为其设置onClick()点击跳转事件,将跳转指向的Ability名称withAbilityName()设置为举重页面的Ability,即WeightliftingAbility,实现点击举重图片后跳转至举重项目详情页面的效果,具体代码如下:
第三步:举重项目详情界面WeightliftingAbilitySlice
WeightliftingAbilitySlice举重项目详情界面实现原理和第一步主界面实现原理相似。在ability_weightlifting.xml文件中界面包含Image图片和Text文本框控件,其中图片用来存放举重比赛照片,Text文字用来存放举重项目的文字介绍。在完成设置各控件属性后,通过setUIContent()方法将ability_weightlifting.xml文件设置为举重项目详情界面布局。举重项目详情界面效果可参考图17。
图17 举重项目详情界面
项目贡献人
胡鹏达 李珂 张馨心 郑森文 朱伟 陈美汝
小姐姐的文章一如既往的很棒
棒棒滴
谢谢支持!
哈哈哈哈哈 虽然没赶上卡片开发大赛,还是要把作品发出来的~
用心了,棒棒哒
谢谢支持!
棒棒的……✔
支持支持,
谢谢支持!
谢谢支持!
赞一个,学习学习
谢谢支持!
用心之作,赞!
谢谢您看到我们的心意!
创作辛苦,好贴必回。
谢谢您的支持!