2020-04-22 08:21:51 +00:00
|
|
|
# IntelliJ Plugin Template
|
2020-04-21 17:49:38 +00:00
|
|
|
|
2020-04-22 08:21:51 +00:00
|
|
|
|
2020-04-21 20:31:52 +00:00
|
|
|
|
2020-04-22 08:21:51 +00:00
|
|
|
|
|
|
|
|
IntelliJ Plugin Template is a repository that provides a pure boilerplate for creating a plugin project with ease
|
|
|
|
|
designed as a GitHub template repository (check the [Creating a repository from a template][gh-template] article).
|
|
|
|
|
The main goal for this Template is to speed up the setup phase of the plugin development for the new as well as existing
|
|
|
|
|
developers by preconfiguring the project scaffold, CI and linking to the proper documentation pages as well as keeping
|
|
|
|
|
everything in the most straightforward manner.
|
|
|
|
|
|
|
|
|
|
We can detail here the following parts:
|
|
|
|
|
|
|
|
|
|
- Gradle configuration
|
|
|
|
|
- Sample code:
|
|
|
|
|
- listeners - project and dynamic plugin lifecycle
|
|
|
|
|
- services - project- and application-related services
|
|
|
|
|
- actions - basic action with shortcut binding
|
|
|
|
|
- Plugin Manifest file
|
|
|
|
|
- README Template
|
|
|
|
|
- CI based on GitHub actions
|
|
|
|
|
- Release and changelog maintenance flow
|
|
|
|
|
|
|
|
|
|
## Getting started
|
|
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
|
|
|
|
|
## Gradle
|
|
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
|
|
|
|
|
## Sample Code
|
|
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
|
|
|
|
|
## Plugin Manifest File
|
|
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
|
|
|
|
|
## Continuous Integration
|
|
|
|
|
|
|
|
|
|
TODO
|
|
|
|
|
|
|
|
|
|
## Release Flow
|
|
|
|
|
|
2020-05-06 07:13:49 +00:00
|
|
|
### Changelog
|
|
|
|
|
|
2020-05-06 07:22:10 +00:00
|
|
|
When delivering a new release, it is essential to let your audience know what the updated version offering is.
|
2020-05-06 07:13:49 +00:00
|
|
|
The best way of handling that is to attach the changelog.
|
|
|
|
|
|
2020-05-06 07:22:10 +00:00
|
|
|
The changelog is a curated list containing information of any new features, fixes, deprecations.
|
2020-05-06 07:13:49 +00:00
|
|
|
If provided, such list would be available in a couple of places: [CHANGELOG.md](./CHANGELOG.md) file,
|
|
|
|
|
[Releases page][releases], [What's new][marketplace-plugin-page] section in Marketplace's Plugin page
|
|
|
|
|
and inside of the Plugin Manager's item details.
|
2020-05-06 07:22:10 +00:00
|
|
|
There are many different methods of handling the project's changelog. One of them, used in the current template project,
|
2020-05-06 07:13:49 +00:00
|
|
|
is the [Keep a Changelog][keep-a-changelog] approach.
|
2020-04-22 08:21:51 +00:00
|
|
|
|
|
|
|
|
## Useful Links
|
|
|
|
|
|
|
|
|
|
- [IntelliJ Platform SDK DevGuide][sdk-docs]
|
|
|
|
|
- [IntelliJ SDK Code Samples][code-samples]
|
|
|
|
|
- [JetBrains Platform Slack][slack]
|
|
|
|
|
- [IntelliJ IDEA Open API and Plugin Development][forum]
|
2020-05-06 07:13:49 +00:00
|
|
|
- [Keep a Changelog][keep-a-changelog]
|
2020-04-22 08:21:51 +00:00
|
|
|
- [GitHub Actions][gh-actions]
|
|
|
|
|
|
|
|
|
|
[gh-template]: https://help.github.com/en/enterprise/2.20/user/github/creating-cloning-and-archiving-repositories/creating-a-repository-from-a-template
|
|
|
|
|
[gh-actions]: https://help.github.com/en/actions
|
|
|
|
|
[sdk-docs]: https://www.jetbrains.org/intellij/sdk/docs
|
|
|
|
|
[code-samples]: https://github.com/JetBrains/intellij-sdk-code-samples
|
2020-05-06 07:13:49 +00:00
|
|
|
[releases]: https://github.com/JetBrains/intellij-plugin-template/releases
|
2020-05-06 07:22:10 +00:00
|
|
|
[marketplace-plugin-page]: https://plugins.jetbrains.com/plugin/0-TODO
|
2020-04-22 08:21:51 +00:00
|
|
|
[slack]: https://plugins.jetbrains.com/slack
|
|
|
|
|
[forum]: https://intellij-support.jetbrains.com/hc/en-us/community/topics/200366979-IntelliJ-IDEA-Open-API-and-Plugin-Development
|
2020-05-06 07:13:49 +00:00
|
|
|
[keep-a-changelog]: https://keepachangelog.com
|
