个人主页杨利杰YJlio❄️个人专栏《Windows 疑难杂症与工单复盘案例库》 《Sysinternals实战教程》《WINDOWS教程》 《Windows PowerShell 实战》 《IOS插件分析测试》《超简单用Python让Excel飞起来》让复杂的事情更简单让重复的工作自动化文章目录前言先让第一个工程运行起来一、安装之前先记录开发环境二、“装好了”要拆成六项检查三、创建一个最小 ArkTS 工程1. 选择应用模板、语言与目标设备2. 核对工程信息四、先认识工程中几个常用位置五、用一段文本理解 ArkTS 页面六、首次运行按顺序核对结果第一轮验证模板基线第二轮验证单点修改七、同步和构建失败时先找第一条错误同步一直没有结束教程中的模板名称找不到还没改代码构建就失败八、设备和页面问题分别检查模拟器启动了IDE 没有运行目标修改了文字设备仍显示旧页面学习总结参考资料前言先让第一个工程运行起来大家好我是杨利杰 YJlio。这是我的 HarmonyOS 7.0 学习笔记第 01 篇。本篇从开发环境开始整理 DevEco Studio 安装、SDK 配置、创建 ArkTS 工程以及首次运行的检查方法。做桌面支持和排障时我习惯先找到问题所在的环节再处理具体报错。学习应用开发也可以用这个思路创建工程、同步依赖、编译、安装、启动每一步都有自己的检查结果。把这些结果记清楚后面遇到问题就有一条可追溯的路径。我的练习安排是先运行 IDE 生成的模板确认基础环境可用再修改首页的一段文字检查修改是否出现在设备上。第一次练习先建立可复现的运行基线每次只改一个因素才能判断问题出在哪一步。本文配图为根据学习内容制作的示意信息图。IDE 界面、目录细节和选项以实际版本为准文中的环境版本与运行结果需要在完成实际操作后填写。一、安装之前先记录开发环境DevEco Studio 是华为面向 HarmonyOS 应用及元服务开发提供的集成开发环境。安装包应从华为开发者联盟的 DevEco Studio 资源页获取并根据官方要求选择适合本机操作系统的版本。本系列使用“HarmonyOS 7.0 学习笔记”作为名称。实际工程使用哪个 SDK、API 级别和模板要根据本机配置填写不能用系列标题代替环境记录。项目需要记录的内容本次记录操作系统系统名称、版本与体系结构待填写DevEco StudioIDE 的完整版本号待填写HarmonyOS SDK/API工程实际使用的 SDK 与 API 级别待填写工程模板本次选择的模板名称待填写目标设备模拟器或真机型号、系统版本待填写应用包名工程中实际使用的应用标识待填写首次启动 IDE 时可能还需要下载 SDK、构建工具和模拟器组件。提前检查网络、磁盘空间和下载状态在依赖仍然下载时先观察进度和日志。此处先填写开发环境。同步、构建、启动和页面修改结果留到第六节完成实际操作后再记录。二、“装好了”要拆成六项检查IDE 能打开以后还需要确认工程能够同步、构建和运行。我会按下面六个环节逐项检查。环节检查内容适合保留的记录识别工程IDE 是否打开了正确工程目录工程名称、目录路径SDK 就绪工程所需 SDK 是否可用SDK 配置与版本同步完成依赖同步是否结束有没有待处理错误同步输出、首条错误构建结果构建任务是否完成任务名与完整结果设备连接模拟器或真机是否出现在运行目标中目标设备名称、连接状态应用启动应用是否安装并进入预期首屏实际设备画面与启动日志IDE 安装完成只能说明工具已安装首屏运行需要另外验证。如果工程同步失败就先处理同步错误如果构建成功但找不到设备就检查设备连接。这样记录比直接反复重装整个开发环境更容易保留排错线索。三、创建一个最小 ArkTS 工程第一次创建工程时我会选择当前 IDE 提供的基础 HarmonyOS 应用模板保留生成的页面和入口代码先验证模板本身能否运行。1. 选择应用模板、语言与目标设备打开新建工程入口按照本次用途选择应用模板、ArkTS 技术栈和目标设备类型。不同 IDE 版本的模板名称、分类和选项可能变化需要按实际界面辨认。ArkTS 是鸿蒙生态的应用开发语言入门资料可从华为官方 ArkTS 页面查阅。本文练习使用 ArkTS 页面暂时不添加额外业务模块。2. 核对工程信息配置项本次练习的处理方式工程名使用简短、容易辨认的名称例如HarmonyFirst包名练习可采用com.example.harmonyfirst正式应用按自身发布要求设置保存路径选择稳定、简短的独立目录避免后续随意移动SDK选择本机已安装、且当前模板支持的版本目标设备与本次准备运行的模拟器或真机匹配创建完成后等待依赖同步结束。同步尚未完成时不宜同时更换多个 SDK 版本否则会增加排查变量。四、先认识工程中几个常用位置模板生成后我会先确认页面源码、Ability 入口、资源和模块配置分别放在哪里。此时不需要记住所有配置项但要知道修改页面时应该查看哪个文件。部分入门阶段先理解的作用entry模块常见模板中的应用入口模块具体模块名以工程为准ArkTS 页面描述页面布局和交互的源码位置Ability 入口查看应用启动与页面加载相关代码资源目录存放图片、字符串等应用资源模块配置查看模块信息、能力和相关配置声明本节图示围绕当前应用模块展示页面、Ability 入口、资源与模块配置的功能关系。它不表示实际文件的目录层级修改前应在本机工程中确认完整路径尤其要区分同名页面和不同模块。先找到当前运行模块使用的页面再修改文本文件名相同不代表就是同一个运行入口。五、用一段文本理解 ArkTS 页面首次运行时先保留模板原样。模板能够启动后再在对应页面中修改一处文本并重新运行。这一步用来确认源码文件与设备画面之间的对应关系。下图对应两个 Text 的页面示例展示build()、Column、文本字号和居中布局之间的关系。图后的代码保留原稿示例。EntryComponentstruct Index{build(){Column(){Text(HarmonyOS 学习笔记第一个页面).fontSize(22).fontWeight(FontWeight.Bold)Text(先确认模板可运行再添加功能。).fontSize(16).margin({top:12})}.width(100%).height(100%).justifyContent(FlexAlign.Center).alignItems(HorizontalAlign.Center)}}build()中的组件组织描述页面内容Column把子组件按纵向排列两个Text用来展示文字后面的样式方法设置字号、间距和布局。本节图示的手机页面与上方代码对应第一段是“HarmonyOS 学习笔记第一个页面”第二段是“先确认模板可运行再添加功能。”两段文字组成的内容在页面中居中排列。这段代码属于页面结构示例。放入工程时应核对当前模板的页面写法和 SDK 支持情况保留模板已有的入口与必要导入。若属性、枚举或组件声明报错先查看对应 API 文档和模板代码。入门练习优先只替换模板中的一段文字不要同时覆盖页面、入口和工程配置。六、首次运行按顺序核对结果我会把第一次运行拆成两轮。第一轮运行未修改的模板第二轮只改一处首页文本确认修改生效。第一轮验证模板基线打开工程等待同步结束检查是否仍有下载或错误。启动目标模拟器或连接已完成调试授权的真机。在运行配置中选择正确模块和目标设备。执行运行操作查看构建和安装结果。在设备上核对实际首屏同时保留需要的日志与截图。第二轮验证单点修改找到当前运行模块使用的首页文件。将一段文本改为容易辨认的新内容保存文件。重新构建并运行确认部署完成。核对设备是否显示新内容记录结果。记录项实际操作后的填写方式模板首次构建填写构建结果失败时记录任务名和首条错误应用首次启动填写能否进入首屏及实际表现文本修改填写新文本是否出现在设备上未解决问题记录现象、已检查事项与下一步下面这张记录表的左页对应第一节的环境信息右页对应本节的同步、构建、启动和文本修改结果。两部分都按实际情况填写。步骤写完不等于运行成功。只有实际构建结果、设备画面和日志才能支持结果记录。七、同步和构建失败时先找第一条错误同步一直没有结束先查看同步输出判断是在持续下载、等待网络响应还是已经失败。检查下载源和代理设置是否符合当前环境要求保留有上下文的错误信息。如果下载仍有进展先等待当前任务如果有明确错误就针对该错误处理。同步问题尚未查清时反复切换 SDK 会让原因更难区分。教程中的模板名称找不到根据 HarmonyOS 应用类型、ArkTS 技术栈和目标设备筛选当前模板。再检查生成的工程是否具备本次需要的页面、入口和模块配置。旧教程的名称可以作为线索实际界面和官方说明才是配置依据。还没改代码构建就失败优先确认 SDK 是否可用、同步是否结束再看首个失败任务属于配置、依赖还是源码编译。保存完整的第一段错误和任务名称最后一行的“失败”提示往往不足以定位问题。我会记录四件事当时在做什么、第一条错误是什么、已经检查了什么、下一步准备只改哪个因素。这样再次运行时结果才便于比较。八、设备和页面问题分别检查模拟器启动了IDE 没有运行目标确认模拟器已经完全启动并能被设备管理功能识别。不要仅凭模拟器窗口出现就认定连接已完成。真机调试按当前设备系统完成开发者选项设置和授权。检查实际连接状态先保存日志和设备状态再尝试重新连接。修改了文字设备仍显示旧页面按照“文件—保存—构建—部署—画面”的顺序检查。确认改的是当前运行模块使用的页面文件已保存本次构建和部署均完成。可以临时使用一段明显不同的文本排除改错文件或看错页面的情况。这次练习尚未引入动态状态逻辑先检查基础运行链路。学习总结第一篇练习的目标是建立一个能重复验证的最小开发环境。我会先确认 IDE、SDK、同步、构建、设备连接和应用启动再用一处文本修改验证源码与画面的关系。完成实际练习后补齐环境表、运行结果和真实截图。如果某一步还没完成就保留“待验证”的记录并写清当前问题。把每一步的结果记录清楚比一次修改很多设置更有助于后续排错。下一篇将进一步查看entry模块、ArkTS 页面、Ability 入口、资源目录与模块配置继续通过小范围修改理解工程结构。参考资料华为开发者联盟DevEco Studio 资源与开发工具华为开发者联盟ArkTS 语言声明本文为学习笔记与操作方法整理配图为示意信息图实际工具版本、工程界面与运行结果以本机操作和官方文档为准。返回顶部
