mirror of
https://github.com/Such-Software/hash-wallet.git
synced 2026-10-18 05:51:34 +02:00
jwinterm
e8f766dfe6
Avoids any confusion / potential trademark friction with HashWallet
(Spanish hardware-wallet company). Hash Bags is a more distinctive
name, harder to collide with, and we can still rank for 'hash wallet'
search via App Store / Play Store subtitle ('Hash Bags - A Wallet
for your Coins').
What changed (all user-visible strings):
- Launcher labels: android/app.properties, scripts/android/app_env.sh,
scripts/ios/app_env.sh, linux window title (CMakeLists +
my_application.cc)
- In-app text: lib/generated/i18n.dart + ARB sources under res/values/
- Brand docs: README.md, CONTRIBUTING.md, PRIVACY.md,
assets/text/Terms_of_Use.txt, assets/text/Release_Notes.txt
- hash.boats website: index.html, og-image.svg + regen og-image.png,
site.webmanifest, styles.css comment, splash/confirm/pulse/mark/
lockup svg titles, report/index.html, server/server.js
- CI workflow display names ("Hash Bags Linux build", etc.)
What did NOT change (deliberate):
- Bundle ID / Package: com.suchsoftware.hashwallet (immutable app
identity on App Store + Play Store — changing == orphaning the app)
- Binary name: hash_wallet (Linux executable)
- Dart import paths: package:hash_wallet/...
- Git repo: hash-wallet (Such-Software/hash-wallet)
- URL scheme: hashwallet:// (internal deep links)
- support@such.software (no domain change yet)
- App Store / Play Store listing names (whatever was registered there
stays; we updated launcher label only)
- hash.boats domain (still the wallet site)
Also kept the '#ash Wallet' wordplay in the nav but updated to
'#ash Bags' so the # mark still serves as the H. Nav reads:
[# mark] #ash Bags
Website hero tagline now matches the App Store sub-title concept:
'A wallet for your coins. Open-source, non-custodial, multi-chain.
Privacy-leaning by default.'
108 files modified, ~674 string replacements.
93 lines
3.6 KiB
Markdown
93 lines
3.6 KiB
Markdown
# Building Cake Wallet for Windows
|
|
|
|
## Requirements and Setup
|
|
|
|
The following are the system requirements to build Cake Wallet for your Windows PC.
|
|
|
|
```txt
|
|
Windows 10 or later (64-bit), x86-64 based
|
|
Flutter 3.27.4
|
|
```
|
|
|
|
### 1. Installing Flutter
|
|
|
|
Install Flutter, specifically version `3.27.4` by following the [official docs](https://docs.flutter.dev/get-started/install/windows).
|
|
|
|
In order for Flutter to function, you'll also need to enable Developer Mode:
|
|
|
|
Start Menu > search for "Run" > type `ms-settings:developers`, and turn on Developer Mode.
|
|
|
|
NOTE: as `3.27.4` is not the latest version, you'll need to download it from <https://docs.flutter.dev/release/archive> instead of the link in the docs above.
|
|
|
|
### 2. Install Development Tools
|
|
|
|
Install Git for Windows and Visual Studio 2022:
|
|
|
|
1. Follow the [Development Tools](https://docs.flutter.dev/get-started/install/windows/desktop#development-tools) installation instructions
|
|
1. NOTE: Be sure to install the `Desktop Development with C++` workload in Visual Studio as outlined in the docs.
|
|
2. Add `git` to your path by going to Start Menu > search "environment" > Environment Variables > double-click Path > Add `C:\Program Files\Git\bin\` on a new line.
|
|
|
|
Lastly, you'll need to install Nuget separately:
|
|
|
|
1. Download the exe from <https://dist.nuget.org/win-x86-commandline/latest/nuget.exe>
|
|
2. Create a new directory, `C:\Program Files\Nuget\`
|
|
3. Move or copy the `nuget.exe` binary you just downloaded into the newly created directory above.
|
|
4. Add `nuget` to your path by going to Start Menu > search "environment" > Environment Variables > double-click Path > Add `C:\Program Files\Nuget\` on a new line.
|
|
|
|
### 3. Installing WSL (Windows Subsystem for Linux)
|
|
|
|
For building Monero dependencies, it is required to install Windows [WSL](https://learn.microsoft.com/en-us/windows/wsl) and required packages for WSL (Ubuntu).
|
|
|
|
1. Open a Powershell window by going to the Start Menu and searching for "Powershell"
|
|
2. Install WSL with the command `wsl --install`
|
|
3. Install the necessary Ubuntu dependencies
|
|
|
|
```powershell
|
|
wsl --install
|
|
wsl sudo apt update
|
|
wsl sudo apt install -y autoconf build-essential ccache cmake curl gcc gcc-mingw-w64-x86-64 git g++ g++-mingw-w64-x86-64 gperf lbzip2 libtool make pkg-config pigz
|
|
```
|
|
|
|
### 4. Installing Rust
|
|
|
|
Install Rust and other Rust-related dependencies using [rustup.rs](https://rustup.rs/#) by running the following command:
|
|
|
|
```bash
|
|
wsl curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
|
```
|
|
|
|
### 5. Acquiring the Cake Wallet source code
|
|
|
|
Download the latest release tag of Cake Wallet and enter the source code directory:
|
|
|
|
```powershell
|
|
git clone https://github.com/cake-tech/cake_wallet.git --branch main
|
|
cd cake_wallet
|
|
```
|
|
|
|
NOTE: Replace `main` with the latest release tag available at <https://github.com/cake-tech/cake_wallet/releases/latest>.
|
|
|
|
### 6. Build Monero, monero_c, and dependencies
|
|
|
|
To use Monero in Cake Wallet, you must build the Monero_C wrapper which will be used by monero.dart package.
|
|
|
|
Run the following in a WSL terminal window (set the Git username and email as desired):
|
|
|
|
```powershell
|
|
wsl
|
|
git config --global user.email "builds@cakewallet.com"
|
|
git config --global user.name "builds"
|
|
./build_all.sh
|
|
```
|
|
|
|
### 7. Configure and build Cake Wallet application
|
|
|
|
To configure the application, run the following:
|
|
|
|
```powershell
|
|
exit
|
|
.\hashwallet.bat
|
|
```
|
|
|
|
After running the script above, you should get `Hash Bags.zip` in the project's root directory which will contain `cake_wallet.exe` (Flutter binary name retained from upstream) and other needed files for running the application. Now you can extract files from `Hash Bags.zip` archive and run the application.
|