跳到主要内容

安装WUI SDK


WUI项目结构

使用 Cumulia WUI 开发的典型Web应用,它的UI程序通常包含以下内容:


  • index.html

index.html是 Web 应用程序的入口文件或默认主页。它定义了应用程序的初始UI结构,通常会引用和加载其他资源以构建完整的用户界面。

示例代码如下:

<!DOCTYPE html>
<html lang="en">

<head>
<meta charset="UTF-8" />
<link rel="icon" type="image/svg+xml" href="/vite.svg" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>WUI Test</title>
</head>

<body>
<script type="module" src="./src/main.ts"></script>
</body>

</html>


  • src/ 该目录存储实现软件包功能的核心代码。其内部结构可能因项目的复杂性和组织方式而有所不同,但通常包括以下内容:

    • main.ts: 这是整个软件包的主入口文件。它负责从其他文件中导入函数和类,也可能将自身的函数或类导出供其他应用程序使用。

    • 其他 TypeScript 文件: 为了更好地组织代码,软件包的核心逻辑通常分布在多个文件中。这些文件可以被 main.ts 导入或供其他包使用。


  • public/

*public/*目录存储需要直接提供给网页的资源,例如数据文件、图片和其他静态资源。


  • package.json package.json是项目的配置文件,包含以下内容:

    • 自定义脚本:可以通过命令 npm run <script_name> 自动执行。
    • 依赖项及其版本:列出项目所需的依赖库,帮助开发者自动构建和测试,并确保版本兼容性。

Cumulia WUI 的 SDK 库

Cumulia WUI 提供了基础库和一系列插件供开发者使用:

  • wui.basic
  • wui.component
  • wui.context
  • wui.framework

SDK 安装

对于现代 Web 应用程序,npm 是一种高效且可维护的工具,能够简化依赖管理流程,帮助开发者快速构建程序。


搭建开发环境

  • 安装Node.js

npm 是 Node.js 的内置工具。

Node.js 是一个 JavaScript 运行环境,允许开发者在浏览器之外执行 JavaScript 代码。

下载并安装最新的稳定版 Node.js(可从其官网获取),安装完成后会自动包含 npm。

  • 选择代码编辑器或 IDE

选择适合自己需求的代码编辑器或集成开发环境(IDE)。推荐的工具包括:

  • Visual Studio Code
  • Atom
  • WebStorm 这些工具提供了语法高亮、代码补全和调试等功能。

安装依赖包

在完成开发环境的搭建后,即可开始构建应用程序。

package.json 文件中指定了所需集成的依赖包名称。

使用以下命令安装依赖:

npm install

此命令会从 npm 注册表中检索依赖包及其相关依赖,并自动创建 node_modules/ 目录,将依赖包存储其中。

复制 SDK 库

将所需的 Cumulia WUI SDK 库文件复制到 node_modules/ 目录中。

验证许可证

确保已正确验证 SDK 的许可证以避免使用限制。

运行应用程序

使用以下命令启动应用程序:

npm run dev

运行后会生成一个 URL(通常为 *http://localhost:3001/*),在浏览器中打开该地址即可查看应用程序。