1# uTox-cocoa specific notes
2
3* 10.10 SDK is required to build, but the product should be
4  compatible back to 10.7.
5  * Support for Mavericks SDK is TODO (ifdef out 10.10 bits)
6  * Please make sure your dependencies are built with the lowest
7    `MACOSX_DEPLOYMENT_TARGET` possible
8  * The gameplan for 10.6 is to just replace AVFoundation with QTKit
9    equivalents.
10    * 32-bit support would be nice too (PowerPC is probably too much)
11* Build an OS X .app package by using `make uTox.app`.
12  * Some features will not work unless you run from a `.app`. These
13    include desktop notifications and the dock icon (???).
14  * An Xcode project file is TODO
15* It is recommended to define `UTOX_COCOA_BRAVE` while building for
16  release. It will disable some basic sanity checks which should
17  always pass if the code is correct.
18* You can instruct uTox to use Yosemite blur as a UI element colour
19  in utox_theme.ini by (not implemented currently)
20* When filing issues directly related to uTox-cocoa, please @stal888 in
21  your issue so I get notified.
22
23## How to compile dependencies
24
25### with Homebrew
26
27```bash
28brew tap tox/tox
29brew install --only-dependencies --HEAD utox
30```
31
32### with Autotools
33
34```bash
35git clone git://github.com/jedisct1/libsodium.git
36cd libsodium
37git checkout tags/1.0.3
38./autogen.sh
39./configure && make check
40make install
41cd ..
42
43git clone git://github.com/irungentoo/filter_audio.git
44cd filter_audio
45make
46make install
47cd ..
48
49git clone git://github.com/TokTok/c-toxcore.git
50cd c-toxcore
51cmake .
52make
53make install
54cd ..
55```
56
57## How to compile uTox
58
59```bash
60git clone --recursive git://github.com/uTox/uTox.git
61cd uTox
62mkdir build
63cd build
64cmake ..
65make
66```
67
68### How to install uTox
69
70```bash
71sudo make install
72```
73
74### How to create a DMG for distribution
75
76```bash
77cmake .. -DSTATIC_ALL=ON
78make
79sudo make package
80```
81
82Done!
83
84## How to create an Xcode project
85
861. Install the [dependencies](#how-to-compile-dependencies)
87
88```bash
89git clone --recursive git://github.com/uTox/uTox.git
90cd uTox
91mkdir build
92cd build
93cmake -GXcode ..
94
95xcodebuild -configuration Release
96```
97
98## Adding to uTox-cocoa
99
100* Please keep your C straight
101