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

参考资料:

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Python绿色通道

Python爬虫:把爬取到的数据插入到execl中

前面我们把大量数据已经爬取到了本地,但这些数据如果不存储起来,那么就会变得无效.开始本文之前,请确保已经阅读。

26630
来自专栏工作积累

Android获取QQ和微信的聊天记录,并保存到数据库

(该方法只适用于监控自己拥有的微信或者QQ ,无法监控或者盗取其他人的聊天记录。本文只写了如何获取聊天记录,服务器落地程序并不复杂,不做赘述。写的仓促,有错别字...

5.4K140
来自专栏Java架构师学习

分享我在阿里工作十年接触过Java框架设计模式一、前言二、责任链设计模式(Chain of Responsibility Pattern)三、工厂模式(Factory Pattern)四、单例设计模式

一、前言 说起来设计模式,大家应该都耳熟能详,设计模式代表了软件设计的最佳实践,是经过不断总结提炼出来的代码设计经验的分类总结,这些模式或者可以简化代码,或者可...

87680
来自专栏雨过天晴

原 荐 C# FTP 坑了我两天的一个坑

1.5K70
来自专栏一个番茄说

函数响应式编程框架RxSwift 学习——Observable

最近开始研究RxSwift,网上能查到的资料太有限,边学边记录,有不对的地方欢迎大家指正。

11410
来自专栏liuchengxu

Spark GraphX 对图进行可视化

Spark 和 GraphX 对并不提供对数据可视化的支持, 它们所关注的是数据处理. 但是, 一图胜千言, 尤其是在数据分析时. 接下来, 我们构建一个可视化...

31910
来自专栏芋道源码1024

Dubbo源码解析 —— 服务引用原理

前言 经过上一篇dubbo源码解析-简单原理、与spring融合的铺垫,我们已经能简单的实现了dubbo的服务引用.其实上一篇中的代码,很多都是从dubbo源码...

34380
来自专栏互联网杂技

重新认识javascript的settimeout和异步

今晚看到QLeelulu的一道JavaScript面试题(setTimeout),稍微想了一下,好不容易连猜带蒙,凑巧说对了答案。但是原因到底是什么呢?自己一时...

34690
来自专栏前端开发

so easy 前端实现多语言

36760
来自专栏用户2442861的专栏

Java Web 中使用ffmpeg实现视频转码、视频截图,javaffmpeg

http://www.cnblogs.com/dennisit/archive/2013/02/16/2913287.html#!comments

84510

扫码关注云+社区

领取腾讯云代金券