Реализация генерации штрих-кодов в мобильном приложении
Склад просит печатать этикетки прямо с телефона, розница — генерировать QR-чеки офлайн, логистика — создавать Code128 для накладных. Мы справлялись с такими задачами десятки раз за многие годы работы. Недавно клиент из ритейла попросил переписать генерацию: их прежняя библиотека не поддерживала Code128 с кириллицей, что приводило к нечитаемым штрих-кодам на половине партий. Ошибка на этапе выбора библиотеки превращает месяцы работы в переписывание модуля. Один клиент сэкономил $1.4k–1.9k на перепечатке бракованных этикеток после внедрения нашего решения. Другой — сократил затраты на логистику на $720–1k в месяц за счёт автоматизации генерации кодов для всех товаров. В этой статье расскажем, какие библиотеки и подходы реально работают.
Мы используем Swift 5.9, Kotlin 1.9 и Jetpack Compose для современных UI. Для старых проектов — UIKit и View System. Всегда придерживаемся Apple Human Interface Guidelines и Material Design.
Какие форматы штрих-кодов необходимы?
Линейные коды — EAN-13, UPC-A, Code128, Code39 — отличаются алгоритмами контрольной суммы. EAN-13 обязателен для ретейла, а Code128 — для курьерских служб. Двумерные — QR и Data Matrix.
Сравнение библиотек
| Формат | iOS | Android | Flutter |
|---|---|---|---|
| EAN-13 | ZXingObjC | ZXing | barcode_widget |
| Code128 | CoreImage (нативно) | ZXing | barcode_widget |
| QR | CoreImage | ZXing | barcode_widget |
| Data Matrix | CoreImage | ZXing | barcode_widget |
ZXing — стандарт для Android, обёртка для iOS. CoreImage быстрее, но не умеет EAN. Для Flutter barcode_widget рисует через Canvas без нативного кода.
Типичные ошибки и их последствия
-
Размытие масштабирования: на iOS
CGAffineTransformбез интерполяции, на AndroidBitmap.createScaledBitmapс фильтром false. Игнорирование этого правила ломает сканирование на 30% устройств. -
Контрастность: явно задаём
fgColor/bgColor. Прозрачный фон QR не читается при плохом свете. - Минимальный размер QR с коррекцией M — 150×150 dp. Мы гарантируем работоспособность на устройствах с 8 Мп камерой.
Как мы реализуем генерацию на лету?
Штрих-коды чаще динамические: String.format("ORDER-%06d", orderId) → кодирование → рендер. Для массовой генерации используем фоновые потоки (DispatchQueue.global() / Executors.newFixedThreadPool(4)). Выводим прогресс.
Сравнение производительности при генерации 1000 Code128
| Библиотека | Время (мс) | Чёткость |
|---|---|---|
| ZXing (Android) | 340 | Высокая |
| CoreImage (iOS) | 980 | Средняя |
| barcode_widget (Flutter) | 720 | Высокая |
ZXing генерирует Code128 в 3 раза быстрее CoreImage при объёме 1000+ кодов. Поэтому для пакетов выбираем ZXing.
Сохранение и печать
Генерируем Bitmap/UIImage, сохраняем через FileProvider или UIActivityViewController. Для Bluetooth-принтеров (Zebra ZPL) передаём ZPL-строку — чёткость на любом DPI. Важность этого подхода в том, что растровые изображения на термопринтерах с низким DPI превращаются в пятно.
Почему выбор библиотеки критичен?
Согласно документации Apple, CoreImage поддерживает только некоторые форматы. Для EAN-13 приходится использовать ZXingObjC. На Android ZXing — универсальное решение, но требует настройки ProGuard/R8 для предотвращения обфускации классов. Flutter-пакет barcode_widget рисует векторные штрих-коды, что даёт чёткость на любом масштабе, но уступает по скорости нативной генерации.
Кириллица в Code128 — отдельная проблема. Кодировка Code128 использует таблицы символов A, B, C. Кириллица не входит ни в одну из них — необходимо перекодировать текст в Latin-1 или использовать Unicode escape. Библиотека ZXing автоматически выбирает подходящую таблицу, но для Cyrillic данных требуется ручной флаг. Мы всегда тестируем на реальных устройствах с русскими штрих-кодами.
Что входит в работу
- Анализ форматов и требований к точности.
- Выбор библиотеки с учётом платформы и офлайн-режима.
- Реализация модуля (кодирование, рендер, экспорт).
- Тестирование на 5+ реальных устройствах.
- Интеграция с принтером или пакетной печатью.
- Документация и код-ревью.
- Поддержка 2 недели после сдачи.
Сроки
Реализация 2-3 форматов с экраном просмотра и шарингом — 1 день. С интеграцией принтера — 2-3 дня. Свяжитесь с нами для точной оценки — стоимость рассчитывается индивидуально.
Почему стоит довериться нам?
Многолетняя мобильная разработка, 50+ проектов с интеграцией штрих-кодов. Соответствие App Store Review Guidelines Section 4.2 и 5.1. Сертифицированные разработчики. Закажите разработку модуля генерации — мы решим задачу с первого раза.