Skip to content

Latest commit

 

History

History
140 lines (99 loc) · 5.56 KB

README.md

File metadata and controls

140 lines (99 loc) · 5.56 KB

RocketX

本插件自动识别未改动 module 并在编译流程中替换为 aar ,做到只编译当前改动的 module,加速 Android apk 的编译速度。让你体验到所有模块都是 aar 的速度,又能保留所有的 module 便于修改,完美!(开源不易,希望朋友小手一抖,右上角来个star,感谢🙏)

编译速度对比

2788235-0f027965fefc94f7

AGP 版本兼容

Plugin version Gradle version
4.0.0+ 6.1.1+
4.1.0+ 6.5+
4.2.0+ 6.7.1+
7.0 7.0+

如何使用

  • 依赖 gradle 插件
// app module 的 build.gradle 加入
apply plugin: 'com.rocketx'

// 在根目录的 build.gradle 加入
buildscript {
    dependencies {
        classpath 'io.github.trycatchx:rocketx:1.1.1'
    }
}
  • 依赖 AS 插件 android studio setting->plugins-> marketplace 搜索 RocketX 安装

image

  • 使用点击小火箭至喷火icon (开启 状态),点击编译器 run 按钮 :

image

如果你有多个 app module 也可选择 Assemble${flavor}${buildType} task 进行 run

配置(可选)

  • openLog :打开 log
  • excludeModule :哪一些模块不需要打成 aar(譬如有些模块使用了 tool:replace="XX" ,打成 aar 后属性会消失,当然也可以移动到 app module 的 AndroidMenifest.xml)
  //app moodule下 配置插件编译项
  android {
  //..
    RocketX {
        openLog = true
        //指定哪些模块不打成 aar ,字符串为 module.path,以下 moduleB 不是一级目录,需要带上父文件夹
        excludeModule = [":moduleA",":module_common:moduleB"]
        //默认为true,表示走增量编译,由于有过多的 tranform 使用不当情况,可使用 false 使其编译通过(编译速度会变慢)
        dexMergeIncremental = true 
    }
   //..
   }
  • excludeTransForms: 编译阶段可以禁用的 transform ,编译速度更快(可通过build 的 log 搜索关键字 transFormList 查看自己项目引用了哪些 transform,并手动配置在 gradle.properties 文件下)
# 使用空格间隔开
excludeTransForms = com.alibaba.arouter AAA bbb

问题

  • 对于 gradle.properties 中的配置:如果使用 org.gradle.configureondemand = true ,请删除或者设置为 false,目前在 window 的 as 上会出现问题,已纳入下期需求
  • 第一次的加速,是最慢的因为需要全量编译后,打出 aar 上传到 LocalMaven
  • 目前如果编译出错,请重新再 run 一次,出现的问题 欢迎提 issue

开发维护者


trycatchx
(日落西来,月向东)

JustAClamber
(知者不惑)

louis
(louis-lzt)

FamilyCYZ
(什么都没有留下)

quan229870530
(什么都没有留下)

为爱发电(贡献者)

账号 留言
XZQ XZQ

为爱发电文档

交流群

先加微信(备注 RocketX)再拉进群

image

License

Copyright (C) 2022 [email protected]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.