{"__v":40,"_id":"54367fe7d0ffee0e00f18ebf","category":{"__v":4,"_id":"55a964c102becf2d007aad11","project":"541c6d8251a68c3b45b9ada7","version":"541c6d8251a68c3b45b9adaa","pages":["55a9652602becf2d007aad12","55a966cd5d3abb0d0012f25e","55b232ee23806c1900a9931d","55d1e56a3c74062300aee44a"],"reference":false,"createdAt":"2015-07-17T20:25:37.640Z","from_sync":false,"order":2,"slug":"official-sdks","title":"Official SDKs"},"is_link":false,"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_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"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":""},"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 & Mac OS X SDK](https://github.com/Countly/countly-sdk-ios) and [documentation page](doc:countly-sdk-for-ios-and-os-x)\n* [Icenium, Cordova & Meteorjs SDK](https://github.com/Countly/countly-sdk-js) and [documentation page](doc:phonegap-icenium-meteor)\n* [Web SDK](https://github.com/countly/countly-sdk-web) to track mobile HTML sites and [documentation page](doc:countly-sdk-for-web)\n* [Unity SDK](https://github.com/Countly/countly-sdk-unity) and [documentation page](http://resources.count.ly/docs/countly-sdk-for-unity)\n* [Xamarin SDK](https://github.com/Countly/countly-sdk-xamarin) and [documentation page](http://resources.count.ly/docs/countly-sdk-for-xamarin)\n* [Windows Phone SDK](https://github.com/Countly/countly-sdk-windows-phone) and  [documentation page](doc:countly-sdk-for-windows-phone) \n* [Analytics for Apple Watch](doc:apple-watch-analytics)\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* [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* [Meteorjs SDK](https://atmospherejs.com/countly/countly-sdk-js)\n* [Unity SDK](https://github.com/imkira/unity-countly)\n* [Cocos2d-x SDK](https://github.com/shadow0162/countly-sdk-cocos2d-x)\n* [Mac OSX SDK](https://github.com/mrballoon/countly-sdk-osx)\n* Another [iOS and Mac OS X SDK](https://github.com/benoitsan/countly-sdk-cocoa) \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]\n\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\": \"Unity\",\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\": \"YES\",\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\": \"ActionScript 3\",\n    \"7-1\": \"YES\",\n    \"7-2\": \"NO\",\n    \"7-3\": \"NO\",\n    \"8-0\": \"Corona\",\n    \"9-0\": \"Blackberry\",\n    \"9-1\": \"YES\",\n    \"8-1\": \"YES\",\n    \"8-2\": \"NO\",\n    \"9-2\": \"NO\",\n    \"8-3\": \"NO\",\n    \"9-3\": \"NO\",\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\": \"NO\",\n    \"7-4\": \"NO\",\n    \"8-4\": \"NO\",\n    \"9-4\": \"NO\",\n    \"10-0\": \"Titanium Appcelerator\",\n    \"10-1\": \"YES\",\n    \"10-2\": \"YES\",\n    \"10-3\": \"YES\",\n    \"10-4\": \"NO\",\n    \"5-0\": \"Xamarin\",\n    \"5-1\": \"YES\",\n    \"5-2\": \"YES\",\n    \"5-3\": \"YES\",\n    \"5-4\": \"NO\"\n  },\n  \"cols\": 5,\n  \"rows\": 11\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:@\\\"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\n\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":"","slug":"downloading-sdks","type":"basic","title":"Downloading & installing SDKs"}

Downloading & installing SDKs


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 & Mac OS X SDK](https://github.com/Countly/countly-sdk-ios) and [documentation page](doc:countly-sdk-for-ios-and-os-x) * [Icenium, Cordova & Meteorjs SDK](https://github.com/Countly/countly-sdk-js) and [documentation page](doc:phonegap-icenium-meteor) * [Web SDK](https://github.com/countly/countly-sdk-web) to track mobile HTML sites and [documentation page](doc:countly-sdk-for-web) * [Unity SDK](https://github.com/Countly/countly-sdk-unity) and [documentation page](http://resources.count.ly/docs/countly-sdk-for-unity) * [Xamarin SDK](https://github.com/Countly/countly-sdk-xamarin) and [documentation page](http://resources.count.ly/docs/countly-sdk-for-xamarin) * [Windows Phone SDK](https://github.com/Countly/countly-sdk-windows-phone) and [documentation page](doc:countly-sdk-for-windows-phone) * [Analytics for Apple Watch](doc:apple-watch-analytics) [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. * [Titanium Appcelerator SDK (iOS)](https://github.com/dieskim/countly-sdk-titanium-ios) * [Titanium Appcelerator SDK (Android)](https://github.com/dieskim/countly-sdk-titanium-android) * [Meteorjs SDK](https://atmospherejs.com/countly/countly-sdk-js) * [Unity SDK](https://github.com/imkira/unity-countly) * [Cocos2d-x SDK](https://github.com/shadow0162/countly-sdk-cocos2d-x) * [Mac OSX SDK](https://github.com/mrballoon/countly-sdk-osx) * Another [iOS and Mac OS X SDK](https://github.com/benoitsan/countly-sdk-cocoa) * [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] [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": "Unity", "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": "YES", "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": "ActionScript 3", "7-1": "YES", "7-2": "NO", "7-3": "NO", "8-0": "Corona", "9-0": "Blackberry", "9-1": "YES", "8-1": "YES", "8-2": "NO", "9-2": "NO", "8-3": "NO", "9-3": "NO", "h-4": "Crash reports", "0-4": "YES", "1-4": "YES", "2-4": "NO", "3-4": "YES", "4-4": "YES", "6-4": "NO", "7-4": "NO", "8-4": "NO", "9-4": "NO", "10-0": "Titanium Appcelerator", "10-1": "YES", "10-2": "YES", "10-3": "YES", "10-4": "NO", "5-0": "Xamarin", "5-1": "YES", "5-2": "YES", "5-3": "YES", "5-4": "NO" }, "cols": 5, "rows": 11 } [/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.