You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by Apache Wiki <wi...@apache.org> on 2013/09/01 13:24:13 UTC
[Cordova Wiki] Update of "StepsForPluginRelease" by AndrewGrieve
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Cordova Wiki" for change notification.
The "StepsForPluginRelease" page has been changed by AndrewGrieve:
https://wiki.apache.org/cordova/StepsForPluginRelease
New page:
= Release Process for ''Core Plugins'' =
Core Plugins are released at most weekly (see: VersioningAndReleaseStrategy).
A plugins release is performed by a single person each week. We call this person the "Plugins Release Master" :). How to select the Plugins Release Master is still TDB.
== Get Buy-in ==
1. Email the dev mailing-list and see if anyone has reason to postpone the release.
* If so, agree upon a branching date / time.
== Create JIRA issues ==
* Create a JIRA issue to track the status of the release.
* Comments should be added to this bug after each top-level step below is taken
== Identify which plugins have changes ==
{{{
./cordova-coho/coho repo-update -r plugins
./cordova-coho/coho foreach -r plugins "git log --oneline master..dev"
}}}
* Add a comment to the JIRA issue stating which plugins had commits
== Update Changelog & Version ==
* For each plugin that has unreleased commits:
a. Update its CHANGELOG.md file with changes
b. Increase the plugin's version within plugin.xml using `SemVer`, and remove the ''-dev'' suffix.
c. Commit these two changes together to the `dev` branch
{{{
git log --no-merges --format="%h %s" dev..master
# Copy & paste into CHANGELOG.md
# Edit version within plugin.xml based off of changes.
git commit -am "Updated version and changelog for release ''$VERSION''"
}}}
== Merge Changes into master ==
{{{
./cordova-coho/coho foreach -r plugins "git checkout master"
./cordova-coho/coho foreach -r plugins "git merge dev --ff-only"
}}}
== Update dev branch's version ==
* For each plugin that had unreleased commits:
{{{
git checkout dev
# Edit version within plugin.xml by incrementing the micro and adding the ''-dev'' suffix.
git commit -am "Incremented plugin version on dev branch."
}}}
== Test ==
* Create mobilespec using the old versions of plugins
* Perform a "plugin upgrade" for plugins that have changes
* Right now, this means doing a `plugin remove` followed by a `plugin add`
* Run through mobilespec, ensuring to do manual tests that relate to changes in the changelog
== Prepare Blob Post ==
* Combine highlights from changelogs into a Release Announcement blog post
* Instructions on [[https://svn.apache.org/repos/asf/cordova/site/README.md|sites page README]]
* Get blog post proof-read.
== Push! ==
{{{
# Blog Post:
svn commit
# Plugin Changes:
./cordova-coho/coho repo-push -r plugins -b dev -b master
}}}
== Close JIRA Issue ==
* Double check that the issue has comments that record the steps you took
* Mark it as fixed
Finally:
* Update *these wiki instructions* if they were missing anything.