Skip to content

Commit

Permalink
Updated supported platform language (dart-lang#5497)
Browse files Browse the repository at this point in the history
  • Loading branch information
atsansone authored and Tony Sansone committed Feb 20, 2024
1 parent 81b053f commit 78f5ec7
Show file tree
Hide file tree
Showing 7 changed files with 367 additions and 173 deletions.
107 changes: 107 additions & 0 deletions src/_data/macos.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
[
{
"cycle":"14",
"codename":"Sonoma",
"releaseDate":"2023-09-26",
"eol":false,
"latest":"14.2.1",
"latestReleaseDate":"2023-12-19",
"link":"https://support.apple.com/HT213895",
"lts":false
},
{
"cycle":"13",
"codename":"Ventura",
"releaseDate":"2022-10-24",
"eol":false,
"latest":"13.6.3",
"latestReleaseDate":"2023-12-11",
"link":"https://support.apple.com/HT213268",
"lts":false
},
{
"cycle":"12",
"codename":"Monterey",
"releaseDate":"2021-10-25",
"eol":false,
"latest":"12.7.2",
"latestReleaseDate":"2023-12-11",
"link":"https://support.apple.com/HT212585",
"lts":false
},
{
"cycle":"11",
"codename":"Big Sur",
"releaseDate":"2020-11-12",
"eol":"2023-09-26",
"latest":"11.7.10",
"latestReleaseDate":"2023-09-11",
"link":"https://support.apple.com/HT211896",
"lts":false
},
{
"cycle":"10.15",
"codename":"Catalina",
"releaseDate":"2019-10-07",
"eol":"2022-09-12",
"latest":"10.15.7",
"latestReleaseDate":"2020-09-24",
"link":"https://support.apple.com/HT210642",
"lts":false
},
{
"cycle":"10.14",
"codename":"Mojave",
"releaseDate":"2018-09-24",
"eol":"2021-10-25",
"latest":"10.14.6",
"latestReleaseDate":"2019-07-22",
"lts":false
},
{
"cycle":"10.13",
"codename":"High Sierra",
"releaseDate":"2017-09-25",
"eol":"2020-12-01",
"latest":"10.13.6",
"latestReleaseDate":"2018-07-09",
"lts":false
},
{
"cycle":"10.12",
"codename":"Sierra",
"releaseDate":"2016-09-20",
"eol":"2019-10-01",
"latest":"10.12.6",
"latestReleaseDate":"2017-07-19",
"lts":false
},
{
"cycle":"10.11",
"codename":"El Capitan",
"releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
"releaseDate":"2015-09-30",
"eol":"2018-12-01",
"latest":"10.11.6",
"latestReleaseDate":"2016-07-18",
"lts":false
},
{
"cycle":"10.10",
"releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
"codename":"Yosemite",
"releaseDate":"2014-10-16",
"eol":"2017-08-01",
"latest":"10.10.5",
"latestReleaseDate":"2015-08-13",
"lts":false
},
{
"cycle":"10.9",
"releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
"codename":"Mavericks",
"releaseDate":"2013-10-22",
"eol":"2016-12-01",
"latest":"10.9.5",
"latestReleaseDate":"2014-09-17",
"lts":false}]
28 changes: 25 additions & 3 deletions src/_sass/_site.scss
Original file line number Diff line number Diff line change
Expand Up @@ -513,7 +513,12 @@ thead:has(th:empty) {
border-radius: 0;
color: $site-color-body;
margin-top: 1rem;
padding: 1.25rem;
padding: 1.5rem;

i.material-icons {
font-size: 1.25em;
user-select: none;
}

.alert-header {
display: flex;
Expand All @@ -537,7 +542,11 @@ thead:has(th:empty) {
background-color: transparent;
}

p:last-child {
pre {
background-color: #00000010;
}

p:last-child, li:last-child, ul:last-child, ol:last-child {
margin-bottom: 0;
}

Expand Down Expand Up @@ -858,4 +867,17 @@ body.obsolete {

dd {
margin-left: 1rem;
}
}

/* -----------------------------------------
Headings in boxes
----------------------------------------- */

div h1:first-child,
div h2:first-child,
div h3:first-child,
div h4:first-child,
div h5:first-child,
div h6:first-child {
margin-top: 0rem;
}
60 changes: 42 additions & 18 deletions src/content/get-dart/_linux.md
Original file line number Diff line number Diff line change
@@ -1,29 +1,53 @@
If you're using Debian/Ubuntu on AMD64 (64-bit Intel), you can choose one of the
following options, both of which can update the SDK automatically when new
versions are released.

* [Install using apt-get](#install-using-apt-get)
* [Install a Debian package](#install-a-debian-package)
### Install using package manager {:.no_toc}

#### Install using apt-get
Choose to install either using [apt-get](#install-using-apt-get)
or downloading a [`.deb`](#install-a-debian-package) package.

Perform the following **one-time setup**:
Both methods trigger an SDK update whenever Dart releases a new version.

```console
$ sudo apt-get update
$ sudo apt-get install apt-transport-https
$ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
$ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list
```
#### Install using `apt-get` {:.no_toc}

Perform the following steps for the first install only.

1. Update the package index files and install the secure HTTP package.

```console
$ sudo apt-get update && sudo apt-get install apt-transport-https
```

1. Download and add the Google Linux GPG public key.

```console
$ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
```

1. Add the Dart package repository to your Linux system.

Then install the Dart SDK:
```console
$ echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list
```

Install the Dart SDK using [`sudo`][sudo].

```console
$ sudo apt-get update
$ sudo apt-get install dart
$ sudo apt-get update && sudo apt-get install dart
```

#### Install a Debian package

Alternatively, download Dart SDK [as a Debian package](#){:.debian-link-stable}
in the `.deb` package format.
To install the Dart SDK as a Debian package (`*.deb`).

1. Download the Dart SDK as a [Debian package](#){:.debian-link-stable}.

1. Install the `*.deb` package using one of two methods:

* From a GUI, double-click the `.deb` file.

* From a terminal, run the following command:

```console
$ sudo dpkg -i dart_3.2.6-1_amd64.deb
```

[sudo]: https://www.sudo.ws/
70 changes: 46 additions & 24 deletions src/content/get-dart/_mac.md
Original file line number Diff line number Diff line change
@@ -1,42 +1,64 @@
[Install Homebrew,](https://brew.sh)
and then run the following commands:

```console
$ brew tap dart-lang/dart
$ brew install dart
```
### Install using Homebrew {:.no_toc}

To install the Dart SDK, use [Homebrew][].

1. Install Homebrew if needed.

1. Add the [official tap][tap].

```console
$ brew tap dart-lang/dart
```

1. Install the Dart SDK.

```console
$ brew install dart
```

### Verify PATH includes Homebrew {:.no_toc}

Verify that your `PATH` includes the **Homebrew `bin` directory**.
Setting up the correct path simplifies using Dart SDK commands
such as `dart run` and `dart format`.
To get help configuring your `PATH`, consult the [Homebrew FAQ][].

:::important
Make sure the **Homebrew `bin` directory is in your `PATH`**.
Setting up the path correctly makes it easier to use Dart SDK commands
such as `dart run` and `dart format`.
For help configuring your path,
consult the [Homebrew FAQ.](https://docs.brew.sh/FAQ)
:::
### Upgrade using Homebrew {:.no_toc}

To upgrade when a new release of Dart is available:

```console
$ brew upgrade dart
```

To switch between locally installed Dart releases,
first install the version you want to switch to if you haven't.
For example, to install Dart 2.12:
### Switch Dart versions {:.no_toc}

```console
$ brew install dart@2.12
```
To switch between locally installed Dart releases:

Then to switch between versions,
unlink the current version and link the desired version.
1. Install the version to which you want to switch.

```console
$ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>
```
For example, to install Dart 3.1:

```console
$ brew install dart@3.1
```

1. To switch between versions,
unlink the current version and link the desired version.

```console
$ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>
```

### List installed Dart versions {:.no_toc}

To see which versions of Dart you've installed:

```console
$ brew info dart
```

[Homebrew]: https://brew.sh
[tap]: {{site.gh-dart.org}}/homebrew-dart
[Homebrew FAQ]: https://docs.brew.sh/FAQ#my-mac-apps-dont-find-homebrew-utilities
44 changes: 26 additions & 18 deletions src/content/get-dart/_windows.md
Original file line number Diff line number Diff line change
@@ -1,33 +1,31 @@
You can install the Dart SDK using [Chocolatey.][Chocolatey]

:::important
These commands require administrator rights.
Here's one way to open a Command Prompt window
that has admin rights:
### Install using Chocolatey {:.no_toc}

1. Press <kbd>Windows+R</kbd> to open the **Run** window.
2. Type `cmd` into the box.
3. Press <kbd>Ctrl+Shift+Enter</kbd>.
:::
To install the Dart SDK, use [Chocolatey][Chocolatey].
Chocolatey requires [elevated permissions].

To install the Dart SDK:
Install Chocolatey, then run a [command prompt] with elevated permissions.

```ps
C:\> choco install dart-sdk
```

To upgrade the Dart SDK:
### Change default install path {:.no_toc}

By default, Chocolatey installs the SDK at `C:\tools\dart-sdk`.
To change that location, set the [`ChocolateyToolsLocation`][]
environment variable to your desired installation directory.

### Verify your PATH includes Dart {:.no_toc}

Verify you can run Dart.

```ps
C:\> choco upgrade dart-sdk
C:\> dart --version
Dart SDK version: 3.2.4 (stable) (Thu Dec 21 19:13:53 2023 +0000) on "win_x64"
```

By default, the SDK is installed at `C:\tools\dart-sdk`.
You can change that location by setting
the [`ChocolateyToolsLocation`][] environment variable
to your chosen installation directory.

If you can't use the Dart SDK executables,
If your development machine doesn't return a Dart version,
add the SDK location to your PATH:

1. In the Windows search box, type `env`.
Expand All @@ -38,5 +36,15 @@ add the SDK location to your PATH:
6. In each window that you just opened,
click **Apply** or **OK** to dismiss it and apply the path change.

### Upgrade using Chocolatey {:.no_toc}

To upgrade the Dart SDK:

```ps
C:\> choco upgrade dart-sdk
```

[elevated permissions]: https://www.thewindowsclub.com/elevated-privileges-windows
[command prompt]: https://www.thewindowsclub.com/how-to-run-command-prompt-as-an-administrator
[Chocolatey]: https://chocolatey.org
[`ChocolateyToolsLocation`]: https://stackoverflow.com/questions/19752533/how-do-i-set-chocolatey-to-install-applications-onto-another-drive/68314437#68314437
Loading

0 comments on commit 78f5ec7

Please sign in to comment.