快速开始

安装 CLI、生成项目骨架,并完成第一次多端构建。

安装

在 Bun workspace 或独立项目中使用以下命令同时安装框架与编译器:

bash
bun add transone transone-cli

仅把编译器作为开发依赖安装:

bash
bun add -d transone-cli

创建项目骨架

在空目录执行transone create:生成 package.json(dev / build / typecheck 脚本)、transone.config.ts、tsconfig.json 与入口 src/main.ts。若目录已存在同名文件,命令拒绝覆盖并报错。

bash
mkdir my-app && cd my-app
transone create

bun dev            # 等价于 transone dev,启动开发服务器
bun run build      # 等价于 transone build,默认构建 web 目标端

入口约定

src/main.ts 导出名为app 的应用实例:createApp({ root, document }) 返回的对象含renderHtmlDocument,并在模块作用域调用app.mount()。这份源码同时驱动 SSR 文档壳与客户端挂载。

构建多端

bash
transone build --target web            # H5 静态站点(已实现)
transone build --target mp-weixin     # 微信小程序原生工程(已实现)
transone build --target mp-alipay     # 阿里小程序原生工程(已实现)
transone build --target mp-bytedance  # 字节小程序原生工程(已实现)
快速失败
未实现的 Target 会在编译期快速报错并给出路线图阶段,而不是产出残缺产物。

下一步