鸿蒙软件开发1-1 从零入门到hello world

本系列是windows系统下、采用ArkTS语言、ArkUI框架、deveco studio编译器学习纯鸿蒙软件研发，采用API version 9进行。本小节主要介绍如何从零开始搭建开发环境、下载、安装、配置编译器、配置开发环境、创建新工程、创建密钥、申请应用认证、应用真机调试运行~，纯小白，一步步学习，记录一下过程便于查询。

weixin_51267334

953人浏览 · 2023-11-20 15:25:30

weixin_51267334 · 2023-11-20 15:25:30 发布

目录

简介

1.鸿蒙软件运行环境

2.下载、安装编译器DevEco Studio

3. 配置开发环境

3.1第一次启动配置

3.2 非第一次启动配置

4.创建Hello World工程

5.根据真机设备适配SDK版本、API版本、编译工具版本及类型

6.创建密钥、申请认证文件

6.1自动签名

6.2手动配置签名

6.2.1 生成密钥文件

6.2.2 申请调试证书和调式Profile认证文件

7.配置运行环境

8.调试设置

9.运行

简介

1.鸿蒙软件运行环境

本系列主要是在windows系统下进行，运行环境要求如下：

（1）操作系统：Windows10 64位

（2）内存：8GB及以上

（3）硬盘：100GB及以上

（4）分辨率：1280*800像素及以上

2.下载、安装编译器DevEco Studio

（1）下载编译器：HUAWEI DevEco Studio和SDK下载和升级 | HarmonyOS开发者

（2）安装编译器：文档中心

主要安装步骤为：

下载完成后，双击下载的编译器exe，进入编译器安装向导，在如下界面选择安装路径，之后点击下一步：

到如下安装界面时，可只勾选第一项，其他步骤点击Next即可。

3. 配置开发环境

配置开发环境主要包括：第一次启动DevEco studio的配置，第一次启动点击错了的配置。

主要配置内容包括：node.js配置，SDK及工具链下载及配置、HDC工具环境变量配置。

3.1第一次启动配置

（1）运行已安装的DevEco Studio，首次使用，选择Do not import settings，单击OK。

（2）进入DevEco Studio操作向导界面，修改npm默认的仓，由于本人不需要，直接跳过了该步骤，需要的可以参考文档中心下的配置Deveco Studio代理和npm代理部分。如果使用API4-7，还需配置Gradle代理。

（3）Node.js配置：可以指定本地已安装的Node.js（Node.js版本要求为v14.19.1及以上，且低于v15.0.0；对应的npm版本要求为6.14.16及以上，且低于7.0.0版本）；如果本地没有合适的版本，可以选择Download按钮，建议刚学的人可以选择直接Download，避免出现node.js不适配的情况，点击下一步会进入下载，finish即可。

（4）SDK及工具链下载：在SDK Components Setup界面，设置OpenHarmony SDK和HarmonyOS SDK存储路径，单击Next进入下一步。

***注意：OpenHarmony SDK和HarmonyOS SDK不能设置为同一个路径，且路径中不能包含中文字符。

弹出License Agreement串口，选中左边某项，右边会出现协议及同意和拒绝协议的按钮，均勾选同意后，左侧均为√，即可Next开始下载SDK。下载完毕后，直接Finish即可。

（5）HDC工具环境变量配置

HDC是为开发者提供HarmonyOS应用/服务的调试工具，为方便使用HDC工具，请为HDC工具及其端口号设置环境变量。

在此电脑 > 属性 > 高级系统设置 > 高级 > 环境变量中，添加HDC端口变量名为：HDC_SERVER_PORT，变量值可设置为任意未被占用的端口，如7035。

在系统或者用户的path变量中，添加HDC工具路径，HDC工具路径为：HarmonyOS SDK安装目录/toolchains/{版本号}。环境变量配置完成后，关闭并重启DevEco Studio。

3.2 非第一次启动配置

如果比较着急在第一次启动时，关闭了向导进入了编译器的欢迎界面，可以通过如下方式对上述步骤进行配置。

在DevEco Studio欢迎页，左下角找到Help>Diagnose Development Environment，打开Diagnose Development Environment弹窗，主要对Basic Configurations中的三项进行依次下载原装，设置好后再按照上述步骤进行HDC配置即可。配置完成后，界面如下：

4.创建Hello World工程

进入Deveco Studio欢迎界面后，点击Create Project选项，创建一个新工程，选择“Empty Ability”模板，然后单击Next。

填写工程相关信息，单机Finish。（此处有误，已作了修正，修正后如下图片）

工程创建完成后，DevEco Studio会自动进行工程的同步，同步成功如下图所示：

5.根据真机设备适配SDK版本、API版本、编译工具版本及类型

真机环境对于不同的SDK、API、编译工具版本及类型具有一定的适配度，如果不适配，运行会触发如下错误：

该错误的原因是SDK、API、编译工具版本及类型存在不适配，在设备中运行应用/服务时，build.gradle(API4-7)或build-profile.json5（API8及以上版本）文件中的compileSdkVersion和compatibleSdkVersion，以及SDK Stage（Beta或Release）需要与设备的apiVersion、releaseType相互匹配才能正常运行。解决办法：

（1）在HarmonyOS SDK存储目录下的Sdk\hmscore\{版本号}\toolchains文件下打开CMD命令行工具。

（2）打开你要测试的真机设备，点击设置>关于平板电脑>HarmonyOS版本，查看手机/平板的HarmonyOS版本。

（3）执行如下命令进行查询真机设备的apiVersion和releaseType取值。

在手机/平板HarmonyOS 3.1 Release设备上：

hdc -c shell 
getprop persist.sys.ohc.apiversion
getprop persist.sys.ohc.releasetype

在手机/平板HarmonyOS 3.1 Release之前版本的设备上：

hdc -c shell
getprop hw_sc.build.os.apiversion
getprop hw_sc.build.os.releasetype

由于我的真机版本是4.0，所以嵌入代码和查询结果如下：

（4）点击File > Settings > SDKs > HarmonyOS，查看compileSdkVersion对应的SDK stage。例如，下图中API Version 9对应的Stage为Release。

（5）根据查询的设备apiversion、releaseType，以及SDK Stage的取值，再查询下表中的匹配关系，来修改compileSdkVersion和compatibleSdkVersion的值。其中compileSdkVersion需要修改工程和各模块build.gradle中的取值；compatibleSdkVersion需要修改各模块下的build.gradle中的取值。

apiVersion	releaseType	compileSdkVersion	SDK Stage	compatibleSdkVersion
4	Release	4	Release	4
4	Release	5	Release	4
5	Release	5	Release	4或5
5	Release	5	Release	4或5
5	Release	6	Release	4或5
5	Release	6	Release	4或5
6	Release	5	Release	4或5
6	Release	6	Release	4或5或6
6	Release	5	Release	4或5
6	Release	6	Release	4或5或6
7	Release	7	Release	4或5或6或7
7	Release	6	Release	4或5或6
8	Release	6	Release	4或5或6
8	Release	8	Release	8
9	Release	9	Release	9

由于我的真机的apiversion、releaseType，以及SDK Stage的取值分别为9，release以及release，所以确定我的compileSdkVersion和compatibleSdkVersion的值均为9。

（6）打开模块的build.gradle（API4-7）或打开工程的build-profile.json5（API8-9）文件，查看compileSdkVersion、compatibleSdkVersion。

当前应用版本和设备镜像版本匹配后，如果仍然报该错误，且设备镜像版本已更新为3.1 Release版本，则说明当前使用的DevEco Studio版本与设备运行的镜像版本不匹配，请升级DevEco Studio至3.1 Release版本，在新版本DevEco Studio上进行运行/调试。

6.创建密钥、申请认证文件

匹配好版本后，需要先对工程进行签名，然后才能运行在真机设备中，签名方式分为自动和手动两种。

6.1自动签名

（1）想要使用自动签名需要先进行华为账号登陆，进入如下界面，点击允许。

（2）单击File > Project Structure > Project > Signing Configs界面勾选Automatically generate signature，等待自动签名完成即可，单击OK。如下图所示：

6.2手动配置签名

HarmonyOS应用/服务通过数字证书（.cer文件）和Profile文件（.p7b文件）来保证应用/服务的完整性。在申请数字证书和Profile文件前，首先需要通过DevEco Studio或命令行工具来生成密钥（存储在格式为.p12的密钥库文件中）和证书请求文件（.csr文件）。然后，申请调试证书和调试Profile文件。最后，将密钥（.p12）文件、数字证书（.cer）文件和Profile（.p7b）文件配置到工程中。

密钥：包含非对称加密中使用的公钥和私钥，存储在密钥库文件中，格式为.p12，公钥和私钥对用于数字签名和验证。
证书请求文件：格式为.csr，全称为Certificate Signing Request，包含密钥对中的公钥和公共名称、组织名称、组织单位等信息，用于向AppGallery Connect申请数字证书。
数字证书：格式为.cer，由华为AppGallery Connect颁发。
Profile文件：格式为.p7b，包含HarmonyOS应用/服务的包名、数字证书信息、描述应用/服务允许申请的证书权限列表，以及允许应用/服务调试的设备列表（如果应用/服务类型为Release类型，则设备列表为空）等内容，每个应用/服务包中均必须包含一个Profile文件。

如果6.1自动配置方式失败，或者想要自己设定和知道签名过程中各个文件所处位置，可以选择手动配置签名，步骤如下：