Appium 연동 기능은 넥사크로플랫폼 17에서 제공하는 UIAutomation2 인터페이스를 사용해 Android NRE에서 실행하는 앱의 속성을 읽거나 쓰고 파라미터를 지정해 메소드를 실행하는 것을 지원합니다. 셀레니움 같은 UI 자동화 테스트 도구를 사용해 단위 테스트를 작성하고 테스트할 수 있습니다.

이번 장에서는 Appium를 설치하고 비주얼 스튜디오 코드에서 기본적인 Java 프로젝트를 생성해 넥사크로플랫폼 앱에 연결하는 단계를 살펴봅니다.

Appium 연동 환경 설정하기

Appium 설치하고 단말기 연결 확인하기

• USB debugging

• Install via USB

• USB debugging (Security settings)

https://github.com/appium/appium-desktop/releases/latest

아래에서는 "0a388e93"이 연결된 단말기 일련번호입니다.

$ adb devices
List of devices attached
0a388e93      device usb:1-1 product:razor model:Nexus_7 device:flo

앱 빌드 시 Package Name은 "nexacro", Program Name은 "TEST0120"으로 설정했습니다.

윈도우 운영체제 환경이라면 Host 설정을 "127.0.0.1"로 변경합니다.

{
  "platformName": "Android",
  "platformVersion": "10",
  "appPackage": "nexacro.TEST0120",
  "appActivity": ".MainActivity",
  "automationName": "UIAutomator2",
  "autoGrantPermissions": "true",
  "deviceName": "0a388e93"
}

테스트 프로젝트 실행 환경 설정하고 테스트하기

• client-combined-3.141.59.jar (https://www.selenium.dev/downloads/)

  • byte-buddy-1.8.15.jar

  • commons-exec-1.3.jar

  • guava-25.0-jre.jar

  • okhttp-3.11.0.jar

  • okio-1.14.0.jar

• testng-7.3.0.jar (https://testng.org/doc/download.html)

  • jcommander-1.78.jar

• java-client-7.4.1.jar (https://github.com/appium/java-client)

• commons-lang3-3.11.jar (https://commons.apache.org/proper/commons-lang/)

package tests;

import java.net.MalformedURLException;
import java.net.URL;

import org.openqa.selenium.remote.DesiredCapabilities;
import org.testng.annotations.AfterTest;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.Test;

import io.appium.java_client.MobileElement;
import io.appium.java_client.android.AndroidDriver;

public class BaseClass {
	AndroidDriver<MobileElement> driver;
	final String URL_STRING = "http://127.0.0.1:4723/wd/hub";

	@BeforeTest
	public void setup() {
		System.out.println("setup");
		DesiredCapabilities capabilities = new DesiredCapabilities();
		capabilities.setCapability("automationName", "UiAutomator2");
		capabilities.setCapability("platformName", "Android");

		capabilities.setCapability("platformVersion", "10");
		capabilities.setCapability("deviceName", "0a388e93");
		capabilities.setCapability("autoGrantPermissions", "true");

		capabilities.setCapability("appPackage", "nexacro.TEST0120");
		capabilities.setCapability("appActivity", ".MainActivity");

		try {
			driver = new AndroidDriver<MobileElement>(new URL(URL_STRING), capabilities);
		} catch (MalformedURLException e) {
			System.out.println("MalformedURLException");
			e.printStackTrace();
		} catch (Exception e) {
			System.out.println("Exception");
			e.printStackTrace();
		}
	}

	@Test
	public void sampleTest() {
		System.out.println("sampleTest");
	}

	@AfterTest
	public void teardown() {
		System.out.println("teardown");
		driver.close();
	}
}

단위 테스트 만들고 실행하기

상단에 Button 컴포넌트를 배치하고 그 아래에 Edit 컴포넌트를 배치합니다.

Button 컴포넌트의 onclick 이벤트 핸들러 함수를 아래와 같이 작성합니다.

this.Button00_onclick = function(obj:nexacro.Button,e:nexacro.ClickEventInfo)
{
	this.Edit00.set_value("BUTTON CLICK");
};

package tests;

import java.net.MalformedURLException;
import java.util.concurrent.TimeUnit;

import org.testng.annotations.Test;

public class Tests extends BaseClass {

	@Test
	public void testOne() throws MalformedURLException, InterruptedException {
		System.out.println("testOne");
		int nTestSpeed = 2000;

		driver.manage().timeouts().implicitlyWait(15, TimeUnit.SECONDS);
		driver.findElementById("mainframe.WorkFrame.form.Button00").click();
		Thread.sleep(nTestSpeed);
	}
}

지원 인터페이스