Unknown macro: {style}

.ia-secondary-container

Unknown macro: { margin}
Unknown macro: {div}
Kaa releases
Unknown macro: {div}
Shortcuts

Page tree
Skip to end of metadata
Go to start of metadata

Use the following instructions to build the C endpoint SDK for iOS. 

First, ensure the following components are installed on your machine.

  • C compiler supporting the C99 standard
  • cmake 2.8.8 or later
  • OpenSSL libraries (ssl and crypto)

Then, proceed as follows:

  1. Generate the C endpoint SDK in Admin UI.
  2. Download and untar the Kaa C SDK archive.
  3. Run the following commands.

    mkdir build
    cd build
  4. Run the following iOS-specific commands.

    cmake -DKAA_PLATFORM=ios -DCMAKE_TOOLCHAIN_FILE=../toolchains/iOS.cmake -GXcode ..
    xcodebuild

To configure the C endpoint SDK build, you can optionally specify the following parameters for the cmake command.

ParameterDescriptionValuesUsage example
KAA_DEBUG_ENABLEDBuild type

Accepted:

  • 0 - the release type
  • 1 - the debug type

Default: 0

cmake -DKAA_DEBUG_ENABLED=1
KAA_MAX_LOG_LEVELMaximum log level used by the SDKAccepted:
  • 0 - NONE (no logs)

  • 1 - FATAL

  • 2 - ERROR

  • 3 - WARN

  • 4 - INFO

  • 5 - DEBUG

  • 6 - TRACE

Default:

  • 4 - If KAA_DEBUG_ENABLED=0
  • 6 - if KAA_DEBUG_ENABLED=1
cmake -DKAA_MAX_LOG_LEVEL=4
KAA_WITHOUT_<MODULE>Kaa module to be omitted during the build

Accepted:

  • EVENTS

  • LOGGING

  • CONFIGURATION

Default: All modules are present in the build

cmake -DKAA_WITHOUT_EVENTS=1
KAA_PLATFORM

SDK target platform

 

NOTE:

Before running the cmake command with the KAA_PLATFORM parameter for a platform other than supported, do the following:

1. Create a folder in $KAA_HOME/listfiles/platform/ and name it using [a-zA-z_-] symbols. You will be able to use the folder name as a value for the KAA_PLATFORM parameter.

2. Put the CMakeLists.txt file into the created folder. This file may contain specific compilation/linking flags, platform-dependent source files, third-party library dependencies, that is all information necessary for building the C endpoint SDK for this platform.

3. Optionally, specify the following parameters in the CMakeLists.txt file.

  • KAA_INCLUDE_PATHS - full path(s) to folder(s) containing additional header files
  • KAA_SOURCE_FILES - full path(s) to additional source files
  • KAA_THIRDPARTY_LIBRARIES - third-party libraries (the name of the library, for example, ssl, crypto)

 

 

Accepted:

x86-64

ios

Default:

x86-64


cmake -DKAA_PLATFORM=x86-64

 

In the CMakeLists.txt file:

set(KAA_INCLUDE_PATHS

 ${KAA_INCLUDE_PATHS}

 path_to_folder_1_with_header_files

 path_to_folder_2_with_header_files

 )

set(KAA_SOURCE_FILES

 ${KAA_SOURCE_FILES}

 path_to_source_file_1

 path_to_source_file_2

 )

set(KAA_THIRDPARTY_LIBRARIES

 ${KAA_THIRDPARTY_LIBRARIES}

 some_library_1

 some_library_2

 )

To configure iOS-specific options, specify the following parameters for the cmake command.

ParameterDescriptionValuesUsage example
IOS_PLATFORM

Applicable for the iOS build (KAA_PLATFORM=ios). It specifies the target iOS platform(armv7/arm64 - for mobile devices, i386 - for the simulator).

 

 

Accepted:

OS - build for the mobile device (armv7/arm64)
SIMULATOR - build for the simulator (i386)

Default:

OS

cmake -DKAA_PLATFORM=ios -DCMAKE_TOOLCHAIN_FILE=../toolchains/iOS.cmake -DIOS_PLATFORM=SIMULATOR -GXcode ..

The following example illustrates the C SDK build procedure for the iOS simulator with the maximum log level.

mkdir build
cd build
cmake -DKAA_PLATFORM=ios -DCMAKE_TOOLCHAIN_FILE=../toolchains/iOS.cmake -DIOS_PLATFORM=SIMULATOR -DKAA_MAX_LOG_LEVEL=6  -GXcode ..
xcodebuild

Copyright © 2014-2015, CyberVision, Inc.

  • No labels