25.4 移动端原生能力调用 - 人人都会AI编程

Tauri 的移动端支持（Android 和 iOS）并不是简单地“把桌面版搬过去”，而是延续了相同的设计哲学：用系统 WebView 渲染 UI，用 Rust 编写跨平台逻辑，再通过插件机制调用平台原生能力。 掌握这套调用流程，你就能在移动端同样享受轻量、安全和高性能的开发体验。

1. 架构一瞥：Rust 是桥梁，不是牢笼

在移动端，Tauri 应用的组成依然是：

前端：运行在 WebView 中的 HTML/CSS/JS，负责界面。
Rust 核心：编译成本地库（.so / .dylib），随应用打包，处理跨平台业务逻辑。
原生端：Android 的 Kotlin/Java、iOS 的 Swift/Objective-C，负责调用平台特有功能（如相机、传感器、蓝牙等）。

Rust 通过 FFI 与原生端通信，前端则通过 invoke API 调用 Rust 命令。所以调用原生能力主要有两条路：

Rust 插件（推荐）：在 Rust 中封装逻辑，必要时通过 Tauri 的插件系统桥接到原生代码。
前端直调原生（高级）：通过 Tauri 提供的 JS 绑定，直接触发原生代码执行。

2. 插件系统：调用原生能力的标准方式

Tauri 的插件机制是打通移动端原生能力的“官方通道”。一个插件通常包含三部分：

Rust 侧：定义命令、管理状态、调用原生 FFI。
原生侧：Android（Kotlin/Java）或 iOS（Swift）的实现。
前端绑定：可选的 JS/TS 包装，方便前端调用。

使用官方插件
官方提供了许多常用插件，例如：

@tauri-apps/plugin-fs：文件系统访问
@tauri-apps/plugin-camera：相机调用
@tauri-apps/plugin-geolocation：地理位置
@tauri-apps/plugin-notification：本地通知

以相机为例，安装后前端仅需：

import { takePicture } from '@tauri-apps/plugin-camera';
const photo = await takePicture();

在移动端，takePicture 会通过 Rust 插件桥接到 Android 的 CameraX 或 iOS 的 UIImagePickerController。权限请求、生命周期管理等细节都由插件内部处理，你无需手动编写原生代码。

自定义插件（需要一定原生知识）
当官方插件不满足需求时，你可以自己编写插件。步骤如下（以 Android 为例，iOS 同理）：

用 Tauri CLI 创建插件模板：npx tauri plugin new --android my-plugin
在 android/src/main/java/<package>/MyPlugin.kt 中实现功能，例如：

class MyPlugin : TauriPlugin() {
    override fun onRegister() {
        // 注册原生方法供 Rust 调用
    }
}

在 Rust 侧通过 plugin::Builder 注册并暴露命令，前端即可像调用普通命令一样使用。

插件系统让你能用最少的原生代码工作量，将移动端能力集成进跨平台代码库中。

3. 直接通过 Rust 命令调用平台 API

对于简单的原生调用（如获取设备信息），不一定需要完整的插件。你可以在 Rust 侧定义一个命令，然后直接在 Rust 里写平台条件编译的代码：

#[tauri::command]
fn get_device_info() -> String {
    #[cfg(target_os = "android")]
    {
        // 调用 Android JNI 或内置的 tauri::api
        todo!()
    }
    #[cfg(target_os = "ios")]
    {
        // 调用 iOS 框架
        todo!()
    }
    #[cfg(not(any(target_os = "android", target_os = "ios")))]
    "desktop".into()
}

Tauri 的 Rust 层已经提供了 tauri::api 下的部分跨平台工具（如路径解析），但对于平台专有 API，仍需你自己编写 FFI 绑定。不建议在核心业务代码中散落大量平台条件编译，复杂逻辑最好封装成插件，保持代码清晰。

4. 前端调用流程与安全

前端对待原生调用就像对待普通的 Tauri 命令：

import { invoke } from '@tauri-apps/api/tauri';
const result = await invoke('get_device_info');

但在移动端，安全边界依然严格：

CSP 和权限管理：通过 tauri.conf.json 的 security 字段限制前端可以访问的 API。
原生能力授权：敏感操作（如相机、麦克风）需要在应用配置中声明权限，并在运行时向用户请求（Android 的 AndroidManifest.xml、iOS 的 Info.plist 和运行时提示）。
Rust 命令白名单：前端只能调用白名单内已声明的命令，防止恶意代码调用未经授权的原生功能。

5. 实际开发中的注意事项

原生调试：Android 使用 adb logcat，iOS 使用 Xcode 控制台。Tauri 的 Rust 日志也会输出到这里，记得引入 log 库。
性能考量：频繁调用原生方法（如每帧触发的传感器数据）应使用批处理或共享内存方式，避免 IPC 开销。
包体积：Rust 编译的 .so 或 .dylib 非常小，但若引入了大型原生 SDK（如百度地图），体积可能会显著增加，需合理权衡。
测试环境：移动端 WebView 对前端框架的兼容性与系统浏览器基本一致，但仍需在真机上测试（如 iOS 的 WKWebView 对某些 CSS 属性支持不同）。

一句话总结：Tauri 移动端通过“前端调用 Rust 命令 → Rust 命令通过插件桥接到原生代码”的链式架构，让你能用最少的平台特定代码，安全且高效地调用相机、GPS、传感器等所有原生能力，同时保持应用体积和性能的轻量优势。