Teragence.SDK.iOS.Background 1.0.9.7

Installation and Integration guide

1. Open the AppDelegate.cs and following usage:

using Teragence.SDK.iOS.Background;

2. Then add in AppDelegate class following property:

public static TRGController TRGController;

3. In the method FinishedLaunching of the AppDelegate class add the following code:

public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
{
    // Your code

    this.TRGController = new TRGController("PartnerID");

    return true;
}

where :

PartnerID

It's your unique Partner ID symbols

4. Allowed controls TRGController

[x] Allows to control ability conduct all measurements using the

bool IsActive { get; set; }

property. By default, IsActive == true.

[x] Allows to control the ability conduct measurements in background (if IsRunned == true), including when application is not running using the

bool EnableBackgroundMode { get; set; }

property. By default, EnableBackgroundMode == true.

[x] Allows conduct one-time measurements when the application is running by calling

void MakeManualMesurements();

method.

Project setup

1. Add the NSLocationWhenInUseUsageDescription key and the NSLocationAlwaysAndWhenInUseUsageDescription key to your Info.plist file. (Xcode displays these keys as Privacy - Location When In Use Usage Description and Privacy - Location Always and When In Use Usage Description in the Info.plist editor.)

Code for manual editing of Info.plist:

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>For detecting of your location.</string>
<key>NSLocationAlwaysUsageDescription</key>
<string>For detecting of your location.</string>

2. If your app supports iOS 10 and earlier, add the NSLocationAlwaysUsageDescription key to your Info.plist file. (Xcode displays this key as Privacy - Location Always Usage Description in the Info.plist editor.)

Code for manual editing of Info.plist:

<key>NSLocationAlwaysUsageDescription</key>
<string>For detecting of your location.</string>

3. For each key you must write a convincing description of why you need to receive location updates in the background. For example - For detecting of your location.

4. In the Background Modes tab of your Info.plist file app target and in Background Modes select Location updates.

5. Add the Required Background Modes key with value App registers for location updates to your info plist file.

Code for manual editing of Info.plist:

<key>UIBackgroundModes</key>
<array>
<string>location</string>
</array>

6. Add the App Transport Security Settings - Allow Arbitrary Loads key with value YES to your info plist file.

Or open Info.plist as source code and insert this:

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

Author

Teragence info@teragence.com

License

ios-teragence-sdk-active is available under the EULA license. See the LICENSE file for more info.

Release notes