search

fwcd / vscode-kotlin

Kotlin code completion, debugging, linting and more for VSCode
MIT License
297 stars 41 forks source link

Offline language-server & debug adapter support/instruction #70

Open Strongbeard opened 3 years ago

Strongbeard commented 3 years ago

Motivation

I work with an offline system that I want to use this extension on. Since there is no direct internet connection, the current version (0.2.23) fails to download the Kotlin language server and debug adapter from Github. No further instruction is provided on how to manually find and install these two dependencies after the error message displays and none is provided in the README.md file.

It would improve the user experience if the extension somehow instructed the user (maybe in the error messages or through a pop-up) on how to manually obtain and install these dependencies when this situation occurs.

Calling out these dependencies and their manual installation process in the README.md file would also help limit the number of transfers over the air-gap.

Description

  1. Either update the error messages displayed by VSCode or add some kind of pop-up with instructions on how to manually download and install the language server and debug adapter when the download fails.
  2. Provide this instruction in the README.md file.

Alternatives considered

Just providing the instruction in the README.md would still be a major improvement for the situation that would not require any code changes.

fwcd commented 3 years ago

You can download the language server binary (e.g. from GitHub Releases) anywhere you like, then point the setting kotlin.languageServer.path to it.

Similarly you can download and install the debug adapter from the kotlin-debug-adapter repo.