apilint 发布流程¶
要发布新版本的 apilint,请执行以下操作
创建一个标题为“Branch X.Y”的提交,并相应地修改文件
apilint/build.gradle
和apilint/Config.java
。例如,请参阅 Branch 0.5。请注意,如果没有任何apidoc
更改,则无需修改apilint/Config.java
。使用分支版本创建 git 标签
$ git tag X.Y
通过运行以下命令在本地运行测试:
$ ./gradlew build
将新版本发布到本地存储库
$ ./gradlew publishToMavenLocal
在本地修改
mozilla-central
以使用新版本测试apilint
,在根build.gradle
中的每个repositories {}
块内添加mavenLocal()
,例如:
diff --git a/build.gradle b/build.gradle
index 813ba09aa3d4b..753fdb8d958a6 100644
--- a/build.gradle
+++ b/build.gradle
@@ -60,6 +60,7 @@ allprojects {
}
repositories {
+ mavenLocal()
gradle.mozconfig.substs.GRADLE_MAVEN_REPOSITORIES.each { repository ->
maven {
url repository
@@ -100,6 +101,7 @@ buildDir "${topobjdir}/gradle/build"
buildscript {
repositories {
+ mavenLocal()
gradle.mozconfig.substs.GRADLE_MAVEN_REPOSITORIES.each { repository ->
maven {
url repository
@@ -113,7 +115,7 @@ buildscript {
ext.kotlin_version = '1.5.31'
dependencies {
- classpath 'org.mozilla.apilint:apilint:0.5.2'
+ classpath 'org.mozilla.apilint:apilint:0.X.Y'
classpath 'com.android.tools.build:gradle:7.0.3'
classpath 'com.getkeepsafe.dexcount:dexcount-gradle-plugin:0.8.2'
classpath 'org.apache.commons:commons-exec:1.3'
测试运行
api-lint
的集成,这应该始终通过,并且不需要修改api.txt
(可能存在例外情况,但应该是故意的)。
$ ./mach lint -l android-api-lint
将标签推送到远程存储库(注意,分支提交不会推送到主分支)。
$ git push -u origin X.Y
等待 Github 自动化成功完成。
(可选,如果存在任何
apidoc
更改) 请 Releng 团队发布新的 apidoc 版本,该包将位于 Github 工件下,例如,请参阅 releases/tag/0.5 中的maven.zip
。另请参阅 Bug 1727585。将
plugins.gradle.org
密钥添加到您的.gradle
文件夹中,请参阅 publishing_gradle_plugins.html。通过运行以下命令发布插件:
$ ./gradlew apilint:publishPlugins
最后,更新
mozilla-central
以使用新版本,例如,请参阅 此补丁。