From e7c43ec5130f16a15b7ac48b1ff7e639da8a3171 Mon Sep 17 00:00:00 2001 From: sneurlax Date: Sat, 3 Jan 2026 19:24:43 -0600 Subject: [PATCH 1/7] fix: increase flutter version to 3.38.1 --- docs/building.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/building.md b/docs/building.md index 41df95be0..1693ecc39 100644 --- a/docs/building.md +++ b/docs/building.md @@ -77,7 +77,7 @@ pip3 install --upgrade meson==0.64.1 markdown==3.4.1 markupsafe==2.1.1 jinja2==3 ``` ### Flutter -Install Flutter 3.35.7 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk). You can also clone https://github.com/flutter/flutter, check out the `3.35.7` tag, and add its `flutter/bin` folder to your PATH as in +Install Flutter 3.38.1 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk). You can also clone https://github.com/flutter/flutter, check out the `3.35.7` tag, and add its `flutter/bin` folder to your PATH as in ```sh FLUTTER_DIR="$HOME/development/flutter" git clone https://github.com/flutter/flutter.git "$FLUTTER_DIR" @@ -293,13 +293,13 @@ If the DLLs were built on the WSL filesystem instead of on Windows, copy the res Frostdart will be built by the Windows host later. ### Install Flutter on Windows host -Install Flutter 3.35.7 on your Windows host (not in WSL2) by [following their guide](https://docs.flutter.dev/get-started/install/windows/desktop?tab=download#install-the-flutter-sdk) or by cloning https://github.com/flutter/flutter, checking out the `3.35.7` tag, and adding its `flutter/bin` folder to your PATH as in +Install Flutter 3.38.1 on your Windows host (not in WSL2) by [following their guide](https://docs.flutter.dev/get-started/install/windows/desktop?tab=download#install-the-flutter-sdk) or by cloning https://github.com/flutter/flutter, checking out the `3.38.1` tag, and adding its `flutter/bin` folder to your PATH as in ```bat @echo off set "FLUTTER_DIR=%USERPROFILE%\development\flutter" git clone https://github.com/flutter/flutter.git "%FLUTTER_DIR%" cd /d "%FLUTTER_DIR%" -git checkout 3.35.7 +git checkout 3.38.1 setx PATH "%PATH%;%FLUTTER_DIR%\bin" echo Flutter setup completed. Please restart your command prompt. ``` From 5af96915a816b1ea799ea5f32d0fdf8ad0c1fe6a Mon Sep 17 00:00:00 2001 From: sneurlax Date: Sat, 3 Jan 2026 19:10:17 -0600 Subject: [PATCH 2/7] fix: install flutter first or at least before the later android studio section mentions it --- docs/building.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/building.md b/docs/building.md index 1693ecc39..79a003fe9 100644 --- a/docs/building.md +++ b/docs/building.md @@ -13,6 +13,20 @@ Here you will find instructions on how to install the necessary tools for buildi The following instructions are for building and running on a Linux host. Alternatively, see the [Mac](#mac-host) and/or [Windows](#windows-host) section. This entire section (except for the Android Studio section) needs to be completed in WSL if building on a Windows host. +### Flutter +Install Flutter 3.38.1 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk). You can also clone https://github.com/flutter/flutter, check out the `3.35.7` tag, and add its `flutter/bin` folder to your PATH as in +```sh +FLUTTER_DIR="$HOME/development/flutter" +git clone https://github.com/flutter/flutter.git "$FLUTTER_DIR" +cd "$FLUTTER_DIR" +git checkout 3.35.7 +echo 'export PATH="$PATH:'"$FLUTTER_DIR"'/bin"' >> "$HOME/.profile" +source "$HOME/.profile" +flutter precache +``` + +Run `flutter doctor` in a terminal to confirm its installation. + ### Android Studio Install Android Studio. Follow instructions here [https://developer.android.com/studio/install#linux](https://developer.android.com/studio/install#linux) or install via snap: ``` @@ -76,20 +90,6 @@ sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev pip3 install --upgrade meson==0.64.1 markdown==3.4.1 markupsafe==2.1.1 jinja2==3.1.2 pygments==2.13.0 toml==0.10.2 typogrify==2.0.7 tomli==2.0.1 ``` -### Flutter -Install Flutter 3.38.1 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk). You can also clone https://github.com/flutter/flutter, check out the `3.35.7` tag, and add its `flutter/bin` folder to your PATH as in -```sh -FLUTTER_DIR="$HOME/development/flutter" -git clone https://github.com/flutter/flutter.git "$FLUTTER_DIR" -cd "$FLUTTER_DIR" -git checkout 3.35.7 -echo 'export PATH="$PATH:'"$FLUTTER_DIR"'/bin"' >> "$HOME/.profile" -source "$HOME/.profile" -flutter precache -``` - -Run `flutter doctor` in a terminal to confirm its installation. - ### Clone the repository and initialize submodules After installing the prerequisites listed above, download the code and init the submodules ``` From 9528f4be6208110cad19f4776267710b46ae9afb Mon Sep 17 00:00:00 2001 From: sneurlax Date: Sat, 3 Jan 2026 19:11:11 -0600 Subject: [PATCH 3/7] docs: document SDK Tools location --- docs/building.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/building.md b/docs/building.md index 79a003fe9..2d536ff96 100644 --- a/docs/building.md +++ b/docs/building.md @@ -35,7 +35,7 @@ sudo apt install -y openjdk-11-jdk sudo snap install android-studio --classic ``` -Use `Tools > SDK Manager` to install: +Use `Tools > SDK Manager` and navigate to `Languages & Frameworks > Android SDK > SDK tools` to install: - `SDK Tools > Android SDK command line tools` - `SDK Tools > CMake` and for Android builds, From f19c30c3284e09494210f335140e20e585e9903b Mon Sep 17 00:00:00 2001 From: sneurlax Date: Sat, 3 Jan 2026 19:22:23 -0600 Subject: [PATCH 4/7] docs: update rust toolchain. cargo-ndk requires 1.86 --- docs/building.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/building.md b/docs/building.md index 2d536ff96..2cd0a63b8 100644 --- a/docs/building.md +++ b/docs/building.md @@ -213,11 +213,11 @@ brew install brotli cairo coreutils gdbm gettext glib gmp libevent libidn2 libng ``` -Download and install [Rust](https://www.rust-lang.org/tools/install). [Rustup](https://rustup.rs/) is recommended for Rust setup. Use `rustc` to confirm successful installation. Install toolchains 1.81.0 and 1.85.1 and `cbindgen` and `cargo-lipo` too. You will also have to add the platform target(s) `aarch64-apple-ios` and/or `aarch64-apple-darwin`. You can use the command(s): +Download and install [Rust](https://www.rust-lang.org/tools/install). [Rustup](https://rustup.rs/) is recommended for Rust setup. Use `rustc` to confirm successful installation. Install toolchains 1.81.0, 1.85.1, and 1.86.0, as well as `cbindgen` and `cargo-lipo` too. You will also have to add the platform target(s) `aarch64-apple-ios` and/or `aarch64-apple-darwin`. You can use the command(s): ``` curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh source ~/.bashrc -rustup install 1.85.1 1.81.0 +rustup install 1.86.0 1.85.1 1.81.0 rustup default 1.85.1 cargo install cargo-ndk cargo install cbindgen cargo-lipo @@ -309,7 +309,7 @@ Run `flutter doctor` in PowerShell to confirm its installation. ### Rust Install [Rust](https://www.rust-lang.org/tools/install) on the Windows host (not in WSL2). Download the installer from [rustup.rs](https://rustup.rs), make sure it works on the commandline (you may need to open a new terminal), and install the following versions: ``` -rustup install 1.85.1 1.81.0 +rustup install 1.86.0 1.85.1 1.81.0 rustup default 1.85.1 cargo install cargo-ndk ``` From d85aca80adb8d2fc28aefd29ebfd6343472f4a34 Mon Sep 17 00:00:00 2001 From: sneurlax Date: Sat, 3 Jan 2026 19:22:50 -0600 Subject: [PATCH 5/7] docs: clarify that windows instructions in linux section are for wsl2 --- docs/building.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/building.md b/docs/building.md index 2cd0a63b8..983eed84e 100644 --- a/docs/building.md +++ b/docs/building.md @@ -158,6 +158,8 @@ cd scripts ``` #### Building plugins and configure for Windows +*This step is only necessary inside WSL2 for building on a Windows host.* + Install dependencies like MXE: ``` cd scripts/windows From e4b09d2ee7a7f57ac9881ec238697b2e69958b09 Mon Sep 17 00:00:00 2001 From: sneurlax Date: Sat, 3 Jan 2026 19:27:15 -0600 Subject: [PATCH 6/7] docs: update win docs re: wsl2; 20.04 -> 24.04 --- docs/building.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/building.md b/docs/building.md index 983eed84e..306ea1215 100644 --- a/docs/building.md +++ b/docs/building.md @@ -275,7 +275,7 @@ flutter run macos Visual Studio is required for Windows development with the Flutter SDK. Download it at https://visualstudio.microsoft.com/downloads/ and install the "Desktop development with C++", "Linux development with C++", and "Visual C++ build tools" workloads. You may also need the Windows 10, 11, and/or Universal SDK workloads depending on your Windows version. ### Build plugins in WSL2 -Set up Ubuntu 20.04 in WSL2. Follow the entire Linux host section in the WSL2 Ubuntu 20.04 host to get set up to build. The Android Studio section may be skipped in WSL (it's only needed on the Windows host). +Set up Ubuntu 24.04 in WSL2. Follow the entire Linux host section in the WSL2 Ubuntu 24.04 host to get set up to build. The Android Studio section may be skipped in WSL (it's only needed on the Windows host). Install the following libraries: ``` From 80b9ecfa7801ea321de5e42bf5608d552a4c60f9 Mon Sep 17 00:00:00 2001 From: sneurlax Date: Mon, 5 Jan 2026 11:26:25 -0600 Subject: [PATCH 7/7] docs: align wording re: flutter nit --- docs/building.md | 17 ++--------------- 1 file changed, 2 insertions(+), 15 deletions(-) diff --git a/docs/building.md b/docs/building.md index 8a1683551..bd2bffe96 100644 --- a/docs/building.md +++ b/docs/building.md @@ -14,18 +14,7 @@ Here you will find instructions on how to install the necessary tools for buildi The following instructions are for building and running on a Linux host. Alternatively, see the [Mac](#mac-host) and/or [Windows](#windows-host) section. This entire section (except for the Android Studio section) needs to be completed in WSL if building on a Windows host. ### Flutter -Install Flutter 3.38.1 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk). You can also clone https://github.com/flutter/flutter, check out the `3.35.7` tag, and add its `flutter/bin` folder to your PATH as in -```sh -FLUTTER_DIR="$HOME/development/flutter" -git clone https://github.com/flutter/flutter.git "$FLUTTER_DIR" -cd "$FLUTTER_DIR" -git checkout 3.35.7 -echo 'export PATH="$PATH:'"$FLUTTER_DIR"'/bin"' >> "$HOME/.profile" -source "$HOME/.profile" -flutter precache -``` - -Run `flutter doctor` in a terminal to confirm its installation. +Install Flutter 3.38.5 by [following their guide](https://docs.flutter.dev/get-started/install/linux/desktop?tab=download#install-the-flutter-sdk). Run `flutter doctor` in a terminal to confirm its installation. ### Android Studio Install Android Studio. Follow instructions here [https://developer.android.com/studio/install#linux](https://developer.android.com/studio/install#linux) or install via snap: @@ -300,9 +289,7 @@ If the DLLs were built on the WSL filesystem instead of on Windows, copy the res Frostdart will be built by the Windows host later. ### Install Flutter on Windows host -Install Flutter 3.38.5 on your Windows host (not in WSL2) by [following their guide](https://docs.flutter.dev/install/manual). - -Run `flutter doctor` in PowerShell to confirm its installation. +Install Flutter 3.38.5 on your Windows host (not in WSL2) by [following their guide](https://docs.flutter.dev/install/manual). Run `flutter doctor` in PowerShell to confirm its installation. ### Rust Install [Rust](https://www.rust-lang.org/tools/install) on the Windows host (not in WSL2). Download the installer from [rustup.rs](https://rustup.rs), make sure it works on the commandline (you may need to open a new terminal), and install the following versions: