Skip to content

Commit 77ad505

Browse files
xrvivclaude
andcommitted
fix(docs): correct Flutter version, add Rust 1.71.0, fix Ubuntu 24.04 meson install, add rsync
- Flutter: 3.38.5 → 3.38.1 (all platforms; confirmed by libflutter.so identity match during reproducible build verification) - Rust: add 1.71.0 to all rustup install lines; required by crypto_plugins/frostdart/scripts/linux/build_all.sh which hardcodes cargo +1.71.0 - Ubuntu 24.04 meson: replace pipx with python3-venv approach; pipx cannot install library-only packages (markupsafe, jinja2, etc.) and will fail; setuptools added because Python 3.12 removed distutils which meson needs for GObject introspection - Linux desktop deps: add rsync; required by crypto_plugins/flutter_libmwc/scripts/linux/build_all.sh Fixes found during WalletScrutiny reproducible build verification (issue #1399). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent edc19aa commit 77ad505

1 file changed

Lines changed: 14 additions & 11 deletions

File tree

docs/building.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Here you will find instructions on how to install the necessary tools for buildi
1414
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.
1515

1616
### Flutter
17-
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.
17+
Install Flutter 3.38.1 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.
1818

1919
### Android Studio
2020
Install Android Studio. Follow instructions here [https://developer.android.com/studio/install#linux](https://developer.android.com/studio/install#linux) or install via snap:
@@ -54,15 +54,18 @@ pip3 install --upgrade meson==0.64.1 markdown==3.4.1 markupsafe==2.1.1 jinja2==3
5454

5555
For Ubuntu 24.04,
5656
```
57-
sudo apt install pipx libgcrypt20-dev libglib2.0-dev libsecret-1-dev
58-
pipx install 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
57+
sudo apt install python3-pip python3-venv libgcrypt20-dev libglib2.0-dev libsecret-1-dev
58+
python3 -m venv ~/.build-tools
59+
~/.build-tools/bin/pip install 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 setuptools
60+
echo 'export PATH="$HOME/.build-tools/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
5961
```
62+
Note: `pipx` cannot install library-only packages (e.g. `markupsafe`, `jinja2`) and will fail. `setuptools` is required because Python 3.12 removed `distutils`, which meson needs for GObject introspection.
6063

6164
Install [Rust](https://www.rust-lang.org/tools/install) via [rustup.rs](https://rustup.rs), the required Rust toolchains, and `cargo-ndk` with command:
6265
```
6366
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
6467
source ~/.bashrc
65-
rustup install 1.89.0 1.85.1 1.81.0
68+
rustup install 1.89.0 1.85.1 1.81.0 1.71.0
6669
rustup default 1.89.0
6770
cargo install cargo-ndk
6871
```
@@ -75,12 +78,12 @@ rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-andro
7578

7679
Linux desktop specific dependencies:
7780
```
78-
sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev meson python3-pip libgirepository1.0-dev valac xsltproc docbook-xsl
79-
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
81+
sudo apt-get install clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev meson python3-pip libgirepository1.0-dev valac xsltproc docbook-xsl rsync
8082
```
83+
Note: `rsync` is required by `crypto_plugins/flutter_libmwc/scripts/linux/build_all.sh`.
8184

8285
### Flutter
83-
Install Flutter 3.38.5 by [following their guide](https://docs.flutter.dev/install/manual).
86+
Install Flutter 3.38.1 by [following their guide](https://docs.flutter.dev/install/manual).
8487

8588
Run `flutter doctor` in a terminal to confirm its installation.
8689

@@ -213,7 +216,7 @@ Download and install [Rust](https://www.rust-lang.org/tools/install). [Rustup](
213216
```
214217
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
215218
source ~/.bashrc
216-
rustup install 1.89.0 1.85.1 1.81.0
219+
rustup install 1.89.0 1.85.1 1.81.0 1.71.0
217220
rustup default 1.89.0
218221
cargo install cargo-ndk
219222
cargo install cbindgen cargo-lipo
@@ -223,7 +226,7 @@ rustup target add aarch64-apple-ios aarch64-apple-darwin
223226
Optionally download [Android Studio](https://developer.android.com/studio) as an IDE and activate its Dart and Flutter plugins. VS Code may work as an alternative, but this is not recommended.
224227

225228
### Flutter
226-
Install 3.38.5 on your Mac host by [following their guide](https://docs.flutter.dev/install/manual). Run `flutter doctor` in a terminal to confirm its installation.
229+
Install Flutter 3.38.1 on your Mac host by [following their guide](https://docs.flutter.dev/install/manual). Run `flutter doctor` in a terminal to confirm its installation.
227230

228231
### Build plugins and configure
229232
#### Building plugins for iOS
@@ -289,12 +292,12 @@ If the DLLs were built on the WSL filesystem instead of on Windows, copy the res
289292
Frostdart will be built by the Windows host later.
290293

291294
### Install Flutter on Windows host
292-
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.
295+
Install Flutter 3.38.1 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.
293296

294297
### Rust
295298
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:
296299
```
297-
rustup install 1.89.0 1.85.1 1.81.0
300+
rustup install 1.89.0 1.85.1 1.81.0 1.71.0
298301
rustup default 1.89.0
299302
cargo install cargo-ndk
300303
```

0 commit comments

Comments
 (0)