• Stars
    star
    132
  • Rank 274,205 (Top 6 %)
  • Language
    Kotlin
  • License
    Apache License 2.0
  • Created over 4 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

gradle repo includeBuild

GradleTask

Profile views

功能介绍

repo专门用于多仓库App混合编译使用,通过更改项目内的substitute,把远端的aar替换成本地源代码的形式参与项目编译环节,同时内部使用的是gradle settings includeBuild,所以项目内原先的逻辑不需要变更,可以直接使用。

repo插件同时项目会自动帮各位去同步远端的仓库代码,如果仓库branch没有发生变化则不会同步代码。

dep插件则是负责将项目内的依赖版本更换成远端版本,同时进行version版本号策略清洗。

version 拿来做的是plugin的dep操作,因为考虑到多仓工程全局配置,所以尝试性的做了些黑科技,已经完成将versionCatalog定义在单一gradle文件内,然后完成项目内所有工程的共享能力。

monitor 拿来做gradle 相关日志统计,以及编译数据相关收集,以及获取app相关的依赖。

plugin-r8 apk 方法签名检查工具,基于android r8 重新适配,偷学大佬的代码。

使用规范

demo 因为很多都是settings插件,所以需要clone完工程之后将几个plugin推送到mavenLocal,之后在外层的settings直接引入对应插件。

当前貌似没有找到settings插件的当场调试模式。

全局插件采用了生成initscript,之后用文件的形式添加到startParameter中去,在第一个settings插件之后影响到所有includebuild工程。

使用简介

  1. 打开项目的settings.gradle,记住是settings.gradle不是build.gradle
  2. 添加下面代码
buildscript {
    repositories {
        mavenLocal()
        maven { setUrl("https://maven.aliyun.com/repository/central/") }

    }
    dependencies {
        // 本地先尝试下 maven local 任务之后添加
        //  classpath "com.kronos.plugin:plugin-repo:0.2.0"
        //   classpath "com.kronos.plugin:plugin-version:0.2.0"
    }
}
// 本地先尝试下 maven local 任务之后添加
//apply plugin: "kronos.plugins"
//apply plugin: 'kronos.settings'
  1. 项目根目录下添加repo.xml
    <module name="QrCodeLibrary" branch="master" origin="https://github.com/Leifzhang/QRScaner.git"
        srcBuild="false" substitute="com.github.leifzhang:QrCodeLibrary" />

其中srcBuild =true的情况代表你需要将这个仓库一起编译, name 代表的是你的仓库的modulename,切记,切记。

  1. 或者使用repo.yaml 进行include building
src: false
modules:
  - branch: master
    origin: https://github.com/Leifzhang/QRScaner.git
    srcBuild: true
    name: QRScaner
  - branch: master
    origin: https://github.com/Leifzhang/QRScaner.git
    srcBuild: false
    name: Router
  1. repo-include.yaml 完成include
src: false
projects:
  - branch: master
    origin: https://github.com/Leifzhang/QRScaner.git
    srcBuild: true
    modules:
      - name: QRScaner
      - name: abb

科普

substitute

Gradle依赖替换,在项目开发过程中,不可避免的需要引入一些第三方库,而不同的第三方库之间,可能存在一些依赖关系。例如:你依赖了库A与B,而同时B也依赖于A。这样就可能存在这种情况:你依赖的A的版本与B中依赖的A的版本不同。同时可以把依赖直接变更为project的形式。

科学建议

个人建议每个模块都根据自己的group设置好group,以及模块名,一定要和aar版本一致,这样就可以充分的利用gradle本身的特性,如果当前module存在,就会自动完成aar切换到源码的操作.

然后依赖方式都使用implementation group:module:version 这样就会自动完成源码和aar的切换。

特别是在includeBuilding的情况下,因为是独立工程,所以project的configuration并不会作用在隔壁工程上