Home | History | Annotate | Download | only in compatibility
      1 <!--
      2    Copyright 2010 The Android Open Source Project 
      3 
      4    Licensed under the Apache License, Version 2.0 (the "License"); 
      5    you may not use this file except in compliance with the License.
      6    You may obtain a copy of the License at
      7 
      8        http://www.apache.org/licenses/LICENSE-2.0
      9 
     10    Unless required by applicable law or agreed to in writing, software
     11    distributed under the License is distributed on an "AS IS" BASIS,
     12    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13    See the License for the specific language governing permissions and
     14    limitations under the License.
     15 -->
     16 
     17 # Android Compatibility #
     18 
     19 Android's purpose is to establish an open platform for developers to build
     20 innovative mobile apps. Three key components work together to realize this
     21 platform.
     22 
     23 The Android Compatibility Program defines the technical details of Android
     24 platform and provides tools used by OEMs to ensure that developers apps run
     25 on a variety of devices. The Android SDK provides built-in tools that
     26 Developers use to clearly state the device features their apps require. And
     27 Android Market shows apps only to those devices that can properly run
     28 them.
     29 
     30 These pages describe the Android Compatibility Program and how to get
     31 access to compatibility information and tools. The latest version of the
     32 Android source code and compatibility program is 2.3, which 
     33 corresponded to the Gingerbread branch.
     34 
     35 ## Why build compatible Android devices? ##
     36 
     37 ### Users want a customizable device. ###
     38 
     39 A mobile phone is a highly personal, always-on, always-present gateway to
     40 the Internet. We haven't met a user yet who didn't want to customize it by
     41 extending its functionality. That's why Android was designed as a robust
     42 platform for running after-market applications.
     43 
     44 ### Developers outnumber us all. ###
     45 
     46 No device manufacturer can hope to write all the software that a person could
     47 conceivably need. We need third-party developers to write the apps users want,
     48 so the Android Open Source Project aims to make it as easy and open as
     49 possible for developers to build apps.
     50 
     51 ### Everyone needs a common ecosystem. ###
     52 
     53 Every line of code developers write to work around a particular phone's bug
     54 is a line of code that didn't add a new feature. The more compatible phones
     55 there are, the more apps there will be. By building a fully compatible Android
     56 device, you benefit from the huge pool of apps written for Android, while
     57 increasing the incentive for developers to build more of those apps.
     58 
     59 ## Android compatibility is free, and it's easy. ##
     60 
     61 If you are building a mobile device, you can follow these steps to make
     62 sure your device is compatible with Android. For more details about the
     63 Android compatibility program in general, see [the program overview](overview.html).
     64 
     65 Building a compatible device is a three-step process:
     66 
     67 1. *Obtain the Android software source code*.
     68     This is [the source code for the Android platform](/source/index.html), that you port to your hardware.
     69 
     70 1. *Comply with Android Compatibility Definition Document (CDD)*.
     71     The CDD enumerates the software and hardware requirements of a compatible Android device.
     72 
     73 1. *Pass the Compatibility Test Suite (CTS)*.
     74     You can use the CTS (included in the Android source code) as an ongoing aid to compatibility during the development process.
     75 
     76 # Joining the Ecosystem #
     77 
     78 Once you've built a compatible device, you may wish to include Android
     79 Market to provide your users access to the third-party app ecosystem.
     80 Unfortunately, for a variety of legal and business reasons, we aren't able to
     81 automatically license Android Market to all compatible devices. To inquire
     82 about access about Android Market, you can [contact us](contact-us.html).
     83