Releasing

Creating a new release

From IntelliJ:

• ensure that the changelog in resources/META-INF/plugin.xml is up-to-date (from the current milestone)
  • edit plugin.xml.template: update release notes
• commit these changes
• create a new branch locally from that commit (git checkout -B release_<version> SHA, replacing <version> and SHA as appropriate)
• in a terminal emulator, bin/plugin --release=<version> build, again replacing <version> with the current version number
• the plugin is created as three separate flutter-studio.zip products in /project/root/artifacts/release_<version> (all three will be uploaded separately)
  • 3.0
  • 2017.3
  • 2018.1
• push your release branch upstream (git push -u upstream release_20)

From github:

• go to https://github.com/flutter/flutter-intellij/releases
• select Draft a new release
  • enter a version tag and release title of x.y.z (e.g., 20.0)
  • update release description (from plugin.xml)
  • N.B. be sure and target your release branch (e.g., release_20.0)

From plugins.jetbrains.com:

• sign into https://plugins.jetbrains.com
• from https://plugins.jetbrains.com/plugin/9212?pr=idea, select 'update plugin'
• upload the flutter-studio.zip files (one for each product) created from the earlier step (note: the .zip file)

Pushing a patch to an existing release

When it's necessary to patch a previously released build:

Create a branch

• the fix should have already been committed to master
• change to the branch for that release (git checkout release_21)

Cherry-pick the fix

• cherrypick the specific commit (git cherry-pick 2d8ac6a)
• ensure that the changelog in resources/META-INF/plugin.xml is up-to-date (from the current milestone)
  • edit plugin.xml.template: update release notes
• commit these changes
• push your release branch upstream (git push -u upstream release_20)

Re-deploy the new Jar

• in a terminal emulator, bin/plugin --release=<version> build, again replacing <version> with the current version number
• the plugin is created as three separate flutter-studio.zip products in /project/root/artifacts/release_<version> (all three will be uploaded separately)
  • 3.0
  • 3.1
  • 2018.1
• sign into https://plugins.jetbrains.com
• from https://plugins.jetbrains.com/plugin/9212?pr=idea, select 'update plugin'
• upload the flutter-studio.zip created from the earlier step (note: the .zip file)