-
-
Notifications
You must be signed in to change notification settings - Fork 42
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
73d74a5
commit 83eddd4
Showing
6 changed files
with
94 additions
and
10 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,50 @@ | ||
# Maintaining the plugin | ||
|
||
## Forging a new release | ||
|
||
The plugin is released manually, based on a git tag. | ||
|
||
A gradle plugin automatically determines the current tag and / or if this | ||
is a snapshot release. | ||
|
||
To build the plugin, execute the gradle task `buildPlugin`. | ||
|
||
```bash | ||
./gradlew clean buildPlugin | ||
``` | ||
|
||
The artifact zip can then be found in `build/distrubutions`. This is the | ||
final result which can be uploaded to the JetBrains repository. | ||
|
||
The checklist for a new release should be the following: | ||
|
||
* ensure the project is currently on the latest commit on the `master` branch | ||
You can enforce this by pulling and resetting with the `--hard` flag | ||
* make sure there are no staged changes | ||
* prepare the changelog: | ||
* execute `./prepare-release.sh` to write the changelog to disk | ||
* manually copy the relevant parts to `CHANGELOG.md` | ||
* commit the changed files (preferrable with a meaningful commit message | ||
`Prepare release 0.16.xxx`) | ||
* tag a release (`git tag 0.x.xxx`) | ||
* push the changed code and the tag to the remote (`git push && git push --tags`) | ||
* build the plugin on the tag (`./gradlew clean buildPlugin`) | ||
|
||
## Upload to JetBrain Plugin repository | ||
|
||
The plugin can be updated in two different ways. | ||
|
||
### Manual upload | ||
|
||
Upload the produced ZIP file to the JetBrains repository manually | ||
|
||
### Semi-automatic upload through gradle | ||
|
||
The IntelliJ gradle plugin ships a task to upload the release | ||
automatically. This will include the changelog generated earlier. | ||
|
||
Execute the following gradle task: | ||
|
||
```bash | ||
IJ_REPO_USERNAME=youruser IJ_REPO_PASSWORD=yourpassword ./gradlew clean buildPlugin publishPlugin | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,8 @@ | ||
#!/usr/bin/env bash | ||
echo "<html><ul>" > change-notes.html | ||
git log `git describe --tags --abbrev=0`..HEAD --no-merges --oneline --pretty=format:"<li>%h %s (%an)</li>" >> change-notes.html | ||
echo "</ul></html>" >> change-notes.html | ||
|
||
cp change-notes.html src/main/resources/META-INF/ | ||
|
||
rm change-notes.html |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
<html><ul> | ||
<li>443f8c6 Create a description for DoctrineOrmRepositoryIntention (Cedric Ziel)</li> | ||
<li>a520820 Do not bind doc tags to variables (Cedric Ziel)</li> | ||
<li>765f56c Remove until constraint and update php plugin to 182.3684.42 (Cedric Ziel)</li> | ||
<li>4fe34f7 Add 2018.2 platform to the build environment (Cedric Ziel)</li> | ||
<li>8e73e00 Don't strip starting backslashes from FQN (Cedric Ziel)</li> | ||
<li>97ef114 Use ORM alias for embedded classes (Konstantin Myakshin)</li> | ||
<li>fcb020e Allow @Attributes and @Attribute annotations for @Annotation classes (#111) (meyerbaptiste)</li> | ||
<li>c858ef4 Convert project structure to use a gradle build (#110) (Cedric Ziel)</li></ul></html> |