鸿蒙前端开发-构建第一个ArkTS应用(Stage模型)

创建ArkTS工程

<><>

  1. 若首次打开DevEco Studio ,请点击Create Project 创建工程。如果已经打开了一个工程,请在菜单栏选择File > New > Create Project来创建一个新工程。

  2. 选择Application 应用开发(本文以应用开发为例,Atomic Service对应为元服务开发),选择模板"Empty Ability ",点击Next进行下一步配置。

  3. 进入配置工程界面,Compile SDK 选择"3.1.0(API 9) ",Model 选择"Stage",其他参数保持默认设置即可。

    说明

    支持使用ArkTS低代码开发方式。

    低代码开发方式具有丰富的UI界面编辑功能,通过可视化界面开发方式快速构建布局,可有效降低开发者的上手成本并提升开发者构建UI界面的效率。

    如需使用低代码开发方式,请打开上图中的Enable Super Visual开关。

  4. 点击Finish,工具会自动生成示例代码和相关资源,等待工程创建完成。

ArkTS工程目录结构(Stage模型)

<><>

  • AppScope > app.json5:应用的全局配置信息。

  • entry:HarmonyOS工程模块,编译构建生成一个HAP包。

    • src > main > ets:用于存放ArkTS源码。
    • src > main > ets > entryability:应用/服务的入口。
    • src > main > ets > pages:应用/服务包含的页面。
    • src > main > resources :用于存放应用/服务所用到的资源文件,如图形、多媒体、字符串、布局文件等。关于资源文件,详见资源分类与访问
    • src > main > module.json5 :Stage模型模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明,详见module.json5配置文件
    • build-profile.json5:当前的模块信息、编译信息配置项,包括buildOption、targets配置等。其中targets中可配置当前运行环境,默认为HarmonyOS。
    • hvigorfile.ts:模块级编译构建任务脚本,开发者可以自定义相关任务和代码实现。
  • oh_modules :用于存放三方库依赖信息。关于原npm工程适配ohpm操作,请参考历史工程迁移

  • build-profile.json5:应用级配置信息,包括签名、产品配置等。

  • hvigorfile.ts:应用级编译构建任务脚本。

构建第一个页面

<><>

  1. 使用文本组件。

    工程同步完成后,在"Project "窗口,点击"entry > src > main > ets > pages ",打开"Index.ets "文件,可以看到页面由Text组件组成。"Index.ets"文件的示例如下:

js 复制代码
// Index.ets
@Entry
@Component
struct Index {
@State message: string = 'Hello World'

build() {
  Row() {
    Column() {
      Text(this.message)
        .fontSize(50)
        .fontWeight(FontWeight.Bold)
    }
    .width('100%')
  }
  .height('100%')
}
}
  1. 添加按钮。

    在默认页面基础上,我们添加一个Button组件,作为按钮响应用户点击,从而实现跳转到另一个页面。"Index.ets"文件的示例如下:

js 复制代码
 // Index.ets
@Entry
@Component
struct Index {
 @State message: string = 'Hello World'

 build() {
   Row() {
     Column() {
       Text(this.message)
         .fontSize(50)
         .fontWeight(FontWeight.Bold)
       // 添加按钮,以响应用户点击
       Button() {
         Text('Next')
           .fontSize(30)
           .fontWeight(FontWeight.Bold)
       }
       .type(ButtonType.Capsule)
       .margin({
         top: 20
       })
       .backgroundColor('#0D9FFB')
       .width('40%')
       .height('5%')
     }
     .width('100%')
   }
   .height('100%')
 }
}
  1. 在编辑窗口右上角的侧边工具栏,点击Previewer,打开预览器。第一个页面效果如下图所示:

构建第二个页面

<><>

  1. 创建第二个页面。

    • 新建第二个页面文件。在"Project "窗口,打开"entry > src > main > ets ",右键点击"pages "文件夹,选择"New > ArkTS File ",命名为"Second ",点击"Finish"。可以看到文件目录结构如下:

      说明

      开发者也可以在右键点击"pages "文件夹时,选择"New > Page",则无需手动配置相关页面路由。

    • 配置第二个页面的路由。在"Project "窗口,打开"entry > src > main > resources > base > profile",在main_pages.json文件中的"src"下配置第二个页面的路由"pages/Second"。示例如下:

        {  "src": [    "pages/Index",    "pages/Second"  ]}
      
  2. 添加文本及按钮。

    参照第一个页面,在第二个页面添加Text组件、Button组件等,并设置其样式。"Second.ets"文件的示例如下:

js 复制代码
// Second.ets
@Entry
@Component
struct Second {
 @State message: string = 'Hi there'

 build() {
   Row() {
     Column() {
       Text(this.message)
         .fontSize(50)
         .fontWeight(FontWeight.Bold)
       Button() {
         Text('Back')
           .fontSize(25)
           .fontWeight(FontWeight.Bold)
       }
       .type(ButtonType.Capsule)
       .margin({
         top: 20
       })
       .backgroundColor('#0D9FFB')
       .width('40%')
       .height('5%')
     }
     .width('100%')
   }
   .height('100%')
 }
}    

实现页面间的跳转

<><>

页面间的导航可以通过页面路由router来实现。页面路由router根据页面url找到目标页面,从而实现跳转。使用页面路由请导入router模块。

  1. 第一个页面跳转到第二个页面。

    在第一个页面中,跳转按钮绑定onClick事件,点击按钮时跳转到第二页。"Index.ets"文件的示例如下:

js 复制代码
 // Index.ets
// 导入页面路由模块
import router from '@ohos.router';

@Entry
@Component
struct Index {
 @State message: string = 'Hello World'

 build() {
   Row() {
     Column() {
       Text(this.message)
         .fontSize(50)
         .fontWeight(FontWeight.Bold)
       // 添加按钮,以响应用户点击
       Button() {
         Text('Next')
           .fontSize(30)
           .fontWeight(FontWeight.Bold)
       }
       .type(ButtonType.Capsule)
       .margin({
         top: 20
       })
       .backgroundColor('#0D9FFB')
       .width('40%')
       .height('5%')
       // 跳转按钮绑定onClick事件,点击时跳转到第二页
       .onClick(() => {
         console.info(`Succeeded in clicking the 'Next' button.`)
         // 跳转到第二页
         router.pushUrl({ url: 'pages/Second' }).then(() => {
           console.info('Succeeded in jumping to the second page.')
         }).catch((err) => {
           console.error(`Failed to jump to the second page.Code is ${err.code}, message is ${err.message}`)
         })
       })
     }
     .width('100%')
   }
   .height('100%')
 }
}
  1. 第二个页面返回到第一个页面。

    在第二个页面中,返回按钮绑定onClick事件,点击按钮时返回到第一页。"Second.ets"文件的示例如下:

    // Second.ets
    // 导入页面路由模块
    import router from '@ohos.router';

    @Entry
    @Component
    struct Second {
    @State message: string = 'Hi there'

    build() {
    Row() {
    Column() {
    Text(this.message)
    .fontSize(50)
    .fontWeight(FontWeight.Bold)
    Button() {
    Text('Back')
    .fontSize(25)
    .fontWeight(FontWeight.Bold)
    }
    .type(ButtonType.Capsule)
    .margin({
    top: 20
    })
    .backgroundColor('#0D9FFB')
    .width('40%')
    .height('5%')
    // 返回按钮绑定onClick事件,点击按钮时返回到第一页
    .onClick(() => {
    console.info(Succeeded in clicking the 'Back' button.)
    try {
    // 返回第一页
    router.back()
    console.info('Succeeded in returning to the first page.')
    } catch (err) {
    console.error(Failed to return to the first page.Code is ${err.code}, message is ${err.message})
    }
    })
    }
    .width('100%')
    }
    .height('100%')
    }
    }

  2. 打开"Index.ets "文件,点击预览器中的按钮进行刷新。效果如下图所示:

使用真机运行应用

<><>

运行HarmonyOS应用可以使用远程模拟器和物理真机设备,区别在于使用远程模拟器运行应用不需要对应用进行签名。接下来将以物理真机设备为例,介绍HarmonyOS应用的运行方法,关于模拟器的使用请参考使用Remote Emulator运行应用/服务

  1. 将搭载HarmonyOS系统的真机与电脑连接。具体指导及要求,可查看使用本地真机运行应用/服务

  2. 点击File > Project Structure... > Project > SigningConfigs 界面勾选"Support HarmonyOS "和"Automatically generate signature ",点击界面提示的"Sign In ",使用华为帐号登录。等待自动签名完成后,点击"OK"即可。如下图所示:

  3. 在编辑窗口右上角的工具栏,点击按钮运行。效果如下图所示:

恭喜您已经使用ArkTS语言开发(Stage模型)完成了第一个HarmonyOS应用,快来探索更多的HarmonyOS功能吧。

相关推荐
我要洋人死20 分钟前
导航栏及下拉菜单的实现
前端·css·css3
科技探秘人31 分钟前
Chrome与火狐哪个浏览器的隐私追踪功能更好
前端·chrome
科技探秘人32 分钟前
Chrome与傲游浏览器性能与功能的深度对比
前端·chrome
JerryXZR37 分钟前
前端开发中ES6的技术细节二
前端·javascript·es6
七星静香39 分钟前
laravel chunkById 分块查询 使用时的问题
java·前端·laravel
q24985969342 分钟前
前端预览word、excel、ppt
前端·word·excel
小华同学ai1 小时前
wflow-web:开源啦 ,高仿钉钉、飞书、企业微信的审批流程设计器,轻松打造属于你的工作流设计器
前端·钉钉·飞书
Gavin_9151 小时前
【JavaScript】模块化开发
前端·javascript·vue.js
懒大王爱吃狼2 小时前
Python教程:python枚举类定义和使用
开发语言·前端·javascript·python·python基础·python编程·python书籍
sanzk3 小时前
华为鸿蒙应用开发
华为·harmonyos