iOS Integration - Getting started

A full working example app is available on this repository. Run to see Nextome Sdk in action. It also contains a seamless outdoor/indoor map integration using OpenStreetMap for outdoor and Nextome Flutter Map for indoor.

Prerequisites

Xcode 15.0
Make sure that your project meets these requirements:
- Swift 5.7
- Minimum deployment: iOS 13.2
Have credentials for jFrog
Have credentials for our portal

How to include

Cocoapods

Nextome Localization is distributed with Cocoapods using our Podspec repo. Be sure to have CocoaPods installed, or follow this guide to install it.

Then it is necessary to configure our Spec Repo.

Add credentials in the netrc file
```
nano ~/.netrc
```
Copy this then close and save
```
machine packages.nextome.dev
login <USERNAME>
password <ENCRYPTED-PASSWORD>
```
Note

If you get an error of this type: "Permission bits, should be 0600, but are 644"

Run this command:

chmod 0600 ~/.netrc
Create a Podfile if you don't already have one. From the root of your project directory, run the following command
```
pod init
```

To your Podfile, be sure that the platform is at least 13.2 then add the CocoaPods specs source and our Nextome source. Then add the NextomeLocalization pod

platform :ios, '13.2'

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/Nextome/Specs'

use_frameworks!

target 'MyApp' do
    pod 'NextomeLocalization'
end

Note

Since SDK is still in RC CocoaPods require to specify the version explicitly like this

    pod 'NextomeLocalization', '3.0.0-rc02'

Install the pods, then open your .xcworkspace file to see the project in Xcode
```
pod install
```
Open your xcworkspace file

Setup

In order to work properly the SDK requires to setup some permissions and capabilities:

Add Background capabilities

If your app needs to compute the position even if it is in background, it is required to add the background capability.

Select your project in Xcode’s Project navigator.
Select the app’s target in the Targets list.
Click the Signing & Capabilities tab in the project editor.
Add the background capability
Add background processing and Location Updates

Add permissions

Add these permissions in the info.plist:

Privacy - Location Always and When In Use Usage Description
Privacy - Location Always Usage Description
Privacy - Location When In Use Usage Description

Retrive SDK Credentials

Log-in the web dashboard and retrieve the Client and Secret Key for the SDK. Those credentials are available from your profile, in the Apps section.

Retrieve SDK Credentials

SDK Initialization

Firsty import the Nextome Localization SDK Module

import NextomeLocalization

Then initialize the NextomeLocalizationSdk.

It requires the given Client and Secret Key.

let nextomeSdk = NextomeLocalizationSdk.Builder(clientId: CLIENT_ID, clientSecret: CLIENT_SECRET).build()

Note

By default the SDK works with settings defined in the web portal. The NextomeLocalizationSdk.Builder allows to override some of those as described in the next sections. But please notice that this operation is extremely dangerous and should only be made in accordance with the Nextome Team because has an huge impact on the localization's performance.

Next steps

See Start Localization to use Nextome SDK.

Examples

A full working example app is available on this repository.