Files
um-react/docs/getting-started.zh.md
T
鲁树人 b142c1ba34 chore: dep pkg upgrade
- Updated Node version in Dockerfile and .npmrc.
- Upgraded various dependencies in package.json, including react-dropzone, react-router, and eslint.
- Added pnpm-workspace.yaml for workspace management.
- Adjusted TypeScript configurations and test utilities for compatibility.
- Enhanced documentation for installation instructions and TypeScript toolchain.
2026-10-21 10:51:06 +09:00

1.9 KiB
Raw Blame History

新手上路

该文档描述了如何本地运行或编译生产版本的「Unlock Music 音乐解锁」。

安装依赖

  • 安装 Node 24.22.0;pnpm 也会根据 package.json 中的 devEngines.runtime 自动获取该版本。
  • 安装/激活项目指定的 pnpm 1 :corepack prepare [email protected] --activate
  • 安装软件依赖:pnpm i --frozen-lockfile

本地运行

💡 你需要先完成「安装依赖」部分。

pnpm start

然后根据提示打开项目运行页面即可。

构建生产版本

💡 你需要先完成「安装依赖」部分。

pnpm build

如果需要预览构建版本,运行 pnpm preview 然后打开项目预览页面即可。

TypeScript 工具链

编译和 ESLint 统一使用 TypeScript 6.x,暂不升级到 TypeScript 7。

打包 .zip

建议在 Linux 环境下执行,可参考 .drone.yml CI 文件。

  1. 确保上述的构建步骤已完成。
  2. 确保 python3 已安装。
  3. 执行下述代码
    python3 -m zipfile -c um-react.zip dist/.
    

打包 win64 单文件

利用 Windows 系统自带的 Edge WebView2 组件 和 wry 进行一个单文件的打包。

大部分 Windows 10 或以上版本的操作系统已经集成了 WebView2 运行时。若无法正常启动,请下载并安装 Edge WebView2 运行时。

其它系统兼容性未知。

  1. 确保你现在在 linux-amd64 环境下。
  2. 确保上述的 um-react.zip 构建已完成。
  3. 执行下述代码
    ./scripts/make-win64.sh
    
  4. 等待提示 [Build OK] 即可。

  1. 参考 pnpm 说明「使用 Corepack 安装」。 ↩︎