YouTrack-Idea-Plugin
This plugin brings Jetbrains YouTrack bugtracker features to Intellij IDE family.
The latest released version can be found at JetBrains IDE plugin repository or installed directly from an IDE itself.
Compatible IDEs: IntelliJ IDE family 2017.1+
Compatible YouTrack versions: 5.2+
Installation and Configuration
This plugin relies on a long-standing task management plugin and it's context management. It will be installed automatically once YouTrack plugin is installed. Gogland IDE is known to have some issues with that though. Having YouTrack plugin installed from a plugin repository proceed as follows:
- Navigate to Settings dialog -> Tools -> Tasks -> Servers
- Configure connection to your YouTrack instance
That's it, plugin is now ready to work.
Features
Command execution
Among the other context types task management plugin supports bug tracker issues. When an issue from YouTrack as set as an active task it's possible to execute YouTrack command against the issue. Hit Ctrl+Shift+Y of use Tools menu to invoke a command window.
Please refer to YouTrack command guide for the general command execution rules.
Code navigation
When clicking a stacktrace in YouTrack the plugin is able to open the corresponding file in IDE. This feature is somewhat similar to what TeamCity plugin offers, although current implementation doesn't perform VCS lookup to find the best match for source code changing over time. This feature requires local ports to be opened, so you may want to configure your firewall to allow connections to 127.0.0.1:63330..63339.
Issue view
Plugin displays issue list matching the query set in server settings. When an issue is selected, issue preview appears with wiki markup rendered.
Notifications
With YouTrack 2018.1+ plugin can show issue tracker notifications in IDE. To enable notifications server wide one should have 'REST API' notification channel enabled on Global Settings page in YouTrack. To disable notifications in IDE navigate to File > Appearance & Behavior > Notifications and switch the corresponding category to 'No Balloon'.
Autolinks
Issue IDs are turned into navigable links in VCS history and Java code comments.
Plugin logs
If you think there's something wrong going on with the plugin try checking plugin logs. To enable debug logging proceed as follows:
- Navigate to 'Help' IDE menu and select 'Debug Log Settings...'
- Add com.github.jk1 category to the list
- In 'Help' menu select 'Show Log in File Manager' to explore logged data
Plugin API
One can use YouTrack plugin API in other plugins as follows:
project.getComponent(YouTrackPluginApi.class)
Separate plugin api jar file is included in the plugin to be used as a compile time dependency.
Development
Plugin requires JDK 8 installed for development.
To get an Idea project open build.gradle
file with Intellij Idea and follow import instructions.
Handy development tasks:
-
./gradlew assemble
to build plugin in build/distributions folder -
./gradlew tests
to run all tests -
./gradlew runIdea
to start a copy of IntelliJ IDEA with YouTrack plugin enabled
Pull requests are most welcome.