The Appium linkage function uses the UIAutomation2 interface provided by the Nexacro Platform 17 to read or write properties of apps running in Android NRE and to support method execution by specifying parameters. You can write unit tests and test using UI automation testing tools, such as Selenium.

In this chapter, we will look at the steps to install Appium, create a basic Java project in Visual Studio code, and connect it to the Nexacro Platform apps.

Configuring the Appium Linkage

Installing Appium & Checking the Terminal Connection

• USB debugging

• Install via USB

• USB debugging (Security settings)

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

In the image below, "0a388e93" is the serial number of the connected terminal.

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

When building the app, the Package Name is set to "nexacro" and the Program Name is set to"TEST0120".

In the Windows operating system environment, change the Host setting to "127.0.0.1".

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

Configuring the Test Project Execution & Testing

• 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();
	}
}

Creating & Running the Unit Test

Place the Button component at the top and the Edit component below it.

Write the onclick event handler function of the Button component as follows.

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);
	}
}

Supported Interfaces