appium / appium-desktop

語言: CN / TW / HK

Appium Desktop

Build StatusCrowdin

Action screenshot

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應用中的元素的工具。它的各種功能將在以下章節中描述。

啟動一個簡單的伺服器

Start a basic server

當你開啟Appium Desktop時,迎接你的是伺服器啟動視窗。基本選項是啟動一個Appium伺服器,它具有所有的預設功能,並能修改主機和埠。啟動按鈕也會讓你知道你正在執行的Appium伺服器的哪個版本,這在向Appium團隊報告問題時可能很有用。

用高階選項啟動一個伺服器

Start an advanced server

通過點選 "高階 "標籤,你可以設定Appium中所有可用的伺服器標誌。這是為高階使用者準備的,只有在查閱Appium文件後才能修改。

伺服器預置

Server presets

如果你使用高階伺服器選項,你有能力儲存一個配置供以後使用。只需在 "高階 "選項卡上儲存預設,隨後你就可以在 "預設 "選項卡上用該配置呼叫和啟動伺服器。

伺服器控制檯輸出視窗

一旦你啟動伺服器,它將在你指定的主機和埠上啟動,並開啟一個顯示伺服器日誌輸出的新視窗。

Server console

這是相當直接的,除了使用按鈕來停止伺服器之外,不可能有真正的互動。你也可以從這個視窗複製和貼上日誌,這對報告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上黑一把?太棒了!請前往我們的貢獻檔案,瞭解如何設定開發環境並向專案提交修改意見的資訊。