版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
实训指导手册:开发新闻客户端-实现新闻服务卡片项目名称:新闻客户端开发-网络请求与服务卡片实践实训任务:任务3实现新闻服务卡片核心目标:掌握鸿蒙服务卡片的生命周期管理、动态卡片布局与交互逻辑;能够独立完成卡片的创建、数据绑定、刷新与点击事件处理,并实现卡片与宿主App的联动跳转,最终在桌面展示可刷新、可点击的热点新闻卡片。任务总览在本任务中,你将完成新闻客户端的新闻服务卡片开发。该卡片为动态卡片,展示2条热点新闻,支持下拉刷新更新内容,点击新闻可拉起新闻详情页。你需要掌握服务卡片的创建与配置、生命周期回调的使用、卡片布局与数据绑定、卡片与App的交互原理,以及常见问题的定位与解决。操作步骤1.在项目中添加新闻列表服务卡片鼠标右击项目的entry文件夹,在弹出的菜单中依次点击New/ServiceWidget/DynamicWidget,然后在弹出的界面中选择合适的服务卡片模版(HelloWorld),点击Next,出现服务卡片配置界面,如图6-15、图6-16、图6-17。图6-15菜单图6-16选择服务卡片模版图6-17配置服务卡片在图6-17界面,输入服务卡片的名称、显示名称、卡片描述、编写语言、卡片尺寸、默认尺寸、能力名称等信息,点击完成,项目变化,如图6-18。图6-18项目结构2.理解服务卡片在项目中的相关配置通过利用开发工具添加新闻服务卡片NewsListWidget后,系统自动在项目中创建了EntryFormAbility.ets、NewsListWidgetCard.ets和/form_config.json三个文件,并在module.json5中增加了服务卡片能力配置。(1)entryformability/EntryFormAbility.etsEntryFormAbility.ets是管理服务卡片生命周期的卡片能力控制器,基本内容如下:import{formBindingData,FormExtensionAbility,formInfo}from'@kit.FormKit';
import{Want}from'@kit.AbilityKit';
exportdefaultclassEntryFormAbilityextendsFormExtensionAbility{
onAddForm(want:Want){
//用户在桌面添加卡片时回调(如长按桌面选择“服务卡片”)
constformData='';
returnformBindingData.createFormBindingData(formData);
}
onCastToNormalForm(formId:string){
//临时卡片转换为普通卡片时回调(如用户将卡片固定到桌面).
}
onUpdateForm(formId:string){
//系统主动要求更新卡片时回调(如定时刷新、用户手动下拉刷新)
}
onFormEvent(formId:string,message:string){
//用户与卡片交互时回调(如点击新闻条目)
}
onRemoveForm(formId:string){
//用户删除卡片或系统回收资源时回调
}
onAcquireFormState(want:Want){
//Calledtoreturna{@linkFormState}object.
returnformInfo.FormState.READY;
}
}EntryFormAbility能力类继承FormExtensionAbility,重写卡片服务生命周期的一些回调函数,回调函数的作用见代码中的注释。(2)Resources/base/profile/form_config.json是服务卡片的配置文件。{"forms":[{"name":"NewsListWidget","displayName":"$string:NewsListWidget_display_name","description":"$string:NewsListWidget_desc","src":"./ets/newslistwidget/pages/NewsListWidgetCard.ets","uiSyntax":"arkts","window":{"designWidth":720,"autoDesignWidth":true},"colorMode":"auto","isDynamic":true,"isDefault":true,"updateEnabled":false,"scheduledUpdateTime":"10:30","updateDuration":1,"defaultDimension":"2*4","supportDimensions":["2*4"]}]}每个服务卡片的配置在这个配置文件的form[]中用一个对象表示。从这个配置文件中可以看出定义了一个名为NewsListWidget的服务卡片,它是一个动态卡片(isDynamic:true),默认尺寸为2行4列,并且是应用的默认卡片(isDefault:true)。卡片的UI界面由./ets/newslistwidget/pages/NewsListWidgetCard.ets文件定义,使用ArkTS语法。卡片不启用定时更新(updateEnabled:false),因此更新需要由应用主动触发。卡片支持自适应窗口宽度(autoDesignWidth:true),设计基准宽度为720像素。(3)newslistwidget/pages/NewsListWidgetCard.etsNewsListWidgetCard是服务卡片布局文件,用于设计新闻服务卡片布局及交互处理,具体布局及交互将在后面实现。(4)服务卡片扩展能力配置除了前面创建的3个文件外,在module.json5模块配置文件中还自动增加了服务卡片扩展能力配置项。{
"module":{
"name":"entry",
"type":"entry",
"extensionAbilities":[
{......},
{
"name":"EntryFormAbility",
"srcEntry":"./ets/entryformability/EntryFormAbility.ets",
"label":"$string:EntryFormAbility_label",
"description":"$string:EntryFormAbility_desc",
"type":"form",
"metadata":[
{
"name":"ohos.extension.form",
"resource":"$profile:form_config"
}
]
}
],
"requestPermissions":[
{
"name":"ohos.permission.INTERNET"
}
]
}该配置将前面创建卡片控制类EntryFormAbility.ets与服务卡片配置文件关联起来,表示当前项目模块支持开发服务卡片能力。其中:name:“EntryFormAbility,扩展能力的唯一标识符,系统通过此名称识别卡片控制类;srcEntry:“./ets/entryformability/EntryFormAbility.ets”,卡片控制类的源码路径,必须指向继承自FormExtensionAbility的ArkTS文件;label: “$string:EntryFormAbility_label”,用户可见的卡片名称,引用resources/element/string.json中的多语言资源description: “$string:EntryFormAbility_desc”,卡片功能描述文本,同样使用多语言资源;type:“form”,扩展能力类型,固定为"form"表示服务卡片"metadata":[{"name":"ohos.extension.form","resource":"$profile:form_config"},卡片专用元数据,resource属性用于关联服务卡片的配置文件form_config.json。3.实现新闻服务卡片布局与交互按照需求,新闻服务卡片显示两条新闻信息(每条新闻显示新闻图片、标题、来源和时间)和一个刷新按钮,点击刷新按钮,更新新闻内容,点击新闻项拉起新闻详情界面,显示新闻详情,布局代码如下:1:import{NewsItem}from'../../models/NewsModel';2:3:letstorage=newLocalStorage();4:@Entry(storage)5:6:@Component7:structNewsListWidgetCard{8://卡片数据(从FormExtensionAbility接收)9:@LocalStorageProp('newsList')newsList:NewsItem[]=[];10:@LocalStorageProp('formId')formId:string='';11:@LocalStorageProp('currentPage')currentPage:number=1;12://@LocalStorageProp('formImages')formImages:Record<string,number>={};13:14://点击刷新按钮:触发EntryFormAbility的onFormEvent事件(eventType=refresh)15:privateonRefresh(){16:console.log("EntryAbilityonRefreshcurrentPage:",this.currentPage);17:postCardAction(this,{18:action:'message',19:params:{20:formId:this.formId,21:currentPage:this.currentPage,22:eventType:'refresh'//与EntryFormAbility的onFormEvent中eventType对应23:}24:});25:}26:27://点击新闻项:发送router信息,将由EntryAbility的onNewWant拉起新闻详情页面28:privateonNewsClick(uniquekey:string){29:postCardAction(this,{30:action:'router',31:abilityName:'EntryAbility',32:params:{33:url:'pages/NewsDetailPage',34:uniquekey:uniquekey//传递新闻唯一标识35:}36:});37:}38:39:build(){40:Column({space:5}){41:Row(){42:Text('热点新闻')//卡片标题区43:.fontSize(20).fontWeight(FontWeight.Bold).fontColor('#333333')44:.padding({top:5,left:10}).alignSelf(ItemAlign.Center)45:.flexGrow(1);46:Image($r('app.media.refresh'))////刷新按钮区47:.width(20).height(20).borderRadius(10)48:.alignSelf(ItemAlign.End).margin({right:10})49:.onClick(()=>this.onRefresh());50:}.width('100%');51:52://2.新闻列表区(显示2条新闻)53:List({space:5}){54:ForEach(this.newsList,(item:NewsItem)=>{55:ListItem(){56:Row({space:5}){57://新闻图片(thumbnail_pic_s)58:Image(item.uniquekey?'memory://'+item.uniquekey:$r('app.media.default_news'))//默认图防止空值59:.width(40).height(40).objectFit(ImageFit.Cover).borderRadius(5);60:61://新闻文字区(标题、来源、日期)62:Column({space:5}){63:Text(item.title)//新闻标题(最多2行,溢出省略)64:.fontSize(14).fontWeight(FontWeight.Medium)65:.fontColor('#333333').maxLines(2)66:.textOverflow({overflow:TextOverflow.Ellipsis})67:.flexGrow(1);68:69:Row({space:5}){//新闻来源70:Text(item.author_name||'未知来源')71:.fontSize(12).fontColor('#999999');72:Text(item.date||'')//新闻日期73:.fontSize(12).fontColor('#999999');74:}75:}.flexGrow(1);76:}77:.padding(5)78:.backgroundColor('#ffffff')79:.borderRadius(5)80:.onClick(()=>this.onNewsClick(item.uniquekey));81:}82:},(item:NewsItem)=>item.uniquekey);83:}84:.padding({left:5,right:5})85:.divider({strokeWidth:0});//隐藏列表分割线86:}87:.width('100%')88:.height('100%')89:.backgroundColor('#F5F5F5');90:}91:}这段代码实现了一个基于ArkTS的新闻列表服务卡片组件,用于在鸿蒙系统上展示动态新闻内容。组件通过LocalStorage接收卡片能力控制器传入的新闻数据,并采用纵向布局依次渲染标题栏、新闻列表和空状态提示。标题栏包含“新闻列表”文本和刷新按钮,点击按钮可触发message更新逻辑;新闻列表使用ForEach遍历数据,每条新闻显示新闻图片、标题、来源和日期,并支持点击事件以实现拉起新闻详情页面。第58-59行代码用(memory://item.uniquekey)标识来进行远端内存图片显示,这是因为在ArkTS动态卡片开发中,Image不允许直接使用网络URL或
file://
协议来显示本地图片,一种可行的方案是先下载网络图片到本地,然后在本地内存中打开图片文件,通过updateForm更新卡片数据,然后在卡片端使用memory://协议来显示远端内存图片。4.处理卡片添加、刷新等事件(1)在NewsService中增加网络图片的下载方法downloadImageAndSave(url:string,savePath:string),表示将url所在的图片下载保存到savePath位置import{http}from'@kit.NetworkKit';import{BusinessError}from'@kit.BasicServicesKit';import{NewsDetail,NewsDetailResponse,NewsItem,NewsListResponse}from'../models/NewsModel';import{fileIo}from'@kit.CoreFileKit';/***新闻服务类*封装获取新闻列表的方法*/exportclassNewsService{.../***下载图片保存到临时文件夹*@paramurl要下载的图片网址*@paramsavePath要保存的本地图片路径*@returnstrue表示下载成功,false表示下载失败*/asyncdownloadImageAndSave(url:string,savePath:string):Promise<boolean>{lethttpRequest=http.createHttp();try{letresponse=awaithttpRequest.request(url);if(response.responseCode===http.ResponseCode.OK){letfile=fileIo.openSync(savePath,fileIo.OpenMode.READ_WRITE|fileIo.OpenMode.CREATE);fileIo.writeSync(file.fd,response.resultasArrayBuffer);fileIo.closeSync(file);returntrue;}returnfalse;}catch(err){console.error('Download',url,'imagefailed:',err);returnfalse;}finally{httpRequest.destroy();}}}(2)在卡片能力控制器EntryFormAbility端处理卡片添加onAddForm、卡片刷新onFormEvent等事件,代码如下:1:import{formBindingData,FormExtensionAbility,formInfo,formProvider}from'@kit.FormKit';2:import{Want}from'@kit.AbilityKit';3:import{NewsService}from'../services/NewsService';4:import{NewsItem}from'../models/NewsModel';5:import{hilog}from'@kit.PerformanceAnalysisKit';6:import{BusinessError}from'@kit.BasicServicesKit';7:import{fileIo}from'@kit.CoreFileKit';11://全局变量:记录卡片ID、当前页码、新闻列表(用于刷新逻辑)12:13:constPAGE_SIZE:number=2;//卡片每次显示2条新闻14:constnewsService:NewsService=newNewsService();15:constDOMAIN_NUMBER:number=0xFF00;16:constTAG:string='EntryFormAbility';17:18:exportdefaultclassEntryFormAbilityextendsFormExtensionAbility{19:onAddForm(want:Want){20:letformId:string='';21:(DOMAIN_NUMBER,TAG,'onAddFormwant:'+JSON.stringify(want));22://用户在桌面添加卡片时回调(如长按桌面选择“服务卡片”)23:if(want.parameters&&want.parameters[formInfo.FormParam.IDENTITY_KEY]){24:formId=want.parameters[formInfo.FormParam.IDENTITY_KEY]asstring;25:this.loadNewsListData(formId);26:}27:returnformBindingData.createFormBindingData({28:'newsList':[],29:'formId':formId,30:'currentPage':131:});32:}33:34:onCastToNormalForm(formId:string){35://临时卡片转换为普通卡片时回调(如用户将卡片固定到桌面)36:(DOMAIN_NUMBER,TAG,'onCastToNormalFormformId:'+formId);37:}38:39:onUpdateForm(formId:string){40://系统主动要求更新卡片时回调(如定时刷新、用户手动下拉刷新)41:(DOMAIN_NUMBER,TAG,'onUpdateFormformId:'+formId);42:this.loadNewsListData(formId);43:}44:45:onFormEvent(formId:string,message:string){46://用户与卡片交互时回调(如点击新闻条目)47:(DOMAIN_NUMBER,TAG,'onFormEventformId:'+formId+',message:'+message);48:constmessageObj:Record<string,Object>=JSON.parse(message);49:constcurrentPage=messageObj.currentPageasnumber;50:consteventType=messageObj.eventTypeasstring;51:switch(eventType){52:case'refresh':53://点击刷新按钮:请求下一页新闻54:try{55:this.loadNewsListData(formId,currentPage);56:}catch(error){57:console.error('onFormEvent:刷新新闻失败',error);58:}59:break;60:case'clickNews':61:break;62:default:63:console.warn('onFormEvent:未知事件类型',eventType);64:}65:}66:67:onRemoveForm(formId:string){68://用户删除卡片或系统回收资源时回调69:(DOMAIN_NUMBER,TAG,'onRemoveFormformId:'+formId);70:}71:72:onAcquireFormState(want:Want){73://Calledtoreturna{@linkFormState}object.74:returnformInfo.FormState.READY;75:}76:77://加载卡片数据78:privateasyncloadNewsListData(formId:string,currentPage:number=1){79:try{80://获取热门新闻81:lethotNews:NewsItem[]=awaitnewsService.getNewsList('top',currentPage,10);82:if(hotNews.length>=PAGE_SIZE){83:currentPage++;84:}85://只要2条有图片的新闻86:hotNews=hotNews.filter((item)=>item.thumbnail_pic_s).slice(0,PAGE_SIZE);87://返回初始卡片数据(包含前2条新闻)88:lettempDir=this.context.getApplicationContext().tempDir;89:letfileName:string='';90:letimgMap:Record<string,number>={};91:for(letnewsofhotNews){92:if(!news.thumbnail_pic_s)continue;93:fileName=news.uniquekey;94:letsavePath=tempDir+'/'+fileName;95:letsuccess=awaitnewsService.downloadImageAndSave(news.thumbnail_pic_s,savePath);96:if(!success)continue;97:letfile=fileIo.openSync(savePath);98:imgMap[fileName]=file.fd;99:}100:101:letformData=formBindingData.createFormBindingData({102:newsList:hotNews,103:formId:formId,104:currentPage:currentPage,105:formImages:imgMap106:});107:formProvider.updateForm(formId,formData).finally(()=>{108://数据更新后,关闭图片文件109:Object.keys(imgMap).map(key=>{110:fileIo.closeSy
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 高中地理教学设计:资源型地区转型发展与生态安全构建实战演练
- 初中综合实践活动八年级上册“校园新部门”教学设计
- 高一英语教学设计:Unit 2 Sports and Fitness 非谓语动词核心素养导学
- 赣美版初中美术七年级上册第二单元第2课《概览中外民间美术》教学设计
- 小学三年级英语教案-Unit 4 My tidy bag词汇拓展
- 六年级地理教学设计:亚洲位置范围与地形河流整体教学研究
- 小学三年级信息科技《创作发布作品》教学设计:基于课件制作的数字化表达实践
- 七年级语文《登幽州台歌》教学设计
- 高三英语读后续写成长励志主题教学设计:从地震废墟到精神重建的叙事进阶
- (2026版)矿山机电专业总结报告
- 2026年金川集团招聘题目(含答案)
- 《电力重大事故隐患判定标准及治理监督管理规定》国家能源局解读课件
- 2026年全国I卷高考数学真题
- 人教版数学二年级上册期中测试卷及完整答案
- 混凝土智能化监测技术-深度研究
- 安全生产检查工作方案
- 中建安全总监竞聘
- T-CRHA 046-2024 标准手术体位安置技术规范
- 强化学习 课件全套 余欣航 第1-8章 强化学习概述- 基于模型的强化学习基础
- 防止校园暴力安全培训
- 安装工程项目成本管控字典
评论
0/150
提交评论