Ionic+Capacitor集成NFC插件遇多阶段报错，请求排查解决

问题1：注入NFC时出现NullInjectorError，提示plugin_not_installed #

• 原因：仅安装了@awesome-cordova-plugins的封装层，未安装对应的原生Cordova插件，且未完成Capacitor的插件同步。
• 解决步骤：
  1. 安装原生NFC插件：npm install phonegap-nfc
  2. 同步Capacitor到Android项目：npx cap sync android
  3. 在AppModule.ts中正确注册NFC服务：

     import { NgModule } from '@angular/core';
     import { NFC } from '@awesome-cordova-plugins/nfc/ngx';
     // ...其他导入
     
     @NgModule({
       // ...其他配置
       providers: [
         NFC,
         // ...其他服务
       ]
     })
     export class AppModule { }
     

  4. 重启Android Studio并重新构建项目。

问题2：ionic serve时出现Native: tried calling NFC.enabled, but Cordova is not available...警告 #

• 原因：ionic serve运行在浏览器环境，Cordova/Capacitor原生插件仅支持真机或Android模拟器，浏览器无法调用原生NFC API。
• 解决方法：
  • 在代码中添加平台判断，仅在原生设备环境下调用NFC相关方法：

    import { Platform } from '@ionic/angular';
    import { NFC } from '@awesome-cordova-plugins/nfc/ngx';
    
    constructor(private platform: Platform, private nfc: NFC) {}
    
    checkNFCAvailability() {
      if (this.platform.is('hybrid')) { // 仅在Android/iOS真机/模拟器执行
        this.nfc.enabled().then(() => {
          // NFC可用逻辑
        }).catch(err => {
          // NFC不可用处理
        });
      } else {
        console.log('仅支持原生设备调用NFC功能');
      }
    }
    

  • 该警告不影响原生环境运行，可直接忽略。

问题3：Android Studio编译报错，找不到setNdefPushMessage(NdefMessage,Activity)方法 #

• 原因：phonegap-nfc插件版本与当前Android SDK版本不兼容，setNdefPushMessage方法已被Android NFC API弃用或方法签名变更。
• 解决步骤：
  1. 更新phonegap-nfc到最新稳定版：npm install phonegap-nfc@latest，执行npx cap sync android同步配置。
  2. 若更新版本后仍报错，修改插件Java代码：
     • 打开Android项目中app/src/main/java/com/chariotsolutions/nfc/plugin/NfcPlugin.java文件
     • 替换原setNdefPushMessage调用为新版API回调方式：

       // 替换原有setNdefPushMessage相关代码
       NfcAdapter nfcAdapter = NfcAdapter.getDefaultAdapter(this.cordova.getActivity());
       if (nfcAdapter != null) {
         nfcAdapter.setNdefPushMessageCallback(new NfcAdapter.CreateNdefMessageCallback() {
           @Override
           public NdefMessage createNdefMessage(NfcEvent event) {
             // 此处返回需要推送的NdefMessage实例
             return new NdefMessage(new NdefRecord[]{NdefRecord.createTextRecord("en", "NFC测试内容")});
           }
         }, this.cordova.getActivity());
       }
       

  3. 检查AndroidManifest.xml配置，确保添加NFC权限和特性：

     <uses-permission android:name="android.permission.NFC" />
     <uses-feature android:name="android.hardware.nfc" android:required="true" />
     

  4. 确保Android项目Module级build.gradle中compileSdkVersion和targetSdkVersion在26以上（推荐33），与插件兼容。

内容的提问来源于stack exchange，提问作者Manuel Sureda