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 是否支持 |
|---|---|---|---|
| 低频 LF | 125 kHz / 134.2 kHz | EM4100、HID Prox 门禁卡、ISO 11784/11785 动物耳标 | 不支持 |
| 高频 HF | 13.56 MHz | ISO/IEC 14443 A/B(MIFARE Classic、DESFire、CPU 卡)、ISO/IEC 15693(NfcV)、ISO/IEC 18092(FeliCa/NfcF)、NFC Forum NDEF | 支持,且是唯一支持的频段 |
| 超高频 UHF | 860–960 MHz | EPC 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 上的协议:
| 技术类 | 对应标准 | 典型载体 |
|---|---|---|
NfcA | ISO 14443-3A | MIFARE Classic / Ultralight / DESFire / CPU 卡 |
NfcB | ISO 14443-3B | 身份证、部分金融卡、Calypso |
NfcF | ISO 18092 / JIS X 6319-4 | FeliCa(日本市场,国行机型普遍缺失) |
NfcV | ISO 15693 | 图书标签、资产标签(识别距离更远) |
IsoDep | ISO 14443-4 | 跑 APDU 的智能卡、HCE 对端 |
MifareClassic | NXP 私有 | 老门禁/梯控/校园卡(依赖 NXP 芯片) |
MifareUltralight | NXP 私有 | 一次性票券、耗材防伪 |
Ndef / NdefFormatable | NFC 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 / NdefRecord | NDEF 数据模型,纯数据 | 否 |
tech.NfcA … | 各协议的读写句柄 | 是(转发到 INfcTag) |
NfcEvent | ReaderMode 回调里携带的 NfcAdapter | 否 |
HostApduService | HCE 的服务端抽象 | 是(系统绑定) |
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; // 跨进程句柄
}
三个容易踩的点:
mServiceHandle是有生命周期的。RF 场一断,句柄就失效,所有基于它的Tag全部作废。缓存Tag对象是最常见的错误。mTechList是"能力快照",由 native 在发现时一次算好。厂商裁剪某项技术,这里就直接少一项。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(),完成 NCICORE_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 | 触发条件 | 匹配依据 |
|---|---|---|---|
| 1 | ACTION_NDEF_DISCOVERED | 标签含可解析的 NDEF | 第一条记录的 TNF + type → URI 或 MIME |
| 2 | ACTION_TECH_DISCOVERED | 无 NDEF,或 NDEF 解析不出 URI/MIME | tech-list XML |
| 3 | ACTION_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 有两条完全不同的路径:
- 前台派发(
enableForegroundDispatch):直接把PendingIntent发给当前前台 Activity,不经过系统 Activity 启动流程,因此不受后台启动限制,响应最快,也是量产项目最该用的方式; - 常规派发:
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 三个"不响应"的根因
按出现频率排序:
- AID 格式错误:必须大写十六进制、偶数长度、不含空格。
F0010203040506写成f0 01 02永远不会匹配。 category冲突:两个应用注册了同一个 AID,系统按优先级/用户选择决定,落选者静默失败。要么换 AID,要么引导用户去"默认支付应用"设置。- 电源状态不匹配:
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.jar | APEX 内 | android.nfc API |
NfcNci.apk | APEX 内 | Java 系统服务 |
libnfc_nci_jni.so | APEX 内 | JNI 桥 |
libnfc_nci.so | APEX 内 | NCI 协议栈 |
android.hardware.nfc.INfc | HAL | 厂商实现 |
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_ON | HAL / 固件 / 供电 |
| 能开但读不到任何卡 | RF_DISCOVER_CMD 配置、天线 |
| 只能读某类卡 | libnfc_nci 技术位、固件 |
| 能读但 App 收不到 Intent | NfcDispatcher / 后台启动限制 / 权限 |
| HCE 不响应 | AID 路由 / ApduServiceInfo 解析 / 电源状态 |
偶发 TagLostException | RF 重配置、场强、金属干扰 |
10. 上篇小结
回到开头那五个问题,现在都能回答了:
techList不一样 → native 算的技术位图不同,本质是固件/ROM 能力差异;- Android 10 后前台派发"没反应" → 后台 Activity 启动限制,必须前台 +
enableForegroundDispatch; transceive()抛TagLostException→ RF 场被重配(ReaderMode 切换、屏幕状态变化),需要重试 + 重连;- HCE 收不到 APDU → AID 格式、
category冲突、RF_SET_LISTEN_MODE_ROUTING_CMD的电源状态; - 低频卡没反应 → 频段根本不支持,13.56MHz 之外的能力需要外接模块。
下篇进入工程侧:每个模块能长出什么业务、版本兼容怎么兜、厂商差异怎么探测,并给出一份可以直接抄的兼容封装和上线检查清单。