Package org.robovm.libimobiledevice

Class InstallationProxyClient

java.lang.Object

org.robovm.libimobiledevice.InstallationProxyClient

All Implemented Interfaces:

java.lang.AutoCloseable

public class InstallationProxyClient
extends java.lang.Object
implements java.lang.AutoCloseable

Manages applications on a device.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	InstallationProxyClient.Options	Options used passed to the various InstallationProxyClient methods.
static interface	InstallationProxyClient.StatusCallback	Callback which receives status information on an ongoing operation.

Field Summary

Fields

Modifier and Type	Field	Description
protected InstproxyClientRef	ref
static java.lang.String	SERVICE_NAME

Constructor Summary

Constructors

Constructor	Description
InstallationProxyClient(IDevice device, LockdowndServiceDescriptor service)	Creates a new InstallationProxyClient and makes a connection to the com.apple.mobile.installation_proxy service on the device.

Method Summary

Modifier and Type	Method	Description
com.dd.plist.NSArray	browse()	Lists all installed applications.
com.dd.plist.NSArray	browse(InstallationProxyClient.Options.ApplicationType type)	Lists installed applications of the specified type.
protected void	checkDisposed()
void	close()
void	dispose()
protected InstproxyClientRef	getRef()
void	install(java.lang.String pkgPath, InstallationProxyClient.Options options, InstallationProxyClient.StatusCallback callback)	Installs an application on the device.
static void	main(java.lang.String[] args)
void	upgrade(java.lang.String pkgPath, InstallationProxyClient.Options options, InstallationProxyClient.StatusCallback callback)	Upgrade an application on the device.

Methods inherited from class java.lang.Object

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

Field Details

SERVICE_NAME

public static final java.lang.String SERVICE_NAME

See Also:

Constant Field Values

ref

protected InstproxyClientRef ref

Constructor Details

InstallationProxyClient

public InstallationProxyClient(IDevice device,
LockdowndServiceDescriptor service)

Creates a new InstallationProxyClient and makes a connection to the com.apple.mobile.installation_proxy service on the device.

Parameters:

device - the device to connect to.

service - the service descriptor returned by LockdowndClient.startService(String).

Method Details

browse

public com.dd.plist.NSArray browse()
                            throws java.io.IOException

Lists all installed applications.

Returns:

an NSArray of NSDictionarys holding information about the installed applications.

Throws:

java.io.IOException

browse

public com.dd.plist.NSArray browse(InstallationProxyClient.Options.ApplicationType type)
                            throws java.io.IOException

Lists installed applications of the specified type.

Parameters:

type - the type of applications to list. Either InstallationProxyClient.Options.ApplicationType.User or InstallationProxyClient.Options.ApplicationType.System applications. Pass null to list all.

Returns:

an NSArray of NSDictionarys holding information about the installed applications.

Throws:

java.io.IOException

install

public void install(java.lang.String pkgPath,
InstallationProxyClient.Options options,
InstallationProxyClient.StatusCallback callback)
             throws java.io.IOException

Installs an application on the device.

Parameters:

pkgPath - path of the installation package or app bundle dir inside the AFC jail.

options - the client options to use or null. Recognized options are InstallationProxyClient.Options.iTunesMetadata(NSObject), InstallationProxyClient.Options.applicationSINF(NSObject) and InstallationProxyClient.Options.packageType(PackageType). If PackageType is InstallationProxyClient.Options.PackageType.Developer then pkgPath points to an app bundle (.app directory) instead of an install package.

callback - callback which will be called for progress and status information. If null is passed, this function will run synchronously.

Throws:

java.io.IOException

upgrade

public void upgrade(java.lang.String pkgPath,
InstallationProxyClient.Options options,
InstallationProxyClient.StatusCallback callback)
             throws java.io.IOException

Upgrade an application on the device. This function is nearly the same as install(String, Options, StatusCallback); the difference is that the installation progress on the device is faster if the application is already installed.

Parameters:

pkgPath - path of the installation package or app bundle dir inside the AFC jail.

options - the client options to use or null. Recognized options are InstallationProxyClient.Options.iTunesMetadata(NSObject), InstallationProxyClient.Options.applicationSINF(NSObject) and InstallationProxyClient.Options.packageType(PackageType). If PackageType is InstallationProxyClient.Options.PackageType.Developer then pkgPath points to an app bundle (.app directory) instead of an install package.

callback - callback which will be called for progress and status information. If null is passed, this function will run synchronously.

Throws:

java.io.IOException

getRef

protected InstproxyClientRef getRef()

checkDisposed

protected final void checkDisposed()

dispose

public void dispose()

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Throws:

java.lang.Exception