Ionic+Capacitor集成NFC插件编译Android项目失败求助

问题背景 #

使用Angular 18 + Ionic 8 + Capacitor 6开发NFC功能APP，ionic serve运行正常，但Android Studio编译时出现9个API找不到错误，核心问题是phonegap-nfc插件调用了Android SDK中已废弃移除的NdefPushMessage相关方法，同时伴随2个配置警告。

核心错误示例 #

> Task :capacitor-cordova-android-plugins:compileDebugJavaWithJavac
C:\Users\Manuel\Desktop\Seminario-UTN\Frontend\SUBD-transport\android\capacitor-cordova-android-plugins\src\main\java\com\chariotsolutions\nfc\plugin\NfcPlugin.java:550: error: cannot find symbol
                        nfcAdapter.setNdefPushMessage(p2pMessage, getActivity());
                                  ^
  symbol:   method setNdefPushMessage(NdefMessage,Activity)
  location: variable nfcAdapter of type NfcAdapter

警告信息 #

warning: Using flatDir should be avoided because it doesn't support any meta-data formats.
warning: SDK processing. This version only understands SDK XML versions up to 3 but an SDK XML file of version 4 was encountered. This can happen if you use versions of Android Studio and the command-line tools that were released at different times.

解决方案 #

1. 替换过时的NFC插件 #

phonegap-nfc@1.2.0版本老旧，不兼容Android 14（SDK 34），改用官方维护的Capacitor NFC插件：

# 卸载旧插件
npm uninstall phonegap-nfc @ionic-native/nfc @ionic-native/core
# 安装Capacitor NFC插件
npm install @capacitor/nfc
npx cap sync

2. 更新代码中的NFC服务配置 #

修改app.module.ts

import { NFC } from '@capacitor/nfc';

@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, IonicModule.forRoot(), AppRoutingModule, HttpClientModule],
  providers: [
    { provide: RouteReuseStrategy, useClass: IonicRouteStrategy },
    { provide: HTTP_INTERCEPTORS, useClass: AuthInterceptorService, multi: true },
    NFC // 替换原@awesome-cordova-plugins/nfc
  ],
  bootstrap: [AppComponent],
})
export class AppModule {}

修改NfcReaderComponent

import { NFC, Ndef } from '@capacitor/nfc';
// ... 其他导入

constructor(
  private ticketService: TicketService,
  private transportService: TransportService,
  private router: Router
) {
  this.initNfcListener();
}

async initNfcListener() {
  try {
    // 监听NFC NDEF消息
    await NFC.addNdefListener({
      callback: (result) => {
        if (result.ndefMessage?.length) {
          const text = Ndef.textPayload(result.ndefMessage[0]);
          // 处理读取到的NFC文本内容
          console.log('读取到NFC内容:', text);
          // 这里添加你的业务逻辑，比如调用ticketService处理
        }
      }
    });
    console.log('NFC监听已启动');
  } catch (error) {
    console.error('NFC监听初始化失败:', error);
  }
}

3. 修复SDK XML版本警告 #

• 打开Android Studio，进入File > Settings > Appearance & Behavior > System Settings > Android SDK
• 切换到SDK Tools标签，确保Android SDK Build-Tools和Android SDK Platform-Tools为最新稳定版，点击Apply更新
• 执行File > Invalidate Caches... > Invalidate and Restart清除缓存

4. 移除flatDir配置（解决第一个警告） #

打开android/build.gradle，找到并移除flatDir相关配置：

// 移除以下内容（如果存在）
repositories {
    flatDir {
        dirs 'libs'
    }
}

验证步骤 #

1. 执行ionic build构建Web资源
2. 执行npx cap sync同步到Android项目
3. 重新在Android Studio中打开项目，点击Build > Make Project验证编译

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