Appium Desktop

Appium Desktop是一款适用于Mac、Windows和Linux的应用程序，它以漂亮而灵活的用户界面为你提供Appium自动化服务器的功能。它基本上是Appium服务器的一个图形界面。你可以设置选项，启动/停止服务器，查看日志等。你也不需要使用Node/NPM来安装Appium，因为Node运行时间与Appium Desktop捆绑在一起。

**注意：**Appium Desktop中曾经包含一个检查器UI。它现在是自己独立的应用程序。Appium Inspector。

下载Appium Desktop

你可以随时在GitHub上的发布页面获取最新的服务器GUI版本。

如果你在Windows或macOS上，Appium Desktop会在应用发布后自动为你提供更新版本。如果你遇到更新问题，只需删除或卸载该应用，然后从上面的链接重新下载最新的。

请注意，Appium Desktop与Appium_不是_一回事。Appium Desktop是Appium的图形化前端，带有额外的工具。Appium Desktop按自己的节奏发布，有自己的版本系统。如果你报告Appium Desktop的问题，一定要确保_包括_Appium Desktop的版本和正在使用的Appium Server的版本（见下文）。

如果你使用的是macOS，你需要安装Appium Desktop应用，方法是将下载的DMG文件中的应用复制到你自己的文件系统中（最佳位置是 "应用程序 "文件夹）。不支持从所附的DMG本身运行Appium，也不会工作。

在macOS上安装

如果你在macOS上使用桌面应用程序，当你运行它时，很可能会出现一些错误，如应用程序无法打开，或未经苹果验证，或类似的错误。绕过这个问题的最简单方法是在你下载的文件上运行xattr -cr 。因此，假设你下载了appium-desktop.dmg 。然后在打开磁盘镜像之前，你可以运行xattr -cr appium-desktop.dmg 。zip版本（或.app本身）也是如此。

原因是Appium团队没有付费的苹果开发者账户，所以我们的应用程序没有被他们认可的证书签署，所以操作系统试图阻止它运行。运行上面的命令可以绕过这个安全限制。

已知的问题

• 一些Windows 10用户在安装EXE时遇到PathTooLongException 。解决这个问题的方法是更新Windows上的设置，以启用长路径。

使用说明

这些说明假定你已经熟悉了Appium和Appium相关概念。如果你是Appium的新手，请访问appium.io并阅读我们的介绍性材料。这些说明还假定你已经下载了服务器图形用户界面和检查器应用程序。

该应用提供了下载和运行Appium自动化服务器的便捷方式，也是检查Chrome/Safari浏览器和你的Android或iOS应用中的元素的工具。它的各种功能将在以下章节中描述。

启动一个简单的服务器

当你打开Appium Desktop时，迎接你的是服务器启动窗口。基本选项是启动一个Appium服务器，它具有所有的默认功能，并能修改主机和端口。启动按钮也会让你知道你正在运行的Appium服务器的哪个版本，这在向Appium团队报告问题时可能很有用。

用高级选项启动一个服务器

通过点击 "高级 "标签，你可以设置Appium中所有可用的服务器标志。这是为高级用户准备的，只有在查阅Appium文档后才能修改。

服务器预置

如果你使用高级服务器选项，你有能力保存一个配置供以后使用。只需在 "高级 "选项卡上保存预设，随后你就可以在 "预设 "选项卡上用该配置调用和启动服务器。

服务器控制台输出窗口

一旦你启动服务器，它将在你指定的主机和端口上启动，并打开一个显示服务器日志输出的新窗口。

这是相当直接的，除了使用按钮来停止服务器之外，不可能有真正的互动。你也可以从这个窗口复制和粘贴日志，这对报告Appium问题很有用。

报告问题和请求功能

Appium Desktop是开源的，我们使用GitHub进行问题跟踪。请简单地在我们的问题追踪器上报告问题。我们将努力确定你所报告的问题是否与Appium Desktop或Appium Server有关。如果它与Appium Desktop无关，我们将关闭该问题，并请你在Appium的主要问题追踪器上开一个普通的Appium问题。请明确你遇到的问题是与Appium Desktop具体相关，还是一般的Appium问题，以节省你自己和我们的宝贵时间。你可以通过查看该问题是否也在Appium命令行服务器上重现来实现。如果是，请将您的报告提交给Appium的问题跟踪器。

有一个功能请求？按照同样的流程，向相应的跟踪器提交问题(如果是专门针对Appium Desktop的请求，可以在这个Repo中提交，如果是针对Appium的请求，则可以在Appium的主跟踪器中提交）。)

高级主题和故障排除

Appium无法检测Mac上的环境变量

Appium使用环境变量，如ANDROID_HOME ，以及依赖你的PATH 等各种二进制文件。当在你适当设置了这些变量的环境中从命令行运行时，Appium在接收这些变量方面没有问题。然而，Appium Desktop并不在shell或命令行环境中运行，因此默认情况下，它无法访问你在shell启动脚本或配置文件中设置的环境变量。为了解决这个问题，我们使用shell-env包来获取你shell中定义的环境变量。然而，这个包只在某些常见的启动脚本中寻找，如~/.bashrc ，~/.bash_profile ，和~/.zshrc 。如果你以其他方式设置你的Appium环境变量，你将需要创建这些默认的init脚本之一，并在那里设置你的环境变量，这样Appium Desktop就会成功接收它们。

关于在只读文件系统上的警告

这可能意味着你试图从下载的磁盘镜像（.dmg 文件）启动Appium Desktop。这不是运行Appium Desktop的支持模式。要正确安装Appium Desktop，请将磁盘镜像中的应用程序复制到你的本地文件系统中，如/Applications 。然后，从该新位置运行该应用程序。

开发者说明

想在Appium Desktop上黑一把？太棒了!请前往我们的贡献文件，了解如何设置开发环境并向项目提交修改意见的信息。