背景
上一篇文章我們講了如何自定義一個簡單的 lint 檢查規(guī)則泌神,這篇文章我們講講 lint 規(guī)則如何發(fā)布與集成璃搜。
問題
上一篇文章中竹宋,我們編寫的 lint 規(guī)則,通過 implementation project(':wrapper')
在主工程中引入我們的規(guī)則,但是在一般實際生產(chǎn)的場景中心褐,我們很少通過源碼的方式去依賴,而是更偏向于使用 gradle 依賴來實現(xiàn)笼踩,本文就來講講如何將我們的自定義 lint 規(guī)則發(fā)布到 maven逗爹,從而使其他工程可以直接用 gradle 依賴的方式來使用。
解決方法
升級 Gradle 和 lint library
在寫這篇文章的時候嚎于,gradle 和 Android Gradle Plugin 都有了較大的版本升級掘而,這里有一個限制需要注意:自定義 lint 工程的 AGP,必須和使用 lint 規(guī)則的工程(主工程)的 AGP 版本一致于购,否則可能出現(xiàn)無法正常使用的問題袍睡。
由于我的主工程的 AGP 是 7.0.3,因此我們將 Lint 工程的 AGP 也同步升級到 7.0.3.
這邊有一個官方文檔沒有說得很清楚的點肋僧,就是 lint library 的版本斑胜,應(yīng)該和 AGP 的版本是一一對應(yīng)的,具體的對應(yīng)規(guī)則就是:
如果 AGP 版本是 x.y.z嫌吠,那么 lint 的版本應(yīng)該是 (x+23).y.z
所以對應(yīng) AGP 7.0.3 的 lint library 版本就是 30.0.3止潘,我們修改相應(yīng)的依賴如下:
compileOnly "com.android.tools.lint:lint-api:$LINT_VERSION"
compileOnly "com.android.tools.lint:lint-checks:$LINT_VERSION"
其中 LINT_VERSION = 30.0.3
注:AGP7 以上需要 Java 11 的環(huán)境,因此如果升級后無法編譯辫诅,需要安裝 Java 11 且在 AS 里面把 JDK 設(shè)置為 Java 11.
發(fā)布到 Maven
接下來就是發(fā)布到 maven repo 了凭戴,其實就是將 wrapper module 發(fā)布到 maven,如果你已經(jīng)很熟悉 gradle maven 的發(fā)布炕矮,那下面的內(nèi)容就可以不用看了么夫。
要發(fā)布到maven,我們只需要兩個步驟:
1. 配置 maven plugin
由于新版本的 AGP 已經(jīng)集成了 maven plugin吧享,所以我們不需要再使用第三方的插件了魏割,直接在 wrapper module 下新建一個 maven.gradle,內(nèi)容如下:
apply plugin: 'maven-publish'
group = GROUP
version = VERSION
def repositoryUrl = MAVEN_REPOSITORY_URL
afterEvaluate {
publishing {
publications {
// Creates a Maven publication called "release".
release(MavenPublication) {
// Applies the component for the release build variant.
from components.release
// You can then customize attributes of the publication as shown below.
groupId = GROUP
artifactId = ARTIFACT_ID
version = VERSION
}
}
repositories {
maven {
allowInsecureProtocol true
url = repositoryUrl
credentials {
username MAVEN_USER
password MAVEN_PWD
}
}
}
}
publish {
doLast {
println "*********************************************************************************"
println "Lint Checker Uploaded"
println "Group : " + GROUP
println "ArtifactId : " + ARTIFACT_ID
println "Version : " + version
println "Repository : " + repositoryUrl
println "*********************************************************************************"
}
}
}
其中有幾個參數(shù)是定義在項目根目錄下的 gradle.properties 里面的:
- GROUP: maven 組钢颂,例如 xyz.glorin.lint
- ARTIFACT_ID: 產(chǎn)物的ID钞它,例如 customlint
- VERSION: 版本號
- MAVEN_REPOSITORY_URL: Maven 倉庫地址
- MAVEN_USER: Maven 倉庫用戶名(開啟了認證的情況下才需要)
- MAVEN_PWD: Maven 倉庫密碼
最終我們在主工程使用的時候,完整的依賴就是:
$GROUP:$ARTIFACT_ID:$VERSION (xyz.glorin.lint:customlint:1.0.0)
2. 打包發(fā)布
只需要執(zhí)行: ./gradlew :wrapper:publish
即可發(fā)布成功殊鞭。
或者在 AS Gradle 界面執(zhí)行task:
代碼
本文工程代碼: https://github.com/glorinli/CustomLintChecker
順便推薦一個免費的 Maven server: https://repsy.io/