学习鸿蒙应用开发：DevEco Studio 3.1.1 安装-设置-创建项目-汉化-真机调试过程详细记录

前言

随着华为Mate 60 的发布，鸿蒙系统火了起来，近段时间不少大厂宣布开发原生鸿蒙应用，预示着鸿蒙系统的良好前景。我是2022年开始接触手机应用开发的，学习了一点java，照着教程和网上的资料开发了几款安卓应用，都是针对自己所在公司的一些工作而开发的，在公司内部得到了推广，同事的反映还比较好。但使用过程中，发现有同事使用的华为鸿蒙系统手机，我的应用在其手机上安装后存在一些问题。最近又听说，以后的鸿蒙系统将不再兼容安卓了。鉴于以上情况，我就想着自学鸿蒙应用的开发，尝试开发原生鸿蒙应用，已解决我自己开发的应用不能再鸿蒙系统上正常使用的问题。

这些天，我通过在华为开发者联盟网站和哔哩哔哩网站，学习教学视频，查阅开发文档资料，初步了解了ArkTs语言的基础知识和DevEco Studio的基本功能。由于我有一点安卓应用开发的经验，学习ArkTs和DevEco Studio感觉也不难（仅限于基础知识）。为了更好的学习，前几天，我还买了一部华为的Nova 10 手机，经过一番尝试成功实现了真机调试。今天把我学到的关于DevEco Studio从安装到真机调试的知识点，总结归纳一下，写成这篇博文以备忘。

一、安装DevEco Studio

写这篇文章的时候，我已经是第二次安装了，第一次是在笔记本电脑上安装的。这次在台式机上安装。特意将整个流程截图，便于更好的说明。

安装方法在华为开发者联盟官网上有说明文档（ DevEco Studio 搭建开发环境流程），但我看了半天，感觉官方文档要照顾到不同的系统和软件版本，因此写得比较繁琐，有些配图和当前的官网可以下载到的DevEco Studio 3.1.1 Release版本不一样，因此，我觉得还是将自己的安装过程贴出来，方便其他安装DevEco Studio 3.1.1 Release版的朋友参考。

我是从华为开发者联盟官网下载的DevEco Studio 3.1.1 Release版本。

https://developer.harmonyos.com/cn/develop/deveco-studio/

下载后是一个zip的压缩包，打开压缩包，里面是一个文件夹，安装文件“deveco-studio-3.1.0.501.exe”就在这个文件夹里。

点击“deveco-studio-3.1.0.501.exe”文件，进入安装界面，我看了不少软件的安装教程都要求不要将软件安装到默认的C盘的目录下，我将安装目录设置到了D盘。

下面的这个界面，我个人觉得都有必要，于是将三个选项都勾选上了。这个根据自己的情况选择。

开始菜单设置使用了默认值

安装完成。

二、设置向导

安装好后，第一次运行DevEco Studio，会出现许可协议页面，点Agree。

软件弹出导入设置选中框，选中第二项不导入设置。

正式进入设置向导页面，第一步基础设置，Node.js和Ohpm全部选择Install，默认的目录都是C盘。我先在D:\Huawei\文件夹下面手动创建了nodejs和phpm目录，然后在此页面中点击右侧的文件夹图标，选择我所创建的文件夹。设置好后点Next。

下图在D:\Huawei\文件夹下第一个文件夹是安装DevEco Studio时安装程序创建的，下面的三个都是我手工创建的。

设置向导第二步SDK设置。这里我同样修改了SDK的安装目录，这个目录也需要自己手工创建后，再在这个界面中选择。

上一步设置好SDK的目录后，就会进入下面的页面，SDK的许可协议分为HarmonyOS-SDK和OpenHarmony-SDK两个，我都是选择了Accept。然后点Next。

第三步，对之前的选项进行汇总，显示nodes.js、ohpm和SDK将要下载的目录，以及文件容量大小和版本。

文件下载需要一段时间，下载完成后点Finish

三、创建项目

完成了设置向导，会自动进入以下界面，第一次运行，选择Create Project。

一般的教程都是推荐选择Empty Ability。其它的选项我也没尝试过。

之后就是项目的一些设置。一般需要修改Project name、Bundle name和Save location。而且这三个参数是有关联的。

修改Project name，则Bundle name和Save location的后缀会随之变化。

第二项的Bundle name中com.后面默认是example，我在安卓应用开发时都是用的自己的英文网名bahamutj，因此这里也修改成了bahamutj。

第三项的Save location，我也将路径修改到了D:\Huawei\目录下。

其他地方保持默认值。

设置完成后，DevEco Studio会自动创建一个显示Hello World 的页面。页面内容可以通过点击界面右侧的Previewer显示。而且我发现，这个预览界面不只是静态的，如果页面中有的控件使用了@State修饰的变量，那么变量出现变化，对应的控件也会自动发生变化，这点比Android Studio要好。

四、软件界面汉化

华为开发者联盟官方文档写明了DevEco Studio是基于IntelliJ IDEA Community开源版本打造的。我开发python软件的工具Pycharm Community和IntelliJ IDEA Community是同一家公司开发的，所以，DevEco Studio的界面和功能给我一些似曾相识的感觉。Pycharm Community有汉化插件，因此DevEco Studio也应该有。我尝试了一下果然完成了汉化。

点击菜单：File->Setings。

在Setings界面，选择Plugins，在右侧我输入了chinese，点搜索。软件默认是从Marketplace中搜索，结果没有搜到汉化插件，但当我选择了Installed后，界面中立刻显示了汉化插件，看样子，这个汉化插件已经集成在软件里了。勾选上这个汉化插件，点Apply或OK。

回到软件界面，弹出了提示框，选择Restart。

软件重启后，就变成中文界面啦。

五、尝试复制已有的项目文件

前面已经说了，写这篇文章时，是我第二次安装DevEco Studio，之前在笔记本上我已经创建了一个项目，并跟着视频教程做了几个页面。

第二次在台式机上安装好DevEco Studio后，我尝试着将笔记本电脑上的项目文件复制到台式机的项目文件夹下。

完成复制后，重新打开DevEco Studio，复制过来的项目文件能够正常显示。

六、进行真机调试

关于真机调试，华为开发者联盟官网上说相关的文档说明（使用真机进行调试）。在调试前，需要配置签名信息，否则会失败。配置签名需要注册账号并实名认证（实名认证）。我第一次调试是在笔记本电脑上按照官方文档进行的操作，经过摸索成功了。这次写文章则是在台式机上进行，复制完项目，将手机开启开发者模式，连接到电脑上后，就点“运行”按钮开始调试，结果，自然是错误不断了。这里将这次的操作过程记录一下。

另外需要说明的是，为了更好的开发华为应用，我特意买了个千元级别的nova 10 手机，该机默认的操作系统是鸿蒙3.0。在之前的摸索中，我发现无法在3.0版本的手机上进行调试，之后将手机系统进行更新（手机自动查找到的4.0版本，而不是3.1版本）。升级到4.0版本后，实现了真机调试。

这次的调试过程如下：

我在将项目复制到台式机上后，打开DevEco Studio，发现项目文件能正常读取，于是连接上手机。

待DevEco Studio识别到手机后，点“运行”按钮开始调试，结果软件报错了（如下图）。我在网上搜了一下，得到的答案是缺失签名配置文件。

我按照网上找到的方法，点击软件右上角的图标，登录华为开发者联盟的注册账号。也可以按照官网文档操作 （使用真机进行调试）

软件自动打开浏览器，输入用户名和密码。

显示登录成功。

软件弹出的界面，点Agree。

打开“项目结构”（File->Projict Structure）,选择Project - Signing Configs。 勾选Automatically generate signature。软件自动下载签名信息。

软件从官网下载到了我的签名信息。点OK确认。

完成上述操作后，再次调试，结果还是报错。看提示还是和签名有关，但我之前已经完成签名设置了呀。

之后我想到了之前在笔记本上进行最后一次调试时，是正常的，但好像昨天晚上手机自动更新过系统，今天白天我再运行手机上自己做的app就出现异常了。我干脆将手机上的app卸载掉，然后再次点运行按钮，经过短暂的等待，手机上出现了我做的应用的页面，成功实现真机调试。