Android NFC实战：三步实现非接触IC卡读取

1. 为什么需要NFC读取IC卡功能？

现在越来越多的场景需要用到非接触式IC卡，比如门禁卡、公交卡、会员卡等等。作为开发者，我们经常需要在自己的App中集成读取这些卡片信息的功能。比如做一个门禁管理系统，需要读取员工卡号；或者开发一个智能家居App，用IC卡作为身份验证方式。

NFC（近场通信）技术是实现这一需求的最佳选择。它允许设备在几厘米范围内进行无线数据交换，读取速度快、功耗低，而且Android系统已经提供了完善的API支持。我去年给某连锁酒店开发房卡管理系统时，就深度使用了这项技术，实测下来稳定性非常好。

2. 开发前的准备工作

2.1 硬件要求

首先确认你的Android设备支持NFC功能。现在大部分中高端手机都内置了NFC芯片，你可以通过以下方式检查：

• 查看手机参数说明
• 在系统设置中寻找"NFC"选项
• 使用代码检测（后面会讲到）

我测试过的小米、华为、三星等品牌的旗舰机型都能完美支持。不过要注意，一些低端机型或者特殊版本（比如某些海外版）可能会阉割这个功能。

2.2 开发环境配置

确保你的开发环境满足以下条件：

• Android Studio最新稳定版
• 最低支持API Level 19（Android 4.4）
• 测试设备或模拟器（需要支持NFC）

建议使用真机测试，因为模拟器的NFC功能有限。我在开发初期用模拟器调试时，就遇到了不少奇怪的问题，换成真机后都迎刃而解了。

3. 三步实现NFC读取功能

3.1 第一步：配置权限和特性

在AndroidManifest.xml中添加以下代码：

<!-- NFC权限 --> <uses-permission android:name="android.permission.NFC" /> <!-- 要求设备必须要有NFC芯片 --> <uses-feature android:name="android.hardware.nfc" android:required="true" />

这里有个小技巧：如果你希望App在没有NFC的设备上也能安装运行（只是禁用相关功能），可以把android:required设为false。但大多数情况下，我们都会设为true，避免在不支持的设备上出现功能异常。

3.2 第二步：初始化NFC适配器

NfcAdapter是Android提供的NFC功能核心类，相当于设备的NFC硬件控制器。因为每台设备只有一个NFC芯片，所以我们通常使用单例模式来管理它。

public class NfcUtils { private static NfcAdapter mNfcAdapter; public static void init(Context context) { if (mNfcAdapter == null) { mNfcAdapter = NfcAdapter.getDefaultAdapter(context); } } }

初始化时要注意检查设备是否支持NFC，以及NFC功能是否已开启。我在实际项目中遇到过用户忘记打开NFC开关的情况，所以一定要做好提示：

if (mNfcAdapter == null) { Toast.makeText(context, "设备不支持NFC功能", Toast.LENGTH_SHORT).show(); return; } if (!mNfcAdapter.isEnabled()) { Toast.makeText(context, "请在设置中开启NFC功能", Toast.LENGTH_SHORT).show(); // 可以引导用户跳转到NFC设置页面 context.startActivity(new Intent(Settings.ACTION_NFC_SETTINGS)); }

3.3 第三步：实现卡片读取逻辑

核心是使用NfcAdapter的ReaderMode，这是Android 4.4引入的简化API，比传统的ForegroundDispatch方式更易用。

// 在Activity的onResume中启用读取模式 mNfcAdapter.enableReaderMode(activity, new NfcAdapter.ReaderCallback() { @Override public void onTagDiscovered(Tag tag) { // 在这里处理读取到的卡片 String cardId = bytesToHex(tag.getId()); runOnUiThread(() -> { textView.setText("卡片ID: " + cardId); }); } }, // 支持的卡片类型标志 NfcAdapter.FLAG_READER_NFC_A | NfcAdapter.FLAG_READER_NFC_B | NfcAdapter.FLAG_READER_NFC_V, null);

记得在onPause中禁用读取模式，避免不必要的资源消耗：

@Override protected void onPause() { super.onPause(); if (mNfcAdapter != null) { mNfcAdapter.disableReaderMode(this); } }

4. 完整代码实现与优化

4.1 工具类封装

为了代码复用，我建议把NFC相关操作封装成一个工具类。下面是经过实战检验的完整实现：

public class NfcHelper { private static volatile NfcHelper instance; private NfcAdapter nfcAdapter; private ReaderCallback readerCallback; private NfcHelper() {} public static NfcHelper getInstance() { if (instance == null) { synchronized (NfcHelper.class) { if (instance == null) { instance = new NfcHelper(); } } } return instance; } public void init(Context context) { nfcAdapter = NfcAdapter.getDefaultAdapter(context); } public boolean isNfcSupported() { return nfcAdapter != null; } public boolean isNfcEnabled() { return isNfcSupported() && nfcAdapter.isEnabled(); } public void enableReaderMode(Activity activity, ReaderCallback callback) { if (isNfcEnabled()) { this.readerCallback = callback; int flags = NfcAdapter.FLAG_READER_NFC_A | NfcAdapter.FLAG_READER_NFC_B | NfcAdapter.FLAG_READER_NFC_V; nfcAdapter.enableReaderMode(activity, callback, flags, null); } } public void disableReaderMode(Activity activity) { if (isNfcSupported()) { nfcAdapter.disableReaderMode(activity); } } public static String bytesToHex(byte[] bytes) { StringBuilder sb = new StringBuilder(); for (byte b : bytes) { sb.append(String.format("%02X", b)); } return sb.toString(); } }

4.2 Activity中的使用示例

public class MainActivity extends AppCompatActivity { private TextView resultText; private NfcHelper nfcHelper; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); resultText = findViewById(R.id.result_text); nfcHelper = NfcHelper.getInstance(); nfcHelper.init(this); if (!nfcHelper.isNfcSupported()) { resultText.setText("设备不支持NFC"); return; } } @Override protected void onResume() { super.onResume(); if (nfcHelper.isNfcEnabled()) { nfcHelper.enableReaderMode(this, tag -> { String cardId = NfcHelper.bytesToHex(tag.getId()); runOnUiThread(() -> { resultText.setText("检测到卡片: " + cardId); // 这里可以添加业务逻辑，比如验证卡号等 }); }); } else { resultText.setText("请开启NFC功能"); } } @Override protected void onPause() { super.onPause(); nfcHelper.disableReaderMode(this); } }

5. 常见问题与解决方案

5.1 读取不到卡片怎么办？

首先检查以下几点：

1. 确认设备支持NFC且已开启
2. 确保卡片类型是兼容的（常见的有Mifare、Felica等）
3. 卡片与设备NFC天线位置要对准（通常在手机背部上方）
4. 检查是否在onResume中正确启用了ReaderMode

我在开发过程中发现，不同手机的NFC天线位置差异很大。比如小米的天线偏上，而华为的偏中部，需要让用户知道应该把卡片放在什么位置。

5.2 如何支持更多卡片类型？

在enableReaderMode的标志位参数中，可以组合以下值：

• FLAG_READER_NFC_A：支持ISO 14443-3A标准（最常见）
• FLAG_READER_NFC_B：支持ISO 14443-3B标准
• FLAG_READER_NFC_F：支持Felica标准（日本常用）
• FLAG_READER_NFC_V：支持ISO 15693标准

如果你不确定要支持哪些类型，可以全部加上，但要注意这可能会稍微增加功耗。

5.3 卡片数据处理技巧

读取到的卡片ID是byte数组，通常我们需要转换成16进制字符串。我提供的bytesToHex方法已经过优化，比原始文章中的实现更高效。如果需要更复杂的卡片数据处理，可以考虑使用Android的NdefMessage相关API。

6. 进阶功能扩展

6.1 读取卡片更多信息

除了卡号，我们还可以读取卡片中的其他数据。比如对于Mifare Classic卡片：

MifareClassic mifare = MifareClassic.get(tag); if (mifare != null) { try { mifare.connect(); // 读取扇区数据... } catch (IOException e) { e.printStackTrace(); } finally { try { mifare.close(); } catch (IOException e) { e.printStackTrace(); } } }

6.2 写入数据到卡片

实现写入功能需要先验证卡片密钥（如果有保护），然后选择正确的扇区进行操作。这部分内容比较复杂，建议先掌握读取功能后再深入研究。

6.3 后台持续监听

如果需要App在后台也能响应NFC事件，可以使用ForegroundDispatch方式，但这需要处理更复杂的生命周期管理。在大多数场景下，ReaderMode已经足够使用。