UNPKG

weapp-vite

Version:

weapp-vite 一个现代化的小程序打包工具

vite.icebreaker.top

weapp-vite/weapp-vite

88 lines (62 loc) • 2 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
# Getting Started ## CLI 别名 `weapp-vite` 和 `wv` 完全等价。 ```bash weapp-vite build wv build ``` ## 最小工作流 ### 1. 准备支持文件 ```bash weapp-vite prepare ``` 如果项目里存在 `.weapp-vite` 支持文件缺失或过期，这一步会更新它们。 ### 2. 本地开发 ```bash weapp-vite dev weapp-vite dev --open ``` 如果需要打开微信开发者工具并把日志桥接回终端，可使用： ```bash weapp-vite dev --open weapp-vite ide logs --open ``` ### 3. 构建 ```bash weapp-vite build ``` ### Web 预览与构建 项目根目录准备引用 `/@weapp-vite/web/entry` 的 `index.html` 后，可以复用原有小程序源码： ```bash wv dev -p web --host wv build -p web ``` 推荐将两条命令分别固定为 `dev:web` 和 `build:web` scripts。`web` 是规范平台名，`h5` 仅作为向后兼容别名保留。Web runtime 适合浏览器兼容验证，但不替代微信 DevTools 或真机验收。 ### 4. 截图验收 ```bash weapp-vite screenshot --project ./dist/build/mp-weixin --page pages/index/index --output .tmp/acceptance.png --json ``` ### 5. 启动 MCP ```bash weapp-vite mcp ``` ## 何时先读哪些文档 - 命令、脚手架、AI 工作流：[`ai-workflows.md`](./ai-workflows.md) - 目录结构、`AGENTS.md`、`.weapp-vite`：[`project-structure.md`](./project-structure.md) - `vite.config.ts` 与 `weapp` 配置：[`weapp-config.md`](./weapp-config.md) - wevu 页面/组件/store 写法：[`wevu-authoring.md`](./wevu-authoring.md) - Vue SFC 宏、`definePageMeta`、`v-model`：[`vue-sfc.md`](./vue-sfc.md) ## 常见命令 ```bash weapp-vite dev weapp-vite dev --open weapp-vite build wv dev -p web --host wv build -p web weapp-vite open weapp-vite preview --project ./dist/build/mp-weixin weapp-vite ide preview --project ./dist/build/mp-weixin weapp-vite ide logs --open weapp-vite screenshot --project ./dist/build/mp-weixin --page pages/index/index --output .tmp/acceptance.png --json weapp-vite mcp ```