docs: updated pnpm notes + sdk contribution note
This commit is contained in:
parent
2841b5b333
commit
772666c770
39
README.MD
39
README.MD
@ -1,10 +1,14 @@
|
|||||||
# Getting started
|
# Getting started
|
||||||
|
|
||||||
|
前提: [安装 pnpm][install-pnpm],推荐 `corepack` 方法。
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
pnpm i
|
pnpm i
|
||||||
pnpm start
|
pnpm start
|
||||||
```
|
```
|
||||||
|
|
||||||
|
[install-pnpm]: https://pnpm.io/zh/installation
|
||||||
|
|
||||||
## 架构
|
## 架构
|
||||||
|
|
||||||
- 浏览器主线程: 渲染界面,处理 UI 更新
|
- 浏览器主线程: 渲染界面,处理 UI 更新
|
||||||
@ -22,9 +26,44 @@ pnpm start
|
|||||||
|
|
||||||
满足上述条件后发起 Pull Request,仓库管理员审阅后将合并到主分支。
|
满足上述条件后发起 Pull Request,仓库管理员审阅后将合并到主分支。
|
||||||
|
|
||||||
|
## 基于 libparakeet SDK 开发
|
||||||
|
|
||||||
|
`libparakeet-js` 编译目前需要 Linux 环境,请参考[仓库说明][libparakeet-js-doc]。
|
||||||
|
|
||||||
|
[libparakeet-js-doc]: https://github.com/parakeet-rs/libparakeet-js/blob/main/README.MD
|
||||||
|
|
||||||
|
### 初次构建
|
||||||
|
|
||||||
|
- 进入上层目录 `cd ..`
|
||||||
|
- 克隆 `libparakeet-js` 仓库 (目前需要 Linux 环境, Windows 下推荐使用 WSL2)
|
||||||
|
- `git clone --recurse-submodules https://github.com/parakeet-rs/libparakeet-js.git`
|
||||||
|
- 进入目录 `cd libparakeet-js`
|
||||||
|
- 如果需要更新 `submodule`:
|
||||||
|
- `git submodule update --init --recursive`
|
||||||
|
- 运行 `./build.sh -j 4` 进行编译
|
||||||
|
- 编译 `js-sdk`:
|
||||||
|
- 进入 `npm` 目录: `cd npm`
|
||||||
|
- 安装依赖: `pnpm i --frozen-lockfile`
|
||||||
|
- 构建: `pnpm build`
|
||||||
|
|
||||||
|
### 做出更改
|
||||||
|
|
||||||
|
做出更改后,参考上面的内容进行重新编译
|
||||||
|
|
||||||
|
### 应用 SDK 更改
|
||||||
|
|
||||||
|
将构建好的 SDK 直接嵌入到当前前端项目:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
pnpm link ../libparakeet-js/npm
|
||||||
|
```
|
||||||
|
|
||||||
|
※ 建立 PR 时,请先提交 SDK PR 并确保你的更改已合并。
|
||||||
|
|
||||||
## TODO
|
## TODO
|
||||||
|
|
||||||
- [ ] #6 文件拖放 (利用 `react-dropzone`?)
|
- [ ] #6 文件拖放 (利用 `react-dropzone`?)
|
||||||
- [ ] 各类算法 [追踪 `crypto` 标签](https://git.unlock-music.dev/um/um-react/issues?labels=67)
|
- [ ] 各类算法 [追踪 `crypto` 标签](https://git.unlock-music.dev/um/um-react/issues?labels=67)
|
||||||
- [ ] #7 简易元数据编辑器
|
- [ ] #7 简易元数据编辑器
|
||||||
- [ ] #8 添加单元测试
|
- [ ] #8 添加单元测试
|
||||||
|
- [ ] #2 解密内容探测 (解密过程)
|
||||||
|
Loading…
Reference in New Issue
Block a user