必须使用deveco studio创建arkts项目并配置入口页面代码,否则模拟器启动后显示空白或报错;需安装jdk 11并配置java_home,下载sdk,创建empty ability项目,修改index.ets文件,运行至本地模拟器。

要在HarmonyOS上运行第一个HelloWorld应用,必须使用DevEco Studio创建ArkTS项目并正确配置入口页面代码,否则模拟器启动后只会显示空白或报错界面。
安装并配置DevEco Studio开发环境
从HarmonyOS开发者官网下载DevEco Studio最新版(Windows选.exe,macOS选.app),双击安装时勾选“Install HarmonyOS SDK”选项→启动后进入Settings → Appearance & Behavior → System Settings → HarmonyOS SDK,确认SDK路径已自动识别;若未识别,手动指定到C:\Users\{用户名}\AppData\Local\HarmonyOS_SDK(Windows)或~/Library/HarmonyOS_SDK(macOS)→点击Apply保存。
【必须安装JDK 11并配置JAVA_HOME环境变量】,否则新建项目时会提示“JDK not found”,DevEco Studio将无法加载模板。
创建Empty Ability项目
在欢迎页点击“Create Project”→选择Application类型→模板选“Empty Ability”→点击Next。
填写项目信息:Project Name填“HelloWorld”,Bundle Name必须按反向域名格式写成com.example.helloworld,Save Location选一个不含中文和空格的路径(如D:\harmony\projects)→Compile SDK选HarmonyOS 5.0(API 9)或更高版本→Language选ArkTS→Device Type选Phone→点击Finish。
等待项目初始化完成,左侧Project面板中展开entry → src → main → ets → pages,确认存在Index.ets文件。
修改Index.ets显示Hello World
双击打开Index.ets,删除全部默认代码,粘贴以下内容:
@Entry<br>@Component<br>struct Index {<br> build() {<br> Row() {<br> Column() {<br> Text("Hello, HarmonyOS!")<br> .fontSize(30)<br> .fontWeight(FontWeight.Bold)<br> }<br> .width('100%')<br> }<br> .height('100%')<br> }<br>}
注意:Text组件的字符串必须用英文双引号包裹,不能用中文引号或单引号,否则编译失败。
运行到本地模拟器
第一步:点击顶部菜单Tools → Device Manager → 点击New Device → 选择P50 Pro(或其他支持Phone类型的设备)→ Next → Finish,等待模拟器镜像下载完成(首次需10–20分钟)。
第二步:确保左下角设备列表中该模拟器状态为Online,且右侧设备图标呈绿色运行态。
第三步:点击右上角绿色三角形Run按钮 → 选择刚创建的模拟器设备 → 点击OK。
DevEco Studio自动编译HAP包并部署,模拟器启动后几秒内,屏幕中央即显示“Hello, HarmonyOS!”文字。











