Читання та запис NFC-міток через мобільний застосунок

Реалізація читання/запису NFC-міток через мобільний застосунок

Ми часто стикаємося з ситуацією, коли 30–40% перших запитів до NFC-мітки повертають NFCReaderError.readerTransceiveErrorTagConnectionLost на iOS або IOException: Tag lost на Android. Причина — надто коротке утримання телефону, interference від металевих поверхонь або неправильний тайм-аут сесії. Без системного підходу інтеграція перетворюється на нескінченне налагодження.

Чому виникають помилки читання NFC?

iOS: обмеження CoreNFC

CoreNFC з'явився відносно давно, але повноцінне читання та запис NDEF стало доступним лише в пізніших версіях iOS. Якщо проект таргетує старі версії, половина користувачів залишиться без NFC. Другий камінь — NFCNDEFReaderSession проти NFCTagReaderSession. Перший працює тільки з NDEF-сумісними мітками. Якщо клієнт приніс Mifare Classic, він просто не запрацює: Apple не підтримує цей протокол з міркувань безпеки. Потрібно заздалегідь перевірити тип мітки та використовувати NFCTagReaderSession з NFCMiFareTag для Mifare Ultralight або NFCISO7816Tag для смарт-карт.

Ще одне вузьке місце — Background Tag Reading. Застосунок не запущено, користувач підносить телефон до мітки — система читає NDEF-URI та запускає застосунок. Виглядає магічно, але вимагає com.apple.developer.nfc.readersession.formats в entitlements з NDEF, плюс URL-схему або Universal Link. Якщо забути додати домен в apple-app-site-association, deep link просто не відкриється.

Android: фрагментація NFC-стека

На Android NfcAdapter.ACTION_NDEF_DISCOVERED, ACTION_TAG_DISCOVERED, ACTION_TECH_DISCOVERED — три різних інтенти з різним пріоритетом. Якщо оголосити тільки NDEF, то мітка без NDEF-структури піде в інший застосунок. Foreground dispatch через enableForegroundDispatch() вирішує це, але вимагає чіткого життєвого циклу: вмикати в onResume, вимикати в onPause. Один пропущений виклик — і застосунок починає отримувати NFC-інтенти навіть коли не активний.

Для запису NDEF: якщо мітка write-protected або відформатована під інший тип, tag.connect() зависне або викине IOException. Потрібен явний тайм-аут через tag.setTimeout() і retry-логіка з експоненційним backoff. Наш досвід показує, що грамотна обробка помилок скорочує кількість збоїв втричі.

Як забезпечити стабільне читання NFC на обох платформах?

iOS

Працюємо з CoreNFC через NFCNDEFReaderSession для стандартних сценаріїв та NFCTagReaderSession для нестандартних форматів. Для запису створюємо NFCNDEFMessage з потрібними NFCNDEFPayload. Використовуємо NFCNDEFPayload.wellKnownTypeURIPayload() для URI-записів — це виключає помилки TNF-заголовків. Сесію обгортаємо в async/await через Continuation, щоб не тягнути delegate-ланцюжок. Помилки мапимо на зрозумілі стани — sessionTimeout, tagNotCompatible, writeProtected — і показуємо через нативний alert або власний UI. Середній час читання мітки — 0.3 секунди, 98% сесій завершуються успішно при правильному утриманні.

Android

Використовуємо Ndef та NdefFormatable tech-класи через Tag.getTechList(). Перед записом перевіряємо ndef.isWritable() та ndef.maxSize() — типова помилка: намагатися записати 500 байт на 144-байтну Ntag213. Для форматування чистих міток використовуємо NdefFormatable.format() з мінімальним початковим повідомленням.

Весь NFC-код виносимо в NfcRepository з Flow<NfcEvent>, UI-шар підписується через collectLatest. При повороті екрана сесія не переривається — foreground dispatch відновлюється в onResume. Такий підхід випробуваний на 15+ проектах. Гарантуємо стабільність сесії навіть на складних конфігураціях.

Підтримувані формати міток

Порівняння iOS та Android

Типові помилки та як їх уникнути

• Tag Lost на iOS: збільшити тайм-аут, додати retry, інформувати користувача.
• Write захищеної мітки: перевіряти isWritable() та повідомляти.
• Переривання сесії при повороті екрана Android: винос логіки в репозиторій з Flow.
• Несумісність типів міток: проводити аудит перед розробкою.

Що входить в роботу

• Аудит: визначаємо типи міток, обсяг даних, чи потрібен background reading, платформи. Враховуємо комерційну економію бюджету до 20% за рахунок правильного вибору стека.
• Проектування: вибір tech-класів, архітектура (репозиторій з Flow/async/await).
• Реалізація: unit-тести на mock-тегах (NFCNDEFReaderSessionMock на iOS, MockNdefTag на Android).
• Тестування на реальних мітках NXP, Broadcom, ST Microelectronics.
• Документація з інтеграції та інструкція для користувачів.
• Супровід протягом 30 днів після здачі.

Отримайте консультацію щодо вашого проекту — оцінимо обсяг і терміни. Замовте аудит NFC-інтеграції: ми проаналізуємо ваші мітки, платформи та сценарії використання.

Процес роботи

1. Вивчення — аналіз вимог, типів міток, умов використання.
2. Проектування — вибір стека, створення прототипу сесії.
3. Розробка — реалізація з тестами на емуляторах та реальних пристроях.
4. Тестування — на 10+ зразках міток різних виробників.
5. Запуск — публікація в App Store / Google Play, налаштування background reading.

Терміни та вартість

Базова інтеграція читання/запису NDEF на одній платформі займає 3–5 робочих днів. Якщо потрібні нестандартні формати, background reading або підтримка кількох типів міток — від 2 тижнів. Точну оцінку даємо після аудиту.

Посилання:

• CoreNFC Documentation
• Android NFC Guide

Інтеграція з залізом: BLE, NFC, IoT та HomeKit у мобільних додатках

Коли задача — зв’язати смартфон з фізичним пристроєм, половина проблем знаходиться не в коді, а в прошивці заліза, характеристиках BLE-сервісів та затримках протоколу. Ми, як мобільні розробники, працюємо на стику з firmware-командою, і без розуміння стеку знизу вгору результат непередбачуваний. Ось чому ми завжди починаємо з HCI-логу та специфікації GATT — Apple Developer: Core Bluetooth Framework — це єдиний спосіб уникнути реверс-інжинірингу в польових умовах.

Чому BLE-інтеграція — найчастіша точка відмови?

Bluetooth Low Energy — основний протокол для носимих, медичних пристроїв, розумних замків та промислових датчиків. Core Bluetooth на iOS та BluetoothGatt на Android реалізують одну специфікацію, але поводяться по-різному в крайніх випадках. Статистика наших проектів: більше 70% звернень у підтримку по BLE пов’язані саме з низькорівневими помилками GATT, а не з логікою додатку.

Що робити з помилкою 133 в Android?

Помилка 133 — найчастіша в Android BLE-розробці. Це не «щось пішло не так», а конкретний індикатор переповнення черги GATT або некоректного закриття попереднього з’єднання. Ми лікуємо її двома прийомами: використовуємо чергу операцій над GATT (write, read, notification subscribe строго послідовно через операційну чергу) та завжди викликаємо disconnect() перед close(). Наша черга GATT-операцій у 3 рази знижує кількість помилок ATT_INSUFFICIENT_RESOURCES порівняно з конкурентними запитами. MTU за замовчуванням — 23 байти. Запит на збільшення (MTU exchange) обов’язковий для передачі даних об’ємом понад 20 байт. На iOS MTU запитується автоматично при підключенні, на Android потрібно явно викликати requestMtu(). Без цього ви не зможете передати, наприклад, зображення або лог через характеристику.

NFC: CoreNFC та Android NFC API

iOS підтримує NFC-читання через CoreNFC з версії iOS 11, запис — з iOS 13. Важливе обмеження: сесія сканування активна лише поки живий об’єкт NFCNDEFReaderSession і показує системний UI. Фонове сканування доступне лише для додатків з entitlement com.apple.developer.nfc.readersession.formats і лише для ISO 14443 (банківські картки, паспорти) — і цей entitlement видається не всім. На Android все простіше: NfcAdapter.enableForegroundDispatch() ловить теги у foreground без системного UI. Фоновий запуск додатку по NFC-тегу реалізується через intent-filter з ACTION_NDEF_DISCOVERED. Порівняння платформ по NFC:

HomeKit та Matter

HomeKit — екосистема Apple для розумного дому. Для інтеграції пристрій повинен мати MFi-сертифікацію (або працювати через Software Authentication для Matter). Мобільний додаток використовує HomeKit framework: HMHomeManager → HMHome → HMRoom → HMAccessory → HMService → HMCharacteristic. Matter (раніше CHIP) — крос-платформний стандарт, який підтримують Apple, Google, Amazon та Samsung. На iOS Matter-пристрої додаються через MTRDeviceController, на Android — через Google Home SDK або Matter SDK безпосередньо. Перевага Matter: один пристрій працює з HomeKit, Google Home та Alexa без перепрошивки, а конфігурація налаштовується в 4 рази швидше порівняно з власним HAP-протоколом.

Для Flutter та React Native використовуємо flutter_blue_plus та react-native-ble-plx відповідно — обидва активно підтримуються і покривають 90% сценаріїв, але для роботи з GATT-нотифікаціями у background на Android все одно потрібен foreground service. Переконайтеся, що deep linking (Universal Links на iOS, App Links на Android) налаштовані для коректного пробудження додатку при скануванні NFC-тегу або отриманні push-повідомлення від IoT-пристрою. Вимоги ATT (App Tracking Transparency) для інтеграції з залізом зазвичай не застосовуються, але якщо додаток збирає анонімну аналітику — додайте запит. Отримайте консультацію нашого інженера — він розбере вашу специфікацію за 2 дні.

Як ми інтегруємо BLE та NFC?

1. Аналітика — отримуємо від firmware-команди повну специфікацію BLE GATT (список сервісів, характеристик, формати даних) або HCI-лог. Без цього розробка перетворюється на реверс-інжиніринг через nRF Connect або Wireshark over HCI.
2. Проектування — визначаємо архітектуру підключень: чергу GATT-операцій, фонові сервіси для Android, перепідключення при втраті зв’язку. Враховуємо MTU-узгодження та обробку помилок ATT_INSUFFICIENT_RESOURCES.
3. Реалізація — кодимо на Swift/Kotlin з урахуванням особливостей платформ (Universal Links, App Links, push-повідомлення через APNs/FCM для тригерів). Для захисту Android-коду використовуємо ProGuard / R8 (shrink).
4. Тестування — на реальних пристроях з першого дня. Емулятор BLE в симуляторах не відтворює edge cases перепідключення, втрати сигналу, зміни MTU. Використовуємо автоматизацію на базі XCTest та Espresso.
5. Деплой — завантаження в App Store Connect / Google Play Console з правильним code signing та provisioning profile. Для iOS — TestFlight, для Android — Firebase App Distribution.

Що входить в роботу (deliverables)

• Вихідний код мобільного додатку з інтеграцією BLE, NFC або IoT (Swift / Kotlin / Flutter / React Native)
• Документація по протоколу GATT (карта сервісів та характеристик)
• Навантажувальне тестування на 10+ реальних пристроях (помилка 133, перепідключення, MTU-узгодження)
• Аналіз та усунення edge cases (помилка ATT_INSUFFICIENT_RESOURCES, втрата з’єднання на фоні, конфлікт з background fetch)
• Інструкція зі збірки та деплою (code signing, TestFlight, Firebase App Distribution)
• Місяць підтримки після релізу

Строки та орієнтовна вартість

Проста інтеграція з одним BLE-периферійним пристроєм (показання + команди керування) — від 2 до 4 тижнів. Типова вартість такої задачі розраховується індивідуально, включаючи налагодження GATT-профілю та обробку edge cases. Повноцінний IoT-додаток з декількома типами пристроїв, firmware OTA-оновленнями та HomeKit-підтримкою — від 2 місяців. Вартість розраховується індивідуально під ваш проект.

Ми займаємося мобільною розробкою кілька років — досвід 45+ проектів з BLE/NFC/HomeKit. Наші інженери сертифіковані Apple та Google, а кожен етап роботи фіксується в issue tracker з прив’язкою до комітів. Ми гарантуємо прозорість процесу та дотримання строків. Використовуємо підхід «інженер клієнту»: без маркетингових пауз, з прямим доступом до розробника.

Закажіть оцінку — отримайте консультацію інженера з розбором вашої специфікації. Замовте інтеграцію під ключ: ми проаналізуємо HCI-лог, перевіримо GATT-характеристики та запропонуємо архітектуру за 2 дні.