DevEco Studio为开发者提供了UI界面预览性能,能够查看利用/服务的UI界面成果,不便开发者随时调整界面UI布局。预览器反对布局代码的实时预览,只须要将开发的源代码进行保留,就能够通过预览器实时查看利用/服务运行成果,不便开发者随时调整代码。

阐明
因为操作系统和真机设备的差别,在预览界面中可能呈现字体、色彩等与真机设备运行的成果存在差别,预览成果仅作为利用/服务开发过程中的参考,理论最终成果请以真机设备运行成果为准。

为了更好的应用体验,倡议先将DevEco Studio降级至最新版本,而后检测并更新SDK至最新版本。

查看ArkTS和JS利用/服务预览成果

预览器反对JS和ArkTS利用/服务“实时预览”和“动静预览”。

阐明
预览Phone、Tablet、TV和Wearable设施的JS/ArkTS工程,预览器性能依赖于电脑显卡的OpenGL版本,OpenGL版本要求为3.2及以上。
richtext、web、video、XComponent组件不反对预览。
不反对调用C++库的预览。
har在被利用和元服务应用时真机成果有区别,真机上实际效果利用不显示menubar,元服务显示menubar,但预览器都以不显示menubar为准。若开发har模块时,请留神被元服务应用时预览器成果与真机成果的不同。

实时预览:在开发界面UI代码过程中,如果增加或删除了UI组件,您只需Ctrl+S进行保留,而后预览器就会立刻刷新预览后果。如果批改了组件的属性,则预览器会实时(亚秒级)刷新预览后果,达到极速预览的成果(以后版本极速预览仅反对ArkTS组件。API 8工程的极速预览仅在非数据绑定场景失效,如波及数据绑定,仍须要在文件保留后才能够预览;API 9工程的极速预览反对局部数据绑定场景,如@State变量)。实时预览默认开启,如果不须要实时预览,请单击预览器右上角按钮,敞开实时预览性能。

阐明

开发者批改resources/base/profile目录下的配置文件(如main_page.json),不反对触发实时预览,开发者须要手动刷新。


动静预览:在预览器界面,能够在预览器中操作利用/服务的界面交互动作,如单击、跳转、滑动等,与利用/服务运行在真机设备上的界面交互体验统一。


在应用预览器前,请依据如下项查看环境信息:

  • 确保File > Settings > SDK >
    HarmonyOS/OpenHarmony中,已下载Previewer资源。如果已下载Previewer,但存在新版本的状况,倡议降级到最新版本,详情请参考下载HarmonyOS
    SDK。
  • 倡议将File > Settings > SDK > HarmonyOS/OpenHarmony中的SDK更新至最新版本。

以ArkTS为例,应用预览器的办法如下:
1.创立或关上一个ArkTS利用/服务工程。本示例以关上一个本地ArkTS Demo工程为例。
2.在工程目录下,关上任意一个.ets文件(JS工程请关上.hml/.css/.js页面)。
3.能够通过如下任意一种形式关上预览器开关,显示成果如下图所示:

  • 通过菜单栏,单击View>Tool Windows>Previewer关上预览器。
  • 在编辑窗口右上角的侧边工具栏,单击Previewer,关上预览器。

查看ArkUI预览成果

ArkUI预览反对页面预览与组件预览,下图中左侧图标为页面预览,右侧图标为组件预览。

页面预览

ArkTS利用/服务反对页面预览,要求compileSdkVersion为7或以上。页面预览通过在工程的ets文件头部增加注解@Entry实现。

@Entry的应用参考如下示例:

@Entry@Componentstruct Index {  @State message: string = 'Hello World'  build() {    Row() {      Column() {        Text(this.message)          .fontSize(50)          .fontWeight(FontWeight.Bold)      }      .width('100%')    }    .height('100%')  }}

组件预览

ArkTS利用/服务反对组件预览,要求compileSdkVersion为8或以上。组件预览反对实时预览,不反对动态图和动静预览。组件预览通过在组件前增加注解@Preview实现,在单个源文件中,最多能够应用10个@Preview装璜自定义组件。

@Preview的应用参考如下示例

@Preview({  title: 'FoodImage'})@Componentstruct FoodImageDisplayPreview {  build() {    Flex() {      FoodImageDisplay({ foodItem: getDefaultFoodData() })    }  }}

以上示例的组件预览成果如下图所示:

组件预览默认的预览设施为Phone,若您想在不同的设施,或者不同的屏幕形态,或者不同设施语言等状况下的组件预览成果,能够通过设置@Preview的参数,指定预览设施的相干属性。若不设置@Preview的参数,默认的设施属性如下所示:

@Preview({  title: 'Component1',  //预览组件的名称  deviceType: 'phone',  //指定以后组件预览渲染的设施类型,默认为Phone  width: 1080,  //预览设施的宽度,单位:px  height: 2340,  //预览设施的长度,单位:px  colorMode: 'light',  //显示的亮/暗模式,取值为light或dark  dpi: 480,  //预览设施的屏幕DPI值  locale: 'zh_CN',  //预览设施的语言,如zh_CN、en_US等  orientation: 'portrait',  //预览设施的横竖屏状态,取值为portrait或landscape  roundScreen: false  //设施的屏幕形态是否为圆形})

请留神,如果被预览的组件是依赖参数注入的组件,倡议的预览形式是:定义一个组件片段,在该片段中申明将要预览的组件,以及该组件依赖的入参,并在组件片段上标注@Preview注解,以表明将预览该片段中的内容。例如,要预览如下组件:

@Componentstruct Title {  context: string  build() {    Text(this.context)  }}

倡议按如下形式预览:

@Preview@Component    //定义组件片段TitlePreviewstruct TitlePreview {  build() {    Title({ context: 'MyTitle' })    //在该片段中申明将要预览的组件Title,以及该组件依赖的入参 {context: ’MyTitle’}  }}

查看Java利用/服务预览成果

Java预览器反对Phone、Tablet、Car、TV和Wearable设施的Java利用/服务布局预览。Java利用/服务的布局反对Java代码布局和XML布局两种形式,其中Java代码布局(AbilitySlice.java或Ability.java文件)反对实时预览界面布局成果,同时还能够动静预览利用/服务的交互成果,如单击、跳转、滑动等互动式操作;XML布局文件能够实时预览,批改和保留了XML代码后,预览器会实时展现利用/服务的布局成果。

阐明
Java文件预览是试验个性,应用中还存在以下束缚。
macOS版本的Java预览器性能,只反对API Version 5及以上版本。
如果xml依赖Java文件中的数据,当批改了xml布局文件后,须要通过启动Java文件预览的形式来查看布局成果。
如果xml中援用了Java的自定义组件,不反对预览。
只反对中的相干UI组件。
只反对jpeg/jpg、png、bmp和wbmp格局的图片预览。
不反对HarmonyOS Library模块的预览。
不反对Ability间跳转的预览。
不反对通过JNI调用C++库的预览。

在应用Java预览器前,请依据如下项查看环境信息:

  • 须要确保File > Settings > SDK > HarmonyOS
    SDK中,已下载对应版本的Previewer资源,如果已下载Previewer,但存在新版本的状况,须要降级到最新版本。
  • File > Settings > SDK > HarmonyOS SDK中的Java SDK须要更新至最新版本。

应用Java预览器的办法如下:

1.创立或关上一个Java利用/服务工程。本示例以创立一个新的Java工程为例,具体请参考创立一个新的工程。

2.在工程目录下,依据布局形式,关上布局文件:

  • JavaUI布局:关上一个AbilitySlice.java或Ability.java文件
阐明
JavaUI布局预览性能是试验个性:
Windows零碎:请通过File > Settings > Previewer下勾选“Enable java previewer”开启。macOS零碎:请通过DevEco Studio > Preferences > Previewer下勾选“Enable java previewer”开启。
  • XML布局:关上一个resources > base > layout目录下的xml布局文件。

3.能够通过如下任意一种形式关上预览器开关,显示成果如下图所示:

  • 通过菜单栏,单击View > Tool Windows > Previewer关上预览器。
  • 在编辑窗口右上角的侧边工具栏,单击Previewer,关上预览器。

Profile Manager

阐明
该个性在DevEco Studio V2.2 Beta2及更高版本中反对。

因为真机设备有丰盛的设施型号,比方Phone设施,包含Mate30、Mate40、P40、P50等设施,不同设施型号的屏幕分辨率可能不一样。因而,在HarmonyOS利用/服务开发过程中,因为设施类型繁多,可能不能查看在不同设施上的界面显示成果。对此,DevEco Studio的预览器提供了Profile Manager性能,反对开发者自定义预览设施Profile(蕴含分辨率和语言),从而能够通过定义不同的预览设施Profile,查看HarmonyOS利用/服务在不同设施上的预览显示成果。以后反对自定义设施分辨率及零碎语言,如果是Lite Wearable设施类型,还反对自定义屏幕形态。

定义设施后,能够在Previewer右上角,单击按钮,关上Profile管理器,切换预览设施。

同时,Profile Manager还反对多设施预览性能,具体请参考查看多端设施预览成果。

上面以自定义一款Phone设施为例,介绍设施Profile Manager的应用办法。

1.在预览器界面,关上Profile Manager界面。

2.在Profile Manager界面,单击+ New Profile按钮,增加设施。

3.在Create Profile界面,填写新增设施的信息,如Profile ID(设施型号)、Device type(设施类型)、Resolution(分辨率)和Language and region(语言和区域)等。其中Device type只能抉择config.json(Stage工程中为module.json5)中deviceType字段已定义的设施。


4.设施信息填写实现后,单击OK实现创立。

查看多端设施预览成果

DevEco Studio反对HarmonyOS分布式应用/服务开发,同一个利用/服务能够运行在多个设施上。在HarmonyOS分布式应用/服务的开发阶段,因不同设施的屏幕分辨率、形态、大小等不同,开发者须要在不同的设施上查看利用/服务的UI布局和交互成果,此时便能够应用多端设施预览器性能,不便开发者在利用/服务开发过程中,随时查看不同设施上的运行成果。

阐明
多端设施预览最多同时反对4个设施的预览。

后面介绍了DevEco Studio反对ArkTS、JS和Java利用/服务的预览器性能,多端设施预览器反对ArkTS、JS与Java利用/服务在不同设施上的同时预览。如果两个设施反对的编码语言不同,就不能应用多端设施预览性能,例如,Java语言的Phone的利用/服务,是不反对在LiteWearable上运行的,因为LiteWearable不反对Java语言。

上面以ArkTS利用/服务为例,介绍多端设施预览器的应用办法,JS和Java利用/服务的多端设施预览器应用办法雷同。

1.在工程目录中,关上任意一个ets文件(JS请关上hml/css/js文件,Java请关上AbilitySlice.java或Ability.java文件)。
2.能够通过如下任意一种形式关上预览器开关,显示成果如下图所示:

  • 过菜单栏,单击View>Tool Windows>Previewer,关上预览器。
  • 在编辑窗口右上角的侧边工具栏,单击Previewer,关上预览器。

3.在Previewer窗口中,关上Profile Manager中的Multi-profile preview开关,同时查看多设施上的利用/服务运行成果。

阐明
多端设施预览不反对动画的预览,如果须要查看动画在设施上的预览成果,请敞开Multi-device preview性能后在单设施预览界面进行查看。

多设施预览成果如下图所示:


Inspector双向预览

DevEco Studio提供HarmonyOS利用/服务的UI预览界面与源代码文件间的双向预览性能,反对ets文件、hml文件及xml文件与预览器界面的双向预览。应用双向预览性能时,须要在预览器界面单击图标关上双向预览性能。

阐明
暂不反对服务卡片的双向预览性能。


开启双向预览性能后,反对代码编辑器、UI界面和Component Tree 组件树三者之间的联动:

  • 选中预览器UI界面中的组件,则组件树上对应的组件将被选中,同时代码编辑器中的布局文件中对应的代码块高亮显示。
  • 选中布局文件中的代码块,则在UI界面会高亮显示,组件树上的组件节点也会出现被选中的状态。
  • 选中组件树中的组件,则对应的代码块和UI界面也会高亮显示。


在预览界面还能够通过组件的属性面板批改可批改的属性或款式,在预览界面批改后,预览器会主动同步到代码编辑器中批改源码,并实时的刷新UI界面;同样的,如果在代码编辑器中批改源码,也会实时刷新UI界面,并更新组件树信息及组件属性。

阐明
如果组件有做数据绑定,则其属性不反对在属性面板批改。
如果界面有应用动画成果或者带动画成果组件,则其属性不反对在属性面板批改。
多设施预览时,不反对双向预览。

为了可能让大家跟上互联网时代的技术迭代,在这里跟大家分享一下我本人近期学习心得以及参考网上材料整顿出的一份最新版的鸿蒙学习晋升材料,有须要的小伙伴自行支付,限时开源,先到先得~~~~

支付以下高清学习路线原图请点击→《鸿蒙全套学习指南》纯血鸿蒙HarmonyOS根底技能学习路线图

支付以上残缺高清学习路线图,请点击→《鸿蒙根底入门学习指南》小编本人整顿的局部学习材料(蕴含有高清视频、开发文档、电子书籍等)

以上分享的学习路线都适宜哪些人跟着学习?
-应届生/计算机专业通过学习鸿蒙新兴技术,入行互联网,将来高起点待业。-0根底转行提前布局新方向,抓住风口,自我晋升,取得更多就业机会。-技术晋升/进阶跳槽倒退瓶颈期,晋升职场竞争力,疾速把握鸿蒙技术,享受蓝海红利。

最初

鸿蒙开发学习是一个系统化的过程,从基础知识的学习到实战技能的锻炼,再到对前沿技术的摸索,每一环节都至关重要。心愿这份教程材料能帮忙您疾速入门并在鸿蒙开发之路上步步攀升,成就一番事业。让咱们一起乘风破浪,拥抱鸿蒙生态的广大将来

如果你感觉这篇内容对你有帮忙,我想麻烦大家动动小手给我:点赞,转发,有你们的 『点赞和评论』,才是我发明的能源。

关注我,同时能够期待后续文章ing,不定期分享原创常识。

想要获取更多残缺鸿蒙最新VIP学习材料,请点击→《鸿蒙 (Harmony OS)开发学习手册》