Okbuck的使用和注意事项

作者: 闻风小蛮牛 | 来源:发表于2017-03-22 11:26 被阅读0次

    首先贴上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目录下,如下图所示。

    Paste_Image.png

    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文件的配置。

    相关文章

      网友评论

        本文标题:Okbuck的使用和注意事项

        本文链接:https://www.haomeiwen.com/subject/cbxonttx.html