今天咱们来碰碰跨端开发中最硬核、也最容易让前端工程师“露怯”的领域——原生底层能力调用（Native Capabilities）。

在日常开发中，像扫码、获取位置这些常规操作，uni.xxx 已经帮你封装得很好了。但如果老板突然扔给你一个需求：“去对接一个厂家提供的蓝牙血压计 SDK”，或者**“做一个即使用户把 App 退到后台，也能持续记录实时轨迹的功能”**，这时候纯 JS 就彻底抓瞎了。

🚀 今日份：跨越前端边界的武器——UTS 与原生插件

过去，为了解决这个问题，前端工程师只能去求助 Android (Java/Kotlin) 和 iOS (Objective-C/Swift) 开发，让他们写原生插件 (Native Plugin)，然后再桥接到 Uni-app 里。沟通成本极高。

为了打破这个壁垒，DCloud 推出了一个杀手锏：UTS (Uni Type Script)。

1. 什么是 UTS？(The Game Changer)

UTS 是一种强类型的、跨平台的语言。它的语法和 TypeScript 几乎一模一样。
核心魔法在于：

• 在 Android 端，它会被直接编译成 Kotlin。
• 在 iOS 端，它会被直接编译成 Swift。
• 在 H5/小程序端，它会被编译成 JavaScript。

这意味着，你只需要写一遍类 TS 代码，就能直接调用 Android 和 iOS 的系统级 API，没有任何 JS 桥接的性能损耗！

📝 实战代码：用前端语法写原生 Android 代码

假设我们需要获取手机当前的精准电池电量（JS 并没有提供直接获取电量的 API，或者不够底层）。我们可以新建一个 UTS 插件：

// 目录：uni_modules/my-battery/utssdk/app-android/index.uts

// 直接导入 Android 原生的类！(这在以前是不可想象的)
import Context from 'android.content.Context';
import BatteryManager from 'android.os.BatteryManager';
import UTSAndroid from 'io.dcloud.uts.android';

export function getNativeBatteryLevel(): number {
    // 获取 Android 的应用上下文
    const context = UTSAndroid.getAppContext();
    if (context != null) {
        // 调用 Android 原生系统服务
        const batteryManager = context.getSystemService(Context.BATTERY_SERVICE) as BatteryManager;
        // 获取电量
        return batteryManager.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY);
    }
    return -1;
}

在你的 Vue 页面中，直接像普通 JS 方法一样引入并使用即可，完全无缝衔接。

2. 方案对比：何时该用什么？

⚠️ 避坑指南（新手必看）

1. 类型极其严格：UTS 是真正的静态强类型语言。在 JS 里你写 let a = 1; a = "hello"; 最多报个警告，在 UTS 里直接导致编译失败，App 打包中断。
2. 必须打自定义基座：包含 UTS 代码或原生插件的项目，绝对不能使用 HBuilderX 自带的标准基座进行真机调试。你每次修改了 UTS 代码，都必须点击 运行 -> 运行到手机 -> 制作自定义调试基座，这个过程大概需要 2-5 分钟。
3. 查阅原生文档：写 UTS 的前提是你得稍微知道一点 Android/iOS 的 API 长什么样。遇到问题时，你搜索的关键词不应该是“Uni-app 怎么获取电量”，而应该是“Android Kotlin 获取电量”。

💡 核心总结

1. UTS 是前端工程师扩展边界的利器，它让你不需要配置复杂的 Android Studio 或 Xcode 环境，就能写原生代码。
2. 遇到 JS 搞不定的硬件交互（NFC、蓝牙、串口通讯、后台保活），首选去插件市场搜别人写好的 UTS 插件；搜不到，再尝试自己用 UTS 封装。