Another year of big changes. We moved again and bought our first home, a beautiful old American Foursquare in our old neighborhood. Astro was acquired by Slack in September, making it three straight years of September job changes. In November, we celebrated my daughter's 1st birthday, and parenting continues to be the most exhausting and rewarding part of my life. Here's the 2018 media that was the backdrop to my year1.
I read a lot of average tech-adjacent non-fiction in 2018, none of which is worth recommending here. Resolving to read more fiction in 2019.
All lists are alphabetical.↩︎
After reading Mattt's excellent NSHipster article on building the fledgling Swift Language Server Protocol project, I scrolled back up and stared at Step 0: Install Xcode. It didn't seem strictly necessary, based on what followed. And as I’m sure you’ve deduced by the title and existence of this post, it’s not. Below is a short step-by-step guide to building and running the Swift Language Server Protocol on linux1. The following instructions assume either a basic understanding of a unix-style command line and/or a willingness to copy and paste superuser commands from the internet into your terminal program of choice.
- Install VS Code by following these instructions: https://code.visualstudio.com/docs/setup/linux
- Make sure that you have all the necessary dependencies installed:
$ sudo apt install curl git clang libsqlite3-dev libblocksruntime-dev libncurses5-dev
- Download the recommended Swift development toolchain from swift.org or via the command line:
$ curl https://swift.org/builds/development/ubuntu1804/swift-DEVELOPMENT-SNAPSHOT-2018-12-07-a/swift-DEVELOPMENT-SNAPSHOT-2018-12-07-a-ubuntu18.04.tar.gz > ~/swift-DEVELOPMENT-SNAPSHOT-2018-12-07-a-ubuntu18.04.tar.gz
- Extract the toolchain and move it to
$ sudo tar xzf swift-DEVELOPMENT-SNAPSHOT-2018-12-07-a-ubunutu18.04.tar.gz -C /usr/local/bin
- Add Swift to your command line path:
Now, let’s run
$ export PATH=/usr/local/bin/swift-DEVELOPMENT-SNAPSHOT-2018-12-07-a-ubuntu18.04/usr/bin:
$ swift --version to make sure that we’ve downloaded and installed Swift correctly. You should see this output (or similar, depending on the version of the toolchain you installed):
Swift version 5.0-dev (LLVM b10ce3d642, Clang c1979d7668, Swift 94b167db75)
- Clone and build Apple’s sourcekit-lsp project:
$ git clone https://www.github.com/apple/sourcekit-lsp.git
$ cd sourcekit-lsp
$ swift build -Xcxx -I/usr/local/bin/swift-DEVELOPMENT-SNAPSHOT-2018-12-07-a-ubuntu18.04/usr/lib/swift
$ sudo mv .build/x86_64-unknown-linux/debug/sourcekit-lsp /usr/local/bin
$ sudo mv .build/x86_64-unknown-linux/debug/libSwiftPM.so /usr/local/bin
- Install Node.js 11.x or newer:
$ curl -sL https://deb.nodesource.com/setup_11.x | sudo -E bash -
$ sudo apt-get install -y nodejs
- Generate the extension for VS Code:
$ cd Editors/vscode
$ npm run createDevPackage
- Install the extension you just created:
$ code --install-extension out/sourcekit-lsp-vscode-dev.vsix
- Point sourcekit-lsp at your installed toolchain in VS Code’s settings (File > Preferences > Settings > settings.json):
- Reload your VS Code window (Control+Shift+P > Reload Window) or restart VS Code.
At this point, you’re all set up to use the Swift Language Server on linux. A few notes: you will see the most functionality for projects that have a
Package.swift file that have been pre-built with
Let’s clone and build a sample project so we can see it in action:
$ git clone https://www.github.com/JohnSundell/Splash.git
$ cd Splash
$ swift build
Finally, open the Splash folder in VSCode and try some of the following to see it in action:
- Hover over a
- Command+Click to jump to a definition
- Type some code and invoke autocomplete
There has been a lot of enthusiasm around the announcement of this project, and for good reason. It serves as yet another reinforcement of Apple’s broad goals for the Swift programming language, which seem to extend further beyond the friendly confines of their own platforms with each passing year.
Tested on Ubuntu 16.04 and 18.04. The commands below all specify the 18.04 versions where necessary.↩︎
From my home office, I can hear the pleased squeals and shrieks emanating from downstairs. A stampede of thumping knees across the floor, a high speed chase.
Two years ago, an infant came screaming into our lives.
One year ago, my daughter was born.
This morning, I walked out my front door — to cast a vote for her future.
The past year has been challenging and rewarding, both personally and professionally. As usual I read, wrote, listened, and played about 1% of everything I wanted to. Here’s some of what I did get to, and enjoyed enough to recommend to you1.
As usual, all lists are ordered alphabetically.↩︎
Back in June, I released a new major update to SlackKit, my Swift framework for building Slack apps. There were three big goals for this release — I wanted to make it universal, make it modular, and make it extensible.
Prior to the new release, there were two separate branches for SlackKit — one that targeted Apple’s platforms (iOS/macOS/tvOS), and one that targeted linux. Not only did this cause confusion for people trying to use the library, but it was also a maintenance headache trying to keep both branches in sync.
The progress made by the Foundation Project on swift-corelibs-foundation over the past year has made unification plausible. Key classes like
URLSession were implemented, and overall quality has greatly improved. Swift 3.1.1 is the first version of Swift where the Foundation frameworks have started to feel like a solid foundation on linux as well as on Apple’s platforms.
The trickiest part about going universal was wrangling SlackKit’s third-party dependencies. Most popular open source Swift projects today are focused on iOS or macOS and don’t support linux, so I needed to find alternatives where necessary.
In addition to being universal, SlackKit is now also modular so that if you don’t need everything that SlackKit offers, you can just pull in the parts you need. I ended up breaking it up into the following 5 modules:
- SKWebAPI - a wrapper for the Slack Web API
- SKRTMAPI - a web socket module for connecting to the Slack Real Time Messaging API
- SKServer - a server module for handling OAuth, slash commands, and more
- SKClient - a client module for tracking and managing client state
- SKCore - a core library for shared model objects
Finally, SlackKit is now designed to be extensible. This means that if you don’t like the defaults, it’s relatively easy to plug into SlackKit by conforming to the real-time messaging, server, or client protocols. The server-side Swift ecosystem is rich, varied, and growing — being extensible will help SlackKit grow and evolve along with that ecosystem.
I’m very pleased to have this release out the door, but there’s still lots left to do. If you’re interested in helping out, take a look at the project roadmap — contributions of all size are always welcome!