Getting Started¶
Once you’ve installed swiftenv you can get started by checking which existing versions of Swift you have installed.
$ swiftenv versions
2.2.1
2.3
* 3.0 (set by /Users/kyle/.swiftenv/version)
NOTE: swiftenv will automatically pick up any versions of Swift installed on macOS by Xcode or Swift toolchains.
Installing Swift¶
You can install swift using swiftenv install
.
$ swiftenv install 3.0
Listing all versions¶
You can list all versions of Swift:
$ swiftenv install --list
You can also list all binary snapshots of Swift that you can install.
$ swiftenv install --list-snapshots
Switching Swift Versions¶
swiftenv allows you to switch between the installed Swift versions either globally or locally. You can configure a global Swift version that is used by default unless overridden.
Global Version¶
You can check the current global Swift version using swiftenv global
.
$ swiftenv global
3.0
To change the global version:
$ swiftenv global 2.2.1
Local Version¶
You can override the global version within any project using a
.swift-version
file. A Swift version file will indicate the version
to be used.
Setting the local Swift version:
$ swiftenv local 3.0
Now, when you’re inside the current directory, the Swift version will be automatically changed to the local version.
$ swiftenv version
2.2.1 (set by /Users/kyle/Projects/kylef/Curassow/.swift-version)
When you switch to another directory without a .swift-version
file, the
global version will be used.
$ swiftenv version
3.0 (set by /Users/kyle/.swiftenv/version)