appium官网中文资料

https://github.com/appium/appium/tree/master/docs/cn

https://github.com/appium/appium/tree/master/docs/cn

• 
  

758

5,509

• 2,672

appium/appium

Code Issues 739 Pull requests 5 Projects 1

appium / docs / cn /

Latest commit 8f78c2e on 12 Apr dpgraham committed with jlipps Remove name strategy from documentation ( #8230 )

	..
	about-appium	Doc Tweaks	a year ago
	advanced-concepts	add the latest chinese translation	2 years ago
	appium-setup	Fixing broken link for UiAutomation	2 years ago
	contributing-to-appium	add the latest chinese translation	2 years ago
	writing-running-appium	Remove name strategy from documentation (#8230)	3 months ago
	README.md	Doc tweaks	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 ?

1. 因为 Appium 在所有平台上都使用了标准的自动化接口，所以你不需要以重新编译或者修改你的 app。
2. 你可以用你喜欢的开发工具，使用任何 WebDriver 兼容的语言来编写测试用例。比如Java， Objective-C，JavaScript with Node.js (in both callback and yield-based flavours)，PHP， Python， Ruby， C#， Clojure， 或者 Perl。可以使用标准的Selenium WebDriver API和特定语言的客户端库。
3. 你可以使用任何测试框架。

投资 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，确保你是按照如下文档的指示来配置不同的测试环境的。
  • linux
  • osx
  • windows

FirefoxOS 需求

• Firefox OS Simulator

快速开始

启动 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以了解如何从源代码中进行编译，测试和运行

其他项目的授权和灵感来源

Credits

邮件列表

声明和公告经常放到讨论组 Discussion Group， 需要注册

问题定位

我们增加了一个 问题定位指南。如果你遇到一些问题，请看下这个问的那个。它包含了一些常见的错误说明，以及在无法解决的情况如何和社区联系。

使用Robots扩展

可以使用 appium 的一些 robots 扩展。或者其他的 robots。想了解更多可以看看 Appium Robots

翻译工作

文档翻译工作由testerhome在推动， 我们会不断补充更多的文档和测试用例.欢迎对 Appium 感兴趣的同学加入我们， 为开源社区贡献中国人的力量.