Package com._1c.g5.v8.dt.platform.services.mobile

Interface IMobileClientLauncher<T extends IMobileDevice>

Type Parameters:

T - the mobile device implementation, that is specific for the mobile OS

All Superinterfaces:

IRuntimeComponentExecutor

public interface IMobileClientLauncher<T extends IMobileDevice>
extends IRuntimeComponentExecutor

1C:Enterprise runtime component executor for mobile client launching. Allows:

• Deploy mobile 1C:Enterprise client to the mobile device
• Run mobile client on the mobile device (optionally in debug mode)

Clients are intended to deploy 1C:Enterprise mobile client before application run. Clients may implement and register this type of the runtime executor component for each type of supported mobile OS.

Method Summary

Modifier and Type	Method	Description
void	deployClient(T device, IArchivedRuntimeComponent mobileClient, boolean reinstall, boolean isMobileStandalone, org.eclipse.core.runtime.IProgressMonitor monitor)	Deploys the 1C:Enterprise mobile client to the mobile device.
void	runClient(T device, URL url, RuntimeExecutionArguments arguments, org.eclipse.core.runtime.IProgressMonitor monitor)	Launches a mobile client on the mobile device based on the provided url and client arguments.

Methods inherited from interface com._1c.g5.v8.dt.platform.services.core.runtimes.execution.IRuntimeComponentExecutor

needComponent

Method Detail

deployClient

void deployClient(T device,
                  IArchivedRuntimeComponent mobileClient,
                  boolean reinstall,
                  boolean isMobileStandalone,
                  org.eclipse.core.runtime.IProgressMonitor monitor)
           throws MobileDeviceException

Deploys the 1C:Enterprise mobile client to the mobile device. Typical implementation flow is:

• Dearchive 1C:Enterprise mobile client component somewhere on the local drive to a temporary folder
• Deploy and install this 1C:Enterprise mobile client component on the mobile device
• Delete temporary folder

Parameters:

device - the mobile device to deploy mobile client component to, is intended to be already launched, cannot be null

mobileClient - mobile 1C:Enterprise client component, cannot be null

reinstall - whether need to reinstall 1C:Enterprise client mobile runtime, if already installed

isMobileStandalone - whether need to install 1C:Enterprise standalone client mobile runtime

monitor - the progress monitor to report progress to and check cancellation status, cannot be null

Throws:

MobileDeviceException - if an error occurred; possible reasons may include:

• Mobile device access error
• Mobile device is not launched

runClient

void runClient(T device,
               URL url,
               RuntimeExecutionArguments arguments,
               org.eclipse.core.runtime.IProgressMonitor monitor)
        throws MobileDeviceException

Launches a mobile client on the mobile device based on the provided url and client arguments.

Started mobile application can be auto attached to the target debug server and will be available as debuggable client in the debug server debugger (in DT IDE, for example) based on arguments parameters.

Mobile 1C:Enterprise runtime must be deployed before application run.

Parameters:

device - the mobile device to deploy mobile client component to, is intended to be already launched, cannot be null

url - the client URL to provide to client launch, cannot be null

arguments - the execution arguments, can be null, then will not be used

monitor - the progress monitor to report progress to and check cancellation status, cannot be null

Throws:

MobileDeviceException - if an error occurred; possible reasons may include:

• Mobile device access error
• Mobile device is not launched