Build.java revision 2d6833bab353e31ceb4230f3f3563fca2e0d9f6f
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.os; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongkerimport com.android.internal.telephony.TelephonyProperties; 20ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Information about the current build, extracted from system properties. 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class Build { 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Value used for when a build property is unknown. */ 2671de7851a2d1c1ef0251bdc1ea59c5e6f58cf429Ficus Kirkpatrick public static final String UNKNOWN = "unknown"; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Either a changelist number, or a label like "M4-rc20". */ 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ID = getString("ro.build.id"); 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A build ID string meant for displaying to the user */ 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String DISPLAY = getString("ro.build.display.id"); 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The name of the overall product. */ 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String PRODUCT = getString("ro.product.name"); 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The name of the industrial design. */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String DEVICE = getString("ro.product.device"); 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The name of the underlying board, like "goldfish". */ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String BOARD = getString("ro.product.board"); 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 43b181118b6e58c0014da4e9d52bf38548adc73a8aDianne Hackborn /** The name of the instruction set (CPU type + ABI convention) of native code. */ 44b181118b6e58c0014da4e9d52bf38548adc73a8aDianne Hackborn public static final String CPU_ABI = getString("ro.product.cpu.abi"); 45b181118b6e58c0014da4e9d52bf38548adc73a8aDianne Hackborn 46fa9cafa074eb5d98b49b63795cd947877df1f21dFicus Kirkpatrick /** The name of the second instruction set (CPU type + ABI convention) of native code. */ 47fa9cafa074eb5d98b49b63795cd947877df1f21dFicus Kirkpatrick public static final String CPU_ABI2 = getString("ro.product.cpu.abi2"); 48fa9cafa074eb5d98b49b63795cd947877df1f21dFicus Kirkpatrick 49d62ad4f120e92fd597f44caf125ac853ac0ea11cDianne Hackborn /** The manufacturer of the product/hardware. */ 50d62ad4f120e92fd597f44caf125ac853ac0ea11cDianne Hackborn public static final String MANUFACTURER = getString("ro.product.manufacturer"); 51d62ad4f120e92fd597f44caf125ac853ac0ea11cDianne Hackborn 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The brand (e.g., carrier) the software is customized for, if any. */ 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String BRAND = getString("ro.product.brand"); 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The end-user-visible name for the end product. */ 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String MODEL = getString("ro.product.model"); 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5874885efc8ce6d315e0593e5f669cc805e264cf68Doug Zongker /** The system bootloader version number. */ 5942471dd5552a346dd82a58a663159875ccc4fb79Dan Egnor public static final String BOOTLOADER = getString("ro.bootloader"); 6042471dd5552a346dd82a58a663159875ccc4fb79Dan Egnor 61ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker /** 62ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * The radio firmware version number. 63ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * 64ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * @deprecated The radio firmware version is frequently not 65ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * available when this class is initialized, leading to a blank or 66ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * "unknown" value for this string. Use 67ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * {@link #getRadioVersion} instead. 68ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker */ 69ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker @Deprecated 70ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker public static final String RADIO = getString(TelephonyProperties.PROPERTY_BASEBAND_VERSION); 7142471dd5552a346dd82a58a663159875ccc4fb79Dan Egnor 7274885efc8ce6d315e0593e5f669cc805e264cf68Doug Zongker /** The name of the hardware (from the kernel command line or /proc). */ 7374885efc8ce6d315e0593e5f669cc805e264cf68Doug Zongker public static final String HARDWARE = getString("ro.hardware"); 7442471dd5552a346dd82a58a663159875ccc4fb79Dan Egnor 757d2e3df60d33a73f5ef62ea462a9c6da5e3efc9aDoug Zongker /** A hardware serial number, if available. Alphanumeric only, case-insensitive. */ 767d2e3df60d33a73f5ef62ea462a9c6da5e3efc9aDoug Zongker public static final String SERIAL = getString("ro.serialno"); 777d2e3df60d33a73f5ef62ea462a9c6da5e3efc9aDoug Zongker 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Various version strings. */ 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class VERSION { 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The internal value used by the underlying source control to 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * represent this build. E.g., a perforce changelist number 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or a git hash. 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String INCREMENTAL = getString("ro.build.version.incremental"); 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The user-visible version string. E.g., "1.0" or "3.4b5". 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RELEASE = getString("ro.build.version.release"); 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 93851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * The user-visible SDK version of the framework in its raw String 94851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * representation; use {@link #SDK_INT} instead. 95851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * 96851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * @deprecated Use {@link #SDK_INT} to easily get this as an integer. 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 984a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn @Deprecated 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SDK = getString("ro.build.version.sdk"); 100851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn 101851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn /** 102851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * The user-visible SDK version of the framework; its possible 103851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * values are defined in {@link Build.VERSION_CODES}. 104851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn */ 105851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn public static final int SDK_INT = SystemProperties.getInt( 106851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn "ro.build.version.sdk", 0); 107851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn 108851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn /** 109851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * The current development codename, or the string "REL" if this is 110851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * a release build. 111851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn */ 112851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn public static final String CODENAME = getString("ro.build.version.codename"); 1133b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn 1143b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn /** 1153b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn * The SDK version to use when accessing resources. 1163b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn * Use the current SDK version code. If we are a development build, 1173b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn * also allow the previous SDK version + 1. 1183b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn * @hide 1193b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn */ 1203b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn public static final int RESOURCES_SDK_INT = SDK_INT 1213b81bc18bb661c02ad8074c39dab16644c1e65d0Dianne Hackborn + ("REL".equals(CODENAME) ? 0 : 1); 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 124851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn /** 125851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * Enumeration of the currently known SDK version codes. These are the 126851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * values that can be found in {@link VERSION#SDK}. Version numbers 127851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * increment monotonically with each official platform release. 128851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn */ 129851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn public static class VERSION_CODES { 130851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn /** 131a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * Magic version number for a current development build, which has 132a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * not yet turned into an official release. 133a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn */ 134a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn public static final int CUR_DEVELOPMENT = 10000; 135a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn 136a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn /** 137851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * October 2008: The original, first, version of Android. Yay! 138851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn */ 139851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn public static final int BASE = 1; 1400fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn 141851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn /** 142851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * February 2009: First Android update, officially called 1.1. 143851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn */ 144851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn public static final int BASE_1_1 = 2; 1450fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn 146851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn /** 147851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn * May 2009: Android 1.5. 148851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn */ 149851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn public static final int CUPCAKE = 3; 1500fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn 151a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn /** 1520fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn * September 2009: Android 1.6. 153a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * 154a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * <p>Applications targeting this or a later release will get these 155a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * new changes in behavior:</p> 156a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * <ul> 157a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * <li> They must explicitly request the 1585a3a77dabd744d5be79d7745c2a977c108a9ad98San Mehat * {@link android.Manifest.permission#WRITE_EXTERNAL_STORAGE} permission to be 159a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * able to modify the contents of the SD card. (Apps targeting 160a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * earlier versions will always request the permission.) 161fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * <li> They must explicitly request the 162fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * {@link android.Manifest.permission#READ_PHONE_STATE} permission to be 163fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * able to be able to retrieve phone state info. (Apps targeting 164fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * earlier versions will always request the permission.) 165fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * <li> They are assumed to support different screen densities and 166fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * sizes. (Apps targeting earlier versions are assumed to only support 167fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * medium density normal size screens unless otherwise indicated). 168fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * They can still explicitly specify screen support either way with the 169fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn * supports-screens manifest tag. 170a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn * </ul> 171a96cbb435d7b2197ab2b61fd98d14cbd6e0c5c3dDianne Hackborn */ 172fe77ec8e0881963714b2464efad9514d921d089aDianne Hackborn public static final int DONUT = 4; 1730fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn 174f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn /** 1750fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn * November 2009: Android 2.0 176f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * 177f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * <p>Applications targeting this or a later release will get these 178f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * new changes in behavior:</p> 179f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * <ul> 180f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * <li> The {@link android.app.Service#onStartCommand 181f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * Service.onStartCommand} function will return the new 182f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * {@link android.app.Service#START_STICKY} behavior instead of the 183f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * old compatibility {@link android.app.Service#START_STICKY_COMPATIBILITY}. 1848d37426c754e9822feaa8c6cc0b7c13e8523e217Dianne Hackborn * <li> The {@link android.app.Activity} class will now execute back 1858d37426c754e9822feaa8c6cc0b7c13e8523e217Dianne Hackborn * key presses on the key up instead of key down, to be able to detect 1868d37426c754e9822feaa8c6cc0b7c13e8523e217Dianne Hackborn * canceled presses from virtual keys. 1877609764295d1b3ec0b53d1ae536ee0280f5e0407Mike Cleron * <li> The {@link android.widget.TabWidget} class will use a new color scheme 1887609764295d1b3ec0b53d1ae536ee0280f5e0407Mike Cleron * for tabs. In the new scheme, the foreground tab has a medium gray background 1897609764295d1b3ec0b53d1ae536ee0280f5e0407Mike Cleron * the background tabs have a dark gray background. 190f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn * </ul> 191f6f9f2d0256930ce0bb4913b2260b8480914edc2Dianne Hackborn */ 1926dc3f4e553d333b9f115a222a9a684bb2aa55b5eJeff Hamilton public static final int ECLAIR = 5; 1930fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn 1940fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn /** 1951778776cf1349a5f275945c53edcd1454d58639cDianne Hackborn * December 2009: Android 2.0.1 1960fa35918af608b56fb3f6aa98341624e22447f92Dianne Hackborn */ 1971778776cf1349a5f275945c53edcd1454d58639cDianne Hackborn public static final int ECLAIR_0_1 = 6; 19823ef7b4836d66d31430fedee2aac36275bb30d4bDianne Hackborn 19923ef7b4836d66d31430fedee2aac36275bb30d4bDianne Hackborn /** 20023ef7b4836d66d31430fedee2aac36275bb30d4bDianne Hackborn * January 2010: Android 2.1 20123ef7b4836d66d31430fedee2aac36275bb30d4bDianne Hackborn */ 20223ef7b4836d66d31430fedee2aac36275bb30d4bDianne Hackborn public static final int ECLAIR_MR1 = 7; 203216bccf804db9c972b317620a27de6a8adf7fbfeAdam Powell 2043e03cfa3af8acf3aad0abc464d2bcab1225a971dDianne Hackborn /** 2053e03cfa3af8acf3aad0abc464d2bcab1225a971dDianne Hackborn * June 2010: Android 2.2 2063e03cfa3af8acf3aad0abc464d2bcab1225a971dDianne Hackborn */ 207216bccf804db9c972b317620a27de6a8adf7fbfeAdam Powell public static final int FROYO = 8; 20814cee9f688c32d63d8521188e7422811629bb7c2Dianne Hackborn 2093e03cfa3af8acf3aad0abc464d2bcab1225a971dDianne Hackborn /** 2109d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn * November 2010: Android 2.3 2113e03cfa3af8acf3aad0abc464d2bcab1225a971dDianne Hackborn */ 2124fa1a221b466d6da6c68150b38cd17b085ab5e26Dianne Hackborn public static final int GINGERBREAD = 9; 2139d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn 2149d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn /** 215edf1fc6ce642c8d0f675795635d223b26d9f825cDianne Hackborn * February 2011: Android 2.3.3. 2169d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn */ 2179d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn public static final int GINGERBREAD_MR1 = 10; 218b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 219b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 220edf1fc6ce642c8d0f675795635d223b26d9f825cDianne Hackborn * February 2011: Android 3.0. 221b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 222b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Applications targeting this or a later release will get these 223b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * new changes in behavior:</p> 224b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <ul> 2253e6d50cc484f2eee0cff63789cc7796718eb6b68Dianne Hackborn * <li> The default theme for applications is now dark holographic: 2263e6d50cc484f2eee0cff63789cc7796718eb6b68Dianne Hackborn * {@link android.R.style#Theme_Holo}. 2270aae2d4e0075fd699cf40b26dca0eb2c3b3e37d2Dianne Hackborn * <li> The activity lifecycle has changed slightly as per 2280aae2d4e0075fd699cf40b26dca0eb2c3b3e37d2Dianne Hackborn * {@link android.app.Activity}. 2299d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn * <li> When an application requires a permission to access one of 2306c2c5fc9930d14d502a22326dee9bf4475dbd649Dianne Hackborn * its components (activity, receiver, service, provider), this 2316c2c5fc9930d14d502a22326dee9bf4475dbd649Dianne Hackborn * permission is no longer enforced when the application wants to 2326c2c5fc9930d14d502a22326dee9bf4475dbd649Dianne Hackborn * access its own component. This means it can require a permission 2336c2c5fc9930d14d502a22326dee9bf4475dbd649Dianne Hackborn * on a component that it does not itself hold and still access that 2346c2c5fc9930d14d502a22326dee9bf4475dbd649Dianne Hackborn * component. 235b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * </ul> 236b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 2379d97b63d0e0c7c9deb2d140c1dd579b51f52c1afDianne Hackborn public static final int HONEYCOMB = 11; 238edf1fc6ce642c8d0f675795635d223b26d9f825cDianne Hackborn 239edf1fc6ce642c8d0f675795635d223b26d9f825cDianne Hackborn /** 240a8138732a01b92f0a40f72050b74a3bd4cf6d215Dianne Hackborn * May 2011: Android 3.1. 241edf1fc6ce642c8d0f675795635d223b26d9f825cDianne Hackborn */ 242edf1fc6ce642c8d0f675795635d223b26d9f825cDianne Hackborn public static final int HONEYCOMB_MR1 = 12; 243a8138732a01b92f0a40f72050b74a3bd4cf6d215Dianne Hackborn 244a8138732a01b92f0a40f72050b74a3bd4cf6d215Dianne Hackborn /** 245426431adcc220b6adfbe1d9530247f897e60fa36Dianne Hackborn * June 2011: Android 3.2. 246e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * 247e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * <p>Update to Honeycomb MR1 to support 7 inch tablets, improve 248e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * screen compatibility mode, etc.</p> 249e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * 250e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * <p>As of this version, applications that don't say whether they 251e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * support XLARGE screens will be assumed to do so only if they target 252e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * {@link #HONEYCOMB} or later; it had been {@link #GINGERBREAD} or 253e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * later. Applications that don't support a screen size at least as 254e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * large as the current screen will provide the user with a UI to 255e66763516a9c27c192adaba417616371a1c3c9bfDianne Hackborn * switch them in to screen size compatibility mode.</p> 256e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * 257e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * <p>This version introduces new screen size resource qualifiers 258e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * based on the screen size in dp: see 259e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * {@link android.content.res.Configuration#screenWidthDp}, 260e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * {@link android.content.res.Configuration#screenHeightDp}, and 261e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * {@link android.content.res.Configuration#smallestScreenWidthDp}. 262e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * Supplying these in <supports-screens> as per 263e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * {@link android.content.pm.ApplicationInfo#requiresSmallestWidthDp}, 264e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * {@link android.content.pm.ApplicationInfo#compatibleWidthLimitDp}, and 265e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * {@link android.content.pm.ApplicationInfo#largestWidthLimitDp} is 266e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * preferred over the older screen size buckets and for older devices 267e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * the appropriate buckets will be inferred from them.</p> 268e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * 269e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * <p>New {@link android.content.pm.PackageManager#FEATURE_SCREEN_PORTRAIT} 270e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * and {@link android.content.pm.PackageManager#FEATURE_SCREEN_LANDSCAPE} 271e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * features are introduced in this release. Applications that target 272e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * previous platform versions are assumed to require both portrait and 273e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * landscape support in the device; when targeting Honeycomb MR1 or 274e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * greater the application is responsible for specifying any specific 275e289bff0ec2b1af4ba773e0c8d49d5fd46eb9921Dianne Hackborn * orientation it requires.</p> 276a8138732a01b92f0a40f72050b74a3bd4cf6d215Dianne Hackborn */ 277426431adcc220b6adfbe1d9530247f897e60fa36Dianne Hackborn public static final int HONEYCOMB_MR2 = 13; 2783fc982f41fda1f254bfbc35490d81cd82a0ed90aDianne Hackborn 2793fc982f41fda1f254bfbc35490d81cd82a0ed90aDianne Hackborn /** 2803fc982f41fda1f254bfbc35490d81cd82a0ed90aDianne Hackborn * Current version under development. 2812d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * 2822d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * <p>Applications targeting this or a later release will get these 2832d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * new changes in behavior:</p> 2842d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * <ul> 2852d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * <li> 2d drawing hardware acceleration is now turned on by default. 2862d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * You can use 2872d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * {@link android.R.attr#hardwareAccelerated android:hardwareAccelerated} 2882d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * to turn it off if needed, although this is strongly discouraged since 2892d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * it will result in poor performance on larger screen devices. 2902d6833bab353e31ceb4230f3f3563fca2e0d9f6fDianne Hackborn * </ul> 2913fc982f41fda1f254bfbc35490d81cd82a0ed90aDianne Hackborn */ 2923fc982f41fda1f254bfbc35490d81cd82a0ed90aDianne Hackborn public static final int ICE_CREAM_SANDWICH = CUR_DEVELOPMENT; 293851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn } 294851a54143c15a1c33361efae2db3f7f45059b472Dianne Hackborn 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The type of build, like "user" or "eng". */ 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String TYPE = getString("ro.build.type"); 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Comma-separated tags describing the build, like "unsigned,debug". */ 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String TAGS = getString("ro.build.tags"); 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A string that uniquely identifies this build. Do not attempt to parse this value. */ 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String FINGERPRINT = getString("ro.build.fingerprint"); 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // The following properties only make sense for internal engineering builds. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final long TIME = getLong("ro.build.date.utc") * 1000; 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String USER = getString("ro.build.user"); 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String HOST = getString("ro.build.host"); 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker /** 310ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * Returns the version string for the radio firmware. May return 311ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker * null (if, for instance, the radio is not currently on). 312ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker */ 313ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker public static String getRadioVersion() { 314ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker return SystemProperties.get(TelephonyProperties.PROPERTY_BASEBAND_VERSION, null); 315ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker } 316ad2171acf423224d925d1b7cefa7184882e100bfDoug Zongker 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static String getString(String property) { 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return SystemProperties.get(property, UNKNOWN); 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static long getLong(String property) { 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return Long.parseLong(SystemProperties.get(property)); 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (NumberFormatException e) { 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 329