https://github.com/leifzhang/gradlesample

gradle repo includeBuild
https://github.com/leifzhang/gradlesample

composebuilding gradle includebuilding settings

Last synced: 10 days ago
JSON representation

gradle repo includeBuild

• Host: GitHub
• URL: https://github.com/leifzhang/gradlesample
• Owner: Leifzhang
• License: apache-2.0
• Created: 2020-07-28T07:03:30.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2023-01-04T11:10:02.000Z (almost 2 years ago)
• Last Synced: 2024-10-12T20:10:45.615Z (25 days ago)
• Topics: composebuilding, gradle, includebuilding, settings
• Language: Kotlin
• Homepage:
• Size: 421 KB
• Stars: 142
• Watchers: 3
• Forks: 12
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# GradleTask

![Profile views](https://gpvc.arturio.dev/LeifzhangGradleSample)

 

## 功能介绍

 

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'

~~~

3. 项目根目录下添加repo.xml

~~~

    

~~~

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

4. 或者使用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

~~~

5.  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并不会作用在隔壁工程上