Notes on the MyFaces Build Tools Builder Plugin 1.0.3 Release

Release manager: Leonardo Uribe

Timeline

  • Proposed release date: 2009-05-22

Issues

  • This release is necessary for release myfaces archetypes, update trinidad-sandbox to use myfaces-builder-plugin.

Testing

Here's how you can help us test the distribution.

Add this to your pom.xml (a node inside <project> )

  <pluginRepositories>
    <pluginRepository>
        <id>test-builder-plugin-1.0.3</id>
        <name>Test repository for myfaces-builder-plugin 1.0.3</name>
        <url>http://people.apache.org/~lu4242/m2-plugins-103</url>
    </pluginRepository>
  </pluginRepositories>  

then use myfaces-builder-plugin:

    <plugins>
      <plugin>
        <groupId>org.apache.myfaces.buildtools</groupId>
        <artifactId>myfaces-builder-plugin</artifactId>
        <version>1.0.3</version>
        ..... some stuff ....
      </plugin>
    <plugins>

myfaces core 1.1.x, 1.2.x and tomahawk use myfaces-builder-plugin so the most easy way is modify its pom (api/pom.xml, impl/pom.xml for example) for use it, then mvn install and check the generated artifacts.

Tasks

Proposed Release Announcement

}}}

== Diary ==
<<Anchor(diary)>>

1. Preparing myfaces-plugin-parent 1.0.3

    * Trying to prepare SUCCESS!.
{{{
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="lu4242_m2_plugins_103_release/myfaces-plugin-parent" -DdryRun=true
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="lu4242_m2_plugins_103_release/myfaces-plugin-parent" -Dresume=false
  • Rollback but do not remove branch files, for restore myfaces-plugin-parent to 1.0.3-SNAPSHOT (later this will be changed manually)
  • Checkout branch and build parent plugin pom using mvn clean install.

1.1 Preparing myfaces-builder-annotations 1.0.3

  • Change on pom.xml its parent plugin to 1.0.3 and temporary commit (avoid branch creation).
    • Trying to prepare SUCCESS!.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="lu4242_m2_plugins_103_release/myfaces-builder-annotations" -DdryRun=true
  • Release it! SUCCESS.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="lu4242_m2_plugins_103_release/myfaces-builder-annotations" -Dresume=false
  • Rollback but do not remove branch files, for restore myfaces-plugin-parent to 1.0.3-SNAPSHOT (later this will be changed manually)

1.2 Preparing myfaces-builder-plugin 1.0.3

  • Change on pom.xml its parent plugin to 1.0.3 and temporary commit (avoid branch creation).
    • Trying to prepare SUCCESS!.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="lu4242_m2_plugins_103_release/myfaces-builder-plugin" -DdryRun=true
  • Release it! SUCCESS.
mvn release:prepare -DtagBase=https://svn.apache.org/repos/asf/myfaces/myfaces-build-tools/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="lu4242_m2_plugins_103_release/myfaces-builder-plugin" -Dresume=false
  • Rollback but do not remove branch files, for restore myfaces-plugin-parent to 1.0.3-SNAPSHOT (later this will be changed manually)

2. Deploy on local repo (all three artifacts) SUCCESS

mvn clean source:jar install deploy -DaltDeploymentRepository=myfaces-local-staging::default::scp://localhost/home/lu4242/stage/repoplugins103 -DperformRelease=true

3. Copy on people.apache.org

scp -p -r org lu4242@people.apache.org:/home/lu4242/public_html/m2-plugins-103

4. Ask for vote

Hi,

I was running the needed tasks to get the 1.0.3 release of Apache
MyFaces Builder Plugin out.

This artifacts are necessary to release myfaces archetypes and make
trinidad-sandbox use myfaces-builder-plugin (see TRINIDAD-1409 for details).
After release this artifacts, myfaces-core and tomahawk will be updated
to use this version.

Testing instructions are available at [3].

Some velocity templates where added and others synchronized to the versions used
in myfaces core, tomahawk or myfaces commons. Several bug fixes has been done on 
some java annotations and on plugins. Below there is a list of the changes 
included on this release:

Tasks

MYFACES-2168 Add documentation for myfaces-builder-plugin

Bugs

MYFACES-2236 Allow define deferredValueType for component/converter/validator for tag @JSFProperty when generate tld using myfaces-builder-plugin
MYFACES-2202 myfaces builder plugin does not recognize properties returning arrays
MYFACES-2170 Missing attribute for @JSFValidator and @JSFConverter on myfaces-builder-annotations
MYFACES-2169 force parameter does not work on make-components, make-tags, make-converter-tags and make-validator-tags goals of myfaces-builder-plugin
MYFACES-2158 Tag inherited from tag class in component hierarchy does not inherit properties [myfaces builder plugin]
MYFACES-2159 Update myfaces builder plugin to use Qdox 1.9.1
MYFACES-2157 Converters cannot inherit properties from other converters when @JSFConverter is used myfaces builder plugin

Please note that this vote concerns all of the following parts:
 1. Maven artifact group "org.apache.myfaces.buildtools" v1.0.3 (only myfaces-builder-plugin, myfaces-builder-annotations, myfaces-plugin-parent) [1]

The artifacts are deployed to my private Apache account ([1]).

Please take a look at the "1.0.3" artifacts and vote!

Please note: This vote is "majority approval" with a minimum of three
+1 votes (see [3]).

------------------------------------------------
[ ] +1 for community members who have reviewed the bits
[ ] +0
[ ] -1 for fatal flaws that should cause these bits not to be released,
 and why..............
------------------------------------------------

Thanks,
Leonardo Uribe

[1] http://people.apache.org/~lu4242/m2-plugins-103
[2] http://www.apache.org/foundation/voting.html#ReleaseVotes
[3] http://wiki.apache.org/myfaces/BuilderPluginRelease103

5. Vote success, continue with the procedure

6. Deploy on repo1.maven.org

mvn clean source:jar install deploy -DperformRelease=true -DaltDeploymentRepository=myfaces-staging::default::scpexe://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository  

7. copy svn branch to tag

8. ANNOUNCE mail

The Apache MyFaces team is pleased to announce the release of
Apache MyFaces Builder Plugin and Annotations 1.0.3.

Apache MyFaces Builder Plugin is a maven plugin, used internally in
other projects like myfaces core and tomahawk for generate component classes,
tag classes, faces-config files, .tld files and facelets taglib files. In other
words, its several maven goals provide a component kit for generate jsf
components with minimal effort.

Apache Myfaces Builder Annotations is a set of annotations used by 
Myfaces Builder Plugin to define the metadata.

Apache MyFaces Builder Plugin and Annotations is available in the central Maven repository under
Group ID "org.apache.myfaces.buildtools".

Enjoy!


  • No labels