{"id":7,"date":"2018-08-24T23:16:44","date_gmt":"2018-08-24T23:16:44","guid":{"rendered":"https:\/\/www.xlsoft.com\/doc\/kudan\/?page_id=7"},"modified":"2023-07-13T20:42:32","modified_gmt":"2023-07-13T20:42:32","slug":"getting-started","status":"publish","type":"page","link":"https:\/\/www.xlsoft.com\/doc\/kudan\/getting-started\/","title":{"rendered":"iOS Getting Started"},"content":{"rendered":"
\n
NOTE: iOS apps built with Kudan AR SDK can no longer be published to the Apple Store. See \u00a0Details<\/a>.<\/div>\n
<\/div>\n

<\/p>\n

This tutorial will show you how to setup an augmented reality project on iOS using KudanAR.<\/div>\n<\/header>\n

 <\/p>\n

\n
\n
\n
<\/div>\n
\n

Download Kudan’s AR Framework for iOS<\/h3>\n

To get started, the first thing you’ll need is Kudan’s AR framework. You can download it on our\u00a0Download<\/a>\u00a0page.<\/p>\n

\n
\n
\"Download<\/a><\/figure>\n

Download the iOS SDK<\/center><\/div>\n

 <\/p>\n

\n
<\/div>\n

Create a new Xcode project<\/h2>\n<\/div>\n
\n

Start up Xcode and create a new Xcode project. If all you want is an AR view, just leave it on the default “Single View Application” and click next.<\/p>\n

Amongst other details, you’ll be required to enter a\u00a0Product Name<\/em>\u00a0and\u00a0Organization Identifier<\/em>. These two fields together make up your\u00a0Bundle Identifier<\/em>. You must make sure that this is the same as the Bundle Identifier associated with your API Key. This will either be the Bundle Identifier you used when generating a free API Key, or, if you are using the\u00a0Development License Key<\/a>, simply\u00a0com.xlsoft.kudanar<\/code><\/mark>.<\/p>\n<\/div>\n

\n
\"Create<\/a><\/figure>\n

Create a new Xcode Project<\/center><\/div>\n

 <\/p>\n

\n
<\/div>\n

Import Kudan’s AR Framework to the project<\/h2>\n<\/div>\n
\n

Copy or move the\u00a0KudanAR.framework<\/code><\/mark>\u00a0file into the project folder, then import it into the project, either by dragging and dropping the file from the folder into the project hierarchy, or by clicking\u00a0File -> Add Files to “<Project>”<\/em>\u00a0to add the file.<\/p>\n<\/div>\n

\n
\"Add<\/a><\/figure>\n

Add Kudan’s framework to the project<\/center><\/div>\n

 <\/p>\n

\n
<\/div>\n

Import the libc++ standard library to the project<\/h2>\n<\/div>\n
\n

Import the\u00a0libc++<\/strong>\u00a0library to your project by selecting the workspace of your project, scrolling to the bottom of the\u00a0General<\/em>\u00a0tab, clicking the small + icon in the\u00a0Linked Frameworks and Binaries<\/em>\u00a0section, search for “libc++” and add the\u00a0libc++.tbd<\/code><\/mark> file.<\/p>\n<\/div>\n

\n
\"Add<\/a><\/figure>\n

Add libc++ to the project<\/center><\/div>\n

 <\/p>\n

\n
<\/div>\n

Disable Bitcode<\/h2>\n<\/div>\n
\n

If you attempt to build your project now, it will fail, and you will receive the following error message :<\/p>\n<\/div>\n

\n

<\/i>Apple Mach-O Linker (ld) Error<\/h3>\n

ld: ‘\/KudanAR.framework\/KudanAR(KudanAR-arm64-master.o)’ does not contain bitcode. You must rebuild it with bitcode enabled (Xcode setting ENABLE_BITCODE), obtain an updated library from the vendor, or disable bitcode for this target. for architecture arm64<\/p>\n

clang: error: linker command failed with exit code 1 (use -v to see invocation)<\/p>\n<\/div><\/div>\n

\n

This is because Kudan’s AR framework is a fat binary. To disable Bitcode, go to the\u00a0Build Settings<\/code><\/mark>\u00a0tab of your workspace, scroll down to\u00a0Build Options<\/code><\/mark>, and set\u00a0Enable Bitcode<\/strong>\u00a0to\u00a0No<\/em>.<\/p>\n<\/div>\n

\n
\"Disable<\/a><\/figure>\n

Disable Bitcode<\/center><\/div>\n

 <\/p>\n

\n
<\/div>\n

Add to Info.plist<\/h2>\n<\/div>\n
\n

Info.plist key – The app’s Info.plist must contain an NSCameraUsageDescription key with a string value describing how the app uses the data.<\/p>\n

“Privacy – Camera Usage Description”<\/p>\n<\/div>\n

 <\/p>\n

\n

Add Property Declaration<\/h2>\n<\/div>\n
\n

For Objective-C Declaration, add to AppDelegate.h:<\/p>\n

AppDelegate.h<\/span><\/div>
\n[code lang=”Java”]\n@property (strong, nonatomic) UIWindow *window;
\n[\/code]\n<\/div><\/div><\/div>\n<\/div>\n

 <\/p>\n

\n

Import the ARAPIKey class to your App Delegate<\/h2>\n<\/div>\n
\n

Open the AppDelegate in your project and change it to the following:<\/p>\n<\/div>\n

\n
AppDelegate.m<\/span>AppDelegate.swift<\/span><\/div>
\n[code lang=”Java”]#import "AppDelegate.h"
\n#import <KudanAR\/ARAPIKey.h><\/p>\n

@interface AppDelegate ()
\n@end<\/p>\n

@implementation AppDelegate<\/p>\n

– (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
\n{
\n [[ARAPIKey sharedInstance] setAPIKey:@<Put API Key here>];<\/p>\n

return YES;
\n}<\/p>\n

@end[\/code]\n<\/div>\n

\n[code lang=”Java”]import UIKit
\nimport KudanAR.ARAPIKey<\/p>\n

@UIApplicationMain
\nclass AppDelegate: UIResponder, UIApplicationDelegate {<\/p>\n

var window: UIWindow?<\/p>\n

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -&gt; Bool {<\/p>\n

ARAPIKey.sharedInstance().setAPIKey("<Put API Key here>")<\/p>\n

return true
\n }<\/p>\n

}[\/code]\n<\/div><\/div><\/div>\n<\/div>\n<\/div>\n

\n

Find the API Key for your corresponding Bundle ID:<\/p>\n