1、先给结论：IM 默认更倾向 Tauri 2，但有 3 类场景更该选 Qt

默认推荐：Tauri 2（文字/图片/文件为主的 IM）

原因很直接：IM 的 UI 以信息密集型为主（会话列表、消息流、搜索、设置、管理页），Web 技术栈迭代效率高；同时 Tauri 以系统 WebView 渲染 + Rust 后端二进制的形态来构建跨平台应用。(GitHub)
更关键的是，Tauri 2 提供了 capabilities/permissions，把“前端能调用哪些本地能力”做成可声明、可收敛的授权边界，IM 这种高风险输入面（富文本、链接、图片、文件、插件）非常吃这一点。(Tauri)

明显更该选 Qt 的 3 类 IM

1. 音视频通话/会议/屏幕共享是核心卖点
   WebView + WebRTC 能做，但平台差异与边界更敏感。比如 iOS 侧，WKWebView 的 getUserMedia 从 iOS 14.3 开始支持，从而让 WebRTC 在 App 内 WebView 跑起来成为可能，但你仍然需要严肃评估权限弹窗、设备枚举、前后台、回声消除等细节差异。(Apple Developer)
   Qt 的多媒体模块则提供跨平台音视频、摄像头/麦克风、屏幕或窗口采集等能力，做深度音视频链路通常更“原生”。(Qt 文檔)
2. 你要求跨平台 UI/输入/渲染高度一致，且交互很重
   Qt Quick/QML 天生为复杂交互、动画、模型视图与自绘效果服务。(Qt 文檔)
3. 你需要明确的 LTS 与长期维护窗口（典型企业级、终端侧 IM）
   Qt 6.8 起 LTS 维护周期提升到 5 年（商业用户），对“要活很久”的客户端非常关键。(Qt)

2、把 IM 拆成“3 层 12 件事”，你就知道该怎么选

无论你选哪个框架，IM 都建议拆成三层：UI 层、核心层、系统层。框架选择会影响每一层“你要自己解决多少”。

A. UI 层（高频迭代）

• 会话列表/消息流（虚拟列表、富文本、消息状态）
• 搜索（本地索引 + 服务端索引）
• 群管理/联系人/设置/多窗口

Tauri 更顺：直接复用 Web 组件体系。
Qt 更稳：一致性更强，尤其复杂交互。

B. 核心层（稳定性与正确性）

• 长连接（心跳、重连、退避、网络切换）
• 消息可靠性（至少一次/恰好一次语义、去重、顺序、回执）
• 离线存储（会话、消息、索引、媒体缓存）
• 加密（端到端、密钥管理、设备绑定）
• 大文件/断点续传/多路上传下载
• 可观测性（日志、崩溃、埋点、性能）

这里 Tauri 的 Rust 后端和 Qt 的 C++ 核心都能胜任，差别在于团队能力栈与生态依赖。

C. 系统层（“像一个真正的桌面软件”）

• 系统托盘/快捷键/开机自启
• 通知（点击跳转到具体会话）
• 文件系统权限、拖拽、剪贴板、截图
• 自动更新与签名发布

Tauri 的亮点是：系统层能力建议显式授权到窗口/WebView 上（capabilities），默认更收敛。(Tauri)
Qt 的亮点是：更传统的原生客户端工程方式，能力边界主要靠你自己的工程规范治理。

3、Tauri 2 做 IM：一套“可落地”的参考架构

3.1 架构形态

• 前端（Web） ：会话列表、消息渲染、设置页
• 本地核心（Rust） ：连接管理、消息队列、加密、SQLite、索引、文件传输调度
• IPC（前后端桥） ：只暴露必要命令，并用 capabilities/permissions 做最小授权

Tauri 的基本架构就是“Rust 后端 + WebView UI + 消息传递”。(Tauri)

3.2 为什么 capabilities 对 IM 特别重要

IM 天然会展示“外部输入内容”（对方发来的富文本、链接、图片、文件、可能还有小程序/插件），安全面非常大。Tauri 的 capabilities/permissions 用来约束“哪些窗口能调用哪些命令/权限”，可以把风险窗口（比如预览窗口、外链窗口）做成低权限甚至零权限。(Tauri)

一个典型策略（思路，不是唯一做法）：

• 主窗口：允许网络、数据库、通知、文件下载（受限目录）
• 外链/预览窗口：只允许打开链接，不允许文件系统与敏感命令
• 登录窗口：只允许 OAuth 流程相关命令

3.3 Tauri IM 的关键坑位

1. WebView 差异：字体、输入法、拖拽、媒体能力、通知表现会在各平台不一致（这是系统 WebView 模型带来的结构性成本）。
2. 权限配置复杂度：capabilities/permissions 一开始会觉得麻烦，但对 IM 这种安全敏感应用，后期会“越用越值”。(Tauri)
3. 音视频：能做，但你必须把“平台兼容性测试矩阵”前置，尤其 iOS WKWebView 的 getUserMedia/WebRTC 边界要做专门验证。(Apple Developer)

4、Qt 做 IM：一套“工业级客户端”的参考架构

4.1 UI 选 Widgets 还是 QML？

• Widgets：传统桌面控件体系，适合偏工具型 IM（企业内部、工位端）
• Qt Quick/QML：现代 UI（动画、模型视图、自绘效果），更适合体验要求高、消息卡片复杂、需要高一致性的 IM。Qt Quick/QML 的能力边界很清晰：动画、模型/视图、粒子/Shader 等都在标准库里。(Qt 文檔)

4.2 音视频/屏幕共享更好“贴近原生”

Qt Multimedia 提供音视频播放、摄像头/麦克风、录制以及屏幕/窗口采集等能力（模块化提供 QML 类型与 C++ 类）。(Qt 文檔)
如果你的 IM 未来要走“会议、共享、录制、虚拟背景”这类路线，Qt 这边的工程组织往往更顺。

4.3 Qt 的关键坑位

1. 许可证策略必须前置：Qt LTS 与商业支持很香，但你必须把许可证与分发合规先算清楚（建议拉法务/合规一起做）。
2. 工程栈门槛：C++/QML 工程化、跨平台构建与部署、性能调优，需要团队有对应能力或预留学习成本。
3. 包体与依赖：Qt 模块选得多，发布体积通常会涨，但换来的是一致性与能力上限。

5、IM 选型的“POC 验证清单”（建议 7～14 天内完成）

你不用靠争论，靠 POC 的数据就能拍板。建议按下面清单做两套最小原型（Tauri/Qt 各一）：

5.1 文字 IM 必测（两者都要）

• 10 万条消息本地库：冷启动加载、滚动流畅度、搜索耗时
• 图片/文件：断点续传、失败重试、并发下载、磁盘占用策略
• 通知：点击通知定位到会话/消息
• 多窗口：主窗口 + 图片预览 + 外链窗口，窗口间状态同步
• 崩溃恢复：重启后未发完消息恢复、草稿恢复
• 日志与诊断：关键链路埋点（连接、收发、解密、落库、渲染）

5.2 音视频 IM 必测（如果你要做）

• 摄像头/麦克风权限：首次授权、拒绝后的引导、系统设置跳转
• 前后台切换：通话是否掉线、音频路由是否异常
• 屏幕共享：窗口枚举、共享过程中性能与稳定性
• 弱网：抖动、丢包、切网（Wi-Fi/4G）下体验

如果你打算用 WebView 走 WebRTC，尤其 iOS，需要把 WKWebView 的 getUserMedia/WebRTC 行为单列出来测（从 iOS 14.3 开始支持，但细节仍需验证）。(Apple Developer)

6、最后给你一条“决策树”，直接落锤

• 你的 IM 核心是文字/图片/文件/通知/托盘，团队 Web 更强，希望包体小、迭代快、权限可控
  选 Tauri 2（再用 capabilities 把风险窗口做低权限）(GitHub)
• 你的 IM 把 音视频/会议/屏幕共享当核心卖点，或你必须 跨平台体验高度一致，或你需要 LTS 长期维护
  选 Qt（优先 Qt Quick/QML） ，并把 Qt Multimedia 与 LTS 策略纳入规划(Qt 文檔)

1. 你应该选哪条路

路线 A：create-tauri-app（推荐新项目）

适合：

• 你要从零开始
• 想最快跑起来一个可用的 Tauri 工程
• 想用官方维护的模板（稳定、省心）

优势：

• 交互式选择项目名、包管理器、框架模板
• 会自动提示你系统缺哪些依赖
• 产出结构规整，适合团队协作

路线 B：Manual Setup（Tauri CLI 初始化到现有项目）

适合：

• 你已经有一个前端项目（Vite/Next/Nuxt/SvelteKit 等）
• 你希望前端工程保持原样，只“加一层 Tauri 外壳”
• 你想完全掌控 dev server、build 命令和资源目录

优势：

• 对现有工程侵入性小
• 适配各种前端脚手架与 monorepo

2. create-tauri-app：一键创建项目

2.1 支持哪些官方模板

create-tauri-app 目前内置了这些模板（官方维护）：

• Vanilla（纯 HTML/CSS/JS，不依赖框架）
• Vue、Svelte、React、SolidJS、Angular、Preact
• Yew、Leptos、Sycamore（Rust 前端生态）
  另外也可以从 Awesome Tauri 找社区模板，或者自己扩展模板。

2.2 运行脚手架命令

在你想创建项目的目录里执行（Linux/macOS 推荐 Bash，Windows 推荐 PowerShell）：

sh <(curl https://create.tauri.app/sh)

然后跟着提示一路选下去即可。

2.3 交互式选项怎么选才不踩坑

你会看到几类关键选择：

① 项目名与 Identifier（包名）

• Project name：工程目录名与默认显示名
• Identifier：类似 com.company.app 的唯一标识（移动端更敏感，建议提前按公司域名规划）

示例提示类似：

• ? Project name (tauri-app) ›
• ? Identifier (com.tauri-app.app) ›

建议：

• 团队/产品线统一命名规则：com.company.product 或 com.company.department.product
• Identifier 一旦发版，后期迁移成本高（尤其移动端），别随便填

② 前端语言生态（这一步很关键）

create-tauri-app 会让你先选“前端开发语言/生态”：

• Rust（cargo）
• TypeScript / JavaScript（pnpm/yarn/npm/bun）
• .NET（dotnet，Blazor）

怎么选：

• 绝大多数团队：选 TypeScript/JavaScript（配 React/Vue/Svelte 等）
• 想全 Rust：选 Rust（配 Yew/Leptos/Sycamore）
• .NET 团队：选 Blazor

③ 包管理器（pnpm/yarn/npm/bun）

如果你选 TS/JS，会再问包管理器：

pnpm / yarn / npm / bun

建议：

• 新项目、单体应用：pnpm 很稳（依赖管理干净、安装快）
• 你团队已有统一：跟随团队标准最重要

④ UI Template 与 Flavor

TS/JS 会让你选 UI Template（Vanilla/Vue/Svelte/React/Solid/Angular/Preact），再选 TypeScript 或 JavaScript。

建议起步组合（最稳、最不绕）：

• UI Template：Vanilla
• UI Flavor：TypeScript
  原因很简单：先把 Tauri 心智模型跑通，再决定框架也不迟。

2.4 启动开发服务器（跑起来）

脚手架完成后，进入目录并安装/启动。文档示例给的是 cargo 安装 tauri-cli 并启动：

cd tauri-app
cargo install tauri-cli --version "^2.0.0" --locked
cargo tauri dev

执行后会发生什么：

• Rust 侧开始编译（src-tauri 后端）
• 前端 dev server 启动（如果模板是前端框架）
• 自动弹出一个桌面窗口加载你的页面

看到窗口跑起来，就说明“工具链 + WebView + Rust 编译链路”全部通了。

3. 手动接入：给现有前端项目加上 Tauri（Tauri CLI）

如果你已经有前端工程（比如 Vite/Next/Nuxt/SvelteKit），推荐这条路线。整体思路是：

1）先确保你的前端能在浏览器里跑（有 dev server）
2）安装 tauri-cli
3）告诉 Tauri：dev server URL 是什么，build 命令是什么，产物目录在哪
4）cargo tauri dev 让 Tauri 编译并打开窗口加载 dev server

3.1 以 Vite 为例创建一个前端（示例）

如果你还没有前端项目，文档用 Vite 举例：

mkdir tauri-app
cd tauri-app
npm create vite@latest .

3.2 安装 Tauri CLI

用 cargo 全局安装（文档示例）：

cargo install tauri-cli --version "^2.0.0" --locked

3.3 找到你的 dev server URL

比如 Vite 默认是：

http://localhost:5173

这个 URL 非常关键：Tauri 开发模式下就是加载它。

3.4 初始化 Tauri（生成 src-tauri）

在项目目录执行：

cargo tauri init

它会问一系列问题，典型如下：

• App name：应用名
• Window title：窗口标题
• Web assets location：静态资源目录（构建后产物）
• Dev server url：开发服务器 URL（例如 Vite 的 5173）
• Frontend dev command：前端启动命令（例如 pnpm run dev）
• Frontend build command：前端构建命令（例如 pnpm run build）

完成后，你会看到项目里多了一个 src-tauri/ 目录，这就是 Tauri 的 Rust 后端与配置中心。

3.5 启动 Tauri 开发模式

直接：

cargo tauri dev

它会：

• 编译 Rust
• 启动/连接你的前端 dev server
• 打开桌面窗口加载页面

到这里，你的“现有前端工程”就正式变成了一个 Tauri App。

4. 实战建议：如何少走弯路

4.1 先跑通“最小闭环”

强烈建议第一天只干三件事：
1）把 create-tauri-app 跑起来
2）把 cargo tauri dev 跑起来
3）确认窗口打开、能加载页面、热更新能用

闭环通了，再开始做：

• invoke 调 Rust 命令
• 文件/系统能力插件
• 打包与签名

4.2 不确定选什么就从 Vanilla 开始

Vanilla 最大价值是减少变量：

• 你只在学习 Tauri，不被框架配置分散注意力
• 后面要换 React/Vue 只是前端层替换，不影响你理解 Tauri 的核心工作方式

4.3 dev server URL 与 build 目录别填错

手动接入时最常见错误就是：

• dev server URL 填错端口/协议
• build 输出目录填错，导致打包后窗口白屏

经验：

• dev server 先在浏览器里打开确认没问题
• build 后的产物目录（dist/build/.output）要和你前端框架一致

4.4 tauri-cli 版本要对齐

文档示例明确安装 ^2.0.0，尽量保证 CLI 与项目依赖版本一致，减少“能编译但跑不起来”的奇怪兼容问题。

5. 你应该得到什么结果

不管你走哪条路线，最终你都会获得一个可运行的 Tauri App，并且开发时只需要记住一个核心命令：

cargo tauri dev

1. Tauri 是什么

Tauri 是一个用于构建跨平台桌面与移动应用的框架，目标是产出“tiny, fast binaries”（体积小、启动快、性能好）的应用包。它允许你使用任何能够编译到 HTML / JavaScript / CSS 的前端框架来构建用户界面，同时在需要时用 Rust 来编写后端逻辑（也支持通过插件提供 Swift / Kotlin 绑定）。

一句话概括： Tauri = Web UI（你选框架） + 系统 WebView（不自带浏览器内核） + Rust/原生能力（安全与性能）

2. 为什么选择 Tauri：三大优势

官方把 Tauri 的核心优势总结为三点，我用更工程化的方式展开一下，便于你做技术选型。

2.1 安全底座：Rust 带来的“默认更安全”

Tauri 基于 Rust 构建，因此天然能受益于 Rust 的内存安全、线程安全、类型安全等特性。对应用开发者而言，即使你不是 Rust 专家，也能“默认吃到”一部分安全红利。

更重要的是，Tauri 对发布版本会进行安全审计，覆盖的不仅是 Tauri 组织内的代码，也会关注其依赖的上游依赖库。它不能消除所有风险，但能把底座风险压到更可控的范围内，适合更严肃的企业/生产场景。

你在安全治理上可以怎么落地：

• 尽量把高权限操作封装为少量、明确的命令（command），减少暴露面
• 针对 invoke 入口做参数校验与权限校验
• 插件选型优先官方/高活跃社区插件，减少引入“不可审计黑盒”的概率

2.2 更小体积：利用系统原生 WebView

Tauri 的一个关键设计是：使用用户系统自带的 WebView 来渲染 UI。这意味着你的应用不需要像一些方案那样把整个浏览器引擎打包进安装包里。

因此，Tauri 应用的包体通常更小。官方提到极简应用甚至可以做到小于 600KB（具体体积会随功能、资源、平台不同而变化）。对于“分发成本”“冷启动”“增量更新”等维度，这一点非常有价值。

你在体积优化上可以进一步做：

• 前端资源按需加载、路由懒加载、压缩图片与字体
• 关闭不需要的特性与插件
• 按平台做差异化资源打包

2.3 架构更灵活：前端随意选，原生能力可扩展

Tauri 对前端框架几乎没有限制：只要你的 UI 能编译成 HTML/JS/CSS，就能塞进 Tauri。React、Vue、Svelte、Solid、Angular，甚至纯静态页面都可以。

而当你需要更深层的系统集成时，Tauri 提供了多层扩展路径：

• 直接用 invoke 做 JS 与 Rust 的桥接

• 通过 Tauri Plugins 扩展能力，并提供 Swift / Kotlin 绑定（更贴近移动端生态）

• 如果你需要更底层的窗口与 WebView 控制，还可以直接使用 Tauri 维护的底层库

  • TAO：窗口创建与事件循环
  • WRY：WebView 渲染与封装

这种分层非常“工程化”：你可以先用框架能力快速交付，后续再逐步下沉到插件或更底层库来解决复杂需求。

3. 快速开始：create-tauri-app 一键起项目

Tauri 推荐用 create-tauri-app 来创建项目。最简单的方式之一是直接执行脚本（Bash）：

sh <(curl https://create.tauri.app/sh)

创建完成后，你应该马上去看两块内容：

• Prerequisites（前置依赖）：不同平台需要不同依赖（例如 macOS 的 Xcode、Windows 的构建工具链等）
• Project Structure（项目结构）：搞清楚哪些是前端目录、哪些是 Tauri/Rust 侧目录、配置文件分别控制什么

如果你想快速对照学习，也可以参考官方示例仓库的项目结构与特性组合（例如 tauri、plugins-workspace 等示例集合）。

4. 核心工作方式：前端渲染 + 后端命令

Tauri 的开发体验通常长这样：

1. 前端负责页面与交互
2. 需要系统能力（文件、系统信息、加密、数据库、通知、窗口控制等）时
3. 前端通过 invoke 调用 Rust 侧命令（command）
4. Rust 执行并返回结果给前端渲染

一个“最小心智模型”示例：

前端（JavaScript）调用：

import { invoke } from "@tauri-apps/api/core";

const res = await invoke("greet", { name: "Tauri" });
console.log(res);

后端（Rust）提供命令：

#[tauri::command]
fn greet(name: String) -> String {
  format!("Hello, {}!", name)
}

你可以把它理解为：前端发起 RPC，Rust 侧提供受控的能力接口。这也是 Tauri 安全模型常见的落点：尽量减少命令数量、缩小参数面、做严格校验。

5. 插件体系：把“常用系统能力”模块化

真实项目里，你不可能所有能力都自己从零写。Tauri 维护了一组官方插件，同时社区也提供了大量插件可选。插件的价值在于：

• 把常见能力（如文件系统、对话框、通知、系统托盘等）标准化
• 降低跨平台差异处理成本
• 提供 Swift / Kotlin 绑定，让同一能力在移动端更自然地调用

选型建议（很实用）：

• 能用官方插件优先官方
• 社区插件重点看：维护频率、issue 响应速度、最近版本发布时间、平台覆盖情况
• 企业场景建议做一次“插件清单 + 权限与风险评估”，尤其是涉及敏感权限时

6. 什么时候 Tauri 特别合适

如果你符合下面任意一条，Tauri 通常会是很舒服的选择：

• 想用 Web 技术做 UI，但不想承受“应用包巨大”的成本
• 对安全与稳定性有要求，希望底座更可审计、更可控
• 应用需要调用大量系统能力，但希望接口边界清晰
• 需要跨平台，同时希望后端逻辑更接近系统、性能更好

反过来，如果你的应用强依赖某个特定浏览器内核特性，或者你希望所有用户环境完全一致（不受系统 WebView 差异影响），那你需要额外评估系统 WebView 的兼容边界与测试策略。

7. 总结：Tauri 的“设计哲学”

Tauri 的哲学其实很清楚：

• UI 用 Web：开发效率高、生态成熟
• 渲染用系统 WebView：体积小、分发轻
• 能力层用 Rust/原生：更安全、更稳定、更可控
• 通过插件与底层库（TAO/WRY）提供从“快速交付”到“深度定制”的梯度

如果你准备开始上手，建议路径是：

1. 用 create-tauri-app 起项目
2. 把核心 UI 跑起来
3. 把系统能力用 invoke 串起来
4. 再引入必要插件，逐步打磨工程结构与安全边界

1. 先做一个选择题：你要做哪种目标

你只需要安装与你的目标匹配的依赖：

• 只做桌面端（Windows/macOS/Linux）

  • System Dependencies + Rust
  • 如果 UI 用 React/Vue 等，再装 Node.js

• 做移动端（Android/iOS）

  • 桌面端全部依赖 + 移动端额外依赖（Android Studio / Xcode 等） (Tauri)

2. Linux：系统依赖怎么装（以 Debian/Ubuntu 为例）

Tauri 在 Linux 上需要 WebView（GTK WebKit）、构建工具链、OpenSSL、托盘/图标相关库等。不同发行版包名会有差异。 (Tauri)

Debian/Ubuntu 常用依赖（官方示例）：

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev

几个经验点：

• 看到 openssl-sys 相关报错，优先检查 libssl-dev / openssl 开发包是否安装齐全；必要时设置 OPENSSL_DIR。 (GitHub)
• 如果你在对照旧文章（Tauri v1）装 libwebkit2gtk-4.0-dev，在新系统（如 Ubuntu 24）可能会遇到仓库里没有的情况；v2 文档用的是 4.1。 (GitHub)
• 打包 Debian 包时，运行时依赖一般会包含 libwebkit2gtk-4.1-0、libgtk-3-0，托盘用到还会带 libappindicator3-1（这有助于你排查“运行环境缺库”问题）。 (Tauri)

装完 Linux 依赖后，下一步直接装 Rust。

3. macOS：Xcode 是关键

macOS 上 Tauri 依赖 Xcode 及其相关开发组件，安装来源两种：

• Mac App Store
• Apple Developer 网站下载

安装后一定要启动一次 Xcode，让它完成首次配置。 (Tauri)

仅做桌面端：装好 Xcode → 继续安装 Rust 要做 iOS：除了 Xcode，还要按 iOS 章节继续装 targets、Homebrew、CocoaPods（后面会写）。 (Tauri)

4. Windows：C++ Build Tools + WebView2（MSI 还可能需要 VBSCRIPT）

4.1 安装 Microsoft C++ Build Tools

安装 Visual Studio C++ Build Tools 时，勾选 “Desktop development with C++”（桌面 C++ 开发）。 (Tauri)

4.2 安装 WebView2 Runtime

Tauri 在 Windows 用 Microsoft Edge WebView2 渲染内容。

• Windows 10（1803+）/ Windows 11 通常已预装 WebView2，可跳过安装步骤
• 如果缺失，安装 WebView2 Runtime（文档建议 Evergreen Bootstrapper） (Tauri)

4.3 只有当你要打 MSI 安装包时：检查 VBSCRIPT

当你的 tauri.conf.json 使用 "targets": "msi" 或 "targets": "all"，构建 MSI 可能会依赖系统的 VBSCRIPT 可选功能；若遇到类似 light.exe 执行失败，可去 Windows 可选功能里启用 VBSCRIPT。 (Tauri)

做完 Windows 依赖后，下一步装 Rust。

5. Rust：所有平台都必须装（用 rustup）

Tauri 基于 Rust，因此开发必装 Rust 工具链。官方推荐 rustup： (Tauri)

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

安装后建议：

• 关闭并重开终端（有时需要重启系统）让 PATH 生效 (Tauri)

6. Node.js：只有当你用 JS 前端生态时才需要

如果你的 UI 用 React/Vue/Svelte 等 JavaScript 生态，就安装 Node.js（建议 LTS），并验证：

node -v
npm -v

想用 pnpm / yarn 等，可以按需启用 corepack：

corepack enable

同样建议重开终端确保命令可用。 (Tauri)

7. 移动端额外依赖：Android / iOS

7.1 Android（跨平台都能做）

核心步骤：

1. 安装 Android Studio
2. 设置 JAVA_HOME（指向 Android Studio 的 JBR）
3. 用 SDK Manager 安装：Platform、Platform-Tools、NDK（Side by side）、Build-Tools、Command-line Tools
4. 设置 ANDROID_HOME、NDK_HOME
5. 用 rustup 添加 Android targets (Tauri)

环境变量示例（Linux/macOS）：

export JAVA_HOME=/opt/android-studio/jbr
export ANDROID_HOME="$HOME/Android/Sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

添加 targets：

rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

常见坑：

• tauri android init 报 NDK_HOME environment variable isn't set：基本就是 NDK 没装或环境变量没指到正确 NDK 目录。 (GitHub)

7.2 iOS（仅 macOS）

iOS 开发必须是 macOS + Xcode（注意是 Xcode 本体，不是只装 Command Line Tools）。 (Tauri)

步骤：

1. rustup 添加 iOS targets

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

2. 安装 Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. 安装 CocoaPods

brew install cocoapods

完成后就可以进入创建项目/初始化移动端的流程。 (Tauri)

8. 快速自检清单（装完别急着开写代码）

你可以用这几个“最小验证”确认环境 OK：

• Rust 是否可用：rustc -V、cargo -V
• Node 是否可用（如需要）：node -v、npm -v
• Windows：是否装了 C++ Build Tools；WebView2 是否存在（Win10 1803+ 通常无需额外装） (Tauri)
• Linux：libssl-dev / WebKitGTK dev 包是否装齐（遇到 openssl-sys 错误优先查这块） (GitHub)
• Android：ANDROID_HOME、NDK_HOME 是否指向正确目录 (GitHub)