AgentSkillsCN

tauri2-mobile

为Tauri 2移动应用的开发、测试与部署提供专业指导。当您使用Tauri 2进行Android/iOS移动应用开发时，可选用此技能，包括项目搭建、Rust后端模式、前端集成、插件使用（生物识别、地理位置、通知、IAP）、模拟器/ADB测试、代码签名，以及Play Store/App Store的发布流程。

SKILL.md
--- frontmatter
name: tauri2-mobile
description: Expert guidance for developing, testing, and deploying mobile applications with Tauri 2. Use when working with Tauri 2 mobile development for Android/iOS, including project setup, Rust backend patterns, frontend integration, plugin usage (biometric, geolocation, notifications, IAP), emulator/ADB testing, code signing, and Play Store/App Store deployment.

Tauri 2 Mobile Development

Build cross-platform mobile apps with Tauri 2 using web technologies (HTML/CSS/JS) for UI and Rust for native backend.

Quick Reference

TaskCommand
Init mobilenpm run tauri android init / npm run tauri ios init
Dev Androidnpm run tauri android dev
Dev iOSnpm run tauri ios dev
Build APKnpm run tauri android build --apk
Build AABnpm run tauri android build --aab
Build iOSnpm run tauri ios build
Add pluginnpm run tauri add <plugin-name>

Workflow Decision Tree

New Project Setup

  1. •Read references/setup.md for environment configuration
  2. •Run npm create tauri-app@latest with mobile targets
  3. •Configure tauri.conf.json with app identifier

Adding Features

Testing

  • •Emulator/ADB debug: Read references/testing.md
  • •Use adb logcat | grep -iE "(tauri|RustStdout)" for logs

Building & Deployment

Project Structure

code
my-app/
├── src/                          # Frontend
├── src-tauri/
│   ├── Cargo.toml
│   ├── tauri.conf.json           # Main config
│   ├── src/
│   │   ├── main.rs               # Desktop entry (don't modify)
│   │   └── lib.rs                # Main code + mobile entry
│   ├── capabilities/
│   │   └── default.json          # Permissions
│   └── gen/
│       ├── android/              # Android Studio project
│       └── apple/                # Xcode project

Essential Configuration

tauri.conf.json

json
{
  "$schema": "https://schema.tauri.app/config/2",
  "productName": "MyApp",
  "identifier": "com.company.myapp",
  "bundle": {
    "iOS": { "minimumSystemVersion": "14.0" },
    "android": { "minSdkVersion": 24 }
  }
}

capabilities/default.json

json
{
  "identifier": "default",
  "windows": ["main"],
  "permissions": ["core:default"]
}

lib.rs (Mobile Entry)

rust
#[cfg_attr(mobile, tauri::mobile_entry_point)]
pub fn run() {
    tauri::Builder::default()
        .plugin(tauri_plugin_opener::init())
        .plugin(tauri_plugin_deep_link::init())
        .invoke_handler(tauri::generate_handler![greet])
        .run(tauri::generate_context!())
        .expect("error");
}

#[tauri::command]
fn greet(name: &str) -> String {
    format!("Hello, {}!", name)
}

Common Issues

ProblemSolution
White screenCheck JS console, verify devUrl, check capabilities
iOS won't connectUse --force-ip-prompt, select IPv6
INSTALL_FAILED_ALREADY_EXISTSadb uninstall com.your.app
Emulator not detectedVerify adb devices, restart ADB
HMR not workingConfigure vite.config.ts with TAURI_DEV_HOST
Shell plugin URL errorUse opener plugin instead (openUrl())
Google OAuth failsGoogle blocks WebView; use system browser flow
Deep link not receivedCheck scheme in tauri.conf.json, init plugin
Safe area CSS fails on Androidenv() not supported in WebView; use JS fallback
Windows APK build symlink errorEnable Developer Mode or copy .so files manually

See references/testing.md for detailed troubleshooting.

Resources