Android工具箱之组织你的代码文件

这是一个系列，咱们将其命名为工具箱，若是你尚未看以前的文章：

Android工具箱之Context解析

Android工具箱之文件目录

Android工具箱之理解app资源文件

Android工具箱之Activity生命周期

Android工具箱之迁移到AppCompat

Android工具箱之Android 6.0权限管理

概览

Android应用须要有良好的包结构定义，这会使得你的代码更易被阅读，一般来讲，恰当的命名规范可以保证你的代码更易被维护和整洁。

命名规范

针对Java代码

下列规则对于Java代码很重要：

• 变量 规范：全部变量都必须为小写字母开始，且驼峰式。例如：incomeTaxRate

• 常量 规范：因此常量都必须为大写字母。例如：DAYS_IN_WEEK

• 方法 规范：全部变量都必须为小写字母开始，且驼峰式。例如：convertToEuroDollars

• 方法参数 规范：全部参数必须小写字母开始，且驼峰式。例如：depositAmount

针对Android类

Android类的命名规则有其本身的一套规范，以使得其类做用更加明显。好比全部的activity都会以activity结尾。

• Activity 规范：CreateTodoItemActivity。继承于：AppCompatActivity，Activity。

• List Adapter 规范：TodoItemsAdapter。继承于：BaseAdapter，ArrayAdapter。

• 数据库帮助类 规范：TodoItemsDbHelper。继承于：SQLiteOpenHelper。

• 网络客户端 规范：TodoItemsClient。

• Fragment 规范：TodoItemDetailFragment。继承于：Fragment。

• Service 规范：FetchTodoItemService。继承于：Service, IntentService。

你在命名Android类以前，最好思考下，目标是任何Android类都须要特殊定义的前缀。

包结构定义

包结构的定义分歧很大，可是基本维持在两种模式：

按照种类分类

其含义为：将app的每一个特性都应该区分开。

• com.example.myapp.activities - 包含全部的activity类

• com.example.myapp.adapters - 包含全部的adapter类

• com.example.myapp.models - 包含全部的数据模型

• com.example.myapp.network - 包含全部的网络代码

• com.example.myapp.fragments - 包含全部的碎片

• com.example.myapp.utils - 包含全部的帮助类

• com.example.myapp.interfaces - 包含全部的接口

按照app应用特性区分

• com.example.myapp.service.* - 包含全部的后台服务类

• com.example.myapp.ui.* - 包含全部的UI相关类

• com.example.myapp.ui.mainscreen - 包含全部的主屏幕相关类

• com.example.myapp.ui.detailsscreen - 包含全部的其余屏幕相关类

这必定义，可让你将DetailsActivity, DetailsFragment, DetailsListAdapter, DetailsItemModel放在一个包中。

DetailsListAdapter和DetailsItemModel类能够将其属性定义为protected，这样其余包中的代码须要经过get/set访问属性。

这使得建立实例更加简单和直观，由于对象在包外是不可改变的。

结论

这两种模式均可以，取决于哪个更加适合你的项目，然而，一般在Java代码中，第二种模式即按照特性划分更加有利和被推荐。

参考

• http://blog.smartlogic.io/2013/07/09/organizing-your-android-development-code-structure

• http://stackoverflow.com/questions/5525872/android-project-package-structure

• http://www.javapractices.com/topic/TopicAction.do?Id=205