Skip to content

Commit 8ed6e97

Browse files
tresfVzor-
authored andcommitted
Update documentation
1 parent a271b13 commit 8ed6e97

File tree

1 file changed

+48
-0
lines changed

1 file changed

+48
-0
lines changed

www/MacDevelopmentEnvironment.md

+48
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,54 @@
11
Mac Development Environment
22
===========================
33

4+
### Prequisites
5+
* [Xcode](https://developer.apple.com/download/) with Command Line tools
6+
* The following tools: `ant autoconf automake libtool gettext`
7+
* These are available via [Homebrew](https://brew.sh)
8+
```bash
9+
brew install ant autoconf automake libtool gettext
10+
```
11+
12+
* ... or alternately via [MacPorts](https://www.macports.org/)
13+
14+
### Compiling
15+
16+
1. To compile and run unit tests for the current archecture:
17+
```bash
18+
ant
19+
```
20+
21+
2. To compile native components only and skip unit tests:
22+
```bash
23+
ant native
24+
```
25+
26+
3. To provide an alternate (older) macOS SDK:
27+
```bash
28+
ant -DSDKROOT=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk
29+
```
30+
31+
4. To cross-compile for an alternate architecture:
32+
```bash
33+
# ARM64 (>= 11.0)
34+
ant -Dos.prefix=darwin-aarch64
35+
36+
# x86 (<= 10.13)
37+
ant -Dos.prefix=darwin-x86
38+
39+
# x86_64
40+
ant -Dos.prefix=darwin-x86-64
41+
42+
# PPC (<= 10.5)
43+
ant -Dos.prefix=darwin-ppc
44+
45+
# PPC64
46+
ant -Dos.prefix=darwin-ppc64
47+
```
48+
49+
### Troubleshooting
50+
51+
452
* Xcode - If you only have the Xcode command line tools installed, and not the full Xcode UI, you may see build errors like this:
553

654
native:

0 commit comments

Comments
 (0)