clickgo-native 2.0.2 → 2.0.3

package/README.md

@@ -42,6 +42,8 @@ native.launcher(new Boot());
 
 ## Build a ClickGo Application as a Native Package
 
+The application project does not need to install `electron` directly when using ClickGo Compiler to run and package it. The compiler supplies the Electron runtime. Native main-process code can use `native.getAppVersion()` to read the application's `package.json` version and `native.isPackaged()` to distinguish a packaged application from development runs. These APIs do not expose Electron to the HTML page.
+
 Building a desktop application consists of two steps: compile the ClickGo application into a `.cga` file, then package the Native project with Electron.
 
 Install the compiler globally first:

package/dist/index.d.ts

@@ -91,6 +91,16 @@ export declare function showMainForm(path: string, opt?: {
     /** --- 应用启动后、网页加载成功前显示的底色 --- */
     'background'?: string;
 }): void;
+/**
+ * --- 获取当前桌面应用的版本，来自应用 package.json ---
+ * @returns 应用版本
+ */
+export declare function getAppVersion(): string;
+/**
+ * --- 判断当前应用是否为已打包运行 ---
+ * @returns 是否已打包
+ */
+export declare function isPackaged(): boolean;
 /** --- 用户调用运行 boot 类 --- */
 export declare function launcher(boot: AbstractBoot): void;
 /**

package/dist/index.js

@@ -511,6 +511,20 @@ function resetMainSession() {
         },
     };
 }
+/**
+ * --- 获取当前桌面应用的版本，来自应用 package.json ---
+ * @returns 应用版本
+ */
+export function getAppVersion() {
+    return electron.app.getVersion();
+}
+/**
+ * --- 判断当前应用是否为已打包运行 ---
+ * @returns 是否已打包
+ */
+export function isPackaged() {
+    return electron.app.isPackaged;
+}
 /** --- 用户调用运行 boot 类 --- */
 export function launcher(boot) {
     (async function () {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo-native",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "The software developed with ClickGo will run in Windows, Mac OS, Linux.",
   "type": "module",
   "keywords": [