Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 87cee816 authored by Scott Main's avatar Scott Main Committed by Android Git Automerger
Browse files

am 50e990c6: Massive clobber of all HTML files in developer docs for new site design

* commit '50e990c6':
  Massive clobber of all HTML files in developer docs for new site design
parents 7db989b3 50e990c6
Loading
Loading
Loading
Loading
+44 −0
Original line number Diff line number Diff line
<ul id="nav">
  
<li class="nav-section">
    <div class="nav-section-header"><a href="<?cs var:toroot?>about/index.html">Welcome</a></div>
    <ul>    
     <!-- <li><a href="<?cs var:toroot ?>about/marketplace.html">Open Marketplace</a></li>
    
       <li><a href="<?cs var:toroot ?>about/flexible.html">Flexible Framework</a></li>
    -->
      <li><a href="<?cs var:toroot?>about/start.html">Get Started</a></li>
    </ul>
  </li> 

  <li class="nav-section">
    <div class="nav-section-header"><a href="<?cs var:toroot ?>about/versions/android-4.0-highlights.html">
      <span class="en">Ice Cream Sandwich</span></a></div>
      <ul>
        <li><a href="<?cs var:toroot ?>about/versions/android-4.0.3.html">Android 4.0.3 APIs</a></li>
        <li><a href="<?cs var:toroot ?>about/versions/android-4.0.html">Android 4.0 APIs</a> </li>
      </ul>
  </li>
  <li class="nav-section">
    <div class="nav-section-header"><a href="<?cs var:toroot ?>about/versions/android-3.0-highlights.html">
      <span class="en">Honeycomb</span></a></div>
      <ul>
        <li><a href="<?cs var:toroot ?>about/versions/android-3.2.html">Android 3.2 APIs</a></li>
        <li><a href="<?cs var:toroot ?>about/versions/android-3.1.html">Android 3.1 APIs</a></li>
        <li><a href="<?cs var:toroot ?>about/versions/android-3.0.html">Android 3.0 APIs</a> </li>
      </ul>
  </li>
  <li class="nav-section">
    <div class="nav-section-header"><a href="<?cs var:toroot ?>about/versions/android-2.3-highlights.html">
      <span class="en">Gingerbread</span></a></div>
      <ul>
        <li><a href="<?cs var:toroot ?>about/versions/android-2.3.4.html">Android 2.3.4 APIs</a></li>
        <li><a href="<?cs var:toroot ?>about/versions/android-2.3.3.html">Android 2.3.3 APIs</a></li>
      </ul>
  </li>
  <li class="nav-section">
    <div class="nav-section-header empty"><a href="<?cs
var:toroot?>about/dashboards/index.html">Dashboards</a></div>
  </li>

</ul>
 No newline at end of file
+235 −0
Original line number Diff line number Diff line
page.title=Dashboards
header.hide=1
@jd:body



<h2 id="Platform">Platform Versions</h2>

<p>This page provides data about the relative number of active devices
running a given version of the Android platform. This can help you
understand the landscape of device distribution and decide how to prioritize
the development of your application features for the devices currently in
the hands of users. For information about how to target your application to devices based on
platform version, read about <a 
href="{@docRoot}guide/topics/manifest/uses-sdk-element.html#ApiLevels">API levels</a>.</p>


<h3 id="PlatformCurrent">Current Distribution</h3>

<p>The following pie chart and table is based on the number of Android devices that have accessed
Google Play within a 14-day period ending on the data collection date noted below.</p>

<div class="col-6" style="margin-left:0">


<table>
<tr>
  <th>Version</th>
  <th>Codename</th>
  <th>API Level</th>
  <th>Distribution</th>
</tr>
<tr><td><a href="/about/versions/android-1.5.html">1.5</a></td><td>Cupcake</td>  <td>3</td><td>0.3%</td></tr>
<tr><td><a href="/about/versions/android-1.6.html">1.6</a></td><td>Donut</td>    <td>4</td><td>0.6%</td></tr>
<tr><td><a href="/about/versions/android-2.1.html">2.1</a></td><td>Eclair</td>   <td>7</td><td>5.2%</td></tr>
<tr><td><a href="/about/versions/android-2.2.html">2.2</a></td><td>Froyo</td>    <td>8</td><td>19.1%</td></tr>
<tr><td><a href="/about/versions/android-2.3.html">2.3 - 2.3.2</a>
                                   </td><td rowspan="2">Gingerbread</td>    <td>9</td><td>0.4%</td></tr>
<tr><td><a href="/about/versions/android-2.3.3.html">2.3.3 - 2.3.7
        </a></td><!-- Gingerbread -->                                       <td>10</td><td>64.6%</td></tr>
<tr><td><a href="/about/versions/android-3.1.html">3.1</a></td>
                                                   <td rowspan="2">Honeycomb</td>      <td>12</td><td>0.7%</td></tr>
<tr><td><a href="/about/versions/android-3.2.html">3.2</a></td><!-- Honeycomb --><td>13</td><td>2%</td></tr> 
<tr><td><a href="/about/versions/android-4.0.html">4.0 - 4.0.2</a></td>
                                                <td rowspan="2">Ice Cream Sandwich</td><td>14</td><td>0.4%</td></tr> 
<tr><td><a href="/about/versions/android-4.0.3.html">4.0.3 - 4.0.4</a>     </td><!-- ICS     -->  <td>15</td><td>6.7%</td></tr> 
</table>


</div>

<div class="col-7" style="margin-right:0">
<img alt=""
src="http://chart.apis.google.com/chart?&cht=p&chs=460x250&chd=t:0.3,0.6,5.2,19.1,0.4,64.6,0.7,2.0,0.4,6.7&chl=Android%201.5|Android%201.6|Android%202.1|Android%202.2|Android%202.3|Android%202.3.3|Android%203.1|Android%203.2|Android%204.0|Android%204.0.3&chco=c4df9b,6fad0c&chf=bg,s,00000000" />

</div><!-- end dashboard-panel -->

<p style="clear:both"><em>Data collected during a 14-day period ending on June 1, 2012</em></p>
<!--
<p style="font-size:.9em">* <em>Other: 0.1% of devices running obsolete versions</em></p>
-->

<h3 id="PlatformHistorical">Historical Distribution</h3>

<p>The following stacked line graph provides a history of the relative number of
active Android devices running different versions of the Android platform. It also provides a
valuable perspective of how many devices your application is compatible with, based on the
platform version.</p>

<p>Notice that the platform versions are stacked on top of each other with the oldest active
version at the top. This format indicates the total percent of active devices that are compatible
with a given version of Android. For example, if you develop your application for
the version that is at the very top of the chart, then your application is
compatible with 100% of active devices (and all future versions), because all Android APIs are
forward compatible. Or, if you develop your application for a version lower on the chart,
then it is currently compatible with the percentage of devices indicated on the y-axis, where the
line for that version meets the y-axis on the right.</p>

<p>Each dataset in the timeline is based on the number of Android devices that accessed
Google Play within a 14-day period ending on the date indicated on the x-axis.</p>

<img alt="" height="250" width="660"
src="http://chart.apis.google.com/chart?&cht=lc&chs=660x250&chxt=x,x,y,r&chxr=0,0,12|1,0,12|2,0,100|3,0,100&chxl=0%3A%7C12/01%7C12/15%7C01/01%7C01/15%7C02/01%7C02/15%7C03/01%7C03/15%7C04/01%7C04/15%7C05/01%7C05/15%7C06/01%7C1%3A%7C2011%7C%7C2012%7C%7C%7C%7C%7C%7C%7C%7C%7C%7C2012%7C2%3A%7C0%25%7C25%25%7C50%25%7C75%25%7C100%25%7C3%3A%7C0%25%7C25%25%7C50%25%7C75%25%7C100%25&chxp=0,0,1,2,3,4,5,6,7,8,9,10,11,12&chxtc=0,5&chd=t:98.6,98.5,98.3,98.2,98.6,98.4,98.4,98.6,98.5,98.6,98.8,98.7,98.9|97.3,97.3,97.2,97.2,97.6,97.5,97.6,97.8,97.8,97.9,98.1,98.1,98.3|87.7,88.1,88.7,89.2,89.9,90.3,90.8,91.4,91.8,92.1,92.5,92.7,93.1|52.4,55.2,58.2,60.1,62.0,63.7,65.2,66.8,68.6,69.9,71.5,72.6,74.0|2.3,2.6,3.5,3.6,4.0,4.1,4.3,4.6,5.5,6.5,7.6,8.2,9.4|1.2,1.3,2.0,2.2,2.6,3.0,3.2,3.5,4.5,5.5,6.6,7.4,8.7|0.0,0.0,0.3,0.4,0.7,0.8,1.1,1.3,2.3,3.3,4.4,5.3,6.7&chm=b,c3df9b,0,1,0|b,b6dc7d,1,2,0|tAndroid%202.2,5b831d,2,0,15,,t::-5|b,aadb5e,2,3,0|tAndroid%202.3.3,496c13,3,0,15,,t::-5|b,9ddb3d,3,4,0|b,91da1e,4,5,0|b,80c414,5,6,0|B,6fad0c,6,7,0&chg=7,25&chdl=Android%201.6|Android%202.1|Android%202.2|Android%202.3.3|Android%203.1|Android%203.2|Android%204.0.3&chco=add274,a0d155,94d134,84c323,73ad18,62960f,507d08&chf=bg,s,00000000" />

<p><em>Last historical dataset collected during a 14-day period ending on June 1, 2012</em></p>
























<h2 id="Screens">Screen Sizes and Densities</h2>

<p>This section provides data about the relative number of active devices that have a particular
screen configuration, defined by a combination of screen size and density. To simplify the way that
you design your user interfaces for different screen configurations, Android divides the range of
actual screen sizes and densities into:</p> 
 
<ul> 
<li>A set of four generalized <strong>sizes</strong>: <em>small</em>, <em>normal</em>,
<em>large</em>, and <em>xlarge</em></em></li>
<li>A set of four generalized <strong>densities</strong>: <em>ldpi</em> (low), <em>mdpi</em>
(medium), <em>hdpi</em> (high), and <em>xhdpi</em> (extra high)</li>
</ul> 

<p>For information about how you can support multiple screen configurations in your
application, see <a href="{@docRoot}guide/practices/screens_support.html">Supporting Multiple
Screens</a>.</p>

<p class="note"><strong>Note:</strong> This data is based on the number
of Android devices that have accessed Google Play within a 7-day period
ending on the data collection date noted below.</p>


<div class="col-6" style="margin-left:0">


<table>
<tr>
<th></th>
<th scope="col">ldpi</th>
<th scope="col">mdpi</th>
<th scope="col">hdpi</th>
<th scope="col">xhdpi</th>
</tr>
<tr><th scope="row">small</th> 
<td>2.3%</td>     <!-- small/ldpi -->
<td></td>     <!-- small/mdpi -->
<td>2.4%</td> <!-- small/hdpi -->
<td></td>     <!-- small/xhdpi -->
</tr> 
<tr><th scope="row">normal</th> 
<td>0.7%</td>  <!-- normal/ldpi -->
<td>26.2%</td> <!-- normal/mdpi -->
<td>57.8%</td> <!-- normal/hdpi -->
<td>0.9%</td>      <!-- normal/xhdpi -->
</tr> 
<tr><th scope="row">large</th> 
<td>0.3%</td>     <!-- large/ldpi -->
<td>2%</td> <!-- large/mdpi -->
<td></td>     <!-- large/hdpi -->
<td></td>     <!-- large/xhdpi -->
</tr> 
<tr><th scope="row">xlarge</th> 
<td></td>     <!-- xlarge/ldpi -->
<td>7.4%</td> <!-- xlarge/mdpi -->
<td></td>     <!-- xlarge/hdpi -->
<td></td>     <!-- xlarge/xhdpi -->
</tr> 
</table>


</div>

<div class="col-7" style="margin-right:0">
<img alt=""
src="http://chart.googleapis.com/chart?cht=p&chs=400x250&chco=c4df9b,6fad0c&chl=Xlarge%20/%20mdpi|Large%20/%20ldpi|Large%20/%20mdpi|Normal%20/%20hdpi|Normal%20/%20ldpi|Normal%20/%20mdpi|Normal%20/%20xhdpi|Small%20/%20hdpi|Small%20/%20ldpi&chd=t%3A7.4,0.3,2.0,57.8,0.7,26.2,0.9,2.4,2.3&chf=bg,s,00000000" />

</div>

<p style="clear:both"><em>Data collected during a 7-day period ending on May 1, 2012</em></p>











<h2 id="OpenGL">Open GL Version</h2>

<p>This section provides data about the relative number of active devices that support a particular
version of OpenGL ES. Note that support for one particular version of OpenGL ES also implies
support for any lower version (for example, support for version 2.0 also implies support for
1.1).</p>

<p>To declare which version of OpenGL ES your application requires, you should use the {@code
android:glEsVersion} attribute of the <a
href="{@docRoot}guide/topics/manifest/uses-feature-element.html">{@code &lt;uses-feature&gt;}</a>
element. You can also use the <a
href="{@docRoot}guide/topics/manifest/supports-gl-texture-element.html">{@code
&lt;supports-gl-texture&gt;}</a> element to declare the GL compression formats that your application
uses.</p>

<p class="note"><strong>Note:</strong> This data is based on the number
of Android devices that have accessed Google Play within a 7-day period
ending on the data collection date noted below.</p>


<div class="col-6" style="margin-left:0">
<table>
<tr>
<th scope="col">OpenGL ES Version</th>
<th scope="col">Distribution</th>
</tr>
<tr>
<td>1.1 only</th>
<td>9.9%</td>
</tr>
<tr>
<td>2.0 &amp; 1.1</th>
<td>90.1%</td>
</tr>
</table>
</div>

<div class="col-7" style="margin-right:0">
<img alt=""
src="http://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%3A9.9,90.1&chf=bg,s,00000000" />

</div>


<p style="clear:both"><em>Data collected during a 7-day period ending on June 4, 2012</em></p>
+34 −0
Original line number Diff line number Diff line
page.title=Flexible Framework
walkthru=1

@jd:body

<style>
blockquote {
  color:#9933CC;
}
</style>

<blockquote>Android's flexible framework means it runs on more devices and reaches more
users</blockquote>

<p>Android powers millions of devices around the world and in a variety of form-factors. The Android
framework is specially built to run apps on more than just one screen size and hardware
configuration. As an app developer, Android's scale and variety offers you the potential to quickly
reach millions of users.</p>

<p>Android apps are flexible and easily adapt to the device on which they are running. Although the
system scales your assets when necessary, you can provide alternative app resources that are
optimized for specific device categories, such as the screen size and density. Android applies the
appropriate resources when running your app, based on the current device’s configuration.</p>

<blockquote>You're in control of which devices can install your app</blockquote>

<p>Some devices provide a different user experience when using apps, but you’re always in control of
how your app behaves on each device. If you publish your app on Google Play, you also have
control over which kinds of devices are allowed to install your app and you can closely control how
your app is distributed.</p>

<p>Every device that includes Google Play has been certified compatible. This means that
the device has passed a rigorous test suite to ensure that the device uses a version of Android that
supports all the platform APIs and will successfully run your app.</p>
 No newline at end of file
+157 −0
Original line number Diff line number Diff line
page.title=Android, the world's most popular mobile platform
walkthru=0
header.hide=0

@jd:body

<div style="position:absolute;width:440px;">
<p>Android powers hundreds of millions of mobile devices in more than 190
countries around the world. It's the largest installed base of any mobile platform
and growing fast&mdash;every day another 900,000 users power up their
Android devices for the first time and start looking for apps, games,
and other digital content. </p>

<div style="width:330px">
<p>Android gives you a world-class platform for creating apps and games for
Android users everywhere, as well as an open marketplace for distributing
to them instantly.</p>
</div>
</div>

<img src="{@docRoot}images/about/growth-chart.png" alt="" height="400" width="681"
style="margin:20px 0 10px 30px;" />
<div style="position:relative;left: 450px;width: 250px;top: -20px;color: #777;">
  <em>Android growth in device activations</em></div>


<h3>Global partnerships and large installed base</h3>

<p>Building on the contributions of the open-source Linux community and more
than 300 hardware, software, and carrier partners, Android has rapidly become
the fastest-growing mobile OS.</p>

<blockquote>Every day more than 900,000 new Android devices are activated worldwide.</blockquote>

<p>Android’s openness has made it a favorite for consumers and developers alike,
driving strong growth in app consumption. Android users download more than 
1 billion apps and games from Google Play each month. </p>

<p>With it's partners, Android is continuously pushing the boundaries of hardware and software
forward to bring new capabilities to users and developers. For developers, 
Android innovation lets you build powerful, differentiated applications
that use the latest mobile technologies.</p>

<!-- <h3>Rapid innovation</h3>

<p>Android is continuously pushing the boundaries of hardware and software
forward, to bring new capabilities to users and developers. For developers, the
rapid evolution of Android technology lets you stay in front with powerful,
differentiated applications.</p>

<p>Android gives you access to the latest technologies and innovations across a
multitude of device form-factors, chipset architectures, and price points. From
multicore processing and high-performance graphics to state-of-the-art sensors,
vibrant touchscreens, and emerging mobile technologies such as Near Field
Communication (NFC), Wi-Fi Direct, and face tracking.</p> -->

<h3>Powerful development framework</h3>

<blockquote>Easily optimize a single binary for phones, tablets, and other devices.</blockquote>

<p>Android gives you everything you need to build best-in-class app experiences.
It gives you a single application model that lets you deploy
your apps broadly to hundreds of millions of users across a wide range of
devices&mdash;from phones to tablets and beyond.</p>

<p>Android also gives you tools for creating apps that look great and take
advantage of the hardware capabilities available on each device. It
automatically adapts your UI to look it's best on each device, while giving you
as much control as you want over your UI on different device
types. </p> 

<p>For example, you can create a single app binary that's optimized for
both phone and tablet form factors. You declare your UI in lightweight sets of XML
resources, one set for parts of the UI that are common to all form factors and
other sets for optimzations specific to phones or tablets.
At runtime, Android applies the correct resource sets based on its screen size,
density, locale,
and so on.</p>


<p>To help you develop efficiently, the <a href="{@docRoot}tools/index.html">Android 
    Developer Tools</a>
offers a full Java IDE with advanced features for developing, debugging, and
packaging Android apps. Using the IDE, you can develop on any available Android
device or create virtual devices that emulate any hardware configuration.</p>

<blockquote>A billion downloads a month and growing. Get your apps in front
of millions of users at Google's scale.</blockquote>

<h3>Open marketplace for distributing your apps</h3>

<p>Google Play is the premier marketplace for selling and distributing Android apps.
When you publish an app on Google Play, you reach the huge installed base of
Android.</p>

<div style="float:left;margin-right:24px;margin-top:12px;">
<img src="{@docRoot}images/gp-device.png">
</div>

<p>As an open marketplace, Google Play puts you in control of how you sell your
products. You can publish whenever you want, as often as you want, and to the
customers you want. You can distribute broadly to all markets and
devices or focus on specific segments, devices, or ranges of hardware
capabilities.</p>

<p>You can monetize in the way that works best for your business&mdash;priced or
free, with in-app products or subscriptions&mdash;for highest engagement and
revenues. You also have complete control of the pricing for your apps
and in-app products and can set or change prices in any supported currency at
any time.<p>

<p>Beyond growing your customer base, Google Play helps you build visibility and
engagement across your apps and brand. As your apps rise in popularity, Google
Play gives them higher placement in weekly "top" charts and rankings, and for
the best apps promotional slots in curated collections.
</p>

<p>Preinstalled on hundreds of millions of Android devices around the world,
Google Play can be a growth engine for your business.</p>

<p><a class="landing-page-link" href="{@docRoot}about/start.html">GET STARTED</a></p>

<div style="background: #F0F0F0;
            border-top: 1px solid #DDD;
            padding: 20px 0 24px 0;
            overflow: auto;
            clear:both;
            margin-bottom:-10px;
            margin-top:60px;"">
   <div style="padding:0 0 0 29px;">
        <h4>Developer Story: Robot Invader</h4>
          <img alt="" class="screenshot thumbnail" style="-webkit-border-radius: 5px;
            -moz-border-radius: 5px;
            border-radius: 5px height:78px;
            width: 78px;
            float: left;
            margin: 17px 20px 9px 0;" src=
            "//g0.gstatic.com/android/market/com.robotinvader.knightmare/hi-256-0-9e08d83bc8d01649e167131d197ada1cd1783fb0">
          <div style="width:700px;">
          <p style="margin-top:26px;margin-bottom:12px;">Robot Invader chose 
              Android as the launch platform for their first game, 
              <a data-g-event="Developers Page" data-g-label="Case Study Link" href=
              "//play.google.com/store/apps/details?id=com.robotinvader.knightmare"><em>Wind-up
              Knight</em></a>.
           </p>
           <p>
              Hear from the developers themselves how Android helped them reach more
              than 100 devices with a single app binary, then iterate rapidly to ensure
              a great experience for users.
           </p>
           </div>
           <iframe style="float:left;
             margin-right:24px;
             margin-top:14px;" width="700" height="394" src=
             "http://www.youtube.com/embed/hTtlLiUTowY" frameborder="0" allowfullscreen></iframe>
   </div> 
</div>
 No newline at end of file
+62 −0
Original line number Diff line number Diff line
page.title=Open Marketplace
walkthru=1

@jd:body

<style>
blockquote {
  color:#9933CC;
}
</style>

<p>Android offers an open distribution model, not a walled garden. Once you’ve developed an
app for Android and want to distribute it, you have choice.</p>

<p>Your final application is contained in an APK file that you can make available to users any
way you want. For example, you can upload it to your own web site to allow visitors to
install it onto their devices. More often, you’ll want to use a trusted
marketplace where users can discover and search for your apps.</p>

<p>How you choose to distribute your app affects precisely how many users your app will reach. Which
distribution provider you choose also affects the kinds of services available to you as a publisher,
such as licensing and in-app billing APIs, user bug reports, installation analytics, marketing
services, and more.</p>

<p>Among your choices is Google Play, the premier marketplace for selling and distributing apps
to Android users around the world. When you publish an app on Google Play, you reach hundreds of
millions of customers in over 130 countries.</p>


<h3>Your business, your customers</h3>

<blockquote>Google Play makes your apps available to your customers
immediately</blockquote>

<p>As an open marketplace, Google Play puts you in control of your business and makes it easy for
you to manage how you sell your products. You can publish whenever you want, as often as you want,
and to the exact set of customers you want.</p>


<h3>Visibility for your apps</h3>

<p>Beyond growing your customer base, Google Play helps you build visibility and engagement across
your apps and brand. As your apps rise in popularity, Google Play gives you higher placement in
weekly "top" lists and offers promotional slots in curated collections. You can engage customers
using rich, colorful product pages that feature app screenshots, videos, and user reviews, as well
as cross-marketing links to your other products.</p>

<h3>Flexible monetizing and distribution</h3>

<blockquote class="right">You can distribute
your apps free or priced and you can sell in-app products for additional revenue</blockquote>

<p>Google Play offers a choice of monetizing options to meet your business needs. You control the
pricing of your apps and in-app products&mdash;you can set and change prices at any time, even
individually in local currencies around the world. On purchase, Google Play handles transactions in
the buyer’s currency and makes payouts in your own currency.</p>


<p>After publishing, you can manage the distribution of your app. You can distribute broadly to all
markets and devices or focus on specific segments, devices, or ranges of hardware capabilities.
Google Play provides the tools for controlling distribution and ensures that your app is available
only to the users who you are targeting.</p>
Loading