Gradle

—— Gradle:全新安卓构建系统

欢马劈雪     最近更新时间:2020-08-04 05:37:59

215

优势

  • 支持多渠道、多APK打包;

Multi-flavor

  • src目录下有main文件夹,这是app的base部分;
  • 支持多种flavor/variant,例如debug,release,paid,free等,分别在src目录下创建相应的文件夹,编写相应的代码;main文件夹下的代码是共用的,而相应文件下下的代码只在相应flavor/variant中使用;
  • 每个文件夹下都可以编写自己的java代码,使用自己的res资源文件等;
  • 在Android studio的build variants面板中可以选择构建的flavor;

文件结构如下图:

Basic Project

  • 工程结构:创建新工程时,自动会生成main和androidTest目录,分别存放工程文件和测试代码;androidTest目录下不需要manifest文件,将自动生成;
  • 可以通过配置,修改/重新指定各种文件的位置:

        android {
            sourceSets {
                main {
                    manifest.srcFile 'AndroidManifest.xml'
                    java.srcDirs = ['src']
                    resources.srcDirs = ['src']
                    aidl.srcDirs = ['src']
                    renderscript.srcDirs = ['src']
                    res.srcDirs = ['res']
                    assets.srcDirs = ['assets']
                }
    
                androidTest.setRoot('tests')
            }
        }
  • tasks:apply plugin时,会自动添加plugin定义的task(java和android包括:assemble,check,build,clean。build包括assemble和check);
  • 和make类似,上次执行之后没有改变的task下次将不会执行;
  • build的配置可以动态化:

      def computeVersionName() {
          ...
      }
    
      android {
          compileSdkVersion 19
          buildToolsVersion "19.0.0"
    
          defaultConfig {
              versionCode 12
              versionName computeVersionName()
              minSdkVersion 16
              targetSdkVersion 16
          }
      }

    注意:方法名不能和默认的getter重名;

  • buildTypes && productFlavors 配置不同的打包类型,两者为组合关系;
    • Build Type + Product Flavor = Build Variant
    • 不同buildTypes的sourceSets可以重新指定;会创建对应的assemble<BuildTypeName> task;
    • main和不同类型的manifest文件将会合并;资源文件也将合并,同名的将以具体build type覆盖main中的资源;

依赖、安卓库、多工程配置

  • 声明依赖

    • 本地jar文件:

      
        dependencies {
            compile files('libs/foo.jar')
        }
    • 远程依赖:

        repositories {
            mavenCentral()
        }
      
        dependencies {
            compile 'com.google.guava:guava:11.0.2'
        }
    • library project依赖:

      
        dependencies {
            compile project(':libraries:lib1')
        }
  • 依赖类型
    • compile:用于主应用程序的依赖编译,所有的内容都会加入到classpath中,并且打包到APK文件中;
    • androidTestCompile:用于集成测试程序(或称InstrumentatinTest);
    • testCompile:用于单元测试;
    • provided:??TODO??
    • debugCompile:debug Build Type;
    • releaseCompile:release Build Type;
    • APK文件总是使用两种依赖类型:compile和<buildtype>Compile;
    • 创建新的build type,就可以使用对应的<buildtype>Compile声明依赖;
  • library project最终将打包为.aar文件,包含编译后的代码、资源文件;library在被其他工程引用时,其依赖只有compile类型的才会被继承;

命令行运行

  • 如果不clean,将采用递增式编译,即之前已编译、且无修改的部分,将不会编译;
  • 第一次运行的时候加上-–daemon选项,将让gradle后台运行,后续编译将节省gradle初始化的时间;

创建自定义task

  • 添加task

    
      task custom(description: 'This is our custom task') << { task ->
          println "Running task ${task.name}"
      }
  • task的执行时机

    • Configuration stage
    • Execution stage
    • 默认task的执行时机均是Configuration stage,即便指定其他task,也会被触发执行
    • 可以通过doLast语句块,来保证只有在明确指定执行task时才会执行,而doLast块外的代码,将在任何任务执行时都会执行
    • <<操作符
        task myTask2 << {
            println "Hello, World!" 
        }

      相当于整个task都在doLast块内

  • 添加task的依赖

    
        assemble.dependsOn 'custom'
    

    assemble将依赖于custom,即custom执行后才能执行assemble;这样是将custom添加到了assemble的最后一个依赖;

  • 使用rule延迟创建task

      assemble.dependsOn(‘customAssemble’)
    
      tasks.addRule(“Pattern: customAssemble“) { taskName ->
        println “Creating task ${taskName}”
        if (taskName.equals(“customAssemble”)) {
          android.applicationVariants.each { variant ->
            println “Adding dependency to assemble${variant.name}”
            def targetTask = project.tasks.findByName(“assemble${variant.name}”)
            if(targetTask != null) {
              targetTask.dependsOn(“customAssemble${variant.name}”)
            }
          }
        }
        task(taskName) << { task ->
          println “Running custom task ${task.name}”
        }
      }
展开阅读全文