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 19Android 4.4测试设备或模拟器需要支持NFC建议使用真机测试因为模拟器的NFC功能有限。我在开发初期用模拟器调试时就遇到了不少奇怪的问题换成真机后都迎刃而解了。3. 三步实现NFC读取功能3.1 第一步配置权限和特性在AndroidManifest.xml中添加以下代码!-- NFC权限 -- uses-permission android:nameandroid.permission.NFC / !-- 要求设备必须要有NFC芯片 -- uses-feature android:nameandroid.hardware.nfc android:requiredtrue /这里有个小技巧如果你希望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 读取不到卡片怎么办首先检查以下几点确认设备支持NFC且已开启确保卡片类型是兼容的常见的有Mifare、Felica等卡片与设备NFC天线位置要对准通常在手机背部上方检查是否在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已经足够使用。