Android開發實踐

http://www.jianshu.com/p/1c83b18d10a0

命名規範

樣式命名

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

參考資料:



作者:續寫經典
鏈接:http://www.jianshu.com/p/1c83b18d10a0
來源:簡書
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。

發佈了54 篇原創文章 · 獲贊 118 · 訪問量 131萬+
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章