documentation

Appsee Cocos2d-x (iOS) Integration Instructions

Objective-C

Swift

You can install the iOS SDK through CocoaPods (recommended) or manually.

Install CocoaPods if you don't already have it.
If you don't want to use CocoaPods, you can install Appsee manually.
If this is your first pod, run pod init.
Add pod 'AppseeGL' to the corresponding target in your Podfile and run pod install.
Manual Installation
- Download the latest Appsee SDK for Cocos2d-x projects.
- Unzip the file and drag the Appsee.framework directory to the "Frameworks" folder in your XCode project tree.
- Add the following frameworks to your project (don't worry, these are dynamic bindings and will not increase your app's size):
  
  AVFoundation
  CoreGraphics
  CoreMedia
  CoreVideo
  QuartzCore
  SystemConfiguration
  libz.tbd (or zlib.dylib in XCode < 7)
  
  To add these frameworks, go to "Build phases" in your project target and select "Link Binary With Libraries".
Add the following value to your Info.plist, right after the first <dict> (right click > "Open As" > "Source Code"):
<key>com.appsee.ApiKey</key> <string>YOUR API KEY</string> Your API keys are available in the Appsee dashboard.
You will need to register or login in order to view your API keys.
In ios/AppController.mm, include:
#import <Appsee/Appsee.h> import Appsee
Add the following line in your application:didFinishLaunchingWithOptions: method:
[Appsee start]; Appsee.start()
In your project tree, go to libs/cocos2dx/platform/ios, and locate CCGLView.m (may be EAGLView.m in older versions) - and add the following header at the top of the file:
#import <Appsee/Appsee.h> Locate the following line:
if(![context_ presentRenderbuffer:GL_RENDERBUFFER]) and add this line right BEFORE it:
[Appsee appendGLFrame:self];
Optional but highly recommended: in order to seamlessly upload crash dSYM files, integrate the Appsee Build Script.
1. Go to your project settings, and select the project's target.
2. Go to the "Build Phases" tab.
3. Click the "+" button and select "New Run Script Phase".
4. Paste the following in the box: ${PODS_ROOT}/AppseeAnalytics/AppseeAnalytics.framework/build ./AppseeAnalytics.framework/build ${PODS_ROOT}/AppseeGL/Appsee.framework/build

Important Note

Appsee uploads data only when the app is minimized to the background.
If you are running from XCode do not stop the app, just press on the "home" button in order for data to be uploaded.

That's it, you're good to go!
Now, launch your app, use it for a few seconds and minimize the app to the background.
Visit the dashboard to view your first tracked session.

What's next?

You can review the full API reference docs to customize your Appsee implementation.
Here are a few important topics to review:

If you have any questions or need any assistance please contact us at support@appsee.com.