Android开发实践

命名规范

样式命名

通用的样式写在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
}

基本框架

AndroidBasicProject

  • BaseActivity
  • BaseFragment
  • Activity栈管理
  • 日志打印
  • 异常信息收集
  • 工具类

功能框架

质量跟踪平台

其它

  • 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开发完成了,想通过链接方式发给别人使用测试,下面两个平台可以帮到你

参考资料:

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,616评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,020评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,078评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,040评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,154评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,265评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,298评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,072评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,491评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,795评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,970评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,654评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,272评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,985评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,815评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,852评论 2 351

推荐阅读更多精彩内容