cj-tauri 2.1.1 → 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.
@@ -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
@@ -523,6 +527,31 @@ public class WebKitHost <: WebViewHost {
523
527
  return Some(text)
524
528
  }
525
529
 
530
+ /**
531
+ * 读宿主 WebView 的 cookie 仓库(JSON 文本,**含 httpOnly**)。
532
+ *
533
+ * filter = 域名后缀(如 `"csdn.net"`;`".csdn.net"` 也命中),空串 = 全部。
534
+ * 失败也返回 JSON(`{"ok":false,"error":…}`),调用方永远不必判 null。
535
+ *
536
+ * **线程口径**:请在命令 worker 线程调用——桥内部投 UI 线程发起异步读并带 5s 超时;
537
+ * 站在 UI 线程上调用会直接拿到错误 JSON(等待的事件得由 UI 线程处理,阻塞即自死锁)。
538
+ */
539
+ public func cookiesJson(filter: String): String {
540
+ let f = unsafe { LibC.mallocCString(filter) }
541
+ let cs = unsafe { cj_bridge_get_cookies(this.handle, f) }
542
+ unsafe {
543
+ LibC.free(f) // C 侧只拷贝,不接管入参所有权
544
+ }
545
+ if (cs.isNull()) {
546
+ return "{\"ok\":false,\"error\":\"bridge returned null\"}"
547
+ }
548
+ let json = cs.toString()
549
+ unsafe {
550
+ cj_bridge_cookies_free(cs) // 归还缓冲:malloc 家族分配,必须走桥的 free
551
+ }
552
+ return json
553
+ }
554
+
526
555
  public func notify(title: String, body: String): Bool {
527
556
  var rc: Int32 = -1
528
557
  unsafe {
@@ -644,10 +673,27 @@ public class WebKitHost <: WebViewHost {
644
673
  if (this.handle.isNull()) {
645
674
  return
646
675
  }
647
- unsafe {
648
- 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 重试)")
649
696
  }
650
- this.handle = CPointer<Unit>()
651
697
  }
652
698
  }
653
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
@@ -523,6 +527,31 @@ public class WebView2Host <: WebViewHost {
523
527
  return Some(text)
524
528
  }
525
529
 
530
+ /**
531
+ * 读宿主 WebView 的 cookie 仓库(JSON 文本,**含 httpOnly**)。
532
+ *
533
+ * filter = 域名后缀(如 `"csdn.net"`;`".csdn.net"` 也命中),空串 = 全部。
534
+ * 失败也返回 JSON(`{"ok":false,"error":…}`),调用方永远不必判 null。
535
+ *
536
+ * **线程口径**:请在命令 worker 线程调用——桥内部投 UI 线程发起异步读并带 5s 超时;
537
+ * 站在 UI 线程上调用会直接拿到错误 JSON(等待的事件得由 UI 线程处理,阻塞即自死锁)。
538
+ */
539
+ public func cookiesJson(filter: String): String {
540
+ let f = unsafe { LibC.mallocCString(filter) }
541
+ let cs = unsafe { cj_bridge_get_cookies(this.handle, f) }
542
+ unsafe {
543
+ LibC.free(f) // C 侧只拷贝,不接管入参所有权
544
+ }
545
+ if (cs.isNull()) {
546
+ return "{\"ok\":false,\"error\":\"bridge returned null\"}"
547
+ }
548
+ let json = cs.toString()
549
+ unsafe {
550
+ cj_bridge_cookies_free(cs) // 归还缓冲:malloc 家族分配,必须走桥的 free
551
+ }
552
+ return json
553
+ }
554
+
526
555
  public func notify(title: String, body: String): Bool {
527
556
  var rc: Int32 = -1
528
557
  unsafe {
@@ -644,10 +673,28 @@ public class WebView2Host <: WebViewHost {
644
673
  if (this.handle.isNull()) {
645
674
  return
646
675
  }
647
- unsafe {
648
- 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 重试)")
649
697
  }
650
- this.handle = CPointer<Unit>()
651
698
  }
652
699
  }
653
700
 
@@ -167,6 +167,14 @@ class FakeHost <: WebViewHost {
167
167
  return true
168
168
  }
169
169
 
170
+ /** cookie 桥回包:测试直接塞一段 JSON(默认空仓库);filter 由调用方自己过滤,这里不模拟 */
171
+ public var cookieJson: String = "{\"ok\":true,\"count\":0,\"cookies\":[]}"
172
+
173
+ public func cookiesJson(filter: String): String {
174
+ let _ = filter
175
+ return this.cookieJson
176
+ }
177
+
170
178
  public func clipboardReadText(): Option<String> {
171
179
  return this.clipboardReadValue
172
180
  }
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.1"
12
+ public let CJ_TAURI_VERSION = "2.2.0"
13
13
 
14
14
  /**
15
15
  * IPC 报文协议版本(报文形状是跨层契约,加版本字段是协议治理惯例):事件 / 回执信封的 `protocol` 字段