淺談Android開發(fā)中項(xiàng)目的文件結(jié)構(gòu)及規(guī)范化部署建議
一、幾句話
- 使用Gradle及其推薦的項(xiàng)目框架
- 把密碼等敏感數(shù)據(jù)放入gradle.properties
- 不要自己寫Http客戶端,使用Volley或OkHttp庫
- 使用Jackson庫來解析JSON數(shù)據(jù)
- 避免Guava并出于Dalvik 65K methods limit不要使用過多的庫
- 使用Fragment來繪制UI界面
- Activity主要用來管理Fragment
- 布局文件XML也是代碼,好好組織它們
- 在布局文件里,使用styles以避免重復(fù)的屬性
- 使用多個(gè)style文件而不是一個(gè)巨大的style文件
- 保持你的 color.xml 短小而DRY,定義色盤
- 同樣保持 dimens.xml DRY,定義通用常量
- 不要?jiǎng)?chuàng)建一個(gè)太深層次的布局
- 避免WebView的客戶端處理,而且要注意內(nèi)存泄露
- 使用Robolectric來進(jìn)行單元測試,Robotium來進(jìn)行連接(UI)測試
- 仿真器用Genymotion
- 一定要用ProGuard 或 DexGuard
二、詳細(xì)
Android SDK
把你的Android SDK放置在你的主目錄里或其他與應(yīng)用無關(guān)的地方。一些IDEs在安裝的時(shí)候會把SDK關(guān)聯(lián)上,并把SDK放在IDE的同一個(gè)目錄下。當(dāng)你需要升級(重裝)IDE或者更換IDE時(shí)你就會發(fā)現(xiàn)糟糕之處啦。另外,如果你的IDE在一個(gè)user賬戶下而不是在root下運(yùn)行的話,就不要把SDK放在系統(tǒng)級目錄下,否則在使用時(shí)需要 sudo 權(quán)限,
Build System
默認(rèn)的選擇是 Gradle。Ant限制比較多而且太大。使用Gradle,你可以很輕易的做到:
-編譯不同的flavours 或應(yīng)用的 variants
-創(chuàng)建簡單的 類-腳本 任務(wù)
-管理和下載依賴
-自定義keystores
-等等
Android的Gradle插件同樣被Google指定為新的標(biāo)準(zhǔn)編譯系統(tǒng),而且Google不斷為其升級。
項(xiàng)目結(jié)構(gòu)
有兩種流行的選擇:舊的Ant & Eclipse ADT項(xiàng)目結(jié)構(gòu);新的Gradle & Android Studio項(xiàng)目結(jié)構(gòu)。你應(yīng)該選擇后者。如果你的項(xiàng)目使用舊的結(jié)構(gòu),那么換掉吧。
舊結(jié)構(gòu)
old-structure ├─ assets ├─ libs ├─ res ├─ src │ └─ com/futurice/project ├─ AndroidManifest.xml ├─ build.gradle ├─ project.properties └─ proguard-rules.pro
新結(jié)構(gòu)
new-structure ├─ library-foobar ├─ app │ ├─ libs │ ├─ src │ │ ├─ androidTest │ │ │ └─ java │ │ │ └─ com/futurice/project │ │ └─ main │ │ ├─ java │ │ │ └─ com/futurice/project │ │ ├─ res │ │ └─ AndroidManifest.xml │ ├─ build.gradle │ └─ proguard-rules.pro ├─ build.gradle └─ settings.gradle
新結(jié)構(gòu)主要的不同在于拆分了'源代碼集' (main,androidTest),這是來自Gradle的理念。
使用最高級別"app"有利于將你的app和其他你的應(yīng)用所引用的庫項(xiàng)目(如:library-foobar)做區(qū)分。然后settings.gradle保持應(yīng)用對這些庫的索引,而app/build.gradle可以指向這些庫。
Gradle配置
通用架構(gòu)請遵循;
小任務(wù)(腳本),你可以使用Gradle來制作小任務(wù)而不是Shell、Python或Perl等,具體參考;
密碼。在你應(yīng)用的build.gradle中你需要為發(fā)布編譯定義 signingConfigs。具體如下:
不要像下面這樣寫,這樣會出現(xiàn)在你的版本控制系統(tǒng)里:
signingConfigs {
release {
storeFile file("myapp.keystore")
storePassword"password123"
keyAlias"thekey"
keyPassword"password789"
}
}
相反,你應(yīng)該創(chuàng)建一個(gè)不會被添加到版本控制系統(tǒng)里的gradle.properties文件
KEYSTORE_PASSWORD=password123 KEY_PASSWORD=password789
這個(gè)文件會被gradle自動導(dǎo)入,所以你可以在build.gradle這樣使用:
signingConfigs {
release {
try{
storeFile file("myapp.keystore")
storePasswordKEYSTORE_PASSWORD
keyAlias"thekey"
keyPasswordKEY_PASSWORD
} catch(ex) {
thrownewInvalidUserDataException("You should define KEYSTORE_PASSWORD and KEY_PASSWORD in gradle.properties.")
}
}}
(如果使用Maven可參考原文檔)
庫
Jackson是一個(gè)Java庫,它可以實(shí)現(xiàn)對象和JSON數(shù)據(jù)的相互轉(zhuǎn)換。Gson 也是一個(gè)類似的不錯(cuò)選擇。不過我們覺得Jsckson更好因?yàn)樗С侄喾N方式來處理JSON:流式,內(nèi)存樹模型和傳動的JSON-POJO數(shù)據(jù)綁定。但是,記住,Jackson比GSON更加龐大,所以你要酌情考慮,如果你想避免 65k methods limit那最好用GSON。其他選擇:Json-smart 和 Boon JSON
網(wǎng)絡(luò)、緩存和圖片。使用Volley 或者Retrofit。Volley也可以用來加載和緩存圖片。如果你選擇Retrofit,你可以用Picasso 來加載和緩存圖片。然后使用 OkHttp 來執(zhí)行有效的HTTP請求。這三種:Retrofit、Picasso和OkHttp都來源于同一樣公司,所以它們互相補(bǔ)充。OkHttp 能用來與 Volley 相連接。
RxJava是一個(gè)響應(yīng)式編程庫,換句話說,處理異步事件。(具體可參考原文檔)
Retrolambda 是一個(gè)Java庫,它幫助你的Android或者其他早于JDK8平臺上使用Lambda表達(dá)式。(具體可參考原文檔)
最后,記住dex方法限制,不要使用太多庫。(Android應(yīng)用,當(dāng)被打包成dex文件時(shí),有一個(gè)最大限制:65535個(gè)引用方法[1][2][3]。如果你超過了限制就會發(fā)生嚴(yán)重錯(cuò)誤。因此,不要使用剛過多庫,使用 dex-method-counts 工具來決定使用哪些類從而保持在限制內(nèi),尤其要避免使用Guava庫,因?yàn)樗^13k方法)
Activities和Fragments
Fragments應(yīng)該是你在Android部署UI界面的默認(rèn)選項(xiàng)。Fragments可以在你的應(yīng)用里重用。我們推薦使用Fragements而不是 activities 來繪制界面基于以下幾點(diǎn):
- 解決是多視圖布局。Fragments被引入進(jìn)來的主要原因是把手機(jī)應(yīng)用程序拓展到平臺電腦上,這樣的話你在平板上可以同時(shí)顯示A和B視圖,而在手機(jī)上可只顯示A或B。如果你的程序最開始就是使用Fragment來實(shí)現(xiàn),那么你的程序可以更容易適用于多種設(shè)備。
- 屏到屏的通信。Android的API并不提供一個(gè)合適的方式來實(shí)現(xiàn)Activity之間傳遞復(fù)雜數(shù)據(jù)(如Java對象)。但是,使用Fragment,你可以利用Activity來成為其子Fragment之間通信的通道。即使這比Activity-到-Activity通信要好不少,我仍然建議你采取Event Bus架構(gòu),例如使用Otto 或者 greenrobot EventBus來作為一個(gè)更簡潔的方案。如果你不想采取附加的庫,那么RxJava也可以被用來實(shí)現(xiàn)一個(gè)EventBus。
- Fragment不僅僅可以用來布局UI。你可以添加一個(gè) 沒有UI界面的Fragment 作為Activity的后臺服務(wù)者。甚至你可以創(chuàng)建一個(gè)Fragment來實(shí)現(xiàn)Fragment切換邏輯,而不是讓Activity去處理Fragment切換邏輯。
- Fragment里甚至可以管理ActionBar。你可以選擇一個(gè)沒有UI界面的Fragment來專門管理ActionBar,或者你可以選擇每個(gè)當(dāng)前可視的Fragment自己來處理父Activity的ActionBar。參考這里。
- 然后,我們也不建議過度使用嵌套Fragments,那可能導(dǎo)致matryoshka 漏洞。
- 從架構(gòu)的角度來考慮,你的應(yīng)用應(yīng)該有一個(gè)頂級Activity,它會包含大部分業(yè)務(wù)相關(guān)的fragments。你也可以創(chuàng)建一些其他的支持性Activities,只要它們與主Activity的通信保持簡單--形似與 Intent.setData()或Intent.setAction()。
Java包結(jié)構(gòu)
在Android應(yīng)用程序里的Java結(jié)構(gòu)接近MVC結(jié)構(gòu)(Model-View-Controller)。在Android里,F(xiàn)ragment和Activity實(shí)際上都是控制器類。而從另一角度來看,他們又是用戶交互的一部分,也就是說屬于視圖View類。
因此,我們很難嚴(yán)格區(qū)分Fragment(或Activity)是控制器還是視圖。所以從Java包角度來看,我們最好把Fragment放在它們自己的fragments包里,然后Activity放在最高級的包里面(遵循上文提出的建議)。當(dāng)然,如果你想有2個(gè)或以上的Activity,那你就創(chuàng)建一個(gè)activitys包。
這樣的話,整個(gè)結(jié)構(gòu)看起來就是一個(gè)典型的MVC結(jié)構(gòu)。一個(gè)Models包包含POJOs,用來轉(zhuǎn)化API接口獲取的Json數(shù)據(jù),一個(gè)views包包含Views,notifications,action bar views,widgets等。Adapters是一個(gè)中間層,位于數(shù)據(jù)和視圖之間。但是,它們通常需要通過getView()來輸出View視圖,所以你可以把a(bǔ)dapters放在views包的子包位置。
一些應(yīng)用程序級別、僅屬于Android系統(tǒng)的控制器類,應(yīng)該放在managers包里。各種各樣的數(shù)據(jù)處理類,例如DateUtils可以放在utils包里。與后臺服務(wù)器交互的類應(yīng)該放在network包里。
總之,從與服務(wù)器交互到與用戶交互的整體架構(gòu)可設(shè)計(jì)如下:
com.futurice.project ├─ network ├─ models ├─ managers ├─ utils ├─ fragments ├─ views ├─ adapters ├─ actionbar ├─ widgets ├─ notifications
資源文件
命名
遵循加前綴的慣例,類似type_foo_bar.xml,如:fragment_contact_details.xml,view_primary_button.xml,activity_main.xml。
組織布局文件
如果你不知道如何規(guī)范化一個(gè)布局XML文件,可參考下面慣例:
- 每行一個(gè)屬性,縮進(jìn)4個(gè)空格;
- android:id永遠(yuǎn)放在第一個(gè);
- android:layout_** 屬性要放在頂部;
- style屬性放在尾部;
- 結(jié)束標(biāo)志位 />要獨(dú)占一行,有助于對屬性排序或添加;
- 不要寫hard code,如 android:text,對于Android Studio來說可考慮使用Designtime attributes方法。
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" > <TextView android:id="@+id/name" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_alignParentRight="true" android:text="@string/name" style="@style/FancyText" /> <include layout="@layout/reusable_part" /> </LinearLayout>
- Android項(xiàng)目基本結(jié)構(gòu)詳解
- 深入解讀Android的Volley庫的功能結(jié)構(gòu)
- 淺析Android系統(tǒng)的架構(gòu)以及程序項(xiàng)目的目錄結(jié)構(gòu)
- 淺談Android系統(tǒng)的基本體系結(jié)構(gòu)與內(nèi)存管理優(yōu)化
- Android編程入門之HelloWorld項(xiàng)目目錄結(jié)構(gòu)分析
- Android應(yīng)用開發(fā)的一般文件組織結(jié)構(gòu)講解
- Android源碼中的目錄結(jié)構(gòu)詳解
- Android程序結(jié)構(gòu)簡單講解
相關(guān)文章
Java中批處理框架spring batch詳細(xì)介紹
這篇文章主要介紹了Java中批處理框架spring batch詳細(xì)介紹,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-07-07
Java實(shí)現(xiàn)正則匹配 “1234567” 這個(gè)字符串出現(xiàn)四次或四次以上
文章介紹了如何在Java中使用正則表達(dá)式匹配一個(gè)字符串四次或四次以上的出現(xiàn),首先創(chuàng)建正則表達(dá)式,然后使用Pattern和Matcher類進(jìn)行匹配和計(jì)數(shù),通過示例代碼展示了如何實(shí)現(xiàn)這一功能,并解釋了匹配的整體次數(shù)和精確出現(xiàn)次數(shù)的邏輯,感興趣的朋友一起看看吧2025-02-02
java swing實(shí)現(xiàn)簡單計(jì)算器界面
這篇文章主要為大家詳細(xì)介紹了java swing實(shí)現(xiàn)簡單計(jì)算器界面,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-04-04
IDEA運(yùn)行spring項(xiàng)目時(shí),控制臺未出現(xiàn)的解決方案
文章總結(jié)了在使用IDEA運(yùn)行代碼時(shí),控制臺未出現(xiàn)的問題和解決方案,問題可能是由于點(diǎn)擊圖標(biāo)或重啟IDEA后控制臺仍未顯示,解決方案提供了解決方法,包括通過右三角Run運(yùn)行(快捷鍵:Alt+42)或以Debug運(yùn)行(快捷鍵:Alt+5)來解決2025-01-01

