VSCode使用LSP进行Swift开发

时间  2019-11-16
标签 vscode 使用 lsp 进行 swift 开发 栏目 Swift 繁體版
原文   原文链接

LSP简介

LSP的全称是Language Server Protocol，是微软推出的一项标准化协议，旨在用来统一开发工具与Language Server以前的通讯。它支持语言的自动补全、定义跳转、查看定义、查看引用、lint、语法高亮等等，但具体实现要看各类语言的LS支持是否完善。在这以前，各类IDE都须要本身实现一套相似的东西，显得比较重复。借助于LSP，开发工具只要按规则接入该协议，即可以享受到各类语言提供的服务。html

目前支持的语言汇总在这里，下图只截出了部分，维护者有民间组织，微软，还有正牌。好比对swift的支持就是Apple维护的sourcekit-lsp。node

image.png

LSP如何工做

官网上有段介绍LSP是如何工做的。git

client和server以前使用JSONRPC进行通讯，采用request-response的方式，以下图。github

image.png

主要步骤：shell

  1. 用户打开文档，client发送textDocument/didOpen通知，告诉服务器。这时文件内容保存在内存中。
  2. 用户编辑文档，client发送textDocument/didChange通知，而后server会发回textDocument/publishDiagnostics通知，会分析出error和warning。client根据这些error和warning进行对应的UI显示。
  3. 用户执行跳转到符号定义，client发起textDocument/definition请求，server返回相关的位置信息。
  4. 用户关闭文档，client发送textDocument/didClose通知，文件内容更新到磁盘。

下面来看下具体的request和response，以textDocument/definition来举例。npm

request: 其主要参数是method,params。params会带上当前的文件信息，要查询定义的符号信息（第几行，第几个字符）json

{
    "jsonrpc": "2.0",
    "id" : 1,
    "method": "textDocument/definition",
    "params": {
        "textDocument": {
            "uri": "file:///p%3A/mseng/VSCode/Playgrounds/cpp/use.cpp"
        },
        "position": {
            "line": 3,
            "character": 12
        }
    }
}
复制代码

response: 响应包括符号定义的文件位置，符号的起始和终止位置。swift

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "uri": "file:///p%3A/mseng/VSCode/Playgrounds/cpp/provide.cpp",
        "range": {
            "start": {
                "line": 0,
                "character": 4
            },
            "end": {
                "line": 0,
                "character": 11
            }
        }
    }
}
复制代码

LSP定义

LSP中定义了不少method，用来区分不一样事件。包括请求和通知。sublime-text

如initialize，是client发给server的第一个请求。 Shutdown，关闭请求。 textDocument/definition，查看符号定义的请求。 ...xcode

其详细定义文档在这里。

VSCode中安装swift LSP

众所周知，VSCode是一款功能强大的编辑器，其提供了很是丰富的插件来支持各类语言的开发，而且它是众多编辑器中率先支持LSP的。

Swift For LSP还在早期开发的阶段，所以并无提供安装包或者插件。因此目前咱们只能手动下载安装。步骤以下：

安装XCode

这步应该能够略过。

安装VSCode

这步应该也能够略过。

安装最新swift toolChain

到Swift.org下载最新的主干包，安装好以后，到XCode->Preferences->Components选择刚安装的toolchain。或者这里不选择，在vscode中设置toolchain的路径。

image.png

安装node和npm

因为VSCode的插件都是用js/ts来写的，因此须要js的运行环境。推荐直接下载安装包来安装。

验证是否装好了，能够执行如下命令

nmp --version
复制代码

编译并安装SourceKit-LSP

clone仓库：

git clone https://github.com/apple/sourcekit-lsp.git
复制代码

跳转到sourcekit-lsp目录：

cd sourcekit-lsp
复制代码

编译：

swift build
复制代码

编译成功后，会在.build/debug找到二进制文件。咱们将其移到/usr/local/bin目录下，以即可以直接使用。

mv .build/debug/sourcekit-lsp /usr/local/bin
复制代码

这个命令会启动lsp的进程。

sourcekit-lsp
复制代码

安装SourceKit-LSP插件

该插件的做用是让VSCode与SourceKit-LSP之间能够进行通讯。

  1. 进入到sourceKit-lsp下面的Editors/vscode/目录
cd Editors/vscode/
复制代码
  1. 执行npm run createDevPackage
npm run createDevPackage
复制代码

若是在这步遇到npm ERR! 404 Not Found: flatmap-stream@0.1.1的问题，能够尝试删除lock文件，清除缓存试试。

rm package-lock.json
npm cache clean --force
复制代码
  1. 安装sourcekit-lsp-vscode-dev.vsix
code --install-extension out/sourcekit-lsp-vscode-dev.vsix
复制代码

首先要在VSCode中安装code命令，cmd+shift+p，输入shell command，而后安装code命令。如图所示。

image.png

重启VSCode。

  1. 配置sourcekit-lsp

使用快捷键cmd,（或者preference-->settings），进入settings页面，搜索sourcekit-lsp，ToolChain Path中填入以前下载安装的toolchain路径。好比个人是/Library/Developer/Toolchains/swift-DEVELOPMENT-SNAPSHOT-2018-11-25-a.xctoolchain。

image.png

以上就配置完成了。

最后，打开一个swift的xcode工程，鼠标停留在关键字上，会展现出具体的定义。以下图。

image.png

将设置中的Trace Server打开，设置成message，能够看到请求/响应/通知信息；设置成verbose，会更加详细，具体字段以及内容。其中请求是有id编号的，通知没有。

  • 打开工程时，log以下。会依次发送initialize，initialized，textDocument/didOpen。window/logMessage是server发过来的通知。
[Trace - 3:00:00 PM] Sending request 'initialize - (0)'.
[Trace - 3:00:00 PM] Received notification 'window/logMessage'.
could not open compilation database for /Users/liusilan/Documents/workspace/my/LeetCode/countSegments noEntry
[Trace - 3:00:00 PM] Received notification 'window/logMessage'.
failed to open IndexStoreDB: indexstoredb_index_create error: index store path does not exist: /Users/liusilan/Documents/workspace/my/LeetCode/countSegments/.build/debug/index/store
[Trace - 3:00:00 PM] Received response 'initialize - (0)' in 234ms.
[Trace - 3:00:00 PM] Sending notification 'initialized'.
[Trace - 3:00:00 PM] Sending notification 'textDocument/didOpen'.
[Trace - 3:00:00 PM] Received notification 'textDocument/publishDiagnostics'.
[Trace - 3:00:01 PM] Received notification 'textDocument/publishDiagnostics'.
复制代码
  • 在进行编辑时，log以下。发送textDocument/didChange，server会返回textDocument/publishDiagnostics。
[Trace - 2:58:57 PM] Sending notification 'textDocument/didChange'.
[Trace - 2:58:57 PM] Received notification 'textDocument/publishDiagnostics'.
[Trace - 2:58:57 PM] Received notification 'textDocument/publishDiagnostics'.
复制代码
  • 鼠标停留时，会发送textDocument/hover。
[Trace - 2:53:43 PM] Sending request 'textDocument/hover - (3)'.
[Trace - 2:53:43 PM] Received response 'textDocument/hover - (3)' in 3ms.
复制代码
  • 光标点在某行时，会发送textDocument/documentHighlight。
[Trace - 2:55:07 PM] Sending request 'textDocument/documentHighlight - (22)'.
[Trace - 2:55:07 PM] Received response 'textDocument/documentHighlight - (22)' in 2ms.
复制代码
  • 按住cmd键，查看符号定义时，会发送textDocument/definition。
[Trace - 2:55:40 PM] Sending request 'textDocument/definition - (43)'.
[Trace - 2:55:40 PM] Received response 'textDocument/definition - (43)' in 8ms.
复制代码

关于versbose打印的信息，你们能够尝试设置看看。

另外，SouceKit-LSP也是支持Sublime Text的，具体配置能够参照sublime-text配置。

Suorcekit-LSP支持的特性

目前，由于它还在早期开发中，支持的功能还不是不少，相信之后会愈来愈完善。

Feature Status Notes
Swift ✅
C/C++/ObjC ❌ clangd is not available in the recommended toolchain. You can try out C/C++/ObjC support by building clangd from source and putting it in PATH.
Code completion ✅
Quick Help (Hover) ✅
Diagnostics ✅
Fix-its ❌
Jump to Definition ✅
Find References ✅
Background Indexing ❌ Build project to update the index using Indexing While Building
Workspace Symbols ❌
Refactoring ❌
Formatting ❌
Folding ❌
Syntax Highlighting ❌ Not currently part of LSP.
Document Symbols ❌

VSCode调试swift

调试在开发过程当中是必不可少的，以前老是生成xcodeproj，而后在xcode中进行调试，总归有些不太方便。

在VSCode中调试swift也挺简单的，步骤以下：

  1. 安装插件CoreLLDB

    QQ20190108-4.png

  2. 配置launch.json

在插件安装完成以后，打开swift工程，按F5，会出现配置弹框，以下。

点击Open launch.json进行配置，具体配置以下：

{
    // Use IntelliSense to learn about possible attributes.
    // Hover to view descriptions of existing attributes.
    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        // Running executables
        {
            "type": "lldb",
            "request": "launch",
            "name": "Run your Executable",
            "program": "${workspaceFolder}/.build/debug/xxx",
            "args": [],
            "cwd": "${workspaceFolder}",
            "preLaunchTask": "swift-build"
        }
    ]
}
复制代码

注意将"program": "${workspaceFolder}/.build/debug/xxx",中的xxx改为本身工程可执行文件的名字。

  1. 配置task.json

launch.json配置好后，继续按F5，此时会出现配置task的弹窗，以下图。

QQ20190108-2.png

点击Configure Task进行配置，以下：

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        // compile your SPM project
        {
            "label": "swift-build",
            "type": "shell",
            "command": "swift build"
        },
        // compile your SPM tests
        {
            "label": "swift-build-tests",
            "type": "process",
            "command": "swift",
            "group": "build",
            "args": [
                "build",
                "--build-tests"
            ]
        }]
}
复制代码

至此，所有配置完成。按F5开始调试，若是仍然出现弹窗，则说明某个地方没配置好，需对比下上面的配置。

最后就能够愉快的调试了。

QQ20190108-3.png
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程