怎么用 tauri 创建编译 android 应用程序

tauri 是一个基于 Rust 构建的跨平台桌面应用框架，同时也支持编译生成移动端应用，很多开发者会选择用它来开发安卓应用程序。下面我们就一步步讲解完整的操作流程。

前期环境准备

在开始编译安卓应用前，需要先准备好所有依赖环境，缺少任何一个都可能导致编译失败。

• 安装 Rust 开发环境，确保版本符合 tauri 的最新要求，可通过 rustup 工具管理版本
• 安装 Node.js 环境，用于前端项目的依赖管理和构建
• 安装安卓开发相关的 SDK、NDK 以及对应的构建工具，配置好 ANDROID_HOME 环境变量
• 安装 tauri 的命令行工具，方便后续执行项目创建和编译命令

创建 tauri 项目

如果是新项目，可以直接使用 tauri 提供的初始化命令创建项目，命令如下：

# 创建新的 tauri 项目
npm create tauri-app@latest
# 进入项目目录
cd your-project-name
# 安装项目依赖
npm install

如果已经有现成的前端项目，也可以手动集成 tauri，在项目根目录执行 tauri 初始化命令，按照提示配置即可。

配置安卓编译参数

要让 tauri 支持安卓编译，需要调整项目的配置文件，主要修改 tauri.conf.json 中的移动端相关配置。示例配置如下：

{
  "tauri": {
    "bundle": {
      "android": {
        "package_name": "com.example.tauri_app", // 替换为自己的应用包名
        "version_code": 1,
        "version_name": "1.0.0",
        "permissions": [
          "android.permission.INTERNET" // 根据应用需求添加权限
        ]
      }
    },
    "allowlist": {
      "all": true // 根据需求调整允许调用的 API 列表
    }
  }
}

执行安卓编译命令

配置完成后，就可以执行编译命令生成安卓安装包了，命令如下：

# 编译调试版本的安卓应用
npm run tauri android build --debug
# 编译发布版本的安卓应用，生成可上架的 apk 或 aab 文件
npm run tauri android build --release

编译完成后，生成的文件会存放在项目的 src-tauri/gen/android/app/build/outputs 目录下，其中 debug 版本用于测试，release 版本可用于正式发布。

常见问题排查

• 如果编译时提示 NDK 版本不匹配，需要安装 tauri 官方推荐的 NDK 版本，并在配置中指定对应路径
• 如果打包后的应用无法联网，检查是否在配置中添加了 INTERNET 权限
• 如果前端资源加载失败，确认前端项目的构建输出路径和 tauri 配置中的资源路径一致

tauriandroid_applicationRustfrontend_frameworkapk_packaging修改时间：2026-05-31 06:06:22