chore: release v0.1.0

Author: Gracker

CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+## 0.1.0 - 2026-02-09
+
+### Features
+- Migrate plugin instrumentation from removed Transform API to AGP official Instrumentation API.
+- Add exception-safe trace pairing by injecting `Trace.endSection()` on exceptional exits.
+- Add 2x2 compatibility demo matrix (AGP 7.4.2 / 8.3.2 x local / remote plugin).
+- Add Gradle compatibility CI matrix to verify compile-time bytecode injection.
+
+### Documentation
+- Rewrite README/README_zh to focus on version selection and usage path.
+- Add maintainer release instructions for Maven Central publishing.
+
+## 0.0.6 - 2021-12-23
+
+### Features
+- Legacy Transform API based instrumentation release.

CHANGELOG.zh.md

@@ -0,0 +1,18 @@
+# 更新日志
+
+## 0.1.0 - 2026-02-09
+
+### 新功能
+- 将插件插桩从已移除的 Transform API 迁移到 AGP 官方 Instrumentation API。
+- 增加异常路径兜底：在方法异常退出时也会注入 `Trace.endSection()`，保证 trace 配对。
+- 新增 2x2 兼容性 Demo 矩阵（AGP 7.4.2 / 8.3.2 x 本地/远程插件）。
+- 新增 Gradle 兼容性 CI 矩阵，自动验证编译期字节码插桩。
+
+### 文档
+- 重写 README/README_zh，突出“如何选版本、怎么接入”。
+- 增加维护者 Maven Central 发版说明。
+
+## 0.0.6 - 2021-12-23
+
+### 新功能
+- 基于旧 Transform API 的插桩版本。

README.md

@@ -20,7 +20,7 @@ TraceFix instruments bytecode at compile time and injects `android.os.Trace.begi
 1. Set plugin version in `gradle.properties`:
 
 ```properties
-TRACEFIX_VERSION=0.0.6
+TRACEFIX_VERSION=0.1.0
 ```
 
 2. Add plugin classpath in module or root `build.gradle`:
@@ -45,6 +45,23 @@ apply plugin: 'auto-add-systrace'
 
 4. Build your app and inspect traces in Perfetto (`https://ui.perfetto.dev/#!/viewer`).
 
+## Publish To Maven Central (Maintainers)
+
+1. Export credentials:
+
+```bash
+export OSSRH_USERNAME=...
+export OSSRH_PASSWORD=...
+export SIGNING_KEY='-----BEGIN PGP PRIVATE KEY BLOCK-----...'
+export SIGNING_PASSWORD=...
+```
+
+2. Publish release artifact:
+
+```bash
+./gradlew :android-systrace-plugin:publishReleaseToSonatype
+```
+
 ## Local Plugin (For Repo Development)
 
 1. Publish plugin to local Maven:

README_zh.md

@@ -20,7 +20,7 @@ TraceFix 是一个编译期字节码插桩插件，会在方法前后自动插
 1. 在 `gradle.properties` 配置版本：
 
 ```properties
-TRACEFIX_VERSION=0.0.6
+TRACEFIX_VERSION=0.1.0
 ```
 
 2. 在 module 或 root 的 `build.gradle` 添加插件 classpath：
@@ -45,6 +45,23 @@ apply plugin: 'auto-add-systrace'
 
 4. 编译后用 Perfetto 查看结果：`https://ui.perfetto.dev/#!/viewer`。
 
+## 发布到 Maven Central（维护者）
+
+1. 配置发布凭据：
+
+```bash
+export OSSRH_USERNAME=...
+export OSSRH_PASSWORD=...
+export SIGNING_KEY='-----BEGIN PGP PRIVATE KEY BLOCK-----...'
+export SIGNING_PASSWORD=...
+```
+
+2. 执行发布：
+
+```bash
+./gradlew :android-systrace-plugin:publishReleaseToSonatype
+```
+
 ## 本地插件用法（仓库开发）
 
 1. 先发布到本地 Maven：

android-systrace-plugin/build.gradle

@@ -36,10 +36,10 @@ repositories {
 
 ext {
     bintrayName = 'TraceFix'                //bintray用户名
-    artifact = bintrayName
-    libraryName = 'TraceFix'
-    libraryDescription = 'Auto add Systrace tag while building apk'
-    libraryVersion = '0.0.6'
+    artifact = bintrayName
+    libraryName = 'TraceFix'
+    libraryDescription = 'Auto add Systrace tag while building apk'
+    libraryVersion = (rootProject.findProperty("TRACEFIX_VERSION") ?: '0.0.6').toString()
 }
 
 

gradle.properties

@@ -20,7 +20,7 @@ android.enableJetifier=true
 # Kotlin code style for this project: "official" or "obsolete":
 kotlin.code.style=official
 # TraceFix plugin version
-TRACEFIX_VERSION=0.0.6
+TRACEFIX_VERSION=0.1.0
 # TraceFix plugin version, For local debug
 TRACEFIX_VERSION_DEBUG=1.0
 publishedGroupId=io.github.gracker
@@ -31,4 +31,4 @@ developerName=Jianwu Gao
 developerEmail=dreamtale.jg@gmail.com
 licenseName=The Apache Software License, Version 2.0
 licenseUrl=http://www.apache.org/licenses/LICENSE-2.0.txt
-allLicenses=["Apache-2.0"]
+allLicenses=["Apache-2.0"]

gradle/java-publish.gradle

@@ -1,4 +1,5 @@
 apply plugin: 'maven-publish'
+apply plugin: 'signing'
 
 tasks.withType(JavaCompile).configureEach {
     options.encoding = "UTF-8"
@@ -18,30 +19,163 @@ tasks.register("javadocJarLocal", Jar) {
     from tasks.named("javadoc")
 }
 
+def releaseVersion = (project.findProperty("TRACEFIX_VERSION")
+        ?: project.findProperty("libraryVersion")
+        ?: "0.0.6").toString()
+def debugVersion = (project.findProperty("TRACEFIX_VERSION_DEBUG")
+        ?: releaseVersion).toString()
+def publishGroupId = (project.findProperty("publishedGroupId") ?: "io.github.gracker").toString()
+def publishArtifactId = (project.findProperty("artifact") ?: project.name).toString()
+
+def ossrhUsername = project.findProperty("ossrhUsername") ?: System.getenv("OSSRH_USERNAME")
+def ossrhPassword = project.findProperty("ossrhPassword") ?: System.getenv("OSSRH_PASSWORD")
+def signingKey = project.findProperty("signingKey") ?: System.getenv("SIGNING_KEY")
+def signingPassword = project.findProperty("signingPassword") ?: System.getenv("SIGNING_PASSWORD")
+def signingKeyId = project.findProperty("signingKeyId") ?: System.getenv("SIGNING_KEY_ID")
+
+def pomLibraryName = (project.findProperty("libraryName") ?: "TraceFix").toString()
+def pomDescription = (project.findProperty("libraryDescription") ?: "Auto add Systrace tag while building apk").toString()
+def pomSiteUrl = (project.findProperty("siteUrl") ?: "https://github.com/Gracker/TraceFix").toString()
+def pomGitUrl = (project.findProperty("gitUrl") ?: "https://github.com/Gracker/TraceFix.git").toString()
+def pomLicenseName = (project.findProperty("licenseName") ?: "The Apache Software License, Version 2.0").toString()
+def pomLicenseUrl = (project.findProperty("licenseUrl") ?: "http://www.apache.org/licenses/LICENSE-2.0.txt").toString()
+def pomDeveloperId = (project.findProperty("developerId") ?: "TraceFix").toString()
+def pomDeveloperName = (project.findProperty("developerName") ?: "TraceFix").toString()
+def pomDeveloperEmail = (project.findProperty("developerEmail") ?: "tracefix@example.com").toString()
+
+def configurePomMetadata = { MavenPublication publication ->
+    publication.pom {
+        name.set(pomLibraryName)
+        description.set(pomDescription)
+        url.set(pomSiteUrl)
+        licenses {
+            license {
+                name.set(pomLicenseName)
+                url.set(pomLicenseUrl)
+            }
+        }
+        developers {
+            developer {
+                id.set(pomDeveloperId)
+                name.set(pomDeveloperName)
+                email.set(pomDeveloperEmail)
+            }
+        }
+        scm {
+            connection.set(pomGitUrl)
+            developerConnection.set(pomGitUrl)
+            url.set(pomSiteUrl)
+        }
+    }
+}
+
 publishing {
     repositories {
         maven {
             name = "tracefixRemote"
             url = rootProject.layout.buildDirectory.dir("tracefix-remote-repo")
         }
+
+        maven {
+            name = "sonatype"
+            def releasesRepoUrl = uri("https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/")
+            def snapshotsRepoUrl = uri("https://s01.oss.sonatype.org/content/repositories/snapshots/")
+            url = releaseVersion.endsWith("SNAPSHOT") ? snapshotsRepoUrl : releasesRepoUrl
+            credentials {
+                username = ossrhUsername
+                password = ossrhPassword
+            }
+        }
     }
 
     publications {
         traceFixLocal(MavenPublication) {
             from components.java
-            groupId = publishedGroupId
-            artifactId = artifact
-            version = TRACEFIX_VERSION_DEBUG
+            groupId = publishGroupId
+            artifactId = publishArtifactId
+            version = debugVersion
             artifact tasks.named("sourcesJarLocal")
             artifact tasks.named("javadocJarLocal")
+            configurePomMetadata(delegate)
+        }
+
+        traceFixRelease(MavenPublication) {
+            from components.java
+            groupId = publishGroupId
+            artifactId = publishArtifactId
+            version = releaseVersion
+            artifact tasks.named("sourcesJarLocal")
+            artifact tasks.named("javadocJarLocal")
+            configurePomMetadata(delegate)
         }
     }
 }
 
+def isSonatypeReleaseTask = {
+    gradle.startParameter.taskNames.any { taskName ->
+        String normalized = taskName.toLowerCase()
+        normalized.contains("sonatype") || normalized.endsWith("publishreleasetosonatype")
+    }
+}
+
+signing {
+    required {
+        isSonatypeReleaseTask()
+    }
+    if (isSonatypeReleaseTask()) {
+        if (signingKey && signingPassword) {
+            if (signingKeyId) {
+                useInMemoryPgpKeys(signingKeyId.toString(), signingKey.toString(), signingPassword.toString())
+            } else {
+                useInMemoryPgpKeys(signingKey.toString(), signingPassword.toString())
+            }
+        } else {
+            logger.lifecycle("SIGNING_KEY/SIGNING_PASSWORD not found. Signing will fail for Sonatype publish.")
+        }
+        sign publishing.publications.traceFixRelease
+    }
+}
+
+tasks.register("verifyReleasePublishConfig") {
+    doLast {
+        List<String> missing = []
+        if (!ossrhUsername) {
+            missing.add("ossrhUsername or OSSRH_USERNAME")
+        }
+        if (!ossrhPassword) {
+            missing.add("ossrhPassword or OSSRH_PASSWORD")
+        }
+        if (!signingKey) {
+            missing.add("signingKey or SIGNING_KEY (ASCII-armored private key)")
+        }
+        if (!signingPassword) {
+            missing.add("signingPassword or SIGNING_PASSWORD")
+        }
+        if (!missing.isEmpty()) {
+            throw new GradleException("Missing release publish config: " + missing.join(", "))
+        }
+    }
+}
+
+tasks.withType(PublishToMavenRepository).configureEach { publishTask ->
+    if (publishTask.name == "publishTraceFixReleasePublicationToSonatypeRepository") {
+        publishTask.dependsOn("verifyReleasePublishConfig")
+    }
+}
+
+tasks.matching { it.name == "signTraceFixReleasePublication" }.configureEach { signTask ->
+    signTask.onlyIf {
+        isSonatypeReleaseTask()
+    }
+    if (isSonatypeReleaseTask()) {
+        signTask.dependsOn("verifyReleasePublishConfig")
+    }
+}
+
 tasks.register("buildAndPublishToLocalMaven") {
-    dependsOn("build", "publishToMavenLocal")
+    dependsOn("build", "publishTraceFixLocalPublicationToMavenLocal")
     doLast {
-        println "* published to maven local: ${publishedGroupId}:${artifact}:${TRACEFIX_VERSION_DEBUG}"
+        println "* published to maven local: ${publishGroupId}:${publishArtifactId}:${debugVersion}"
     }
 }
 
@@ -51,3 +185,10 @@ tasks.register("buildAndPublishToRemoteRepo") {
         println "* published to file repo: ${rootProject.buildDir}/tracefix-remote-repo"
     }
 }
+
+tasks.register("publishReleaseToSonatype") {
+    dependsOn("publishTraceFixReleasePublicationToSonatypeRepository")
+    doLast {
+        println "* published release: ${publishGroupId}:${publishArtifactId}:${releaseVersion}"
+    }
+}