Building iOS/OS X

Note, some of the paths below will need to be adjusted based on the version downloaded


  1. Download the following iOS SDKs:

    • Core SDK (release)
    • Onboarding SDK
    • Configuration SDK
    • Notification SDK
    • Control Panel SDK
  2. Extract the downloaded packages and setup the directory structure:

mkdir alljoyn-ios
mkdir alljoyn-ios/core
mv alljoyn-14.06.00-osx_ios-sdk alljoyn-ios/core/alljoyn

Set up OpenSSL dependencies

cd <parent directory of alljoyn-ios>
pushd alljoyn-ios
git clone git://
git clone
cp -r openssl-xcode/openssl.xcodeproj openssl
pushd openssl
git checkout tags/OpenSSL_1_0_1f #replace this with a newer version as available
sed -ie 's/\(ONLY_ACTIVE_ARCH.*\)YES/\1NO/' openssl.xcodeproj/project.pbxproj
xcodebuild -configuration Release -sdk iphonesimulator
xcodebuild -configuration Release -sdk iphoneos
xcodebuild -configuration Release
xcodebuild -configuration Debug -sdk iphonesimulator
xcodebuild -configuration Debug -sdk iphoneos
xcodebuild -configuration Debug
launchctl setenv OPENSSL_ROOT `pwd`

Define environment variables

cd alljoyn-ios
launchctl setenv ALLJOYN_SDK_ROOT `pwd`
cd services
launchctl setenv ALLSEEN_BASE_SERVICES_ROOT `pwd`

Build the samples

Open each of the following sample iOS applications in Xcode and build them by selecting Project > Build from the Xcode menu.

  • alljoyn-ios/core/alljoyn/alljoyn_objc/samples/iOS/
  • alljoyn-ios/core/alljoyn/services/about/ios/samples/
  • alljoyn-ios/services/alljoyn-config-14.06.00-rel/objc/samples/
  • alljoyn-ios/services/alljoyn-controlpanel-14.06.00-rel/objc/samples/
  • alljoyn-ios/services/alljoyn-notification-14.06.00-rel/objc/samples/
  • alljoyn-ios/services/alljoyn-onboarding-14.06.00-rel/objc/samples/

Install samples on an iOS device

Make sure you have an iOS device connected to your computer, then use Xcode to Run the desired sample application. This will install the application onto your device.

TIP: This command can also be used to build a sample application from a terminal

Add the AllJoyn® framework to an iOS application

  1. Make sure you know the location of the AllJoyn SDK folder. The AllJoyn SDK folder contains your build, services, and alljoyn_objc folders.
  2. Open Xcode, open your project, and select the root of the tree in Project Navigator. Then select the app's target under Targets.

Add the AllJoyn Core library and dependencies:

  1. Select the Building Settings tab for the app target. Click the All option at the top of the list.
  2. At the top of the Build Settings list, click Architectures and then select Standard architectures (armv7, armv7s).
  3. Set Build Active Architecture only to Yes.
  4. Scroll down to the Linking section, and set Other Linker Flags to the following:

    -lalljoyn -lajrouter -lBundledRouter.o -lssl -lcrypto

  5. Scroll down to the list of settings until see the Search Paths group.
  6. Double-click the Header Search Paths field and enter the following:

    $(ALLJOYN_ROOT)/core/alljoyn/build/darwin/arm/$(PLATFORM_NAME)/$(CONFIGURATION)/dist/cpp/inc $(ALLJOYN_ROOT)/core/alljoyn/alljoyn_objc/AllJoynFramework/AllJoynFramework/

  7. Double-click the Library Search Paths field and enter the following:


  8. Look through the Build Settings table until you see the Apple LLVM 5.0 - Language - C++ group and set the following:

    • Enable C++ Exceptions to No.
    • Enable C++ Runtime Types to No.
    • C++ Language Dialect to Compiler Default.
  9. Look through the Build Settings table until you see the Apple LLVM 5.0 - Custom Compiler Flags group and set the following:

    • Enter the following in the Other C Flags field for Debug field:


    • Enter the following in the Other C Flags field for Release field:


  10. Look through the Build Settings table until you see the Apple LLVM 5.0 - Language group and set the following:

    • C Language Dialect to Compiler Default.
    • Compile Sources As to Objective-C++.
  11. Select the Build Phases tab.
  12. Expand the Link Binary With Libraries group and click the + sign at the lower left corner. A dialog will appear.
    1. Select the SystemConfiguration.framework file.
    2. Click the + button again and add the following libraries to link against, if not already included:
    3. libstdc++.6.0.9.dylib
    4. libstdc++.6.dylib
    5. libstdc++.dylib
    6. libc++abi.dylib
    7. libc++.1.dylib
    8. libc++.dylib

Add the service frameworks

  1. Select the Build Phases tab for the app target. Click the All option at the top of the list.
  2. Under Link Binary with Libraries, click on the '+' button, choose Add Other..., and add the following:

    General libs (needed by all apps using one or more service frameworks):

    • alljoyn-ios/services//cpp/lib/
      • liballjoyn_services_common_cpp.a
      • liballjoyn_about_cpp.a
    • alljoyn-ios-directory/services//objc/lib/
      • liballjoyn_services_common_objc.a
      • liballjoyn_about_objc.a
      • libAllJoynFramework_iOS.a

    Config libs:

    • alljoyn-ios/services/alljoyn-config-14.06.00-rel/cpp/lib/
      • liballjoyn_config_cpp.a
    • alljoyn-ios-directory/services/alljoyn-config-14.06.00-rel/objc/lib/
      • liballjoyn_config_objc.a

    Control Panel libs:

    • alljoyn-ios/services/alljoyn-controlpanel-14.06.00-rel/cpp/lib/
      • liballjoyn_controlpanel_cpp.a
    • alljoyn-ios/services/alljoyn-controlpanel-14.06.00-rel/objc/lib/
      • liballjoyn_controlpanel_objc.a

    Notification libs:

    • alljoyn-ios/services/alljoyn-notification-14.06.00-rel/cpp/lib/
      • liballjoyn_notification_cpp.a
    • alljoyn-ios/services/alljoyn-notification-14.06.00-rel/objc/lib/
      • liballjoyn_notification_objc.a

    Onboarding libs:

    • alljoyn-ios/services/alljoyn-onboarding-14.06.00-rel/cpp/lib/
      • liballjoyn_onboarding_cpp.a
    • alljoyn-ios/services/alljoyn-onboarding-14.06.00-rel/objc/lib/
      • liballjoyn_onboarding_objc.a