旗鱼移动Android开发规范

Posted SpringL

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了旗鱼移动Android开发规范相关的知识,希望对你有一定的参考价值。

 

旗鱼移动android开发规范

 

 

 

 

 

 

 

撰写:     旗鱼移动Android开发组     

 

 

 

 

 

 

 

 

 

 

 

 

旗鱼移动科技有限公司所属,未经允许不得私自传播

 

 

 

 

                                                      第1版

2016年 5 月 3 日

 

 


 

 

 

 

目录

 

一、Android开发框架

二、命名规范

  2.1 包(packages)命名规范

  2.2 类(classes)命名规范

  2.3 方法methods)

  2.4 变量(variables)

  2.5 常量(Constants)

  2.6 资源文件(图片drawable文件夹下)

  2.7 资源布局文件(XML文件(layout布局文件))

  2.8 资源布局文件layout中的id命名

三、代码规范

  3.1 排版

  3.2 注释

四、XML规范

 

 

 

 

 

 


 


 

 

 

一、Android开发框架

  旗鱼移动Android开发项目统一采用公司Android开发框架。

二、命名规范

2.1 包(packages)命名规范

  采用反域名命名规则,全部使用小写字母。一级包名为com,二级包名为qiyu,三级包名根据应用进行命名,四级包名为模块名或层级名等。

 

包名

此包中包含

com.qiyu.应用名称缩写.ui.activity

页面用到的Activity类 (activities层级名用户界面层)

com.qiyu.应用名称缩写.ui.fragment

页面用到的Fragment

com.qiyu.应用名称缩写.adapter

页面用到的Adapter类 (适配器的类)

com.qiyu.应用名称缩写.utils/tools

此包中包含:公共工具方法类(utils/tools模块名)

com.qiyu.应用名称缩写.response.data

网络请求返回response层级1

com.qiyu.应用名称缩写.response.bean

网络请求返回response层级2

com.qiyu.应用名称缩写.response.entity

网络请求返回response层级3

com.qiyu.应用名称缩写.bean/entity

此包中包含:元素类

com.qiyu.应用名称缩写.db

数据库操作类

com.qiyu.应用名称缩写.view

自定义的View类等

com.qiyu.应用名称缩写.XXXX

其他定义的包名

 

 

2.2 类(classes命名规范

  采用大驼峰命名法,尽量避免缩写,除非该缩写是众所周知的,  比如html,URL,如果类名称中包含单词缩写,则单词缩写的每个字母均应大写。

 

描述

Activity 类

Activity为后缀标识

欢迎页面类WelcomeActivity

Adapter类

Adapte 为后缀标识

新闻详情适配器NewDetailAdapter

解析类

Data整体后缀标识二层析类Bean为后缀标识,三层为Entity。

首页解析类HomePosterData

公共方法类

Utils、Tools或Manager为后缀标识灵活运用

线程池管理类:ThreadPoolManager 

日志工具类:旗鱼点餐中为L

Service类

以Service为后缀标识

时间服务TimeService

BroadcastReceive类

以Receiver为后缀标识

时间通知TimeReceiver

ContentProvider

以Provider为后缀标识

时间共享TimeProvider

直接写的共享基础类

以Base开头

BaseActivity,BaseFragment

............

............

.............

 

 

 

 

 

2.3 方法methods)

  动词或动名词,采用小驼峰命名法例如:onCreate(),run()自定义方法定义为private ,特别需要例外。

 

方法

说明

initXX()

初始化相关方法,使用init为前缀标识,如初始化布局initView()

isXX()

checkXX()方法返回值为boolean型的请使用is或check为前缀标识有时必须以get开头,如数据库类里。

getXX()

返回某个值的方法,使用get为前缀标识

processXX()

对数据进行处理的方法,尽量使用process为前缀标识

displayXX()

弹出提示框和提示信息,使用display为前缀标识

saveXX()

与保存数据相关的,使用save前缀标识

resetXX()

对数据重组的,使用reset前缀标识

clearXX()

清除数据相关的

removeXXX()

清除数据相关的

drawXXX()

绘制数据或效果相关的,使用draw前缀标识

initXX()

初始化相关方法,使用init为前缀标识,如初始化布局initView()

..........

.....................

 

 

 

2.4 变量(variables)

移动Android开发-规范文档

为旗鱼 (AOSP) 问题构建 android CopperheadOS

一个规范的自定义View——Android开发艺术探索笔记

移动应用界面设计的尺寸设置及规范

Android开发代码规范

Android技术积累:开发规范