Skip to content
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.

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

Flutter SDK includes the full Dart SDK, as of 1.20 #2529

Merged
merged 2 commits into from
Jul 17, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
8 changes: 7 additions & 1 deletion src/_includes/get-sdk.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
Once you’re ready to move beyond DartPad and develop real apps,
you need the Dart SDK.
you need an SDK.
You can either download the Dart SDK directly
(as described below)
or [download the Flutter SDK,][]
which (as of Flutter 1.20) includes the Dart SDK.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This surprises me. I thought it was as of 1.17.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@kevmoo can you confirm the first version of Flutter that includes the full Dart SDK?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is new to me, too! @timsneath ?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically, the full Dart SDK isn't in the Flutter SDK even in 1.20, since dart2native (e.g.) isn't in the Flutter SDK. Its functionality will be available when the expanded dart command is available, which looks like it'll be 1.21. I'm going to create a PR to undo the work of this PR.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For now, I'm just changing 1.20 to 1.21. I hope that isn't too confusing. #2562


[download the Flutter SDK,]: {{site.flutter}}/docs/get-started/install

<ul class="tabs__top-bar">
<li class="tab-link current" data-tab="tab-sdk-install-windows">Windows</li>
Expand Down
26 changes: 14 additions & 12 deletions src/get-dart.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,24 +6,26 @@ js:
defer: true
---

This page describes how to download the Dart SDK.
The Dart SDK has the libraries and command-line tools that you need to develop
Dart command-line, server, and non-Flutter web apps.
**To develop Flutter apps for any platform** —
including web and mobile apps —
then **instead of installing the Dart SDK,
[install Flutter.][flutter]**
For details, see the [Dart SDK overview](/tools/sdk).

{{site.alert.tip}}
If you want to create _both_ Flutter and command-line or server apps,
install both Flutter and the Dart SDK.
{{site.alert.end}}
**As of Flutter 1.20, the [Flutter SDK][flutter] includes the Dart SDK.**
So if you have Flutter installed,
you might not need to explicitly download the Dart SDK.
Consider downloading the Dart SDK if
any of the following are true:

To learn about the tools you can use for Dart development, see
the [Dart tools](/tools) page.
To learn about what's in the Dart SDK, see [Dart SDK overview](/tools/sdk).
* You don't use Flutter.
* You use a pre-1.20 version of Flutter.
* You want to reduce disk space requirements or download time,
and your use case doesn't require Flutter.
For example, you might have a continuous integration (CI)
setup that requires Dart but not Flutter.


## Install the Dart SDK {#install}
## Installing the Dart SDK {#install}

As the following instructions show,
you can use a package manager
Expand Down
10 changes: 8 additions & 2 deletions src/tools/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,19 +5,25 @@ description: The tools that support the Dart language.

When you're ready to create an app,
get the SDK and tools for your app type.
If you aren't sure which tools you need, **get the Flutter SDK.**

<div class="table-wrapper" markdown="1">
|------------+-----------------------------------+--------------------------|
| App type | Get started instructions | Tool information |
|------------|-----------------------------------|--------------------------|
| Mobile | [Install Flutter]({{site.flutter}}/setup) | [Flutter tools]({{site.flutter}}/using-ide) |
| Web | [Install the Dart SDK](/tools/sdk) | [General-purpose tools][] and [web tools](#web) |
| Flutter (mobile and more) | [Install Flutter]({{site.flutter}}/setup) | [Flutter tools]({{site.flutter}}/using-ide) |
| Web app (non-Flutter) | [Install the Dart SDK](/tools/sdk) | [General-purpose tools][] and [web tools](#web) |
| Server or command line | [Install the Dart SDK](/tools/sdk) | [General-purpose tools][] and [specialized tools](#server) |
{:.table .table-striped}
</div>

[General-purpose tools]: #general-purpose-tools

{{site.alert.version-note}}
As of Flutter 1.20, the Flutter SDK includes the Dart SDK.
{{site.alert.end}}


## General-purpose tools

The following tools support the Dart language on all platforms.
Expand Down
5 changes: 5 additions & 0 deletions src/tools/jetbrains-plugin.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,8 +50,13 @@ Install a JetBrains IDE if you don't already have one.

If you don't already have the Dart SDK,
install it.
You can get it either by itself or by downloading the Flutter SDK,
which (as of Flutter 1.20) includes the Dart SDK.

Choose one:

* [Download the Dart SDK](/get-dart)
* [Download the Flutter SDK]({{site.flutter}}/docs/get-started/install)


### Configuring Dart support
Expand Down
8 changes: 4 additions & 4 deletions src/tools/sdk/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,15 @@ js:

The Dart SDK has the libraries and command-line tools that you need to develop
Dart web, command-line, and server apps. To get the Dart SDK, see [Get Dart](/get-dart).

If you're developing only mobile apps,
If you're developing Flutter apps,
then you don't need the Dart SDK; just [install Flutter.][flutter]

To learn about other tools you can use for Dart development, see
the [Dart tools](/tools) page.

<aside class="alert alert-info" markdown="1">
**Note:** This site's documentation and examples use
{{site.alert.version-note}}
As of Flutter 1.20, the Flutter SDK includes the Dart SDK.
This site's documentation and examples use
{% if site.data.pkg-vers.SDK.channel == 'dev' %} the **dev channel** {% endif -%}
version [{{site.data.pkg-vers.SDK.vers}}][site SDK version]{:.no-automatic-external}
of the **Dart SDK**.
Expand Down