{"__v":65,"_id":"54367fe7d0ffee0e00f18ebf","category":{"__v":7,"_id":"55a964c102becf2d007aad11","pages":["55a9652602becf2d007aad12","55a966cd5d3abb0d0012f25e","55b232ee23806c1900a9931d","55d1e56a3c74062300aee44a","55f537006dfd660d0072f90c","56d2c0855ad7ad0b00b7e865","56e1dfb9e63f910e00e598b5"],"project":"541c6d8251a68c3b45b9ada7","version":"541c6d8251a68c3b45b9adaa","reference":false,"createdAt":"2015-07-17T20:25:37.640Z","from_sync":false,"order":2,"slug":"official-sdks","title":"Official SDKs"},"is_link":false,"parentDoc":null,"project":"541c6d8251a68c3b45b9ada7","user":"541c6d3151a68c3b45b9ada6","version":{"__v":16,"_id":"541c6d8251a68c3b45b9adaa","project":"541c6d8251a68c3b45b9ada7","createdAt":"2014-09-19T17:53:06.500Z","releaseDate":"2014-09-19T17:53:06.500Z","categories":["541c6d8251a68c3b45b9adab","541c6e1c51a68c3b45b9adae","542baa54e5bb3e2000801fec","5436794bb7cf0e1c0020d8cc","54367d76b7cf0e1c0020d8e9","54367dc7b7cf0e1c0020d8f4","54367defd0ffee0e00f18eb7","54368035b7cf0e1c0020d8fe","5436ad91b7cf0e1c0020da6c","5447a252a1024f14005a6dd7","547e0c858466c808005369a1","54f6b81852174719008f610b","5516d13c16a294230084a985","557971d4fdbdb717002fa6c1","55a964c102becf2d007aad11","55b8c26b1b56701900a14109"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":["55fcd514342d1e0d000b21d6"],"createdAt":"2014-10-09T12:30:31.891Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"basic_auth":false,"results":{"codes":[]},"settings":"","try":true,"auth":"never","params":[],"url":""},"isReference":false,"order":0,"body":"Countly has several SDKs to choose from. Some of them are supported by Countly, and others are contributed by community.\n\nBelow you can see a list of mobile and desktop SDKs.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Officially Supported SDKs\"\n}\n[/block]\n* [Android SDK](https://github.com/Countly/countly-sdk-android) and [documentation page](doc:countly-sdk-for-android)\n* [iOS, watchOS, tvOS & OSX SDK](https://github.com/Countly/countly-sdk-ios) and [documentation page](doc:countly-sdk-for-ios-and-os-x)\n* Javascript based [Web SDK](https://github.com/countly/countly-sdk-web) to track HTML sites and [documentation page](doc:countly-sdk-for-web)\n* [NodeJS SDK](http://github.com/countly/countly-sdk-nodejs) to track Node.js runningapps and devices and [documentation page](doc:countly-sdk-for-nodejs) \n* [Phonegap, Icenium, Cordova, Meteorjs, Ionic SDK](https://github.com/Countly/countly-sdk-js) and [documentation page](doc:phonegap-icenium-meteor)\n* [Windows Phone & Windows SDK](https://github.com/Countly/countly-sdk-windows-phone) and  [documentation page](doc:countly-sdk-for-windows-phone)\n* [Python IoT SDKs](http://github.com/countly/countly-sdk-iot-python) (beta)\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"body\": \"If you want to generate mobile or web code easily for custom events, user profiles, crash reporting and all other features that comes with Countly in general, we suggest that you use [Countly Code Generator](http://code.count.ly), which is a point and click service that builds necessary code for you.\",\n  \"title\": \"Countly Code Generator\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Community Supported SDKs\"\n}\n[/block]\nThese client libraries are developed and supported by Countly community. Refer to the corresponding author for support and more information.\n\n* [Unity SDK](https://github.com/Countly/countly-sdk-unity) and [documentation page](http://resources.count.ly/docs/countly-sdk-for-unity)\n* [Cocos2d-x SDK](https://github.com/shadow0162/countly-sdk-cocos2d-x) and [documentation page](http://resources.count.ly/docs/cocos2d-x)\n* [Titanium Appcelerator SDK (iOS)](https://github.com/dieskim/countly-sdk-titanium-ios)\n* [Titanium Appcelerator SDK (Android)](https://github.com/dieskim/countly-sdk-titanium-android)\n* [.Net SDK](https://github.com/firebellys/countly-sdk-dotnet) (Alternative)\n* [Unity SDK](https://github.com/imkira/unity-countly) (Alternative)\n* [C++ SDK supporting Windows and Linux](https://github.com/GithSystems/CountlyCpp)\n* [Corona SDK](https://github.com/brandontreb/Countly-Corona)\n* [Blackberry Webworks SDK](https://github.com/Countly/countly-sdk-blackberry-webworks) and install guide (not maintained)\n* [Blackberry Cascades SDK](https://github.com/craigmj/countly-sdk-blackberry10-cascades) (not maintained)\n* [Actionscript 3 SDK](https://github.com/Countly/countly-sdk-as3) (not maintained)\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Feature comparison\"\n}\n[/block]\nThis is a feature comparison for officially supported SDKs.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"SDK\",\n    \"h-1\": \"Analytics\",\n    \"h-2\": \"Push notifications\",\n    \"h-3\": \"User Profiles\",\n    \"0-0\": \"Android\",\n    \"1-0\": \"iOS & Mac OS X\",\n    \"2-0\": \"Phonegap / Cordova\",\n    \"3-0\": \"Web SDK\",\n    \"4-0\": \"NodeJS SDK\",\n    \"0-1\": \"YES\",\n    \"1-1\": \"YES\",\n    \"2-1\": \"YES\",\n    \"3-1\": \"YES\",\n    \"4-1\": \"YES\",\n    \"0-2\": \"YES\",\n    \"1-2\": \"YES\",\n    \"2-2\": \"YES\",\n    \"3-2\": \"N/A\",\n    \"4-2\": \"N/A\",\n    \"0-3\": \"YES\",\n    \"1-3\": \"YES\",\n    \"2-3\": \"YES\",\n    \"3-3\": \"YES\",\n    \"4-3\": \"YES\",\n    \"6-0\": \"Windows Phone\",\n    \"6-1\": \"YES\",\n    \"6-2\": \"NO\",\n    \"6-3\": \"YES\",\n    \"7-0\": \"Cocos2d-x\",\n    \"7-1\": \"YES\",\n    \"7-2\": \"YES\",\n    \"7-3\": \"YES\",\n    \"h-4\": \"Crash reports\",\n    \"0-4\": \"YES\",\n    \"1-4\": \"YES\",\n    \"2-4\": \"NO\",\n    \"3-4\": \"YES\",\n    \"4-4\": \"YES\",\n    \"6-4\": \"YES\",\n    \"7-4\": \"YES\",\n    \"5-0\": \"Unity3D\",\n    \"5-1\": \"YES\",\n    \"5-2\": \"YES\",\n    \"5-3\": \"YES\",\n    \"5-4\": \"YES\"\n  },\n  \"cols\": 5,\n  \"rows\": 8\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example iOS application for testing\"\n}\n[/block]\nhere's an example iOS application that can be used to send data to Countly servers. Below you can see the instructions on how to use the example iOS application.\n\n  * Clone this repo:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://github.com/erkanyildiz/countly-sdk-samples\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n  * In countly-sdk-samples directory run this command to get latest iOS SDK:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"git submodule update --init --remote --merge\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n  * Open CountlyTestApp.xcodeproj in ios directory and add your app key and host in AppDelegate.m on this line:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"[Countly.sharedInstance start::::at:::\\\"YOUR_APP_KEY\\\" withHost:@\\\"https://YOUR_API_HOST.com\\\"];\",\n      \"language\": \"text\"\n    }\n  ]\n}\n[/block]\n  * Run project and you can see the session data immediately on your Dashboard. \n\n  * You can record custom events using one of the buttons on the screen. Custom events will be sent to server within 60 seconds, then you can see them in Events section. You can edit event keys and other values in ViewController.m if you want.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Example Android application for testing\"\n}\n[/block]\n\n  * Download / clone SDK git repository https://github.com/Countly/countly-sdk-android\n  * Open downloaded project in Android Studio.\n  * Edit MainActivity.java in either app, or app-messaging module, specifying correct server / credentials / preferences.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://www.filepicker.io/api/file/GKmWWmwcTUiIB5SCNTwW\",\n        \"android.png\",\n        \"2434\",\n        \"1340\",\n        \"#15294a\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n  * Select correct target: \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://www.filepicker.io/api/file/DwlozDyNT1yq6VGTiUE5\",\n        \"2154nqjYkdchyNgpo_P1SlrUg6yDz75BIbVYk0vOrW0.png\",\n        \"1024\",\n        \"580\",\n        \"#1d4569\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n\n  * Hit Run.","excerpt":"This is a list of our SDKs, together with download addresses and integration guides.","slug":"downloading-sdks","type":"basic","title":"Downloading & installing SDKs"}

Downloading & installing SDKs

This is a list of our SDKs, together with download addresses and integration guides.

Countly has several SDKs to choose from. Some of them are supported by Countly, and others are contributed by community. Below you can see a list of mobile and desktop SDKs. [block:api-header] { "type": "basic", "title": "Officially Supported SDKs" } [/block] * [Android SDK](https://github.com/Countly/countly-sdk-android) and [documentation page](doc:countly-sdk-for-android) * [iOS, watchOS, tvOS & OSX SDK](https://github.com/Countly/countly-sdk-ios) and [documentation page](doc:countly-sdk-for-ios-and-os-x) * Javascript based [Web SDK](https://github.com/countly/countly-sdk-web) to track HTML sites and [documentation page](doc:countly-sdk-for-web) * [NodeJS SDK](http://github.com/countly/countly-sdk-nodejs) to track Node.js runningapps and devices and [documentation page](doc:countly-sdk-for-nodejs) * [Phonegap, Icenium, Cordova, Meteorjs, Ionic SDK](https://github.com/Countly/countly-sdk-js) and [documentation page](doc:phonegap-icenium-meteor) * [Windows Phone & Windows SDK](https://github.com/Countly/countly-sdk-windows-phone) and [documentation page](doc:countly-sdk-for-windows-phone) * [Python IoT SDKs](http://github.com/countly/countly-sdk-iot-python) (beta) [block:callout] { "type": "info", "body": "If you want to generate mobile or web code easily for custom events, user profiles, crash reporting and all other features that comes with Countly in general, we suggest that you use [Countly Code Generator](http://code.count.ly), which is a point and click service that builds necessary code for you.", "title": "Countly Code Generator" } [/block] [block:api-header] { "type": "basic", "title": "Community Supported SDKs" } [/block] These client libraries are developed and supported by Countly community. Refer to the corresponding author for support and more information. * [Unity SDK](https://github.com/Countly/countly-sdk-unity) and [documentation page](http://resources.count.ly/docs/countly-sdk-for-unity) * [Cocos2d-x SDK](https://github.com/shadow0162/countly-sdk-cocos2d-x) and [documentation page](http://resources.count.ly/docs/cocos2d-x) * [Titanium Appcelerator SDK (iOS)](https://github.com/dieskim/countly-sdk-titanium-ios) * [Titanium Appcelerator SDK (Android)](https://github.com/dieskim/countly-sdk-titanium-android) * [.Net SDK](https://github.com/firebellys/countly-sdk-dotnet) (Alternative) * [Unity SDK](https://github.com/imkira/unity-countly) (Alternative) * [C++ SDK supporting Windows and Linux](https://github.com/GithSystems/CountlyCpp) * [Corona SDK](https://github.com/brandontreb/Countly-Corona) * [Blackberry Webworks SDK](https://github.com/Countly/countly-sdk-blackberry-webworks) and install guide (not maintained) * [Blackberry Cascades SDK](https://github.com/craigmj/countly-sdk-blackberry10-cascades) (not maintained) * [Actionscript 3 SDK](https://github.com/Countly/countly-sdk-as3) (not maintained) [block:api-header] { "type": "basic", "title": "Feature comparison" } [/block] This is a feature comparison for officially supported SDKs. [block:parameters] { "data": { "h-0": "SDK", "h-1": "Analytics", "h-2": "Push notifications", "h-3": "User Profiles", "0-0": "Android", "1-0": "iOS & Mac OS X", "2-0": "Phonegap / Cordova", "3-0": "Web SDK", "4-0": "NodeJS SDK", "0-1": "YES", "1-1": "YES", "2-1": "YES", "3-1": "YES", "4-1": "YES", "0-2": "YES", "1-2": "YES", "2-2": "YES", "3-2": "N/A", "4-2": "N/A", "0-3": "YES", "1-3": "YES", "2-3": "YES", "3-3": "YES", "4-3": "YES", "6-0": "Windows Phone", "6-1": "YES", "6-2": "NO", "6-3": "YES", "7-0": "Cocos2d-x", "7-1": "YES", "7-2": "YES", "7-3": "YES", "h-4": "Crash reports", "0-4": "YES", "1-4": "YES", "2-4": "NO", "3-4": "YES", "4-4": "YES", "6-4": "YES", "7-4": "YES", "5-0": "Unity3D", "5-1": "YES", "5-2": "YES", "5-3": "YES", "5-4": "YES" }, "cols": 5, "rows": 8 } [/block] [block:api-header] { "type": "basic", "title": "Example iOS application for testing" } [/block] here's an example iOS application that can be used to send data to Countly servers. Below you can see the instructions on how to use the example iOS application. * Clone this repo: [block:code] { "codes": [ { "code": "https://github.com/erkanyildiz/countly-sdk-samples", "language": "text" } ] } [/block] * In countly-sdk-samples directory run this command to get latest iOS SDK: [block:code] { "codes": [ { "code": "git submodule update --init --remote --merge", "language": "text" } ] } [/block] * Open CountlyTestApp.xcodeproj in ios directory and add your app key and host in AppDelegate.m on this line: [block:code] { "codes": [ { "code": "[Countly.sharedInstance start:@\"YOUR_APP_KEY\" withHost:@\"https://YOUR_API_HOST.com\"];", "language": "text" } ] } [/block] * Run project and you can see the session data immediately on your Dashboard. * You can record custom events using one of the buttons on the screen. Custom events will be sent to server within 60 seconds, then you can see them in Events section. You can edit event keys and other values in ViewController.m if you want. [block:api-header] { "type": "basic", "title": "Example Android application for testing" } [/block] * Download / clone SDK git repository https://github.com/Countly/countly-sdk-android * Open downloaded project in Android Studio. * Edit MainActivity.java in either app, or app-messaging module, specifying correct server / credentials / preferences. [block:image] { "images": [ { "image": [ "https://www.filepicker.io/api/file/GKmWWmwcTUiIB5SCNTwW", "android.png", "2434", "1340", "#15294a", "" ] } ] } [/block] * Select correct target: [block:image] { "images": [ { "image": [ "https://www.filepicker.io/api/file/DwlozDyNT1yq6VGTiUE5", "2154nqjYkdchyNgpo_P1SlrUg6yDz75BIbVYk0vOrW0.png", "1024", "580", "#1d4569", "" ] } ] } [/block] * Hit Run.