tauri 备忘清单

$ npm install @tauri-apps/cli@latest @tauri-apps/api@latest
$ yarn upgrade @tauri-apps/cli @tauri-apps/api --latest
$ yarn up @tauri-apps/cli @tauri-apps/api
$ pnpm update @tauri-apps/cli @tauri-apps/api --latest
$ bun update @tauri-apps/cli @tauri-apps/api

use tauri::Manager;
tauri::Builder::default()
  .setup(|app| {
    #[cfg(debug_assertions)] // 仅在调试构建时包含此代码
    {
      let window = app.get_window("main").unwrap();
      window.open_devtools();
      window.close_devtools();
    }
    Ok(())
  });

[dependencies]
tauri = { version = "...", features = ["...", "devtools"] }

在文件 src-tauri/Cargo.toml 中启用 devtools Cargo 功能

Tauri 使用系统原生的 Webview，而不像 Electron 那样将完整的 Chromium 打包进应用，因此构建产物体积相当小。

但各手机厂商对于 Webview 的支持程度不同，因此在部分设备可能会出现一些兼容性问题。

• JAVA_HOME: 若无其他 JDK 环境，可以配置为 Android Studio 安装目录下的 jbr 目录。

• ANDROID_HOME: 配置为 Android SDK Location 目录下的 sdk 目录。

• NDK_HOME: 配置为 Android SDK Location 目录下的 ndk 下的 ndk 版本号目录。

Rust 默认只安装当前主机平台的编译目标（比如在 macOS 上默认就是 x86_64-apple-darwin）。 如果你想编译到其它平台或架构，就需要使用 rustup target add 安装对应的编译目标。

Android 应用打包时，一般会把编译的这几种架构的库文件全都放进 APK/ABB 中，系统会自动选择匹配的那个。

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

首先需要在开发环境下打开应用，才能进行调试。

在浏览器打开检查页面，根据浏览器不同，地址也不同，edge 浏览器是 edge://inspect，chrome 浏览器是 chrome://inspect。

在检查页面中，会显示当前运行的应用，点击 inspect 即可打开调试工具。

Android 系统要求所有 APK 必须先使用证书进行数字签名，然后才能安装到设备上或进行更新。

keytool 是 Java 数据证书管理工具。

可以在 JAVA_HOME 环境变量指向的目录下的 /bin/ 目录中找到 keytool.exe。

执行以下命令之后按照提示进行输入即可。

$ keytool -genkey -v -keystore 自定义的数据文件名称 -storetype JKS -keyalg RSA -keysize 2048 -validity 10000 -alias 自定义的证书别名

如果是要上架应用商店的，要如实填写。否则可能会导致因信息不对从而上架失败。

输入完毕，确认后，工具会要求设置密码。记住密码，后面会用到。

完成以上操作后，在当前工作目录下会生成一个 自定义的数据文件名称.keystore 文件。

$ keytool -genkey -alias android.keystore -keyalg RSA -validity 20000 -keystore android.keystore
$ zipalign -p -f -v 4 unsigned.apk release.apk
$ apksigner sign --ks android.keystore release.apk

创建 src-tauri/gen/android/keystore.properties 文件。

storePassword=数据文件密码
keyPassword=证书密码
keyAlias=自定义的证书别名
storeFile=自定义的数据文件名称.keystore

需要注意，在 windows 下，storeFile 需要 C:\\Program Files\\Android 这样的格式。

随后找到 src-tauri/gen/android/app/build.gradle.kts 文件，添加以下内容：

import java.io.FileInputStream

// ...
android {
  defaultConfig {
    // ...
  }
  signingConfigs {
    create("release") {
        val keystorePropertiesFile = rootProject.file("keystore.properties")
        val keystoreProperties = Properties()
        if (keystorePropertiesFile.exists()) {
            keystoreProperties.load(FileInputStream(keystorePropertiesFile))
        }

        keyAlias = keystoreProperties["keyAlias"] as String
        keyPassword = keystoreProperties["keyPassword"] as String
        storeFile = file(keystoreProperties["storeFile"] as String)
        storePassword = keystoreProperties["storePassword"] as String
    }
  }
  buildTypes {
    // ...
    getByName("release") {
      signingConfig = signingConfigs.getByName("release")
      // ...
    }
  }
}

配置完毕后，当执行 npm run tauri android build 时，会自动对构建的 APK/AAB 文件进行签名。

首先创建基础 Tauri 项目。

# 创建 tauri 项目
$ npm create tauri-app@latest
# 安装依赖
$ npm install

手动创建：

$ npm install -D @tauri-apps/cli@latest
# 进入项目目录初始化，按照提示输入即可
$ npx tauri init

创建后，则可以执行以下命令：

# 初始化 iOS 开发配置
$ npx tauri ios init
# 开发 iOS 应用
$ npx tauri ios dev
# 构建 iOS 应用
$ npx tauri ios build

描述 CLI 配置

应用程序系统托盘图标的配置