# Quick Start {% hint style="info" %} Check our public [sample application](https://bitbucket.org/dolphin-technologies/move-ios-sample/src/master/) for an actual implementation of the snippets below and how they can be utilized. {% endhint %} ## Overall Code A quick start snippet will look something like this in your app's [`willFinishLaunchWithOptions`](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623032-application): ```swift import MoveSDK func application(_ application: UIApplication, willFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool { MoveSDK.shared.setSDKStateListener { state in switch state { case .uninitialized: /* SDK uninitialized*/ break case .ready: /* SDK initialized and ready to start the service*/ MoveSDK.shared.startAutomaticDetection() case .running: /* SDK Started Detection*/ break case let .error(error): switch error { /* Hanlde SDK State Errors*/ default: break } } } let sdkConfig = MoveConfig(timelineDetectionService: [.walking, .driving, .bicycle, .places, .publicTransport], drivingServices: [.dfd, .behaviour], otherServices: [.poi]) MoveSDK.shared.initialize(auth: auth, config: sdkConfig, launchOptions: launchOptions) { initError in if let error = initError { switch error { /* Hanlde SDK Initialize Error*/ default: break } } } } ``` {% hint style="warning" %} This snippet assumes that the required configurations and permissions are already setup to work. Check [permissions handling](/move-platform/move-sdk-1.x/sdk/appendix/ios/permission-handling.md#required-permissions) section for more details. {% endhint %} ## Breakdown Let us break down the overall code block into the following: ### SDK Authorization The [MoveAuth](/move-platform/move-sdk-1.x/sdk/models/moveauth.md) will look something like this: ```swift let auth = MoveAuth(userToken: "",refreshToken: "" contractID: "", productID: "" ) ``` If the provided [MoveAuth](/move-platform/move-sdk-1.x/sdk/models/moveauth.md) was invalid, the SDK will not initialize and complete with [MoveConfigurationError](/move-platform/move-sdk-1.x/sdk/models/moveconfigurationerror.md)`.authInvalid`. Check [Initialization](/move-platform/move-sdk-1.x/sdk/api-interface/ios/intialization.md) for more details about possible outcomes. {% hint style="warning" %} ### Authentication Expiry The host app is expected to monitor [MoveAuthState](/move-platform/move-sdk-1.x/sdk/models/moveauthstate.md) updates via`authStateChangeListener`([iOS](/move-platform/move-sdk-1.x/sdk/api-interface/ios/services.md#set-sdk-auth-state-listener)) API and handle those changes accordingly. Check [Authentication updates and expiry](/move-platform/move-sdk-1.x/sdk/models/moveauthstate.md#authentication-updates-and-expiry) for more details about authentication expiry and renewal. {% endhint %} ### SDK Configuration [MoveConfig](/move-platform/move-sdk-1.x/sdk/models/moveauth.md) allows host apps to configure which of the licensed Move services should be enabled. It could be based on each user preference or set from a remote server. {% hint style="danger" %} **iOS System Permissions** Based on the passed [MoveConfigs](/move-platform/move-sdk-1.x/sdk/models/moveauth.md) on[`initialization`](/move-platform/move-sdk-1.x/sdk/api-interface/ios/intialization.md) , the SDK determines the required permissions to activate the requested services.\ \ The host app **must** verify that all the permissions required for the passed configs are granted.\ \ In case the required permissions were missing when calling SDK [initialization](/move-platform/move-sdk-1.x/sdk/api-interface/ios/intialization.md) API, the [MoveSDKState](/move-platform/move-sdk-1.x/sdk/models/movedevicestatus.md) will transit to `permissionMissing`error [MoveSDKState](/move-platform/move-sdk-1.x/sdk/models/movedevicestatus.md) other than `ready`[MoveSDKState](/move-platform/move-sdk-1.x/sdk/models/movedevicestatus.md). Check [permission handling](/move-platform/move-sdk-1.x/sdk/appendix/ios/permission-handling.md) for details about permissions required for each service. {% endhint %} The [MoveConfig](/move-platform/move-sdk-1.x/sdk/models/moveauth.md) will look something like this: ```swift let sdkConfig = MoveConfig( timelineDetectionService: [.walking, .driving, .bicycle, .places, .publicTransport], drivingServices: [.dfd, .behaviour], otherServices: [.poi]) ``` ### SDK State The host app is expected to set its [`SDKStateListener`](/move-platform/move-sdk-1.x/sdk/api-interface/ios/services.md#set-sdk-state-listener) **before** initializing the SDK to intercept the [MoveSDKState](/move-platform/move-sdk-1.x/sdk/models/movestate.md) changes caused by calling the [`initialize`](/move-platform/move-sdk-1.x/sdk/api-interface/ios/intialization.md) API. The provided block could then start the SDK when [MoveSDKState](/move-platform/move-sdk-1.x/sdk/models/movestate.md) is `ready` or handle errors if occurred. The provided block could look something like this: {% hint style="info" %} Only calling [`startAutomaticDetection`](/move-platform/move-sdk-1.x/sdk/api-interface/ios/services.md#start-automatic-detection)API will transit [MoveSDKState](/move-platform/move-sdk-1.x/sdk/models/movestate.md) is `ready state.` {% endhint %} ```swift MoveSDK.shared.setSDKStateListener { state in switch state { case .uninitialized: /* SDK uninitialized*/ break case .ready: /* SDK initialised and ready to start the service*/ MoveSDK.shared.startAutomaticDetection() case .running: /* SDK Started Detection*/ break case let .error(error): switch error { /* Hanlde SDK State Errors*/ default: break } } } ``` ### SDK Initialization {% hint style="warning" %} The[`initialization`](/move-platform/move-sdk-1.x/sdk/api-interface/ios/intialization.md)API must be executed before[`didFinishLaunchingWithOptions`](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1622921-application)returns. We recommend calling it in[`willFinishLaunchingWithOptions`](https://developer.apple.com/documentation/uikit/uiapplicationdelegate/1623032-application) .\ \ Exceptions might apply, where the SDK is not initialized on app launch. First initialization is a good example, where the app would only initialize the SDK after onboarding the user and requesting permissions. \ \ Check[ Initialization Timing](/move-platform/move-sdk-1.x/sdk/api-interface/ios/intialization.md#timing) for more details about the importance of adequately initializing the SDK. {% endhint %} ```swift MoveSDK.shared.initialize(auth: auth, config: sdkConfig, launchOptions: launchOptions) { initError in if let error = initError { switch error { /* Hanlde SDK Initialization MoveConfigurationError*/ default: break } } } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.movesdk.com/move-platform/move-sdk-1.x/sdk/getting-started/ios-1/quick-start.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.