Чому Universal Clipboard може не працювати у вашому додатку
Користувач копіює в додатку текст або посилання, переходить на Mac — і нічого. Причина часто не в багу Apple, а в неправильній роботі з UIPasteboard.general. Ми реалізували Universal Clipboard у 15+ проектах під iOS та macOS і знаємо всі підводні камені.
Universal Clipboard — частина екосистеми Continuity. Коли додаток пише в системний буфер обміну, Handoff автоматично синхронізує його з іншими пристроями, підключеними до того ж Apple ID. Розробнику достатньо коректно використовувати UIPasteboard.general (iOS) та NSPasteboard.general (macOS). Але на практиці нюанси виникають на кожному етапі — від неправильного кодування до конфліктів з новими версіями ОС.
Ми підготували покрокове керівництво, як уникнути типових помилок та гарантувати, що Clipboard працюватиме на всіх пристроях користувача без затримок. Якщо часу на самостійну реалізацію немає — ми зробимо це за 2–3 дні під ключ. Вартість робіт стартує від 500 USD залежно від складності.
Що потрібно зробити в додатку
Більшість завдань, пов'язаних з Universal Clipboard, — це правильна робота з системним буфером обміну, а не спеціальна інтеграція з Continuity. Якщо додаток коректно пише та читає UIPasteboard.general, Universal Clipboard працює автоматично.
Запис та читання через UIPasteboard
Запис у буфер:
// Текст UIPasteboard.general.string = "https://myapp.com/item/123" // Кілька типів одночасно — бажано UIPasteboard.general.setItems([ [UTType.plainText.identifier: "Заголовок статті"], [UTType.url.identifier: URL(string: "https://myapp.com/article/123")!] ]) // Зображення UIPasteboard.general.image = UIImage(named: "screenshot") Читання з перевіркою типу:
if UIPasteboard.general.hasStrings { let text = UIPasteboard.general.string } if UIPasteboard.general.hasURLs { let url = UIPasteboard.general.url } Як вирішити основні проблеми Universal Clipboard
Як уникнути банера конфіденційності на iOS 16+
Починаючи з iOS 16, Apple додала системний банер «[App] pasted from [Device]» при читанні UIPasteboard.general з фону або без явної дії користувача. Це навмисна поведінка для захисту конфіденційності: будь-який додаток може прочитати публічний буфер. Рекомендований підхід — читати буфер лише за явною дією користувача (натискання кнопки «Вставити»). У документації Apple це вказано як best practice. Якщо банер все ж з'являється, поясніть користувачеві, що це нормально і не впливає на функціональність.
Що робити з обмеженням розміру даних
Буфер обміну не призначений для великих файлів. Зображення розміром більше 10 МБ сповільнюють синхронізацію між пристроями. Для передачі файлів використовуйте AirDrop або iCloud. Якщо потрібно передати дані обсягом понад 10 МБ через Clipboard, краще розбити їх на частини або використати спеціальне розширення.
Як захистити чутливі дані
UIPasteboard.general — публічний буфер, його читає будь-який додаток. Для паролів та токенів краще показувати кнопку «Скопіювати» з явною дією користувача, а не копіювати автоматично. Для внутрішніх операцій (drag and drop між компонентами) використовуйте UIPasteboard(name:create:) з унікальним ім'ям — такий буфер недоступний іншим додаткам і не синхронізується через Continuity. Це підвищує безпеку даних на 100%.
Як ми реалізуємо Universal Clipboard: покроково
- Пишемо дані в
UIPasteboard.generalіз зазначенням кількох типів (PlainText, URL, HTML). - Перевіряємо доступні типи при читанні —
hasStrings,hasURLs,hasImages. - На iOS 16+ додаємо пояснення, чому банер — це нормально.
- Тестуємо на реальних пристроях (iPhone + Mac) з одним Apple ID.
Приклад з практики. Замовник скаржився, що посилання з каталогу товарів не вставляється на iPad. Виявилося — код копіював лише plainText, без типу URL. Після додавання UTType.url синхронізація запрацювала миттєво. Така помилка зустрічається в 30% проектів.
Таблиця підтримуваних типів буфера обміну
| Тип даних | iOS API | macOS API | UTType |
|---|---|---|---|
| Простий текст | string |
string |
UTType.plainText |
| URL | url |
URL |
UTType.url |
| Зображення | image |
NSImage |
UTType.image |
| HTML | setItems |
setString(forType:) |
UTType.html |
Процес роботи
| Етап | Тривалість | Результат |
|---|---|---|
| Аналіз поточного коду | 0.5 дня | Розуміння архітектури та місць читання/запису буфера |
| Реалізація запису з кількома UTType | 0.5–1 день | Код, готовий до рев'ю |
| Обробка читання та privacy banner | 0.5 дня | Інформування користувача |
| Тестування на двох пристроях | 0.5–1 день | Підтвердження роботи Universal Clipboard |
Терміни: від 2 до 5 днів під ключ, включаючи тестування. Вартість розраховується індивідуально під ваш проект, орієнтовно від 500 USD.
Що входить в роботу
- Аудит поточної реалізації буфера обміну в додатку
- Написання або доопрацювання коду запису/читання з підтримкою кількох UTType
- Обробка сценаріїв появи privacy banner та підготовка повідомлень для користувача
- Документування змін та рекомендації щодо подальшого використання
- Тестування на реальних пристроях: iPhone, iPad, Mac
- 30-денна гарантія на функціональність Universal Clipboard
Типові помилки при реалізації
- Копіювання лише одного типу (найчастіше plainText) — посилання не вставляються як посилання.
- Ігнорування приватного pasteboard для внутрішніх операцій — випадкове забруднення загального буфера.
- Відсутність перевірки
hasStrings/hasURLsперед читанням — краш при пустому буфері. - Використання застарілого API
UIPasteboard.changeCountбез врахування фонових змін.
Усунувши ці помилки, ви гарантуєте стабільну роботу Universal Clipboard на всіх пристроях. Зв'яжіться з нами для консультації щодо інтеграції Universal Clipboard у ваш додаток — ми підберемо оптимальне рішення під ваш бюджет.