更新记录

1.0.0（2025-11-29）

鸿蒙harmonyos tag读写

平台兼容性

hm_nfc_plugin - HarmonyOS NFC功能插件

📌 插件简介

hm_nfc_plugin 是专为 HarmonyOS 设备设计的 NFC 功能插件，提供完整的 NFC 交互能力（设备检测、状态查询、读写操作等）。开发者可快速集成 NFC 功能，无需处理底层通信逻辑。

重要提示：仅支持 真机调试（模拟器不支持 NFC 功能）

🛠 安装方式

✅ 通过 HBuilderX 导入（推荐）

1. 打开 HBuilderX → 菜单栏 插件 → 插件市场
2. 搜索 hm_nfc_plugin → 点击 导入
3. 选择目标 uni-app 项目 → 确认导入

📱 使用方法

1️⃣ 导入插件

import { 
  hmNfcIsSupport, 
  hmNfcIsOpen, 
  openNfcSettings, 
  startNfcScan, 
  startNfcWrite 
} from 'hm_nfc_plugin';

2️⃣ 核心功能示例

✅ 检查设备支持 NFC

if (hmNfcIsSupport()) {
  console.log("✅ 设备支持NFC");
} else {
  console.log("❌ 设备不支持NFC");
}

✅ 检查NFC是否开启

if (hmNfcIsOpen()) {
  console.log("✅ NFC已开启");
} else {
  console.log("❌ NFC未开启");
}

✅ 打开NFC设置页面

openNfcSettings(); // 跳转系统NFC设置

✅ 启动NFC读取（需真机操作）

startNfcScan({
  onRead: (data) => console.log("读取数据:", data), // 成功回调
  onError: (error) => console.error("错误:", error)  // 错误回调
});

✅ 启动NFC写入

const writeContent = {
  type: "text",    // 类型: text/uri/smartposter
  content: "Hello HarmonyOS" // 写入内容
};

startNfcWrite(writeContent, {
  onWrite: (result) => console.log("写入成功:", result),
  onError: (error) => console.error("写入失败:", error)
});

🔧 回调接口定义

interface NfcReadCallback {
  onRead: (data: string) => void;    // 读取成功
  onError: (error: string) => void;   // 读取失败
}

interface NfcWriteContentModel {
  type: 'text';                         // 写入类型
  content: string;                      // 写入内容
}

⚠️ 重要注意事项

1. 必须真机调试

❌ 模拟器 不支持 NFC 功能（需用 HarmonyOS 真机测试）

2. 权限配置

在 manifest.json 中添加 NFC 权限：

"reqPermissions": [
{
"name": "ohos.permission.USE_NFC"
}
]

3. NFC 操作流程

• 读取：将 NFC 标签靠近设备（距离 1-2cm）
• 写入：确保标签已放置在设备 NFC 读写区域

💡 使用建议

1. 首次调用前检查：

if (!hmNfcIsSupport()) {
  uni.showToast({ title: "设备不支持NFC", icon: "none" });
  return;
}

2. NFC 未开启时引导：

if (!hmNfcIsOpen()) {
  uni.showModal({
    title: "NFC未开启",
    content: "需要打开NFC才能使用功能",
    success: (res) => res.confirm && openNfcSettings()
  });
}

3. 测试时注意：

• 用 支持NFC的设备（如华为P系列、Mate系列）
• 避免使用金属外壳/保护套（影响NFC信号）

🔧 错误解决

1、版本号错误

Error Message: The project's compatibleSdkVersion: 13 cannot be lower than the minimum compatible version 17 required by the dependencies: hm_nfc_plugin.
修改配置文件版本号，如：build-profile.json5：compatibleSdkVersion版本为：6.0.1(21)；
{
        "name": "release",
        "signingConfig": "release",
        "compatibleSdkVersion": "5.0.1(13)",
        "compatibleSdkVersionStage": "beta6",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "caseSensitiveCheck": true,
            "useNormalizedOHMUrl": true
          }
        }
 }
文件路径：项目所在目录绝对路径\unpackage\dist\dev\app-harmony\build-profile.json5