Getting Started with Appacitive iOS SDK

An overview of Appacitive iOS SDK, how to install and use, basic conventions and debugging, and more.

#Installing the Appactive iOS SDK

There is a very simple way to integrate the Appacitive iOS SDK to your project. All you need to do is drag a .frameworks file yo your project.

Soon you will be able to use CocoaPods to integrate the Appacitive iOS SDK.

Adding the Appacitive iOS SDK framework to your project.

Step 1: Download the Appactive iOS SDK framework bundle

You can download the latest SDK here. The file you download will be a zip archive. Extract the contents. You will find a single file named Appacitive.framework which is a static library framework bundle. You can checkout the earlier versions on the downloads page.

Step 2: Integrate the framework bundle into your Xcode project

Drag the Appacitive.framework file into your Xcode project's Project Navigator and drop it inside the group(looks like a folder) named Frameworks. That's it, the SDK has been integrated.

Step 3: Verify the setup

At this point you are going to verify if the SDK was installed successfully. In your Xcode project, open up the Prefix.pch file and add the following header:

 #import <Appacitive/AppacitiveSDK.h>

Build (cmd+B) your project. If the build is successful then you have installed the SDK correctly.

Step 4: Initialize your project with appacitive

Assuming that you have created an app on the appacitive platform, you must have an api key. Here is an image that shows where you can find the API KEY on the dashboard.

To get started you need to provide your api key to the SDK. To do this call the + registerApiKey: method on the Appacitive class. Make sure to call this in the application:didFinishLaunchingWithOptions: method in your delegate. Here is an example:

- (BOOL)application:(UIApplication *)application 
             didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

     [Appacitive registerAPIKey:@"REPLACE_ME_WITH_YOUR_APIKEY" useLiveEnvironment:NO];
     return YES;
}

The above method will use the provided API key and register it with the SDK.

For any query or suggestions, feel free to drop an email to connect@appacitive.com