首先贴上OkBuck在官方github上地址：https://github.com/uber/okbuck。 大家有什么问题可以先上去看看。目前网上大部分关于OkBuck的文章都是0.4版本的，和目前0.19版本还是有差距的，大家在使用的时候需要注意。
1、环境准备
目前okbuck的使用不支持windows系统，只能在mac os X和Linux下操作。
在mac os x中，我们需要预先安装好homebrew，ant，watchman，anroid-ndk(官方说明需要安装ndk，但是实际测试的过程中发现，没有ndk，也是可以正常运行的。)。
其中homebrew主要是用来安装其它组件，watchman用来监测文件并纪录文件改动情况，为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文件中添加以下内容
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'
大部分情况下，上述配置添加后，配置就完成了。因为okBuc托管在jcenter()，所以buildscript和allprojects的repositories中都必须要添加jcenter()，而且是在apply plugin 部分之前。
gradle同步之后，将会生成两个gradle task，okBuck和buckWrapper。其中okBuck主要是用于生成各种Buck文件。而buckWrapper文件类似于gradle Wrapper，会为我们提供好okbuck相关的指令。
上述过程，第一次配置可能需要花费较长时间，因为gradle将会下载okbuck相关的组件，将近400M，建议配置好代理去下载，否则速度会非常慢。下载好的组件位于gradle目录下，如下图所示。
3、使用OkBuck进行编译和安装
完成上述配置之后，我们可以通过以下指令来完成buckWrapper的激活，项目的编译和安装。
- ./gradlew :buckWrapper
该指令用于激活buckWrapper，这样我们可以更好的利用okBuck的相关指令来进行编译和安装 - ./buckw build <target>
如./buckw build appRelease，针对app的Release版本的编译。 - ./buckw install –run <target>
如./buckw install –run appRelease，安装app的Release版本。
4、常见的一些错误和注意事项
-
错误一
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
出现上述问题，是因为你当前的gradle版本过低，需要升级到3.3版本。如下图所示：
由于国内网络的问题，在gradle升级过程中速度会很慢，建议在官网直接下载安装包，然后导入进去。Gradle的升级过程可以参考此帖http://www.jianshu.com/p/00beddbe3dbc
同理，当你的gradle版本升到3.3之后，android 的buildToolVersion同样也要升级，建议升到最新版本，我目前使用的是25.0.2版本。
compileSdkVersion 25
buildToolsVersion "25.0.2"
-
错误二
在执行./buckw build appRelease时出现如下错误
What went wrong:
Execution failed for task ':app:okbuck'
release for app has no signing config set!
这是因为在配置gradle时，还需要配备signing相关的配置。具体配置如下所示。
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'
}
}
注意：不要忘记将你的签名文件拷贝到根目录下(当然，你放到其它目录也可以，记得修改配置中的路径就行)
-
错误三
有时我们在编译的过程中，会出现如下的错误
我们来看以下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相关的协议，对于代码中使用到switch case的语句，我们需要手动将其改为if else，只有这样才能编译通过。
5、和gradle的编译时间对比
针对okbuck，我们对同一工程进行gradle和okbuck的两次编译，并记录其时间如下。
通过对比，能明显感觉，okbuck的编译速度要快于gradle，但是目前okbuck貌似对aidl的支持不是特别好，加上对工程的改动也比较大，因此在对项目是否采用okbuck来构建，还需根据实际情况来讨论。
最后附上github的地址，大家主要参考其中gradle文件的配置。
