https://github.com/appium/appium/tree/master/docs/cn
https://github.com/appium/appium/tree/master/docs/cn
| .. | |||
| about-appium | a year ago | ||
| advanced-concepts | 2 years ago | ||
| appium-setup | 2 years ago | ||
| contributing-to-appium | 2 years ago | ||
| writing-running-appium | 3 months ago | ||
| README.md | a year ago |
README.md
Appium
Appium 是一個開源的，跨平臺的自動化測試工具。它支持模擬器（iOS，FirefoxOS，Android）和真機（iOS， Android， FirefoxOS）上的原生應用，混合應用和移動 web 應用。
Note: 我們最近發佈了Appium 1.0。如果已有 Appium 測試腳本，你可以參考這個文件遷移到 1.0！
支持平臺
- iOS
- Android
- FirefoxOS
詳細請參見文檔網站
爲什麼選擇appium ?
- 因爲 Appium 在所有平臺上都使用了標準的自動化接口，所以你不需要以重新編譯或者修改你的 app。
- 你可以用你喜歡的開發工具，使用任何 WebDriver 兼容的語言來編寫測試用例。比如Java， Objective-C，JavaScript with Node.js (in both callback and yield-based flavours)，PHP， Python， Ruby， C#， Clojure， 或者 Perl。可以使用標準的Selenium WebDriver API和特定語言的客戶端庫。
- 你可以使用任何測試框架。
投資 WebDriver 意味着你可以押寶在一個已經成爲標準的獨立，自由和開放的協議。你不會被任何專利限制。
如果沒有 Appium，你就只能用 Javascript 來寫 Apple 的 UIAutomation 腳本，並且只能通過Instruments 應用來運行你的測試。同樣的，在 Google 的UiAutomator體系下，你只能用 Java 寫你的測試案例。Appium 最終開啓了跨平臺原生移動自動化的可能。
我還是不太明白……
如果你第一次接觸 Appium 或者想要一個完整的描述，請通讀我們的 Introduction to Appium Concepts。
依賴
爲了運行測試，針對不同的移動平臺，你需要配置下環境，下面列出相關的依賴平臺的需求。
如果你想通過 npm install 安裝的 appium 來運行 Appium 或者研究 Appium 或者爲 Appium 貢獻力量。你需要安裝
node.js 和 npm 0.10 或者更高版本 (使用
n或者brew install node來安裝 Nodejs，確保安裝過程中，你沒有使用任何 sudo，否則你會遇到很多問題)。我們推薦最新的穩定版本。
你可以使用 appium-doctor 來驗證 Appium 的所有依賴。運行 appium-doctor，然後提供
--ios 或者 --android 參數來驗證兩個平臺的依賴是否配置正確。如果從源代碼運行，你可以使用
bin/appium-doctor.js 或者 node bin/appium-doctor.js
iOS 需求
- Mac OS X 10.7 或者更高，推薦 10.9.2
- XCode >= 4.6.3，推薦 5.1.1
- Apple Developer Tools (iPhone simulator SDK， command line tools)
- 確保你已經讀了我們寫的如何配置 iOS 測試環境的文檔
Android 需求
- Android SDK API >= 17 (額外的特性需要 18/19）
- Appium 支持OS X，Linux，Windows 上的 Android，確保你是按照如下文檔的指示來配置不同的測試環境的。
FirefoxOS 需求
快速開始
啓動 Appium server，並運行用你喜歡的 WebDriver 兼容的語言編寫的測試用例。你可以用 node.js 或者下面的應用程序來運行 Appium
使用 Node.js
$ npm install -g appium
$ appium &
使用 app
- 下載 Appium app
- 運行它！
爲Appium編寫測試
如何開始寫測試用例，運行測試用例，可以看the running tests，這個文檔描述了iOS，Android 和老版本的 Android 機器的情況。如果你想在實體機上運行測試的話，你可能會對真機指南感興趣。
我們支持 Selenium WebDriver JSON Wire Protocol 的一個子集，而且在此之上擴展了移動平臺相關的特性。所以你可以指定特定移動平臺desired capabilities 來運行你的測試。
你可以通過 WebDriver 元素定位策略的子集來定位元素。更多信息請參考 finding elements爲了支持移動手勢automating mobile gestures，比如tap，flick 和 swipe，我們擴展了JSON Wire Protocolor。
你也可以對混合應用中的webview進行自動化 hybrid app guide
該代碼庫有 很多不同語言的測試例子！
工作原理
Appium 可以驅動多種原生自動化框架，同時也提供基於 Selenium 的 WebDriver JSON wire protocol api。
基於Dan Cuellar's 在 iOS 自動化上的成果，Appium 通過驅動 Apple 的 UIAutomation 庫來提供 iOS 支持。
而在新版本的 Android 上，我們使用 Uiautomator 框架，老版本的 Android，則使用了Selendroid
FirefoxOS 的支持依賴一個基於 Gecko 平臺並且兼容 WebDriver 的自動化驅動Marionette。
如何貢獻代碼
可以看下我們的文檔 contribution documentation以瞭解如何從源代碼中進行編譯，測試和運行
其他項目的授權和靈感來源
郵件列表
聲明和公告經常放到討論組 Discussion Group， 需要註冊
問題定位
我們增加了一個 問題定位指南。如果你遇到一些問題，請看下這個問的那個。它包含了一些常見的錯誤說明，以及在無法解決的情況如何和社區聯繫。
使用Robots擴展
可以使用 appium 的一些 robots 擴展。或者其他的 robots。想了解更多可以看看 Appium Robots
翻譯工作
文檔翻譯工作由testerhome在推動， 我們會不斷補充更多的文檔和測試用例.歡迎對 Appium 感興趣的同學加入我們， 爲開源社區貢獻中國人的力量.