Skyler Kaufman | 4443691 | 2011-04-07 15:11:52 -0700 | [diff] [blame] | 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 | |
Skyler Kaufman | 991ae4d | 2011-04-07 12:30:41 -0700 | [diff] [blame] | 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 |
Jean-Baptiste Queru | 822f529 | 2012-04-16 12:50:06 -0700 | [diff] [blame] | 24 | platform and provides tools used by OEMs to ensure that developers' apps run |
Skyler Kaufman | 991ae4d | 2011-04-07 12:30:41 -0700 | [diff] [blame] | 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 |
Jean-Baptiste Queru | 822f529 | 2012-04-16 12:50:06 -0700 | [diff] [blame] | 27 | Google Play shows apps only to those devices that can properly run |
Skyler Kaufman | 991ae4d | 2011-04-07 12:30:41 -0700 | [diff] [blame] | 28 | them. |
| 29 | |
| 30 | These pages describe the Android Compatibility Program and how to get |
Brian Muramatsu | a842527 | 2011-12-21 12:27:12 -0800 | [diff] [blame] | 31 | access to compatibility information and tools. |
Skyler Kaufman | 991ae4d | 2011-04-07 12:30:41 -0700 | [diff] [blame] | 32 | |
| 33 | ## Why build compatible Android devices? ## |
| 34 | |
| 35 | ### Users want a customizable device. ### |
| 36 | |
| 37 | A mobile phone is a highly personal, always-on, always-present gateway to |
| 38 | the Internet. We haven't met a user yet who didn't want to customize it by |
| 39 | extending its functionality. That's why Android was designed as a robust |
| 40 | platform for running after-market applications. |
| 41 | |
| 42 | ### Developers outnumber us all. ### |
| 43 | |
| 44 | No device manufacturer can hope to write all the software that a person could |
| 45 | conceivably need. We need third-party developers to write the apps users want, |
| 46 | so the Android Open Source Project aims to make it as easy and open as |
| 47 | possible for developers to build apps. |
| 48 | |
| 49 | ### Everyone needs a common ecosystem. ### |
| 50 | |
| 51 | Every line of code developers write to work around a particular phone's bug |
| 52 | is a line of code that didn't add a new feature. The more compatible phones |
| 53 | there are, the more apps there will be. By building a fully compatible Android |
| 54 | device, you benefit from the huge pool of apps written for Android, while |
| 55 | increasing the incentive for developers to build more of those apps. |
| 56 | |
| 57 | ## Android compatibility is free, and it's easy. ## |
| 58 | |
| 59 | If you are building a mobile device, you can follow these steps to make |
| 60 | sure your device is compatible with Android. For more details about the |
| 61 | Android compatibility program in general, see [the program overview](overview.html). |
| 62 | |
| 63 | Building a compatible device is a three-step process: |
| 64 | |
| 65 | 1. *Obtain the Android software source code*. |
| 66 | This is [the source code for the Android platform](/source/index.html), that you port to your hardware. |
| 67 | |
| 68 | 1. *Comply with Android Compatibility Definition Document (CDD)*. |
| 69 | The CDD enumerates the software and hardware requirements of a compatible Android device. |
| 70 | |
| 71 | 1. *Pass the Compatibility Test Suite (CTS)*. |
| 72 | You can use the CTS (included in the Android source code) as an ongoing aid to compatibility during the development process. |
| 73 | |
| 74 | # Joining the Ecosystem # |
| 75 | |
Jean-Baptiste Queru | 822f529 | 2012-04-16 12:50:06 -0700 | [diff] [blame] | 76 | Once you've built a compatible device, you may wish to include Google |
| 77 | Play to provide your users access to the third-party app ecosystem. |
Skyler Kaufman | 991ae4d | 2011-04-07 12:30:41 -0700 | [diff] [blame] | 78 | Unfortunately, for a variety of legal and business reasons, we aren't able to |
Jean-Baptiste Queru | 822f529 | 2012-04-16 12:50:06 -0700 | [diff] [blame] | 79 | automatically license Google Play to all compatible devices. To inquire |
| 80 | about access about Google Play, you can [contact us](contact-us.html). |