淺談Android開發(fā)中項目的文件結(jié)構(gòu)及規(guī)范化部署建議
一、幾句話
- 使用Gradle及其推薦的項目框架
- 把密碼等敏感數(shù)據(jù)放入gradle.properties
- 不要自己寫Http客戶端,使用Volley或OkHttp庫
- 使用Jackson庫來解析JSON數(shù)據(jù)
- 避免Guava并出于Dalvik 65K methods limit不要使用過多的庫
- 使用Fragment來繪制UI界面
- Activity主要用來管理Fragment
- 布局文件XML也是代碼,好好組織它們
- 在布局文件里,使用styles以避免重復(fù)的屬性
- 使用多個style文件而不是一個巨大的style文件
- 保持你的 color.xml 短小而DRY,定義色盤
- 同樣保持 dimens.xml DRY,定義通用常量
- 不要創(chuàng)建一個太深層次的布局
- 避免WebView的客戶端處理,而且要注意內(nèi)存泄露
- 使用Robolectric來進行單元測試,Robotium來進行連接(UI)測試
- 仿真器用Genymotion
- 一定要用ProGuard 或 DexGuard
二、詳細
Android SDK
把你的Android SDK放置在你的主目錄里或其他與應(yīng)用無關(guān)的地方。一些IDEs在安裝的時候會把SDK關(guān)聯(lián)上,并把SDK放在IDE的同一個目錄下。當你需要升級(重裝)IDE或者更換IDE時你就會發(fā)現(xiàn)糟糕之處啦。另外,如果你的IDE在一個user賬戶下而不是在root下運行的話,就不要把SDK放在系統(tǒng)級目錄下,否則在使用時需要 sudo 權(quán)限,
Build System
默認的選擇是 Gradle。Ant限制比較多而且太大。使用Gradle,你可以很輕易的做到:
-編譯不同的flavours 或應(yīng)用的 variants
-創(chuàng)建簡單的 類-腳本 任務(wù)
-管理和下載依賴
-自定義keystores
-等等
Android的Gradle插件同樣被Google指定為新的標準編譯系統(tǒng),而且Google不斷為其升級。
項目結(jié)構(gòu)
有兩種流行的選擇:舊的Ant & Eclipse ADT項目結(jié)構(gòu);新的Gradle & Android Studio項目結(jié)構(gòu)。你應(yī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)用所引用的庫項目(如: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)建一個不會被添加到版本控制系統(tǒng)里的gradle.properties文件
KEYSTORE_PASSWORD=password123 KEY_PASSWORD=password789
這個文件會被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是一個Java庫,它可以實現(xiàn)對象和JSON數(shù)據(jù)的相互轉(zhuǎn)換。Gson 也是一個類似的不錯選擇。不過我們覺得Jsckson更好因為它支持多種方式來處理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都來源于同一樣公司,所以它們互相補充。OkHttp 能用來與 Volley 相連接。
RxJava是一個響應(yīng)式編程庫,換句話說,處理異步事件。(具體可參考原文檔)
Retrolambda 是一個Java庫,它幫助你的Android或者其他早于JDK8平臺上使用Lambda表達式。(具體可參考原文檔)
最后,記住dex方法限制,不要使用太多庫。(Android應(yīng)用,當被打包成dex文件時,有一個最大限制:65535個引用方法[1][2][3]。如果你超過了限制就會發(fā)生嚴重錯誤。因此,不要使用剛過多庫,使用 dex-method-counts 工具來決定使用哪些類從而保持在限制內(nèi),尤其要避免使用Guava庫,因為它包含超過13k方法)
Activities和Fragments
Fragments應(yīng)該是你在Android部署UI界面的默認選項。Fragments可以在你的應(yīng)用里重用。我們推薦使用Fragements而不是 activities 來繪制界面基于以下幾點:
- 解決是多視圖布局。Fragments被引入進來的主要原因是把手機應(yīng)用程序拓展到平臺電腦上,這樣的話你在平板上可以同時顯示A和B視圖,而在手機上可只顯示A或B。如果你的程序最開始就是使用Fragment來實現(xiàn),那么你的程序可以更容易適用于多種設(shè)備。
- 屏到屏的通信。Android的API并不提供一個合適的方式來實現(xiàn)Activity之間傳遞復(fù)雜數(shù)據(jù)(如Java對象)。但是,使用Fragment,你可以利用Activity來成為其子Fragment之間通信的通道。即使這比Activity-到-Activity通信要好不少,我仍然建議你采取Event Bus架構(gòu),例如使用Otto 或者 greenrobot EventBus來作為一個更簡潔的方案。如果你不想采取附加的庫,那么RxJava也可以被用來實現(xiàn)一個EventBus。
- Fragment不僅僅可以用來布局UI。你可以添加一個 沒有UI界面的Fragment 作為Activity的后臺服務(wù)者。甚至你可以創(chuàng)建一個Fragment來實現(xiàn)Fragment切換邏輯,而不是讓Activity去處理Fragment切換邏輯。
- Fragment里甚至可以管理ActionBar。你可以選擇一個沒有UI界面的Fragment來專門管理ActionBar,或者你可以選擇每個當前可視的Fragment自己來處理父Activity的ActionBar。參考這里。
- 然后,我們也不建議過度使用嵌套Fragments,那可能導(dǎo)致matryoshka 漏洞。
- 從架構(gòu)的角度來考慮,你的應(yīng)用應(yīng)該有一個頂級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實際上都是控制器類。而從另一角度來看,他們又是用戶交互的一部分,也就是說屬于視圖View類。
因此,我們很難嚴格區(qū)分Fragment(或Activity)是控制器還是視圖。所以從Java包角度來看,我們最好把Fragment放在它們自己的fragments包里,然后Activity放在最高級的包里面(遵循上文提出的建議)。當然,如果你想有2個或以上的Activity,那你就創(chuàng)建一個activitys包。
這樣的話,整個結(jié)構(gòu)看起來就是一個典型的MVC結(jié)構(gòu)。一個Models包包含POJOs,用來轉(zhuǎn)化API接口獲取的Json數(shù)據(jù),一個views包包含Views,notifications,action bar views,widgets等。Adapters是一個中間層,位于數(shù)據(jù)和視圖之間。但是,它們通常需要通過getView()來輸出View視圖,所以你可以把adapters放在views包的子包位置。
一些應(yīng)用程序級別、僅屬于Android系統(tǒng)的控制器類,應(yīng)該放在managers包里。各種各樣的數(shù)據(jù)處理類,例如DateUtils可以放在utils包里。與后臺服務(wù)器交互的類應(yīng)該放在network包里。
總之,從與服務(wù)器交互到與用戶交互的整體架構(gòu)可設(shè)計如下:
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ī)范化一個布局XML文件,可參考下面慣例:
- 每行一個屬性,縮進4個空格;
- android:id永遠放在第一個;
- android:layout_** 屬性要放在頂部;
- style屬性放在尾部;
- 結(jié)束標志位 />要獨占一行,有助于對屬性排序或添加;
- 不要寫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>
相關(guān)文章
Jrebel License Server 激活 IDEA-Jrebel-在線-
這篇文章主要介紹了Jrebel License Server 激活 IDEA-Jrebel-在線-離線-均適用,本文給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-12-12Mybatis中mapper.xml實現(xiàn)熱加載介紹
大家好,本篇文章主要講的是Mybatis中mapper.xml實現(xiàn)熱加載介紹,感興趣的同學(xué)趕快來看一看吧,對你有幫助的話記得收藏一下2022-01-01Struts2學(xué)習(xí)筆記(3)-DMI動態(tài)調(diào)用方式
本文主要介紹Struts2的DMI動態(tài)調(diào)用的兩種方式,簡單實用,希望能給大家做一個參考。2016-06-06淺談java中為什么重寫equals后需要重寫hashCode
今天帶各位學(xué)習(xí)一下java中為什么重寫equals后需要重寫hashCode,文中有非常詳細的圖文介紹及代碼示例,對正在學(xué)習(xí)java的小伙伴們有很好的幫助,需要的朋友可以參考下2021-05-05