用途
本技能面向使用 Tauri 2 进行移动应用开发的场景:以 Web 技术(HTML/CSS/JS)构建用户界面,以 Rust 编写原生后端,从而开发、测试并部署跨平台的 Android/iOS 应用。当工作涉及 Tauri 2 移动开发时,可参考本技能提供的专家级指导。
主要能力
技能以任务速查表、工作流决策树和参考文档的形式组织:
- 命令速查:涵盖初始化移动端(
npm run tauri android init/npm run tauri ios init)、开发调试(npm run tauri android dev/npm run tauri ios dev)、构建产物(npm run tauri android build --apk、--aab、npm run tauri ios build)以及添加插件(npm run tauri add <plugin-name>)。 - 工作流决策树:按新项目搭建、功能添加、测试、构建部署四类任务,指引阅读对应的参考文档(setup.md、plugins.md、rust-patterns.md、frontend-patterns.md、authentication.md、iap.md、testing.md、build-deploy.md、ci-cd.md)。
- 项目结构说明:给出标准目录布局,包括
src/(前端)、src-tauri/(Cargo.toml、tauri.conf.json、src/main.rs 桌面入口、src/lib.rs 主代码与移动入口、capabilities/default.json 权限、gen/android 与 gen/apple 原生工程)。 - 配置示例:提供
tauri.conf.json与capabilities/default.json的示例,以及lib.rs的移动入口写法与#[tauri::command]命令定义示例。 - 常见问题排查:以表格列出白屏、iOS 无法连接、INSTALL_FAILED_ALREADY_EXISTS、模拟器未检测到、HMR 失效、Shell 插件 URL 报错、Google OAuth 失败、深度链接未收到、Android 安全区域 CSS 失效、Windows 上 APK 构建符号链接错误、重建后内容陈旧、Windows 上 OpenSSL 交叉编译失败等问题的对应解决方向。
使用方式
按照技能给出的决策树选择路径:新项目先阅读 references/setup.md 配置环境,并用 npm create tauri-app@latest 创建带移动目标的项目,再在 tauri.conf.json 中配置应用标识;添加功能时按需阅读插件、Rust 模式、前端集成、认证、应用内购买等参考文档;测试阶段使用模拟器/ADB 调试,并通过 adb logcat | grep -iE "(tauri|RustStdout)" 查看日志;构建部署阶段参考代码签名、应用商店与 CI/CD 相关文档。
适用场景
需要用 Web 前端技术栈配合 Rust 原生后端开发跨平台 Android 与 iOS 应用的开发者,尤其是遇到移动端环境初始化、插件集成、原生通信、认证授权、打包发布与调试排错等问题时。
限制
上述参考文档的具体内容、各问题的完整解决步骤以及各平台环境要求等细节未在本资料中提供,需查阅对应文档。资料中给出的是指导框架与示例片段,实际配置与命令请以项目自身情况及官方文档为准。
资源
- 文档:https://v2.tauri.app
- 插件:https://v2.tauri.app/plugin/
- GitHub:https://github.com/tauri-apps/tauri