Android 2.0（版本 1）

API 级别：5

Android 2.0 是一个主要平台版本，从 2009 年 11 月开始可部署到搭载 Android 的手机。此版本包含面向用户和开发者的新功能 Android 框架 API 中的 API。

对于开发者，Android 2.0 平台以 Android SDK 的可下载组件可下载平台包含 完全兼容的 Android 库和系统映像，以及一组模拟器 皮肤、示例应用等等。可下载的平台完全符合相关要求，且不包含任何外部库。

如需开始针对 Android 2.0 平台进行开发或测试，请使用 Android SDK 和 AVD 管理器工具将该平台下载到您的 SDK 中。

平台亮点

有关新用户功能和平台亮点的列表，请参阅 Android 2.0 平台亮点文档。

内置应用

可下载平台中包含的系统映像提供了以下内置应用：

闹钟 浏览器 计算器 摄像机 相机 通讯录 自定义语言区域（开发者应用） 开发者工具（开发者应用） 拨号器

电子邮件 图库 手势构建器 用于输入日语文本的 IME 消息功能 音乐 设置 备件（开发者应用）

语言区域

可下载平台中包含的系统映像提供多种内置语言区域。在某些情况下，特定区域的语言区域提供特定区域的字符串。而在其他情况下，系统会使用该语言的默认版本。通过 Android 2.0 系统支持的语言 图片如下（采用 language_country/region 语言区域） 描述符）。

中文（中国）(zh_CN) 中文（台湾）(zh_TW) 捷克语 (cs_CZ) 荷兰语（荷兰）(nl_NL) 荷兰语、比利时 (nl_BE) 英语、美国 (en_US) 英语、英国 (en_GB) 英语（加拿大）(en_CA) 英语（澳大利亚）(en_AU) 英语（新西兰）(en_NZ) 英语（新加坡）(en_SG) 法语、法国 (fr_FR) 法语（比利时）(fr_BE)

法语（加拿大）(fr_CA) 法语（瑞士）(fr_CH) 德语（德国）(de_DE) 德语（奥地利）(de_AT) 德语（瑞士）(de_CH) 德语（列支敦士登）(de_LI) 意大利语、意大利 (it_IT) 意大利语（瑞士）(it_CH) 日语 (ja_JP) 韩语 (ko_KR) 波兰语 (pl_PL) 俄语 (ru_RU) 西班牙语 (es_ES)

本地化的界面字符串与可通过“设置”访问的语言区域匹配。

模拟器皮肤

可下载平台包含一组模拟器皮肤，您可以使用这些皮肤针对不同的屏幕尺寸和分辨率对应用进行建模。模拟器皮肤如下：

• QVGA（240x320，低密度，小屏幕）
• WQVGA（240x400、低密度、普通屏幕）
• FWQVGA（240x432、低密度、普通屏幕）
• HVGA（320x480、中等密度、普通屏幕）
• WVGA800（480x800、高密度、普通屏幕）
• WVGA854（480x854 高密度，普通屏幕）

如需详细了解如何开发可在所有 Android 设备上正常显示和运行的应用，请参阅支持多种屏幕。

开发者功能

以下部分介绍了可下载的 Android 2.0 平台组件提供的新开发者功能。

Ant 支持

• 调试和发布模式应用签名。发布模式签名包含对 zipalign 优化的集成支持。如需了解详情，请参阅为应用签名。
• 添加了新的 Ant 构建系统，支持 Emma 插桩项目（代码覆盖率）。

Framework API

下面几部分提供了有关 Android 2.0 平台提供的应用框架 API 的信息。

API 级别

Android 2.0 平台提供了该框架的更新版本 API。与之前的版本一样，Android 2.0 API 会被分配一个整数标识符 - 5，该标识符存储在系统本身中。此标识符称为“API 级别”，可让系统在安装应用之前正确确定应用是否与系统兼容。

如需在应用中使用 Android 2.0 中引入的 API，您需要在应用清单的 <uses-sdk> 元素的属性中设置适当的值“5”。

如需详细了解如何使用 API 级别，请参阅 API 级别文档。

API 变更摘要

蓝牙

• 开启/关闭蓝牙
• 设备和服务发现
• 使用 RFCOMM 连接到远程设备并发送/接收数据
• 公布 RFCOMM 服务并监听传入的 RFCOMM 连接

同步适配器

• 新增了适用于同步适配器的 API，以连接到任何后端

客户经理

• 集中式账号管理器 API，可安全地存储和访问身份验证令牌/密码

通讯录

• 新的联系人 API，允许来自多个账号的数据
• 借助新的快捷联系框架 API，开发者可以在其应用中创建联系人标记。点击该标记会打开一个窗口，其中列出了可一键与对方联系的方式。

WebView

• 已弃用的类：UrlInterceptHandler、Plugin、PluginData、PluginList、UrlInterceptRegistry。

相机

• 新增了色彩效果、场景模式、闪光灯模式、对焦模式、白平衡、旋转和其他设置的参数。
• 新增了 ZoomCallback 接口，用于在缩放级别发生变化时执行操作。

媒体

• MediaScanner 现在会在所有图片插入 MediaStore 时为其生成缩略图。
• 新增了 Thumbnail API，用于按需检索图片和视频缩略图。

其他框架

• android.R.style 中新增了系统主题，可轻松在当前系统壁纸上显示 activity，或让上一个 activity 在后台保持可见。
• 新的 WallpaperManager API 取代并扩展了之前在 Context 中的壁纸 API，以允许应用请求和设置系统壁纸。
• 新增了服务 API，以帮助应用正确处理服务生命周期，尤其是在内存不足的情况中，此类情况可能会导致服务在运行时被终止。
  • Service.setForeground() 已废弃，现在实际上不执行任何操作。该 API 已替换为新的 API startForeground()，该 API 有助于（且需要）将持续性通知与前台状态相关联。
• MotionEvent 现在可以为支持它的设备报告同时触摸信息。最多可同时跟踪 3 个指针。
• KeyEvent 提供了新的按键调度 API，以帮助实现按键释放操作和长按行为，以及用于取消按键按下操作的新机制（适用于虚拟按键）。
• WindowManager.LayoutParams 具有新常量，这些常量可让窗口在显示时唤醒屏幕，并在屏幕处于锁定状态时显示窗口。这样，应用就可以更轻松地实现闹钟等应唤醒设备的功能。
• 新的 intent API，用于广播设备的底板状态，并允许应用在设备放置在桌面或车载底板上时启动特殊 activity。

按键时执行按键事件

Android 2.0 设计为可在使用虚拟按键（代表主屏幕）的设备上运行。 菜单、“返回”和“搜索”键，而不是实体键。为最佳用户提供支持 时，Android 平台现在会在 key-up，用于 key-down/key-up 对，而不是 key-down。这有助于防止 意外按钮事件，允许用户按下按钮区域，然后拖动 不用生成任何事件

只有当您的应用拦截按钮事件并在按下键（而非按下键）时执行操作时，这种行为变更才会影响您的应用。尤其是当您的应用拦截返回键时，您应确保您的应用能够正确处理按键事件。

通常情况下，不建议在应用中拦截返回键，但如果您的应用正在执行此操作，并且在按下按键（而非按键松开）时调用某个操作，则应修改代码。

如果您的应用将使用 Android 2.0（API 级别 5）中引入的 API， 您可以利用新的 API 来管理关键事件对：

• 如果您要在 activity 或对话框中拦截返回键，只需实现新的 onBackPressed() 方法即可。
• 如果您要在视图中拦截返回键，则应在按下按键时跟踪按键事件（通过新的 startTracking() 方法），然后在按键松开时调用操作。您可以使用以下模式：

Kotlin

override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
    return when (keyCode) {
        KeyEvent.KEYCODE_BACK -> {
            if (event.repeatCount == 0) {
                event.startTracking()
                true
            } else {
                false
            }
        }
        ...
        else -> super.onKeyDown(keyCode, event)
    }
}

override fun onKeyUp(keyCode: Int, event: KeyEvent): Boolean {
    return when (keyCode) {
        KeyEvent.KEYCODE_BACK -> {
            if (event.isTracking && !event.isCanceled) {
                // *** DO ACTION HERE ***
                true
            } else {
                false
            }
        }
        ...
        else -> super.onKeyUp(keyCode, event)
    }
}

Java

public boolean onKeyDown(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_BACK
                && event.getRepeatCount() == 0) {
            event.startTracking();
            return true;
        }
        return super.onKeyDown(keyCode, event);
    }

    public boolean onKeyUp(int keyCode, KeyEvent event) {
        if (keyCode == KeyEvent.KEYCODE_BACK && event.isTracking()
                && !event.isCanceled()) {
            // *** DO ACTION HERE ***
            return true;
        }
        return super.onKeyUp(keyCode, event);
    }

如果您想更新旧版应用，使其对返回键的处理在 Android 2.0 及更低平台版本中正常运行，可以使用与上文中所述方法类似的方法。您的代码可以捕获 按下 key-down 时定位按钮事件，设置一个标记来跟踪键事件，以及 然后在按键时捕获事件，如果跟踪到 标志已设置。您还需要监控焦点变化，并在获得/失去焦点时清除跟踪标志。

API 差异报告

如需详细了解 Android 2.0（API 级别 5）与之前版本的 API 变更，请参阅 API 差异报告。