Skip to content

安装与运行 ​

开发示例 ​

根工程使用 Node 20.19.1、pnpm 9.2.0 和 DCloud 编译批次 3.0.0-4080720251210001。

先执行 pnpm install --frozen-lockfile。分别在两个终端运行 pnpm dev:h5 和 pnpm dev:docs。

H5 在 http://127.0.0.1:5173/#/subPages/notebook/Index。文档站在 http://127.0.0.1:5174。运行 pnpm dev:mp-weixin 后,用微信开发者工具打开 dist/dev/mp-weixin。开发工具的 AppID 按你自己的测试项目配置。

微信示例使用按需组件注入,从首页只加载当前页面及其依赖。更多配置见 DCloud manifest。

从 npm 安装 ​

sh
pnpm add looseleaf-uni

在宿主 pages.json 根级配置 easycom。用 vue-tsc 的项目可在自己的类型入口导入 looseleaf-uni/global。

json
{
  "easycom": {
    "custom": {
      "^ll-(.*)$": "looseleaf-uni/lib/components/ll-$1/ll-$1.vue"
    }
  }
}

如需验证当前源码,在组件库仓库运行 pnpm package:local,再在宿主项目中安装生成的 dist/release/looseleaf-uni-0.1.0.tgz。

本地 uni_modules ​

把 dist/release/uni_modules/looseleaf-uni 复制到宿主的 src/uni_modules。HBuilderX 建立的项目将模块放在项目根的 uni_modules。uni-app 会按同名目录自动识别组件。

两个安装入口都随组件带上样式。在页面里加入 <ll-button>保存</ll-button> 即可使用。

可独立安装的最小工程 ​

先运行 pnpm package:local。用 node scripts/create-consumer.mjs npm <全新绝对路径> 或 node scripts/create-consumer.mjs uni_modules <全新绝对路径> 生成对应宿主。两个项目分别运行 pnpm install、pnpm type-check 和 pnpm dev,可验证组件标签、公开类型和 Card 内嵌 Tape。宿主自带的 dev:mp-weixin 可生成微信开发态目录。