Skip to content

Commit fdf5bdc

Browse files
atsansoneTony Sansone
atsansone
authored and
Tony Sansone
committed
Updated supported platform language (dart-lang#5497)
Fixes dart-lang#5496 Fixes dart-lang#4414 Fixes dart-lang#5499
1 parent af34879 commit fdf5bdc

File tree

7 files changed

+367
-173
lines changed

7 files changed

+367
-173
lines changed

‎src/_data/macos.json

+107
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
[
2+
{
3+
"cycle":"14",
4+
"codename":"Sonoma",
5+
"releaseDate":"2023-09-26",
6+
"eol":false,
7+
"latest":"14.2.1",
8+
"latestReleaseDate":"2023-12-19",
9+
"link":"https://support.apple.com/HT213895",
10+
"lts":false
11+
},
12+
{
13+
"cycle":"13",
14+
"codename":"Ventura",
15+
"releaseDate":"2022-10-24",
16+
"eol":false,
17+
"latest":"13.6.3",
18+
"latestReleaseDate":"2023-12-11",
19+
"link":"https://support.apple.com/HT213268",
20+
"lts":false
21+
},
22+
{
23+
"cycle":"12",
24+
"codename":"Monterey",
25+
"releaseDate":"2021-10-25",
26+
"eol":false,
27+
"latest":"12.7.2",
28+
"latestReleaseDate":"2023-12-11",
29+
"link":"https://support.apple.com/HT212585",
30+
"lts":false
31+
},
32+
{
33+
"cycle":"11",
34+
"codename":"Big Sur",
35+
"releaseDate":"2020-11-12",
36+
"eol":"2023-09-26",
37+
"latest":"11.7.10",
38+
"latestReleaseDate":"2023-09-11",
39+
"link":"https://support.apple.com/HT211896",
40+
"lts":false
41+
},
42+
{
43+
"cycle":"10.15",
44+
"codename":"Catalina",
45+
"releaseDate":"2019-10-07",
46+
"eol":"2022-09-12",
47+
"latest":"10.15.7",
48+
"latestReleaseDate":"2020-09-24",
49+
"link":"https://support.apple.com/HT210642",
50+
"lts":false
51+
},
52+
{
53+
"cycle":"10.14",
54+
"codename":"Mojave",
55+
"releaseDate":"2018-09-24",
56+
"eol":"2021-10-25",
57+
"latest":"10.14.6",
58+
"latestReleaseDate":"2019-07-22",
59+
"lts":false
60+
},
61+
{
62+
"cycle":"10.13",
63+
"codename":"High Sierra",
64+
"releaseDate":"2017-09-25",
65+
"eol":"2020-12-01",
66+
"latest":"10.13.6",
67+
"latestReleaseDate":"2018-07-09",
68+
"lts":false
69+
},
70+
{
71+
"cycle":"10.12",
72+
"codename":"Sierra",
73+
"releaseDate":"2016-09-20",
74+
"eol":"2019-10-01",
75+
"latest":"10.12.6",
76+
"latestReleaseDate":"2017-07-19",
77+
"lts":false
78+
},
79+
{
80+
"cycle":"10.11",
81+
"codename":"El Capitan",
82+
"releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
83+
"releaseDate":"2015-09-30",
84+
"eol":"2018-12-01",
85+
"latest":"10.11.6",
86+
"latestReleaseDate":"2016-07-18",
87+
"lts":false
88+
},
89+
{
90+
"cycle":"10.10",
91+
"releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
92+
"codename":"Yosemite",
93+
"releaseDate":"2014-10-16",
94+
"eol":"2017-08-01",
95+
"latest":"10.10.5",
96+
"latestReleaseDate":"2015-08-13",
97+
"lts":false
98+
},
99+
{
100+
"cycle":"10.9",
101+
"releaseLabel":"OS X __RELEASE_CYCLE__ (__CODENAME__)",
102+
"codename":"Mavericks",
103+
"releaseDate":"2013-10-22",
104+
"eol":"2016-12-01",
105+
"latest":"10.9.5",
106+
"latestReleaseDate":"2014-09-17",
107+
"lts":false}]

‎src/_sass/_site.scss

+25-3
Original file line numberDiff line numberDiff line change
@@ -513,7 +513,12 @@ thead:has(th:empty) {
513513
border-radius: 0;
514514
color: $site-color-body;
515515
margin-top: 1rem;
516-
padding: 1.25rem;
516+
padding: 1.5rem;
517+
518+
i.material-icons {
519+
font-size: 1.25em;
520+
user-select: none;
521+
}
517522

518523
.alert-header {
519524
display: flex;
@@ -537,7 +542,11 @@ thead:has(th:empty) {
537542
background-color: transparent;
538543
}
539544

540-
p:last-child {
545+
pre {
546+
background-color: #00000010;
547+
}
548+
549+
p:last-child, li:last-child, ul:last-child, ol:last-child {
541550
margin-bottom: 0;
542551
}
543552

@@ -858,4 +867,17 @@ body.obsolete {
858867

859868
dd {
860869
margin-left: 1rem;
861-
}
870+
}
871+
872+
/* -----------------------------------------
873+
Headings in boxes
874+
----------------------------------------- */
875+
876+
div h1:first-child,
877+
div h2:first-child,
878+
div h3:first-child,
879+
div h4:first-child,
880+
div h5:first-child,
881+
div h6:first-child {
882+
margin-top: 0rem;
883+
}

‎src/content/get-dart/_linux.md

+42-18
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,53 @@
1-
If you're using Debian/Ubuntu on AMD64 (64-bit Intel), you can choose one of the
2-
following options, both of which can update the SDK automatically when new
3-
versions are released.
41

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

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

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

12-
```console
13-
$ sudo apt-get update
14-
$ sudo apt-get install apt-transport-https
15-
$ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
16-
$ 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
17-
```
9+
#### Install using `apt-get` {:.no_toc}
10+
11+
Perform the following steps for the first install only.
12+
13+
1. Update the package index files and install the secure HTTP package.
14+
15+
```console
16+
$ sudo apt-get update && sudo apt-get install apt-transport-https
17+
```
18+
19+
1. Download and add the Google Linux GPG public key.
20+
21+
```console
22+
$ wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
23+
```
24+
25+
1. Add the Dart package repository to your Linux system.
1826

19-
Then install the Dart SDK:
27+
```console
28+
$ 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
29+
```
30+
31+
Install the Dart SDK using [`sudo`][sudo].
2032

2133
```console
22-
$ sudo apt-get update
23-
$ sudo apt-get install dart
34+
$ sudo apt-get update && sudo apt-get install dart
2435
```
2536

2637
#### Install a Debian package
2738

28-
Alternatively, download Dart SDK [as a Debian package](#){:.debian-link-stable}
29-
in the `.deb` package format.
39+
To install the Dart SDK as a Debian package (`*.deb`).
40+
41+
1. Download the Dart SDK as a [Debian package](#){:.debian-link-stable}.
42+
43+
1. Install the `*.deb` package using one of two methods:
44+
45+
* From a GUI, double-click the `.deb` file.
46+
47+
* From a terminal, run the following command:
48+
49+
```console
50+
$ sudo dpkg -i dart_3.2.6-1_amd64.deb
51+
```
52+
53+
[sudo]: https://www.sudo.ws/

‎src/content/get-dart/_mac.md

+46-24
Original file line numberDiff line numberDiff line change
@@ -1,42 +1,64 @@
1-
[Install Homebrew,](https://brew.sh)
2-
and then run the following commands:
31

4-
```console
5-
$ brew tap dart-lang/dart
6-
$ brew install dart
7-
```
2+
### Install using Homebrew {:.no_toc}
3+
4+
To install the Dart SDK, use [Homebrew][].
5+
6+
1. Install Homebrew if needed.
7+
8+
1. Add the [official tap][tap].
9+
10+
```console
11+
$ brew tap dart-lang/dart
12+
```
13+
14+
1. Install the Dart SDK.
15+
16+
```console
17+
$ brew install dart
18+
```
19+
20+
### Verify PATH includes Homebrew {:.no_toc}
21+
22+
Verify that your `PATH` includes the **Homebrew `bin` directory**.
23+
Setting up the correct path simplifies using Dart SDK commands
24+
such as `dart run` and `dart format`.
25+
To get help configuring your `PATH`, consult the [Homebrew FAQ][].
826

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

1729
To upgrade when a new release of Dart is available:
1830

1931
```console
2032
$ brew upgrade dart
2133
```
2234

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

27-
```console
28-
$ brew install dart@2.12
29-
```
37+
To switch between locally installed Dart releases:
3038

31-
Then to switch between versions,
32-
unlink the current version and link the desired version.
39+
1. Install the version to which you want to switch.
3340

34-
```console
35-
$ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>
36-
```
41+
For example, to install Dart 3.1:
42+
43+
```console
44+
$ brew install dart@3.1
45+
```
46+
47+
1. To switch between versions,
48+
unlink the current version and link the desired version.
49+
50+
```console
51+
$ brew unlink dart@<old> && brew unlink dart@<new> && brew link dart@<new>
52+
```
53+
54+
### List installed Dart versions {:.no_toc}
3755

3856
To see which versions of Dart you've installed:
3957

4058
```console
4159
$ brew info dart
4260
```
61+
62+
[Homebrew]: https://brew.sh
63+
[tap]: {{site.gh-dart.org}}/homebrew-dart
64+
[Homebrew FAQ]: https://docs.brew.sh/FAQ#my-mac-apps-dont-find-homebrew-utilities

‎src/content/get-dart/_windows.md

+26-18
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,31 @@
1-
You can install the Dart SDK using [Chocolatey.][Chocolatey]
21

3-
:::important
4-
These commands require administrator rights.
5-
Here's one way to open a Command Prompt window
6-
that has admin rights:
2+
### Install using Chocolatey {:.no_toc}
73

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

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

159
```ps
1610
C:\> choco install dart-sdk
1711
```
1812

19-
To upgrade the Dart SDK:
13+
### Change default install path {:.no_toc}
14+
15+
By default, Chocolatey installs the SDK at `C:\tools\dart-sdk`.
16+
To change that location, set the [`ChocolateyToolsLocation`][]
17+
environment variable to your desired installation directory.
18+
19+
### Verify your PATH includes Dart {:.no_toc}
20+
21+
Verify you can run Dart.
2022

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

25-
By default, the SDK is installed at `C:\tools\dart-sdk`.
26-
You can change that location by setting
27-
the [`ChocolateyToolsLocation`][] environment variable
28-
to your chosen installation directory.
29-
30-
If you can't use the Dart SDK executables,
28+
If your development machine doesn't return a Dart version,
3129
add the SDK location to your PATH:
3230

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

39+
### Upgrade using Chocolatey {:.no_toc}
40+
41+
To upgrade the Dart SDK:
42+
43+
```ps
44+
C:\> choco upgrade dart-sdk
45+
```
46+
47+
[elevated permissions]: https://www.thewindowsclub.com/elevated-privileges-windows
48+
[command prompt]: https://www.thewindowsclub.com/how-to-run-command-prompt-as-an-administrator
4149
[Chocolatey]: https://chocolatey.org
4250
[`ChocolateyToolsLocation`]: https://stackoverflow.com/questions/19752533/how-do-i-set-chocolatey-to-install-applications-onto-another-drive/68314437#68314437

0 commit comments

Comments
 (0)