# 总览

### \*\* 下载最新版的桌面应用程序 [Petoi Desktop App](https://github.com/PetoiCamp/DesktopAppRelease/releases) \*\*

{% hint style="info" %}

* 下载完成压缩文件（.zip）后，请对其解压缩后再使用。
* Windows用户，请不要将 UI.exe 移动到其他文件目录。
  {% endhint %}

Petoi 桌面应用程序为您提供简洁的图形用户界面来配置固件、校准机器人并可以为您的机器人设计自定义动作。 主要功能模块是[固件上载](https://docs.petoi.com/chinese/zhuo-mian-ying-yong/gu-jian-shang-zai)、[关节校准](https://docs.petoi.com/chinese/zhuo-mian-ying-yong/guan-jie-jiao-zhun)和[技能创作坊](https://docs.petoi.com/chinese/zhuo-mian-ying-yong/ji-neng-chuang-zuo-fang)。

源代码主要采用 Python3 中的 Tkinker 模块编写，GitHub 代码仓库地址是：

&#x20;<https://github.com/PetoiCamp/DesktopAppRelease>

其中 UI.py 是所有模块的总入口：

* UI.py 调用：

-> FirmwareUploader.py

-> Calibrator.py

-> SkillComposer.py

<figure><img src="https://201656985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQ6a951Q6Jn1Zzt5Ajr-3369173170%2Fuploads%2FQQgSvJjjslg464v1hdfS%2Fimage.png?alt=media&#x26;token=6c9f7baa-0126-42f3-a3f8-9ab2418d597c" alt=""><figcaption></figcaption></figure>

translate.py 为 UI 提供多语言支持。 您可以帮助我们将 UI 翻译成您的语言。 在运行应用程序之前，您必须使用随附的 USB 适配器或蓝牙模块连接到 Petoi 机器人。

## 预编译的可执行程序

您可以使用预编译的[可执行程序文件](https://github.com/PetoiCamp/OpenCat/releases)，就不需要使用编程界面了。&#x20;

下载 Mac 版本后，您必须将其拖到 Application 文件夹中。&#x20;

如果您看到“Petoi Desktop App”由于无法验证开发者而无法打开的错误消息，您可以右键单击该图标，按住 **Shift** 键并单击“**打开**”。

![](https://201656985-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQ6a951Q6Jn1Zzt5Ajr-3369173170%2Fuploads%2FItMETy2tWAPs0ULz6ab0%2FMac_right_open.JPG?alt=media\&token=9d165dd9-e5b4-4dcf-bcd1-ff90fb468ee7)

## 在 Terminal 中运行程序

如果此应用程序在运行时出现兼容性问题，或者您想修改应用程序的源代码并进行测试，您也可以在Terminal 中运行程序。 Terminal 是 Mac 或 Linux 系统中的内置界面，Windows 系统中的等效环境称为命令行工具 (CMD)。 建议您安装 [Anaconda](https://www.anaconda.com) 来管理您的 Python 环境，它还可以提供 Powershell 作为旧 Windows 系统中的Terminal 。&#x20;

根据您现有的 Python 配置，您可能需要升级到 Python3 并安装以下库：

* pyserial
* pillow

您可以通过在Terminal 中输入 `pip3 install pyserial pillow` 或使用 Anaconda 中的包管理器来安装它们。 运行程序步骤如下：

1. 在终端中，使用 `cd` 命令导航到 OpenCat/pyUI/ 文件夹， 其间您可以使用 Tab 键自动补充完成路径名
2. 进入 pyUI/ 文件夹后，输入 `ls` 查看此路径下的所有文件，确保可以看到列出的 UI.py 和其他 python 脚本文件
3. 输入 `python3 UI.py` 即可开始运行Petoi 桌面应用程序

{% hint style="info" %}
对于Linux系统用户，`如果遇到 python 报错信息`“\_tkinter.TclError: no display name and no $DISPLAY environment variable”，可以尝试安装 python3-tk，tk-dev，以Debian / Ubuntu为例命令如下：

`apt install python3-tk`

`apt install tk-dev`

安装完成后，重启电脑。
{% endhint %}
