效果图
安装 bun
npm install -g bun配置阿里源
在 C:\Users\huyun 个人用户目录新建文件 .bunfig.toml
[install]
registry = "https://registry.npmmirror.com/"先安装 tauri 依赖
Rust 版本需要 ≥ 1.75
rustc --version
# rustup update 升级到最新稳定版更新不了，可以设置 rustup 阿里云源
运行以下命令来添加阿里云的crates.io索引
rustup set profile minimal
rustup update
rustup component add rust-src修改Rustup的配置文件，指向阿里云的源。首先，找到Rustup的配置文件（通常位于C:\Users\<你的用户名>\.cargo\config.toml）。如果没有这个文件，你可以手动创建一个。
[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = "git://mirrors.ustc.edu.cn/crates.io-index"找个目录打开 cmd 执行安装 tauri
bun create tauri-app@latest
Make sure you have installed the prerequisites for your OS: https://tauri.app/start/prerequisites/, then run:
cd huyanba-app
bun install
bun run tauri android init
For Desktop development, run:
bun run tauri dev
For Android development, run:
bun run tauri android dev执行命令
cd huyanba-app
bun installTauri 仅 2.0.0 及以上稳定版本支持安卓编译，1.x 版本无移动端能力
查看 tauri 版本
bun tauri --version安装Android Studio，并安装相应插件
| 组件 | 要求版本 | 说明 |
|---|---|---|
| Android SDK Platform（编译 SDK） | Android 14.0（UpsideDownCake / API 34） | ✅ 唯一推荐的编译版本，Tauri 2.0 安卓层代码依赖 API 34 的特性，低于 34 编译不通过，高于 34（比如 API35/Android 15）需要升级到 2.1 开发版，目前不稳定 |
| SDK Build Tools | 34.0.0 | 和 API34 匹配的最新稳定版，不要用 35.x 系列 |
| NDK（交叉编译核心依赖） | 26.1.10909125 | ✅ 官方唯一测试通过的最稳定版本，仅支持 25.x ~ 26.x 大版本，绝对不要用 27 及以上版本 |
| Android SDK Command-line Tools | latest（最新版） | 这个工具更新一般不会有兼容性问题，直接装最新即可 |
| JDK | 编译安卓代码要求 JDK17，Gradle 8.8 + 运行要求 JDK21 | 安卓代码编译必须用 JDK17，Gradle 本身如果是 8.8 及以上版本可以额外装 JDK21，或者配置 Gradle 强制用 JDK17 运行 |
| cmake | 3.10.2 | 用的这个版本，测试没问题 |
勾选 show package details会出现具体的版本号
环境变量配置
# 设置 JAVA_HOME
# 安卓构建必须用 JDK17
set JAVA_HOME=D:\software\jdk-17.0.16
set PATH=%JAVA_HOME%\bin;%PATH%
# 设置 Android SDK 和 NDK 路径
set ANDROID_HOME=%LOCALAPPDATA%\Android\Sdk
set ANDROID_NDK_HOME=%ANDROID_HOME%\ndk\26.1.10909125 # 替换为实际 NDK 版本
set PATH=%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\cmdline-tools\13.0\bin;%PATH%添加 Rust Android 编译目标
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android配置 Cargo 编译器链接器 C:\Users\huyun\.cargo\config.toml
[target.aarch64-linux-android]
linker = "$NDK_HOME/toolchains/llvm/prebuilt/windows-x86_64/bin/aarch64-linux-android24-clang.cmd"安装后运行以下命令验证环境是否满足
bun tauri info
[✔] Environment
- OS: Windows 10.0.26200 x86_64 (X64)
✔ WebView2: 147.0.3912.86
✔ MSVC: Visual Studio 生成工具 2022
✔ rustc: 1.95.0 (59807616e 2026-04-14)
✔ cargo: 1.95.0 (f2d3ce0bd 2026-03-21)
✔ rustup: 1.29.0 (28d1352db 2026-03-05)
✔ Rust toolchain: stable-x86_64-pc-windows-msvc (default)
- node: 22.15.1
- pnpm: 10.13.1
- yarn: 1.22.22
- npm: 11.6.0
- bun: 1.3.9
[-] Packages
- tauri 🦀: 2
- tauri-build 🦀: No version detected
- wry 🦀: No version detected
- tao 🦀: No version detected
- @tauri-apps/api ⱼₛ: 2.11.0
- @tauri-apps/cli ⱼₛ: 2.11.0
[-] Plugins
- tauri-plugin-opener 🦀: 2
- @tauri-apps/plugin-opener ⱼₛ: 2.5.3
[-] App
- build-type: bundle
- CSP: unset
- frontendDist: ../dist
- devUrl: http://localhost:1420/
- framework: React
- bundler: Vite初始化安卓项目
bun tauri android init生成 android 项目路径为
src-tauri\gen\android
gradle在国内下载太慢，所以会连接超时,可以更换国内源
编辑android\gradle\wrapper\gradle-wrapper.properties
修改distributionUrl为国内镜像站的地址
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.14.3-bin.zip编译 apk， 以管理员身份运行终端，不然会报错Windows 系统默认禁止普通用户创建符号链接
bun tauri android run上面编译的是 debug 版不需要证书即可在手机中安装，测试 arm 版的 apk 可以安装
For more on this, please refer to https://docs.gradle.org/8.14.3/userguide/command_line_interface.html#sec:command_line_warnings in the Gradle documentation.
Finished 4 APKs at:
D:\git\huyunan\huyanba-app\src-tauri\gen/android\app/build/outputs/apk/arm64/debug/app-arm64-debug.apk
D:\git\huyunan\huyanba-app\src-tauri\gen/android\app/build/outputs/apk/arm/debug/app-arm-debug.apk
D:\git\huyunan\huyanba-app\src-tauri\gen/android\app/build/outputs/apk/x86/debug/app-x86-debug.apk
D:\git\huyunan\huyanba-app\src-tauri\gen/android\app/build/outputs/apk/x86_64/debug/app-x86_64-debug.apk