CONTRIBUTING.md

Azure Toolkit for Rider

The main project is located in the PluginsAndFeatures/azure-toolkit-for-rider. All changes to the Utils and PluginsAndFeatures/azure-toolkit-for-intellij folders must be implemented in the base repository.

Prerequisites

• Install JDK 17 (e.g. JetBrains Runtime or Amazon Corretto)

Windows

• If you receive errors related to exit code -1073741515 during the Utils project installation, make sure to install Visual Studio 2010 C++ Redistributable.

Building

• Clone the repository with HTTPS or SSH:

  $ git clone https://github.com/JetBrains/azure-tools-for-intellij.git
  $ cd azure-tools-for-intellij
  

• To run the prepared run configurations, open the PluginsAndFeatures/azure-toolkit-for-rider folder in IntelliJ IDEA.

• Using JDK 17, run Build Utils run configuration or manually execute the following command under the project base path (If you have problems, make sure JAVA_HOME environment variable points to <JDK17>/bin):

  $ ./mvnw clean install -DskipTests -f Utils/pom.xml
  

• Using JDK 17, run Build Plugin run configuration or use Gradle to build the plugin

  $ ./PluginsAndFeatures/azure-toolkit-for-rider/gradlew -b ./PluginsAndFeatures/azure-toolkit-for-rider/build.gradle.kts buildPlugin
  

  You can find the outputs under PluginsAndFeatures/azure-toolkit-for-rider/build/distributions

Run/Debug

• Open IntelliJ IDEA, open PluginsAndFeatures/azure-toolkit-for-rider folder.
• Run/Debug the plugin by using Run Plugin run configuration.
• For the dotnet part, open the solution file from PluginsAndFeatures/azure-toolkit-for-rider/ReSharper.Azure.sln.

Maven Plugins for Azure Services

The plugin depends on the Maven Plugins for Azure Services. Most often we use the release version of the package (when it is based on the endgame branch from the azure-tools-for-java repository). But sometimes it is necessary to build a snapshot version of the package. To do that, follow these steps:

• Install Corretto JDK 8
• Using JDK 8, Clone and Build azure-maven-plugins/azure-toolkit-libs.

  $ git clone https://github.com/microsoft/azure-maven-plugins.git
  $ cd azure-maven-plugins
  $ ./mvnw clean install -f azure-toolkit-libs/pom.xml