diff options
-rw-r--r-- | site/docs/ide.md | 66 |
1 files changed, 52 insertions, 14 deletions
diff --git a/site/docs/ide.md b/site/docs/ide.md index 2a7f8abb5d..3d2e073bdd 100644 --- a/site/docs/ide.md +++ b/site/docs/ide.md @@ -5,28 +5,66 @@ title: IDE integration # Integrating Bazel with IDEs -Bazel currently integrates with the following IDEs via third-party solutions: +IDEs integrate with Bazel in a variety of ways, from features that allow Bazel executions from within the IDE, to awareness of Bazel structures such as syntax highlighting of the BUILD files. -* Android Studio +## Supported IDEs and editors -* CLion +### IntelliJ, Android Studio and CLion -* IntelliJ +*Status*: Beta, supported by the Bazel team. -* Xcode +[Plug-ins](http://ij.bazel.build) for Android Studio, CLion, and IntelliJ enable you to: -## IDE plug-ins +* Import BUILD files into the IDE +* Make your IDE aware of Bazel's build and Skylark languages +* Build, test, and execute binaries directly from the IDE -[Plug-ins](http://ij.bazel.build) for Android Studio, CLion, and IntelliJ -enable you to: +Installation: -* Import BUILD files into the IDE +* [Android Studio plugin](https://plugins.jetbrains.com/plugin/9185-android-studio-with-bazel) +* [CLion plugin](https://plugins.jetbrains.com/plugin/9554-clion-with-bazel) +* [IntelliJ plugin](https://plugins.jetbrains.com/plugin/8609-intellij-with-bazel) -* Make your IDE aware of Bazel's build and Skylark languages +### Xcode -* Build, test, and execute binaries directly from the IDE +*Status*: Beta, supported by the Bazel team. + +[Tulsi](http://tulsi.bazel.build) generates Bazel-compatible Xcode projects from Bazel's `BUILD` files. + +### Eclipse + +*Status*: experimental, not officially supported by the Bazel team. + +See [installation steps on GitHub](https://github.com/bazelbuild/eclipse#installation) + + +### Visual Studio Code + +*Status*: not officially supported by the Bazel team. + +Provides syntax highlighting and formatting for Bazel `BUILD` and `WORKSPACE` files. + +See [Bazel in Visual Studio marketplace](https://marketplace.visualstudio.com/items?itemName=DevonDCarew.bazel-code) + + +### Atom + +*Status*: not officially supported by the Bazel team. + +See [`language-bazel` package](https://atom.io/packages/language-bazel) + + + +### Vim + +*Status*: Beta, not officially supported by the Bazel team. + +https://github.com/bazelbuild/vim-bazel + +## Automatically run build and test on file change + +[Bazel watcher](https://github.com/bazelbuild/bazel-watcher) is a tool for building Bazel targets when source files change. -## Tulsi +## Building your own IDE plugin -[Tulsi](http://tulsi.bazel.build) generates Bazel-compatible Xcode projects from -Bazel's `BUILD` files. +Read the [*IDE support* blog post](https://bazel.build/blog/2016/06/10/ide-support.html) to learn more about the Bazel APIs to used when building an IDE plugin. |