来源书籍

Android应用开发攻略

Skill 版本:v24 移动应用开发实战类 速查手册(低浓度 + 低稳定性) 262 张卡片

Ian F. Darwin(编著) · 姚军等 译 · 机械工业出版社 · 2013 · ISBN 978-7-111-41411-7

类别清单覆盖

4/7

已覆盖 4 补充生成 0 未覆盖 3

全书导读

这本书用具体问题、解决方案与讨论组织Android应用开发知识。阅读先认识组件和运行状态,再进入界面、数据、网络与设备能力,最后处理国际化及发布。本文依据2013年中文版解释历史工具与API;市场、服务状态和示例能否在当前系统运行,均不能从旧书直接推出。

全书主线

能运行的最小项目只是起点。移动应用还要在用户切换、配置变化、网络延迟和硬件差异中保持可恢复的状态;组件通信连接功能,持久化保存长期数据,测试验证这些边界。后续每个攻略沿原书问题展开,不把并列技术拼成固定执行链。

前置说明

作者介绍

编者Ian F. Darwin长期从事UNIX、Java及Android开发与培训,本页交代其经验与作品,帮助理解社区攻略的编选背景。

封面介绍

封面动物是加拉帕戈斯海鬣蜥。本页介绍它的海生习性、晒太阳调温和排盐鼻腺;这些内容用于解释封面选择,与Android攻略没有技术依赖。

译者序

译者序将移动开发的吸引力归于设备和网络能力提高、开发平台成熟以及分发渠道形成。全书以社区贡献的可运行小例子连接Java基础、界面、设备能力与国际化,适合按实际问题查找;历史市场判断保留为当时背景。

O’Reilly Media,Inc.介绍

出版社介绍其技术图书、会议与在线服务,以及通过社区传播新技术的出版定位;所列媒体评语是宣传材料,不作为技术正确性的证据。

前言

前言把Android放在开放移动平台竞争中,说明本书旨在让社区开发者分享解决具体问题的经验。市场地位与平台名称是写作时背景,不用于判断2026年的平台格局。

关于Android

本书背景下的Android把Linux系统能力、Java语言与移动API组合起来,应用经Android工具链转换为Dalvik运行的字节码。它与桌面Java共享语言和部分库,但不能因此假定全部桌面API可用;销售量叙述仅是2010年的历史背景。

Android平台分层进一步说明该问题的操作条件与边界。

原书依据 · 1 处

本书的由来

本书来自公开社区网站上的贡献、阅读、审校和评论,编者把多位开发者的实际方案整理为攻略。多作者结构解释了章节风格和方案时代背景可能不同。

本书读者对象

本书以具备Java和标准API基础、至少认识Activity、Intent、Service及ContentProvider的读者为对象。遇到陌生组件时应先建立对象和生命周期认识,再按攻略解决具体功能问题。

本书内容

全书从开发环境进入移动设计与测试,再讲组件通信、数据共享、图形及各种界面机制;随后连接媒体、持久化、电话、网络、位置、传感器和蓝牙,最后讨论系统控制、其他语言、国际化与发布。测试被提早安排,因为组件或界面的功能可用并不意味着状态变化与整机行为可靠。

本书约定

斜体用于术语和文件路径,等宽字体用于代码与标识符,等宽粗体表示需要逐字输入的内容,等宽斜体表示替换值。提示和警告图标用于提醒附加条件;阅读代码时需区分字面语法与占位符。

代码示例的获取和使用

攻略末尾给出单独示例下载,集中仓库包含按目录组织的Eclipse项目。Git可查看历史并接收更正,ZIP方便一次下载;代码使用说明区分应用中引用示例与大量复制分发,具体许可应回到原文核对。

Safari联机丛书

Safari在书中是可搜索和阅读技术书籍、视频的订阅服务,本页说明历史访问方式和功能,不保证这些链接与订阅条件仍有效。

如何联系我们

本页说明勘误反馈与出版社联系渠道,并明确网络变化使技术内容难以永久有效。因此后续攻略按原书环境解释,复用时需另核对现行文档。

致谢

致谢列出社区攻略贡献者、编辑、制作与技术审校人员,交代多作者成书及校订过程,不把人员名单转换成技术结论。

第1章 入门

第1章 入门

本章以Hello World为入门模式:先得到能够构建、部署和启动的最小应用,再逐步加入生命周期、依赖和界面事件。这样可把工具链故障与业务逻辑故障分开定位。

1.2 学习Java语言

Android采用Java语言,却不提供Swing、Applet等全部桌面API。应学习语言、集合、I/O、线程等可迁移部分,再用Android组件和GUI机制替换不适用内容;Java Cookbook等资源是学习入口,书目不是当前版本清单。

Java学习要区分平台API进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.3 从命令行创建”Hello,World”应用程序

不使用Eclipse时,旧工具链通过android create project指定包名、Activity、目标平台与目录,生成Manifest、源代码、资源及构建文件。Ant的debug目标生成APK;AVD描述模拟器配置,ADB负责向目标安装应用。这是原书的命令行方案,步骤展示了创建、构建、部署和启动各自负责什么,不是现行工具链说明。

命令行创建并部署旧项目进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.4 在Eclipse中创建”Hello,World”应用程序

Eclipse方案先准备IDE、SDK和ADT,再建立Android项目、选择目标SDK并编辑XML资源。布局的gravity决定子元素或内容的对齐;保存触发构建后,通过Run As启动模拟器并运行APK。选择平台决定可用API,单次Hello World只验证最基本工具链。

用旧ADT建立最小应用进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.5 在Windows上安装用于Android开发的IDE

Windows安装过程按依赖顺序准备JDK、Eclipse、Android SDK和ADT。SDK Manager安装平台、示例及可选组件,ADT再绑定本地SDK位置;目录权限、工具占用与组件版本不匹配会阻止安装。原书的管理员操作属于特定旧环境排障,不能泛化为所有下载都应提升权限。

安装旧Android开发环境进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.6 理解Android生命周期

Activity由系统事件驱动,不从普通main循环开始。onCreate建立界面和监听器,onStart/onResume进入可见和交互状态,onPause/onStop对应失焦与隐藏,返回时可能重启;可覆写回调并记录日志观察实际顺序。原书将应用状态简述为活动、暂停和停止,具体回调对象仍是Activity。

生命周期意识进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.7 通过ADB在模拟器上安装.apk文件

ADB把构建好的APK安装到运行中的模拟器或连接设备。先找到SDK中的adb位置,旧版本可能在tools、后续位于platform-tools;再在终端调用安装命令并在目标菜单确认结果。命令找不到与目标未连接属于不同故障。

用ADB安装已有APK进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.8 通过SlideME将应用程序安装到模拟器上

SlideME在原书中用于官方商店不可用或模拟器测试分发时的替代渠道。先从浏览器下载并安装,再用商店客户端浏览其他应用;作者也记录了模拟器无响应的限制。这是历史分发方案,当前服务是否可用未作确认。

历史替代商店安装路径进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.9 共享来自其他Eclipse项目的Java类

共享源码应建立项目依赖,避免复制粘贴造成两份代码独立演化。旧Eclipse可引用源码项目或JAR;两个Android项目还可声明库项目。发布时要标记主项目和依赖项目的对应版本,才有机会重建同一发布物;有缺陷的插件可能破坏构建,应隔离。

项目依赖替代复制源码进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.10 引用程序库实现外部功能

外部JAR加入项目构建路径后,IDE才能解析库中类型。绝对路径引用容易在其他开发者机器上失效,把JAR随项目放置可以改善位置一致性,但也引入分发许可责任;IDE与Ant都构建时必须保持两处配置一致。

外部库路径要可重现进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.11 使用SDK样例避免棘手的情况

SDK样例提供可运行的完整上下文,用于理解文档未充分说明的功能。导入已有样例时需选择匹配的目标平台;找不到样例可能是对应包未安装。先运行再沿源代码观察输入、回调与输出,比复制孤立代码片段更容易发现依赖。

从可运行样例追查机制进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.12 保持Android SDK更新

SDK Manager负责平台、工具和厂商附加包;ADT还必须与更新后的SDK匹配。Windows更新失败可分别检查目录只读、管理员授权、ADB占用或管理器自身替换失败。把所有失败都当下载问题会错过本地文件和版本约束。

旧SDK更新要分层排障进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.13 从模拟器/Android设备获得屏幕截图

DDMS可连接指定设备并捕捉屏幕:打开设备视图、选目标、触发Screen Capture再保存。先选择正确设备很重要,否则截到的不是正在调试的应用;原书也列出部分系统版本自带的截图入口。

从指定设备捕获界面进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.14 程序:简单的CountDownTimer示例

CountDownTimer把总时长和通知间隔分开:周期调用onTick传入剩余时间,到期调用onFinish。Activity按钮负责开始或取消,显示已过时间可由总时长减剩余时间得到;示例的按钮文本与状态管理不应视为完整产品实现。

倒计时分离进度与完成进一步说明该问题的操作条件与边界。

原书依据 · 1 处

1.15 程序:Android OS下的小费计算器Tipster

Tipster以账单、人数和小费率三个输入展示完整的事件驱动界面。TableLayout与TableRow组织行列,TextView显示标签和结果,EditText接受输入,RadioGroup管理互斥比例选项。XML资源生成R标识后,Activity用findViewById把布局对象接到监听器;R文件应由工具生成而非手工改动。

输入类型约束只能约束可输入的形式,不能自动排除空值和零人数。界面先禁用计算按钮,随着文本和单选项变化更新可用状态;真正计算前仍检查范围,默认单选值要从组中读取,不能只依赖变化事件。小费等于账单乘比例,总额再除以人数得到分摊值;这只是演示计算,不是实际支付或账务系统。Reset同时清除输入、结果并恢复默认选择,错误对话框关闭后把焦点放回出错字段。

XML资源连接运行时控件进一步说明该问题的操作条件与边界。

表格布局控制行列跨度进一步说明该问题的操作条件与边界。

输入形式不能代替范围校验进一步说明该问题的操作条件与边界。

监听事件驱动界面状态进一步说明该问题的操作条件与边界。

计算与复位形成完整交互进一步说明该问题的操作条件与边界。

原书依据 · 5 处

第2章 设计成功的应用程序

第2章 设计成功的应用程序

移动应用要把关键功能置于容易到达的位置,使用平台熟悉的交互,并在离开视图后保存可恢复的局部数据。设备的几何尺寸与像素密度不同,布局与图像应分别准备;硬件特性不能假定普遍存在。

应用可通过Intent复用其他组件的能力;选项菜单承接当前界面的通用操作,上下文菜单针对所选对象。数据访问宜由中间服务把多种来源转换为稳定接口,避免手机直接依赖数据库或后端数据格式。接口隔离可把变化限制在服务侧,但不能保证源数据不可用时业务完全不受影响。

移动界面遵循平台习惯进一步说明该问题的操作条件与边界。

屏幕尺寸与密度分别适配进一步说明该问题的操作条件与边界。

设备特性不能默认存在进一步说明该问题的操作条件与边界。

中间接口隔离后端格式进一步说明该问题的操作条件与边界。

原书依据 · 4 处

2.2 异常处理

Java的Throwable包含Exception和Error;Exception中排除RuntimeException的一支属于检测型异常,调用者需捕捉或声明。异常转译在可复用层把技术错误转成较统一的异常,再靠近用户处理;原书也保留了反对意见:过度统一会丢掉“文件不存在”和“暂时不可读”等可恢复差异。

错误不应被空catch吞掉,也不应每层既记录又重抛而重复报告。对用户必须采取行动的错误,对话框比短暂Toast更合适;不重要的信息才用短暂提示。原例中对关闭失败的断言和finally重新抛异常不作为通用安全规则复制。

异常转译仍须保留差异进一步说明该问题的操作条件与边界。

异常只在合适边界报告进一步说明该问题的操作条件与边界。

Java异常分类影响处理义务进一步说明该问题的操作条件与边界。

原书依据 · 3 处

2.3 作为“单例”访问Android应用程序对象

多个Activity共享会话或服务入口时,可以让自定义Application在onCreate中初始化这些对象,并在Manifest声明该Application类型。原书用静态访问方法方便取得实例,但也承认语言层面仍可创建其他实例;该模式表示框架管理的应用上下文入口,不应当作跨进程持久存储或所有共享状态天然线程安全的保证。

应用对象汇集共享服务进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.4 在用户旋转设备时保存数据

旋转会销毁并重新创建Activity,所以字段值不等于可恢复状态。简单或可序列化数据可放入onSaveInstanceState的Bundle;原书另一方案通过旧的非配置实例接口把对象交给新Activity,再恢复字段并避免重复创建文件写入器。应区分Activity重建与任务对象延续;这段历史方案不证明进程死亡后也能恢复对象。

旋转重建须恢复必要状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.5 监控Android设备的电量

应用可以订阅电池状态广播,在接收回调中读电量;需要每次变化与只关心低电量是两种不同订阅。书例只打印level,没有实现完整的百分比换算和警告界面,因此不能声称已有完整低电量策略。

按关注范围订阅电池广播进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.6 在Android中创建闪屏

闪屏可用专用Activity或主Activity上的Dialog。独立Activity易理解,但会增加启动入口与返回栈处理,需避免返回主界面时再看到闪屏;Dialog可简化Activity栈,却需在方向变化、返回或超时结束时正确恢复和移除。原书先质疑移动应用是否需要额外等待,因此固定停留时间不应视为性能优化。

闪屏方案影响返回栈进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.7 设计会议/网络研讨/编程马拉松/机构用的应用程序

会议类应用的核心是把时间、地点和参与活动联系起来。会场与展厅地图帮助定位,日程应显著标示取消和房间变更,议程关联笔记让记录保留上下文;社交、餐饮和私聊是按场景选择的附加功能。原书列举的第三方服务与当前可用性不能画等号。

会议应用围绕时地组织信息进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.8 在Android应用中使用Google Analytics

书中旧版Analytics流程先配置账户与属性ID、添加SDK和网络权限,再在Application初始化跟踪器。页面浏览与按钮事件是不同观测对象,事件入队后还需dispatch发送。书中要求告知用户会收集使用数据;该说明不等于当前隐私合规结论,也不保证旧SDK和UA属性仍适用。

使用分析区分采集与发送进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.9 简单的手电筒应用程序

手电筒例子先检测设备是否有闪光灯,再检查相机支持的模式列表,只有支持torch才请求常亮;关闭与异常路径要释放相机资源。拥有相机、拥有闪光灯与支持常亮是不同能力。书例打开相机的条件和异常路径不能不加检查地照抄,笔记只保留已说明的操作意图。

手电筒先检测常亮能力进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.10 将Android手机应用程序改编为平板电脑应用程序

手机应用迁到平板不只是更改目标SDK。应在平板配置的模拟器或真机上检查横向布局、按钮可达范围与间距、文字尺寸以及系统主题变化。原书用dp表达控件尺寸、sp表达字体,并区分最低支持平台与目标平台声明;API级别和主题名称限于当时环境。

平板迁移验证布局与触达进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.11 设置首次运行的首选项

首次运行标记需要跨进程保存,所以放入SharedPreferences。缺少键时返回true,执行首次流程后写false;以后启动读取已保存值,不依赖静态变量。应用升级一般保留此标记,重新安装等清除数据的情形会改变它,因此它表示存储中的初始化状态,不是不可篡改的身份或付费凭据。

首次运行标记应持久化进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.12 为显示格式化时间和日期

日期时间对象表示值,格式串决定显示形式。示例用DateFormat把同一个Date显示为短月份、完整月份、星期或时分秒。应辨认M、m、h等符号含义,避免用外观相似的格式改变月份和分钟等字段;示例格式并不自动代表所有语言环境的偏好。

格式串决定日期时间显示进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.13 用KeyListener控制输入

KeyListener用于限制输入字符或适配键盘行为。DigitsKeyListener可按参数允许正负号与小数点,DateKeyListener约束日期输入字符;MultiTap与Qwerty对应不同键盘形式。它们帮助输入,但日期字符合法不代表日历日期有效,字符集合检查也不等于业务范围校验。

输入监听器限制字符集合进一步说明该问题的操作条件与边界。

原书依据 · 1 处

2.14 备份Android应用程序数据

备份管理把应用挑选的数据交给传输层保存,恢复时再交还应用。原书通过备份代理声明、数据文件和dataChanged通知连接这一过程;dataChanged只提出请求,不证明数据已经上传。设备可没有可用传输,应用仍应正常工作;云服务差异也意味着敏感数据不能仅因用了系统备份就视为安全。

测试应形成实际往返:写入状态、请求备份、强制运行队列、卸载重装,再核对恢复的值。原书Activity示例展示本地状态与通知,并未在此展开完整代理实现,因此不能把它当成可直接交付的完整备份系统。

备份请求与完成要区分进一步说明该问题的操作条件与边界。

备份测试必须验证恢复值进一步说明该问题的操作条件与边界。

原书依据 · 2 处

2.15 用提示代替工具提示

hint在输入为空时提供填写线索,输入后消失,适合触屏和小屏幕上的简短提示。可设置提示颜色,也可用代码修改;已很明确的标签无需再重复提示。省空间是取舍,不能把必要的长期说明都藏在输入后消失的水印里。

输入提示应补充必要线索进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第3章 测试

第3章 测试

单元测试隔离检查组件,网络和数据库等依赖可由模拟对象替代;整机、界面与跨组件测试回答另外的问题。NPE是空指针错误,ANR是响应超时,FC是系统要求关闭失败应用的表现。测试应尽早进行,且不能用编译成功替代运行时验证。

测试层次对应不同问题进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.2 在Android中进行TDD

原书将Android插装UI测试与标准Java单元测试拆成两个项目。前者需要环境并验证界面集成,后者便于模拟依赖、快速测试非UI逻辑;把业务逻辑从界面类提取出来,能减少TDD对完整设备环境的依赖。

提取逻辑分离两类测试进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.3 为应用测试设置Android虚拟设备(AVD)

AVD把操作系统、屏幕和模拟硬件组成可重复的设备配置,可测试无GPS、无SD卡等边界并模拟通信和位置事件。它扩大配置覆盖,却不能代表所有真机性能。创建时分别设置目标、存储、屏幕及硬件;快照保留运行状态,清除用户数据则重置状态,两者适合不同测试目的。Windows旧启动错误还可能来自SDK路径空格。

虚拟设备按风险配置矩阵进一步说明该问题的操作条件与边界。

快照与清数据验证不同状态进一步说明该问题的操作条件与边界。

原书依据 · 2 处

3.4 用基于云的测试在多种设备上进行测试

云设备服务用集中管理的真实设备,把屏幕和输入远程传给测试者,可扩大机型、运营商及位置覆盖。它与AVD互补:AVD容易控制配置,远程真机更接近具体硬件;原书列出的供应商只是历史入口,并非当前服务推荐。

远程真机补充模拟器覆盖进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.5 测试项目的创建和使用

Android测试项目要显式依赖被测应用,并在Manifest将测试包与目标应用包分开。instrumentation的targetPackage指明被测对象,测试运行器负责插装。示例取得Activity中的TextView并断言文本,验证的是具体界面结果;项目结构随IDE不同而变。

插装测试要绑定正确应用进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.6 应用程序崩溃排错

崩溃定位先看adb logcat或IDE日志中的异常类型、原因链与应用代码位置。权限拒绝示例点名WRITE_SETTINGS,空指针示例最终定位到Activity字段未取得控件实例;修复应针对原因,而不是泛加权限或捕捉所有异常。旧权限声明只是当时场景,不代表当前系统只需加一行Manifest。

沿异常原因链定位崩溃进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.7 用Log.d和LogCat进行调试

Log.d输出标签与消息,固定标签方便筛选,消息可携带格式化变量和检查点。看到检查点只能证明执行曾到达该处,不能证明此前所有计算都正确;日志应服务于明确的状态或路径问题。

调试日志证明路径已到达进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.8 用BugSense自动从用户那里得到缺陷报告

自动崩溃报告把用户未主动提供的异常细节汇集到服务端。旧BugSense方案以应用键码、库、网络权限与启动初始化连接采集和报告页面;发布后仍要主动观察与定位。书中对BugSense和ACRA的比较限于写作时,不作为当前产品能力结论。

现场崩溃需要结构化报告进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.9 使用本地运行时应用程序日志分析现场错误情况

现场故障需要比单次异常栈更长的上下文。运行日志可记录状态转换、资源超时、重试上限和关键通知,用级别、按需开关和保留期限控制成本;网络不可用时本地文件仍能留下证据。原书RuntimeLog代码有排版和实现缺口,不作为可直接运行的库;其价值是说明应该记录哪些事件及如何管理记录量。

现场日志记录状态演变进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.10 为测试重现活动生命周期场景

生命周期测试应分别执行正常退出、Home后返回及暂停后被系统移除再启动。各回调加入同一标签的日志,可观察是否重新onCreate或经过onRestart;强制停止不保证调用onDestroy。测试目标是状态和资源在不同路径下都正确,而不是只背一份固定回调表。

生命周期测试覆盖中断路径进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.11 用StrictMode保持应用程序敏捷性

StrictMode在调试期间帮助发现主线程数据库等不合适操作。原书通过API级别和调试开关启用默认策略,再按需自定义检测;它能揭示部分响应性风险,不能据工具说明就断言所有ANR原因都能检测。数据量增大后的卡顿尤其需要验证。

用严格模式发现主线程风险进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.12 运行Monkey程序

Monkey以随机事件探索预设测试未覆盖的交互。包装脚本固定目标包、节奏、事件数和随机种子,便于团队重现;确认某个种子后再换种子扩大探索。网络被意外关闭并非纯噪声,它也可能暴露离线边界;同种子只固定输入生成,不保证所有环境调度完全相同。

随机交互测试要保留种子进一步说明该问题的操作条件与边界。

原书依据 · 1 处

3.13 发送文本消息以及AVD之间的通话

两个AVD可互相模拟电话与短信。窗口标题的控制台端口在原书方案中也作为模拟电话号码,用它向另一实例发起通信;这可测试接收路径而不产生真实通信,但不代表真实运营商网络行为。

双模拟器验证通话短信进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第4章 进程间/内通信

第4章 进程间/内通信

本章把组件协作与线程协作分开。Intent表达要处理的数据及动作,可指明组件或交给匹配应用;广播分发事件;后台线程承担耗时操作,Handler把消息排入目标线程处理。Intent并不天然等于跨进程远程调用,Service也不自动等于新线程。

进程通信边界进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.2 用意图打开网页、电话号码或者其他内容

隐式Intent用动作和URI描述请求,系统寻找注册的处理者,调用方不必绑定某个浏览器或拨号应用。只有需要对方返回结果时,才使用带请求码的结果流程,并在回调中区分成功与取消。启动请求不是同步取得结果,也不保证每种URI都有处理者。

按动作和数据委托其他应用进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.3 从视图中发送文本邮件

文本分享通过ACTION_SEND提供MIME类型、主题和正文,再由接受应用展示发送界面。示例按钮将字符串资源放进EXTRA_TEXT;这属于委托,不是应用自行完成邮件投递。原书Manifest含无关或位置不当的权限配置,笔记不把它作为必要权限清单复制。

文本邮件分享是委托操作进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.4 发送带有附件的电子邮件

单附件分享把文件URI放进EXTRA_STREAM,多附件则使用ACTION_SEND_MULTIPLE及URI列表。MIME类型帮助接收应用理解内容,chooser允许用户选处理者。原书直接使用文件URI是历史示例,文件可读性和当前共享权限必须另行验证,不能把URI存在当作对方能访问。

附件分享需同时描述内容类型进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.5 用Intent.putExtra()推送字符串值

启动Activity时,发送方用稳定键向Intent添加参数,接收方从当前Intent读取Extras并处理缺失。书例只展示字符串,不能把它推成Intent只能传字符串;附加参数适合一次请求的数据,不等同于跨启动的持久存储。

活动参数按明确键读取进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.6 从子活动中获取数据到主活动中

结果返回流程包含请求码、结果码及数据三个不同维度。父Activity以请求码启动子Activity,子Activity设置结果和Intent数据后finish,父回调先匹配请求,再检查成功或取消并取数据。结果不会在发起调用时同步产生;数组行号只适合数据未变化的示例场景。

活动结果区分请求与完成状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.7 保持服务运行同时显示其他应用

界面切走后仍需继续的GPS记录可由Service承接,Activity通过启动和停止请求控制它。Service是组件生命周期边界,默认仍可在同一进程中;START_STICKY与非粘性返回值描述书中重建倾向,不是任务永远存活保证。资源结束处理还须与实际停止路径对应,原例onUnbind不能当作所有启动服务的通用销毁回调。

服务分离任务与界面可见性进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.8 发送/接收广播消息

广播通信由接收器、过滤器和发送方的动作契约连接。接收方注册匹配动作,发送方构造相同动作并附带数据,回调在接收上下文的线程规则下运行;本例在主线程接收,因此长任务不能直接塞进onReceive。

广播以动作契约连接双方进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.9 在设备重启之后启动服务

设备重启会丢失普通进程内状态,原书用监听BOOT_COMPLETED的接收器在启动完成后重新发起服务。它连接系统事件与任务恢复,不代表服务无条件允许启动;原文示例并未完整处理权限及后续系统限制,不能当成跨版本保证。

开机事件触发任务重新初始化进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.10 用线程创建响应式应用程序

耗时网络工作可放进Thread或Runnable,通过start调度,界面线程保持响应;后台结果再交回主线程更新控件。线程不会因Activity离开自动结束,应有可见的停止或中断机制。原书把守护线程当作离开界面时停止的方案并不成立,笔记保留显式管理任务生命周期的边界。

后台工作仍需生命周期管理进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.11 用AsyncTask进行后台处理

旧AsyncTask把输入参数、进度值与结果类型分开,doInBackground执行工作,onPreExecute和onPostExecute在界面侧准备与接收结果;publishProgress把进度交给onProgressUpdate。示例有标题栏不确定进度和模态水平进度两种反馈,二者对应是否需要阻止其他交互。循环示例只覆盖最后一次结果且异常路径不完整,不能把演示当作完整批量加载器。

旧异步任务分离工作与回调进一步说明该问题的操作条件与边界。

进度反馈要对应可测工作量进一步说明该问题的操作条件与边界。

原书依据 · 2 处

4.12 用活动线程队列和处理器在线程之间发送消息

后台线程不直接改主线程控件,而是向绑定主线程队列的Handler发送Message。工作线程打包数据,目标线程的handleMessage处理并更新界面;绑定线程才决定执行位置,名叫Handler并不自动意味着主线程。循环示例保留中断标志以便结束。

消息队列把结果交回目标线程进一步说明该问题的操作条件与边界。

原书依据 · 1 处

4.13 创建Android Epoch HTML/JavaScript日历

WebView可以加载assets中的HTML、样式和脚本,让网页组件在Android界面内运行。原书用Epoch日历演示双向桥接:Java调用脚本函数,JavaScript通过注册对象把选中日期传回Java,再更新本地状态或控件。桥接名、数据格式与线程调度必须一致;示例的日期转换、暴露方法和资源路径是旧实现片段,不是处理任意不可信网页的安全模板。

本地网页组件通过桥接协作进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第5章 内容提供者

第5章 内容提供者

内容提供者在应用数据外建立标准化访问接口,让其他应用按URI、表和列约定读取或修改数据,而不直接取得数据库文件。底层常用SQLite,但接口职责与存储实现不同。联系人选择返回的是数据URI,还需查询;AIDL是另一种更通用的远程接口机制,不是Provider的别名。

内容提供者进一步说明该问题的操作条件与边界。

原书依据 · 1 处

5.2 从内容提供者获取数据

联系人选择先用ACTION_PICK请求外部界面,再在结果回调检查请求码、结果码和返回数据。Intent中的URI只是选中记录的定位,ContentResolver查询后才得到Cursor;Cursor还可能没有行,不能把界面选择和读取成功当成同一个结果。

选择返回URI后再查询数据进一步说明该问题的操作条件与边界。

原书依据 · 1 处

5.3 编写内容提供者

自定义Provider在Manifest声明authority和实现类,并实现初始化、类型识别、查询及增删改方法。URI匹配器把路径对应到资源类型,查询再映射为底层操作;结果Cursor可登记通知URI。示例delete和update仍是占位,权限验证也未完整展开,因此只能说明接口形状,不是现成安全共享实现。

提供者将URI映射为数据操作进一步说明该问题的操作条件与边界。

原书依据 · 1 处

5.4 编写Android远程服务

AIDL先声明客户端和服务端共同使用的接口,工具生成接口与Stub,服务实现方法并在onBind返回Binder。客户端通过bindService建立连接,在onServiceConnected里把Binder转换为接口后才能调用;连接失效时应清除引用,并在结束使用时解绑。启动服务、完成绑定与方法成功是不同结果。

原书片段把String返回写成int,又把getMessage调用写成getCounter,不能直接编译;笔记以AIDL声明的字符串返回契约解释,不替这些不一致编造实现。绑定请求发出也不表示代理已经取得,更不能仅判断连接对象非空就直接调用。

远程服务先绑定再取得接口进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第6章 图形

第6章 图形

图形章节处理普通GUI控件以外的显示和输入:字体、三维渲染、自由绘画、拍照、图表及图片资源。触摸不仅用于按钮,还可改变图形状态和缩放;图像资源的制作与运行时绘制属于不同环节。

6.2 使用自定义字体

旧版本自定义字体通过assets/fonts保存TTF或OTF,再用Typeface.createFromAsset创建对象并设置给文本控件。资源随应用分发,字体大小影响下载体积,授权可能不允许把字体随示例重分发。原书“XML不能引用自定义字体”的说法仅限定其当时环境。

自定义字体包含资源与许可进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.3 用OpenGL ES绘制旋转的方块

GLSurfaceView提供绘制表面,Renderer处理表面创建、尺寸变化和逐帧绘制,Cube保存几何数据并发出绘制命令。初始化建立清屏色和深度测试,尺寸变化更新视口及透视投影;每帧清理缓冲、重置变换、平移旋转后绘制。Cube用顶点、颜色与索引分别表达位置、外观和三角形连接,缓冲填充后要把游标归零,并按本机字节序解释数据。

渲染回调分离环境与逐帧工作进一步说明该问题的操作条件与边界。

图形缓冲需对齐数据解释进一步说明该问题的操作条件与边界。

原书依据 · 2 处

6.4 添加对OpenGL旋转方块的控制

交互版方块把旋转角度与旋转速度分开。D-pad事件改变x或y方向速度,每帧再用速度累加角度并重绘;视图必须取得焦点并允许触摸模式中的聚焦,才能接收按键。这样输入更新状态,渲染消费状态,而不是在按键回调里直接完成所有帧绘制。

按键更新状态再由逐帧绘制进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.5 徒手绘制平滑曲线

触摸采样快于事件交付时,一个MotionEvent可能包含历史坐标。绘画程序应按时间顺序加入历史点,再加当前点,避免只连少量终点造成折线缺失。为了减少绘制量,跟踪上一个位置、当前点和全部历史点的包围矩形,再按半个笔宽扩展后请求局部重绘。数据路径持续保存,onDraw负责画路径;这里的平滑来自更完整采样和及时反馈,并非自动生成数学贝塞尔曲线。

触摸绘画要读取批量历史点进一步说明该问题的操作条件与边界。

局部重绘区域包含完整笔画进一步说明该问题的操作条件与边界。

原书依据 · 2 处

6.6 使用意图拍照

委托相机拍照用捕捉Intent及结果回调,需要文件时事先提供目标URI。返回RESULT_OK后仍应检查文件确实产生,取消则不当错误弹窗;原书实测显示不同设备处理目标与尺寸并不一致。旧文件URI分享方式仅作为历史背景,不能直接推广到现行系统。

拍照成功还要核对实际产物进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.7 用android.media.Camera拍照

需要预览、原始数据或更细参数控制时,原书改用Camera和SurfaceView。Surface创建时打开并绑定预览,尺寸变化时配置预览,表面销毁时停止预览并释放;拍照回调处理JPEG或原始数据,再恢复预览。参数必须先查询支持集合,不能把某项存在等同于所有模式可用;书例按列表最后一项选最大尺寸等写法没有通用排序保证。

直接拍照与预览生命周期相连进一步说明该问题的操作条件与边界。

相机参数须逐项查询支持进一步说明该问题的操作条件与边界。

原书依据 · 2 处

6.8 用Google ZXing条码扫描程序扫描条形码或QR代码

ZXing示例通过已有扫描应用而非自己实现解码。发送约定扫描动作及模式,结果回调分别读取码制与内容并处理取消;必须先具备匹配处理者。已知目标码制时缩小解码集合可减少尝试工作,扫描出文本不代表文本本身可信或是业务有效数据。

委托扫描并约束解码范围进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.9 用AndroidPlot显示图表和图形

AndroidPlot以原生图表控件显示数据,先把库加入构建依赖,在布局声明XYPlot,再把数字转换为序列并配置线、点和填充。只提供Y值时,示例以元素索引作为X轴,不能误认成真实时间间隔;显示标签密度和背景属于表现配置,不能改变数据含义。

图表序列明确横轴含义进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.10 使用Inkscape创建Android启动器图标

矢量图保存形状而非固定像素,适合作为多密度图标母版。原书用Inkscape先在统一画布内安排图形及透明留白,再导出36、48、72、96像素PNG放到对应资源目录;这些尺寸是旧启动图标规格。缩小会损失细节,因此要在目标尺寸与设备上看结果,而非只看大图是否精致。

矢量母版导出多密度图标进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.11 从OpenClipArt.org用Paint.NET创建简易启动器图标

从剪贴画制作图标时,先挑选轮廓简单且缩小后可辨的图像,取得合适分辨率PNG,再扩大透明画布保留边距。缩放图形与扩展画布不同,前者改变内容大小,后者增加留白;所有密度资源应同名,改名时同步修改Manifest图标引用。图像来源和授权要核对,免费标签不是任意使用保证。

图标缩放与透明留白分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.12 使用Nine Patch文件

Nine Patch不是整图等比例拉伸,而是通过边界标记告诉系统哪些像素带可以扩展、内容应放在哪里。角保持形状,边沿单向伸展,中心可双向伸展;上和左标拉伸范围,下和右标内容范围。保存为.9.png后按普通资源名引用,焦点状态还可用selector选择不同背景。

九宫格背景分离拉伸与内容区进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.13 用Android RGraph创建HTML5图表

RGraph用HTML5 Canvas与JavaScript生成图表,可放进WebView作为原生图表之外的路径。数据数组、标签和交互配置共同定义图表,页面加载后创建并绘制对象;Java侧准备WebView、启用所需脚本并加载本地资源。原文assets路径写法有不一致,必须与真实项目资源位置相符;其兼容版本陈述仅是写作时测试结果。

网页图表依赖脚本与画布能力进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.14 添加简单的光栅动画

逐帧光栅动画把同尺寸、内容略变的图片按顺序播放。animation-list分别声明帧资源和持续毫秒数,oneshot决定一次或循环;AnimationDrawable负责开始和停止。原书在窗口获得焦点后启动以等待控件准备,但重复获得焦点与停止行为仍需按实际生命周期管理。

逐帧动画明确顺序与时长进一步说明该问题的操作条件与边界。

原书依据 · 1 处

6.15 使用捏合缩放

捏合缩放用状态机区分无操作、单指拖动和双指缩放。按下时保存原矩阵和起点,移动时从保存值计算平移;第二指加入时记录初始距离和中心,后续按新旧距离比围绕中心缩放。抬指结束当前模式。阈值用于避免过近两点的不稳定比例,示例的硬编码边界不应当作通用屏幕约束。

捏合缩放基于手势初始状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第7章 GUI

第7章 GUI

Android没有原样移植桌面Java GUI,而是采用自己的移动控件和布局系统。书中比较Java ME的局限、Swing的体积和SWT对本地工具包的依赖,说明平台选择的背景。Widget还可能指两种对象:Activity内的按钮等控件,与主屏幕上的应用小部件;二者位置和更新方式不同,不能只凭英文名称判断。

移动GUI不能照搬桌面库进一步说明该问题的操作条件与边界。

界面控件与桌面小部件不同进一步说明该问题的操作条件与边界。

原书依据 · 2 处

7.2 理解并遵循用户界面指南

用户界面指南帮助开发者采用用户熟悉的交互,但指南必须匹配目标平台。历史桌面设计作品仍可启发视觉组织和术语处理,不能把它们的具体控件风格直接迁到Android;原书的版本、作者归属和推荐列表不作为现行书目结论。

界面指南先匹配目标平台进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.3 通过解耦视图和模型处理配置更改

棋盘例子表明:GUI是数据的表现,不是数据本身。把棋局数组放在Activity初始化中,旋转重建就会重新置空;拆出模型后,界面创建时从现有状态刷新,点击时先改模型再刷新显示。原书用进程内单例延续模型,只能覆盖进程仍存活的配置变化;进程被杀仍需文件或数据库保存。

重建界面从独立模型刷新进一步说明该问题的操作条件与边界。

进程内模型不等于持久保存进一步说明该问题的操作条件与边界。

原书依据 · 2 处

7.4 创建一个按钮及其单击事件监听器

按钮在布局中声明ID,加载布局后取得对象并注册OnClickListener;共享监听器按来源ID分派操作。匿名内部类和Activity直接实现接口是不同组织方式,各自适合局部行为和共享分派;不能从创建了按钮就推断事件已连接。

按钮需显式连接点击行为进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.5 以5种不同的方式连接事件处理器

原书比较五种监听器连接方式:成员类、保存为接口类型的匿名对象、调用处匿名类、Activity实现接口、XML的onClick方法名。前两类便于复用,局部匿名类把行为放在控件附近,Activity实现节省独立宿主但可能堆积职责;XML方法名方式只处理点击,名称和签名必须对应。选择应看共享程度与可维护性,而非机械统一为一种风格。

监听器组织按复用程度选择进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.6 使用CheckBox和RadioButton控件

选择控件先看选项之间是否独立。CheckBox表达各自的是或否,RadioGroup把单选按钮组织成互斥集合,Spinner将候选收起并显示当前项。控件内部维护选择状态,监听器负责把状态连接到业务行为;单击RadioButton不等于RadioGroup收到普通点击事件。

选择控件由互斥关系决定进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.7 用图形按钮改进UI设计

图形按钮通过selector按状态选择图片,代码监听点击执行行为。状态图必须与控件真正提供的状态匹配:checked表示选中,pressed表示按下,不能因为文件叫play_pressed就视为按下条件。图像可以减少文字占用,但其含义也需让用户辨认。

图形按钮按真实状态换图进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.8 通过Spinner类提供下拉选择器

Spinner通过Adapter获得候选,选中后将下拉列表收起并显示当前项。把候选放进字符串资源可支持国际化;需要即时响应时监听选择变化,整张表单一起提交时可直接读取当前选中项。位置索引、项目标识和显示文本属于不同信息。

下拉候选与选择反馈分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.9 处理长按/长单击事件

长按应连接专用监听而非手工猜多个触摸事件。普通View可使用长按回调,列表等多项容器则监听具体项目的长按,才能获得对应条目上下文。回调的事件消费结果与弹出菜单要对应;原书关于首次支持版本和部分方法名的叙述不作为API历史依据。

长按应监听正确交互层级进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.10 用TextView和EditText显示文本字段

TextView承担文字显示,EditText在此基础上支持用户编辑;是否可输入是选择控件的直接依据。默认文字可放XML,但资源引用便于修改和国际化。原书把某些选择控件也列作EditText后代的叙述不正确,笔记不沿用该类型关系。

文本显示与输入分清职责进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.11 用属性和TextWatcher接口限制EditText值

输入约束可分层:XML指定字符类型与长度,TextWatcher观察修改后做数值范围处理。百分比示例把超过100的值替换为100,同时允许用户暂时删空;临时编辑状态和最终业务有效性应区分。修改Editable会触发新的回调,因此修正必须收敛,不能无条件反复重写。

文本修正回调必须收敛进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.12 实现AutoCompleteTextView

自动完成在用户输入达到阈值后,从Adapter提供的候选中显示建议,减少整段输入。示例以字符串数组提供水果名,TextWatcher只把当前值复制到另一个标签,并不是自动完成机制本身必须实现的部分。建议集合也不一定是业务允许值的完整约束。

自动完成由候选与阈值驱动进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.13 用SQLite数据库查询为AutoCompleteTextView

数据库游标替代字符串数组时,需要两项额外契约:选择建议后从哪一列转成输入文本,以及输入变化后如何重新查询。StringConversionColumn完成前者,FilterQueryProvider完成后者;只替换Adapter类型会出现游标对象字符串或建议不随输入收缩。

游标补全需转换列与过滤查询进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.14 将编辑字段转换为密码字段

密码输入应使用遮蔽字符的显示模式,减少旁观者直接看到输入内容。原书通过旧password属性演示;它只改变界面显示,不提供密码存储或传输保护,也不是授权校验。

密码遮蔽只保护显示层进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.15 将软键盘上的Enter键改成Next键

表单软键盘的动作应匹配字段角色。前面的单行字段可声明Next以转移焦点,最后字段声明Done结束输入,而不是让Enter无意插入新行。IME动作和文本是否允许多行仍应分别配置和测试,不因键帽变了就认定所有键盘行为一致。

键盘动作匹配表单阶段进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.16 在活动中处理按键事件

Activity可覆写按键回调并按keyCode分派需要的行为,未处理事件还须遵守平台分派与默认行为。原书片段缺少布尔返回,并把HOME列入普通回调示例,不能据此宣称应用可拦截所有系统键;笔记只保留对可交付事件的处理机制。

按键处理不能吞掉系统默认行为进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.17 让他们看到星标:使用RatingBar

RatingBar把评分呈现为一组星标,星数是显示范围,rating是当前值,stepSize决定整数或半星粒度,isIndicator决定是否只读。变化回调用fromUser区分用户操作与程序赋值;多项调查可在完成按钮统一读取,避免保存半份回答。社区平均值与个人输入最好分清,不让用户误认为平均值就是自己的选择。

评分值粒度与提交时机分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.18 震动视图

视图震动是位置动画而非设备振动。XML定义平移幅度、时长和循环插值,再把动画应用到需要提示的输入框;使用当前焦点需先确认焦点对象存在且正确。按钮回调收到的是按钮本身,不一定是出错字段。动画用于引起注意,不能代替清楚说明错误。

提示动画应作用于出错对象进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.19 提供触觉反馈

触觉反馈让用户及时感到触摸已被接收,可使用系统反馈类型或直接控制振动器。原书前者在View启用并调用performHapticFeedback,后者请求振动权限并指定持续时间;设备可能没有振动器,不同反馈常量也未必容易辨别。输入监听还可能消费事件,因此需避免为反馈破坏按钮原有动作。

触觉反馈是输入确认而非结果进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.20 在TabView中浏览不同的活动

旧TabView方案把ActivityGroup作为选项卡内的宿主,用本地Activity管理器启动子Activity,再替换内容视图以保留外层选项卡。它区分“替换整个屏幕”与“只替换标签内容”,但引入嵌套Activity管理。代码还有监听器参数等缺口,作为历史方案解释,不当作现行导航推荐。

标签内导航要明确替换范围进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.21 创建自定义标题栏

自定义标题栏先用独立布局定义文字和图像按钮,再在窗口内容建立前请求对应窗口特性,之后加载主布局并设置标题布局。公共窗口基类可复用装配顺序,但按钮仍要真正连接事件;原例只有处理方法名不意味着监听已全部完成。

窗口特性须在合适阶段装配进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.22 格式化数字

String.format适合控制字段宽度、精度与参数顺序,编号参数可重复引用同一值或为翻译调整顺序。NumberFormat更适合按Locale处理数字、货币和百分比,DecimalFormat提供可调模式;显示舍入与数值本身不同。原书将Locale误归到java.text,笔记不据此生成导入语句。

格式化参数可编号重排进一步说明该问题的操作条件与边界。

数字格式应匹配地区语义进一步说明该问题的操作条件与边界。

原书依据 · 2 处

7.23 格式化正确的复数形式

复数规则是语言规则,不是给所有名词加s。条件语句只适合简单英语,ChoiceFormat可按数值区间选择词句,Android的plurals资源则按语言环境的数量类别选择文本。选择资源与填入数量占位符是两步:如果返回文本含%d,还需提供格式化参数,不能直接期待数量选择自动替换占位符。

数量类别与文本替换分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.24 从第一个屏幕启动第二个屏幕

新增屏幕需要布局、承载Activity、Manifest声明和启动请求协同。按钮创建显式Intent,把目标类交给系统启动;不能用普通new Activity代替受系统管理的界面。界面布局用ViewGroup组织View,Fragment则是可复用的屏幕片段,并非所有功能都应拆成独立Activity。Android管理返回栈,因此最简单两屏导航不必另造一套返回历史。

新增屏幕要连接四个环节进一步说明该问题的操作条件与边界。

布局容器组织界面子视图进一步说明该问题的操作条件与边界。

原书依据 · 2 处

7.25 创建出现在两个活动之间的“加载中”屏幕

“加载中”页可以给等待过程反馈,但原书固定延时后切屏只演示页面跳转,没有绑定实际数据完成。示例在主线程Handler回调中sleep还会阻塞界面,因此不能作为响应性实现。应由实际任务状态驱动成功、失败或取消后的界面转移;本节作为对示例局限的直接说明。

加载提示应对应真实任务状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.26 使用SlidingDrawer覆盖其他组件

抽屉要覆盖主内容,应放在支持叠放的FrameLayout或RelativeLayout,而非期待LinearLayout自然叠加。关闭后把手仍占空间,底层列表应预留同样高度的间隔;把手与间隔共用样式可减少尺寸漂移。布局层级与内容可见范围必须一起考虑。

覆盖抽屉须预留把手空间进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.27 自定义SlidingDrawer组件,使动画/过渡的方向变为从上向下

需要从上向下展开时,原书以org.panel的Panel替代默认抽屉。引入库及其XML命名空间,声明顶部位置、把手、内容与动画参数即可组织展开界面;这是更换组件实现,不是给原组件随意改一个方向常量。第三方包兼容性与当前来源需单独核验。

替换抽屉组件以控制展开方向进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.28 为布局添加圆角边框

drawable目录还可保存XML形状,不仅是位图。矩形形状可以设置圆角、填充和内边距,再作为布局背景复用;padding把内容移离边缘,外层间距则把整体移离屏幕边缘。形状本身与覆盖其上的子视图背景需共同检查,避免圆角被子视图遮住。

形状背景分离边缘与内容进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.29 在Android中检测手势

GestureDetector将MotionEvent序列识别为滚动、抛掷、长按等回调;双击需要额外的双击监听接口。示例以长按切换翻页和拖动模式:翻页检查位移与速度阈值,拖动按距离平移,双击归位。识别事件与给事件分配业务含义是两层,回调返回值也必须与输入分派一致,不能把样例全部return false当作通用模板。

手势识别与界面模式分开进一步说明该问题的操作条件与边界。

抛掷翻页同时看位移与速度进一步说明该问题的操作条件与边界。

原书依据 · 2 处

7.30 在Android 1.6及更新版本中用Android 3.0片段构建UI

Fragment把界面拆成宿主Activity中的可复用片段,拥有自己的创建视图与状态回调。示例在列表选择时开始事务,替换容器、设置过渡并提交;加入片段返回栈可在返回时撤销相应变更。视图配置和magznumber状态分别保存恢复。原书对兼容包最低版本的文字互有冲突,不用它确定当前兼容范围;构造参数也不能当作系统重建时必定保留。

片段事务与状态恢复分别管理进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.31 使用Android 3.0 Photo Gallery

图库控件通过适配器把图片资源映射为可浏览的项,getCount给数量、getItem给数据、getView创建每项图像视图,点击回调再按位置取得对应图像。固定方形FIT_XY会影响长宽比,示例读取图像尺寸与显示名称也需区分不同资源类型;它展示的是历史Gallery组件路径。

图库适配器连接资源与选择进一步说明该问题的操作条件与边界。

原书依据 · 1 处

7.32 创建简单的应用程序窗口部件

App Widget由主屏幕宿主展示,不能直接像Activity那样持有并操作控件。Provider接收更新,在RemoteViews中描述文字与点击PendingIntent,再交AppWidgetManager更新;示例点击通过服务计算新心情后按widgetId更新。多个实例必须保留各自身份,PendingIntent身份不只由Extras决定,不能照抄相同请求标识就声称每个按钮都更新正确实例。

主屏幕小部件通过远程视图更新进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第8章 GUI警告:菜单、对话框、Toast和通知

第8章 GUI警告:菜单、对话框、Toast和通知

菜单提供可选操作,对话框要求确认或输入,Toast短暂显示低重要性信息,通知把事件留在应用窗口之外。这些机制处理不同注意力和交互需求,不能仅按编写代码多少选取;必须采取行动的错误不应只靠几秒后消失的Toast。

反馈机制按交互后果选择进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.2 创建和显示菜单

选项菜单可在res/menu用XML声明各项ID、标题和图标,Activity在onCreateOptionsMenu中加载资源。菜单定义负责呈现,选择处理属于另一回调;菜单按钮位置是历史系统界面背景,不据此要求当前设备拥有硬件菜单键。

菜单定义与行为回调分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.3 处理菜单选择项

用户选择菜单项后,onOptionsItemSelected取得MenuItem,按稳定ID分派动作。示例仅用Toast演示分派,实际业务结果仍要检查;未处理项不应无条件宣称已消费,否则会阻断其他默认处理。

菜单选择返回实际处理状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.4 创建子菜单

子菜单将相关选项组织成层次,可用XML或编程添加。原书在创建回调中指定组ID、项目ID、顺序与标题,再用选择回调按项ID处理;组身份和单项身份不是同一概念。小屏幕上的子菜单呈现可能与桌面层叠菜单不同,层次过深仍增加操作成本。

子菜单身份与显示顺序分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.5 创建弹出/警告对话框

未保存更改时应让用户分清保存、放弃与取消退出。AlertDialog为三条路径连接不同动作:保存执行持久化,放弃结束界面,取消仅关闭确认框并继续编辑。按钮“正面、中立、负面”只是界面角色,不能替代具体业务语义;保存失败也不能当已成功退出。

未保存提示区分三种决定进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.6 使用Timepicker窗口小部件

时间选择器把时和分的输入组织成平台控件,先以当前或已有值初始化,用户确认后回调更新状态与显示。示例把小时、分钟分别保存在字段中,并格式化前导零;选择钟面时间不自动确定日期、时区或提醒调度,需要业务另行说明。

时间选择器只解决结构化输入进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.7 创建类似iPhone的滚轮选择器

第三方滚轮不只是Java类,还依赖绘图资源,因此要用含资源的库项目或相应源码资源,而非只复制JAR。WheelView通过Adapter提供选项,变化监听与滚动起止监听承担不同反馈时机;示例滚动中暂缓汇总,停止后更新结果。多个滚轮的滚动状态应按实际并发交互管理。

滚轮选择在合适时机汇总进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.8 创建标签式对话框

标签式对话框用一个Dialog承载TabHost,先setup再为各标签设置标识、显示标题与内容ID。TabWidget展示标签,FrameLayout放内容,滚动容器承接长文字;标签ID、内容根视图和用户选择应对应。示例把内容指向TextView而外层又有ScrollView,复用时需核对目标层级。

对话框标签关联正确内容视图进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.9 创建ProgressDialog

进度对话框告诉用户后台任务正在运行。示例由点击在UI线程显示,工作线程模拟耗时后发消息,Handler在主线程撤除并更新文字。真正任务需要把结束、异常和取消都接到收尾,不能因为固定睡眠结束就宣称业务处理已成功。

后台结束后回主线程收尾进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.10 创建带有按钮、图像和文本的自定义对话框

自定义Dialog可用布局组合图片、文字和按钮,按钮分别执行关闭与跳转等行为。对话框适合局部补充信息,不因能放入全部控件就应把完整Activity挤进去;显示容器、关闭范围和跳转任务栈需要分别确定。

自定义对话框明确关闭与跳转进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.11 创建可重用的“关于”对话框类

可复用“关于”对话框从当前包信息读取版本,从字符串资源取得名称和说明,再用自定义布局显示。长文本可滚动,Linkify把网址和邮箱转换为可选链接;这能帮助支持人员确认版本,但链接化不等于已验证地址可信。资源、工具类和调用入口共同构成交付,不是只复制一段Java。

关于信息从实际发布物读取进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.12 自定义Toast显示

自定义Toast先定义图片与文字布局,用LayoutInflater实例化,再配置展示位置、时长并在触发时show。改外观没有改变短暂提示的性质:重要错误仍需可确认、可操作的反馈。原书setView等接口路径是旧方案,不声明跨版本都能任意定制。

自定义Toast仍是短暂提示进一步说明该问题的操作条件与边界。

原书依据 · 1 处

8.13 在状态栏中创建通知

通知用图标、标题和消息把后台事件留给用户,通过PendingIntent描述选中后的操作,再以通知ID发布或更新。清除通知与选中通知不同,前者不执行目标操作;自动取消也只是展示生命周期。声音、振动和灯光是可选提示,依赖设备能力与设置;原书部分flags/defaults写法混淆,不直接复制为现行代码。

通知提供用户主动返回入口进一步说明该问题的操作条件与边界。

通知刺激应区分配置与能力进一步说明该问题的操作条件与边界。

原书依据 · 2 处

第9章 GUI:ListView

第9章 GUI:ListView

ListView用于把数据项显示为可选择列表。后续攻略从适配器和点击开始,进入空数据、自定义行、分段及方向变化,逐步说明列表不只是重复放几个TextView。导言中的使用比例是写作时陈述,不用于当前应用统计。

9.2 用ListView构建基于列表的应用程序

ListView按行展示可滚动数据,Adapter把项目数量、项目对象、身份和行视图提供给容器。按需创建或复用视图减少构建成本;可复用视图还需检查行类型并重新绑定全部状态。后台加载结果回来时,旧View可能已被绑定给其他行,因此必须核对当前身份。分页可在接近末尾时异步取下一批,而不是先下载全部结果。

列表适配器连接数据与行视图进一步说明该问题的操作条件与边界。

复用行必须重新绑定正确状态进一步说明该问题的操作条件与边界。

异步列表结果先核对当前身份进一步说明该问题的操作条件与边界。

列表分页按用户需要加载进一步说明该问题的操作条件与边界。

原书依据 · 4 处

9.3 为ListView创建“无数据”视图

空列表应给出明确说明,避免让用户把没有项目误认成页面损坏。原书以android:empty配合标准列表机制展示空视图;普通ListView还需正确关联空视图,单独写个特殊ID不能保证所有宿主都自动接线。加载未完成、加载失败与真的零条也应在产品语义上区分。

空列表需明确关联空状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

9.4 创建具有图像和文本的高级ListView

图文列表把自定义行布局与数据适配器连接:文本数组和图像资源数组按同一位置配对,getView加载布局后分别填入。使用ListActivity时列表ID遵循宿主约定,普通Activity则可显式找控件。示例忽略convertView且所有getItemId返回0,只能作静态演示,不能据此声称已支持高性能复用或稳定行身份。

图文列表绑定须保持同一项目进一步说明该问题的操作条件与边界。

原书依据 · 1 处

9.5 在ListView中使用段标题

分段列表由一个总适配器组织多个子适配器,在总位置中区分段标题和段内项目。它复用每段自己的数据绑定方式,让日记可按日期等维度呈现;段头占据位置,因此总索引不能直接当子列表索引。原书未获许可而未附合成适配器完整代码,本节只解释已说明的组合契约,不臆造内部实现。

分段列表要映射总位置进一步说明该问题的操作条件与边界。

原书依据 · 1 处

9.6 使用户的注意力保持在ListView上

用户编辑或删除项目后,列表不应无故跳回开头。保存关注项目,在返回时找到它在当前数据中的位置,再以setSelection恢复浏览位置;列表变化后旧索引可能失效。设置选择只改变视图与焦点,不会自动再次执行项目动作。

列表返回应恢复用户上下文进一步说明该问题的操作条件与边界。

原书依据 · 1 处

9.7 编写自定义列表适配器

自定义媒体适配器从MediaItem读取标题、艺术家及选中状态,每次getView都完整填入行;状态保存在模型,复用时才不会随View一起串到别项。点击更新模型后notifyDataSetChanged通知列表重新读取和显示;通知不是修改数据本身,也不是已持久化。

列表选择状态应保存在模型进一步说明该问题的操作条件与边界。

原书依据 · 1 处

9.8 处理方向变化:从ListView数据值到横向图表

同一组数值在纵向可显示为列表,横向可显示为图表。原书显式处理配置变化并通过Intent序列化参数切换Activity,图表再解析数据构建系列;表示层变化不应成为数据重新生成或丢失的理由。示例锁定方向与配置处理方式、缺失的转换方法及活动返回控制仍需验证,不能当成完整可运行实现。

方向切换保持同一数据语义进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第10章 多媒体

第10章 多媒体

多媒体功能可以委托已安装的播放器,也可以直接管理采集与播放对象。两条路径分别承担外部处理者契约或本地资源与状态机责任,后续再加入面部检测、语音输入和文本朗读。

10.2 播放YouTube视频

原书从YouTube链接提取视频ID并构造相应URI,再通过ACTION_VIEW交给匹配应用播放。方案依赖设备上的处理者,URI提取也依赖链接形式;它并不是内嵌播放器或自行下载视频的实现。

外部视频播放依赖处理者进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.3 使用Gallery和ImageSwitcher视图

图像浏览器以Gallery选择缩略项,ImageSwitcher显示选中图像并执行淡入淡出;ViewFactory创建实际ImageView。选择集合、当前显示和过渡动画属于不同职责。示例一次加载全部Drawable只适合有限资源,不应默认为大图库方案;空catch也不能当成有效失败处理。

图像选择与显示过渡分离进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.4 用MediaRecorder捕捉视频

MediaRecorder由状态约束方法顺序:建立相机与预览资源、配置源及输出、prepare成功后才能start,停止后按需要重新配置。Surface回调衔接资源取得和释放,共享相机用完必须归还;准备异常时不能继续标已就绪。视频时长和输出文件也需要存储空间边界,原书无限录制仅是演示。

录制调用受状态机约束进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.5 使用Android的面部检测功能

面部检测寻找图像中类似人脸的区域及眼部位置,不回答“这是谁”。示例设置最多检测数,读取结果中的眼部中点、间距和置信信息,再把图像坐标映射到View;结果数组容量不等于实际找到的人脸数。显示缩放时中心和标记大小需同样考虑比例,空结果不能靠异常掩盖。

面部检测不等于身份识别进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.6 播放来自文件的音频

MediaPlayer负责媒体源和播放状态,MediaController是用户操作界面,应用通过控制接口把按钮映射到播放器。要在源准备完成后开始播放,不能把创建对象等同于可播放;原书同步prepare后才注册监听等片段需校验顺序。播放位置占时长比例也不是缓存百分比,释放和停止必须符合当前状态。

播放器状态与控制界面分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.7 无交互播放音频

短提示音可直接创建MediaPlayer并播放,资源内音频与文件路径分别有方便创建和手动准备路径。长音频即使不提供完整控制器,也应给用户停止办法;停止、自然完成和释放不同,重复创建而不release会耗尽资源。

短音效也要管理播放资源进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.8 使用语音识别功能

语音输入通过RecognizerIntent交给匹配识别组件,回调可能给出多个候选字符串。示例只显示第一个,但实际还需处理取消、无数据和空候选;识别出的文本不是业务事实,不应在需要确认的场景中直接当成用户最终授权。

语音结果是候选文本进一步说明该问题的操作条件与边界。

原书依据 · 1 处

10.9 使用设备的朗读功能

朗读先依赖语音数据和引擎初始化。原书检查TTS数据,不可用时请求安装;初始化回调成功后再选择语言、发出speak,结束使用时shutdown。引擎对象已经创建不代表异步初始化完成,立即连续调用后立刻关闭并不是可靠朗读流程。

朗读等待引擎真正就绪进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第11章 数据持久性

第11章 数据持久性

持久性章节按对象区分文件系统、关系数据库、联系人共享数据与交换格式。文件是字节内容及路径,SQLite提供表与SQL访问,联系人通过平台接口读写,JSON和XML用于表示与转换数据;把文本解析成对象本身并没有保存数据。原书没有在导言展开网络缓存或迁移保障,不把它们补写成作者结论。

持久化选择进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.2 获得文件信息

File对象描述一个路径,构造本身不创建磁盘文件。可查询存在性、类型、大小、权限和修改时间,真正修改要调用对应方法;规范路径和大小写表现受文件系统环境影响。一次信息查询只是当时观察,不能当成随后I/O必定成功的承诺。

路径对象不等于磁盘文件进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.3 读取应用自带而非文件系统中的文件

打包在res/raw的资源不是普通磁盘路径,应按R资源ID调用openRawResource取得流,再按文本或二进制读取。示例用BufferedReader读行并追加到StringBuilder,但没有恢复换行,也未完整展示关闭;若保留原文结构或大文件,不能机械照抄一次全部放进文本框。

包内资源通过资源流读取进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.4 列出目录

list返回目录条目名,listFiles返回对应File对象,后者适合继续查询类型和大小。FilenameFilter按目录与名字选择,FileFilter直接取得File;过滤减少候选而非自动排序或递归。目录枚举失败与空目录不同,结果应先核验再排序和显示。

目录枚举区分名字与对象进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.5 获得关于SD卡的总空间和可用空间的信息

StatFs对目标存储路径给出块尺寸与块数量,两者相乘得到总字节;改用可用块得到应用可用空间。乘法前转宽整数以避免中间值溢出,除以1048576是二进制兆单位。空间是查询时刻的估计,文件创建仍可能因竞争、权限或容量变化失败。

空间估算先乘宽整数再换单位进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.6 花费最小的精力提供用户首选项设置活动

用户偏好可以由PreferenceScreen声明类型、键、显示项与选项值,PreferenceActivity负责旧版设置界面,SharedPreferences保存跨运行的值。读取时使用与定义一致的键和类型,并为首次未设置值提供默认;屏幕上的文案与保存值不必相同,不能让翻译改变业务键。

偏好界面与持久键值对应进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.7 检查默认共享首选项的一致性

首选项变化监听在修改提交后收到通知,不是提交前阻止。原书发现不合要求时写回默认值并刷新界面,先向用户解释原因避免突然改值;监听注册与注销配对,修正还可能再次触发回调。已写回存储与界面已显示一致需要分别核对。

偏好修正处理存储与界面一致进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.8 执行高级文本搜索

全文搜索用FTS3虚拟表建立可按词项匹配的文本集合,通过MATCH表达式查询,Cursor遍历结果并在结束时关闭。SQLiteOpenHelper管理创建和版本升级,数据层让界面不直接拼装所有存储操作。原书以删除重建演示升级,会丢数据,查询异常也不能折成“无结果”;搜索表达式与普通SQL参数化值的契约需分开理解。

全文匹配使用专用索引契约进一步说明该问题的操作条件与边界。

数据库版本升级不能默认清库进一步说明该问题的操作条件与边界。

原书依据 · 2 处

11.9 在Android应用程序中创建SQLite数据库

SQLiteOpenHelper以数据库名和版本管理打开、创建和升级入口。首次创建通过onCreate建立表,getWritableDatabase返回可操作句柄,再进行查询和修改。SQL语句的标识符、类型与空格必须完整,原书字符串拼接展示有排版缺口,不能据展示片段直接断言能建库成功。

数据库助手管理创建与打开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.10 在SQLite数据库中插入数值

插入记录可用ContentValues按列名组织值,再交SQLiteDatabase.insert写入。返回值是数据库行标识或失败结果,不能把界面列表追加和数据库插入混成一个动作;示例tasks.add没有完整上下文,实际应在确认写入结果后更新相应视图或模型。

插入结果决定后续模型更新进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.11 从现有的SQLite数据库加载数值

query以表、列和排序等条件返回Cursor。先确认可定位到首行,再按指定列类型读取并前进到下一行,最后关闭;Cursor表示访问结果的迭代位置,不是已全部构造好的业务对象列表。示例把各行转换为Food对象,空结果也是有效情况。

游标遍历要处理零行与关闭进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.12 在SQLite中使用日期

时间值的纪元和单位必须明确。Unix常用自1970年UTC起的秒,Java Date构造读取毫秒;原书用strftime的%s取得秒再乘1000交给Java。SQLite接受的时间表示还可用于日期计算和默认当前时间;转换不能凭列名为timestamp就推断存储类型,也不能恢复原来没有保存的亚秒精度。

时间戳转换先统一纪元与单位进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.13 用JSONObject解析JSON

JSON是数据交换格式,JSONObject用键和值构造对象并序列化,也可从字符串解析后按键读取。请求成功不代表字段、类型和业务值正确,异常不能只打印后继续当作完整数据;示例的方法括号与返回位置也只是片段,需要验证。

JSON解析遵循字段类型契约进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.14 用DOM API解析XML文档

DOM把XML解析成树,应用从根元素遍历子节点并提取字段。空白、元素与文本都是不同节点,不能盲目把第0和第1子节点当作id和title;原书直接在Element上getNodeValue的片段也不能可靠取得元素文本。输入可直接传流,避免先全文转字符串再转回字节的额外复制。

DOM读取先识别节点类型进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.15 用XmlPullParser解析XML文档

拉式XML解析由应用不断next取得开始标签、文本和结束标签,可按消费进度逐步读取,而不必先建完整树。示例第一版保存当前标签再填字段,严格版用require验证结构、用nextText读取字段,避免默默接受不符预期的嵌套与顺序。静态XML资源也能取得相应解析器;原书简单速度排序没有普遍基准依据,不据此认定所有输入都更快。

拉式解析由应用推进事件进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.16 添加联系人

联系人由账户、RawContact与带MIME类型的数据行组织,不只是往一张平面表写姓名。原书先创建原始联系人,再通过批操作回引用把姓名、电话和邮箱关联到前一项结果,最后applyBatch提交。账户选择与访问权限需要真实核验,示例假账户和首个认证器不能无条件照用。

联系人批操作用回引用关联进一步说明该问题的操作条件与边界。

原书依据 · 1 处

11.17 读取联系人数据

联系人选择返回定位URI,先查联系人ID,再按ID查询电话号码等分表。一个联系人可有多个号码,界面应让用户确认实际目的地;原例循环setText只会保留最后一次覆盖值,并未实现完整多号码选择。数值型HAS_PHONE_NUMBER不能用只认识true文本的布尔解析替代,游标也要在所有路径关闭。

联系人身份与号码列表分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第12章 电话应用程序

第12章 电话应用程序

电话与SMS功能依赖设备是否有相应通信能力。Wi-Fi设备可能没有蜂窝通话或短信路径,网络语音和短信服务属于另一套连接;Intent可委托拨号,直接操作又有不同授权和反馈。后续均按原书历史API解释,不将设备有Android等同于电话功能可用。

通信功能以设备能力为前提进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.2 在电话铃响的时候进行某些操作

原书通过电话状态广播区分RINGING、OFFHOOK和IDLE,只有对应状态下才解释来电号码等字段。接收器应快速结束,不把耗时处理放进回调;若需向用户展示信息,用通知保留主动选择入口。普通广播接收次序未定义,不应依赖另一个接收器先完成。

电话状态事件按状态解释字段进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.3 处理呼出电话

有序广播可让前一接收者的结果数据传给后者,原书据此演示号码改写。原始号码与累计改写后的号码属于不同输入;相同优先级不能依赖偶然注册顺序,最高值也不保证绝对第一。电话广播还存在紧急呼叫等专用限制,通用abortBroadcast规则不能直接套用。

有序广播区分原值与累计结果进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.4 电话自动拨号

示例用ACTION_DIAL与tel URI打开拨号界面,用户仍需按呼叫按钮,因此标题所说“自动拨号”不能解释为已直接呼出。拨号界面与ACTION_CALL等直接呼叫行为不同,权限也不能仅凭原书混用的一句说明推断。

打开拨号界面不等于呼叫进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.5 发送单部分和多部分SMS消息

SMS长消息应由SmsManager按编码规则拆分,单段与多段分别调用对应发送路径,不能简单固定每160个中文字符切割。示例返回true只说明走过发送调用,没有提供发送和送达PendingIntent,因而不能证明用户已收到;它也未展开重试幂等策略。

短信分段与投递结果是两层进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.6 在Android应用程序中接收SMS消息

旧SMS接收路径由广播携带PDU数组,接收器逐段解码取消息体。原书逐段Toast只展示原始片段,不保证已经按顺序拼成一条长消息;数据、格式和权限都需核对。接收消息内容不等于取得可信业务指令,后续解释仍应有明确约束。

短信接收先解码再组装消息进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.7 使用模拟器控制面板向模拟器发送SMS消息

DDMS的Emulator Control可输入模拟来源号码与消息文本,向选定AVD注入短信。这用于检验接收器和显示路径,不产生真实蜂窝投递;模拟来源字段由测试者填写,不能当作发送方身份验证。

模拟短信验证接收路径进一步说明该问题的操作条件与边界。

原书依据 · 1 处

12.8 使用Android的TelephonyManager获得设备信息

TelephonyManager可以查询部分静态信息并监听通话、连接、信号和服务状态变化。监听应随使用范围注册和停止,未知枚举及不可取得值需保留未知;示例把GSM信号简单归一为百分比,不能推广到所有制式。原文一次读取所有标识只是演示,不意味着当前设备、权限与政策允许全部获得。

电话信息查询与监听分开进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第13章 联网应用程序

第13章 联网应用程序

移动网络选择不仅看能否写出客户端,还看实际网络能否通过。原书用当时GPRS代理限制说明HTTP/HTTPS的可达性优势,并区分SOAP/XML与REST风格服务的数据表示;这不等于所有网络永远只允许HTTP,也不表示REST必须使用JSON。

网络协议选择还看部署可达性进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.2 使用REST风格的Web服务

服务访问先把资源地址、HTTP动作和请求体定义清楚,再处理响应内容。原书用攻略列表和单条详情说明GET读取,用带主体请求提交修改,客户端可用URLConnection或旧Apache HttpClient;返回XML后还需解析为模型。示例同步调用位置会阻塞界面,未写出的状态码、超时和错误原因不能当作已处理。

服务访问分离传输与数据解析进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.3 用正则表达式从无结构文本中提取信息

没有结构化接口时,原书先获取页面,再用正则捕获排名数值、删除分组逗号并转整数。多行内容需要完整匹配上下文,而页面结构随时会变,未命中应显式失败;这只是针对已知半结构模式提取,不是通用HTML解析器。

半结构提取要显式检查匹配进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.4 用ROME解析RSS/Atom Feed

ROME把不同RSS/Atom格式转成较统一的Feed与Entry对象,应用读取条目标题等字段显示列表。库负责格式解析,网络读取、异常处理和界面更新仍由应用安排;示例直接在按钮中下载会阻塞UI。原书对旧下载站证书错误的绕过建议不沿用,项目来源与连接验证应另查可靠发布渠道。

订阅解析库统一格式不包办网络进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.5 用MD5加密明文

本节标题将MD5称为“加密”,需要纠正:代码调用MessageDigest生成摘要,没有加解密密钥或解密过程。RFC 6151明确MD5不能用于要求抗碰撞的场景;这不提供明文机密性。代码的十六进制转换还缺每字节补零,可能丢失固定宽度。这里区分原书示例与外部纠错,不把它写成安全的保密方案。

摘要不等于明文加密进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.6 将文本转换为超链接

TextView的autoLink可把识别出的URL等文本变成可点击链接,让系统处理后续打开动作。链接化只改变交互表现,不验证目标身份或内容安全;all还可能识别不止网页,应用应选择适合的类型。

自动链接化不等于目标验证进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.7 用WebView访问网页

WebView在应用内展示网页,布局声明后取得对象并loadUrl;远程网页还依赖网络访问条件。它与ACTION_VIEW交给外部浏览器不同,应用承担嵌入页面的导航和生命周期责任,发出加载请求不等于网页已加载成功。

嵌入网页与外部浏览器不同进一步说明该问题的操作条件与边界。

原书依据 · 1 处

13.8 自定义WebView

WebSettings控制当前WebView的图片加载、字体、缩放、脚本等行为,配置项应围绕页面需要选择。启用JavaScript增加运行能力,不是让所有网页自动正确;密码和表单保存相关旧API也不是完整隐私策略。具体方法及默认值按目标版本核对。

网页设置按所需能力开启进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第14章 游戏与动画

第14章 游戏与动画

游戏框架把场景、精灵、输入和物理等常见能力封装起来,减少重复基础工作。选择时应按项目需要比较功能,而不是把所有桌面框架视为天然可用于Android;原书框架表是历史选择线索,不能当作当前维护状态清单。 表14-1实际列出AndEngine、Box2D、Corona SDK、Flixel、libgdx、PlayN、rokon、ShiVa 3D与Unity,并比较是否开源、价格和网址;表本身不是功能全面性测试,价格及维护情况均不能外推为现状。

游戏框架按实际功能取舍进一步说明该问题的操作条件与边界。

原书依据 · 1 处

14.2 用flixel-android构建Android游戏

Flixel的Android移植以游戏视图承载场景,精灵表达在图形空间移动的实体。Droid示例把方向输入变成水平加速度和跳跃速度,再按着地、水平速度与垂直方向选择动画,最后调用父类更新物理状态。输入、运动和动画联动,但具体速度与资源帧是该游戏参数,不是通用物理规律。

精灵按运动状态选择动画进一步说明该问题的操作条件与边界。

原书依据 · 1 处

14.3 用AndEngine(Android-Engine)构建Android游戏

AndEngine示例按引擎、资源、场景、完成加载四阶段准备游戏。纹理负责外观,场景放置精灵,物理世界提供刚体与边界,PhysicsConnector把刚体状态同步到可视实体;显示成球并不意味着物理代理也是球形,代码实际创建盒状刚体。

触摸回调按对象找到关联Body并设置速度,加速度回调把设备读数映射为物理世界重力。原文描述的拖动击球并未由所示单次按下逻辑完整实现,样例资源与动画帧也存在需核对之处,不能冒充已运行验证的台球游戏。

物理刚体与可视精灵需要同步进一步说明该问题的操作条件与边界。

传感输入需明确映射游戏量进一步说明该问题的操作条件与边界。

原书依据 · 2 处

14.4 处理定时键盘输入

本例不是让界面线程睡眠,而是在每次释放按键后取消旧延迟消息、重新安排空闲超时。按键事件立即执行任务A,持续一段时间没有新事件才执行B,形成基于最后事件的延迟动作;对象销毁时还需处理未到期消息,避免旧任务继续调用。

重置延迟消息检测输入空闲进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第15章 社交网络

第15章 社交网络

社交网站集成可把用户转交浏览器,也可直接调用网站接口;两者在授权、消息格式与交互控制上不同。原书讨论的是成书时的平台格局,不代表今天存在统一且通用的社交网络API。

15.2 用HTTP集成社交网络

图像按钮的点击处理器构造分享URL,再用ACTION_VIEW将用户转交浏览器。URL参数必须按站点协议编码;用户仍需在网站中完成操作,因此打开入口不能当作分享成功。原书所列站点和短链均是历史示例,本轮没有验证它们当前可用。

分享入口不等于发布完成进一步说明该问题的操作条件与边界。

原书依据 · 1 处

15.3 用JSON加载用户的Twitter动态

示例先发送HTTP请求,检查200响应,读取JSON,再按数组中的created_at与text字段构造显示内容。网络状态、响应结构和界面展示是连续但不同的环节。原书公开动态无需认证的说明只针对当时端点,不应扩展为今天的接口保证;失败也不等于空动态。

公开数据仍依赖接口契约进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第16章 位置和地图应用程序

第16章 位置和地图应用程序

位置服务负责产生坐标,地图服务负责呈现地理信息。原书以Google Maps和OpenStreetMap演示两种地图路线;设备有GPS也不保证随时有可用坐标。

16.2 获得位置信息

先以Criteria筛选已启用提供器,处理没有匹配服务的情况,再注册带最小时间和距离的更新监听。onLocationChanged提供坐标及时间;onResume申请、onPause移除使定位消耗随使用期收束。精度说明是原书环境示意,不是无条件承诺。

定位订阅随使用期收束进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.3 在应用程序中访问GPS信息

独立LocationListener可接收位置变化,但应用数据与界面通常仍由活动管理。示例用getLastKnownLocation取得已知位置,和持续更新回调不同;代码未展示LocationManager初始化,也未检查空返回,不能直接复制成完整应用。应将数据交给实际拥有业务资源的对象处理。

最后已知位置不等于实时位置进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.4 在设备上模拟GPS坐标

通过测试提供器注入构造的Location,使演示不依赖现场GPS。样例设置经纬度、精度、可用状态和测试位置,再让普通监听接收;这改变的是定位输入,不能冒称真实移动。测试后须恢复真实定位,本轮未执行设备注入。

模拟定位替换输入而非移动设备进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.5 使用地理解析和反向地理解析

Geocoder将地址转换为坐标,反向解析则从坐标取得地址字段。它可能访问服务器,原书要求离开UI线程。服务存在不意味着查询必有结果,示例直接取list.get(0)仍需处理空列表和失败。

地理解析离开界面线程进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.6 准备Google Maps开发

历史Google Maps准备流程连接运行时库、MapActivity、MapView、签名身份与API键、网络权限和构建目标。地图元素需要完整类名、可点击属性和缩放设置,清单声明外部地图类库及联网权限。键码按当时签名证书指纹申请,调试与发布签名必须区分;可重新申请的地图键与必须备份的签名keystore不是同种资产。保留依赖排查方法,不将旧注册入口和SDK配置当作当前接入教程。

地图接入要核对整条依赖链进一步说明该问题的操作条件与边界。

服务键与签名密钥分开管理进一步说明该问题的操作条件与边界。

原书依据 · 2 处

16.7 将设备当前位置添加到Google Maps

MyLocationOverlay是地图库提供的当前位置图层,加入MapView的overlays后刷新绘制。它仍需位置权限,并在恢复与暂停时启停定位。加入集合只建立显示关系,不能代替订阅控制。

位置图层同时管理定位订阅进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.8 在Google MapView上绘制位置标志

地图地理坐标先转换为旧GeoPoint的百万分之一度整数,再经Projection转屏幕像素。自定义Overlay在非阴影轮次画标志,x减半宽、y减整高,使底部中心落在坐标点;原文第⑥项把y解释成向右移动并不符合代码。图层加入集合后invalidate刷新,移动视窗与添加标志仍是两项操作。

地图标志先投影再对齐锚点进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.9 在MapView上绘制多个位置标志

ItemizedOverlay用createItem与size暴露列表,新增项目后populate使聚合状态更新。标志Drawable需设置边界,可选中底或居中锚点;位置跨度用于缩放,中心点需另定。onTap(index)处理某个标志并返回已消费状态,把地理对象与触摸交互连接起来。

多点图层暴露集合并刷新聚合进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.10 为Google MapView创建图层

AddressOverlay将Address经纬度转换为GeoPoint,在draw中投影成Point,再把图片中心对准该点。外层活动负责实例化、加入图层与刷新;图层负责位置和绘图,避免两者职责混在一起。这个例子采用居中锚点,与上一例中底锚点不同。

图层分开管理位置与宿主装配进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.11 改变Google MapView的模式

旧版MapView通过地图模式开关改变底图表现,原书按街道信息与地形信息的阅读需求取舍。模式切换改变呈现,不改变位置数据本身;本攻略没有展开当前地图API的等价用法。

地图模式服务阅读任务进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.12 在不使用Drawble对象的情况下绘制图层图标

Nearby Metars把天气字段转为程序绘制图标。ItemizedOverlay在非阴影轮次遍历项目,项目将地理点投影、按缩放估算大小并保留最小可见尺寸,再用圆、弧、填充和线段表达云量与风向。画笔透明度让底图标签仍可读;同区域绘制有覆盖顺序,画布既有变换也须保留。原文末尾把project称为风向弧度与代码不符:project控制图标尺度,三角函数使用windDir。具体气象含义、角度单位和赤道比例近似须核对,不能宣称航空可用。

动态图标由数据字段驱动绘制进一步说明该问题的操作条件与边界。

绘图尺度与角度不可混用进一步说明该问题的操作条件与边界。

原书依据 · 2 处

16.13 在Google Maps上实现位置搜索

从EditText取地址文本,经Geocoder查询后,按有结果与零结果分别展示。所示代码只请求一个候选并Toast展示,没有实现全部结果列表、地图定位或最佳结果评分;也未体现攻略16.5要求的后台查询。地址行循环采用小于最大索引,存在遗漏末行的风险。

位置搜索区分查询与结果呈现进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.14 在一个TabView中放置MapView

旧TabActivity用TabHost、TabWidget和tabcontent容器组织切换内容。地图先在独立MapActivity运行,再通过TabSpec.setContent(Intent)嵌入选项卡;普通详情则直接引用视图ID。布局、活动注册与外部地图库均需一致,原书包名等示例配置仍须核对,不能视为今天推荐的导航方案。

复杂页先独立运行再装入容器进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.15 处理MapView的长按动作

自定义MapView保留父类触摸行为,按下时启动500毫秒计时,地图移动、抬手或多指触摸时取消。超时后把屏幕坐标反投影为GeoPoint,再交监听器处理;示例用runOnUiThread回到界面线程。它没有完整实现上下文菜单,也未覆盖取消事件、空监听器与销毁清理,使用前须补齐这些边界。

长按是可取消的延迟判断进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.16 使用OpenStreetMap

osmdroid提供另一套MapView及控制器,示例加入地图和日志依赖、网络权限与状态权限,再配置缩放和多点触摸。它使用OpenStreetMap地图数据,不代表与Google类完全同名同义;依赖版本和包名须成套核对。所示JAR版本与下载入口仅为历史上下文。

地图数据与显示程序库分开选进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.17 在OpenStreetMap地图上创建图层

地图中心点控制初始视窗,标注点表示业务地点;两者分别创建。OverlayItem集合交给ItemizedIconOverlay,配资源代理后加入图层集合并刷新,图中缩放改变视窗而非地点。

地图中心与标注位置各有职责进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.18 在OpenStreetMap地图上使用比例尺

ScaleBarOverlay以图层形式呈现当前地图缩放比例,帮助估计屏幕距离对应的地理距离。添加比例尺不用改变地点集合,也不负责计算行程距离。

比例尺表达视窗中的距离关系进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.19 处理OpenStreetMap图层上的触摸事件

ItemizedIconOverlay构造时接收OnItemGestureListener,在单击和长按回调中取得具体项目及索引,再展示标题说明。事件处理与标记数据绑定;代码单击返回true、长按返回false,即便都显示Toast,消费语义仍不同,不能仅看副作用判断事件已消费。

图层手势绑定具体业务项目进一步说明该问题的操作条件与边界。

原书依据 · 1 处

16.20 用OpenStreetMap地图获得位置的更新

位置监听接到新经纬度,转换为旧GeoPoint整数,再更新地图中心并刷新。模拟器注入不同坐标可观察移动,不必真实出行。这个示例只在onCreate注册,没有展示移除监听,实际装配须与16.2的订阅生命周期结合;不断居中也会与用户手动浏览发生交互取舍。

跟随定位是更新视窗的策略进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第17章 加速计

第17章 加速计

本章介绍加速计及其他传感器。导言里的两部手机接触后用共同运动生成共享密钥只是作者设想,作者明确尚未见实现,不能写成经过验证的密码协议。真正可操作的内容是后续存在性检查、摇晃判定和方向温度读取。

17.2 检查传感器是否存在

先从SensorManager枚举特定类型传感器,仅在非空时取实例;设备没有所需硬件是必须明确展示的分支。原例服务名SOME_SENSOR_SERVICE是占位,实际不能原样复制,后例使用SENSOR_SERVICE。原来的传感器噪声卡未获本章证据,保留原文件身份改写为可证的存在性检查。

使用前检测传感器是否存在进一步说明该问题的操作条件与边界。

原书依据 · 1 处

17.3 使用加速计检测设备的摇晃

摇晃例子保留前后两次三轴加速度,首个样本只初始化,避免与默认零值产生伪差。至少两轴变化幅度超过阈值形成一次快速变化,再用shakeInitiated记录持续变化并触发动作;变化消失时复位。它是阈值与状态启发式,不是通用滤波器,也不能证明运动方向真的反转。示例没有展示注销监听和触发冷却,需另行处理。

摇晃判定结合差值与状态进一步说明该问题的操作条件与边界。

原书依据 · 1 处

17.4 用加速计根据屏幕方向检查设备是向上还是向下

示例以加速计z值在9到10或负10到负9之间区分面朝上与下,前提是坐标约定与姿态适合该判断。它不覆盖所有倾角和运动状态,阈值之外应保留未定状态;先取第一个传感器的代码也须补存在性检查。

姿态阈值只覆盖指定区间进一步说明该问题的操作条件与边界。

原书依据 · 1 处

17.5 用方向传感器发现Android设备的方向

旧方向传感器返回方位角、倾斜与滚转;代码按pitch优先、roll其次的区间输出哪一边朝上。分类结果依赖坐标定义与分支顺序,未命中不是新的测量结论。设备无方向传感器时应停止注册,而非仅设置提示后仍用空对象注册。本节保留旧TYPE_ORIENTATION上下文。

方向分类要注明坐标与优先级进一步说明该问题的操作条件与边界。

原书依据 · 1 处

17.6 读取温度传感器

温度例子取得目标传感器,以最快延迟注册监听,在回调显示values[0]。它没有说明温度所代表的具体物理部件,也未提供环境温度保证;先按17.2核查支持,再核对目标传感器含义和必要采样频率,不应仅凭值名当成室温。

传感器数值先确认测量对象进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第18章 蓝牙

第18章 蓝牙

蓝牙提供外设连接,但设备支持的协议和应用数据格式仍需分别处理。原书以SPP套接字展示发现、连接与流式读写,HDP健康设备规范只列未来计划,不在本章实现范围。

蓝牙连接不替代业务协议进一步说明该问题的操作条件与边界。

原书依据 · 1 处

18.2 启用蓝牙并使设备处于可发现状态

先检查适配器是否启用,未启用时用系统Intent请求用户同意,并按结果处理。可发现状态是另一项请求,原书示例限定120秒。支持蓝牙、启用蓝牙、可被发现不能混为一谈;示例还未处理getDefaultAdapter为空的硬件缺失分支。

蓝牙启用与可发现分别确认进一步说明该问题的操作条件与边界。

原书依据 · 1 处

18.3 连接启用蓝牙的设备

蓝牙客户端按服务UUID建立RFCOMM套接字,连接可能阻塞,因此在后台执行,连接前取消发现以减少干扰。连接后用流读写,结束关闭套接字。所示代码混用了socket与mmSocket、未等待连接完成就准备流、忽略读取长度与EOF,不能当作可直接运行的完整通信实现。

阻塞蓝牙连接离开界面线程进一步说明该问题的操作条件与边界。

流读取需要边界与结束语义进一步说明该问题的操作条件与边界。

原书依据 · 2 处

18.4 监听和接收蓝牙连接请求

服务端用服务名称与UUID创建BluetoothServerSocket,另开线程调用accept等待入站连接,再把得到的已连接套接字交给通信逻辑。可发现请求结果决定是否开始监听;监听套接字与接收后的连接套接字不同,示例没有完整展示关闭与连续接受策略。

监听套接字与会话套接字分工进一步说明该问题的操作条件与边界。

原书依据 · 1 处

18.5 实现蓝牙设备发现

发现过程经广播异步交付:ACTION_FOUND提供设备,ACTION_DISCOVERY_FINISHED结束扫描并处理空结果。例子只添加未绑定设备,注册接收器和设置列表并未完整展示startDiscovery与注销。原文把可发现称作配对容易误导:其代码明确区分BOND_BONDED,能被发现并不等于已绑定或连接。

发现设备不等于完成配对进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第19章 系统与设备控制

第19章 系统与设备控制

本章集中讨论公开系统服务可提供的信息和控制能力;实际能力仍受目标系统、硬件与权限约束。后续攻略分开读取网络与清单信息、改变通知、剪贴板和执行进程。

19.2 访问电话网络/连接性信息

ConnectivityManager取得活动网络信息,再分别检查可用性、已连接、漫游和类型。所示代码未处理没有活动网络的空值;网络处于连接状态也没有验证某一远端请求成功,不能替代真正请求的错误处理。

网络状态只是请求前的线索进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.3 从清单文件获取信息

通过PackageManager读取当前包的PackageInfo.versionName,减少另存一份版本字符串造成的不一致。原例捕获异常后仍访问packageInfo,失败时会产生空引用;应将读取失败作为结果表达,而不是只写日志。

版本显示复用包元数据进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.4 将来电通知改为静音、振动或者普通

三个按钮分别调用AudioManager设置静音、普通和振动模式,并显示提示。这里改变的是系统响铃模式,不是单个音频的播放音量;API调用与用户可见结果须对应,具体系统允许范围属于原书版本条件。本轮未在真实设备执行更改。

响铃模式与媒体音量分开处理进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.5 复制文本以及从剪贴板获取文本

ClipboardManager示例写入文本,再读取CharSequence并展示。写入与读取是独立操作,直接toString前应确认文本存在;该例只覆盖历史文本剪贴板,不提供任意格式和版本的完整支持。

剪贴板读写各自检查有效值进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.6 使用基于LED的通知

通知对象配置LED颜色、亮灭时长与FLAG_SHOW_LIGHTS,再由NotificationManager提交。这里的ledARGB是字段而非正文所称方法;能否实际发光仍取决于设备LED与系统支持,不能仅凭notify调用保证出现。

灯光通知声明颜色与时间进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.7 使设备振动

通知vibrate字段用毫秒数组描述等待与振动节奏,并需清单VIBRATE权限。原文把有限数组描述为如此继续,所示代码却没有表达无限重复;因此笔记只保留有限节奏请求,真实呈现受设备和系统通知策略影响。

振动节奏由有限时序描述进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.8 从应用程序运行Shell命令

Runtime.getRuntime().exec启动独立原生进程,Process提供标准输出流,示例读完输出再waitFor等待。完整进程管理还需错误输出、退出结果、中断与关闭策略,不能只以有输出认定成功。它启动指定程序,不是自动解释任意Shell语法。

启动进程后仍需收束执行结果进一步说明该问题的操作条件与边界。

原书依据 · 1 处

19.9 确定指定应用程序是否运行

ActivityManager提供运行进程列表,样例比较processName与包名返回布尔值。但循环变量声明idx、访问却用i,且未处理列表为空;进程名相符只是该历史接口观察到的进程状态,不代表应用可交互或业务健康。

进程存在与应用可用分开判断进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第20章 其他编程语言和框架

第20章 其他编程语言和框架

原书把Java、JNI原生代码、脚本环境和Web容器视为不同开发路线。复用语言和跨平台打包可以减少部分工作,却不自动符合平台交互习惯;原生能力边界、外观与用户期望仍需逐项验证。App Inventor仅作为进一步线索,未在本章展开教程。

跨平台复用仍要验证平台体验进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.2 运行外部/原生UNIX/Linux命令

本例同样用Runtime.exec启动原生进程,逐行读取标准输出供日志或界面使用。与19.8相比没有新启动机制;原例while条件在readLine之外又调用read,混用两种推进方式会消费额外字符,应只采用一条清晰读取路径。

流循环保持单一推进方式进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.3 在NDK上用JNI运行原生C/C++代码

JNI路线先声明native方法并加载库,生成匹配Java包类方法的头文件,再实现C函数、配置Android.mk、构建共享库并打包。JNIEnv和静态方法的jclass是调用边界的一部分,Java/C类型要按JNI映射匹配。原例C代码用labs处理double差值,不能默认其停止条件与Java Math.abs相同;事件线程大量计时还会触发ANR。原生代码可复用C/C++与处理计算,但性能收益须测量,并承担ABI、内存与进程崩溃风险,不能用volatile一词替代跨语言同步设计。 表20-1逐项映射Java基本类型到jbyte/jshort/jint/jlong/jfloat/jdouble/jchar/jboolean,基本类型数组对应相应JNI数组类型;对象及对象数组使用jobject/jobjectArray,Class、String、Throwable分别对应jclass、jstring、jthrowable。类型映射不能替代引用生命周期与内存管理。

原生调用依赖完整绑定链进一步说明该问题的操作条件与边界。

原生性能收益必须实测进一步说明该问题的操作条件与边界。

原书依据 · 2 处

20.4 从SL4A入手

SL4A先安装脚本层和所需解释器,再通过android.Android桥接设备API,支持编辑后直接运行。解释器可能位于不同运行环境,脚本文件与解释器安装分开管理;原书未知来源安装、菜单和脚本目录均属当时环境,不代表今天的部署路径。

脚本环境与设备能力由桥连接进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.5 用SL4A创建警告

SL4A对话框分为创建、配置按钮或列表、显示三个阶段。例子展示一按钮、两按钮与列表三种外观,但没有读取用户选择或执行后续业务,因此只能算界面构造,不是完整确认流程。

构造对话框不等于处理选择进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.6 使用SL4A读取Google文档并在ListView控件中显示

历史gdata脚本按输入凭据登录,再获取文档摘要、截短标题并格式化列表,最后显示在对话框而不是原生ListView。登录异常后代码仍继续请求,且密码行存在语法问题;应将授权失败与合法空列表分开。此处不推荐执行历史账号密码登录,本轮也没有采集凭据或访问私人文档。

授权失败不能沿用成功路径进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.7 用QR码共享SL4A脚本

QR码可承载短脚本文本,首行名称与后续代码须按粘贴方式处理,再由接收者查看、保存和运行。它是信息编码载体,原文称为加密或解密容易误导;未提供保密性或来源可信证明。字符容量依编码条件变化,不把书中单一数字当成任意Unicode脚本的容量保证。

二维码传脚本仍需检查内容进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.8 从WebView中通过JavaScript使用原生手机功能

WebView用addJavascriptInterface向网页暴露命名Java对象,页面按钮调用桥接方法,再由Java启动原生能力。桥应保持窄接口,不能从HTML可调用推导出任意页面都值得信任。原例有分号、变量及HTML括号等不完整处,未展示目标版本所需全部配置,不能当作可直接运行或已验证安全的桥接实现。

网页桥接只暴露明确能力进一步说明该问题的操作条件与边界。

原书依据 · 1 处

20.9 用PhoneGap/Cordova创建平台无关的应用程序

PhoneGap/Cordova将HTML、CSS和JavaScript装入原生应用壳,平台活动仅加载资源页;跨平台复用发生在Web内容层,平台桥接与体验仍需适配。例子使用1.5.0时代的JAR和DroidGap,同时混有不同版本JS文件名,实际复现不能混装。本轮不把列出的旧平台支持当成当前清单。

跨平台应用壳保持资源版本一致进一步说明该问题的操作条件与边界。

原书依据 · 1 处

第21章 字符串和国际化

第21章 字符串和国际化

国际化先把文本和文化敏感表现从代码分离,本地化再为目标语言提供资源;数字、日期与图像也可能需要文化适配。只抽出字符串是基础,不等于已经完成翻译和地区体验。

国际化先提供本地化的接缝进一步说明该问题的操作条件与边界。

原书依据 · 1 处

21.2 国际化应用程序文本

布局用资源名、Java用getString引用文本,语言目录只翻译值而保留名称。找不到语言或某个条目时逐项回退默认values,因此默认资源必须完整。地区变体用如values-fr-rCA区分;原文混称ISO语言和国家代码,不能据此把二者当成同一种代码。表格需结合图像继续核读。 图表核读补充:表21-1把繁简中文写成cn-tw、cn-zh,不能照用。依据Android官方资源规则,语言为ISO 639-1代码zh,地区另加r及地区代码,旧式目录可用values-zh-rCN、values-zh-rTW;这是本轮外部纠错,非原书原样结论。Android资源限定符规则。表21-2还展示values、values-es、values-es-rCU、values-es-rCL的默认、通用及地区分层。

翻译资源保留稳定名称进一步说明该问题的操作条件与边界。

默认资源承担逐项回退进一步说明该问题的操作条件与边界。

原书依据 · 2 处

21.3 寻找和翻译字符串

抽取硬编码字符串、建立合法资源标识、翻译与专家确认是不同任务。iOS以原文作键的历史资源不能直接当Android标识,转换时还要维护稳定映射和碰撞。机器翻译可作初稿,不替代目标语言与文化核验;工具和服务名称按原书年代记录,历史轶事不作技术证明。

文本抽取与翻译质量分别验收进一步说明该问题的操作条件与边界。

原书依据 · 1 处

21.4 处理Strings.xml的微妙之处

strings.xml把可见文案集中维护,R.string是生成的资源标识,不应手改。字符串资源既经过XML解析,又受Android资源语法处理:开头的@和?可能表示引用,XML实体处理尖括号与&,引号和反斜杠还控制撇号、前后空格、换行制表及反斜杠本身。局部b/i/u标签与TextView整体样式的作用范围不同。原书转码后的示例有些视觉上相同,应按两层语法解释,不照抄全角标点。 表21-3的五种XML预定义实体为lt、gt、amp、apos、quot;实体解码后仍可能受Android字符串转义处理,因此不能只做XML层验证。

资源文本经历两层语法处理进一步说明该问题的操作条件与边界。

空白与局部样式也是资源语义进一步说明该问题的操作条件与边界。

原书依据 · 2 处

第22章 打包、部署和分发/销售应用程序

第22章 打包、部署和分发/销售应用程序

发布章节从证书和签名开始,再介绍市场提交、广告、混淆与其他应用链接。生成可安装包只是其中一步,分发前仍要检查身份连续性与真实设备上的发布产物。

22.2 创建签名证书

原书用keytool生成私钥、公钥和自签名证书,keystore及别名标识后续签署所需资产。它强调签名身份与包名影响升级和受签名控制的共享,因此不能每次发布随意换证书;密钥库与密钥密码也须分开辨认。成书时证书期限、共享用户ID和更换证书规则是历史环境描述,本轮不推广为现行完整政策;“公钥解密证书”也不能当作签名机制的准确解释。

发布签名维系应用身份连续性进一步说明该问题的操作条件与边界。

原书依据 · 1 处

22.3 签署应用程序

先导出未签名APK,再用持有的keystore签署,或由历史IDE向导合并操作。向导便利不应掩盖密钥库位置;最终发布构建已重新生成,必须对这个确切签名产物重新进行真实设备测试,而不是沿用调试构建结果。jarsigner是当时流程,不能声称签名包能无条件运行于任何设备。

验收真实发布产物而非调试包进一步说明该问题的操作条件与边界。

原书依据 · 1 处

22.4 通过Android Play分发应用程序

发布渠道先要求可用的真实签名产物,再提交包、标题说明、分类、价格与地区信息。原书账号费用、服务条款、审核时效和入口均是成书时情况,不可当成现行承诺;营销文字与技术包身份同样需准确,发布后还包含用户支持。

分发资料与发布产物共同验收进一步说明该问题的操作条件与边界。

原书依据 · 1 处

22.5 将AdMob集成到应用中

广告集成示例依次加入SDK、发布者ID、权限、自定义属性与布局,最后按设备启用测试广告验证。布局与清单承担不同职责,正文把布局属性写成清单位置存在混淆,所示XML还有闭合问题,不能原样执行。定位是可选输入而非展示广告的必然要求;广告展示或点击也不等于确定收益。本轮没有接入商业账户、请求广告或真实点击。

广告集成先用测试请求验证进一步说明该问题的操作条件与边界。

原书依据 · 1 处

22.6 用ProGuard进行代码混淆和优化

ProGuard在Java字节码转换为DEX之前进行优化与混淆,由配置决定输入输出和保留项。被清单、原生绑定、XML构造器、反射、枚举与Parcelable协议访问的入口需要保留;只分析直接调用不能证明它们无用。混淆减少名称信息而非消除所有逆向可能,优化也须验证行为和实际收益。此处构建脚本与规则按旧Ant/Eclipse环境解释。

压缩混淆须保留间接入口进一步说明该问题的操作条件与边界。

混淆与优化具有不同目标进一步说明该问题的操作条件与边界。

原书依据 · 2 处

22.7 提供Google Play市场中发布的其他应用的链接

应用可用ACTION_VIEW打开市场搜索URI或指定包详情,搜索词先编码以保留空格和标点语义。搜索结果与精确包详情不同;原文示例正确使用details?id=,后文又出现details?q=id:,应以上下文一致形式理解。找不到接收活动时需可见反馈,示例Toast遗漏show不能直接照用。最后参阅页也纳入阅读,没有把下册封面当本书内容。

市场搜索与包详情使用不同定位进一步说明该问题的操作条件与边界。

原书依据 · 1 处

跨章综合

组件、线程、数据和设备能力贯穿全书:生命周期决定何时订阅和释放,线程归属决定何处处理耗时工作,持久化决定哪些状态应跨重建保留。一个按钮触发Intent、网络请求或硬件订阅后,启动成功、返回数据、业务完成仍是不同结果。

界面由模型状态驱动,列表、图形、地图与动画都须处理坐标、资源及更新边界;传感器和蓝牙进一步提醒设备差异与流式输入不可忽略。测试章节的方法应覆盖恢复、失败和不同设备,而发布章节把验收对象收束到实际签名与优化后的包。

本书具体工具链和外部服务有明显年代限制。可迁移的是职责、状态、资源和失败边界的分析方法;保留历史操作以解释原例,同时逐处注明未验证的当前适用性。MD5、中文语言代码表及正文与代码矛盾处均有明确纠错归属,不把纠错伪装成作者原话。

发散与实践

筛选已结束,采用两份实现深读计划:消息入队与分发(计划文件:ideas/idea-001-追踪消息入队与分发.md)追踪线程归属及调度,数据库创建与升级(计划文件:ideas/idea-002-追踪数据库创建与升级.md)追踪版本和事务边界。两者均核验AOSP固定提交并形成首轮源码映射;完整深读、模拟器及故障实验尚未执行。

未另立社交服务、广告、短信或市场发布实践:依赖过时端点或真实账户,无法增加本轮机制理解且会引入外部操作。地图和传感器可作为后续输入变化观察,但与已选状态/异步边界重合,本轮不为数量另建重复计划。

生成进度与管理记录

Android应用开发攻略

执行模式:light

建档进度:done

内容形态:问题思考型(沿用历史识别;局部操作用途按操作参考保留)

四象限结论:速查手册(低浓度 + 低稳定性)

判断理由:沿用既有评级。本书以早期Android、Eclipse/ADT、具体控件和平台API的场景方案为主。生命周期、测试与状态边界可迁移;具体步骤仍须按历史版本解释,不因完成全书而改成双高。

历史首次Skill版本未记录,不回填。本轮执行book-workflow v4 / book-notes v24 –mode light;未执行笔记复核、独立审查及审查结果优化。

整书笔记

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
00 前置说明 done 1
01 第1章 入门 done 18
02 第2章 设计成功的应用程序 done 21
03 第3章 测试 done 14
04 第4章 进程间/内通信 done 14
05 第5章 内容提供者 done 4
06 第6章 图形 done 17
07 第7章 GUI done 37
08 第8章 GUI警告:菜单、对话框、Toast和通知 done 14
09 第9章 GUI:ListView done 10
10 第10章 多媒体 done 8
11 第11章 数据持久性 done 18
12 第12章 电话应用程序 done 8
13 第13章 联网应用程序 done 8
14 第14章 游戏与动画 done 5
15 第15章 社交网络 done 2
16 第16章 位置和地图应用程序 done 21
17 第17章 加速计 done 5
18 第18章 蓝牙 done 6
19 第19章 系统与设备控制 done 8
20 第20章 其他编程语言和框架 done 10
21 第21章 字符串和国际化 done 6
22 第22章 打包、部署和分发/销售应用程序 done 7

非正文排除

spine项 类型 排除理由
1704 封面 书封无正文,仅图像
1705 书名版权 用于书目信息核验,不作为技术正文
1706 纯目录 所有链接指向后续原书正文,不能重复算阅读

待关联术语

术语名 出现章节 一句话语境
Openmoko 00 前言仅列举早期开放移动平台
MeeGo 00 前言仅列举移动平台竞争背景
SIP 02 会议应用仅提名可用于受控语音服务
SAX 11 与DOM及拉式XML解析对比,仅提及事件式替代方案
SOAP 13 原书对比Web服务风格,未展开消息协议
WSDL 13 REST对比中仅提名的接口描述机制

引用文献

标题 类型 出现章节 一句话语境
Checking C Programs with Lint 书 00 作者既有著作
Java Cookbook 书 00 作者既有Java工具书
Android-Cookbook-Examples 源码项目 00 书中集中示例仓库
Java in a Nutshell 书 01 面向有编程基础者的Java入门
Head First Java 书 01 Java语言入门推荐
Thinking in Java 书 01 Java学习资源
Learning Java 书 01 Java学习资源
Great Java:Level 1 其他 01 Java入门视频
Java:The Good Parts 书 01 Java学习资源
Android Development Bibliography 书 01 写作时的Android书目汇编
Robolectric 框架 02 原书仅提及模拟Android环境用于测试
Splash Screens Done Right 文章 02 介绍以对话框处理闪屏的历史方案
JUnit 框架 03 单元测试框架提名
TestNG 框架 03 单元测试框架提名
Bitbar TestDroid 框架 03 历史云设备测试供应商
Perfecto Mobile 框架 03 历史云设备测试供应商
Debugging Arts of the Ninja Masters 视频 03 Google I/O 2009调试资料
ACRA 源码项目 03 原书提名类似崩溃数据采集项目
Epoch DHTML/JavaScript Calendar 框架 04 原书以本地日历组件演示桥接;已成卡保留集成用途
Smooth Signatures 文章 06 Square公开手写轨迹与局部绘制方案
Android Patterns 其他 07 原书推荐的Android视觉体验模式网站
The Gui Guide:International Terminology for the Windows Interface 书 07 历史界面术语与国际化资料
Java Look and Feel Design Guidelines 书 07 Java桌面界面指南
Designing Visual Interfaces:Communication-Oriented Techniques 书 07 跨桌面平台视觉设计原则
About Face:The Essentials of Interaction Design 书 07 交互设计延伸阅读
Java I/O 书 07 数字与格式化延伸阅读
The World of ListView(Google I/O 2010) 视频 09 ListView原开发者的概述演讲
JBoss Seam 框架 13 原书服务端采用JAX-RS的背景实现
PageUnit 框架 13 原书作者提及的Web测试框架
Mastering Regular Expressions 书 13 正则表达式延伸阅读
RFC 6151 规范 13 本轮纠错核验,MD5摘要与抗碰撞边界
OpenStreetMap 网站 16 可编辑世界地图,成书时地图数据背景
Nearby Metars 01.01.0.2 开源项目 16 天气地图图层的程序绘制样例
Java Cookbook 书籍 20 原生代码访问Java变量的延伸阅读
Essential JNI 书籍 20 桌面Java JNI进一步说明
Building Android Apps with HTML,CSS,and JavaScript 书籍 20 PhoneGap背景技术延伸阅读
Java Internationalization 书籍 21 Java国际化延伸阅读
The GUI Guide 书籍 21 历史界面术语翻译资料

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 追踪消息入队与分发 实现深读 done 04、14 计划及首轮映射
002 追踪数据库创建与升级 实现深读 done 11 计划及首轮映射

实践候选筛选:done;251组已筛选,相近候选合并;采用2份计划,完整实践未执行。

本轮生成结果

836个保留spine项、251组正文完整读取,299图像实际查看;262张知识卡(原5卡保留身份修订、新增257卡)、2份实践计划。整书笔记含各攻略独立讲解、跨章主线与每卡唯一主要位置及真实原文出处。语言表中文代码错误已按Android官方资源限定符规则纠正;本轮light,无生成后独立审查。

历史类别核对(保留,非本轮验收)

类别清单核对(移动应用开发实战类)

维度 覆盖状态(已覆盖/补充生成/未覆盖) 关联卡片标题或未覆盖理由
应用组件与生命周期 已覆盖 《生命周期意识》覆盖组件状态与资源释放时机。
UI、交互与无障碍 未覆盖 原书 GUI 章节尚未按 v7 问题卡规则补跑。
数据存储与内容共享 已覆盖 《持久化选择》与《内容提供者》覆盖持久化边界和跨应用数据共享。
进程、线程与组件通信 已覆盖 《进程通信边界》覆盖跨进程通信的约束。
设备能力与传感器 已覆盖 《传感器噪声》覆盖传感器读数的不确定性。
网络、后台与系统集成 未覆盖 网络、电话、蓝牙和系统控制章节尚未生成知识卡。
测试、发布与版本兼容 未覆盖 测试、部署和商店分发章节尚未按最新规则补跑。

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

暂无公开主题。