Project set up

VERSION 0.2.1455
PUBLIC PREVIEW

This guide describes how to set up your iOS project to use the SDK.

The Navigation SDK for iOS is only available upon request. Contact us to get started.

  1. Install Xcode if you don’t already have it.

  2. Create a new project or open an existing one. The application deployment target has to be set to at least 13.0.

  3. Install Cocoapods on your computer.

  4. Install cocoapods-art tool on your computer.

  5. Because the repository for Navigation SDK is private, you will need to contact us to get access. Once you have obtained access, go to repositories.tomtom.com and log in with your account. Expand the user menu in the top-right corner, and select "Edit profile" → "Generate an Identity Token". Copy your token and put it, together with your login, in ~/.netrc. If the file doesn’t exist, create one and add the following entry:

    1machine repositories.tomtom.com
    2login <YOUR_LOGIN>
    3password <YOUR_TOKEN>
  6. Add a reference to the cocoapods-art repository:

    pod repo-art add tomtom-sdk-cocoapods "https://repositories.tomtom.com/artifactory/api/pods/cocoapods"
  7. Then create a Podfile in the project folder. The pod init command in the project folder can generate a basic podfile.

  8. At the top of the Podfile add the source of the SDK Cocoapods.

    1plugin 'cocoapods-art', :sources => [
    2 'tomtom-sdk-cocoapods'
    3]
  9. Add the module dependencies that you need in your application.

    1SDK_VERSION = '{version}'
    2
    3target 'YourAppTarget' do
    4 use_frameworks!
    5 pod 'TomTomSDKNavigationEngine', SDK_VERSION
    6 pod 'TomTomSDKOnlineRouting', SDK_VERSION
    7 pod 'TomTomSDKRouting', SDK_VERSION
    8 (...)
    9end
  10. Install the dependencies by executing the following command in the project folder.

    pod install
  11. To update the SDK version, run the command:

    pod repo-art update tomtom-sdk-cocoapods

Next steps

Now that you’ve set up your project, here are some suggestions to extend the functionality: