drifty/comaps
1
0
Fork 0
mirror of https://codeberg.org/comaps/comaps synced 2025-12-19 21:13:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify iOS build instructions

Browse Source 
I had to first run ./configure.sh, otherwise the iOS app build in Xcode failed due to missing boost includes
This commit is contained in:
Eivind Samseth
2025-06-10 19:32:11 +02:00
parent 9d31c7f37f
commit 0324e37a1f
1 changed files with 24 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
docs/INSTALL.md
View File

@@ -35,7 +35,7 @@ Clone the repository including all submodules (see [Special cases options](#spec
```bash ```bash
git clone --recurse-submodules --shallow-submodules https://codeberg.org/comaps/comaps.git git clone --recurse-submodules --shallow-submodules https://codeberg.org/comaps/comaps.git
``` ```
### Linux
Go into the cloned repository: Go into the cloned repository:
```bash ```bash
cd comaps cd comaps
@@ -54,6 +54,7 @@ Configure the repository (make sure you have a working C++ build environment):
bash ./configure.sh bash ./configure.sh
``` ```
### Windows
For _Windows 10_: You should be able to build the project by following either of these setup methods: For _Windows 10_: You should be able to build the project by following either of these setup methods:
**Setup 1: Using WSL** **Setup 1: Using WSL**
@@ -69,6 +70,27 @@ For _Windows 10_: You should be able to build the project by following either o
"C:\Program Files\Git\bin\bash.exe" configure.sh # execute the script by using Developer Command Prompt "C:\Program Files\Git\bin\bash.exe" configure.sh # execute the script by using Developer Command Prompt
``` ```
### macOS
Install required build dependencies and Xcode
1. Install Xcode Command Line Tools
2. Install [Xcode](https://apps.apple.com/app/xcode/id497799835?mt=12) from the App Store.
3. Install [Homebrew](https://brew.sh) and required dependencies
4. Build CoMaps to be able to build the iOS app later
#### Xcode Command Line Tools
```bash
xcode-select --install
```
#### Homebrew packages
```bash
brew install wget optipng
```
#### Configure repository
```bash
bash ./configure.sh
```
Now the repository is prepared to build a CoMaps app! Now the repository is prepared to build a CoMaps app!
### Special cases options ### Special cases options
@@ -335,13 +357,7 @@ Building CoMaps for iOS requires a Mac.
Ensure that you have at least 20GB of free space. Ensure that you have at least 20GB of free space.
After [getting all sources](#getting-sources), please make sure that Command Line Tools are installed: Perform the steps in [getting all sources](#getting-sources), including configuring the repository
```bash
xcode-select --install
```
Then, install [Xcode](https://apps.apple.com/app/xcode/id497799835?mt=12) from the App Store.
Enroll in the [Apple Developer Program](https://developer.apple.com/programs/) (you can run CoMaps in Simulator without this step). Enroll in the [Apple Developer Program](https://developer.apple.com/programs/) (you can run CoMaps in Simulator without this step).