《阿里巴巴Android开发手册(规约)》背后的故事

本文内容来自InfoQ的公众号分享。

1、前言   

阿里继去年推出 Java 开发手册之后（参见《阿里技术结晶：《阿里巴巴Java开发手册(规约)-终极版》[附件下载]》、《
作者谈《阿里巴巴Java开发手册(规约)》背后的故事》），在春节期间推出的《阿里巴巴 Android 开发手册(规约)》的目的是什么呢？为此，InfoQ 第一时间采访了阿里巴巴高级无线开发工程师、手册的主要作者之一芸墨，为大家揭开其背后创作故事，并在此与大家分享采访结果。

2、相关下载

《重磅发布：《阿里巴巴Android开发手册(规约)》[附件下载]》
《阿里技术结晶：《阿里巴巴Java开发手册(规约)-终极版》[附件下载]》

3、Android 手册(规约)有哪些内容？

《阿里巴巴 Android 开发手册(规约)》全篇分为 9 个章节，分别是 Java 语言规范，Android 资源文件命名与使用，Android 基本组件，UI 与布局，进程、线程与消息通信，文件与数据库，Bitmap、Drawable 与动画，安全及其他内容，即主要涵盖了 Android 开发的性能、安全性和稳定性问题。作者认为这些章节不分主次，都是开发者在进行业务开发时容易忽视的问题，大家可根据实际情况参考。

4、Android 手册(规约)是怎样诞生的？

阿里做这件事的初衷源于双十一，由于每年在双十一准备期间都要成立专家组去集中扫荡线上 crash，把 crash 率降到 0.1% 以下，修复 bug 以后，可能在不久的将来又会重现，那如何把专家的经验沉淀下来得以复用呢？

在这些过程中，他们把一些常见 crash 的分析沉淀了下来，把一些结合 codestyle 写到了阿里 Android 开发手册里，还有一些写成了自定义规则放到了持续集成平台和 IDEA 插件里，比如常见的 CursorWindowAllocationException、SuperNotCalledException 和 ConcurrentModificationException 这一类的问题。后来他们想把这些好的经验开放出来跟大家一起分享，所以《阿里巴巴 Android 开发手册(规约)》就面世了。

然而手册发布之后，在引起高关注度的同时，也引发了不少读者的质疑，很多人认为阿里在技术分享上动作频频，连发两个手册，是否是内部 KPI 推动的结果。对此，芸墨表示这并不是 KPI 任务，各研发团队的主管并没有给大家硬性指标，手册的编者都是集团各大 APP 的一线业务开发者，来自淘宝、天猫、闲鱼和支付宝等团队，他们都是自发地组成一个虚拟项目组，本着前人栽树后人乘凉，前人踩坑后人平路的心态，总结日常中解决的诸如性能、稳定性、安全、UI 适配等问题的经验，并在日常的业务工作之余完成了手册的内容。

5、三个等级划分的标准是什么？

不管是之前 Java 手册还是现在的 Android 手册，阿里都按照约束力强弱将规则划分了强制、推荐、参考三个等级。

对于这几个等级的制定，芸墨是这么解释的：

• 1）把会造成线上稳定性问题、严重的性能问题和展示问题，常见的安全问题的写法定义为【强制】级别的；
• 2）把一些阿里的最佳实践和一些经验沉淀定义为【推荐】级别的，比如很多开发者最近都在问的“文本大小使用单位 dp 这一条是不是有问题，难道不是应该用 sp 吗？”；
• 3）把一些阿里内部各个团队自己的约定定义为【参考】，即大家可以自行决定是否使用。
  

实际上，在 App 在开发时，视觉都是设计好了整体 UI 布局和控件的尺寸、位置，根据操作系统字体大小设置动态调整 app 字体会造成开发成本高到不可承受。在 Android 上，很多 App 对文本采用了 sp 作为单位，事实上就造成了它们的 UI 在字体大小变化的情况下完全无力适配，内容显示异常。所以，约定的时候就考虑到了现实情况。如果一个产品在设计的时候就已经考虑到对字体设置的需求，那是可以无视这一条；只是大部分的 app 在设计的时候视觉交互其实只有一套，对他们来说的话如果忽略了这个问题用 sp 就会造成 UI 显示的缺陷。

6、若规范与需求发生冲突，如何应对？

一般说来，产品经理需要保证自己需求的还原性和整体体验，开发者也希望自己写出的代码美观整洁 bug 少，大家都是同一战线的伙伴，但是手册中明令禁止的行为可能会对产品的可用性造成很严重的影响，会影响产品的线上使用，所以芸墨并不赞成开发者违背规范中强制的内容，而对于推荐和参考的内容，只要不影响产品的用户体验，开发者择优选择即可。

7、Android 手册面向哪些开发者？

虽然手册面向的主要是 Android 开发者，非 Native 的开发者如果指纯 H5 的开发者那可能跟规约并没有直接联系，如果指的是 RN 这种新兴的动态化框架的话，那么规约在性能优化、安全等方面依旧是可以为他们提供开发上的参考。

再者，芸墨认为，无论是 H5、RN、微信小程序的开发，还是 IOS/Android 原生开发，在 UI framework 这个层面原理是相通的，并不是新技术新框架出现了，已有的框架就被完全推倒重来。其次，RN、微信小程序越来越受关注是因为他们体现出来的组件化、动态化、快速部署的能力对原生开发者产生了巨大的吸引力，但是在这个过程中，JavaScript 扮演的更多的是一种 DSL（domain specific language）的角色，而不是说一看到 JavaScript 就等同于前端开发，他们本质上还是运行在原生操作系统上的，所以 Android 手册里的内容对那些学习新框架的 Android 原生开发者仍是不可或缺的基础。

8、关于未来

对于 Android 手册，阿里会时刻关注和及时回复线上的用户反馈，前期保持一个月一版本的迭代速度，中后期会根据 Android 的系统更新情况半年一次迭代，并表示 iOS 开发手册内部版本正在筹划对外开放中，敬请期待~

Android 手册的内容都是阿里集团业务开发者的经验总结，也结合了 Google 和业界的一些最佳实践，去年已经在集团内部公示过很久，也得到了广泛的认可。一个行业标准手册出之不易，阿里表示他们会秉持着开放的态度，欢迎业内同行一起参与意见反馈和完善工作，这是他们愿意见到的行业幸事。

附录：全站精品资源下载

[1] 精品源码下载：
《Java NIO基础视频教程、MINA视频教程、Netty快速入门视频 [有源码]》
《轻量级即时通讯框架MobileIMSDK的iOS源码（开源版）[附件下载]》
《开源IM工程“蘑菇街TeamTalk”2015年5月前未删减版完整代码 [附件下载]》
《微信本地数据库破解版(含iOS、Android)，仅供学习研究 [附件下载]》
《NIO框架入门(四)：Android与MINA2、Netty4的跨平台UDP双向通信实战 [附件下载]》
《NIO框架入门(三)：iOS与MINA2、Netty4的跨平台UDP双向通信实战 [附件下载]》
《NIO框架入门(二)：服务端基于MINA2的UDP双向通信Demo演示 [附件下载]》
《NIO框架入门(一)：服务端基于Netty4的UDP双向通信Demo演示 [附件下载]》
《用于IM中图片压缩的Android工具类源码，效果可媲美微信 [附件下载]》
《高仿Android版手机QQ可拖拽未读数小气泡源码 [附件下载]》
《一个WebSocket实时聊天室Demo：基于node.js+socket.io [附件下载]》
《Android聊天界面源码：实现了聊天气泡、表情图标(可翻页) [附件下载]》
《高仿Android版手机QQ首页侧滑菜单源码 [附件下载]》
《开源libco库：单机千万连接、支撑微信8亿用户的后台框架基石 [源码下载]》
《分享java AMR音频文件合并源码，全网最全》
《微信团队原创Android资源混淆工具：AndResGuard [有源码]》
《一个基于MQTT通信协议的完整Android推送Demo [附件下载]》
《Android版高仿微信聊天界面源码 [附件下载]》
《高仿手机QQ的Android版锁屏聊天消息提醒功能 [附件下载]》
《高仿iOS版手机QQ录音及振幅动画完整实现 [源码下载]》

[2] 精品文档和工具下载：
《计算机网络通讯协议关系图（中文珍藏版）[附件下载]》
《史上最全即时通讯软件简史（精编大图版）[附件下载]》
《重磅发布：《阿里巴巴Android开发手册(规约)》[附件下载]》
《阿里技术结晶：《阿里巴巴Java开发手册(规约)-终极版》[附件下载]》
《基于RTMP协议的流媒体技术的原理与应用（技术论文）[附件下载]》
《独家发布《TCP/IP详解 卷1：协议》CHM版 [附件下载]》
《良心分享：WebRTC 零基础开发者教程（中文）[附件下载]》
《MQTT协议手册（中文翻译版）[附件下载]》
《经典书籍《UNIX网络编程》最全下载(卷1+卷2、中文版+英文版)[附件下载]》
《音视频开发理论入门书籍之《视频技术手册(第5版)》[附件下载]》
《国际电联H.264视频编码标准官方技术手册（中文版）[附件下载]》
《Apache MINA2.0 开发指南（中文版）[附件下载]》
《网络通讯数据抓包和分析工具 Wireshark 使用教程(中文) [附件下载]》
《最新收集NAT穿越(p2p打洞)免费STUN服务器列表 [附件下载]》
《高性能网络编程经典：《The C10K problem(英文)》[附件下载]》
《即时通讯系统的原理、技术和应用（技术论文）[附件下载]》
《技术论文：微信对网络影响的技术试验及分析[附件下载]》
《华为内部3G网络资料： WCDMA系统原理培训手册[附件下载]》
《网络测试：Android版多路ping命令工具EnterprisePing[附件下载]》
《Android反编译利器APKDB：没有美工的日子里继续坚强的撸》
《一款用于P2P开发的NAT类型检测工具 [附件下载]》
《两款增强型Ping工具：持续统计、图形化展式网络状况 [附件下载]》

[3] 精选视频、演讲PPT下载：
《YY直播在移动弱网环境下的深度优化实践分享(视频+PPT)[附件下载]》
《QQ空间移动端10亿级视频播放技术优化揭秘(视频+PPT)[附件下载]》
《RTC实时互联网2017年度大会精选演讲PPT [附件下载]》
《微信分享开源IM网络层组件库Mars的技术实现(视频+PPT)[附件下载]》
《微服务理念在微信海量用户后台架构中的实践(视频+PPT)[附件下载]》
《移动端IM开发和构建中的技术难点实践分享(视频+PPT)[附件下载]》
《网易云信的高品质即时通讯技术实践之路(视频+PPT)[附件下载]》
《腾讯音视频实验室：直面音视频质量评估之痛(视频+PPT)[附件下载]》
《腾讯QQ1.4亿在线用户的技术挑战和架构演进之路PPT[附件下载]》
《微信朋友圈海量技术之道PPT[附件下载]》
《手机淘宝消息推送系统的架构与实践(音频+PPT)[附件下载]》
《如何进行实时音视频的质量评估与监控(视频+PPT)[附件下载]》
《Go语言构建高并发消息推送系统实践PPT(来自360公司)[附件下载]》
《网易IM云千万级并发消息处理能力的架构设计与实践PPT [附件下载]》
《手机QQ的海量用户移动化实践分享(视频+PPT)[附件下载]》
《钉钉——基于IM技术的新一代企业OA平台的技术挑战(视频+PPT)[附件下载]》
《微信技术总监谈架构：微信之道——大道至简(PPT讲稿)[附件下载]》
《Netty的架构剖析及应用案例介绍(视频+PPT)[附件下载]》
《声网架构师谈实时音视频云的实现难点(视频采访)》
《滴滴打车架构演变及应用实践(PPT讲稿)[附件下载]》
《微信海量用户背后的后台系统存储架构(视频+PPT)[附件下载]》
《在线音视频直播室服务端架构最佳实践(视频+PPT)[附件下载]》
《从0到1：万人在线的实时音视频直播技术实践分享(视频+PPT)[附件下载]》
《微信移动端应对弱网络情况的探索和实践PPT[附件下载]》
《Android版微信从300KB到30MB的技术演进(PPT讲稿)[附件下载]》

阿里巴巴的iOS版开发手册出来，第一时间收藏，赞

iOS版本还没出来 -=  =