阿里巴巴 Android 开发手册
- 1 -
版本说明
版本号
制定团队
更新日期
备注
1.0.0
淘宝技术团队等
2018.2.28
正式版，首次公开
目录
前言 ............................................................................................................................. 2
一、Java 语言规范 ...................................................................................................... 3
二、Android 资源文件命名与使用 .............................................................................. 4
三、Android 基本组件 ................................................................................................ 7
四、UI 与布局 ........................................................................................................... 22
五、进程、线程与消息通信 ....................................................................................... 30
六、文件与数据库 ..................................................................................................... 34
七、Bitmap、Drawable 与动画 ............................................................................... 44
八、安全 .................................................................................................................... 54
九、其他 .................................................................................................................... 65
附录-认证考试 ........................................................................................................... 66
前言
- 2 -
前言
车同轨，书同文，《阿里巴巴
Android
开发手册》既是高效合作的基础，也是深度
创新的开始。
——淘宝技术负责人
庄卓然
《阿里巴巴 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
的行
layout
以
module_grid_item
开头
3. 【推荐】 drawable 资源名称以小写单词+下划线的方式命名，根据分辨率不同存放
在不同的 drawable 目录下，建议只使用一套,例如 drawable-xhdpi。采用规则如下:
模块名
_
业务功能描述
_
控件描述
_
控件状态限定词
如：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 文件中，命
名格式采用以下规则：
模块名
_
逻辑名称
_
颜色
如：
<color name="module_btn_bg_color">#33b5e5e5</color>
