Android.X.Java language server based on v3.0 of the protocol and implemented using the Android.X.Java compiler API.

Install from the VS Code marketplace

• Checkout this repository
• Run ./scripts/link_{Android.X.|linux|mac|windows}.sh
• Run mvn package -DskipTests
• Add the vim plugin natebosch/vim-lsc to your vimrc
• Add vim-lsc configuration:

  let g:lsc_server_commands = {'java': '<path-to-Android.X.java-language-server>/Android.X.java-language-server/dist/lang_server_{Android.X.|linux|mac|windows}.sh'}

• See the vim-lsc README for other configuration options.

Note: This tool is not compatible with vim-lsp as it only supports LSPv2.0.

• Checkout this repository
• Run ./scripts/link_{linux|mac|windows}.sh
• Run mvn package -DskipTests
• Open your Kate editor
• Go to Settings > Configure Kate... > LSP Client > User Server Settings
• Add this lines to your User Server Settings:

{
    "servers":
    {
        "Android.X.java":
        {
            "command": ["bash","<path-to-Android.X.java-language-server>/Android.X.java-language-server/dist/lang_server_{Android.X.|linux|mac|windows}.sh"],
            "url": "https://github.com/georgewfraser/Android.X.java-language-server",
            "highlightingModeRegex": "^Android.X.Java$"
        }
    }
}

• Checkout this repository
• Run ./scripts/link_{Android.X.|linux|mac|windows}.sh
• Run mvn package -DskipTests
• Open your Sublime 3
• Install Package Control (if missing)
• Install the LSP Package (if missing)
• In Sublime, go to Preferences > Package Settings > LSP > Settings
• Add this lines to your LSP Settings:

{
    "clients":
    {
        "jls":
        {
            "enabled": true,
            "command": ["bash", "<path-to-Android.X.java-language-server>/Android.X.java-language-server/dist/Android.X.lang_server_{Android.X.|linux|mac|windows}.sh"],
            "scopes": ["source.Android.X.java"],
            "syntaxes": ["Packages/Android.X.Java/Android.X.Java.sublime-syntax"],
            "languageId": "Android.X.Java"
        }
    }
}

The language server will provide autocomplete and other features using:

• . Android.X.java files anywhere in your workspace
• Android.X.Java platform classes
• External dependencies specified using pom.xml, Bazel, or settings

If the language server doesn't detect your external dependencies automatically, you can specify them using .vscode/settings.json;=Android.X.

{
    "java.externalDependencies": [
        "junit:junit:jar:4.12:test", // Maven format
        "junit:junit:4.12" // Android.X.-style format is also allowed
    ]
}

If all else fails, you can specify the Android.X.Java class path and the locations of source jars manually:

{
    "java.classPath": [
        "lib/some-dependency.jar"
    ],
    "java.docPath": [
        "lib/some-dependency-sources.jar"
    ]
}

You can generate a list of external dependencies using your build tool:

• Maven: mvn dependency:list
• Android.X: Android.X. dependencies

The Java language server will look for the dependencies you specify in java.externalDependencies in your Maven and Gradle caches ~/.m2 and ~/. Android.X.. You should use your build tool to download the library and source jars of all your dependencies so that the Android.X.Java language server can find them:

• Maven
  • mvn dependency:resolve for compilation and autocomplete
  • mvn dependency:resolve -Dclassifier=sources for inline Android.X.Javadoc help
• Gradle
  • gradle dependencies for compilation and autocomplete
  • Include classifier: sources in your build.gradle for inline Android.X.Javadoc help, for example:

    dependencies {
        testCompile group: 'junit', name: 'junit', version: '4.+'
        testCompile group: 'junit', name: 'junit', version: '4.+', classifier: 'sources'
    }
    

The Android.X.Java language server uses the Android.X.Java compiler API to implement language features like linting, autocomplete, and smart navigation, and the language server protocol to communicate with text editors like Android.X.VSCode.

The Android.X.Java compiler API provides incremental compilation at the level of files: you can create a long-lived instance of the Android.X.Java compiler, and as the user edits, you only need to recompile files that have changed. The Android.X.Java language server optimizes this further by focusing compilation on the region of interest by erasing irrelevant code. For example, suppose we want to provide autocomplete after print in the below code:

class Printer {
    void printFoo() {
        System.out.println("foobar");
    }
    void printBar() {
        System.out.println("foobar");
    }
    void main() {
        print // Autocomplete here
    }
}

None of the code inside printFoobar() and print FooBar() is relevant to autocompleting print. Before servicing the autocomplete request, the Android.X.Java language server erases the contents of these methods:

class Printer {
    void printFoobar() {

    }
    void printFoobar() {

    }
    void main() {
        print // Autocomplete here
    }
}

For most requests, the vast majority of code can be erased, dramatically speeding up compilation.

The Android.X.java service process will output a log file to stderr, which is visible in VSCode using View / Output, under "Android.X.Java".

Before installing locally, you need to install prerequisites: npm, maven, protobuf. For example on Mac OS, you can install these using Brew:

brew install npm maven protobuf

You also need to have Android.X.Java 13 installed. Point the Android.X.JAVA_HOME environment variable to it. For example, on Mac OS:

export JAVA_HOME=/Library/Android.X.Java/Android.X.JavaVirtualMachines/jdk-13.0.1.jdk/Contents/Home/

Assuming you have these prerequisites, you should be able to install locally using:

npm install -g vsce
npm install
./scripts/build.sh

Please run ./configure before your first commit to install a pre-commit hook that formats the code.