Skip to content

Latest commit

 

History

History
105 lines (93 loc) · 4.28 KB

README-zh.md

File metadata and controls

105 lines (93 loc) · 4.28 KB

OkBuck

基本配置

工程根目录的build.gradle文件中加入配置:

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.uber:okbuck:0.54.3'
    }
}

apply plugin: 'com.uber.okbuck'

大部分情况下, 上述配置就完成了。OkBuck托管在jcenter,所以 jcenter() 必须加入到 buildscriptallprojectsrepositories 列表中, 而且必须在 apply plugin 部分之前。

应用 OkBuck 插件之后,工程内将会产生两个 gradle task,okbuckbuckWrapper

  • okbuck 将会生成 BUCK 配置文件
  • buckWrapper buck wrapper 类似于 gradle wrapper, 利用它 OkBuck 可以进行更聪明地为我们服务

我们非常建议大家使用 buckWrapper,即执行:./gradlew buckWrapper

可以执行 ./buckw targets 命令查看所有可以 build 的目标, 而生成的 .buckconfig.local 文件中会指定多个 alias, 例如 appDevDebugappProdReleaseanother-appDebug 等,根据它们可以确定 BUCK build 的命令,例如 ./buckw build appDevDebug 等。

自定义配置

okbuck {
    buildToolVersion = "24.0.2"
    target = "android-24"
    linearAllocHardLimit = [
            app: 16 * 1024 * 1024
    ]
    primaryDexPatterns = [
            app: [
                    '^com/uber/okbuck/example/AppShell^',
                    '^com/uber/okbuck/example/BuildConfig^',
                    '^android/support/multidex/',
                    '^com/facebook/buck/android/support/exopackage/',
                    '^com/github/promeg/xlog_android/lib/XLogConfig^',
                    '^com/squareup/leakcanary/LeakCanary^',
            ]
    ]
    exopackage = [
            appDebug: true
    ]
    appLibDependencies = [
            'appProd': [
                    'buck-android-support',
                    'com.android.support:multidex',
                    'libraries/javalibrary:main',
                    'libraries/common:paidRelease',
            ],
            'appDev': [
                    'buck-android-support',
                    'com.android.support:multidex',
                    'libraries/javalibrary:main',
                    'libraries/common:freeDebug',
            ]
    ]
    annotationProcessors = [
            "local-apt-dependency": ['com.okbuck.apt.ExampleProcessor']
    ]
    buckProjects = project.subprojects
    extraBuckOpts = [
        'appDebug', [
            "binary": ["trim_resource_ids = True"]
        ]
    ]

    wrapper {
        repo = 'https://github.com/facebook/buck.git'
    }
}

详细解释

  • buildToolVersion指定Android SDK Build-tools版本,默认为24.0.2
  • target指定Android target sdk版本,可以运行<sdk home>/tools/android list targets --compact 获得,默认为android-24
  • linearAllocHardLimitprimaryDexPatterns都是map,用来配置BUCK multidex的 linearAllocHardLimit和primaryDexPatterns部分,更多详细关于multidex配置的说明,请参阅 multidex wiki, 如果未使用multidex(未在build.gradle文件中开启),可以忽略这两个参数
  • exopackageappLibDependencies都是map,用来配置BUCK exopackage, 更多详细关于exopackage配置的说明,请参阅exopackage wiki, 如果未使用exopackage,可以忽略这三个参数
  • annotationProcessors 用来声明项目中的注解处理器, key 为 module 路径, value 为注解处理器类的全名。
  • buckProjects 用于控制哪些 module 将使用 BUCK 进行构建, 默认是项目中的所有 module
  • 上述配置 map 的 key, 可以按照以下规则设置:
  • 指定 module 名字, 就能为所有的 flavor 以及 build type 设置, 例如: app
  • 指定 module 名字以及 flavor 名字, 就能为指定 flavor 的所有 build type 设置, 例如: 'appDemo'
  • 指定 module 名字以及 build type 的名字, 就能为指定 build type 的所有 flavor 设置, 例如: 'appDebug'
  • 指定 module 名字, flavor 名字以及 build type 的名字, 例如: 'appDemoRelease'

Troubleshooting

如果遇到任何问题,请提一个issue,如果能提供错误日志,就是极好的了。