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 |
Appium 是一个开源的,跨平台的自动化测试工具。它支持模拟器(iOS,FirefoxOS,Android)和真机(iOS, Android, FirefoxOS)上的原生应用,混合应用和移动 web 应用。
Note: 我们最近发布了Appium 1.0。如果已有 Appium 测试脚本,你可以参考这个文件迁移到 1.0!
投资 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
启动 Appium server,并运行用你喜欢的 WebDriver 兼容的语言编写的测试用例。你可以用 node.js 或者下面的应用程序来运行 Appium
$ npm install -g appium
$ 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以了解如何从源代码中进行编译,测试和运行
Credits
声明和公告经常放到讨论组 Discussion Group, 需要注册
我们增加了一个 问题定位指南。如果你遇到一些问题,请看下这个问的那个。它包含了一些常见的错误说明,以及在无法解决的情况如何和社区联系。
可以使用 appium 的一些 robots 扩展。或者其他的 robots。想了解更多可以看看 Appium Robots
文档翻译工作由testerhome在推动, 我们会不断补充更多的文档和测试用例.欢迎对 Appium 感兴趣的同学加入我们, 为开源社区贡献中国人的力量.