mirror of
https://github.com/cake-tech/cake_wallet.git
synced 2024-11-16 17:27:37 +00:00
01d40c4dc3
Some checks are pending
Cache Dependencies / test (push) Waiting to run
* Rename build-guide-win.md to howto-build-windows.md * Update howto-build-windows.md * Update howto-build-windows.md * Update howto-build-windows.md * Update howto-build-windows.md * Update howto-build-android.md * Update howto-build-android.md * Update howto-build-macos.md * Update howto-build-macos.md * Update howto-build-ios.md * Update howto-build-android.md * Update howto-build-windows.md
112 lines
4.1 KiB
Markdown
112 lines
4.1 KiB
Markdown
# Building Cake Wallet for macOS
|
|
|
|
## Requirements and Setup
|
|
|
|
The following are the system requirements to build Cake Wallet for your macOS device.
|
|
|
|
```
|
|
macOS >= 14.0
|
|
Xcode 15.3
|
|
Flutter 3.19.x
|
|
```
|
|
|
|
### 1. Installing Package Dependencies
|
|
|
|
Cake Wallet cannot be built without the following packages installed on your build system.
|
|
|
|
For installing dependency tools you can use brew [Install brew](https://brew.sh).
|
|
|
|
You may easily install them on your build system with the following command:
|
|
|
|
`$ brew install cmake xz automake autoconf libtool boost@1.76 zmq cocoapods`
|
|
|
|
`$ brew link boost@1.76`
|
|
|
|
### 2. Installing Xcode
|
|
|
|
You may download and install the latest version of [Xcode](https://developer.apple.com/xcode/) from macOS App Store.
|
|
|
|
### 3. Installing Flutter
|
|
|
|
Need to install flutter with version `3.19.x`. For this please check section [Install Flutter](https://docs.flutter.dev/get-started/install/macos/desktop?tab=download).
|
|
|
|
### 4. Installing rustup
|
|
|
|
Install rustup from the [rustup.rs](https://rustup.rs/) website.
|
|
|
|
### 5. Verify Installations
|
|
|
|
Verify that Flutter and Xcode have been correctly installed on your system with the following command:
|
|
|
|
`$ flutter doctor`
|
|
|
|
The output of this command will appear like this, indicating successful installations. If there are problems with your installation, they **must** be corrected before proceeding.
|
|
```
|
|
Doctor summary (to see all details, run flutter doctor -v):
|
|
[✓] Flutter (Channel stable, 3.19.x, on macOS 14.x.x)
|
|
[✓] Xcode - develop for iOS and macOS (Xcode 15.3)
|
|
```
|
|
|
|
### 6. Acquiring the Cake Wallet source code
|
|
|
|
Download the source code.
|
|
|
|
`$ git clone https://github.com/cake-tech/cake_wallet.git --branch main`
|
|
|
|
Proceed into the source code before proceeding with the next steps:
|
|
|
|
`$ cd cake_wallet/scripts/macos/`
|
|
|
|
### 7. Execute Build & Setup Commands for Cake Wallet
|
|
|
|
We need to generate project settings like app name, app icon, package name, etc. For this need to setup environment variables and configure project files.
|
|
|
|
Please pick what app you want to build: cakewallet or monero.com.
|
|
|
|
`$ source ./app_env.sh <cakewallet OR monero.com>`
|
|
(it should be like `$ source ./app_env.sh cakewallet` or `$ source ./app_env.sh monero.com`)
|
|
|
|
Then run configuration script for setup app name, app icon and etc:
|
|
|
|
`$ ./app_config.sh`
|
|
|
|
Build the Monero libraries and their dependencies:
|
|
|
|
`$ ./build_monero_all.sh`
|
|
|
|
If you be needed to build universal monero lib, then it will require additional steps. Steps for build universal monero lib on mac with Apple Silicon (arm64):
|
|
|
|
- Need to install Rosetta: `$ softwareupdate --install-rosetta`
|
|
- Need to install [Brew](https://brew.sh/) with rosetta: `$ arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"` (or take another way to install brew, but be use that you have installed it into /usr/local as it's using for x86_64 macs)
|
|
- Install dependencies for build monero wallet lib for x86_64 with brew: `$ arch -x86_64 /usr/local/bin/brew install automake autoconf libtool openssl boost@1.76 zmq` and link installed boost@1.76 for x86_64 `$ arch -x86_64 /usr/local/bin/brew link boost@1.76`
|
|
- Run building script with additional argument: `$ ./build_monero_all.sh universal`
|
|
|
|
If you will be needed to build monero wallet lib only for x86_64 on arm64 mac, then you need use steps above, but run build script with rosetta without arguments: `$ arch -x86_64 ./build_monero_all.sh`.
|
|
|
|
It is now time to change back to the base directory of the Cake Wallet source code:
|
|
|
|
`$ cd ../../`
|
|
|
|
Install Flutter package dependencies with this command:
|
|
|
|
`$ flutter pub get`
|
|
|
|
Your Cake Wallet binary will be built with cryptographic salts, which are used for secure encryption of your data. You may generate these secret salts with the following command:
|
|
|
|
`$ flutter packages pub run tool/generate_new_secrets.dart`
|
|
|
|
Then we need to generate localization files and mobx models.
|
|
|
|
`$ ./configure_cake_wallet.sh macos`
|
|
|
|
### 8. Build!
|
|
|
|
`$ flutter build macos --release`
|
|
|
|
Then you can open `macos/Runner.xcworkspace` with Xcode and you can to archive the application.
|
|
|
|
Or if you want to run to connected device:
|
|
|
|
`$ flutter run --release`
|
|
|
|
Copyright (c) 2024 Cake Labs LLC
|