cake_wallet/howto-build-ios.md
tuxsudo 01d40c4dc3
Some checks are pending
Cache Dependencies / test (push) Waiting to run
Guides update (#1542)
* 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
2024-07-19 05:37:20 +03:00

101 lines
3 KiB
Markdown

# Building Cake Wallet for iOS
## Requirements and Setup
The following are the system requirements to build Cake Wallet for your iOS 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 cocoapods`
### 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/mobile-ios?tab=download).
### 4. Installing rustup
Install rustup from the [rustup.rs](https://rustup.rs/) website.
### 5. Verify Installations
Verify that the 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 CakeWallet 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/ios/`
### 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`
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 ios`
### 8. Build!
`$ flutter build ios --release`
Then you can open `ios/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