Core Nfc

作者 dpearson26998d90fd121a26无许可证1.1K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库2个月前更新

Read and write NFC tags using CoreNFC. Use when scanning NDEF tags, reading ISO7816/ISO15693/FeliCa/MIFARE tags, writing NDEF messages, handling NFC session lifecycle, configuring NFC entitlements, or implementing background tag reading in iOS apps.

仅含说明Software Development
AI 生成的概览

指导 iOS 开发者使用 Apple CoreNFC 框架读写 NFC 标签。

功能
该技能提供在 iPhone 上使用 CoreNFC 的参考指南和代码示例，涵盖 NDEF 读取会话、面向 ISO 7816、ISO 15693、FeliCa 和 MIFARE 标签的标签读取会话、NDEF 消息构造与载荷类型、权限与 Info.plist 配置、后台标签读取、常见错误以及审查清单。它产出的是说明性内容和 Swift 代码示例，而非可执行结果，并指向一份扩展模式参考文件。
适用场景
适用于在 iOS 应用中实现或审查 NFC 标签扫描、读取或写入，或配置 NFC 能力、权限和后台标签读取时。也适合排查会话生命周期与失效相关问题。
运行要求
不含脚本，仅为说明和参考文档。使用所述 API 需要 Xcode、用于 NFC 读取的 iPhone 7 或更新机型，以及“近场通信标签读取”能力和相应权限与 Info.plist 用途说明。

CoreNFC

Read and write NFC tags on iPhone using the CoreNFC framework. Covers NDEF reader sessions, tag reader sessions, NDEF message construction, entitlements, and background tag reading.

Contents

Setup

Project Configuration

  1. Add the Near Field Communication Tag Reading capability in Xcode
  2. Add NFCReaderUsageDescription to Info.plist with a user-facing reason string
  3. Add the com.apple.developer.nfc.readersession.formats entitlement with the current TAG value; do not add legacy NDEF
  4. For ISO 7816 tags, add supported application identifiers to com.apple.developer.nfc.readersession.iso7816.select-identifiers in Info.plist
  5. For FeliCa tags, add supported system codes to com.apple.developer.nfc.readersession.felica.systemcodes; do not use wildcard system codes

Device Requirements

NFC reading requires iPhone 7 or later. Always check for reader session availability before creating NFC UI or sessions. Use the concrete reader session type you are about to create.

swift
import CoreNFC
guard NFCNDEFReaderSession.readingAvailable else {    // Device does not support NFC or feature is restricted    showUnsupportedMessage()    return}

Key Types

TypeRole
NFCNDEFReaderSessionScans for NDEF-formatted tags
NFCTagReaderSessionScans for ISO7816, ISO15693, FeliCa, MIFARE tags
NFCNDEFMessageCollection of NDEF payload records
NFCNDEFPayloadSingle record within an NDEF message
NFCNDEFTagProtocol for interacting with an NDEF-capable tag

NDEF Reader Session

Use NFCNDEFReaderSession to read NDEF-formatted data from tags. This is the simplest path for reading standard tag content like URLs, text, and MIME data.

swift
import CoreNFC
final class NDEFReader: NSObject, NFCNDEFReaderSessionDelegate {    private var session: NFCNDEFReaderSession?
    func beginScanning() {        guard NFCNDEFReaderSession.readingAvailable else { return }
        session = NFCNDEFReaderSession(            delegate: self,            queue: nil,            invalidateAfterFirstRead: false        )        session?.alertMessage = "Hold your iPhone near an NFC tag."        session?.begin()    }
    // MARK: - NFCNDEFReaderSessionDelegate
    func readerSessionDidBecomeActive(_ session: NFCNDEFReaderSession) {        // Session is scanning    }
    func readerSession(        _ session: NFCNDEFReaderSession,        didDetectNDEFs messages: [NFCNDEFMessage]    ) {        for message in messages {            for record in message.records {                processRecord(record)            }        }    }
    func readerSession(        _ session: NFCNDEFReaderSession,        didInvalidateWithError error: Error    ) {        let nfcError = error as? NFCReaderError        if nfcError?.code != .readerSessionInvalidationErrorFirstNDEFTagRead,           nfcError?.code != .readerSessionInvalidationErrorUserCanceled {            print("Session invalidated: \(error.localizedDescription)")        }        self.session = nil    }}

Reading with Tag Connection

For read-write operations, use the tag-detection delegate method to connect to individual tags:

swift
func readerSession(    _ session: NFCNDEFReaderSession,    didDetect tags: [any NFCNDEFTag]) {    guard let tag = tags.first else {        session.restartPolling()        return    }
    session.connect(to: tag) { error in        if let error {            session.invalidate(errorMessage: "Connection failed: \(error)")            return        }
        tag.queryNDEFStatus { status, capacity, error in            guard error == nil else {                session.invalidate(errorMessage: "Query failed.")                return            }
            switch status {            case .notSupported:                session.invalidate(errorMessage: "Tag is not NDEF compliant.")            case .readOnly:                tag.readNDEF { message, error in                    if let message {                        self.processMessage(message)                    }                    session.invalidate()                }            case .readWrite:                tag.readNDEF { message, error in                    if let message {                        self.processMessage(message)                    }                    session.alertMessage = "Tag read successfully."                    session.invalidate()                }            @unknown default:                session.invalidate()            }        }    }}

Tag Reader Session

Use NFCTagReaderSession when you need direct access to the native tag protocol (ISO 7816, ISO 15693, FeliCa, or MIFARE).

Polling optionTags
.iso14443ISO 7816-compatible and MIFARE
.iso15693ISO 15693
.iso18092FeliCa

Do not use this session for payment-related AIDs. Load nfc-patterns.md [blocked] for protocol-specific connection, APDU, command, and response handling.

Writing NDEF Messages

Write NDEF data to a connected tag. Always check readWrite status first.

swift
func writeToTag(    tag: any NFCNDEFTag,    session: NFCNDEFReaderSession,    url: URL) {    tag.queryNDEFStatus { status, capacity, error in        guard status == .readWrite else {            session.invalidate(errorMessage: "Tag is read-only.")            return        }
        guard let payload = NFCNDEFPayload.wellKnownTypeURIPayload(            url: url        ) else {            session.invalidate(errorMessage: "Invalid URL.")            return        }
        let message = NFCNDEFMessage(records: [payload])
        tag.writeNDEF(message) { error in            if let error {                session.invalidate(                    errorMessage: "Write failed: \(error.localizedDescription)"                )            } else {                session.alertMessage = "Tag written successfully."                session.invalidate()            }        }    }}

NDEF Payload Types

Creating Common Payloads

swift
// URL payloadlet urlPayload = NFCNDEFPayload.wellKnownTypeURIPayload(    url: URL(string: "https://example.com")!)
// Text payloadlet textPayload = NFCNDEFPayload.wellKnownTypeTextPayload(    string: "Hello NFC",    locale: Locale(identifier: "en"))
// Custom payloadlet customPayload = NFCNDEFPayload(    format: .nfcExternal,    type: "com.example:mytype".data(using: .utf8)!,    identifier: Data(),    payload: "custom-data".data(using: .utf8)!)

Parsing Payload Content

Load Parsing NDEF Payload Content [blocked] for the complete type-name-format switch and multi-record handling.

Background Tag Reading

On iPhone XS and later, iOS can read NFC tags in the background without opening your app. The NDEF message must contain a URI record (typeNameFormat == .nfcWellKnown, type U). If there are multiple URI records, the system uses the first one.

For app-specific routing, write a universal link to the tag and configure the Associated Domains capability for that domain. Background tag reading also supports specific system URL schemes such as web, email, SMS, telephone, FaceTime, Maps, and HomeKit setup. It does not support custom URL schemes, and the system does not route by bundle ID or arbitrary NDEF content type.

When a user taps a compatible tag, iOS displays a notification that opens your app. Handle the tag data via NSUserActivity:

swift
func scene(    _ scene: UIScene,    continue userActivity: NSUserActivity) {    guard userActivity.activityType ==        NSUserActivityTypeBrowsingWeb else { return }
    let message = userActivity.ndefMessagePayload    guard message.records.first?.typeNameFormat != .empty else { return }
    for record in message.records {        processRecord(record)    }}

Common Mistakes

DON'T: Use stale or missing NFC entitlements

Without the com.apple.developer.nfc.readersession.formats entitlement, reader sessions cannot access NFC hardware. Use the current TAG value for Core NFC reader sessions; do not copy older examples that add NDEF.

DON'T: Ignore session invalidation errors

The session invalidates for multiple reasons. Distinguishing user cancellation from real errors prevents false error alerts.

swift
// WRONG -- shows error when user cancelsfunc readerSession(    _ session: NFCNDEFReaderSession,    didInvalidateWithError error: Error) {    showAlert("NFC Error: \(error.localizedDescription)")}
// CORRECT -- filter expected invalidation reasonsfunc readerSession(    _ session: NFCNDEFReaderSession,    didInvalidateWithError error: Error) {    let nfcError = error as? NFCReaderError    switch nfcError?.code {    case .readerSessionInvalidationErrorUserCanceled,         .readerSessionInvalidationErrorFirstNDEFTagRead:        break  // Normal termination    default:        showAlert("NFC Error: \(error.localizedDescription)")    }    self.session = nil}

DON'T: Hold a strong reference to a stale session

Once a session is invalidated, it cannot be restarted. Nil out your reference and create a new session for the next scan.

swift
// WRONG -- reusing invalidated sessionfunc scanAgain() {    session?.begin()  // Does nothing, session is dead}
// CORRECT -- create a new sessionfunc scanAgain() {    session = NFCNDEFReaderSession(        delegate: self, queue: nil, invalidateAfterFirstRead: false    )    session?.begin()}

Review Checklist

  • NFC capability added in Signing & Capabilities
  • NFCReaderUsageDescription set in Info.plist
  • com.apple.developer.nfc.readersession.formats entitlement uses TAG, not legacy NDEF
  • NFCNDEFReaderSession.readingAvailable or NFCTagReaderSession.readingAvailable checked before creating sessions
  • Session delegate set before calling begin()
  • Session reference set to nil after invalidation
  • didInvalidateWithError distinguishes user cancellation from actual errors
  • NDEF status queried before write operations
  • Tag capacity checked before writing large messages
  • ISO 7816 application identifiers listed in Info.plist if using NFCTagReaderSession
  • FeliCa system codes listed in Info.plist when polling .iso18092
  • Background tag reading uses a URI NDEF record and universal links or supported system URL schemes
  • Custom URL schemes, bundle IDs, or arbitrary NDEF content types are not used for background routing
  • Payment-related AIDs are routed away from NFCTagReaderSession
  • Only one reader session active at a time

References

来源与署名

来源：dpearson2699/swift-ios-skills位于skills/core-nfc提交8d90fd1

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 dpearson2699/swift-ios-skills 的技能

Widgetkit

dpearson2699

指导实现、审查和改进 iOS、iPadOS、watchOS 与 CarPlay 上的 WidgetKit 小组件和控制项。

Software Development1.1K2个月前更新

Weatherkit

dpearson2699

指导 iOS 开发者使用 WeatherService 获取 WeatherKit 预报、警报与署名信息。

Software Development1.1K2个月前更新

Vision Framework

dpearson2699

Implement computer vision features including text recognition (OCR), face detection, barcode scanning, image segmentation, object tracking, and document scanning in iOS apps. Covers both the modern Swift-native Vision API (iOS 18+) and legacy VNRequest patterns, VisionKit DataScannerViewController for live camera scanning, and CoreMLRequest/VNCoreMLRequest for custom model inference. Use when adding OCR, barcode scanning, face detection, or custom Core ML model inference with Vision.

待分类1.1K2个月前更新

Tipkit

dpearson2699

Implement and review Apple TipKit feature-discovery UI for iOS 17+ apps. Use when adding or auditing in-app tips, contextual help, coach marks, Tip, TipView, popoverTip, rules, events, actions, display frequency, testing overrides, reusable tip identifiers, or iOS 18+ TipGroup and CloudKit tip sync; avoid for generic SwiftUI navigation or layout outside tip presentation.

待分类1.1K2个月前更新

Tabletopkit

dpearson2699

指导使用 TabletopKit 在 visionOS 上构建多人空间桌游，涵盖棋具、座位、动作与 RealityKit 渲染。

Software Development1.1K2个月前更新

Swiftui Webkit

dpearson2699

指导在 iOS 26 及更高版本的 SwiftUI 应用中使用 WebKit for SwiftUI 嵌入和控制网页内容。

Software Development1.1K2个月前更新

更多Software Development技能

Playground

anthropics

精选

构建自包含的交互式 HTML 演练场，包含控件、实时预览和可复制的提示词输出。

Software Development37K今天更新

M5 Onboard

anthropics

精选

通过 USB 检测 M5Stack ESP32 开发板，刷写 UIFlow 2.0 固件并安装 MicroPython 应用包。

Software Development37K今天更新

Cardputer Buddy

anthropics

精选

指导迭代 Cardputer-Adv 的 MicroPython 应用包：添加应用、通过 USB 串口推送文件、查看日志并运行 REPL 命令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精选

依据从远程来源获取的 Web Interface Guidelines 审查 UI 代码，并以 file:line 形式报告问题。

Software Development32K5周前更新

Vercel React Native Skills

vercel-labs

精选

React Native 与 Expo 最佳实践规则，涵盖列表性能、动画、导航、UI 模式、状态与 monorepo 配置。

Software Development32K5周前更新

Vercel React Best Practices

vercel-labs

精选

Vercel 的 React 与 Next.js 性能指南，以 70 条规则的形式用于编写、审查和重构代码。

Software Development32K5周前更新