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

Task Command

Init mobile npm run tauri android init / npm run tauri ios init

Dev Android npm run tauri android dev

Dev iOS npm run tauri ios dev

Build APK npm run tauri android build --apk

Build AAB npm run tauri android build --aab

Build iOS npm run tauri ios build

Add plugin npm run tauri add <plugin-name>

Workflow Decision Tree

New Project Setup

• Read references/setup.md for environment configuration

• Run npm create tauri-app@latest with mobile targets

• Configure tauri.conf.json with app identifier

Adding Features

• Native functionality: Read references/plugins.md

• Rust commands/state: Read references/rust-patterns.md

• Frontend integration: Read references/frontend-patterns.md

• Authentication/OAuth: Read references/authentication.md

• In-app purchases: Read references/iap.md

Testing

• Emulator/ADB debug: Read references/testing.md

• Use adb logcat | grep -iE "(tauri|RustStdout)" for logs

Building & Deployment

• Code signing & stores: Read references/build-deploy.md

• CI/CD pipelines: Read references/ci-cd.md

Project Structure

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

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

capabilities/default.json

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

lib.rs (Mobile Entry)

#[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

Problem Solution

White screen Check JS console, verify devUrl , check capabilities

iOS won't connect Use --force-ip-prompt , select IPv6

INSTALL_FAILED_ALREADY_EXISTS adb uninstall com.your.app

Emulator not detected Verify adb devices , restart ADB

HMR not working Configure vite.config.ts with TAURI_DEV_HOST

Shell plugin URL error Use opener plugin instead (openUrl() )

Google OAuth fails Google blocks WebView; use system browser flow

Deep link not received Check scheme in tauri.conf.json, init plugin

Safe area CSS fails on Android env() not supported in WebView; use JS fallback

Windows APK build symlink error Enable Developer Mode or copy .so files manually

Stale content after rebuild .so compiled in dev mode embeds old assets; rebuild with tauri android build --debug or apply Kotlin workaround (see build-deploy.md)

OpenSSL cross-compile fails on Windows Install Strawberry Perl for vendored OpenSSL; see build-deploy.md

See references/testing.md for detailed troubleshooting.

Resources

• Docs: https://v2.tauri.app

• Plugins: https://v2.tauri.app/plugin/

• GitHub: https://github.com/tauri-apps/tauri