|
4 | 4 |
|
5 | 5 | **当前状态** |
6 | 6 | - 仅保留主分支 `main`,历史快照以 tag 方式保留:`pre-merge-master`、`pre-merge-tauri-version`、发布点 `v0.2.7`。 |
7 | | -- `src-tauri/` 已并入,Tauri 与 CRA 联动开发,端口一致为 `9754`。 |
| 7 | +- 已迁移到 Vite(保留 CRA 以便回退),Tauri 联动端口为 `9754`。 |
8 | 8 |
|
9 | 9 | **功能概览(持续完善)** |
10 | 10 | - 钱包基础:创建、助记词恢复、转账、基础数据 |
|
26 | 26 | - `.env`:本地环境变量(含 `PORT=9754`) |
27 | 27 |
|
28 | 28 | ## 环境要求 |
29 | | -- Node.js 18+ 与 npm(或 pnpm/yarn 自行替代) |
| 29 | +- Node.js ≥ 20.18(推荐 20.18.0)与 npm(或 pnpm/yarn 自行替代) |
30 | 30 | - Rust 稳定版工具链:`rustup`, `cargo` |
31 | 31 | - Windows(开发/打包):需安装 Visual Studio C++ 构建工具(Desktop development with C++) |
32 | 32 |
|
33 | 33 | ## 快速开始 |
34 | 34 | - 安装依赖: |
35 | 35 | - `npm install` |
36 | | -- 开发(浏览器预览): |
37 | | - - `npm start` → `http://localhost:9754` |
38 | | - - 由 `.env:1` 中 `PORT=9754` 指定端口 |
39 | | -- 开发(桌面版调试): |
| 36 | +- 开发(Vite 浏览器预览,推荐): |
| 37 | + - `npm run dev:vite` → `http://localhost:9754` |
| 38 | +- 开发(Tauri 桌面版调试,走 Vite): |
40 | 39 | - `npm run tauri:dev` |
41 | | - - Tauri 会执行 `beforeDevCommand: npm start` 并指向 `devUrl: http://localhost:9754` |
42 | | -- 构建(Web 静态站点): |
43 | | - - `npm run build` → 输出到 `build/` |
| 40 | +- 构建(Web 静态站点 via Vite): |
| 41 | + - `npm run build:vite` → 输出到 `dist/` |
44 | 42 | - 构建(Tauri 桌面应用): |
45 | 43 | - `npm run tauri:build` → 输出到 `src-tauri/target/release/bundle/` |
| 44 | +- 兼容保留(可选): |
| 45 | + - CRA 开发:`npm start`(端口仍取 `.env` 中 `PORT=9754`) |
| 46 | + - CRA 构建:`npm run build` → `build/` |
46 | 47 |
|
47 | 48 | ## 版本管理(自动同步) |
48 | 49 | - 版本统一以 `package.json:1` 为准,执行 `npm version` 自动同步到: |
|
64 | 65 | ## 关键配置 |
65 | 66 | - 端口(开发): |
66 | 67 | - `.env:1` 设置 `PORT=9754` |
67 | | - - `src-tauri/tauri.conf.json:1` → `build.devUrl = "http://localhost:9754"` |
| 68 | + - `src-tauri/tauri.conf.json:6` → `build.devUrl = "http://localhost:9754"` |
68 | 69 | - 构建路径(生产): |
69 | | - - CRA 输出 `build/` |
70 | | - - `src-tauri/tauri.conf.json:1` → `build.frontendDist = "../build"` |
71 | | -- 常用脚本(`package.json:1`): |
72 | | - - `start`、`build`(CRA) |
73 | | - - `tauri`、`tauri:dev`、`tauri:build`(Tauri) |
| 70 | + - Vite 输出 `dist/`(`src-tauri/tauri.conf.json:6` → `build.frontendDist = "../dist"`) |
| 71 | + - CRA 输出 `build/`(兼容保留) |
| 72 | +- 常用脚本(`package.json:33` 起): |
| 73 | + - Vite:`dev:vite`、`build:vite`、`preview:vite` |
| 74 | + - CRA:`start`、`build` |
| 75 | + - Tauri:`tauri:dev`、`tauri:build` |
74 | 76 |
|
75 | 77 | ## 环境变量与外部服务 |
76 | | -- `.env:1` 示例(已包含): |
| 78 | +- `.env:1` 示例: |
77 | 79 | - `PORT=9754`(开发端口) |
78 | | - - 其他案例变量:`REACT_APP_ganacheAddress`、`REACT_APP_ganacheRpc`、`REACT_APP_BASE_URL` |
| 80 | + - 已兼容两种风格: |
| 81 | + - CRA:`REACT_APP_ganacheAddress`、`REACT_APP_ganacheRpc`、`REACT_APP_BASE_URL` |
| 82 | + - Vite:`VITE_ganacheAddress`、`VITE_ganacheRpc`、`VITE_BASE_URL` |
| 83 | + - 代码中已提供兼容读取(见 `src/env.js:1`),可逐步迁移为 `VITE_*`。 |
79 | 84 | - 如使用 Etherscan API(合约验证/查询),请自行配置 API Key(可放入 `.env` 以 `REACT_APP_...` 形式)。 |
80 | 85 | - 访问主网/测试网请配置可靠的 RPC(Infura/Alchemy/自建节点等)。 |
81 | 86 |
|
|
0 commit comments