2022年移动客户端Android开发规范 .pdf

移动客户端开发规范之Android 一、编码规范(1) 常量命名：只能包含字母和 _，字母全部大写，单词之间用_隔开。单词名称要能体现变量的逻辑说明。(2)变量命名：变量类型简称+变量逻辑名称变量类型： String=str ；Integer=int;Boolean=bool;(3)控件命名：控件类型简称+逻辑名称控件类型：LayoutView ：lv RelativeView:rv Button:btn TextView:tv ImageView:iv EditText:et (4)Activity 命名及对应的页面命名Activity 命令：逻辑名称 (首字母大写 )Activity 页面命令：逻辑名称(小写，跟 Activity 的逻辑名称同名，单词间用_分隔 )+.xml (5)Strings.xml 中的 id 命名对于针对特定Actvity 命名： activity 名称_逻辑名称 (小写 ) 其它命名： strings_ 逻辑名称 (小写 ) (6)包的命名规则：com.al.ec+.应用程序名称 . 目录分类（全部小写）名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 1 页，共 6 页 - - - - - - - - - 二、版本控制(1) 采用代码管理工具，进行代码的管理。如：SVN 代码在完成一个大版本的时候，需对此大版本打标签，以方便下次可以快速取出代码。代码提示，需注明开发或修改了什么内容。(2) 程序的文件头注释按以下格式/* * 亚信联创电信 EC产品部 * * author 翁德辉 * date 2012- 04 - 05* Description: 基类，用于集合页面的常用操作 * version V1.0 */如果有修改需在其下面写明修改日期，修改人，修改内容。(3) 函数或过程的注释按以下格式/* 函数或过程说明* * param 参数名：参数说明*/(4) 对于变量需要在变量上面对变量进行注解。/ 弹出选号privateAlertDialogdialogNumber = null;(5) 在 eclipse进行开发当中，可以使用Ctrl+Shit+F对代码按格式排版可以使用 CTRL+SHIFT+O 对不需要的引用类进行去除。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 2 页，共 6 页 - - - - - - - - - 三、目录结构(1) 代码结构com.al.ec+. 应用名称 +.activity:用于放基类 Activity页面com.al.ec+. 应用名称 +.activity+功能分类 : 用于放相应的功能的Activity页面（功能如指：有关于员工的；有关于查询的；有关于管理的）com.al.ec+. 应用名称 +.adapter:用于放相应的适配器信息com.al.ec+. 应用名称 +.control:用于放第三方控件com.al.ec+. 应用名称 +.customview: 用于放自定义页面或控件com.al.ec+. 应用名称 +.model: 用于放自定义的类com.al.ec+. 应用名称 +.model+.interface:用于放接口返回的数据类com.al.ec+. 应用名称 +.utils:用于放常用工具包com.al.ec+. 应用名称 +.utils+.security:用于放常用工具包中的安全处理（加解密等）com.al.ec+. 应用名称 +.utils+.data:用于放对数据的处理类 （如：数据库，轻量存储等）com.al.ec+. 应用名称 +.service:用于放服务com.al.ec+. 应用名称 +.interface:用于放调用接口的类(2) 引用包尽量少用第三方包放在 libs目录放(3) 资源目录名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 3 页，共 6 页 - - - - - - - - - res/anim: 放一些动画效果 ( 可以有目录结构 ) res/drawable:放一些图像的效果xml( 如：按钮的图片和按钮按下去的图片) res/drawable-hdpi:放图像（由于现在主流的分辨率已经高于480800）layout:放页面的布局res/raw: 放一些 SQL语句等res/values:放 colors.xml(自定义颜色 ) 、strings.xml(定义的字符串 ) 、styles.xml(样式)等。res/values/dimens.xml:对于手机需要放这个文件，平板不需要对于平板还需要增加以下二个目录res/values-large:放 dimens.xml( 用于适配 7 尺左右平板 ) res/values-xlarge：放 dimens.xml （用于适配 10 尺左右平板）四、安全性及完整性(1) 数据安全性存储在 SqLite 需对数据进行加密，取出来的时候进行解密。轻量级存储也需要进行加密，取出来的时候进行解密。(2) 数据传输调用安全客户端与门户层之间的调用之间数据传输过程中客户端进行加密，门户进行解密；门户层返回数据过程中对数据进行加密，客户端进行解密。双方需要定义一套加解密算法，需要门户层框架的支持。(3) 混淆编译对发布的，需进行混淆编译。在常用一些第三方包的情况下有可能引成混淆编译安装的失败。(4)APK 权限不需要的 APK权限不引用名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 4 页，共 6 页 - - - - - - - - - (5) 系统异常对于客户端的异常退出，需要调用相应的方法，把日志传输到门户层异常日志表中进行记录，方便改正。(6) 门户层日志门户层需记录每一次的接口调用情况，并进行区别，特别是调用出错或异常的情况。五、平板开发注意事项由于平板尺寸多，分辨率多种，建议只做主流的几种适配。现在主流的为： 10.1 寸 1280800 7 寸 1024600 7 寸 1280800 7寸 19201200 平板开发主要采用： style+dimens(values-large,values-xlarge)相配合，以及线性布局相对布局的方式style:样式；用于各种控件，按钮，列表，输入框，文框的统一样式，样式里对应的宽、高、字体等值采用dimens 设定的值。dimens：用于放定义的值，包括字体，宽，高，边距等。大小单位统一用： dp 字体统一用： sp 线性布局主要采用： layout_weight进行几等分六、开发注意内容(1) 图像图像需要变化的，需做成9.png，以减少图像的存储空间。如：按钮，输名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 5 页，共 6 页 - - - - - - - - - 入框等(2) 统一的单位大小单位统一用： dp 字体大小统一用： sp (3) 打印 Log 调用统一写的 Ulog，调试的时候统一打开打印Log，上线的时候关掉不显示出来。接口用的出入参建议每次都打印，以方便调试使用。(4) 新版本升级每次打开应用的时候比对新版本有新版本需进行强制更新（由于电信行业的特殊性决定）(5) 对于 Activity需创建 BaseActivity基类， 把一些常用的操作放置于此。(6) 常用的复杂控件：创建自定义控件，进行复用。七、调用接口 http 请求比对的各种 http 请求的封装，建议采用江苏项目所运用到的请求封装优点：对接口调用成功或失败已经封装。缺点：一个类只能对应一个接口。注意点：需对接口调用返回的数据建立相应的类进行接收数据。名师资料总结 - - -精品资料欢迎下载 - - - - - - - - - - - - - - - - - - 名师精心整理 - - - - - - - 第 6 页，共 6 页 - - - - - - - - -