更新记录

1.0.0（2025-11-08）

(注：不同hx版本最好重新打包基座，以避免出现版本差异的错误)

平台兼容性

uni-app(4.61)

uni-app x(4.61)

xwe-nfc

HBuilder X 支持版本

vue版本兼容

平台兼容

权限说明文档

说明：如果主工程内未配置以下权限，导入插件后请重新打包基座权限方可生效。

• 【ios】

内置注册权限：插件内配置了Info.plist，内置权限如下：

注意：下面权限已经在插件内配置，项目中不需要重复配置了

<dict>
    <key>NFCReaderUsageDescription</key>
    <string>读取/写入nfc标签</string>
</dict>

内置敏感权限申请清单：插件内配置了UTS.entitlements，内置权限如下：

注意：下面权限已经在插件内配置，项目中不需要重复配置了

<dict>
    <key>com.apple.developer.nfc.readersession.formats</key>
    <array>
        <string>NDEF</string>
    </array>
</dict>

【特别注意】敏感权限申请清单需要到苹果开发者后台去勾选相应权限，需勾选权限如下：

• NFC Tag Reading （NFC权限）

动态申请权限：

无需要动态申请的权限

需要自行配置的配置项：

【通过 url scheme唤醒app，需自行配置如下】

• 第一种方式：项目根目录创建 Info.plist 文件配置

<dict>
    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <key>CFBundleURLRole</key>
            <string>Editor</string>
            <key>CFBundleURLIdentifier</key>
            <string>com.xwe.tools</string> <!-- 替换为你的 Bundle ID -->
            <key>CFBundleURLSchemes</key>
            <array>
                <string>xwenfc</string> <!-- 核心：唤醒用的 Scheme，必须正确 -->
            </array>
        </dict>
    </array>
</dict>

• 第二种方式：项目根目录manifest.json > app-plus > ios > urltypes

• 【harmonyOS】

需要自行配置的配置项：

【通过 url scheme唤醒app，需自行配置如下】

• module.json5 文件配置

• 路径：项目根目录harmony-configs > entry > src > main > module.json5

• 注意：如没有相应文件自行创建，可以把 unpackage > dist > dev > app-harmony > entry > src > main > module.json5 编译后的文件复制到根目录，当然也可以直接在编译后的文件去配置，但是为了保证项目工程的规范性，最好是在根目录创建一个去修改配置。

• 特别注意：保证skills数组的增量添加，编译后已经存在的配置不要去改动。

• scheme-唤醒用的Scheme 根据自己需求自行定义（如果是多种数据格式只需要配置scheme就行了，如果需要更多配置请参考官方skills标签）。

{
    "module": {
        "abilities": [
            {
                "skills": [
                    {
                        "entities": ["entity.system.browsable"],
                        "actions": ["ohos.want.action.viewData"],
                        "uris": [
                            {
                                "scheme": "xwenfc"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

插件使用文档

• 引入插件和实例化

import {XWENfc} from '@/uni_modules/xwe-nfc';

const xweNfc = new XWENfc();

• 监听-url打开app

xweNfc.onUrlOpenApp(callback)

callback返回参数说明

callbackOption结构说明

data结构说明-code = 11（url打开app读取成功）

format结构说明

meta（json数据类型）结构说明

meta（path数据类型）结构说明

meta（text数据类型）结构说明

调用代码示例

xweNfc.onUrlOpenApp((callbackOption) => {
    console.log('监听-url打开app',callbackOption);

    if(callbackOption.code === 10){
        console.log('监听中',callbackOption);
    }

    if(callbackOption.code === 11){
        console.log('监听-url打开app读取成功',callbackOption);
    }

    if(callbackOption.code === -11){
        console.log('监听-url打开app读取失败',callbackOption);
    }
})

插件公共code状态码说明