Mobile

Getting started - iOS

Basic steps to start using Woosmap Mobile SDK for iOS

Install the SDK

To use Woosmap Mobile in your iOS project, import it manually inside your project (we don’t support CocoaPods for now). Woosmap Mobile iOS SDK is hosted on GitHub. You will need to contact us to download the SDK.

Once the SDK bundles files downloaded, launch Xcode and either open an existing project, or create a new project. If you’re new to iOS, create a Single View Application. Then, simply drag the following bundles into your project (when prompted, select Copy items if needed):

  • WoosmapNow.framework
  • WoosmapNowNotification.framework

Select your project from the Project Navigator, choose your application’s target, open the Build Phases tab, and within Link Binary with Libraries, add the following frameworks:

  • WoosmapNow.framework

To integrate Woosmap Mobile in your iOS application, you should first of all to be enrolled in Apple Developer Program.

Initialization

Create, if it’s not already done, a Woosmap Mobile Private key through the Woosmap Console. Woosmap Create a Private Key

Add your API key to your AppDelegate.swift as follow:

  • Add the following import statement:
    import WoosmapNow
    
  • Add the following to your application(_:didFinishLaunchingWithOptions:) method, replacing YOUR_PRIVATE_KEY with your API key:
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool
    {
      Now.shared.setPrivateKey(privateKey: "YOUR_PRIVATE_KEY")   
      return true
    }
    

Tracking

As Woosmap SDK requires access to the location of the device, you will need to request permission to use the location services. Add the corresponding keys to your Info.plist file, to define the string informing the user why you need the location services. Check next topic to see how.

Woosmap Mobile SDK automatically starts tracking user data by calling Now.shared.startMonitoringInBackground(). Data are stored on the device in a local database and synced when the network connectivity is available.

Please, follow steps described in the Location Tracking section to complete the Woosmap Mobile integration in your iOS app.