yz1988computer/countly-sdk-android

Countly Mobile Analytics - Android SDK

##What's Countly? Countly is an innovative, real-time, open source mobile analytics application. It collects data from mobile devices, and visualizes this information to analyze mobile application usage and end-user behavior. There are two parts of Countly: the server that collects and analyzes data, and mobile SDK that sends this data. Both parts are open source with different licensing terms.

This repository includes the SDK for Android.

##Installing Android SDK

Installing Android SDK requires two very easy steps. Countly Android SDK uses OpenUDID (which comes ready with the zip file). First step is about OpenUDID requirement and second step is integrating Countly SDK to your project:

###1. Add this to your manifest:

• Add OpenUDID_manager.java and OpenUDID_service.java to your project under Eclipse.

<service android:name="org.openudid.OpenUDID_service">
    <intent-filter>
        <action android:name="org.openudid.GETUDID" />
    </intent-filter>
</service>

###2. Add main Countly SDK to your project using steps below:

• Add Countly.java to your project under Eclipse.
• Call Countly.sharedInstance().init(context, "https://YOUR_SERVER", "YOUR_APP_KEY") in onCreate, which requires your App key and the URL of your Countly server (use https://cloud.count.ly for Countly Cloud).
• Call Countly.sharedInstance().onStart() in onStart.
• Call Countly.sharedInstance().onStop() in onStop.

Additionally, make sure that INTERNET permission is set if there's none in your manifest file.

Note: Make sure you use App Key (found under Management -> Applications) and not API Key. Entering API Key will not work.

Note: Call init only once during onCreate of main activity. After that, for each onStart and onStop for each activity, call Countly onStart and onStop.

###4. Other

Check Countly Server source code here:

• Countly Server (countly-server)

There are also other Countly SDK repositories below:

• Countly iOS SDK
• Countly Android SDK
• Countly Windows Phone SDK
• Countly Blackberry Webworks SDK
• Countly Blackberry Cascades SDK (Community supported)
• Countly Mac OS X SDK (Community supported)
• Countly Appcelerator Titanium SDK (Community supported)
• Countly Unity3D SDK (Community supported)

##How can I help you with your efforts? Glad you asked. We need ideas, feedbacks and constructive comments. All your suggestions will be taken care with upmost importance.

We are on Twitter and Facebook if you would like to keep up with our fast progress!

For community support page, see http://support.count.ly.