面向 NativeScript 的公共工具与 MQTT 通讯组件。Android 原生能力使用 Java 实现，通过独立的 TypeScript 插件提供给应用调用，与 Vue 视图层无关。JAR 随 npm 包发布，安装插件后由 NativeScript 纳入 Android 构建。
common AES 原生功能支持 Android 8.0（API 26）及以上和 iOS 15 及以上；MQTT 原生功能仍支持 Android。iOS 使用独立 Xcode Framework，XCFramework 随 npm 包发布。
| 组件文档 | 内容 | 状态 |
|---|---|---|
| common | 公共工具、Token/MQTT 凭据安全存储、Android Keystore / iOS Keychain 密钥管理、AES-GCM JSON 加解密 | 已实现 |
| MQTT v3 | 基于 Eclipse Paho 的 MQTT 3.1.1 通讯 | 已实现 |
| MQTT v5 | 基于 Eclipse Paho 的 MQTT 5.0 通讯 | 已实现 |
各组件 README 包含安装、API、宿主配置、构建与发布说明。
| 目录 | 内容 |
|---|---|
| android/ | 独立 Java 工程：common、MQTT v3、MQTT v5 |
| nativescript-plugin/ | 对应组件的 npm 插件与 TS 类型声明 |
| demo-app/ | NativeScript 9 + Vue 3 + Vite 演示，含 AES、MQTT v3 / v5 测试入口 |
| ios/ | 独立 Xcode Framework：common |
| docs/ | 文档目录 |
目录名中的 nativescipt 为工程当前使用的名称。各 Java 工程与 npm 包独立构建；运行演示的完整步骤见 demo README。
本项目采用 Apache License 2.0。
common 另提供统一 toast(message) 提示接口；iOS 的版本、App Store 和方向工具通过
com.ajaxjs.nativescript.ios.Helper TS 命名空间调用，详见 common 组件说明。