# TauriAndroid

**Repository Path**: tauri-interactive-multimedia/tauri-android

## Basic Information

- **Project Name**: TauriAndroid
- **Description**: tauri2导出android
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TauriAndroid

Tauri 2 + Vue 3 项目，支持导出 Windows 和 Android 平台应用。

## 项目介绍

本项目基于 Tauri 2 和 Vue 3 构建，展示了如何使用 Tauri 框架开发跨平台桌面和移动应用。项目包含完整的构建流程，支持导出 Windows 可执行文件和 Android APK。

## 环境搭建

### 1. 基础环境

- Node.js 18+
- Rust 1.75+
- Visual Studio 2022（Windows 平台）
- Android Studio（Android 平台）
- Java JDK 21+

### 2. 依赖安装

```bash
# 安装项目依赖
npm install

# 安装 Rust Android 目标平台
rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android
```

### 3. 配置文件

项目已包含 `.npmrc` 文件，解决代理下载问题：

```ini
registry=https://registry.npmmirror.com/
disturl=https://registry.npmmirror.com/-/binary/node
electron_mirror=https://npmmirror.com/mirrors/electron/
electron-builder-binaries_mirror=https://registry.npmmirror.com/-/binary/electron-builder-binaries/
```

## 开发流程

### 启动开发服务器

```bash
npm run tauri dev
```

### 代码结构

- `src/` - Vue 前端代码
- `src-tauri/` - Tauri 后端代码
  - `src/` - Rust 源码
  - `gen/android/` - Android 构建目录

## 构建流程

### 1. Windows 平台构建

```bash
npm run tauri build
```

构建产物位于 `src-tauri/target/release/` 目录，生成的可执行文件可直接运行。

### 2. Android 平台构建

#### 初始化 Android 项目

```bash
npm run tauri -- android init
```

#### 构建 Android APK

```bash
npm run tauri -- android build
```

构建产物位于 `src-tauri/gen/android/app/build/outputs/apk/universal/release/` 目录。

## Android 签名流程

### 1. 生成签名密钥

```bash
& "C:\Program Files\Android\Android Studio\jbr\bin\keytool.exe" -genkey -v -keystore keystore/tauriandroid.keystore -alias tauriandroid -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=tauriandroid, OU=tauriandroid, O=tauriandroid, L=Beijing, ST=Beijing, C=CN" -storepass 123456 -keypass 123456
```

### 2. 配置签名信息

在 `src-tauri/gen/android/keystore.properties` 文件中配置签名信息：

```properties
storePassword=123456
keyPassword=123456
keyAlias=tauriandroid
storeFile=../keystore/tauriandroid.keystore
```

### 3. 签名 APK

```bash
cd src-tauri/gen/android/app/build/outputs/apk/universal/release
& "C:\Users\66964\AppData\Local\Android\Sdk\build-tools\36.1.0\apksigner.bat" sign --ks "d:\TauriAndroid\tauriandroid\keystore\tauriandroid.keystore" --ks-key-alias tauriandroid --ks-pass pass:123456 --key-pass pass:123456 --out app-universal-release-signed.apk app-universal-release-unsigned.apk
```

签名后的 APK 可直接安装到 Android 设备。

## 注意事项

1. **identifier 命名**：在 `tauri.conf.json` 中配置的 identifier 不要使用 `-` 或 `_` 等字符，避免在不同平台构建时出现冲突。

2. **Gradle 下载**：如果 Gradle 下载缓慢，可先下载 `gradle-8.14.3-bin.zip` 文件，放置到 `src-tauri/gen/android/gradle/wrapper/` 目录下，并修改 `gradle-wrapper.properties` 文件：

   ```properties
   distributionUrl=gradle-8.14.3-bin.zip
   ```

3. **环境变量**：确保 Java 和 Android SDK 的环境变量已正确配置。

4. **签名安全**：生产环境中应使用更复杂的密码和密钥别名，并妥善保管签名文件。

## 参考资料

- [Tauri 官方文档](https://tauri.app/)
- [Vue 3 官方文档](https://v3.vuejs.org/)
- [Tauri2 导出 Android 详细教程](https://blog.csdn.net/qq_17523181/article/details/157506030)

## 许可证

MIT License