从一个Hello World工程说起当你用DevEco Studio创建一个新项目时通常会得到一个这样的工程结构。我们需要关注的核心代码目录有三个AppScope存放应用的全局配置比如应用名称和应用图标。entry/src/main/ets主要的编码工作区。应用入口entryability和所有页面pages都在这里。entry/src/main/resources资源文件目录用于存放图片、多语言字符串、颜色值等。使用资源文件管理样式是好的实践能让应用更易于维护。 页面是如何被加载的从入口到界面一个页面从代码到呈现在屏幕上遵循着清晰的路径UIAbility (应用入口)EntryAbility.ets文件是应用的入口。它在启动时创建“舞台”WindowStage并决定首先加载哪个页面。加载页面在onWindowStageCreate方法中通过windowStage.loadContent(pages/Index, ...)这行代码指定了要加载的页面是pages目录下的Index.ets文件。路由配置resource/base/profile/main_pages.json文件就像一张“地图”所有需要被访问的页面都必须在这里注册。IDE通常会自动帮你完成这一步。 核心代码逐行拆解打开pages/Index.ets文件我们通过一个示例来分析其核心构成。1. 装饰器为组件赋予“身份”与“能力”typescriptEntry // 标记该组件是一个页面入口与main_pages.json中的配置对应[citation:1] Component // 标记这是一个自定义组件可被其他组件复用[citation:1] export struct Index { // export导出使其可以被其他文件导入使用[citation:1] // ... }Entry 表示这个组件是一个页面可以从UIAbility被直接加载。Component 表示这个struct结构体是一个自定义组件它拥有独立的UI构建逻辑。你可以把它看作是乐高积木用于搭建复杂界面。export 如果你写的组件希望被其他文件引用就需要使用export导出。2. 响应式数据UI自动更新的秘密typescriptState message: string Hello World; // 状态变量State装饰器是声明式UI的“灵魂”。它告诉ArkUI框架请帮我时刻关注这个message变量的变化一旦它变了所有用到它的UI都要立刻刷新。传统的命令式开发如Android早期需要你手动找到TextView并调用setText()而声明式开发State则省去了这一步极大提升了开发效率减少了60%的DOM操作量。3. build函数用“鱼鳞式”语法描绘UIbuild()函数是组件的“画板”所有UI元素都在这里定义和布局。这种通过嵌套代码块来描述UI结构的方式被称为鱼鳞式布局它让UI结构一目了然。typescriptbuild() { // 根容器RelativeContainer相对布局占满全屏 RelativeContainer() { // 子组件一个文本 Text(this.message) .id(HelloWorld) // 设置ID便于锚点定位 .fontSize($r(app.float.page_text_font_size)) // 从资源文件读取尺寸 .fontWeight(FontWeight.Bold) .alignRules({ // 设置对齐规则锚点相对于父容器水平和垂直居中 center: { anchor: __container__, align: VerticalAlign.Center }, middle: { anchor: __container__, align: HorizontalAlign.Center } }) .onClick(() { // 绑定点击事件 this.message Welcome; // 点击后更新状态触发UI刷新 }) } .height(100%) .width(100%) }容器与组件RelativeContainer是布局容器Text是基础组件。你可以像搭积木一样组合它们。链式调用通过.fontSize()、.onClick()这样的链式调用可以非常方便地为组件添加属性和事件这是声明式UI的典型特征。资源管理$r()使用$r(app.float.xxx)来引用资源文件中的数值是实现多设备适配和国际化的关键一步。这能有效减少硬编码也使应用包体积更小。事件处理onClick事件里直接修改State修饰的message数据变了UI就跟着变。这背后正是状态管理机制在生效。➕ 更多示例项目学什么当你掌握了最基础的Hello World就可以通过更多示例项目来深化理解。这些项目通常涵盖了HarmonyOS开发的核心领域非常值得深入研究示例主题核心学习目标涉及的关键API/概念用户首选项功能学习应用数据的轻量级持久化存储。preferences实现数据的put、get、flush操作。调用本地库及三方库学习如何引入和使用别人写好的代码库提高开发效率。ohpm包管理Navigation路由Tabs切换Canvas绘图。笔记应用模板学习一个完整、分层架构的商业级应用是如何设计的。模块化分层设计RichEditor富文本编辑SwipeAction滑动操作华为账号一键登录。文件管理服务学习如何调用系统能力实现如删除文件到回收站等功能。File Manager Service Kit文件URI操作与权限申请。这些官方的Codelabs和模板项目是理解HarmonyOS能力边界和最佳实践的最佳途径。