cj-tauri 2.1.3 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/cjpm.toml CHANGED
@@ -2,7 +2,7 @@
2
2
  cjc-version = "1.0.5"
3
3
  name = "cjTauri"
4
4
  description = "仓颉版 Tauri:轻量跨端混合开发框架(WebView 宿主 + IPC 桥 + 能力安全模型)"
5
- version = "2.1.3"
5
+ version = "2.2.0"
6
6
  target-dir = ""
7
7
  output-type = "static"
8
8
  compile-option = ""
package/cli/cjpm.toml CHANGED
@@ -2,7 +2,7 @@
2
2
  cjc-version = "1.0.5"
3
3
  name = "cli"
4
4
  description = "cj-tauri CLI:脚手架 create / dev / build / run / info"
5
- version = "2.1.3"
5
+ version = "2.2.0"
6
6
  target-dir = ""
7
7
  output-type = "executable"
8
8
  compile-option = ""
@@ -10,7 +10,7 @@ import std.collection.*
10
10
 
11
11
  /** CLI 版本:须与 cli/cjpm.toml 的 version、CHANGELOG 顶部版本一致(scripts/check-version.sh 校验) */
12
12
  func cliVersion(): String {
13
- return "2.1.3"
13
+ return "2.2.0"
14
14
  }
15
15
 
16
16
  /** 一次命令所需的路径上下文 */
@@ -97,14 +97,16 @@ cj_host *cj_bridge_create(void) {
97
97
  return h;
98
98
  }
99
99
 
100
- void cj_bridge_destroy(cj_host *h) {
100
+ int cj_bridge_destroy(cj_host *h) {
101
101
  int i;
102
- if (!h) return;
102
+ if (!h) return 1;
103
103
  /* 平台资源先走:COM 环境引用 / 模块句柄等(幂等)。返回 0=宿主线程还在收尾,
104
- 它可能仍在用 h(GTK/WebView2 回调的 user_data 就是它)——这时连句柄一起留着不释放。 */
104
+ 它可能仍在用 h(GTK/WebView2 回调的 user_data 就是它)——这时连句柄一起留着不释放。
105
+ 回报 0 是**如实**:调用方(仓颉 dispose)据此保留句柄并可再试,别当成「已经释放」
106
+ 把字段置空——那正是 issue #8 里「窗口还在屏幕上、页面 IPC 全哑」被静默放过去的地方。 */
105
107
  if (!cj_plat_fini(h)) {
106
- cj_logf("[cj-bridge] destroy: host thread still running, handle kept\n");
107
- return;
108
+ cj_logf("[cj-bridge] destroy: host thread still running, handle kept (retryable)\n");
109
+ return 0;
108
110
  }
109
111
  if (h->js_lock) cj_plat_sync_destroy(h->js_lock);
110
112
  if (h->dlg_lock) cj_plat_sync_destroy(h->dlg_lock);
@@ -124,6 +126,7 @@ void cj_bridge_destroy(cj_host *h) {
124
126
  free(h->pending_url);
125
127
  cj_logf("[cj-bridge] host destroyed: %p\n", (void *)h);
126
128
  free(h);
129
+ return 1;
127
130
  }
128
131
 
129
132
  void cj_bridge_init(cj_host *h, cj_on_message_fn m, cj_on_destroy_fn d) {
@@ -401,8 +401,11 @@ void cj_core_drop_files(cj_host *h, const char *uri_list);
401
401
  CJ_BRIDGE_API cj_host *cj_bridge_create(void);
402
402
 
403
403
  /* 释放宿主编:先 cj_plat_fini,再回收公共状态。对 NULL 安全。
404
- 契约:仓颉侧在 waitForExit 返回后调用**至多一次**,调用后句柄不可再用(字段置空)。 */
405
- CJ_BRIDGE_API void cj_bridge_destroy(cj_host *h);
404
+ 返回值:1 = 已回收(句柄随即失效,调用方必须把字段置空);
405
+ 0 = 平台宿主线程还没收工,**平台状态与句柄一起留着**,调用方可以稍后再调一次重试。
406
+ 契约(issue #8):这是可重试的操作,不是「调过就算数」——早退时不能把句柄丢掉,
407
+ 否则「没回收」这件事既看不见也再没有第二次机会(表象是窗口留在屏幕上、页面 IPC 全哑)。 */
408
+ CJ_BRIDGE_API int cj_bridge_destroy(cj_host *h);
406
409
 
407
410
  /* 注入回调(JS 消息到达 / 窗口销毁)+ 平台一次性初始化 */
408
411
  CJ_BRIDGE_API void cj_bridge_init(cj_host *h, cj_on_message_fn m, cj_on_destroy_fn d);
@@ -337,16 +337,19 @@ int cj_plat_fini(cj_host *h) {
337
337
  /* 收尾顺序同样要命:窗口销毁是 GTK/WebKit 一整串多线程拆解,若它与仓颉运行时的收尾
338
338
  并发(run() 返回 → 运行时关停),实测几乎必然以 SIGABRT 收尾(`schd-worker` unhandled
339
339
  SIGABRT from runtime frame)。所以给宿主线程一个有界的等待窗口——纯 usleep 轮询标记,
340
- 不碰 join(join 会与运行时握手互等,见上);等不到也不阻塞进程退出,照旧留着状态。 */
340
+ 不碰 join(join 会与运行时握手互等,见上);等不到也不阻塞进程退出,照旧留着状态。
341
+ 预算与 Windows 侧同一口径(5s):GTK/WebKit 的拆解是整串多线程收尾,2s 实测不够宽。
342
+ 早退时**保留 p 与 thread_done 标记**,调用方(仓颉 dispose)可以再调一次重试——
343
+ issue #8 里那次「窗口还在、IPC 全哑」就是早退之后句柄被置空、再没有第二次机会。 */
341
344
  if (!p->thread_done) {
342
345
  int spin = 0;
343
- while (!p->thread_done && spin < 2000) { /* 最多约 2s */
346
+ while (!p->thread_done && spin < 5000) { /* 最多约 5s */
344
347
  usleep(1000);
345
348
  spin++;
346
349
  }
347
350
  }
348
351
  if (!p->thread_done) {
349
- fprintf(stderr, "[cj-bridge] fini: host thread still running, platform state kept\n");
352
+ fprintf(stderr, "[cj-bridge] fini: host thread still running, platform state kept (retryable)\n");
350
353
  return 0;
351
354
  }
352
355
  h->plat = NULL;
@@ -2284,12 +2284,41 @@ static DWORD WINAPI host_thread_main(LPVOID param) {
2284
2284
  create_env(NULL, udf_arg, NULL, &p->env.iface));
2285
2285
  }
2286
2286
 
2287
- while (GetMessageW(&msg, NULL, 0, 0)) {
2288
- TranslateMessage(&msg);
2289
- DispatchMessageW(&msg);
2287
+ /* 消息循环(issue #8):**不能**只等消息。should_quit 可以来自任何线程(命令 worker 里的
2288
+ app.quit()),而窗口已经不在(还没建出来 / 已被销毁 / 环境创建失败)时没人能给它
2289
+ PostMessage——纯 GetMessageW 会永久阻塞:宿主线程永不退出 → thread_done 恒 0 →
2290
+ cj_plat_fini 每次都报「host thread still running」并把平台状态永久留着。所以改成
2291
+ 有界唤醒 + 每轮复核退出意图,两条都不依赖别人替我们投消息。 */
2292
+ for (;;) {
2293
+ DWORD wr = MsgWaitForMultipleObjectsEx(0, NULL, 50, QS_ALLINPUT, MWMO_INPUTAVAILABLE);
2294
+ if (wr == WAIT_OBJECT_0) {
2295
+ while (PeekMessageW(&msg, NULL, 0, 0, PM_REMOVE)) {
2296
+ if (msg.message == WM_QUIT) goto done;
2297
+ TranslateMessage(&msg);
2298
+ DispatchMessageW(&msg);
2299
+ }
2300
+ }
2301
+ /* 退出意图复核:窗口还活着就本线程自己销毁(DestroyWindow 只能建窗线程调),
2302
+ 窗口已经没了就直接收工。 */
2303
+ if (h->should_quit) {
2304
+ if (p->hwnd) {
2305
+ DestroyWindow(p->hwnd); /* WM_DESTROY → PostQuitMessage,下一轮取到 WM_QUIT 退出 */
2306
+ } else {
2307
+ break;
2308
+ }
2309
+ }
2290
2310
  }
2291
2311
 
2292
2312
  done:
2313
+ /* 窗口必收(issue #8):消息循环退出 ≠ 窗口没了。WM_QUIT 可能来自别处(嵌套模态循环、
2314
+ 别的线程 PostQuitMessage),那时窗口仍留在屏幕上而消息循环已经不再服务它——表象正是
2315
+ 「界面看着正常,但点什么都回不来、ExecuteScript 一条都不再发」(js -> native 还在走,
2316
+ 因为消息接收是 WebView2 自己的通道;回投却全靠本循环,于是前端 promise 永不 settle)。
2317
+ 这里补最后一道:本线程直接销毁,保证「循环退出时屏幕上不留窗」。 */
2318
+ if (p->hwnd) {
2319
+ DestroyWindow(p->hwnd); /* WM_DESTROY 里自己会置 p->hwnd = NULL 并 PostQuitMessage */
2320
+ p->hwnd = NULL;
2321
+ }
2293
2322
  if (title_w) free(title_w);
2294
2323
  if (icon_w) free(icon_w);
2295
2324
  if (p->menu) { /* 窗口没了,菜单栏也要回收(HMENU 归本线程建、也归本线程销毁)*/
@@ -2352,15 +2381,21 @@ int cj_plat_fini(cj_host *h) {
2352
2381
  if (!p) return 1;
2353
2382
  /* 宿主线程还活着(事件循环没退出):不能在这里 free 平台状态——它正被那条线程用着。
2354
2383
  等待必须有界:宿主线程收尾时要进入仓颉运行时(onDestroy),无限等会与运行时的线程
2355
- 退出握手互等(Linux 侧实测过,见 bridge_linux.c 同名函数);超时就状态与句柄一起留着。 */
2384
+ 退出握手互等(Linux 侧实测过,见 bridge_linux.c 同名函数)。
2385
+ 等不到时**保留线程句柄与平台状态**并以 0 返回:调用方(仓颉 dispose)可以再调一次,
2386
+ 这里绝不提前 CloseHandle——句柄一丢,下次连「它还活着吗」都问不出来(issue #8)。 */
2356
2387
  if (p->thread_started && p->thread) {
2357
- WaitForSingleObject(p->thread, 5000);
2358
- CloseHandle(p->thread);
2359
- p->thread = NULL;
2360
- p->thread_started = 0;
2388
+ if (WaitForSingleObject(p->thread, 5000) == WAIT_OBJECT_0) {
2389
+ CloseHandle(p->thread);
2390
+ p->thread = NULL;
2391
+ p->thread_started = 0;
2392
+ }
2361
2393
  }
2362
2394
  if (!p->thread_done) {
2363
- fprintf(stderr, "[cj-bridge] fini: host thread still running, platform state kept\n");
2395
+ /* 它可能正停在 WM_DESTROY 的同步 COM 清理里(view_close / controller Close 都可能慢)。
2396
+ 再投一次退出让存活窗口走销毁路径,然后如实报告没回收,等调用方重试。 */
2397
+ if (p->hwnd) PostMessageW(p->hwnd, WM_CJT_QUIT, 0, 0);
2398
+ fprintf(stderr, "[cj-bridge] fini: host thread still running, platform state kept (retryable)\n");
2364
2399
  return 0;
2365
2400
  }
2366
2401
  h->plat = NULL;
@@ -105,6 +105,9 @@ static int g_wake_calls;
105
105
  static int g_quit_calls;
106
106
  static int g_start_calls;
107
107
  static int g_fini_calls;
108
+ /* cj_plat_fini 的返回值:1 = 宿主线程已收工(平台状态可回收),0 = 还没收工(要留着等重试)。
109
+ issue #8:核心必须把这个 0 如实传出去并保留句柄,不能当成功。 */
110
+ static int g_fini_result = 1;
108
111
  static int g_run_dialog_calls;
109
112
  static int g_post_dialog_calls;
110
113
  static int g_load_url_calls;
@@ -181,7 +184,7 @@ void cj_plat_sync_wait(cj_sync *s, int *ready) {
181
184
  void cj_plat_sync_signal(cj_sync *s) { if (s) pthread_cond_signal(&s->c); }
182
185
 
183
186
  void cj_plat_init(cj_host *h) { (void)h; }
184
- int cj_plat_fini(cj_host *h) { (void)h; g_fini_calls++; return 1; }
187
+ int cj_plat_fini(cj_host *h) { (void)h; g_fini_calls++; return g_fini_result; }
185
188
  void cj_plat_start(cj_host *h) { (void)h; g_start_calls++; }
186
189
  void cj_plat_quit(cj_host *h) { (void)h; g_quit_calls++; }
187
190
  void cj_plat_wake_ui(cj_host *h) { (void)h; g_wake_calls++; }
@@ -1053,10 +1056,31 @@ int main(void) {
1053
1056
  /* --- 18. 销毁:先走平台 fini,再回收句柄 --- */
1054
1057
  case_begin("destroy 先走 cj_plat_fini 再回收");
1055
1058
  reset_counters();
1056
- cj_bridge_destroy(h2);
1057
- cj_bridge_destroy(h);
1059
+ CHECK(cj_bridge_destroy(h2) == 1, "宿主线程已收工时 destroy 回 1");
1060
+ CHECK(cj_bridge_destroy(h) == 1, "同上(第二个宿主)");
1058
1061
  CHECK(g_fini_calls == 2, "两个宿主各自走一次平台 fini");
1059
1062
 
1063
+ /* --- 18b. 销毁可重试(issue #8):宿主线程没收工就如实回 0,句柄留着等下一次 ---
1064
+ 早退那一轮的真实后果是「窗口留在屏幕上、消息循环不再服务它、页面 promise 永不 settle」,
1065
+ 所以核心这条边界必须有断言盯着:回 0 时平台状态不许被提前回收(句柄仍可访问),
1066
+ 而且同一个句柄重试一次必须能成功回收——否则应用侧既看不见失败、也没有第二次机会。 */
1067
+ case_begin("destroy 可重试:fini 未收工不假装成功");
1068
+ {
1069
+ cj_host *hr = cj_bridge_create();
1070
+ CHECK(hr != NULL, "为可重试用例新建宿主");
1071
+ if (hr) {
1072
+ reset_counters();
1073
+ g_fini_result = 0;
1074
+ CHECK(cj_bridge_destroy(hr) == 0, "宿主线程未收工时 destroy 回 0(不是成功)");
1075
+ CHECK(g_fini_calls == 1, "那次仍走了平台 fini(只是它回 0)");
1076
+ CHECK(cj_bridge_should_quit(hr) == 0,
1077
+ "句柄仍可安全访问(平台状态没被提前回收,没有 UAF)");
1078
+ g_fini_result = 1;
1079
+ CHECK(cj_bridge_destroy(hr) == 1, "同一句柄重试即可回收(回 1)");
1080
+ CHECK(g_fini_calls == 2, "重试又走了一次平台 fini");
1081
+ }
1082
+ }
1083
+
1060
1084
  /* --- 19. 串口:白名单是安全边界,导出只做校验 + 转发 --- */
1061
1085
  case_begin("serial 白名单与导出转发");
1062
1086
  CHECK(cj_serial_path_allowed("/dev/ttyUSB0"), "放行 /dev/ttyUSB0");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cj-tauri",
3
- "version": "2.1.3",
3
+ "version": "2.2.0",
4
4
  "description": "Tauri for the Cangjie language: a scaffold CLI for hybrid desktop apps — Cangjie backend (statically compiled) plus a system WebView frontend (HTML/CSS/JS), with a bidirectional IPC bridge and a capability-based security model. Windows, Linux and HarmonyOS PC.",
5
5
  "keywords": [
6
6
  "cangjie",
@@ -25,10 +25,14 @@ foreign func cj_bridge_create(): CPointer<Unit>
25
25
 
26
26
  /**
27
27
  * 释放宿主编:对空指针安全、幂等;调用后该句柄不可再用
28
+ *
29
+ * 返回值是**契约的一部分**(issue #8):1 = 已回收,句柄随即失效;0 = 宿主线程还没收工,
30
+ * 平台状态与句柄都被留着,调用方应稍后重试。别把 0 当成功——那等于把「窗口还在、
31
+ * IPC 全哑」这件事静默丢掉,之后再没有第二次机会。
28
32
  */
29
33
  @When[os == "Linux" && env != "ohos"]
30
34
  @C
31
- foreign func cj_bridge_destroy(h: CPointer<Unit>): Unit
35
+ foreign func cj_bridge_destroy(h: CPointer<Unit>): Int32
32
36
 
33
37
  @When[os == "Linux" && env != "ohos"]
34
38
  @C
@@ -669,10 +673,27 @@ public class WebKitHost <: WebViewHost {
669
673
  if (this.handle.isNull()) {
670
674
  return
671
675
  }
672
- unsafe {
673
- cj_bridge_destroy(this.handle)
676
+ // 宿主线程还在收尾(GTK/WebKit 的拆解是整串多线程收尾,C 侧每次最多等 5s)时,
677
+ // cj_bridge_destroy 回 0 表示**没回收**:句柄必须留着再试一次——直接置空就等于
678
+ // 把「没释放干净」这件事一起丢掉(issue #8 的那一轮就是这么静默过去的)。
679
+ var released = false
680
+ var tries = 0
681
+ while (tries < 2 && !released) {
682
+ unsafe {
683
+ released = cj_bridge_destroy(this.handle) != 0
684
+ }
685
+ if (!released) {
686
+ tries += 1
687
+ if (tries < 2) {
688
+ sleep(Duration.millisecond * 500)
689
+ }
690
+ }
691
+ }
692
+ if (released) {
693
+ this.handle = CPointer<Unit>()
694
+ } else {
695
+ eprintln("[cj-tauri] dispose: 宿主线程未结束,句柄保留(可再调一次 dispose 重试)")
674
696
  }
675
- this.handle = CPointer<Unit>()
676
697
  }
677
698
  }
678
699
 
@@ -24,10 +24,14 @@ foreign func cj_bridge_create(): CPointer<Unit>
24
24
 
25
25
  /**
26
26
  * 释放宿主编:对空指针安全、幂等;调用后该句柄不可再用
27
+ *
28
+ * 返回值是**契约的一部分**(issue #8):1 = 已回收,句柄随即失效;0 = 宿主线程还没收工,
29
+ * 平台状态与句柄都被留着,调用方应稍后重试。别把 0 当成功——那等于把「窗口还在、
30
+ * IPC 全哑」这件事静默丢掉,之后再没有第二次机会。
27
31
  */
28
32
  @When[os == "Windows"]
29
33
  @C
30
- foreign func cj_bridge_destroy(h: CPointer<Unit>): Unit
34
+ foreign func cj_bridge_destroy(h: CPointer<Unit>): Int32
31
35
 
32
36
  @When[os == "Windows"]
33
37
  @C
@@ -669,10 +673,28 @@ public class WebView2Host <: WebViewHost {
669
673
  if (this.handle.isNull()) {
670
674
  return
671
675
  }
672
- unsafe {
673
- cj_bridge_destroy(this.handle)
676
+ // 宿主线程还在收尾(WebView2 的 controller Close / view_close 都是同步 COM 调用,
677
+ // 可能卡到数秒;C 侧每次最多等 5s)时,cj_bridge_destroy 回 0 表示**没回收**:
678
+ // 句柄必须留着再试一次——直接置空就等于把「没释放干净」这件事一起丢掉
679
+ // (issue #8 的那一轮就是这么静默过去的)。
680
+ var released = false
681
+ var tries = 0
682
+ while (tries < 2 && !released) {
683
+ unsafe {
684
+ released = cj_bridge_destroy(this.handle) != 0
685
+ }
686
+ if (!released) {
687
+ tries += 1
688
+ if (tries < 2) {
689
+ sleep(Duration.millisecond * 500)
690
+ }
691
+ }
692
+ }
693
+ if (released) {
694
+ this.handle = CPointer<Unit>()
695
+ } else {
696
+ eprintln("[cj-tauri] dispose: 宿主线程未结束,句柄保留(可再调一次 dispose 重试)")
674
697
  }
675
- this.handle = CPointer<Unit>()
676
698
  }
677
699
  }
678
700
 
package/src/version.cj CHANGED
@@ -9,7 +9,7 @@ package cjTauri
9
9
  * - cli/src/project.cj 的 cliVersion()
10
10
  * - CHANGELOG.md 顶部第一个已发版段
11
11
  */
12
- public let CJ_TAURI_VERSION = "2.1.3"
12
+ public let CJ_TAURI_VERSION = "2.2.0"
13
13
 
14
14
  /**
15
15
  * IPC 报文协议版本(报文形状是跨层契约,加版本字段是协议治理惯例):事件 / 回执信封的 `protocol` 字段