首先贴上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版本。如下图所示:
Paste_Image.png由于国内网络的问题,在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'
}
}
注意:不要忘记将你的签名文件拷贝到根目录下(当然,你放到其它目录也可以,记得修改配置中的路径就行)
-
错误三
有时我们在编译的过程中,会出现如下的错误
Paste_Image.png我们来看以下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的两次编译,并记录其时间如下。
863EF9B5-99E6-4E6E-81B2-32C7DC24DE76.png通过对比,能明显感觉,okbuck的编译速度要快于gradle,但是目前okbuck貌似对aidl的支持不是特别好,加上对工程的改动也比较大,因此在对项目是否采用okbuck来构建,还需根据实际情况来讨论。
最后附上github的地址,大家主要参考其中gradle文件的配置。
网友评论