命名规范
样式命名
通用的样式写在styles.xml
采用大驼峰命名法,所有单词的首字母大写。
<style name="AppTheme.Base" parent="Theme.AppCompat.Light.NoActionBar">
<item name="colorPrimary">@color/colorPrimary</item>
<item name="colorPrimaryDark">@color/colorPrimaryDark</item>
<item name="colorAccent">@color/colorAccent</item>
</style>
<style name="AppTheme" parent="AppTheme.Base"></style>
大项目可按模块或按页面拆分为多个文件:
styles.xml
styles_home.xml
styles_settings.xml
...
字符串命名
<string name="error.message.network">Network error</string>
<string name="error.message.call">Call failed</string>
<string name="error.message.map">Map loading failed</string>
颜色命名
<!-- basic colors -->
<color name="green">#27D34D</color>
<color name="blue">#2A91BD</color>
<color name="orange">#FF9D2F</color>
<color name="red">#FF432F</color>
<!-- grayscale -->
<color name="white" >#FFFFFF</color>
<color name="gray_light">#DBDBDB</color>
<color name="gray" >#939393</color>
<color name="gray_dark" >#5F5F5F</color>
<color name="black" >#323232</color>
尺寸命名
<!-- font sizes -->
<dimen name="font_larger">22sp</dimen>
<dimen name="font_large">18sp</dimen>
<dimen name="font_normal">15sp</dimen>
<dimen name="font_small">12sp</dimen>
包(package)
全部使用小写字母。一级包名常见的有:com/cn/org/net,二级包名以公司或个人来命名,三级包名根据应用进行命名,四级包名为模块名或层级名。
com.classic.stock
com.classic.stock.user
类(class)
采用大驼峰命名法,所有单词的首字母大写。
MainActivity
SettingsActivity
抽象类(abstract class)
抽象类名称以 Abs 开头,采用大驼峰命名法,所有单词的首字母大写。
AbsListView
AbsSeekBar
接口(interface)
接口名称以 I 开头,如果有多个单词,每个单词首字母大写。
IBinder
IStockInfo
事件监听器(event listener)
以On开头,如果有多个单词,每个单词首字母大写。
OnClickListener
OnItemClickListener
方法(method)
小驼峰命名法,除首单词外,其余所有单词的首字母大写。
setContentView
initView
参数(parameter)
小驼峰命名法 ,除首单词外,其余所有单词的首字母大写。
page
pageSize
变量(variable)
小驼峰命名法 ,除首单词外,其余所有单词的首字母大写。
page
pageSize
常量(constants)
全部大写,单词之间用下划线分割。
DB_VERSION
DB_NAME
图片资源文件
建议用模块名称+逻辑名称
book_cover_default.png
book_type_online.png
Layout命名
建议用模块名称+逻辑名称
books_comment.xml
books_comment_item.xml
Layout中的id命名
建议用layout文件名称做前缀+逻辑名称+view缩写
@+id/books_comment_item_bookcover_iv
@+id/books_comment_item_nickname_tv
注释规范
/**
* 项目名称
* 包名
*
* 文件描述:TODO
* 创 建 人:TODO
* 创建时间:2016/3/15 15:40
*/
Gradle依赖规范
项目根目录新建config.gradle文件,配置参考如下:
def supportVersion = "23.3.0"
def rxBindingVersion = "0.4.0"
def greenDAOVersion = "2.2.0"
def retrofitVersion = "2.0.2"
ext {
android = [
compileSdkVersion: 23,
buildToolsVersion: "23.0.3",
applicationId : "com.classic.android",
minSdkVersion : 14,
targetSdkVersion : 23,
versionCode : 1,
versionName : "1.0"
]
//官方库
supportV4 = "com.android.support:support-v4:${supportVersion}"
supportAppcompatV7 = "com.android.support:appcompat-v7:${supportVersion}"
supportDesign = "com.android.support:design:${supportVersion}"
supportCardView = "com.android.support:cardview-v7:${supportVersion}"
supportRecyclerView = "com.android.support:recyclerview-v7:${supportVersion}"
supportGridLayout = "com.android.support:gridlayout-v7:${supportVersion}"
supportAnnotations = "com.android.support:support-annotations:${supportVersion}"
supportMultidex = "com.android.support:multidex:1.0.+"
//基础项目
basicProject = "com.classic.core:classic:2.0"
//动画
nineoldandroids = "com.nineoldandroids:library:2.4.0"
//图片加载
glide = "com.github.bumptech.glide:glide:3.7.0"
fresco = "com.facebook.fresco:fresco:0.10.+"
picasso = "com.squareup.picasso:picasso:2.5.2"
//json解析
fastjson = "com.alibaba:fastjson:1.2.11"
fastjsonAndroid = "com.alibaba:fastjson:1.1.51.android"
//view注入
dagger = "com.squareup.dagger:dagger:1.2.4"
butterknife = "com.jakewharton:butterknife:8.0.1"
// butterknife = "com.jakewharton:butterknife:7.0.1"
//Rx家族,响应式编程
rxJava = "io.reactivex:rxjava:1.1.5"
rxAndroid = "io.reactivex:rxandroid:1.2.0"
rxBinding = "com.jakewharton.rxbinding:rxbinding:${rxBindingVersion}"
rxBindingSupportV4 = "com.jakewharton.rxbinding:rxbinding-support-v4:${rxBindingVersion}"
rxBindingSupportAppcompatV7 = "com.jakewharton.rxbinding:rxbinding-appcompat-v7:${rxBindingVersion}"
rxBindingSupportDesign = "com.jakewharton.rxbinding:rxbinding-design:${rxBindingVersion}"
rxBindingSupportRecyclerView = "com.jakewharton.rxbinding:rxbinding-recyclerview-v7:${rxBindingVersion}"
rxBindingLeanbackV17 = "com.jakewharton.rxbinding:rxbinding-leanback-v17:${rxBindingVersion}"
//网络请求
retrofit = "com.squareup.retrofit2:retrofit:${retrofitVersion}"
gsonForRetrofit = "com.squareup.retrofit2:converter-gson:${retrofitVersion}"
rxJavaForRetrofit = "com.squareup.retrofit2:adapter-rxjava:${retrofitVersion}"
okhttp = "com.squareup.okhttp3:okhttp:3.2.0"
volley = "com.mcxiaoke.volley:library:1.0.19"
//数据库
sqlbrite = "com.squareup.sqlbrite:sqlbrite:0.6.3"
greenDAO = "de.greenrobot:greendao:${greenDAOVersion}"
greenDAOGenerator = "de.greenrobot:greendao-generator:${greenDAOVersion}"
//事件总线
eventBus = "org.greenrobot:eventbus:3.0.0"
androidEventBus = "org.simple:androideventbus:latest"
//二维码扫描
zxing = "com.google.zxing:core:3.2.1"
//圆形ImageView
circleImageView = "de.hdodenhof:circleimageview:2.0.0"
//通用适配器
commonAdapter = "com.classic.adapter:commonadapter:1.1"
//方便的切换到:加载中视图、错误视图、空数据视图、网络异常视图、内容视图。
mutipleStatusView = "com.classic.common:multiple-status-view:1.2"
//google开源的一款新布局,综合了LinearLayout 和 RelativeLayout特性,及功能扩展
flexboxLayout = "com.google.android:flexbox:0.1.1"
}
然后在项目根目录的build.gradle文件中添加配置文件的引用
//应用配置文件
apply from: "config.gradle"
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.5.0'
}
}
allprojects {
repositories {
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
开始使用,在module的build.gradle文件中直接引用
apply plugin: 'com.android.application'
android {
compileSdkVersion rootProject.ext.android.compileSdkVersion
buildToolsVersion rootProject.ext.android.buildToolsVersion
defaultConfig {
applicationId rootProject.ext.android.applicationId
minSdkVersion rootProject.ext.android.minSdkVersion
targetSdkVersion rootProject.ext.android.targetSdkVersion
versionCode rootProject.ext.android.versionCode
versionName rootProject.ext.android.versionName
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile rootProject.ext.supportV4
compile rootProject.ext.supportAppcompatV7
compile rootProject.ext.glide
compile rootProject.ext.okhttp
}
基本框架
- BaseActivity
- BaseFragment
- Activity栈管理
- 日志打印
- 异常信息收集
- 工具类
功能框架
- 图片加载 glide、fresco、picasso
- json数据解析 fastjson
- View注入 Dagger、butterknife
- Material Design向下兼容库 carbon
- Rx系列 RxJava、RxAndroid、RxBinding
- 网络请求 retrofit + okhttp + RxJava
- 数据库 sqlbrite、Realm、greenDAO
质量跟踪平台
其它
- leakcanary检查内存泄露,square出名,必属精品
- blockcanary检测UI卡顿, 阿里工程师出品
- DebugDrawer帮你快速的在debug版本分析,诊断问题
- ANR-WatchDog检查ANR问题的利器
- ViewServer当你用真机调试连不上Hierarchy Viewer,它可以帮助你完美解决问题
- androidtool-mac可在mac上对Android手机和智能手表进行一键截屏、录制视频和安装APK等操作
测试
- testerhome支付宝Monkey老师推荐的测试社区,里面有很多干货
- bugtags新一代的、专为移动测试而生的缺陷发现及管理工具
- testin免费移动App真机云测试平台
- Emmagee网易出品的,是监控指定被测应用在使用过程中占用机器的CPU、内存、流量资源的性能测试小工具。
- GT腾讯出品的,对APP进行快速的性能测试(CPU、内存、流量、电量、帧率/流畅度等等)、开发日志的查看、Crash日志查看、 网络数据包的抓取、APP内部参数的调试、真机代码耗时统计等
- awesome-android-testing收集了不少测试用到的library.
APP内测,分发
APP开发完成了,想通过链接方式发给别人使用测试,下面两个平台可以帮到你
参考资料: