Краш при попытке печати PDF из-за отсутствия принтера в системе — типичная ситуация при разработке корпоративного мобильного приложения. Особенно когда поддержка AirPrint и Android Print Framework реализована через костыли. Мы решаем задачу печати документов из мобильного приложения — от накладных до этикеток. Первый краш-репорт из-за нулевого числа принтеров в системе или невозможности напечатать PDF на принтере конкурирующего вендора — типичная боль. Наша команда имеет 5+ лет опыта в интеграции AirPrint, Android Print Framework и прямых SDK (Zebra, TSC, ATOL). Предлагаем готовые решения под ключ за 1-3 недели.
Согласно документации Apple, AirPrint доступен на iOS 4.2 и выше, поддерживая большинство современных Wi-Fi принтеров.
Проблемы, которые решаем
Разные каналы печати — разные сложности. iOS требует AirPrint, Android — PrintManager, а корпоративные принтеры Zebra — прямой TCP/IP. Без правильной архитектуры вы столкнётесь с несовместимостью принтеров, проблемами производительности и сложностью шаблонов.
- Несовместимость принтеров. Mopria Print Service — стандарт для Android, но не все модели поддерживают его. AirPrint ограничен принтерами с поддержкой Bonjour. Приходится проектировать fallback-механизмы.
- Производительность. Печать 10-страничного PDF через PrintDocumentAdapter требует буферизации в ParcelFileDescriptor — неоптимизированный код приводит к ANR. Мы используем асинхронную запись с CancellationSignal.
- Шаблоны документов. HTML → WebView → печать — быстрее, чем рисование через Canvas, но требует точной вёрстки под @media print. На iOS — кастомный UIPrintPageRenderer с Core Graphics для чеков.
Как мы это делаем: стек и кейс
Для одного из ритейлеров мы внедрили печать этикеток и чеков за 2 недели. Стек: Android Kotlin + Jetpack Compose, iOS SwiftUI, Zebra ZPL через TCP, Epson TM-T88V через ESCPOS Bluetooth. Документы A4 — через WebView (HTML+CSS в assets). Этикетки — серверные шаблоны с заполнением на клиенте. Результат: время печати 1.5 секунды, ноль крашей.
Почему WebView — недооценённый инструмент для печати?
WebView.createPrintDocumentAdapter() на Android и UIPrintPageRenderer с UIGraphicsBeginPDFContextToData на iOS позволяют рендерить сложные HTML-шаблоны. Поддержка @page и page-break-before даёт контроль над разрывами. Это в 3 раза быстрее рисования через Canvas и проще в поддержке — дизайнер меняет CSS, а не код.
Как интегрировать печать этикеток Zebra?
Используем Zebra Link-OS SDK: устанавливаем TCP-соединение на порт 9100, отправляем ZPL-команды. Шаблоны этикеток храним на сервере в виде строк с плейсхолдерами, на клиенте заполняем через String.format. Для динамических штрихкодов применяем команды ^BC или ^BQ. Важно настроить DPI: для этикеток 203 dpi, для документов — 300.
Процесс работы
- Анализ сценариев — какие документы, тип принтеров, частота печати.
- Проектирование архитектуры — выбор каналов (AirPrint / PrintManager / SDK), шаблонизация.
- Реализация — код интеграции, тестирование на реальном железе (5+ моделей).
- Тестирование — нагрузочное (10+ страниц), граничные случаи (нет принтера, ошибки связи).
- Деплой и документация — инструкция для пользователя, поддержка.
Что входит в работу
- Разработка модуля печати под iOS и/или Android.
- Интеграция с AirPrint, Android Print Framework, SDK принтеров (Zebra, Epson, TSC, ATOL).
- Создание шаблонов документов (HTML+CSS, ZPL, ESCPOS).
- Тестирование на 3-5 моделях принтеров.
- Документация по развертыванию и настройке.
- Поддержка 1 месяц после сдачи.
Сроки ориентировочно
| Тип интеграции | Срок |
|---|---|
| Документы A4 (AirPrint + Print Framework) | 1-2 недели |
| Этикетки Zebra (ZPL) | 1-2 недели |
| Чеки (ESCPOS, 54-ФЗ) | 2-3 недели |
| Комплексное решение (все типы) | 2-4 недели |
Стоимость рассчитывается индивидуально. Оценим ваш проект по ТЗ за 1 день — свяжитесь с нами.
Выбор подхода по сценарию
| Сценарий | Подход |
|---|---|
| Документы A4 (накладные, акты) | WebView → PrintDocumentAdapter / AirPrint |
| PDF из сервера | PrintDocumentAdapter с ParcelFileDescriptor / UIPrintInteractionController |
| Этикетки Zebra ZPL | Zebra Link-OS SDK, прямой TCP |
| Чеки на термопринтерах | ESCPOS через Bluetooth или TCP |
| Кассовые чеки (54-ФЗ) | ATOL SDK / Эвотор SDK |
Пример кода для печати PDF на Android (Kotlin)
val printManager = getSystemService(Context.PRINT_SERVICE) as PrintManager
val jobName = "Document_${System.currentTimeMillis()}"
printManager.print(jobName, object : PrintDocumentAdapter() {
override fun onLayout(oldAttr: PrintAttributes?, newAttr: PrintAttributes, cancellationSignal: CancellationSignal, callback: LayoutResultCallback, extras: Bundle?) {
if (cancellationSignal.isCanceled) {
callback.onLayoutCancelled(); return
}
val info = PrintDocumentInfo.Builder(jobName)
.setContentType(PrintDocumentInfo.CONTENT_TYPE_DOCUMENT)
.setPageCount(pageCount)
.build()
callback.onLayoutFinished(info, oldAttr != newAttr)
}
override fun onWrite(pages: Array<out PageRange>, destination: ParcelFileDescriptor, cancellationSignal: CancellationSignal, callback: WriteResultCallback) {
// Write PDF bytes to destination.fileDescriptor
}
}, null)Типичные ошибки и чек-лист
- Несоответствие DPI. Для этикеток Zebra используйте 203 dpi, для документов — 300.
- Забывают про CancellationSignal. Без него пользователь не сможет отменить печать.
- Хранение ZPL-шаблонов в коде. Лучше на сервере — обновления без публикации.
- Нет тестов на реальных принтерах. Эмулятор не покажет проблемы с буферизацией.
Получите консультацию по вашему проекту — оценим за 1 день и поможем выбрать оптимальное решение.
