Skip to content

Commit

Permalink
Merge pull request #499 from 2bndy5/app-store-is-snap-pkg
Browse files Browse the repository at this point in the history
docs: warn about flutter snap package
  • Loading branch information
temeddix authored Jan 18, 2025
2 parents df301c3 + 1ce3c7a commit 545b0e4
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 3 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -33,5 +33,6 @@ target/

# Others
*.lock
.python-version
/documentation/site/
.python-version
/documentation/*.egg-info/
12 changes: 10 additions & 2 deletions documentation/docs/installing-components.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,20 @@
# Installing Components

To get started, you need to have [Flutter SDK](https://docs.flutter.dev/get-started/install)[^1] and [Rust toolchain](https://www.rust-lang.org/tools/install) installed on your system.
[flutter-install-steps]: https://docs.flutter.dev/get-started/install

[^1]: If you're working on Linux, do not install Flutter from `snap`. Flutter from `snap` comes with its own binary linker called `ld`, which is fundamentally incompatible with Rust. Instead, follow the manual installation method as written in the Flutter docs.
To get started, you need to have [Flutter SDK][flutter-install-steps] and [Rust toolchain](https://www.rust-lang.org/tools/install) installed on your system.

Once you're done with the installations, verify your system's readiness with the following commands. Make sure you have installed all the subcomponents that Flutter suggests. If there are no issues in the output, you are good to go onto the next step!

```shell title="CLI"
rustc --version
flutter doctor
```

!!! warning

If you're working on Linux, it is recommended to install Flutter manually. Do not install Flutter from `snap`.

Flutter from `snap` comes with its own binary linker called `ld`, which is fundamentally incompatible with Rust. Instead, follow the [manual installation steps per the Flutter docs][flutter-install-steps].

Typically, the Flutter SDK package found in Debian-based Linux distributions' app store (under the name "Flutter") is a `snap` package.

0 comments on commit 545b0e4

Please sign in to comment.