78 lines
2.5 KiB
Org Mode
78 lines
2.5 KiB
Org Mode
#+TITLE: kotlin layer
|
|
|
|
#+TAGS: general|layer|multi-paradigm|programming
|
|
|
|
[[file:img/kotlin.png]]
|
|
|
|
* Table of Contents :TOC_5_gh:noexport:
|
|
- [[#description][Description]]
|
|
- [[#features][Features:]]
|
|
- [[#install][Install]]
|
|
- [[#layer][Layer]]
|
|
- [[#ktlint][Ktlint]]
|
|
- [[#configuration][Configuration]]
|
|
- [[#choosing-a-backend][Choosing a backend]]
|
|
- [[#company-kotlin][Company-kotlin]]
|
|
- [[#lsp][LSP]]
|
|
|
|
* Description
|
|
This layer adds support for [[http://kotlinlang.org/][Kotlin]] to Spacemacs.
|
|
|
|
** Features:
|
|
- Syntax highlighting
|
|
- Auto-completion
|
|
- Syntax-checking with [[https://github.com/shyiko/ktlint][ktlint]] and [[https://github.com/whirm/flycheck-kotlin][flycheck-kotlin]]
|
|
- Navigation with =ggtags=
|
|
|
|
* Install
|
|
** Layer
|
|
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
|
|
add =kotlin= to the existing =dotspacemacs-configuration-layers= list in this
|
|
file.
|
|
|
|
** Ktlint
|
|
You must install [[https://github.com/shyiko/ktlint][ktlint]] and make sure that the =ktlint= binary is on Emacs
|
|
=exec-path=
|
|
|
|
* Configuration
|
|
All layer configurations can be done by setting layer variables in your dotfile.
|
|
No custom user config lines are necessary
|
|
|
|
** Choosing a backend
|
|
This layer provides two alternative backends to choose from.
|
|
|
|
*** Company-kotlin
|
|
This is the default choice if nothing is set and no lsp layer
|
|
is loaded in your dotfile. This mode only provides very
|
|
limited IDE capabilities. Used best if only small applications
|
|
are edited. To set explicitly set the following in your
|
|
dotfile:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(kotlin :variables kotlin-backend 'company-kotlin)
|
|
#+END_SRC
|
|
|
|
*** LSP
|
|
For proper IDE support this backend should be used. It is
|
|
based on an external server which will be started automatically
|
|
by emacs, once a kotlin file is opened. The key bindings are
|
|
the same for all lsp modes so if you are already familiar with
|
|
one you should be able to work the same in all modes.
|
|
|
|
To set explicitly do the following in your dotfile:
|
|
|
|
#+BEGIN_SRC emacs-lisp
|
|
(kotlin :variables
|
|
kotlin-backend 'lsp
|
|
kotlin-lsp-jar-path "path/to/kotlin/installdir/install/server/bin/kotlin-language-server")
|
|
#+END_SRC
|
|
|
|
For this to work you will also need to obtain
|
|
the latest version of the lsp server from [[https://github.com/fwcd/kotlin-language-server][here]].
|
|
The path to the server jar must be given in the layer
|
|
variable =kotlin-lsp-jar-path=.
|
|
|
|
NOTE: Key bindings for LSP are defined in the
|
|
LSP layer. Also it is advisable to have a look
|
|
at the autocomplete layer for an optimal
|
|
intellisense config for LSP.
|