Improve build docs and optimize Dockerfile for Android and Linux builds

[sethforprivacy]

Our docs are quite... varied in quality and detail, so I've done my best to clean them up.

In addition, I've worked to optimize @MrCyjaneK's Dockerfile for building Cake Wallet and Monero.com from source for Android and Linux in an attempt to drastically simplify the process, especially for less technical users.

This PR:

1. Shifts all build docs into docs/builds
2. Optimizes and moves the build Dockerfile from scripts/linux to the root of the project
3. Overhauls Android and Linux guides to use the above Docker image to make builds far easier
4. Fixes a few minor build issues that @MrCyjaneK found.
5. Resolves Building CakeWallet Android App 4.4.0 failed with haven_wallet errors, Missing cw_haven realted build instructions? #337

[sethforprivacy]

I think this is all ready for review!

I've tested Android and Linux builds with the new Docker image across three different hosts (a mix of x64 and arm64) and have worked with @MrCyjaneK to iron out the issues.

Please double check the other guides, but I have made sure not to edit the core steps, instead focusing on syntax and formatting.

[sethforprivacy]

NOTE: The output example for Linux is incorrect (shows Android right now) but I will update that when my latest Linux build completes and I can copy-paste it out :)

[sethforprivacy]

NOTE: The output example for Linux is incorrect (shows Android right now) but I will update that when my latest Linux build completes and I can copy-paste it out :)

Resolved in 9e19496.

[xrviv]

Seth, I found 1 possible problem with the Dockerfile:

Does the two == work on your end?

---

Anyway, I got past that -

The currrent flow is:

1. docker run --rm -it
   -v "$(pwd)":/app
   ghcr.io/cake-tech/cake_wallet:main-linux
   bash

2. cd app

3. git clone https://github.com/cake-tech/cake_wallet.git

4. cd cake_wallet/

5. git checkout v4.23.0

6. git submodule update --init --recursive

7. ./configure_cake_wallet.sh android

8. keytool -genkeypair
   -alias myKeyAlias
   -keyalg RSA
   -keysize 2048
   -validity 10000
   -keystore /app/cake_wallet/my-release-key.jks

9. flutter pub get

10. flutter build appbundle --release

At this stage I get:

Got dependencies!
2 packages are discontinued.
Dependencies are affected by security advisories:
  [^0]: https://github.com/advisories/GHSA-3hpf-ff72-j67p
81 packages have newer versions incompatible with dependency constraints.
Try `flutter pub outdated` for more information.

You are applying Flutter's main Gradle plugin imperatively using the apply script method, which is deprecated and will be removed in a future release. Migrate to applying Gradle plugins with the declarative plugins block: https://flutter.dev/to/flutter-gradle-plugin-apply


FAILURE: Build failed with an exception.

* Where:
Build file '/app/cake_wallet/android/app/build.gradle' line: 71

* What went wrong:
A problem occurred evaluating project ':app'.
> path may not be null or empty string. path='null'

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.

BUILD FAILED in 1s
Running Gradle task 'bundleRelease'...                           1,464ms
Gradle task bundleRelease failed with exit code 1

I had to move the release key around. but then I encountered another problem.

At this stage. I suppose I have to look at the new instructions and build from there.

[MrCyjaneK]

@xrviv Current working flow is documented here: https://github.com/sethforprivacy/cake_wallet/blob/build-docs/docs/builds/ANDROID.md#building-cake-wallet-or-monerocom

Dockerfile builds just fine on my end. Can you provide us details at which point of the documentation it resulted in an error and what that error was?

[sethforprivacy]

@xrviv Current working flow is documented here: https://github.com/sethforprivacy/cake_wallet/blob/build-docs/docs/builds/ANDROID.md#building-cake-wallet-or-monerocom

Dockerfile builds just fine on my end. Can you provide us details at which point of the documentation it resulted in an error and what that error was?

Same for me, following the new instructions the image builds properly on multiple machines and runs properly as well.

[MrCyjaneK]

All looks good to me, let me just spin up a macos VM to verify that iOS and macOS docs work and there are no other edge cases

[MrCyjaneK]

For iOS and macOS there is a requirement for extra step after installing XCode.app

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

and app_config.sh and build_monero_all.sh need to swap places on iOS/macOS, as app_config.sh requires monero_c dylib to be already built.

brew needs extra dependencies: automake ccache go libtool pkgconfig

we also need to call ./build_mwebd.sh after build_monero_all.sh on iOS

after generate_new_secrets.dart we also need to run

dart run tool/generate_localization.dart

In addition, build failed with xcode 15.3 on macOS 14.0 -> I have tested again on Xcode 16.2 and macOS 15.3.1, so we should use these values in the docs

I have followed iOS docs. but I am fairly certain that fixes should be made to both macos and iOS docs,

ios build failed, I'll make a patch to fix it in a bit - it is a known issue with mwebd

ios also needs softwareupdate --install-rosetta (well flutter, so macOS probably also needs it)

[sethforprivacy]

For iOS and macOS there is a requirement for extra step after installing XCode.app

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

and app_config.sh and build_monero_all.sh need to swap places on iOS/macOS, as app_config.sh requires monero_c dylib to be already built.

brew needs extra dependencies: automake ccache go libtool pkgconfig

we also need to call ./build_mwebd.sh after build_monero_all.sh on iOS

after generate_new_secrets.dart we also need to run

dart run tool/generate_localization.dart

In addition, build failed with xcode 15.3 on macOS 14.0 -> I have tested again on Xcode 16.2 and macOS 15.3.1, so we should use these values in the docs

I have followed iOS docs. but I am fairly certain that fixes should be made to both macos and iOS docs,

ios build failed, I'll make a patch to fix it in a bit - it is a known issue with mwebd

ios also needs softwareupdate --install-rosetta (well flutter, so macOS probably also needs it)

For iOS and macOS there is a requirement for extra step after installing XCode.app

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

and app_config.sh and build_monero_all.sh need to swap places on iOS/macOS, as app_config.sh requires monero_c dylib to be already built.

brew needs extra dependencies: automake ccache go libtool pkgconfig

we also need to call ./build_mwebd.sh after build_monero_all.sh on iOS

after generate_new_secrets.dart we also need to run

dart run tool/generate_localization.dart

In addition, build failed with xcode 15.3 on macOS 14.0 -> I have tested again on Xcode 16.2 and macOS 15.3.1, so we should use these values in the docs

I have followed iOS docs. but I am fairly certain that fixes should be made to both macos and iOS docs,

ios build failed, I'll make a patch to fix it in a bit - it is a known issue with mwebd

ios also needs softwareupdate --install-rosetta (well flutter, so macOS probably also needs it)

Adding all now, please review the upcoming commit to be sure I understood it all properly.

[sethforprivacy]

For iOS and macOS there is a requirement for extra step after installing XCode.app

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

and app_config.sh and build_monero_all.sh need to swap places on iOS/macOS, as app_config.sh requires monero_c dylib to be already built.

brew needs extra dependencies: automake ccache go libtool pkgconfig

we also need to call ./build_mwebd.sh after build_monero_all.sh on iOS

after generate_new_secrets.dart we also need to run

dart run tool/generate_localization.dart

In addition, build failed with xcode 15.3 on macOS 14.0 -> I have tested again on Xcode 16.2 and macOS 15.3.1, so we should use these values in the docs

I have followed iOS docs. but I am fairly certain that fixes should be made to both macos and iOS docs,

ios build failed, I'll make a patch to fix it in a bit - it is a known issue with mwebd

ios also needs softwareupdate --install-rosetta (well flutter, so macOS probably also needs it)

Changes made in 30ebcf6.

[MrCyjaneK]

With my notes above I was able to build cake wallet, on Windows11 (arm - should also work in x64 CPU as well, especially because flutter does not support arm64 on 3.24.4)