Appium系列|创建项目

一、创建项目

点击Create New Project就可以进行项目的创建

Appium官方有示例是通过maven来进行项目构建的，所以我们可以选择创建Maven类型的项目。

选择窗口左侧的Maven选项，表明接着要创建Maven类型的项目，IDE会自动创建这种类型项目所需的一切，如pom.xml文件等，如下所示：

第一次使用IntelliJ IDEA需要设置下jdk的路径，点击上图右侧的New按钮，然后找到jdk的安装目录，比如我的安装路径为："C:\Program Files\Java\jdk1.8.0_131"，就选择该目录即可，设置完如下所示：

接着需要设置下GroupId和ArtifactId，如下所示

接着设置下项目名以及存放路径，完成项目创建

二、Appium依赖添加

Appium Server已经安装完毕，接着需要借助Maven自动化去下载Appium的客户端依赖。

打开项目里的pom.xml文件，这个文件主要用来声明依赖用的，我们在这里声明需要用到的依赖，到时候IDE就会自动根据配置的声明下载对应的依赖。这里我们需要用到Appium，所以需要声明Appium的依赖，同时需要用到单元测试框架，也需要声明对应的依赖，这里单元测试框架选择TestNG，当然选择JUnit也是可以的。

声明如下：

 <dependencies>
        <dependency>
            <groupId>org.testng</groupId>
            <artifactId>testng</artifactId>
            <version>6.9.10</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>io.appium</groupId>
            <artifactId>java-client</artifactId>
            <version>5.0.3</version>
        </dependency>

    </dependencies>

建议大家testng和java-client的版本和我报纸一致，因为后续要介绍一些报告展示的常见对版本是有要求的，不同的版本可能需要的依赖版本也会不一样，为了避免后续出现意想不到的错误，最后跟本书使用的版本保持一致。

在pom.xml文件边上会出现如下的选择，选择Enable Auto-Import，这样就会自动导入需要的依赖，如下所示

等依赖都下载完成后就可以来编写具体的测试脚本了。

三、脚本执行

在编写具体脚本之前先来介绍下被测试的应用，这本书我们会使用开源中国这个APP来作为被测试的对象。这个 应用的APK可以从开源中国的网站上获取得到。但最新的版本有的模拟器镜像不支持安装，如果你使用的是真实的手机来执行脚本就不会有这个问题，为了演示方便本书直接获取开源中国的源码编译了一个支持模拟器安装的版本，可以通过如下的github链接获取到：

https://github.com/if1else0/appium_pratice/raw/master/AUT/osc.apk

有了安装文件后，可以将这个apk安装到模拟器上，如果有手机直接安装到手机也可以（需要在电脑上安装好驱动并打开usb调试模式）。现在来简单介绍下如何通过Android Studio去创建一个模拟器并启动它。

打开Android Studio，第一次使用的时候可以先创建个Android 工程，具体步骤如下所示：

创建完项目后就可以点击菜单栏的这个图片进行模拟器的创建了，如下图所示：

点击完后，可以看到如下的界面

点击“Create Virtual Device”就可以进行模拟器的创建，在如下的界面中选择你要创建的模拟器的手机型号，如Nexus 5

接着需要选择模拟器的镜像，如果要启动硬件加速就得选择x86的CPU架构，不能选择ARM的CPU架构。之前如果没有下载过镜像的话，要先进行下载，如下所示：

点击上图的Download后，会进入如下的界面，勾选"Accept"，选择Next进行安装即可

下载完后，就可以选择该镜像进行模拟器的创建了。

创建完模拟器后，可以通过点击绿色的启动图片，进行模拟器的启动，如下所示

模拟器启动完的界面如下：

模拟器启动完后就可以创建项目的基本结构了。

我们可以在项目的根目录下创建一个文件夹，给这个文件夹任意命名下如AUT，专门来存放被测试的apk的文件夹。

然后将上面提到的github里下载得到的apk放到这个文件夹下。

src/test下主要用来存放测试脚本，所以我们可以在这底下去创建我们的测试脚本。

可以在src/test/java下新建一个包如appium.chapter1用来存放第一章节的测试代码。创建完后的项目结构如下所示：

接着在这个包下新建一个Java类，命名为HelloWorld，然后在这个新建的类里面，鼠标右击选择“Generate”，然后依次选择“SetUp Method”、“Test Method”、"TearDown Method"，让IDE依次帮忙生成这三部分的代码。在依次选择的时候IDE会提示里要使用的JUnit4或者TestNG，因为我们要使用的是TestNG单元测试框架，所以这里都选择TestNG即可。

这这个测试类里首先需要声明一个AppiumDriver的对象引用，然后在setUp方法里给这个对象引用进行实例化。实例化的构造参数里需要一个DesiredCapabilities的对象应用，所以还得在setUp方法里声明和设置DesiredCapabilities对象引用的值，也是通过这些值的设置来告诉Appium Server你要操作的设备以及测试对象的相关信息。具体编写完的测试代码如下：

package appium.chapter1;

import io.appium.java_client.AppiumDriver;
import io.appium.java_client.android.AndroidDriver;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.DesiredCapabilities;
import org.testng.annotations.AfterMethod;
import org.testng.annotations.BeforeMethod;
import org.testng.annotations.Test;

import java.io.File;
import java.net.URL;

public class HelloWorld {
    private AppiumDriver<WebElement> driver;

    @BeforeMethod
    public void setUp() throws Exception {
        //构造被测试应用的路径
        File app = new File(System.getProperty("user.dir"), "AUT/osc.apk");
        //实例化DesiredCapabilities
        DesiredCapabilities capabilities = new DesiredCapabilities();
        //deviceName的值可以任意指定
        capabilities.setCapability("deviceName","My Device");
        //设置被测应用的绝对路径
        capabilities.setCapability("app", app.getAbsolutePath());
        capabilities.setCapability("appPackage","net.oschina.app");
        //设置启动类的信息，这个信息可以通过aapt dump bading apkname来获得
        capabilities.setCapability("appActivity", ".AppStart");
        //初始化AppiumDriver
        driver = new AndroidDriver<WebElement>(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);
    }

    @Test
    public void testName() throws Exception {
        Thread.sleep(5000);
    }

    @AfterMethod
    public void tearDown() throws Exception {
        driver.quit();
    }
}

其中appActivity的值可以通过执行命令aapt dumpg badging apk名得到。如果我被测试apk文件放在桌面，然后文件名是osc.apk，就可以在命令行下进入到桌面然后执行如下命令获得启动类的值：

aapt dump badging osc.apk

如下图所示：

现在可以启动Appium Desktop，设置下主机地址为127.0.0.1，端口号为4723，如下：

然后点击下Start Server的按钮，就可以启动Appium Server了。现在可以选择这个测试类，鼠标右键选择Run HelloWorld，如果开源中国可以被成功启动，说明这个脚本可以正常工作了。

至此我们已经编写了第一个测试脚本，这个脚本主要用来把被测试应用启动后起来，并没有做其他操作，如何对应用进行操作我们会在后面章节进行详细讲解。