com.google.gwt.dev

Class CompileModule

java.lang.Object

com.google.gwt.dev.CompileModule

public class CompileModule
extends Object

Compiles a GWT module into a form that can be re-used by subsequent builds. Takes all compilation units specified on the module source path and write out CachedCompilationUnits for each one into a file named .gwtar (rhymes with the musical instrument). This will reduce compile and dev mode startup time if a .gwtar file is up to date and doesn't need to be re-built. Most developers using the GWT SDK won't need to invoke this tool to get performance improvements. The built-in PersistentUnitCache already saves compiled modules between builds. This tool is of use to library authors for bundling up a pre-compiled gwt library for distributions. Projects that include the library will never incur the penalty of recompiling the library. It can also be useful in a distributed or multi-process build environment, as separate instances of CompileModule could be invoked in parallel. CompileModule is meant to be used in conjunction with a build tool such as Apache Ant which can do gross level dependency checking of the inputs and compute the staleness of a .gwtar file. If the .gwtar file is up to date, the assumption is that this tool won't be invoked at all. If there are dependent modules that already have their own .gwtar files, they are assumed good and loaded first. CachedCompilationUnits that already exist will not be re-written into the .gwtar files. Note: Currently, the order the modules are passed in is the order in which they will be compiled. This means you should be careful to pass in modules that depend on other modules in the same list last. TODO(zundel): remove the manual ordering of dependencies.

Constructor Summary

Constructors

Constructor and Description
CompileModule(CompileModuleOptions options)

Method Summary

Modifier and Type	Method and Description
static void	main(String[] args)
boolean	run(TreeLogger logger) Main loop.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Constructor Detail

CompileModule

public CompileModule(CompileModuleOptions options)

Method Detail

main

public static void main(String[] args)

run

public boolean run(TreeLogger logger)

Main loop. For each module passed on the command line, populates the compilation state with compilation units from other archives, compiles all resources in this module, and writes out all the compilation units that are not already members of another archive into a new CompilationUnitArchive file.