diff options
author | Alexandra Dima <alexandra.dima@jetbrains.com> | 2019-07-23 17:56:38 +0200 |
---|---|---|
committer | Samvel Abrahamyan <samvel1024@gmail.com> | 2019-10-12 14:33:09 +0200 |
commit | f0bcc011d7592db9b6e2fc19648c8fb3c7dd3c9d (patch) | |
tree | a737453d275f633ff38d9b7bb6659e213632f711 /contrib/bsp/readme.md | |
parent | 5ea90651ba6be7c3ea86f1d3123fa6af5b2f9ca8 (diff) | |
download | mill-f0bcc011d7592db9b6e2fc19648c8fb3c7dd3c9d.tar.gz mill-f0bcc011d7592db9b6e2fc19648c8fb3c7dd3c9d.tar.bz2 mill-f0bcc011d7592db9b6e2fc19648c8fb3c7dd3c9d.zip |
Addressed code review feedback.
Diffstat (limited to 'contrib/bsp/readme.md')
-rw-r--r-- | contrib/bsp/readme.md | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/contrib/bsp/readme.md b/contrib/bsp/readme.md new file mode 100644 index 00000000..c3846f66 --- /dev/null +++ b/contrib/bsp/readme.md @@ -0,0 +1,38 @@ +# Build Server Protocol support for mill + +The contrib.bsp module was created in order to integrate the Mill build tool +with IntelliJ IDEA via the Build Server Protocol (BSP). It implements most of +the server side functionality described in BSP, and can therefore connect to a +BSP client, including the one behind IntelliJ IDEA. This allows a lot of mill +tasks to be executed from the IDE. + +# Importing an existing mill project in IntelliJ via BSP + +1) Following the mill installation instructions +2) Add the following import statement in the build.sc +of your project: + + `import $ivy.com.lihaoyi::mill-contrib-bsp:$MILL_VERSION` + +3) Run the following command in the working directory of your project: + + `mill -i mill.contrib.BSP/install` + This should create a `.bsp/` directory inside your working directory, + containing a BSP connection file that clients can use to start the + BSP server for Mill. + + This command should be ran whenever you chnage the version of mill that + you use. + +4) Now you can use IntelliJ to import your project from existing sources +via bsp ( currently available in the nightly release ). Note: It might +take a few minutes to import a project the very first time. + +## Known Issues: + +- Sometimes build from IntelliJ might fail due to a NoClassDefFoundException +being thrown during the evaluation of tasks, a bug not easy to reproduce. +In this case it is recommended to refresh the bsp project. + +- Currently it's not possible ro run scala classes from intelliJ, but this +issue is being investigated |