主题
移动项目从创建到真机
新建 APP / 小程序工程，跑起来在手机上预览——环境准备、编译、装机都由它完成，你只需要说清要做什么，并在手机上点两下「允许」。
目标：你会拿到什么
| 你要的 | 它交给你什么 |
|---|---|
| 一个手机 App / 小程序 | 一个能编译运行的移动端工程，落在你的项目文件夹里（默认 mobile/）；同一份代码可产出安卓、iPhone、鸿蒙 App 与微信小程序、网页 |
| 手机上亲眼看到 | 电脑上一个手机大小的预览窗口；手机浏览器上能打开的预览地址；安卓手机上可直接运行，也能打出安装包 |
| 界面不用从零写 | 新工程自带爻枢 UI 组件库（125 个组件、明暗两套主题），列表、表单、弹层、卡片这些常用件现成可用 |
第一步：说一句话，它会先问清两件事
text
做个记账 App，我想先在手机上看看
做一个卖货的小程序它不会闷头开工：先跟你确认做成哪种形态（App / 小程序 / 都要）和工程放在哪个文件夹，再动手建工程。建完立刻编译一遍（编译＝把代码翻译成手机能运行的程序），确认这个新工程本身跑得起来——这一步不用你动手。
第二步：环境它自己备（首次要下载，之后复用）
移动项目要用一个专门的编译工具（HBuilderX），缺什么、装在哪、下多少，它自己判断自己下，你不用碰命令行。要下多少，取决于你这次想看到哪一步：
| 你的目标 | 它要备的东西 | 首次下载量 |
|---|---|---|
| 在电脑上看到界面（默认） | 编译工具 | Windows 约 90 MB / Mac 约 285 MB |
| 装到手机上跑起来（连数据线调试） | 安卓运行环境（含连接与调试工具、手机模拟器） | 约 2.3 GB |
| 把安装包打出来发给别人 | 打包用的一套工具与物料 | 约 1.5 GB |
只想在手机浏览器上看网页版的话，第 1 档就够，不用下 GB 级的东西。
用到相机、蓝牙、图表、二维码这类手机能力时，它还会额外备一份运行环境和能力包（几百 MB 量级）。这些都是一次下好、之后一直复用。
时间预期：从零到「手机上看效果」，首次合计通常是十几分钟量级（取决于网速与下载量）；同一个项目再次编译只要几秒到几十秒。
第三步：先在电脑上看一眼
不用等手机，先在电脑上把界面过一遍——它会自动打开一个手机大小的窗口（宽 390，常见手机屏的排布）：
- 看到的是真界面，不是设计稿；
- 你说一句要改的地方，它改完页面自动刷新，手机尺寸下哪里挤了、哪里被裁，一眼就能看出来；
- 它自己也会用这个尺寸截图核对，交付时把截图附给你。
第四步：跑到手机上看
三个办法，按「想多快看到」排序，任选：
| 方式 | 你要做什么 | 改完能立刻刷新吗 | 适合 |
|---|---|---|---|
| ① 手机浏览器打开预览地址 | 手机和电脑连同一个 Wi-Fi，在手机上打开它给你的地址 | 能 | 最快看一眼整体效果 |
| ② 连数据线直接调试 | 用数据线连上手机，在手机上允许「调试」和「安装」 | 能（它重新编译一次） | 看真机手感、试点击与滚动 |
| ③ 打一个安装包，装到手机 | 把安装包传到手机，点开安装 | 不能（重新打包再装一次） | 手机脱开电脑用、给别人试用 |
- 走 ① 时：iPhone 上还能把这个网页「添加到主屏幕」，桌面就多一个像 App 的图标；数据存在手机浏览器里，清了浏览器数据会一起清空。
- 走 ② 时：第一次连接，它会自动往手机里装一个运行环境，你会在手机上看到安装提示，点「允许」即可；之后每次改完都能直接刷新。
- 走 ③ 时：装到手机上的是一个独立 App，不需要电脑、不需要运行环境。发给别人装的注意事项见移动应用打包与发布。
要做小程序：同一份代码还能编译成微信小程序包。手机上的预览这一步在电脑的「微信开发者工具」里完成（扫码打开）——这个工具需要你自己装一次，装好后它会接上，官方下载地址。
结果判定：看到这些就算成了
| 阶段 | 算成的样子 | 不算成的样子 |
|---|---|---|
| 建工程 | 对话里给出工程位置，里面是成套的页面与配置文件 | 提示缺环境——它会接着自己装 |
| 编译 | 报「编译成功」 | 报错——它自己回去改，不用你读日志 |
| 电脑上看 | 手机大小的界面能滚动、能点，没有红色报错浮层 | 白屏、满屏报错浮层——让它继续修 |
| 手机浏览器 | 地址打开就是你的界面，滑动点击都正常 | 打不开（多数是没连同一个 Wi-Fi，见下） |
| 手机装 App | 桌面多一个图标，点开是你的界面 | 安装被拦——手机提示来源风险，允许后重试 |
常见卡点
| 现象 | 怎么回事 | 怎么办 |
|---|---|---|
| 第一次特别慢，一直显示「正在下载编译工具」 | 首次要下编译器，实测可达 8~9 分钟 | 正常，等它；同一个工程之后再编译只要几秒 |
| 要下好几 GB | 看手机形态、出安装包用的依赖本身就是 GB 级 | 它在下载前会先播报体积和预计时间，下载中也会报进度 |
| 手机打不开预览地址 | 手机和电脑不在同一个 Wi-Fi，或电脑休眠、防火墙拦了 | 连同一个 Wi-Fi 重试；仍不行就改用「打安装包装到手机」 |
| 手机上样式和电脑上不一样 | 手机 App 的界面规则更严（只能纵向排列、样式不往下继承），手机上是按这套规则渲染的 | 把手机上的截图发给它，说「手机上长这样」，它按手机规则调 |
| 手机上图标显示成方块 | 个别机型与系统版本的显示差异 | 截图发给它，让它按机型处理 |
| 提示「未知来源」「风险应用」 | 安卓对非应用商店安装包的常规提醒 | 在手机设置里允许该来源安装，再点一次 |
| 手机上的内容清空了 | 网页版把数据存在手机浏览器里，清缓存会连数据一起清 | 要长期保留或给别人用，就打安装包 |
| 小程序预览找不到入口 | 手机上的预览要在电脑的微信开发者工具里扫码 | 装一次微信开发者工具（上面的官方链接），再让它把小程序包编译一遍 |
边界（先说清楚，省你的时间）
- iPhone 装原生 App：需要一台 Mac 电脑和苹果开发者账号（苹果的规矩，不是它的限制）。iPhone 上想看效果，走网页版最快。
- 鸿蒙手机装 App：要额外装华为的开发工具，装机还需要华为开发者证书；安卓与网页版不受影响。
- 小程序手机预览：它能保证把小程序包编译出来；手机上的预览在微信开发者工具里完成。
- 网页版是预览不是成品：电脑关了就打不开，数据也存在手机浏览器里——正式拿出来用请走安装包。
- 电脑上的手机模拟器不是必需的：它跟着安卓运行环境一起装，在 Windows 上还常常起不来；直接把手机连上更快。
- 技术底座：工程基于 uni-app x（一套代码编译成安卓、iPhone、鸿蒙与小程序），界面来自爻枢 UI 组件库——后续页面与交互不用从零写。