JadeView

JadeView 易语言 SDK

项目简介

JadeView 易语言 SDK 是一个专为易语言开发者设计的 WebView 窗口库，基于 Rust 开发，提供了简单易用的 API 接口，帮助开发者快速构建现代化的桌面应用程序。

主要功能

  • 跨底层平台：内核支持 Windows/Linux，易语言仅适配 Windows
  • WebView 渲染：支持 HTML/CSS/JS/Vue/React 页面
  • 窗口管理：标准 / 无边框窗口、Mica 透明、截图保护、明暗主题切换
  • 事件系统：子程序指针回调，覆盖窗口、IPC、热键全生命周期事件
  • 内置jade://私有资源协议，无需 HTTP 服务加载静态文件
  • 安全内存自动托管，全接口线程安全
  • 双向 IPC 通讯，配套系统文件、消息弹窗工具
  • JAPK 加密资源包（付费）：内存加载、签名防篡改
  • 系统工具：托盘、全局热键、自定义 URL、YAML 配置、NTP 授时、剪贴板文本读写

内存管理机制

底层jadeview_x86.dll采用 Rust 内存模型，规避内存泄漏与野指针崩溃：

  1. 使用CStr/CString安全处理 UTF8 字符串；
  2. 回调产生字符串内核自动释放，无需手动操作；
  3. 底层不直接调用 malloc/free，内存统一托管；
  4. 回调生命周期严格管控，资源及时回收；
  5. 全局状态加互斥锁，支持多线程并发调用。

快速开始

  1. 注册应用就绪事件：JadeView.App.注册事件(#事件_应用准备就绪, &回调子程序)，必须在初始化之前执行
  2. 初始化内核：调用JadeView.App.初始化加载 jadeview_x86.dll进行初始化
  3. 运行消息循环：调用JadeView.App.消息循环 运行消息循环
  4. 创建 WebView 窗口：在 #事件_应用准备就绪 回调子程序 内调用JadeView.窗口.创建创建窗口。重要：窗口必须在 #事件_应用准备就绪 事件触发后才能创建。
  5. 注册其他事件：通过JadeView.App.注册事件 注册其他事件回调
  6. 清理资源：监听 #事件_全部窗口已关闭 事件，调用JadeView.App.退出释放全部资源

注意事项

  1. 全接口线程安全，多线程可正常调用；
  2. JadeView.窗口.创建即时返回 ID，但窗口实际创建是在事件循环线程中异步完成的；
  3. 中文入参必须使用GBK文本到UTF8文本转换；
  4. 导入JadeView.ec自带全局单例，无需手动声明。
  5. 使用完毕后应及时调用 JadeView.App.退出 清理资源

支持的平台

  • Windows 10 1903 及以上、Windows 11（易语言 SDK 唯一适配操作系统）
Next
方法总览