Heap SDK challenge how to:

Introduction

I developed Heap SDK with two test applications I built as a challenge for two companies ( Fleetio & Divvy ) during a recrutment process:

1. Repository of FleetioTest
2. Repository of DivvyTest

They are both including already the HeapSdk pod.

Instalation

Application

1. Be sure your application has a minimum deployment target of iOS 14.0
2. You will have to set isUserInteractionEnabled = true if you want to be able to track some object.

Podfile

In your podfile add the HeapSdk pod and check the platform version is at least 14.0 as bellow.

platform :ios, '14.0'
use_frameworks!

target 'FleetioTest' do
  pod 'Alamofire'
  pod 'HeapSdk'
end

Run the following command App folder

1. rm -rf Pods // optional
2. pod repo update // optional
3. pod install
4. pod update

Info.plist

Add the following to allow the SDK to communicate with the backend

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

AppDelegate.swift

Import HeapSdk at the top of the file and in the didFinishLaunchingWithOptions function add one line of code to init and run the SDK.

import UIKit
import HeapSdk

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.

    // Init and run HeapSdk
    _ = HSdk()

    return true
}

Conclusion

This challenge allowed me to get back in the SDK world and learn more about it. It took me more than 4 hours around 7hours, I had to learn how to release a version on cocoa pods.

I was able to build, setup, install & release the SDK. The SDK is mainly doing the job, tracking the events and sending them to the back-end.

But when it comes to detecting which object the user is interacting within the app this can be really tricky. Sometimes we need to set isUserInteractionEnabled = true in the app if we want the SDK be able to detect the object.