index.jd revision 847480c6d1c1ecd4d6e0242d4fb8e3afb2a07198
1page.title=Dashboards 2@jd:body 3 4<style> 5div.chart, 6div.screens-chart { 7 display:none; 8} 9tr .total { 10 background-color:transparent; 11 border:0; 12 color:#666; 13} 14tr th.total { 15 font-weight:bold; 16} 17</style> 18 19 20 21 22<div class="sidebox"> 23<h2>Google Play Install Stats</h2> 24<p>The Google Play Developer Console also provides <a 25href="{@docRoot}distribute/googleplay/about/distribution.html#stats">detailed statistics</a> 26about your users' devices. Those stats may help you prioritize the device profiles for which 27you optimize your app.</p> 28</div> 29 30<p>This page provides information about the relative number of devices that share a certain 31characteristic, such as Android version or screen size. This information may 32help you prioritize efforts for <a 33href="{@docRoot}training/basics/supporting-devices/index.html">supporting different devices</a> 34by revealing which devices are active in the Android and Google Play ecosystem.</p> 35 36<p>This data reflects devices running the latest Google Play Store app, which is compatible 37with Android 2.2 and higher. Each snapshot of data represents all the devices that visited the 38Google Play Store in the prior 7 days.</p> 39 40 41<div class="note"> 42<p><strong>Note:</strong> Beginning in September, 2013, devices running versions older than Android 432.2 do not appear in this data because those devices do not support the new Google Play Store 44app. Only the new app is able to measure the number of devices that actively visit Google Play Store 45and we believe this measurement best reflects your potential user-base.</p> 46</div> 47 48 49<h2 id="Platform">Platform Versions</h2> 50 51<p>This section provides data about the relative number of devices running a given version of 52the Android platform.</p> 53 54<p>For information about how to target your application to devices based on 55platform version, read <a 56href="{@docRoot}training/basics/supporting-devices/platforms.html">Supporting Different 57Platform Versions</a>.</p> 58 59 60<div id="version-chart"> 61</div> 62 63 64<p style="clear:both"><em>Data collected during a 7-day period ending on September 4, 2013. 65<br/>Any versions with less than 0.1% distribution are not shown.</em> 66</p> 67 68<p class="note"><strong>Note:</strong> Because this data is gathered from the new Google Play 69Store app, which supports Android 2.2 and above, devices running older versions are not included. 70However, in August, 2013, versions older than Android 2.2 accounted for about 1% of devices that 71<em>checked in</em> to Google servers (not those that actually visited Google Play Store). 72</p> 73 74 75 76 77 78<h2 id="Screens">Screen Sizes and Densities</h2> 79 80 81<p>This section provides data about the relative number of devices that have a particular 82screen configuration, defined by a combination of screen size and density. To simplify the way that 83you design your user interfaces for different screen configurations, Android divides the range of 84actual screen sizes and densities into several buckets as expressed by the table below.</p> 85 86<p>For information about how you can support multiple screen configurations in your 87application, read <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple 88Screens</a>.</p> 89 90 91<div id="screens-chart"> 92</div> 93 94 95<p style="clear:both"><em>Data collected during a 7-day period ending on September 4, 2013 96<br/>Any screen configurations with less than 0.1% distribution are not shown.</em></p> 97 98 99 100 101 102 103 104 105<h2 id="OpenGL">Open GL Version</h2> 106 107<p>This section provides data about the relative number of devices that support a particular 108version of OpenGL ES. Note that support for one particular version of OpenGL ES also implies 109support for any lower version (for example, support for version 2.0 also implies support for 1101.1).</p> 111 112 113<img alt="" style="float:right" 114src="//chart.googleapis.com/chart?cht=p&chs=400x250&chco=c4df9b,6fad0c&chl=GL%201.1%20only|GL%202.0%20%26%201.1&chd=t%3A0.2,99.8&chf=bg,s,00000000" /> 115 116<p>To declare which version of OpenGL ES your application requires, you should use the {@code 117android:glEsVersion} attribute of the <a 118href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code <uses-feature>}</a> 119element. You can also use the <a 120href="{@docRoot}guide/topics/manifest/supports-gl-texture-element.html">{@code 121<supports-gl-texture>}</a> element to declare the GL compression formats that your application 122uses.</p> 123 124 125<table style="width:350px"> 126<tr> 127<th scope="col">OpenGL ES Version</th> 128<th scope="col">Distribution</th> 129</tr> 130<tr> 131<td>1.1 only</th> 132<td>0.2%</td> 133</tr> 134<tr> 135<td>2.0 & 1.1</th> 136<td>99.8%</td> 137</tr> 138</table> 139 140 141 142<p style="clear:both"><em>Data collected during a 7-day period ending on September 4, 2013</em></p> 143 144 145 146 147 148 149 150 151 152 153 154 155 156<script> 157var VERSION_DATA = 158[ 159 { 160 "chart": "//chart.googleapis.com/chart?chs=500x250&cht=p&chco=c4df9b%2C6fad0c&chd=t%3A2.4%2C30.7%2C0.1%2C21.7%2C45.1&chf=bg%2Cs%2C00000000&chl=Froyo%7CGingerbread%7CHoneycomb%7CIce%20Cream%20Sandwich%7CJelly%20Bean", 161 "data": [ 162 { 163 "api": 8, 164 "name": "Froyo", 165 "perc": "2.4" 166 }, 167 { 168 "api": 10, 169 "name": "Gingerbread", 170 "perc": "30.7" 171 }, 172 { 173 "api": 13, 174 "name": "Honeycomb", 175 "perc": "0.1" 176 }, 177 { 178 "api": 15, 179 "name": "Ice Cream Sandwich", 180 "perc": "21.7" 181 }, 182 { 183 "api": 16, 184 "name": "Jelly Bean", 185 "perc": "36.6" 186 }, 187 { 188 "api": 17, 189 "name": "Jelly Bean", 190 "perc": "8.5" 191 } 192 ] 193 } 194]; 195 196 197 198 199 200var SCREEN_DATA = 201[ 202 { 203 "data": { 204 "Large": { 205 "hdpi": "0.4", 206 "ldpi": "0.6", 207 "mdpi": "3.4", 208 "tvdpi": "1.2", 209 "xhdpi": "0.5" 210 }, 211 "Normal": { 212 "hdpi": "33.6", 213 "ldpi": "0.1", 214 "mdpi": "15.7", 215 "xhdpi": "23.1", 216 "xxhdpi": "7.1" 217 }, 218 "Small": { 219 "ldpi": "9.5" 220 }, 221 "Xlarge": { 222 "hdpi": "0.3", 223 "mdpi": "4.4", 224 "xhdpi": "0.1" 225 } 226 }, 227 "densitychart": "//chart.googleapis.com/chart?chs=400x250&cht=p&chco=c4df9b%2C6fad0c&chd=t%3A10.2%2C23.5%2C1.2%2C34.3%2C23.7%2C7.1&chf=bg%2Cs%2C00000000&chl=ldpi%7Cmdpi%7Ctvdpi%7Chdpi%7Cxhdpi%7Cxxhdpi", 228 "layoutchart": "//chart.googleapis.com/chart?chs=400x250&cht=p&chco=c4df9b%2C6fad0c&chd=t%3A4.8%2C6.1%2C79.6%2C9.5&chf=bg%2Cs%2C00000000&chl=Xlarge%7CLarge%7CNormal%7CSmall" 229 } 230]; 231 232 233 234var VERSION_NAMES = 235[ 236 {"api":0},{"api":1},{"api":2},{"api":3}, 237 { 238 "api":4, 239 "link":"<a href='/about/versions/android-1.6.html'>1.6</a>", 240 "codename":"Donut", 241 }, 242 { "api":5}, 243 { "api":6}, 244 { 245 "api":7, 246 "link":"<a href='/about/versions/android-2.1.html'>2.1</a>", 247 "codename":"Eclair", 248 }, 249 { 250 "api":8, 251 "link":"<a href='/about/versions/android-2.2.html'>2.2</a>", 252 "codename":"Froyo" 253 }, 254 { 255 "api":9, 256 "link":"<a href='/about/versions/android-2.3.html'>2.3 -<br>2.3.2</a>", 257 "codename":"Gingerbread" 258 }, 259 { 260 "api":10, 261 "link":"<a href='/about/versions/android-2.3.3.html'>2.3.3 -<br>2.3.7</a>", 262 "codename":"Gingerbread" 263 }, 264 { "api":11}, 265 { 266 "api":12, 267 "link":"<a href='/about/versions/android-3.1.html'>3.1</a>", 268 "codename":"Honeycomb" 269 }, 270 { 271 "api":13, 272 "link":"<a href='/about/versions/android-3.2.html'>3.2</a>", 273 "codename":"Honeycomb" 274 }, 275 { "api":14}, 276 { 277 "api":15, 278 "link":"<a href='/about/versions/android-4.0.html'>4.0.3 -<br>4.0.4</a>", 279 "codename":"Ice Cream Sandwich" 280 }, 281 { 282 "api":16, 283 "link":"<a href='/about/versions/android-4.1.html'>4.1.x</a>", 284 "codename":"Jelly Bean" 285 }, 286 { 287 "api":17, 288 "link":"<a href='/about/versions/android-4.2.html'>4.2.x</a>", 289 "codename":"Jelly Bean" 290 }, 291 { 292 "api":18, 293 "link":"<a href='/about/versions/android-4.3.html'>4.3</a>", 294 "codename":"Jelly Bean" 295 } 296]; 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316$(document).ready(function(){ 317 // for each set of data (each month) 318 $.each(VERSION_DATA, function(i, set) { 319 320 // set up wrapper divs 321 var $div = $('<div class="chart"' 322 + ((i == 0) ? ' style="display:block"' : '') 323 + ' >'); 324 var $divtable = $('<div class="col-5" style="margin-left:0">'); 325 var $divchart = $('<div class="col-8" style="margin-right:0">'); 326 327 // set up a new table 328 var $table = $("<table>"); 329 var $trh = $("<tr><th>Version</th>" 330 + "<th>Codename</th>" 331 + "<th>API</th>" 332 + "<th>Distribution</th></tr>"); 333 $table.append($trh); 334 335 // loop each data set (each api level represented in stats) 336 $.each(set.data, function(i, data) { 337 // check if we need to rowspan the codename 338 var rowspan = 1; 339 // must not be first row 340 if (i > 0) { 341 // if this row's codename is the same as previous row codename 342 if (data.name == set.data[i-1].name) { 343 rowspan = 0; 344 // otherwise, as long as this is not the last row 345 } else if (i < (set.data.length - 1)) { 346 // increment rowspan for each subsequent row w/ same codename 347 while (data.name == set.data[i+rowspan].name) { 348 rowspan++; 349 // unless we've reached the last row 350 if ((i + rowspan) >= set.data.length) break; 351 } 352 } 353 } 354 355 // create table row and get corresponding version info from VERSION_NAMES 356 var $tr = $("<tr>"); 357 $tr.append("<td>" + VERSION_NAMES[data.api].link + "</td>"); 358 if (rowspan > 0) { 359 $tr.append("<td rowspan='" + rowspan + "'>" + VERSION_NAMES[data.api].codename + "</td>"); 360 } 361 $tr.append("<td>" + data.api + "</td>"); 362 $tr.append("<td>" + data.perc + "%</td>"); 363 $table.append($tr); 364 }); 365 366 // create chart image 367 var $chart = $('<img style="margin-left:30px" alt="" src="' + set.chart + '" />'); 368 369 // stack up and insert the elements 370 $divtable.append($table); 371 $divchart.append($chart); 372 $div.append($divtable).append($divchart); 373 $("#version-chart").append($div); 374 }); 375 376 377 378 var SCREEN_SIZES = ["Small","Normal","Large","Xlarge"]; 379 var SCREEN_DENSITIES = ["ldpi","mdpi","tvdpi","hdpi","xhdpi","xxhdpi"]; 380 381 382 // for each set of screens data (each month) 383 $.each(SCREEN_DATA, function(i, set) { 384 385 // set up wrapper divs 386 var $div = $('<div class="screens-chart"' 387 + ((i == 0) ? ' style="display:block"' : '') 388 + ' >'); 389 390 // set up a new table 391 var $table = $("<table>"); 392 var $trh = $("<tr><th></th></tr>"); 393 $.each(SCREEN_DENSITIES, function(i, density) { 394 $trh.append("<th scope='col'>" + density + "</th>"); 395 }); 396 $trh.append("<th scope='col' class='total'>Total</th>"); 397 $table.append($trh); 398 399 // array to hold totals for each density 400 var densityTotals = new Array(SCREEN_DENSITIES.length); 401 $.each(densityTotals, function(i, total) { 402 densityTotals[i] = 0; // make them all zero to start 403 }); 404 405 // loop through each screen size 406 $.each(SCREEN_SIZES, function(i, size) { 407 // if there are any devices of this size 408 if (typeof set.data[size] != "undefined") { 409 // create table row and insert data 410 var $tr = $("<tr>"); 411 $tr.append("<th scope='row'>" + size + "</th>"); 412 // variable to sum all densities for this size 413 var total = 0; 414 // loop through each density 415 $.each(SCREEN_DENSITIES, function(i, density) { 416 var num = typeof set.data[size][density] != "undefined" ? set.data[size][density] : 0; 417 $tr.append("<td>" + (num != 0 ? num + "%" : "") + "</td>"); 418 total += parseFloat(num); 419 densityTotals[i] += parseFloat(num); 420 }) 421 $tr.append("<td class='total'>" + total.toFixed(1) + "%</td>"); 422 $table.append($tr); 423 } 424 }); 425 426 // create row of totals for each density 427 var $tr = $("<tr><th class='total'>Total</th></tr>"); 428 $.each(densityTotals, function(i, total) { 429 $tr.append("<td class='total'>" + total.toFixed(1) + "%</td>"); 430 }); 431 $table.append($tr); 432 433 // create charts 434 var $sizechart = $('<img style="float:left;width:380px" alt="" src="' 435 + set.layoutchart + '" />'); 436 var $densitychart = $('<img style="float:left;width:380px" alt="" src="' 437 + set.densitychart + '" />'); 438 439 // stack up and insert the elements 440 $div.append($table).append($sizechart).append($densitychart); 441 $("#screens-chart").append($div); 442 }); 443 444 445}); 446 447 448 449function changeVersionDate() { 450 var date = $('#date-versions option:selected').val(); 451 452 $(".chart").hide(); 453 $(".chart."+date+"").show(); 454} 455 456 457function changeScreensVersionDate() { 458 var date = $('#date-screens option:selected').val(); 459 460 $(".screens-chart").hide(); 461 $(".screens-chart."+date+"").show(); 462} 463 464</script> 465