在Linux系统上搭建Swift开发调试环境

Swift与Linux

自2015年Swift宣布开源并支持Linux后，一晃已超过5年。在最初几年间尽管Swift发展迅速，但并未被Linux社区广泛接受。造成这种局面的原因较多，其中既有语言稳定性方面的问题，同时又有对Linux的支持不完善、缺乏具有吸引力的基础库和第三方库、热点项目不足等多方面原因。

最近两年，上述问题均得到显著改善。

  • 从Swift5开始Swift团队宣布ABI稳定了。自此，Swift为应用程序提供了二进制兼容性，有了ABI稳定性作为基础，Swift对其他平台的支持速度和力度将大大提高
  • 2020年Swift团队推出了5.3版本，除了“重要的质量提升和性能增强”之外，Swift5.3的一个关键特性是正式支持Linux和Window平台。事实上，这也是Swift的发布流程首次为三个不同的平台分别设立了发布负责人。作为承诺将Swift引入Linux的第一份成果，Swift团队宣布新的Swift版本可用于一众Linux发行版上。
  • 出现了大量优秀的官方和第三方的跨平台库。仅Apple公司，最近几年来已经为Swift社区贡献了大量的Swift代码，并保持着非常高的提交频率。
  • Swift在服务器端及深度学习领域取得了不错的应用成果。

Swift已经准备在Linux有更多的表现。

写本文的原因

前些日子写了篇用Publish创建博客（一）——入门（一个用Swift编写的优秀的静态网站生成器）的介绍，期间有网友问我是否可以在Linux上使用，我回答不成问题。但转过头来思考，虽然Publish完美地支持Linux，但开发者能否像在mac上一样方便的进行开发调试呢？

之前使用Vapor的时候，曾通过Docker在Ubuntu上安装过Swift，不过代码是在mac上调试的。我也十分好奇，在2021年Swift到底在Linux下的开发环境如何？

本文的目标是在Linux上搭建一个可供生产标准的Swift开发调试环境。使用者将获得一个支持代码高亮、自动补全、定义跳转、断点调试、代码美化、代码静态扫描、跨操作系统平台配置的综合开发体验。

准备

由于每个人使用的Linux发行版本不同，因此在安装过程中，如遇到缺少必要依赖的情况，请自行按系统提示安装所需的依赖库即可。

本文在描述每一步该如何做的同时，还会做出必要的解释。即使你使用的是其他的Linux发行版，或者不同的编辑器，甚至在Swift或其他工具发生了重大的升级后，仍可按照下面安装思路进行环境搭建。

本文搭建的起点是建立在已经安装了Visual Studio Code 1.53.0的Ubuntu 20.04LTS（最小化安装）系统上的。选择安装的Swift Toolchain为5.3.3。

对于Ubuntu 20.04,需安装python2.7及npm以完成下面其他操作。

$ sudo apt install libpython2.7 libpython2.7-dev libz3-4 npm

Swift Toolchain

工具链选择

尽管你可以直接下载Swift Toolchain的源码自己编译，但目前最推荐的方式还是使用官方提供的已编译好的下载包进行安装。swift.org上提供了Ubuntu 16.04、Ubuntu 18.04、Ubuntu 20.04、CentOS 7、CentOS 8、Amazon Linux 2的下载包。其他的发行版本也多有自己的官方支持，比如Fodor、Red Hat Enterprise Linux8、Raspbian OSi等

Swift在5.3版本后开始正式支持Linux平台，所以本文选择在Ubuntu 20.04上安装Swift 5.3.3 Release。

安装

在swift.org上查找对应发行版的Swift Toolchain下载地址

image-20210214092353715
$cd ~
$wget https://swift.org/builds/swift-5.3.3-release/ubuntu2004/swift-5.3.3-RELEASE/swift-5.3.3-RELEASE-ubuntu20.04.tar.gz

解压文件

$tar -xzf swift-5.3.3-RELEASE-ubuntu20.04.tar.gz

swift工具链将被解压在 ~/swift-5.3.3-RELEASE-ubuntu20.04目录中，将该目录移动到你习惯的路径，比如：

$sudo mv swift-5.3.3-RELEASE-ubuntu20.04 /usr/share/swift

请记住移动后的路径/usr/share/swift，该路径将在下面的配置中被多次使用到。

将swift bin的路径添加到环境中

$echo "export PATH=/usr/share/swift/usr/bin:$PATH" >> ~/.bash
$source .bash

至此，Swift已经在当前系统上安装好了

$swift --version
Swift version 5.3.3 (swift-5.3.3-RELEASE)
Target: x86_64-unknown-linux-gnu

运行第一段代码

创建hello.swift，内容为

#!/usr/bin/env swift
print("My first swift code")

$cd ~
$swift hello.swift
My first swift code

或者可以将swift代码当做script来执行

$chmod +755 hello.swift
$./hellow.swift
My first swift code

创建第一个Swift项目

Swift Package Manager (SPM) 是苹果推出的用于创建使用swift的库和可执行程序的工具。目前它已经是Swift Toolchain的一部分了。

创建可执行程序项目

$cd ~
$mdkir MyProject
$cd MyProject
$swift package init --type executable
Creating executable package: MyProject
Creating Package.swift
Creating README.md
Creating .gitignore
Creating Sources/
Creating Sources/MyProject/main.swift
Creating Tests/
Creating Tests/LinuxMain.swift
Creating Tests/MyProjectTests/
Creating Tests/MyProjectTests/MyProjectTests.swift
Creating Tests/MyProjectTests/XCTestManifests.swift

编译并运行该项目

~/MyProject$swift run
[4/4] Linking MyProject
Hello, world!

该项目在下面的配置中还将使用到。也可以直接使用vscode打开项目文件

~/MyProject$code .
image-20210214144908318

vscode对于Swift已经内置支持了代码高亮。

SourceKit-LSP

什么是LSP

LSP的全程是Language Sever Protocol，是微软提出的一项标准化协议，旨在统一开发工具与Lanuguage Server之间的通信。LSP为支持的语言提供了一套通用的功能集，包括：语法高亮、自动补全、定义跳转、查找引用等等。苹果公司从2018年开始为Swift社区提供了LSP的代码及支持。目前LSP已经被集成到了Swift的工具链中。

安装

尽管Swift ToolChain中已经集成了LSP，但是我们还是需要为vscode安装对应的插件并进行配置，才能在vscode中使用Swift的LSP功能。

由于Swift LSP插件没有被放置在vscode的插件市场中，我们还是需要从苹果的LSP Github站点上下载

$git clone https://github.com/apple/sourcekit-lsp.git

下载的文件包含全部LSP的代码和插件代码，我们只需安装插件代码。

$cd sourcekit-lsp/Editors/vscode/
$npm run createDevPackage
image-20210214151421778

编译成功的插件被放置在 ~/sourcekit-lsp/Editors/vscode/out目录中。

配置vscode

通过命令行将插件安装到vscode上

$cd ~/sourcekit-lsp/Editors/vscode/out
$code --install-extension sourcekit-lsp-vscode-dev.vsix

或者在vscode中选择该插件进行安装

image-20210214151923560

配置Settings

image-20210214154131957

由于lsp已经集成到了swift toolchain中，因此在我们安装toolchain时，它已经被安装到了/usr/share/swift/usr/bin的目录中，并且该目录也已经设置在环境的PATH中，因此通常无需指定绝对路径，vscode便可以使用swift的lsp功能。如果你自己单独下载了新版本的lsp，可以在settings.json中设置对应的路径。

"sourcekit-lsp.serverPath": "/usr/share/swift/usr/bin/sourcekit-lsp"

安装完成后，vscode便可支持代码自动补全、定义跳转等功能。

swift_in_linux_lsp_demo

LLDB

什么是LLDB

LLDB调试器是LLVM项目的调试器组件。它构建为一组可重用的组件，这些组件广泛使用LLVM中的现有库，例如Clang表达式解析器和LLVM反汇编程序。通过LLDB，让vscode拥有了对Swift代码进行调试的能力。

安装

由于Swift Toolchain当前已经集成了LLDB，因此我们无需对其进行安装，只需要安装vscode的lldb插件即可。

在vscode的插件市场中，安装CodeLLDB

image-20210214160313240

在settings.json中指定lldb的位置

"lldb.library": "/usr/share/swift/usr/lib/liblldb.so"

也可以在settings UI中设定

image-20210214170242254

调试配置文件

在vscode中用lldb对项目进行调试，需要在项目的.vscode目录中针对每个项目分别创建调试配置文件launch.json和tasks.json。

launch.json是vscode用于调试的配置文件，比如指定调试语言环境，指定调试类型等等。其作用和XCode中的target类似。在swift项目中，我们通常会设置两个configuration，一个用于调试程序，一个用于进行Unit testing。

$cd MyProject
$code .

在第一次点击左侧的run按钮时，vscode会提示创建launch.json文件，我们也可以自己手动在.vscode目录中创建该文件。

image-20210214172254927

launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "lldb", 
            "request": "launch",
            "name": "Debug",
            "program": "${workspaceFolder}/.build/debug/MyProject",
            "args": [],
            "cwd": "${workspaceFolder}"，
            "preLaunchTask": "swift-build"
        },
        {
            "type": "lldb",
            "request": "launch",
            "name": "unit testing on Linux",
            "program": "./.build/debug/MyProjectPackageTests.xctest",
            "preLaunchTask": "swift-build-tests"
        }
    ]
}

  • type

    用于此启动配置的调试器的类型，swift调试需设置成lldb

  • request

    此启动配置的请求类型，swift调试需设置成launch，

  • name

    在调试启动配置下拉列表中的显示名称

  • program

    可执行文件的位置。使用swift build编译后（不加realase参数）的执行文件被放置在项目目录${workspaceFolder}/.build/debug/下，文件名通常为项目名称（本例为MyProject）；swift build -c release编译后的执行文件放置在${workspaceFolder}/.build/release/下，文件名为项目名称（本例为MyProject）;unit testing的可执行文件放置在${workspaceFolder}/.build/debug/，文件名通常为项目名称PackageTests.xctest（本例为MyProjectPackageTests.xctest）。请根据每个项目的名称、配置设定该项。

  • args

    传递给程序的参数。比如你的项目支持启动参数设定MyProject name hello，则args为["name","hello"]

  • cwd

    当前工作目录，用于查找依赖关系和其他文件

  • preLaunchTask

    要在调试会话开始之前启动的任务，每个任务都需要在tasks.json中有对应的设定。比如本例中，swift-build对应着tasks.json中的label:swift-build的task。对于swift项目，在调试前最常作的工作便是编译。

tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "swift-build",
            "type": "shell",
            "command":"swift build"
        },
        {
            "label": "swift-build-tests",
            "type": "process",
            "command": "swift",
            "args": [
                "build",
                "--build-tests"
            ]
        }
    ]
}

  • lable

    同launch.json中的preLaunchTask对应

  • type

    shell或process，为了更好的演示，本例中两种形式都采用了。

  • command

    如果type为process，commnad只能为需要执行命令的可执行文件名称（不可带参数），在本例中为swift,如果type为shell则可以在command中直接写上需要调用的参数，比如swift build

  • args

    对于type为process的情况，需要调用的参数在此填写。在本例中，swift-build-tests也可以写成

"label": "swift-build-tests",
"type": "shell",
"command": "swift build --build-tests"

launch.json和tasks.json还有很多其他的选项，更多的用法请参阅vscode手册以及SPM手册。

现在我们就可以开始对Swift项目进行调试了

第一次调试

$cd MyProject
$code .

随便给main.swift添加点内容，比如：

import Foundation
let a = 100
print("Hello, world!\(Int.random(in: 0...100))")
print("a:\(a)")
swift-in-linux-lldb-demo

SwiftFormat

为什么要对代码Foramt

许多项目都有固定的代码风格，统一的代码规范不仅有助于项目的迭代和维护，同时也让代码更加美观和易读。但并不是每个程序员都能够掌握并熟练使用项目风格约定。通过使用自动化工具完成上述工作是让人十分惬意的事情。

Swift社区中有多个Format项目，目前最活跃的有nicklockwood的swiftformat和Apple的swift-format。本例中，我们选择安装nicklockwood的swiftformat。两者的安装方法类似，相对来说swiftformat支持的规则更多，另外同Swift 的版本也不像swift-foramt那样需要严格绑定。

安装命令行工具

$cd ~
$git clone https://github.com/nicklockwood/SwiftFormat.git
$cd SwiftFormat
$swift build -c release
$sudo cp ~/SwiftFormat/.build/release/swiftformat /usr/local/bin
$swiftformat --version
0.47.11

安装vscode插件

swiftformat、swift-format以及swiftlint的vscode插件都是由Valentin Kabel开发的，他同时还管理、开发了其他及个vscode下的swift插件，为在vscode上更好的使用swift作出了不小的贡献。

在插件商店选择swiftformat对应的插件（注意不要选错）。

image-20210214211153478

在settings.json中添加

"swiftformat.path": "/usr/local/bin/swiftformat",
"swiftformat.configSearchPaths": [
        "./swiftformat",
        "~/.swiftformat"
        ]

swiftformat将从Swiftformat.configSearchPaths设定的路径中尝试查找用户自己创建的配置文件（.swiftformat），上面的配置为，如果当前目录没有，则从用户根目录上查找。如果都没有则使用默认配置和规则。

swift-in-linux-format-demo

swiftformat目前包含50多个规则，它的文档做的很好，可以在Rules.md中找到最新的规则列表及演示。需要注意的是，vscode目前无法正确的响应swiftformat自定义配置中的--indent，需要在vscode中对indent做单独的设定（我目前采用的是通过EditorConfig for VS Code做统一设置）。另外，如果通过swift.options:["--config","~/rules/.swiftformat"]指定的规则文件的优先级高于swiftformat.path中的规则文件。

SwiftLint

让代码更规范

在计算机科学中，lint是一种工具程序的名称，它用来标记源代码中，某些可疑的、不具结构性的段落。它是一种静态程序分析工具，最早适用于C语言，在UNIX平台上开发出来。后来它成为通用术语，可用于描述在任何一种计算机程序语言中，用来标记源代码中有疑义段落的工具。swift社区中，被使用的最广泛的就是realm开发的SwiftLint。

其实，上面的swiftformat、swift-format都具有lint的功能，并且和swiftlint在很多地方的规则都类似（都基于Github's Swift Style Guide），但各自的特点还是略有不同。

swiftformat更多的表现在对代码的自动修改上，而swiftlint由于直接hook了Clang和Sourcekit，因此提供了swiftformat所不具备的，代码录入阶段的实时验证和提示功能（通常并不使用它的autocorrect）。

安装命令行工具

$git clone https://github.com/realm/SwiftLint.git
$cd SwiftLint
$swift build -c release
$sudo cp ~/SwiftLint/.build/release/swiftlint /usr/local/bin
$swiftlint --version
0.42.0

安装vscode插件

在vscode插件市场中安装swiftlint插件

image-20210215073043096

在settings.json中添加

"swiftlint.path": "/usr/local/bin/swiftlint"，
"swiftlint.toolchainPath": "/usr/share/swift/usr/bin",
"swiftlint.configSearchPaths": [
        "./.swiftlint.yml",
        "~/.swiftlint.yml"
    ]

configSearchPath的设置同swiftformat类似，如果不需要自定义配置，则无需填写。

swift-in-linux-lint-demo

跨平台配置

我们已经在Ubuntu 20.04上构建了一个较完整的Swift开发环境。

settings

如果你也像我一样使用了vscode的setting同步功能，那么在其他的平台（比如mac），上述的settings.json将无法正常使用。

为了让我们构建的开发环境适应多平台，需要启用配置的多平台支持，并且针对不同平台分别设定。

安装platform-settins插件

image-20210215091440441

修改settings.json

当前为：

{
    "sourcekit-lsp.serverPath": "/usr/share/swift/usr/bin/sourcekit-lsp",
    "lldb.library": "/usr/share/swift/usr/lib/liblldb.so",
    "swiftformat.path": "/usr/local/bin/swiftformat",
    "swiftformat.configSearchPaths": [
        "./swiftformat",
        "~/.swiftformat"
    ],
    "swiftlint.path": "/usr/local/bin/swiftlint",
    "swiftlint.toolchainPath": "/usr/share/swift/usr/bin",
    "swiftlint.configSearchPaths": [
        "./.swiftlint.yml",
        "~/.swiftlint.yml"
    ]
}

修改为：

{
    "platformSettings.autoLoad": true,
    "platformSettings.platforms": {
        "linux":{
            "sourcekit-lsp.serverPath": "/usr/share/swift/usr/bin/sourcekit-lsp",
            "lldb.library": "/usr/share/swift/usr/lib/liblldb.so",
            "swiftformat.path": "/usr/local/bin/swiftformat",
            "swiftlint.path": "/usr/local/bin/swiftlint",
            "swiftlint.toolchainPath": "/usr/share/swift/usr/bin",
        },
        "Mac":{
            "sourcekit-lsp.serverPath": "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/sourcekit-lsp",
            "lldb.library": "/Applications/Xcode.app/Contents/SharedFrameworks/LLDB.framework/Versions/A/LLDB",
            "swiftformat.path": "/usr/local/bin/swiftformat", //homebrew目前也恰巧安装在此
            "swiftlint.path": "/usr/local/bin/swiftlint", //指向工具的实际路径
            "swiftlint.toolchainPath": "/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin",
        }
    
    },
    "swiftformat.configSearchPaths": [
        "./swiftformat",
        "~/.swiftformat"
    ],
    "swiftlint.configSearchPaths": [
        "./.swiftlint.yml",
        "~/.swiftlint.yml"
    ]
}

launch.json

在mac平台下，unit testing的调用方式也和linux下不同，因此需要在launch.json中添加一个configuration，由于使用同一个preLauchchTask，因此tasks.json不用改动。

       {
            "type": "lldb",
            "request": "launch",
            "name": "Debug tests on macOS",
            "program": "/Applications/Xcode.app/Contents/Developer/usr/bin/xctest", //For example /Applications/Xcode.app/Contents/Developer/usr/bin/xctest
            "args": [
                "${workspaceFolder}/.build/debug/MyProjectPackageTests.xctest"
            ],
            "preLaunchTask": "swift-build-tests"
        },
image-20210215092656451

在不同的平台上，选择对应的target即可。

结语

希望本文能够帮助更多的朋友在Linux上使用Swift进行开发。

我的个人博客肘子的Swift记事本中会有更多关于Swift、SwiftUI、CoreData的内容。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 202,802评论 5赞 476
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,109评论 2赞 379
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 149,683评论 0赞 335
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,458评论 1赞 273
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,452评论 5赞 364
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,505评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,901评论 3赞 395
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,550评论 0赞 256
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,763评论 1赞 296
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,556评论 2赞 319
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,629评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,330评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,898评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,897评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,140评论 1赞 259
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 42,807评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,339评论 2赞 342