[ome-devel] OmeroBuild changes

[josh.moore at gmx.de]

Hi folks.

As many of you have perhaps (painfully) noticed, the build for the
omero server has been undergoing a reworking both for speed and
usability.

The reworked main targets from the source build are:

 build-all              Build everything and copy to ...
 build-blitz            Build blitz and copy to dist/...
 build-cpp              Build OmeroCpp bindings and  ...
 build-default          Build all components except f...
 build-ear              Build ear and copy to dist   ...
 build-importer         Build importer and copy to di...
 build-java             Build OmeroJava bindings and ...
 build-py               Build OmeroPy bindings and co...
 build-schema           Build new DB schema and copy ...
 build-webadmin         Build WebAdmin and copy to di...
 clean                  Calls 'clean' on all componen...
 javadoc                Generate Javadocs for all com...
 prepare-eclipse        Symlink (or copy) all lib/rep...
 quick                  Disable tests
 tar                    Tar the dist directory into $...
 zip                    Zip the dist directory into $...

Just running "ant" from the top-level should do "The Right Thing",
which was previously a wee bit longer:

  NOMAKE=1 java omero quick build dist withtools

Note: all the other top-level targets do not disable tests via "quick".


If you use "ant -p" at the top-level, you'll also see other targets,
like:

 build                  DEPRECATED: Use build-default...
 cleantools             DEPRECATED: Use clean        ...
 dist                   DEPRECATED: Use build-* targe...
 fullbuild              DEPRECATED: Use build-all...
 withtools              DEPRECATED: Use build-all or build-[COMPONENT]

which are defined in deprecated.xml and will eventually
disappear. They, however, allow the old, longer command to continue to
work if you so desire.

Any commands which you are missing (reload-db, deploy) have probably
moved to the dist/ directory since they are not about building the
product but with working with it. One caveat: reload-db is called
"setup-db" under dist/. A fun idiosyncrasy.

Further improvements will be coming to the dist/ build.xml during the
next milestones, possibly with a removal of the ant dependency.

Thanks for all the feedback from everyone. Suggestions and flames are
welcomed and encouraged as ever.

Best regards,
~Josh