Details
Description
We need to augment the existing ICEfaces 2 Ant build to add targets to generate the actual release bundles, both bin and src.
As a reference, the recipe for creating the release bundles for Alpha 3 was as follows:
1. Make sure the icefaces/ReadMe.html file is updated for the release.
2. Make sure svn/ossrepo/icefaces/scratchpads/glimmer/core/build.properties is updated with the correct version info.
3. Lay a tag (svn copy) on scratchpads/glimmer for the release.
4. SVN export files from ossrepo/icefaces/tags that corresponds to the release.
5. Rename top-level "glimmer" directory to "icefaces"
6. Copy exported files into 3 bundle folders:
- icefaces-2.0.0-alpha3-src
- icefaces-2.0.0-alpha3-bin
icefaces-2.0.0-alpha3-bin
1. in icefaces dir do "ant allclean"
2. do "ant world"
3. in icefaces/core do "ant javadoc"
- Move the resulting /icefaces/core/build/javadocs dir to out of the bin bundle to be uploaded to the Wiki/.org docs site.
4. Delete the icefaces/build.xml, build.properties files
5. Under compat dir:
- in compat/core, do 'ant javadoc'
- Copy the ICEfaces 1.8.2 Component javadocs (api and TLD) out of the bin folders to be uploaded to the wiki/.org doc site. (TLD - use 1.8.2)
- Delete the build.xml file, component-metadata, components, and core directories
- Delete the following files from the /compat/lib dir:
- freemarker-2.3.14.jar (build only)
- jsf-metadata-resources-*.jar (build only)
- jsf-metadata.jar (build only)
- jsp-api-2.1.jar (not req. for Tomcat 6 or GF 3)
- portlet.jar (build only)
- Delete the compat/samples/auctionMonitor/web/WEB-INF/lib and /WEB-INF/classes dirs.
- Delete the compat/samples/component-showcase/web/WEB-INF/lib and /WEB-INF/classes dirs.
- Delete the compat/samples/compat-basic sample dir.
7. Delete the icefaces/core and icefaces/test directories.
8. In the icefaces/lib dir, delete the following files:
- mojarra-2.0.1-FCS-source.zip
- icefaces-compat.jar (in compat/lib already)
- junit-4.5.jar
- portlet2-api.jar
- commons-fileupload.jar
9. In the icefaces/samples dir:
- Delete the "basic" dir (not a great user sample and has fatal failures with JSF 2.0.2).
- Delete the "test" dir (internal testing use only).
- Delete the /auction/build/classes dir.
- Delete the /auction/build/dist/exploded dir.
icefaces-2.0.0-alpha3-src
1. In the icefaces/lib dir delete the following files:
- mojarra-2.0.1-FCS-source.zip
- commons-fileupload.jar
2. In the icefaces/samples dir:
- Delete the "basic" dir (not a great user sample and has fatal failures with JSF 2.0.2).
- Delete the "test" dir (internal testing use only).
3. Delete the icefaces/test dir.
As a reference, the recipe for creating the release bundles for Alpha 3 was as follows:
1. Make sure the icefaces/ReadMe.html file is updated for the release.
2. Make sure svn/ossrepo/icefaces/scratchpads/glimmer/core/build.properties is updated with the correct version info.
3. Lay a tag (svn copy) on scratchpads/glimmer for the release.
4. SVN export files from ossrepo/icefaces/tags that corresponds to the release.
5. Rename top-level "glimmer" directory to "icefaces"
6. Copy exported files into 3 bundle folders:
- icefaces-2.0.0-alpha3-src
- icefaces-2.0.0-alpha3-bin
icefaces-2.0.0-alpha3-bin
1. in icefaces dir do "ant allclean"
2. do "ant world"
3. in icefaces/core do "ant javadoc"
- Move the resulting /icefaces/core/build/javadocs dir to out of the bin bundle to be uploaded to the Wiki/.org docs site.
4. Delete the icefaces/build.xml, build.properties files
5. Under compat dir:
- in compat/core, do 'ant javadoc'
- Copy the ICEfaces 1.8.2 Component javadocs (api and TLD) out of the bin folders to be uploaded to the wiki/.org doc site. (TLD - use 1.8.2)
- Delete the build.xml file, component-metadata, components, and core directories
- Delete the following files from the /compat/lib dir:
- freemarker-2.3.14.jar (build only)
- jsf-metadata-resources-*.jar (build only)
- jsf-metadata.jar (build only)
- jsp-api-2.1.jar (not req. for Tomcat 6 or GF 3)
- portlet.jar (build only)
- Delete the compat/samples/auctionMonitor/web/WEB-INF/lib and /WEB-INF/classes dirs.
- Delete the compat/samples/component-showcase/web/WEB-INF/lib and /WEB-INF/classes dirs.
- Delete the compat/samples/compat-basic sample dir.
7. Delete the icefaces/core and icefaces/test directories.
8. In the icefaces/lib dir, delete the following files:
- mojarra-2.0.1-FCS-source.zip
- icefaces-compat.jar (in compat/lib already)
- junit-4.5.jar
- portlet2-api.jar
- commons-fileupload.jar
9. In the icefaces/samples dir:
- Delete the "basic" dir (not a great user sample and has fatal failures with JSF 2.0.2).
- Delete the "test" dir (internal testing use only).
- Delete the /auction/build/classes dir.
- Delete the /auction/build/dist/exploded dir.
icefaces-2.0.0-alpha3-src
1. In the icefaces/lib dir delete the following files:
- mojarra-2.0.1-FCS-source.zip
- commons-fileupload.jar
2. In the icefaces/samples dir:
- Delete the "basic" dir (not a great user sample and has fatal failures with JSF 2.0.2).
- Delete the "test" dir (internal testing use only).
3. Delete the icefaces/test dir.
The top-level build.xml and build.properties files have beenHere is a first cut the new instructions:
Preparation for running the new bundle targets currently remains mostly the same:
1. Make sure the icefaces/ReadMe.html file is updated for the release.
2. Make sure svn/ossrepo/icefaces/scratchpads/glimmer/core/build.properties is updated with the correct version info.
3. Lay a tag (svn copy) on scratchpads/glimmer for the release.
4. SVN export files from ossrepo/icefaces/tags that corresponds to the release. The "rename" can be done as part of the export (although renaming is no longer strictly necessary).
e.g.
svn export http://server.ice:8888/ossrepo/icefaces/scratchpads/glimmer icefaces2
5. After exporting, from the newly exported directory, adjust icefaces2/build.properties file to reflect the proper bundle name:
bundle.name=icefaces-2.0.0-beta1
6. From the icefaces2 directory, execute:
ant bundle.clean bundle
The result should be a bundle directory at the same level as the icefaces2 directory which contains both the binary and source directories with all the noted adjustments made as well zipped versions of the same.