# Building Scol for iOS (iPhone, iPhone Simulator, iPad)
========================================================

## Requirements

 - CMake 3.5 or newer
 - Scol dependencies (see the `dependencies` folder under the SVN trunk)

## Building

### 1.Project generation with CMake

 - From a terminal, run `cmake-gui &`. This enables CMake to pick up environment variables.
 - Select the path to Scol's source code. Choose a build folder, preferably distinct from Scol's source folder.
 - Hit Configure, choose Xcode as generator, check "Use toolchain file for cross-compiling", and select the iOS toolchain (trunk/dependencies/CMake/toolchain/IOS.toolchain.cmake).
 - Hit Generate. An Xcode project will be created in your build folder.
 - xcodebuild -configuration Release -target install
### 2.Building with Xcode

 In Xcode, you can build and run Scol for both iOS simulators and devices.
 In order to build for iOS devices, you need a code sign identity.

 *Setting the code sign identity:*
  - In the Project navigator, select the top-level Scol project.
  - In the settings window, select the `scolLauncher` target.
  - In the `Build Settings` tab, set the `Code Signing Identity` field for scolLauncher to the desired identity.