首先貼上OkBuck在官方github上地址：https://github.com/uber/okbuck。 大家有什么問題可以先上去看看。目前網(wǎng)上大部分關(guān)于OkBuck的文章都是0.4版本的役听，和目前0.19版本還是有差距的草丧，大家在使用的時候需要注意涩澡。
1智蝠、環(huán)境準(zhǔn)備
目前okbuck的使用不支持windows系統(tǒng)，只能在mac os X和Linux下操作亥揖。
在mac os x中珊擂，我們需要預(yù)先安裝好homebrew，ant费变，watchman摧扇，anroid-ndk(官方說明需要安裝ndk，但是實(shí)際測試的過程中發(fā)現(xiàn)挚歧，沒有ndk扛稽，也是可以正常運(yùn)行的。)滑负。
其中homebrew主要是用來安裝其它組件在张，watchman用來監(jiān)測文件并紀(jì)錄文件改動情況用含，為okbuck使用。
brew update
# Required to build and use buck
brew install android-ndk ant
# Optional, but recommended for faster development
brew install watchman
2帮匾、工程的配置
首先在工程的build.gradle文件中添加以下內(nèi)容
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.1.0'
classpath 'com.uber:okbuck:0.19.0'
}
}
allprojects {
repositories {
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
apply plugin: 'com.uber.okbuck'
大部分情況下，上述配置添加后瘟斜，配置就完成了。因?yàn)閛kBuc托管在jcenter()螺句，所以buildscript和allprojects的repositories中都必須要添加jcenter()，而且是在apply plugin 部分之前壹蔓。
gradle同步之后，將會生成兩個gradle task佣蓉，okBuck和buckWrapper。其中okBuck主要是用于生成各種Buck文件勇凭。而buckWrapper文件類似于gradle Wrapper，會為我們提供好okbuck相關(guān)的指令虾标。
上述過程，第一次配置可能需要花費(fèi)較長時間灌砖，因?yàn)間radle將會下載okbuck相關(guān)的組件璧函，將近400M，建議配置好代理去下載基显，否則速度會非常慢蘸吓。下載好的組件位于gradle目錄下，如下圖所示撩幽。
3库继、使用OkBuck進(jìn)行編譯和安裝
完成上述配置之后，我們可以通過以下指令來完成buckWrapper的激活窜醉，項(xiàng)目的編譯和安裝宪萄。
- ./gradlew :buckWrapper
該指令用于激活buckWrapper，這樣我們可以更好的利用okBuck的相關(guān)指令來進(jìn)行編譯和安裝 - ./buckw build <target>
如./buckw build appRelease榨惰，針對app的Release版本的編譯拜英。 - ./buckw install –run <target>
如./buckw install –run appRelease，安裝app的Release版本读串。
4聊记、常見的一些錯誤和注意事項(xiàng)
-
錯誤一
A problem occurred evaluating project ':app'.
> Failed to apply plugin [id 'com.android.application']
> Minimum supported Gradle version is 3.3. Current version is 2.10. If using the gradle wrapper, try editing the distributionUrl in /Users/jinchao/Documents/workspace_studio/testappnew/gradle/wrapper/gradle-wrapper.properties to gradle-3.3-all.zip
出現(xiàn)上述問題撒妈，是因?yàn)槟惝?dāng)前的gradle版本過低，需要升級到3.3版本排监。如下圖所示：
由于國內(nèi)網(wǎng)絡(luò)的問題狰右，在gradle升級過程中速度會很慢，建議在官網(wǎng)直接下載安裝包舆床，然后導(dǎo)入進(jìn)去棋蚌。Gradle的升級過程可以參考此帖http://www.reibang.com/p/00beddbe3dbc
同理，當(dāng)你的gradle版本升到3.3之后挨队，android 的buildToolVersion同樣也要升級谷暮，建議升到最新版本，我目前使用的是25.0.2版本盛垦。
compileSdkVersion 25
buildToolsVersion "25.0.2"
-
錯誤二
在執(zhí)行./buckw build appRelease時出現(xiàn)如下錯誤
What went wrong:
Execution failed for task ':app:okbuck'
release for app has no signing config set!
這是因?yàn)樵谂渲胓radle時湿弦，還需要配備signing相關(guān)的配置。具體配置如下所示腾夯。
signingConfigs{
debug{
storeFile file('../NX_Weixin')
storePassword '123456'
keyAlias 'weixin'
keyPassword '123456'
}
release {
storeFile file('../NX_Weixin')
storePassword '123456'
keyAlias 'weixin'
keyPassword '123456'
}
}
buildTypes {
debug {
signingConfig signingConfigs.debug
}
release {
signingConfig signingConfigs.release
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
注意：不要忘記將你的簽名文件拷貝到根目錄下(當(dāng)然颊埃，你放到其它目錄也可以，記得修改配置中的路徑就行)
-
錯誤三
有時我們在編譯的過程中蝶俱，會出現(xiàn)如下的錯誤
我們來看以下MainPresenterImpl中的具體代碼
public class MainPresenterImpl implements MainPresenter {
private MainView mMainView;
public MainPresenterImpl(MainView mainView) {
this.mMainView = mainView;
}
@Override
public void switchNavigation(int id) {
switch (id) {
case R.id.navigation_item_news:
mMainView.switch2News();
break;
case R.id.navigation_item_images:
mMainView.switch2Images();
break;
case R.id.navigation_item_weather:
mMainView.switch2Weather();
break;
case R.id.navigation_item_about:
mMainView.switch2About();
break;
default:
mMainView.switch2News();
break;
}
}
}
通過查看buck相關(guān)的協(xié)議班利，對于代碼中使用到switch case的語句，我們需要手動將其改為if else榨呆，只有這樣才能編譯通過罗标。
5、和gradle的編譯時間對比
針對okbuck积蜻，我們對同一工程進(jìn)行g(shù)radle和okbuck的兩次編譯闯割，并記錄其時間如下。
通過對比纽谒，能明顯感覺，okbuck的編譯速度要快于gradle鼓黔，但是目前okbuck貌似對aidl的支持不是特別好不见，加上對工程的改動也比較大，因此在對項(xiàng)目是否采用okbuck來構(gòu)建缎谷，還需根據(jù)實(shí)際情況來討論灶似。
最后附上github的地址，大家主要參考其中g(shù)radle文件的配置希痴。
