Skip to content

Update swiftly install pages #887

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Feb 3, 2025
Merged

Update swiftly install pages #887

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8ab6e1b
Tweak wording, replace mac package option with Swiftly
Feb 3, 2025
8a369ff
Wording tweaks for Linux, raise Docker prominence.
Feb 3, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions _includes/install/_linux_platforms_tabs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
## Toolchain Installer
<ul class="grid-level-0">
## Latest Release
<ul class="grid-level-0 grid-layout-2-column">
<li class="grid-level-1 featured">
<h3>Swiftly (beta)</h3>
<h3>Swiftly (recommended)</h3>
<p class="description">
Command line tool for installing, managing, and switching between Swift.org toolchains.
The Swiftly installer manages Swift and its dependencies. It supports switching between different versions and downloading updates.
</p>
<!-- <br>
<p>To install swiftly, run the following commands in your terminal.</p>
Expand All @@ -15,6 +15,14 @@
<a href="https://download.swift.org/swiftly/linux/swiftly-0.4.0-dev-x86_64.tar.gz" class="cta-secondary">Download</a>
<a href="/install/linux/swiftly" class="cta-secondary">Instructions</a>
</li>
<li class="grid-level-1">
<h3>Docker</h3>
<p class="description">
If you prefer a containerized environment, you can download the official Docker images for compiling and running Swift on a variety of distributions.
</p>
<a href="https://hub.docker.com/_/swift" class="cta-secondary external">Docker Hub</a>
<a href="/install/linux/docker" class="cta-secondary">Instructions</a>
</li>
</ul>

## Alternate installation options
Expand Down
42 changes: 18 additions & 24 deletions install/macos/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,44 +5,36 @@ title: Install Swift

{% include install/_os_tabs.md macos="true" %}

## Toolchain Installer
<ul class="grid-level-0">
<li class="grid-level-1 featured">
<h3>Swiftly (beta)</h3>
<p class="description">
Command line tool for installing, managing, and switching between Swift.org toolchains.
</p>
<!-- <br>
<p>To install swiftly, run the following command in your terminal.</p>
<pre><code>
SWIFTLY_FILENAME=swiftly-0.4.0-dev.pkg
curl -O -s "https://download.swift.org/swiftly/darwin/$SWIFTLY_FILENAME" && installer -pkg "$SWIFTLY_FILENAME" -target CurrentUserHomeDirectory && ~/usr/local/bin/swiftly init
</code></pre> -->
<a href="https://download.swift.org/swiftly/darwin/swiftly-0.4.0-dev.pkg" class="cta-secondary">Download</a>
<a href="/install/macos/swiftly" class="cta-secondary">Instructions</a>
</li>
</ul>

## Latest Release (Swift {{ site.data.builds.swift_releases.last.name }})
## Latest Release
<ul class="grid-level-0 grid-layout-2-column">
<li class="grid-level-1">
<h3>Xcode</h3>
<p class="description">
Download the latest version of Xcode, which is regularly refreshed with the latest Swift toolchain.
To develop with Swift for Apple platforms, download the latest version of Xcode, which is regularly refreshed with the latest Swift toolchain.
</p>
<a href="https://developer.apple.com/xcode/" class="cta-secondary external">Install Xcode</a>
</li>
<li class="grid-level-1 featured">
<h3>Swiftly</h3>
<p class="description">
To download toolchains from Swift.org, use the Swiftly toolchain installer. Swift.org toolchains include experimental features like Embedded Swift and support for WebAssembly.
</p>
<a href="https://download.swift.org/macos/swiftly.pkg" class="cta-secondary">Download</a>
<a href="/install/macos/swiftly" class="cta-secondary">Instructions</a>
</li>
</ul>


## Other Install Options
<ul class="grid-level-0 grid-layout-2-column">
<li class="grid-level-1">
<h3>Package Installer</h3>
<p class="description">
Toolchain package installer (.pkg)
The toolchain package installer (.pkg) that Swiftly automates is available as a stand-alone download.
</p>
<a href="https://download.swift.org/{{ site.data.builds.swift_releases.last.tag | downcase }}/xcode/{{ site.data.builds.swift_releases.last.tag }}/{{ site.data.builds.swift_releases.last.tag }}-osx.pkg" class="cta-secondary">Download Toolchain</a>
<a href="/install/macos/package_installer" class="cta-secondary">Instructions</a>
</li>
</ul>

<ul class="grid-level-0">
{% include install/_static_sdk_release.md %}
</ul>

Expand All @@ -57,6 +49,8 @@ title: Install Swift

Swift snapshots are prebuilt binaries that are automatically created from the branch. These snapshots are not official releases. They have gone through automated unit testing, but they have not gone through the full testing that is performed for official releases.

The easiest way to install development snapshots is with the Swiftly tool. Read more on the [instructions page](/install/macos/swiftly).

{% assign xcode_dev_builds = site.data.builds.development.xcode | sort: 'date' | reverse %}
{% assign xcode_6_1_builds = site.data.builds.swift-6_1-branch.xcode | sort: 'date' | reverse %}

Expand Down