5. PyCharm鸿蒙Hypium：从0到跑通，少踩90%坑

配套的动画视频在：《5. PyCharm×鸿蒙Hypium：从0到跑通，少踩90%坑》。

打开鸿蒙官方(https://developer.huawei.com/consumer/cn/download/)，下载命令行工具和自动化测试开发库。开发工具用PyCharm社区2025.1版的，下载command-line-tools6.1和DevEco Testing Hypium 6.1。

PyCharm 2026版本的，则下载command-line-tools 26.0版和DevEco Testing Hypium 26.0。

建议将解压后的工具直接放在项目里，方便后期迁移。项目在E:\AutoTest下，解压缩之后，在项目中存放的形式如下：

E:\AutoTest\command-line-tools

E:\AutoTest\hypium-6.1.0.210 文件夹下存放如下：

hypium-6.1.0.210-py3-none-any.whl

hypium-pycharm-plugin-6.1.0.210.zip

xdevice-6.1.0.210-py3-none-any.whl

xdevice_devicetest-6.1.0.210-py3-none-any.whl xdevice_ohos-6.1.0.210-py3-none-any.whl

接下来，先来配置命令行运行环境，打开菜单【File】，选择【Settings】，找到Tools下面的【Terminal】。

在右边找到 【Environment variables】并点击最右边的图标，打开配置窗口。

 打开的窗口中，name填写：PATH；value：填写命令工具所在的目录，末尾用;分隔之后并且添加%PATH%，完整值如下：

E:\\hypium_test\\command-line-tools\\sdk\\default\\openharmony\\toolchains;%PATH%

按下【OK】按钮，进行保存。

在返回的窗口中，按下【Apply】按钮，进行确定保存。

找到左侧的【Plugins】选项并进行点击。

在右边窗口，有个配置按钮，选择【Install Plugin from Disk…】

 选择hypium-pycharm-plugin-6.1.0.210.zip，PyCharm会自动进行安装。

 

安装完之后，要按下【Restart IDE】按钮，重启PyCharm之后，插件才能生效。

接下来还需要配置hdc.exe命令，好同步手机镜像。打开菜单【File】，选择【Settings】，在左侧菜单栏的最下面，就可以看到刚刚安装的插件【DevEco Testing Hypium】，点击之后，眼光移到右边窗口。

找到Hdc路径，找到command-line-tools下面，找到hdc.exe，下面是完整目录：

E:/hypium_test/command-line-tools/sdk/default/openharmony/toolchains/hdc.exe

按下【Apply】按钮之后，配置就全部完成了。

 要用 hypium进行开发的话，还需要安装开发包。打开命令行窗口，输入如下命令，进入到开发包目录下。

cd hypium-6.1.0.210

 后面的开发包需要用到前面的，要按照顺序进行安装才行。

pip install xdevice-6.1.0.210-py3-none-any.whl xdevice_devicetest-6.1.0.210-py3-none-any.whl xdevice_ohos-6.1.0.210-py3-none-any.whl hypium-6.1.0.210-py3-none-any.whl

 重新打开一个命令行窗口，输入如下命令，如果能看到手机的序列号，说明hdc通信可以了。当前，前提是你先将手机，通过USB数据线接到电脑上才能看到。

hdc list targets

打开右边UIView面板，如果可以看到手机镜像，说明插件安装和配置没问题。

打开命令行窗口，如下如下命令，安装我们将要测试的app。

hdc install myapp.hap

再次打开镜像窗口，如果可以看到myapp的logo，那配置就大功告成了，可以放心，大胆的进行下一节，开发截图功能。

配套的动画视频在：《5. PyCharm×鸿蒙Hypium：从0到跑通，少踩90%坑》。