1# 使用eTS语言开发(低代码方式) 2 3 4> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** 5> 该特性在**DevEco Studio V3.0 Beta3**及更高版本中支持。 6> 7> 目前eTS低代码开发方式支持的组件较少,更多组件的支持将在后续版本中实现。 8> 9> 为确保运行效果,本文以使用**DevEco Studio V3.0.0.900 Beta3**版本为例,点击[此处](https://developer.harmonyos.com/cn/develop/deveco-studio#download_beta_openharmony)获取下载链接。 10 11 12OpenHarmony低代码开发方式具有丰富的UI界面编辑功能,通过可视化界面开发方式快速构建布局,可有效降低开发者的上手成本并提升开发者构建UI界面的效率。 13 14 15使用低代码开发应用或服务有以下两种开发方式: 16 17 18- 直接创建一个支持低代码开发的新工程以进行开发。本文以此方式为例进行说明。 19 20- 在已有工程中,创建visual文件来进行开发。此种方式的操作可参考[创建visual文件支持低代码开发](#构建第二个页面)。 21 22 23## 创建新工程支持低代码开发 24 251. 若首次打开**DevEco Studio**,请点击**Create Project**创建工程。如果已有一个工程,请点击**File** > **New** > **Create Project**。选择模板“**Empty Ability**”,点击**Next**进行下一步配置。 26 27 ![zh-cn_image_0000001233528152](figures/zh-cn_image_0000001233528152.png) 28 292. 进入配置工程界面,打开“**Enable Super Visual**”开关,**UI Syntax**选择“**eTS**”,其他参数保持默认设置即可。 30 31 ![zh-cn_image_0000001277728569](figures/zh-cn_image_0000001277728569.png) 32 333. 点击**Finish**,工具会自动生成示例代码和相关资源,等待工程创建完成。 34 35 36## 低代码开发工程项目文件 37 38工程同步完成后,自动生成以下目录结构: 39 40![zh-cn_image_0000001277809333](figures/zh-cn_image_0000001277809333.png) 41 42- **entry > src > main > ets > MainAbility > pages > index.ets**:低代码页面的逻辑描述文件,定义了页面里所用到的所有的逻辑关系,比如数据、事件等,详情请参考[TS语法糖](../ui/ts-syntactic-sugar.md)。如果创建了多个低代码页面,则pages目录下会生成多个页面文件夹及对应的ets文件。 43 44- **entry > src > main > supervisual > MainAbility > pages > index.visual**:visual文件存储低代码页面的数据模型,双击该文件即可打开低代码页面,进行可视化开发设计。如果创建了多个低代码页面,则pages目录下会生成多个页面文件夹及对应的visual文件。 45 46 47## 构建第一个页面 48 49工程同步完成后,第一个页面已有一个容器、一段文本(Hello World)显示。为了更详细地了解低代码开发,我们将删除画布原有模板组件,从零开始完成页面的添加、设置。 50 51第一个页面内有一个容器、一段文本和一个按钮,通过Column、Text和Button组件来实现。其中,Column为沿垂直方向布局的容器组件,具体使用请见[Column](../reference/arkui-ts/ts-container-column.md)。 52 531. 删除画布原有模板组件。<a name="delete_origin_content"></a> 54 打开index.visual文件,选中画布中的组件,单击鼠标右键,选择Delete删除画布原有模板组件。操作如下所示: 55 56 ![zh-cn_image_0000001233208980](figures/zh-cn_image_0000001233208980.gif) 57 582. 添加容器,设置Column容器的样式和属性。<a name="add_container"></a> 59 选中UI Control中的Column组件,将其拖至画布。点击右侧属性样式栏中的图标![zh-cn_image_0000001233048996](figures/zh-cn_image_0000001233048996.png)(General),设置Column组件的高度Height为100%,使其占满屏幕;点击右侧属性样式栏中的图标![zh-cn_image_0000001233368860](figures/zh-cn_image_0000001233368860.png)(Feature),设置Column组件的AlignItems样式为center,使得其子组件在水平轴上居中显示。操作如下所示: 60 61 ![zh-cn_image_0000001277488977](figures/zh-cn_image_0000001277488977.gif) 62 633. 添加文本。 64 选中UI Control中的Text组件,将其拖至画布,再拖至Column组件的中央区域。点击右侧属性样式栏中的图标![zh-cn_image_0000001277608813](figures/zh-cn_image_0000001277608813.png)(Feature),设置Text组件的Content属性为“this.message”(即“Hello World”);设置组件的FontSize样式为30fp,使得其文字放大;设置组件的TextAlign样式为center,使得组件文字居中显示。再选中画布上的Text组件,拖动放大。操作如下所示: 65 66 ![zh-cn_image_0000001235731706](figures/zh-cn_image_0000001233528156.gif) 67 684. 添加按钮。 69 选中UI Control中的Button组件,将其拖至画布,再拖至Text组件下面。点击右侧属性样式栏中的图标![zh-cn_image_0000001277728577](figures/zh-cn_image_0000001277728577.png)(General),设置Button组件的Height为40vp;点击右侧属性样式栏中的图标![zh-cn_image_0000001277809337](figures/zh-cn_image_0000001277809337.png)(Feature),设置Button组件的Label属性为“Next”;设置Button组件的FontSize样式为25fp,使得其文字放大。操作如下所示: 70 71 ![zh-cn_image_0000001235732402](figures/zh-cn_image_0000001233208988.gif) 72 735. 在编辑窗口右上角的侧边工具栏,点击Previewer,打开预览器。第一个页面效果如下图所示: 74 75 ![zh-cn_image_0000001235892798](figures/zh-cn_image_0000001233049004.png) 76 77 78## 构建第二个页面 79 801. 创建第二个页面。 81 在“**Project**”窗口,打开“**entry > src > main > ets > MainAbility**”,右键点击“**pages**”文件夹,选择“**New > Visual**”,命名为“**second**”,单击“**Finish**”,即完成第二个页面的创建。可以看到文件目录结构如下: 82 83 ![zh-cn_image_0000001233368868](figures/zh-cn_image_0000001233368868.png) 84 852. [删除画布原有模板组件。](#delete_origin_content) 86 873. [添加容器,设置Column容器的样式和属性。](#add_container) 88 894. 添加文本。 90 91 - 在second.ets文件中,将本页面的message文本内容设置为“Hi there”,示例如下: 92 93 ```ts 94 // second.ets 95 @Entry 96 @Component 97 struct Second { 98 @State message: string = 'Hi there' 99 100 /** 101 * In low-code mode, do not add anything to the build function, as it will be 102 * overwritten by the content generated by the .visual file in the build phase. 103 */ 104 build() { 105 106 } 107 } 108 ``` 109 - 选中Text组件,将其拖至画布,再拖至Column组件的中央区域。点击右侧属性样式栏中的图标![zh-cn_image_0000001277488985](figures/zh-cn_image_0000001277488985.png)(Feature),设置Text组件的Content属性为“this.message”(即“Hi there”);设置Text组件的FontSize样式为30fp;设置组件的TextAlign样式为center。再选中画布上的Text组件,拖动放大。操作如下所示: 110 111 ![zh-cn_image_0000001280255513](figures/zh-cn_image_0000001277608817.gif) 112 1135. 添加按钮。 114 选中UI Control中的Button组件,将其拖至画布,再拖至Text组件下面。点击右侧属性样式栏中的图标![zh-cn_image_0000001233528160](figures/zh-cn_image_0000001233528160.png)(General),设置Button组件的Height为40vp;点击右侧属性样式栏中的图标![zh-cn_image_0000001277728597](figures/zh-cn_image_0000001277728597.png)(Feature),设置Button组件的Value属性为“Back”;设置组件的FontSize样式为25fp,使得其文字放大。操作如下所示: 115 116 ![zh-cn_image_0000001280383937](figures/zh-cn_image_0000001277809361.gif) 117 118 119## 实现页面间的跳转 120 121页面间的导航可以通过页面路由router来实现。页面路由router根据页面url找到目标页面,从而实现跳转。使用页面路由请导入router模块。 122 1231. 第一个页面跳转到第二个页面。 124 在第一个页面中,跳转按钮绑定onclick方法,点击按钮时跳转到第二页。需同时处理ets文件及visual文件。 125 - “**index.ets**”示例如下: 126 127 ```ts 128 // index.ets 129 import router from '@ohos.router'; 130 131 @Entry 132 @Component 133 struct Index { 134 @State message: string = 'Hello World' 135 136 /** 137 * In low-code mode, do not add anything to the build function, as it will be 138 * overwritten by the content generated by the .visual file in the build phase. 139 */ 140 onclick() { 141 router.push({ 142 url: 'pages/second', // 指定要跳转的页面 143 }) 144 } 145 146 build() { 147 } 148 } 149 ``` 150 151 - “**index.visual**”: 打开index.visual,选中画布上的Button组件。点击右侧属性样式栏中的事件图标![zh-cn_image_0000001233209020](figures/zh-cn_image_0000001233209020.png)(Events),鼠标点击OnClick事件的输入框,选择this.onclick,如下所示: 152 153 ![zh-cn_image_0000001235745716](figures/zh-cn_image_0000001233049040.png) 154 1552. 第二个页面返回到第一个页面。 156 在第二个页面中,返回按钮绑定back方法,点击按钮时返回到第一页。需同时处理ets文件及visual文件。 157 158 - “**second.ets**”示例如下: 159 160 ```ts 161 // second.ets 162 import router from '@ohos.router'; 163 164 @Entry 165 @Component 166 struct Second { 167 @State message: string = 'Hi there' 168 169 /** 170 * In low-code mode, do not add anything to the build function, as it will be 171 * overwritten by the content generated by the .visual file in the build phase. 172 */ 173 back() { 174 router.back() 175 } 176 177 build() { 178 179 } 180 } 181 ``` 182 - “**second.visual**”: 打开second.visual,选中画布上的Button组件。点击右侧属性样式栏中的事件图标![zh-cn_image_0000001233368900](figures/zh-cn_image_0000001233368900.png)(Events),鼠标点击OnClick事件的输入框,选择this.back,如下所示: 183 184 ![zh-cn_image_0000001280385809](figures/zh-cn_image_0000001277489017.png) 185 1863. 打开index.visual或index.ets文件,点击预览器中的 ![zh-cn_image_0000001277608849](figures/zh-cn_image_0000001277608849.png) 按钮进行刷新。效果如下图所示: 187 188 ![zh-cn_image_0000001233528192](figures/zh-cn_image_0000001233528192.png) 189 190 191## 使用真机运行应用 192 1931. 将搭载OpenHarmony标准系统的开发板与电脑连接。 194 1952. 点击**File** > **Project Structure** > **Project** > **Signing Configs**界面勾选“**Automatically generate signing**”,等待自动签名完成即可,点击“**OK**”。如下图所示: 196 197 ![zh-cn_image_0000001277728613](figures/zh-cn_image_0000001277728613.png) 198 1993. 在编辑窗口右上角的工具栏,点击![zh-cn_image_0000001277809373](figures/zh-cn_image_0000001277809373.png)按钮运行。效果如下图所示: 200 201 ![zh-cn_image_0000001233209024](figures/zh-cn_image_0000001233209024.png) 202 203恭喜您已经使用eTS语言开发(低代码方式)完成了第一个OpenHarmony应用,快来[探索更多的OpenHarmony功能](../application-dev-guide.md)吧。 204