@cloudcare/hvigor-ohos-plugin 0.1.0-alpha.1 → 0.1.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.1.0-alpha.3] - 2026-09-11
+
+- Added build-time registration of the installed plugin version in SDK `sdk_pkg_info.track`.
+
+## [0.1.0-alpha.2] - 2026-09-11
+
+- Added GitHub Actions trusted npm publishing triggered by plugin version tags.
+- Added the plugin version badge to the package documentation.
+
 ## [0.1.0-alpha.1] - 2026-09-11
 
 - Prepared the initial npm prerelease of the console/HiLog and cold-launch instrumentation plugin.

package/README.md

@@ -1,5 +1,7 @@
 # Guance HarmonyOS Hvigor Plugin
 
+[![Hvigor plugin version](https://img.shields.io/badge/dynamic/json?label=plugin&color=orange&query=$.version&uri=https://static.guance.com/ft-sdk-package/badge/harmonyos/plugin/version.json)](https://www.npmjs.com/package/@cloudcare/hvigor-ohos-plugin)
+
 `@cloudcare/hvigor-ohos-plugin` is the build-time companion for `@guancecloud/ft_sdk`. It instruments direct `console.*` and `hilog.*` calls and injects cold-launch lifecycle tracking into a HAP module's `src/main/ets` sources. Runtime log collection remains controlled by `FTLoggerConfig.setEnableConsoleLog(true)` in `@guancecloud/ft_sdk`.
 
 ## Install
@@ -9,7 +11,7 @@ This is a Hvigor tool package, so declare it in the project-level `hvigor/hvigor
 ```json5
 {
   "dependencies": {
-    "@cloudcare/hvigor-ohos-plugin": "0.1.0-alpha.1"
+    "@cloudcare/hvigor-ohos-plugin": "0.1.0-alpha.3"
   }
 }
 ```
@@ -36,10 +38,10 @@ export default {
 }
 ```
 
-The plugin preserves the original console/HiLog output and does not modify application files on disk. It injects cold-launch application initialization into Ability `onCreate()` methods, first-UIAbility creation into `UIAbility.onCreate()`, and first-frame observation into `UIAbility.onWindowStageCreate()`. Do not add manual cold-launch timing calls to application code.
+The plugin preserves the original console/HiLog output and does not modify application files on disk. It injects its installed package version into the SDK's `sdk_pkg_info.track` tag at build time, so rebuilding after a plugin upgrade reports the matching version. It injects cold-launch application initialization into Ability `onCreate()` methods, first-UIAbility creation into `UIAbility.onCreate()`, and first-frame observation into `UIAbility.onWindowStageCreate()`. Do not add manual cold-launch timing calls to application code.
 
 ## Compatibility
 
-The `0.1.0-alpha.1` prerelease is verified with Node.js 18 or newer, Hvigor and `@ohos/hvigor-ohos-plugin` 6.23.5, and HarmonyOS SDK 6.0.2 (API 22). It supports `@guancecloud/ft_sdk` `0.1.17` and later releases.
+The `0.1.0-alpha.3` prerelease is verified with Node.js 18 or newer, Hvigor and `@ohos/hvigor-ohos-plugin` 6.23.5, and HarmonyOS SDK 6.0.2 (API 22). It supports `@guancecloud/ft_sdk` `0.1.17` and later releases.
 
 `@ohos/hvigor-ohos-plugin` is supplied by DevEco Studio's Hvigor runtime. `@guancecloud/ft_sdk` must still be declared as the application's runtime HAR dependency because the generated imports target that package.

package/hvigorCompile/ft-cold-launch-transform.ts

@@ -10,6 +10,7 @@ declare const require: {
     require(moduleName: string): any;
   };
 };
+declare const __dirname: string;
 
 type TypeScriptApi = any;
 type AbilityClassKind = 'stage' | 'ui' | 'other';
@@ -73,6 +74,22 @@ function selectBridgeName(identifiers: Set<string>): string {
   return bridgeName;
 }
 
+function getPluginVersion(): string {
+  try {
+    const fileSystem = require.main.require('fs');
+    const path = require.main.require('path');
+    const packagePath = path.resolve(__dirname, '..', 'package.json');
+    const packageInfo = JSON.parse(fileSystem.readFileSync(packagePath, 'utf8')) as { version?: string };
+    if (typeof packageInfo.version === 'string') {
+      return packageInfo.version.trim();
+    }
+  } catch (_) {
+    // Do not inject a guessed version when a custom package layout prevents
+    // reading package.json. A missing entry is more accurate than fake data.
+  }
+  return '';
+}
+
 function findImportInsertionOffset(ts: TypeScriptApi, sourceFile: any): number {
   let offset = 0;
   sourceFile.statements.forEach((statement: any) => {
@@ -212,9 +229,10 @@ function createFirstFrameRetryInjections(ts: TypeScriptApi, sourceFile: any, cod
 }
 
 function createColdLaunchInjections(ts: TypeScriptApi, sourceFile: any, code: string,
-  bridgeName: string): ColdLaunchInjection[] {
+  bridgeName: string, pluginVersion: string): ColdLaunchInjection[] {
   const injections: ColdLaunchInjection[] = [];
   const abilityBindings = collectAbilityBindings(ts, sourceFile);
+  const pluginVersionArgument = pluginVersion.length > 0 ? `, ${JSON.stringify(pluginVersion)}` : '';
   visit(ts, sourceFile, (node: any) => {
     if (!ts.isClassDeclaration(node)) {
       return;
@@ -232,7 +250,7 @@ function createColdLaunchInjections(ts: TypeScriptApi, sourceFile: any, code: st
       const position = member.body.getStart(sourceFile) + 1;
       if (member.name.text === 'onCreate') {
         hasOnCreate = true;
-        let content = `\n${indentation}${bridgeName}.recordApplicationInit(this.context);`;
+        let content = `\n${indentation}${bridgeName}.recordApplicationInit(this.context${pluginVersionArgument});`;
         if (kind === 'ui') {
           content += `\n${indentation}${bridgeName}.recordFirstUIAbilityCreate();`;
         }
@@ -269,7 +287,7 @@ function createColdLaunchInjections(ts: TypeScriptApi, sourceFile: any, code: st
       injections.push({
         position: node.end - 1,
         content: `\n${indentation}  onCreate(): void {\n` +
-          `${indentation}    ${bridgeName}.recordApplicationInit(this.context);\n` +
+          `${indentation}    ${bridgeName}.recordApplicationInit(this.context${pluginVersionArgument});\n` +
           `${indentation}  }\n`
       });
     }
@@ -299,7 +317,8 @@ function rewriteSource(ts: TypeScriptApi, id: string, code: string): string {
   }
   const sourceFile = ts.createSourceFile(id, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
   const bridgeName = selectBridgeName(collectIdentifierNames(ts, sourceFile));
-  const injections = createColdLaunchInjections(ts, sourceFile, code, bridgeName);
+  const version = getPluginVersion();
+  const injections = createColdLaunchInjections(ts, sourceFile, code, bridgeName, version);
   if (injections.length === 0) {
     return code;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcare/hvigor-ohos-plugin",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.3",
   "description": "Guance HarmonyOS Hvigor plugin for automatic console, HiLog, and cold-launch collection.",
   "main": "index.js",
   "files": [
@@ -13,6 +13,15 @@
   ],
   "author": "Guance",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GuanceCloud/datakit-harmonyos.git",
+    "directory": "ft_hvigor_plugin"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
   "engines": {
     "node": ">=18"
   },