命名規范
樣式命名
通用的樣式寫在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開發完成了,想通過鏈接方式發給別人使用測試,下面兩個平臺可以幫到你
參考資料: