io.appium.java_client.service.local

Class AppiumServiceBuilder

java.lang.Object

org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

io.appium.java_client.service.local.AppiumServiceBuilder

public final class AppiumServiceBuilder
extends org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

Field Summary

Fields

Modifier and Type	Field and Description
static String	APPIUM_PATH The environmental variable used to define the path to executable appium.js (1.4.x and lower) or main.js (1.5.x and higher)
static String	DEFAULT_LOCAL_IP_ADDRESS
static String	NODE_PATH The environmental variable used to define the path to executable NodeJS file (node.exe for WIN and node for Linux/MacOS X)

Constructor Summary

Constructors

Constructor and Description
AppiumServiceBuilder()

Method Summary

Methods

Modifier and Type	Method and Description
protected com.google.common.collect.ImmutableList<String>	createArgs()
protected AppiumDriverLocalService	createDriverService(File nodeJSExecutable, int nodeJSPort, com.google.common.collect.ImmutableList<String> nodeArguments, com.google.common.collect.ImmutableMap<String,String> nodeEnvironment)
protected void	finalize()
protected File	findDefaultExecutable()
AppiumServiceBuilder	usingAnyFreePort() Configures the appium server to start on any available port.
AppiumServiceBuilder	usingDriverExecutable(File nodeJSExecutable) Sets which Node.js the builder will use.
AppiumServiceBuilder	usingPort(int port) Sets which port the appium server should be started on.
AppiumServiceBuilder	withAppiumJS(File appiumJS)
AppiumServiceBuilder	withArgument(ServerArgument argument) Boolean arguments have a special moment: the presence of an arguments means "true".
AppiumServiceBuilder	withArgument(ServerArgument argument, String value)
AppiumServiceBuilder	withCapabilities(org.openqa.selenium.remote.DesiredCapabilities capabilities)
AppiumServiceBuilder	withEnvironment(Map<String,String> environment) Defines the environment for the launched appium server.
AppiumServiceBuilder	withIPAddress(String ipAddress)
AppiumServiceBuilder	withLogFile(File logFile) Configures the appium server to write log to the given file.
AppiumServiceBuilder	withStartUpTimeOut(long time, TimeUnit timeUnit)

Methods inherited from class org.openqa.selenium.remote.service.DriverService.Builder

build, getLogFile, getPort

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

APPIUM_PATH

public static final String APPIUM_PATH

The environmental variable used to define the path to executable appium.js (1.4.x and lower) or main.js (1.5.x and higher)

See Also:

Constant Field Values

NODE_PATH

public static final String NODE_PATH

The environmental variable used to define the path to executable NodeJS file (node.exe for WIN and node for Linux/MacOS X)

See Also:

Constant Field Values

DEFAULT_LOCAL_IP_ADDRESS

public static final String DEFAULT_LOCAL_IP_ADDRESS

See Also:

Constant Field Values

Constructor Detail

AppiumServiceBuilder

public AppiumServiceBuilder()

Method Detail

findDefaultExecutable

protected File findDefaultExecutable()

Specified by:

findDefaultExecutable in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

withArgument

public AppiumServiceBuilder withArgument(ServerArgument argument)

Boolean arguments have a special moment: the presence of an arguments means "true". This method was designed for these cases

Parameters:

argument - is an instance which contains the argument name

Returns:

the self-reference

withArgument

public AppiumServiceBuilder withArgument(ServerArgument argument,
                                String value)

Parameters:

argument - is an instance which contains the argument name

value - A non null string value. (Warn!!!) Boolean arguments have a special moment: the presence of an arguments means "true". At this case an empty string should be defined

Returns:

the self-reference

withCapabilities

public AppiumServiceBuilder withCapabilities(org.openqa.selenium.remote.DesiredCapabilities capabilities)

Parameters:

capabilities - is an instance of DesiredCapabilities

Returns:

the self-reference

withAppiumJS

public AppiumServiceBuilder withAppiumJS(File appiumJS)

Parameters:

appiumJS - an executable appium.js (1.4.x and lower) or main.js (1.5.x and higher)

Returns:

the self-reference

withIPAddress

public AppiumServiceBuilder withIPAddress(String ipAddress)

withStartUpTimeOut

public AppiumServiceBuilder withStartUpTimeOut(long time,
                                      TimeUnit timeUnit)

Parameters:

time - a time value for the service starting up

timeUnit - a time unit for the service starting up

Returns:

self-reference

createArgs

protected com.google.common.collect.ImmutableList<String> createArgs()

Specified by:

createArgs in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

usingDriverExecutable

public AppiumServiceBuilder usingDriverExecutable(File nodeJSExecutable)

Sets which Node.js the builder will use.

Overrides:

usingDriverExecutable in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

Parameters:

nodeJSExecutable - The executable Node.js to use.

Returns:

A self reference.

usingPort

public AppiumServiceBuilder usingPort(int port)

Sets which port the appium server should be started on. A value of 0 indicates that any free port may be used.

Overrides:

usingPort in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

Parameters:

port - The port to use; must be non-negative.

Returns:

A self reference.

usingAnyFreePort

public AppiumServiceBuilder usingAnyFreePort()

Configures the appium server to start on any available port.

Overrides:

usingAnyFreePort in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

Returns:

A self reference.

withEnvironment

public AppiumServiceBuilder withEnvironment(Map<String,String> environment)

Defines the environment for the launched appium server.

Overrides:

withEnvironment in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

Parameters:

environment - A map of the environment variables to launch the appium server with.

Returns:

A self reference.

withLogFile

public AppiumServiceBuilder withLogFile(File logFile)

Configures the appium server to write log to the given file.

Overrides:

withLogFile in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

Parameters:

logFile - A file to write log to.

Returns:

A self reference.

createDriverService

protected AppiumDriverLocalService createDriverService(File nodeJSExecutable,
                                           int nodeJSPort,
                                           com.google.common.collect.ImmutableList<String> nodeArguments,
                                           com.google.common.collect.ImmutableMap<String,String> nodeEnvironment)

Specified by:

createDriverService in class org.openqa.selenium.remote.service.DriverService.Builder<AppiumDriverLocalService,AppiumServiceBuilder>

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable