Package org.robovm.compiler.target

Interface Target

All Known Implementing Classes:

AbstractTarget, ConsoleTarget, FrameworkTarget, IOSTarget

public interface Target

Builds and launches (if supported) a particular type of binary (e.g. iOS apps, dynamic libraries, etc).

Method Summary

Modifier and Type	Method	Description
void	archive()	Creates an archive suitable for distribution and stores it in the Config.getInstallDir() directory.
File	build(List<File> objectFiles)	Builds a binary out of the specified object files.
void	buildFat(Map<Arch,File> slices)	Builds a fat binary out of the specified slices.
boolean	canLaunch()	Returns true if binaries created by this Target can be launched, i.e.
boolean	canLaunchInPlace()	Returns true if binaries created by this Target can be launched in place and doesn't have to be copied into some folder structure, e.g.
LaunchParameters	createLaunchParameters()	Creates LaunchParameters for launching the binary built by this Target.
Arch	getArch()	Returns the Arch this Target will build for.
List<Arch>	getDefaultArchs()	Returns a list of the default archs to build for if no archs have been specified in the Config.
String	getInstallRelativeArchivePath(Path path)
OS	getOs()	Returns the OS this Target will build for.
String	getType()	Returns a unique type id for this Target.
void	init(Config config)	Initializes this Target from the specified Config.
void	install()	Installs the built binary and any supporting files into the Config.getInstallDir() directory.
Process	launch(LaunchParameters launchParameters)	Launches the built binary if supported.
void	prepareLaunch()	performs prepare launch activities

Method Details

getType

String getType()

Returns a unique type id for this Target.

getOs

OS getOs()

Returns the OS this Target will build for. This is determined by init(Config). If an explicit OS has been set on the Config in the call to init(Config) that OS will returned by this method. Otherwise init(Config) will determine a default OS and this method returns that one.

getArch

Arch getArch()

Returns the Arch this Target will build for. This is determined by init(Config). If an explicit Arch has been set on the Config in the call to init(Config) that Arch will returned by this method. Otherwise init(Config) will determine a default Arch and this method returns that one.

getDefaultArchs

List<Arch> getDefaultArchs()

Returns a list of the default archs to build for if no archs have been specified in the Config. Returns an empty list if there are no defaults.

getInstallRelativeArchivePath

String getInstallRelativeArchivePath(Path path)

canLaunch

boolean canLaunch()

Returns true if binaries created by this Target can be launched, i.e. it produces executable binaries.

canLaunchInPlace

boolean canLaunchInPlace()

Returns true if binaries created by this Target can be launched in place and doesn't have to be copied into some folder structure, e.g. an iOS app bundle.

prepareLaunch

void prepareLaunch()
            throws IOException

performs prepare launch activities

Throws:

IOException

build

File build(List<File> objectFiles)
    throws IOException

Builds a binary out of the specified object files.

Throws:

IOException

buildFat

void buildFat(Map<Arch,File> slices)
       throws IOException

Builds a fat binary out of the specified slices.

Throws:

IOException

install

void install()
      throws IOException

Installs the built binary and any supporting files into the Config.getInstallDir() directory.

Throws:

IOException

archive

void archive()
      throws IOException

Creates an archive suitable for distribution and stores it in the Config.getInstallDir() directory.

Throws:

IOException

launch

Process launch(LaunchParameters launchParameters)
        throws IOException

Launches the built binary if supported.

Throws:

UnsupportedOperationException - if binaries built by this Target cannot be launched.

IOException

createLaunchParameters

LaunchParameters createLaunchParameters()

Creates LaunchParameters for launching the binary built by this Target.

Throws:

UnsupportedOperationException - if binaries built by this Target cannot be launched.

init

void init(Config config)

Initializes this Target from the specified Config.