gson

Navigation

Recent site activity

Release Process

The following is a step-by-step procedure for releasing a new version of Google-Gson.
  1. Mark all bugs as fixed for the release
  2. Ensure all changelists are code-reviewed and have +1
  3. Update the version tag in pom.xml
  4. Perform the following Maven commands, in order:
    • mvn clean
    • mvn package source:jar javadoc:jar assembly:assembly
  5. Navigate to target/dist and perform a sanity check on the zip bundle:
    • unzip zip file
    • jar tvf on the jar files and verify the proper files are in the jars
  6. Upload the zip bundle to the code.google.com/p/google-gson site (label this upload as "Featured")
  7. Deprecate old Gson version (click on version label and set the "Featured" label to "Deprecated")
  8. Copy generated JavaDocs from target/apidocs to trunk/gson/docs/javadocs
    • Set the svn properties to the valid mime-types:
      • find docs -name "*.html" | xargs svn propset svn:mime-type text/html
      • find docs -name "*.gif" | xargs svn propset svn:mime-type image/gif
  9. Commit the JavaDoc changes into the repository
  10. Run mvn deploy in trunk/gson directory
  11. cd ../../mavenrepo/com/google/code/gson/gson/
  12. svn add 1.2.3
  13. svn commit (add the local maven repository to the googlecode.com)
  14. Tag the current release from trunk/gson
    • mvn clean
    • cd ../..
    • svn copy trunk/gson tags/1.2.3
    • svn commit tags -m "Release 1.2.3"
  15. Update the "API" link on the code.google.com home page to point to the newly tagged JavaDoc
  16. Update the version in the "Using Gson with Maven2" sites page
  17. Update Gson Roadmap to move the release down under the "Released section". Also, look at all bugs that were fixed and add a few lines describing what changed in the release.
  18. Create a post on the Gson Discussion Forum