Build and Release

Last modified 30 Sep 2021 10:06 +02:00

Build

There are three types of Studio builds:

Build type Quality Description

stable

production

Production-quality official releases.

snapshot

beta

Intended for testing, evaluation of new features, gathering of community feedback and so on. Development happens here.

milestone (deprecated)

beta

Intended for testing, evaluation of new features, gathering of community feedback and so on.

nightly (deprecated)

varies, no guarantees

Development happens here. Latest functionality, but the code may break any time. Use at your own risk.

Adding Plugin Repository

Custom repository needs to be added to use snapshot builds:

  1. Go to menu File → Settings (Preferences) → Plugins → Manage plugin repositories

  2. Add repository:

  3. Search for MidPoint Studio and click on Install

Migrating from nightly/milestone plugin repository to snapshot repository

  1. Go to menu File → Settings (Preferences) → Plugins

    1. Uninstall MidPoint Studio plugin

  2. Go to menu File → Settings (Preferences) → Plugins → Manage plugin repositories

    1. Edit existing url of nightly/milestone repository, change it to https://plugins.jetbrains.com/plugins/Snapshot/list

  3. Search for MidPoint Studio and click on Install

Release Procedure

  1. update studio-idea-plugin/src/main/resources/META-INF/plugin.xml

    1. edit description if needed

    2. update change-notes, add release description

  2. make sure studio-idea-plugin/build.gradle contains proper since/until build compatiblity values

  3. align git branches snapshot → stable

    1. all branches up to released one shouldn’t contain any differences

  4. in project run ./gradlew clean buildPlugin runPluginVerifier

    1. check validation results in studio-idea-plugin/build/reports/pluginVerifier/*/report.html

  5. execute jenkins job midpoint-studio-release with PUBLISH=true and proper release branch

    1. jenkins will create and publish all necessary branches up to released one

    2. go to https://plugins.jetbrains.com/plugin/13809-midpoint-studio/versions

      • validate published plugins/versions

    3. go to https://github.com/Evolveum/midpoint-studio/releases

      • validate created git tags for each published build

    4. notifications from Jetbrains Marketplace will be sent after:

      1. plugin was uploaded

      2. plugin compatibility was checked

      3. plugin was approved

  6. on master branch update plugin version in build.gradle and change notes in plugin.xml

Issues

  1. in case build wasn’t correct but plugin was published to JetBrains Marketplace

    1. go to https://plugins.jetbrains.com/plugin/13809-midpoint-studio/versions

    2. find plugin version you want to hide/delete and click Hide update or Remove update icon

See Also