mirror of
https://github.com/JetBrains/intellij-sdk-code-samples.git
synced 2025-07-29 01:37:51 +08:00
44 lines
3.4 KiB
Markdown
44 lines
3.4 KiB
Markdown
---
|
|
title: Creating Your First Plugin
|
|
---
|
|
<!-- Copyright 2000-2020 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
|
|
|
|
This documentation section will help you get started with developing plugins for the *IntelliJ Platform*. You can use either [IntelliJ IDEA Community Edition](https://www.jetbrains.com/idea/download/) or [IntelliJ IDEA Ultimate](https://www.jetbrains.com/idea/download/) as your IDE (it is highly recommended to use the latest available version). Both include the complete set of plugin development tools. To become more familiar with *IntelliJ IDEA*, please refer to the [IntelliJ IDEA Web Help](https://www.jetbrains.com/idea/help/).
|
|
|
|
There are two supported workflows available for building plugins.
|
|
The recommended workflow for new projects is to [use Gradle](#using-gradle).
|
|
The old [Plugin DevKit](#using-devkit) workflow still supports existing projects.
|
|
|
|
If a new plugin will be Scala-based, a plugin development workflow [sbt-idea-plugin](https://github.com/JetBrains/sbt-idea-plugin), is available.
|
|
The workflow is analogous to the Gradle workflow but tailored to developing IntelliJ Platform plugins in Scala.
|
|
JetBrains does not officially support this Scala workflow, and at this time the workflow has only minimal documentation.
|
|
|
|
The Gradle workflow offers these advantages:
|
|
* Gradle in general:
|
|
* Representations of source sets, modules, and projects are portable,
|
|
* Projects of any size or complexity usually require scripts for build management, which Gradle handles natively,
|
|
* Training, documentation, and community help for general Gradle topics are widely available.
|
|
* Specific to development of IntelliJ Platform plugins with the Gradle plugin for IntelliJ IDEA:
|
|
* Changing plugin targets is easier because it is all done in `build.gradle`:
|
|
* Switching the version of the target IntelliJ Platform (IDE),
|
|
* Changing the target IntelliJ Platform-based IDE, e.g., from IntelliJ IDEA to PyCharm,
|
|
* Running a plugin against alternate versions of the JetBrains runtime.
|
|
* Gradle is fully integrated with IntelliJ Platform-based IDE CI builds and [plugins.jetbrains.com](https://plugins.jetbrains.com), so it is easy to customize and extend the build and publishing processes.
|
|
* Gradle has built-in verification for `plugin.xml` module dependency and use of version-specific IntelliJ Platform APIs, the same checks as on [plugins.jetbrains.com](https://plugins.jetbrains.com).
|
|
|
|
## Using Gradle
|
|
|
|
* [Developing plugins using Gradle](/tutorials/build_system.md)
|
|
* [Getting Started with Gradle](/tutorials/build_system/prerequisites.md)
|
|
* [Configuring Gradle Projects](/tutorials/build_system/gradle_guide.md)
|
|
* [Publishing Plugins with Gradle](/tutorials/build_system/deployment.md)
|
|
|
|
## Using DevKit
|
|
* [Developing plugins using DevKit](getting_started/using_dev_kit.md)
|
|
* [Setting Up a Development Environment](getting_started/setting_up_environment.md)
|
|
* [Creating a Plugin Project](getting_started/creating_plugin_project.md)
|
|
* [Creating an Action](/tutorials/action_system/working_with_custom_actions.md)
|
|
* [Running and Debugging a Plugin](getting_started/running_and_debugging_a_plugin.md)
|
|
* [Deploying a Plugin](getting_started/deploying_plugin.md)
|
|
* [Publishing a plugin to plugin repository](getting_started/publishing_plugin.md)
|