Android NFC框架源码剖析 上篇

10 阅读15分钟

0. 先讲一个真实场景

产品经理跑过来说:"贴一下工牌就能打卡,很简单的,调个 API 就行。"

于是你写了这五行代码:

val adapter = NfcAdapter.getDefaultAdapter(context)
adapter.enableReaderMode(this, { tag ->
    val ndef = Ndef.get(tag)
    ndef.connect()
    val msg = ndef.ndefMessage
    ndef.close()
}, NfcAdapter.FLAG_READER_NFC_A or NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK, null)

能跑。但接下来一定会遇到这些问题:

  • 为什么同一张卡,在 A 手机上 techList 有 MifareClassic,在 B 手机上却没有?
  • 为什么 enableForegroundDispatch 在 Android 10 之后偶尔"点了没反应"?
  • 为什么 transceive() 抛 TagLostException,把手机挪开 1 厘米又好了?
  • 为什么我做 HCE 门禁,AID 注册了却始终收不到 processCommandApdu?
  • 为什么"低频卡"贴上去完全没反应?

这些问题,靠 API 文档是答不出来的,必须知道框架内部长什么样。这篇就从射频频率开始,一路拆到 startActivity。

说明:本文以 AOSP 主线为基准。Android 16 起 NFC 已整体迁入 Mainline 模块(APEX com.android.nfcservices),代码路径从 packages/apps/Nfc 变为 packages/modules/Nfc;老版本对照时我会注明差异。厂商 ROM 普遍有裁剪与魔改,文中会明确指出哪些点"不能假设"。


1. 先把"频率"这件事说清楚

很多人把 NFC 和"高频卡"混着说,实际工业界的 RFID 频段划分是这样的:

频段典型频率典型协议/卡种手机 NFC 是否支持
低频 LF125 kHz / 134.2 kHzEM4100、HID Prox 门禁卡、ISO 11784/11785 动物耳标不支持
高频 HF13.56 MHzISO/IEC 14443 A/B(MIFARE Classic、DESFire、CPU 卡)、ISO/IEC 15693(NfcV)、ISO/IEC 18092(FeliCa/NfcF)、NFC Forum NDEF支持,且是唯一支持的频段
超高频 UHF860–960 MHzEPC Class1 Gen2 / ISO 18000-6C,仓储物流标签不支持(需外接 UHF 模块)

所以第一句话就要立住:

手机里的 NFC = 13.56MHz 高频(HF)。低频 125kHz 和超高频 900MHz 都不在 Android NFC 框架的能力边界内。

这也解释了那个经典投诉:客户拿着一张 125kHz 的旧门禁卡贴手机,说"别人的手机能刷"。那不是 NFC,那是手机里另外塞了一颗 LF 读头(少数行业机型),或者干脆是 UHF 手持机。

1.1 NFC 内部还有"速率档位"

除了频段,NFC 在 13.56MHz 上还有三档传输速率:106 / 212 / 424 kbit/s。这三档不是"高中低频",而是同一载波下的不同调制密度:

  • 106 kbit/s:ISO 14443A 的起点,MIFARE Classic / Ultralight 的默认档,抗干扰最好、距离最远;
  • 212 / 424 kbit/s:ISO-DEP(ISO 14443-4)协商后可提速,DESFire、CPU 卡、HCE 通常跑在这两档。

框架里它体现为 NfcA 的 ATQA/SAK 与 IsoDep 的 historicalBytes,协商由 NFCC 固件完成,Java 层拿到的是"已激活的 RF 接口"。所以你无法在应用层指定速率——这也是很多"读卡慢"问题最终只能找厂商调 RF 参数的原因。

1.2 一个必须记住的结论

Android NFC 框架的全部代码,都是为 13.56MHz 服务的。你在 android.nfc.tech 里看到的每一个类,都对应一个 13.56MHz 上的协议:

技术类对应标准典型载体
NfcAISO 14443-3AMIFARE Classic / Ultralight / DESFire / CPU 卡
NfcBISO 14443-3B身份证、部分金融卡、Calypso
NfcFISO 18092 / JIS X 6319-4FeliCa(日本市场,国行机型普遍缺失)
NfcVISO 15693图书标签、资产标签(识别距离更远)
IsoDepISO 14443-4跑 APDU 的智能卡、HCE 对端
MifareClassicNXP 私有老门禁/梯控/校园卡(依赖 NXP 芯片)
MifareUltralightNXP 私有一次性票券、耗材防伪
Ndef / NdefFormatableNFC Forum可格式化的标准标签

这张表是后面所有兼容性讨论的基础:能不能用,首先取决于芯片和 ROM 有没有实现对应技术。


2. 分层架构总览

先上全景图。这张图建议直接背下来,排查任何 NFC 问题都是从上往下或从下往上"对齐层次"。

┌──────────────────────────────────────────────────────────────┐
│  应用层  App                                                 │
│  NfcAdapter / Tag / Ndef / tech.* / HostApduService          │
├──────────────────────────────────────────────────────────────┤
│  API 层  framework-nfc.jar(Android 16 起随 APEX 下发)       │
│  android.nfc.*     ← 进程内对象,Tag 是 Parcelable            │
├──────────────────────────────────────────────────────────────┤
│  系统服务层  NfcNci.apk(Java)                               │
│  NfcService(生命周期/状态机)                                │
│  NfcAdapterService(INfcAdapter 实现,Binder 服务端)          │
│  NfcDispatcher(意图匹配与派发)                              │
│  NfcTagService(INfcTag 实现,技术对象跨进程入口)             │
│  HostEmulationManager(HCE APDU 状态机)                      │
│  DeviceHost ← NativeNfcManager(JNI 门面)                    │
├──────────────────────────────────────────────────────────────┤
│  JNI  libnfc_nci_jni.so                                      │
│  NativeNfcManager.cpp / NfcTag.cpp / RoutingManager.cpp       │
├──────────────────────────────────────────────────────────────┤
│  协议栈  libnfc_nci.so(C++,NCI 协议)                        │
│  nfc_ncif.cc(NCI 编解码)/ nci_rf.cc / nci_hms.cc            │
│  tags/(RF 发现与标签抽象)/ rf/                              │
├──────────────────────────────────────────────────────────────┤
│  HAL  android.hardware.nfc.INfc(AIDL,早期为 HIDL 1.x)       │
├──────────────────────────────────────────────────────────────┤
│  固件  NFCC(NXP PN5xx/SN100、高通 NQ 系列、ST/三星等)         │
│  天线匹配 / 场强 / 防冲突 / 卡模拟路由                         │
└──────────────────────────────────────────────────────────────┘

三层职责一句话总结:

  • Java 系统服务层:决定"这张卡给谁"——权限、前台、偏好、AID 路由、Intent 构造;
  • JNI + libnfc_nci:决定"怎么和卡说话"——NCI 命令编排、RF 发现循环、数据分片;
  • HAL + 固件:决定"物理上能不能说上话"——场强、天线、协议时序、卡模拟。

分层带来的一个直接后果:上层报的错,往往是下层的能力缺失。TagLostException 可能根本不是"卡离开了",而是 RF 场被重新配置了。这个坑下篇细讲。


3. API 层:android.nfc 这张地图

android.nfc 包很小,但每个类的位置都不是随便放的。

3.1 关键类职责

类职责是否跨进程
NfcAdapter唯一的门面:开关、ReaderMode、前台派发、HCE 卡片注册是(内部持 INfcAdapter)
NfcManager获取 NfcAdapter 的兼容入口否
Tag一张被发现标签的"身份证 + 能力列表"是(内含 INfcTag)
NdefMessage / NdefRecordNDEF 数据模型,纯数据否
tech.NfcA …各协议的读写句柄是(转发到 INfcTag)
NfcEventReaderMode 回调里携带的 NfcAdapter否
HostApduServiceHCE 的服务端抽象是(系统绑定)

3.2 NfcAdapter 是怎么拿到系统服务的

老代码里常见 NfcAdapter.getDefaultAdapter(context),内部其实是一层层往下摸:

// 简化示意:android.nfc.NfcAdapter
public static NfcAdapter getDefaultAdapter(Context context) {
    NfcManager manager = (NfcManager) context.getSystemService(Context.NFC_SERVICE);
    return manager != null ? manager.getDefaultAdapter() : null;
}

Android 13(API 33)之后,系统服务注册方式改成了 NfcFrameworkInitializer:

// 简化示意:android.nfc.NfcFrameworkInitializer
public static void registerServiceWrappers() {
    SystemServiceRegistry.registerContextAwareService(
            Context.NFC_SERVICE,
            NfcManager.class,
            (context, service) -> new NfcManager(context, INfcAdapter.Stub.asInterface(service)));
}

这个变化对业务的意义在于:API 层已经变成可独立更新的模块(framework-nfc.jar 随 APEX 下发)。也就是说,同一个 Android 大版本,不同时间点的机器,android.nfc 的行为可能不一样。这一点在做兼容性判断时非常关键——不要用 Build.VERSION.SDK_INT 去推断 NFC 行为,要用能力探测。

3.3 Tag 到底装了什么

Tag 是整个框架的枢纽,它的字段值得逐个看:

// 简化示意:android.nfc.Tag
public final class Tag implements Parcelable {
    final byte[] mId;                 // 卡号(UID),注意:不是所有卡都有稳定 UID
    final int[] mTechList;            // 技术位图,如 TECH_NFC_A | TECH_NDEF
    final String[] mTechStringList;   // "android.nfc.tech.NfcA" 等
    final Bundle[] mTechExtras;       // 每种技术的附加参数(ATQA/SAK/历史字节…)
    final int mServiceHandle;         // native 层句柄,指向一张已激活的卡
    final INfcTag mTagService;        // 跨进程句柄
}

三个容易踩的点:

  1. mServiceHandle 是有生命周期的。RF 场一断,句柄就失效,所有基于它的 Tag 全部作废。缓存 Tag 对象是最常见的错误。
  2. mTechList 是"能力快照",由 native 在发现时一次算好。厂商裁剪某项技术,这里就直接少一项。
  3. mTechExtras 里的 ATQA/SAK 是判定卡型的唯一可靠依据,比 UID 长度靠谱得多。

4. 系统服务层:NfcService 的生命周期与状态机

NfcService 是一个 Application 子类,运行在 com.android.nfc 进程里,由 NfcApplication 拉起。

4.1 状态机

                  enable()                     NFCC 初始化成功
      ┌────────┐ ─────────► ┌────────────┐ ──────────────────► ┌────────┐
      │  OFF   │            │ TURNING_ON │                     │   ON   │
      └────────┘ ◄───────── └────────────┘                     └────────┘
          ▲         初始化失败                disable()  │            │
          │                                            ▼            │
          │                                     ┌──────────────┐    │
          └──────────────────────────────────── │ TURNING_OFF  │ ◄──┘
                                                └──────────────┘

对外暴露的常量就是 NfcAdapter.STATE_OFF / STATE_TURNING_ON / STATE_ON / STATE_TURNING_OFF,状态变化通过广播 NfcAdapter.ACTION_ADAPTER_STATE_CHANGED 通知。

业务上必须注意:这个状态机是异步的。enable() 返回 true 只代表"请求已受理",不代表 NFCC 已经就绪。所以正确姿势是监听广播,而不是 enable() 之后立刻 enableReaderMode()。

4.2 enable() 内部做了什么

// 简化示意:NfcService
public boolean enableInternal() {
    synchronized (sServiceLock) {
        if (mState == NfcAdapter.STATE_ON || mState == NfcAdapter.STATE_TURNING_ON) {
            return true;                              // 幂等
        }
        mState = NfcAdapter.STATE_TURNING_ON;
        updateState(false);                           // 发广播

        if (mDeviceHost.enable()) {                   // ← 关键:下发到 JNI
            mState = NfcAdapter.STATE_ON;
            applyRouting(true);                       // 配置 RF 发现/监听路由
            updateState(false);
            return true;
        }
        mState = NfcAdapter.STATE_OFF;
        updateState(false);
        return false;
    }
}

这里有两个必须理解的节点:

  • mDeviceHost.enable():一路走到 NativeNfcManager::initialize(),完成 NCI CORE_RESET → CORE_INIT 握手。这一步失败,通常意味着固件/ HAL/时钟/供电有问题,Java 层无能为力。
  • applyRouting(true):把"当前该监听什么、该轮询什么"翻译成 NCI 的 RF_DISCOVER_CMD。ReaderMode、HCE、前台派发、屏幕状态,全部汇聚到这里。这是整个框架最核心的一个"汇聚点",下篇会专门拿它做业务设计。

4.3 NfcAdapterService:Binder 的入口

应用侧调用的每一个方法,最终都落到 NfcAdapterService(INfcAdapter 的实现):

// 简化示意
class NfcAdapterService extends INfcAdapter.Stub {
    @Override public boolean enable()  { return mNfcService.enableInternal(); }
    @Override public boolean disable() { return mNfcService.disableInternal(); }
    @Override public INfcTag getNfcTagInterface() { return mNfcService.getNfcTagInterface(); }
    @Override public void setReaderMode(IBinder binder, IAppCallback callback,
                                        int flags, Bundle extras) { /* … */ }
}

权限模型在这里收敛:NFC 是普通权限(normal),但 HCE、eSE 访问、enable()/disable() 都受额外限制。比如 enable()/disable() 从 Android 10 起对普通应用基本关闭,只有系统/特权应用可调——这也是为什么你的"一键开启 NFC"引导只能跳设置页。


5. 发现链路:一张卡是怎么变成 Intent 的

这是全篇最重要的一节。完整链路共 7 步,建议对照时序图看。

 App            NfcService        NfcDispatcher      JNI/libnfc_nci        NFCC
  │                  │                  │                  │                │
  │                  │                  │  RF_DISCOVER_CMD │◄───────────────┤ 轮询
  │                  │                  │                  │                │
  │                  │                  │                  │  RF_INTF_      │ 卡进场
  │                  │                  │                  │  ACTIVATED_NTF │
  │                  │                  │◄──onRemoteEndpointDiscovered───────┤
  │                  │  dispatchTag()   │                  │                │
  │                  │─────────────────►│                  │                │
  │                  │                  │ findNdefMessage()│                │
  │                  │                  │─────────────────►│  DATA_EXCHANGE │
  │                  │                  │◄─────────────────┤                │
  │                  │                  │  tryNdef/tryTech/tryTag           │
  │                  │                  │  startActivity / PendingIntent    │
  │◄───Intent────────┤                  │                  │                │

5.1 第 1–2 步:NCI 的发现循环

libnfc_nci 维护一个持续运行的发现循环,本质是不断下发:

  • RF_DISCOVER_CMD (0x03):告诉 NFCC"去轮询 14443A/B、15693、FeliCa,同时监听卡模拟";
  • 卡进场后 NFCC 主动上报 RF_INTF_ACTIVATED_NTF (0x43):里面带 RF 技术、协议、卡参数;
  • 卡离开上报 RF_DEACTIVATE_NTF。

这一步决定了"能不能被发现"。如果 RF_DISCOVER_CMD 里的轮询位没打开(比如省电策略关掉了 15693),你在应用层再怎么努力也读不到 NfcV 标签。这就是"有些标签在 XX 手机上永远读不到"的根因之一。

5.2 第 3–4 步:JNI 把 native 句柄包装成 Java 对象

NativeNfcManager 收到 onRemoteEndpointDiscovered 回调,NfcTag.cpp 创建 NativeNfcTag,并把技术位图、UID、ATQA/SAK 一起算出来:

// 简化示意:packages/modules/Nfc/nci/jni/NativeNfcTag.cpp
jint NativeNfcTag::getTechList() {
    // 依据已激活 RF 接口 + 卡参数,返回位图
    // 例如 NFC_A | NFC_A_ISO_DEP | NDEF 组合
}

注意:技术位图是 native 算的。厂商可以让某个技术"永远不出现",比如把 MifareClassic 位清掉。所以 techList 是能力探测的第一手证据。

5.3 第 5 步:NfcService 分发给 NfcDispatcher

// 简化示意:NfcService
@Override
public void onRemoteEndpointDiscovered(TagEndpoint tag) {
    if (!tag.isPresent()) return;
    if (!mNfcDispatcher.dispatchTag(tag)) {
        // 没有应用感兴趣,按策略丢弃或提示
    }
}

5.4 第 6 步:NfcDispatcher 的三级尝试

这是"Intent 优先级"的真正实现地(老版本在 NfcService.NfcServiceHandler 里,逻辑一致):

// 简化示意:NfcDispatcher
boolean dispatchTag(TagEndpoint tag) {
    NdefMessage message = tag.findNdefMessage();   // 有 NDEF 就先读出来

    if (message != null && tryNdef(tag, message)) return true;  // ① NDEF
    if (tryTech(tag, message)) return true;                     // ② TECH
    return tryTag(tag);                                         // ③ TAG
}

三级对应的就是三个 Action:

优先级Action触发条件匹配依据
1ACTION_NDEF_DISCOVERED标签含可解析的 NDEF第一条记录的 TNF + type → URI 或 MIME
2ACTION_TECH_DISCOVERED无 NDEF,或 NDEF 解析不出 URI/MIMEtech-list XML
3ACTION_TAG_DISCOVERED前两者都无匹配无过滤,兜底(全应用可见)

tryNdef 的构造逻辑:

// 简化示意
private boolean tryNdef(TagEndpoint tag, NdefMessage message) {
    NdefRecord record = message.getRecords()[0];
    Intent intent = new Intent(NfcAdapter.ACTION_NDEF_DISCOVERED);
    intent.putExtra(NfcAdapter.EXTRA_TAG, tag.getTag());
    intent.putExtra(NfcAdapter.EXTRA_ID, tag.getUid());
    intent.putExtra(NfcAdapter.EXTRA_NDEF_MESSAGES, new NdefMessage[]{ message });

    Uri uri = parseUri(record);         // RTD_URI / RTD_TEXT / TNF_ABSOLUTE_URI
    String mime = record.toMimeType();  // TNF_MIME_MEDIA
    if (uri != null)  intent.setData(uri);
    if (mime != null) intent.setType(mime);

    // 内部两条路径:有前台 PendingIntent 就直接 send,否则 startActivityAsUser
    return sendIntent(intent);
}

5.5 第 7 步:投递到应用

sendIntent 有两条完全不同的路径:

  1. 前台派发(enableForegroundDispatch):直接把 PendingIntent 发给当前前台 Activity,不经过系统 Activity 启动流程,因此不受后台启动限制,响应最快,也是量产项目最该用的方式;
  2. 常规派发:startActivityAsUser,走标准 Intent 解析,会弹应用选择器,且从 Android 10 起受后台 Activity 启动限制影响。

这条差异直接导致了一个高频 Bug:App 在后台时用 Intent Filter 收不到 NFC。不是权限问题,是后台启动限制。解决方案只有一个——前台用 enableForegroundDispatch / enableReaderMode。


6. 技术对象层:Tag 之后的跨进程真相

拿到 Tag 只是拿到"身份证",真正读写要走技术对象。

6.1 TagTechnology 的骨架

所有 tech.* 类都实现 TagTechnology,公共逻辑在 BasicTagTechnology:

// 简化示意:android.nfc.tech.BasicTagTechnology
public void connect() throws IOException {
    synchronized (mLock) {
        if (mIsConnected) return;
        int error = mTag.getTagService().connect(mTag.getServiceHandle(), mSelectedTechnology);
        if (error == ErrorCodes.SUCCESS) {
            mIsConnected = true;
        } else {
            throw new IOException("connect failed: " + error);
        }
    }
}

mTag.getTagService() 就是 INfcTag,服务端是 NfcTagService,再往下就是 JNI 的 NativeNfcTag::doConnect()。

6.2 transceive() 的真实语义

// 简化示意:BasicTagTechnology
public byte[] transceive(byte[] data, boolean raw) throws IOException {
    checkConnected();
    return mTag.getTagService().transceive(mTag.getServiceHandle(), data, raw);
}

这里有三层语义要拆开:

  • raw = false:框架帮你补 CRC / 协议头(仅部分技术支持);
  • raw = true:原样下发,你自己负责 CRC;
  • 返回即"一收一发"完成,没有重试。所以 TagLostException 一旦抛出就是真失败,必须自己封装重试。

6.3 MifareClassic 为什么特殊

MifareClassic 不走标准 APDU,而是 NXP 私有指令(0x30 读块、0xA0 写块、0x60/0x61 认证)。它在框架里的支持依赖固件实现了 MIFARE 透传。这就是为什么:

  • 部分机型 techList 里有 MifareClassic,但 authenticateSectorWithKeyA() 一直返回 false;
  • 国行某些机型干脆不暴露该技术类。

业务结论:不要用 MifareClassic 做新项目的核心链路。存量卡兼容可以,新发卡一律上 NfcA + ISO-DEP(DESFire/CPU 卡)。


7. 卡模拟:一条 APDU 的路

HCE(Host Card Emulation)是 NFC 里最"玄学"的部分,因为它涉及 AID 路由这个跨层配置。

7.1 应用侧:声明服务

<service
    android:name=".MyHostApduService"
    android:exported="true"
    android:permission="android.permission.BIND_NFC_SERVICE">
    <intent-filter>
        <action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
    </intent-filter>
    <meta-data
        android:name="android.nfc.cardemulation.host_apdu_service"
        android:resource="@xml/apduservice" />
</service>

res/xml/apduservice.xml:

<host-apdu-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/app_name"
    android:requireDeviceUnlock="false">
    <aid-group android:description="@string/aid_group" android:category="other">
        <aid-filter android:name="F0010203040506" />
        <aid-filter android:name="A0000000031010" />
    </aid-group>
</host-apdu-service>

7.2 系统侧:ApduServiceInfo 解析并落到路由表

NfcService 启动时会扫描所有声明了 HOST_APDU_SERVICE 的服务,解析成 ApduServiceInfo,然后把 AID → 服务 的映射下发到 native:

AID 表 ──JNI──► RoutingManager ──► NCI RF_SET_LISTEN_MODE_ROUTING_CMD (0x21)
                                          │
                                          ▼
                                   NFCC 内部路由表(host / eSE / UICC)

NCI 的 RF_SET_LISTEN_MODE_ROUTING_CMD 里每个 TLV 至少包含:AID 值、协议(ISO-DEP / NFC-DEP)、目标(Host / eSE / UICC)、电源状态(灭屏/亮屏/低电)。这就是"灭屏能不能刷"的配置来源。

7.3 一次 SELECT AID 的完整路径

 读卡器                 NFCC              libnfc_nci          HostEmulationManager      你的 Service
   │                     │                    │                      │                      │
   │ SELECT AID F001..   │                    │                      │                      │
   │────────────────────►│  APDU 上报         │                      │                      │
   │                     │───────────────────►│  onHostCardEmulationData                   │
   │                     │                    │─────────────────────►│ 查 AID 表             │
   │                     │                    │                      │──────────────────────►│
   │                     │                    │                      │  processCommandApdu() │
   │                     │                    │                      │◄──────────────────────┤
   │  90 00              │                    │                      │  sendResponseApdu()   │
   │◄────────────────────┼────────────────────┼──────────────────────┤                      │

HostEmulationManager 内部维护一个轻量会话状态机:空闲 → 已按 AID 选中 → 会话中 → 去激活。它负责:

  • 解析 00 A4 04 00(SELECT by name),按 AID 找目标服务;
  • 维护"当前会话绑定到哪个服务",后续 APDU 直接转发;
  • 处理 onDeactivated,通知服务会话结束。

7.4 HCE 三个"不响应"的根因

按出现频率排序:

  1. AID 格式错误:必须大写十六进制、偶数长度、不含空格。F0010203040506 写成 f0 01 02 永远不会匹配。
  2. category 冲突:两个应用注册了同一个 AID,系统按优先级/用户选择决定,落选者静默失败。要么换 AID,要么引导用户去"默认支付应用"设置。
  3. 电源状态不匹配:requireDeviceUnlock="true" 时灭屏不路由;某些 ROM 还会在低电时清空 host 路由。

另外,部分厂商 ROM 会给 HCE 追加"应用可见性"约束(例如切到后台一段时间后回收 host 路由),表现为"调试时好用、上线后偶发不响应"。这不是 AOSP 行为,需要用日志确认后走厂商渠道,下篇会给出兜底方案。


8. P2P:从 Beam 到退场

NfcAdapter.setNdefPushMessage()、ACTION_NDEF_DISCOVERED 的 P2P 分支,构成的 Android Beam 曾经很风光。但:

  • Android 10 起 Beam 被标记废弃;
  • Android 14(API 34)正式移除 Android Beam。

现在 libnfc_nci 里的 NFC-DEP(P2P)发现位多数机型已默认关闭。新项目不要再设计 P2P 传输方案,设备配对改用 BLE / QR / UWB。


9. 最底层:JNI、NCI 与 HAL

这一层平时不需要改,但排障时必须知道自己在哪一层。

9.1 模块清单(Android 16+)

产物位置作用
framework-nfc.jarAPEX 内android.nfc API
NfcNci.apkAPEX 内Java 系统服务
libnfc_nci_jni.soAPEX 内JNI 桥
libnfc_nci.soAPEX 内NCI 协议栈
android.hardware.nfc.INfcHAL厂商实现
libnfc-nci.conf / libnfc-nxp.conf/vendor/etc/厂商 RF 参数

9.2 HAL 的演进

Android 8–12 : android.hardware.nfc@1.0 / 1.1 / 1.2 (HIDL)
Android 13+  : android.hardware.nfc.INfc (AIDL)

AIDL 化之后,HAL 接口变成 open() / write() / prediscover() / close() 等少数几个方法,NCI 报文以裸字节数组进出。这意味着:

从 HAL 往上看,框架是"协议无关"的——它只负责收发 NCI 包。所有协议差异都在 libnfc_nci.so 和固件里。

所以当厂商说"我们改了 RF 参数",改动点大概率在 libnfc-nxp.conf 或固件,不在 AOSP 代码里。这也是为什么 NFC 问题经常"只能找厂商"。

9.3 一个实用的分层定位法

现象最可能出问题的层
开关打不开 / 一直 TURNING_ONHAL / 固件 / 供电
能开但读不到任何卡RF_DISCOVER_CMD 配置、天线
只能读某类卡libnfc_nci 技术位、固件
能读但 App 收不到 IntentNfcDispatcher / 后台启动限制 / 权限
HCE 不响应AID 路由 / ApduServiceInfo 解析 / 电源状态
偶发 TagLostExceptionRF 重配置、场强、金属干扰

10. 上篇小结

回到开头那五个问题,现在都能回答了:

  • techList 不一样 → native 算的技术位图不同,本质是固件/ROM 能力差异;
  • Android 10 后前台派发"没反应" → 后台 Activity 启动限制,必须前台 + enableForegroundDispatch;
  • transceive() 抛 TagLostException → RF 场被重配(ReaderMode 切换、屏幕状态变化),需要重试 + 重连;
  • HCE 收不到 APDU → AID 格式、category 冲突、RF_SET_LISTEN_MODE_ROUTING_CMD 的电源状态;
  • 低频卡没反应 → 频段根本不支持,13.56MHz 之外的能力需要外接模块。

下篇进入工程侧:每个模块能长出什么业务、版本兼容怎么兜、厂商差异怎么探测,并给出一份可以直接抄的兼容封装和上线检查清单。