阿里巴巴 Android 开发手册
- 1 -
版本说明
版本号
制定团队
更新日期
备注
1.0.1
淘宝技术团队等
2018.3.5
1) 修正部分示例和说明;2) 补充汇总参考文献
到附录;3) 修正排版问题。
目录
前言 .................................................................................................................................................. 2
一、Java 语言规范 ........................................................................................................................ 3
二、Android 资源文件命名与使用 ........................................................................................... 4
三、Android 基本组件 ................................................................................................................ 7
四、UI 与布局 ............................................................................................................................. 21
五、进程、线程与消息通信 ..................................................................................................... 31
六、文件与数据库 ...................................................................................................................... 35
七、Bitmap、Drawable 与动画 ............................................................................................ 44
八、安全....................................................................................................................................... 54
九、其他....................................................................................................................................... 61
附录 1、认证考试....................................................................................................................... 62
附录 2、版本历史....................................................................................................................... 63
附录 3、参考文献....................................................................................................................... 64
前言
- 2 -
前言
《阿里巴巴 Android 开发手册》是阿里巴巴集团各大 Android 开发团队的集体智慧
结晶和经验总结,将淘宝、天猫、闲鱼、钉钉等 App 长期开发迭代和优化经验系统地整
理成册,以指导 Android 开发者更加高效、高质量地进行 App 开发,呈现给用户体验好、
性能优、稳定性佳、安全性高的产品。
《阿里巴巴 Android 开发手册》作为阿里巴巴开发规约重要的一环,我们的目标是:
防患未然,提升质量意识,降低故障率和维护成本;
标准统一,提升协作效率;
追求卓越的工匠精神,打磨精品代码。
本手册以开发者为中心视角分为Java 语言规范(遵循《阿里巴巴Java 开发手册》),
Android 资源文件命名与使用,Android 基本组件,UI 与布局,进程、线程与消息通信,
文件与数据库,Bitmap、Drawable 与动画,安全,其他等九大部分,根据约束力强弱,
规约依次分为强制、推荐、参考三大类:
【强制】必须遵守,违反本约定或将会引起严重的后果;
【推荐】尽量遵守,长期遵守有助于系统稳定性和合作效率的提升;
【参考】充分理解,技术意识的引导,是个人学习、团队沟通、项目合作的方
向。
对于规约条目的延伸信息中,“说明”对内容做了适当扩展和解释;“正例”提倡
什么样的编码和实现方式;“反例”说明需要提防的雷区,以及错误案例。
另外,「阿里巴巴 Android 开发规范」认证考试同步上线,详情请访问:
https://edu.aliyun.com/certification/cldt04
《阿里巴巴 Android 开发手册》项目组成员,排名不分先后:芸墨(淘宝技术部)、
矢亮(智能场景事业部)、游僧(淘宝技术部)、景宝(淘宝技术部)、邻云(闲鱼技
术部)、尚节(猫客技术部)等,还有很多阿里巴巴移动开发工程师参与,在此一并表
示感谢,感谢阿里巴巴移动基础安全团队和《阿里巴巴 Java 开发手册》相关同学对手
册的指导。
二、Android 资源文件命名与使用
- 4 -
二、Android 资源文件命名与使用
1. 【推荐】资源文件需带模块前缀。
2. 【推荐】layout 文件的命名方式。
Activity
的
layout
以
module_activity
开头
Fragment
的
layout
以
module_fragment
开头
Dialog
的
layout
以
module_dialog
开头
include
的
layout
以
module_include
开头
ListView
的行
layout
以
module_list_item
开头
RecyclerView
的
item layout
以
module_recycle_item
开头
GridView
的
item layout
以
module_grid_item
开头
3. 【推荐】drawable 资源名称以小写单词+下划线的方式命名,根据分辨率不同存放在
不同的 drawable 目录下,如果介意包大小建议只使用一套,系统去进行缩放。采用
规则如下:
模块名
_
业务功能描述
_
控件描述
_
控件状态限定词
如:module_login_btn_pressed,module_tabs_icon_home_normal
4. 【推荐】anim 资源名称以小写单词+下划线的方式命名,采用以下规则:
模块名
_
逻辑名称
_[
方向
|
序号
]
Tween 动画(使用简单图像变换的动画,例如缩放、平移)资源:尽可能以通用的
动画名称命名,如 module_fade_in , module_fade_out , module_push_down_in (动
画+方向)。
Frame 动画(按帧顺序播放图像的动画)资源:尽可能以模块+功能命名+序号。如
module_loading_grey_001。
5. 【推荐】color 资源使用#AARRGGBB 格式,写入 module_colors.xml 文件中,命名
格式采用以下规则:
模块名
_
逻辑名称
_
颜色
评论0
最新资源