Реалізація Universal Clipboard між Apple-пристроями
Universal Clipboard — частина Continuity. Користувач копіює текст, посилання або зображення на iPhone і вставляє на Mac або iPad без будь-яких додаткових дій. З точки зору розробника це працює через UIPasteboard.general на iOS та NSPasteboard.general на macOS — система сама синхронізує вміст через Handoff-інфраструктуру.
Що потрібно зробити в програмі
Більшість завдань, пов'язаних з Universal Clipboard, — це правильна робота з системним буфером обміну, а не спеціальна інтеграція з Continuity. Якщо програма коректно пише та читає UIPasteboard.general, Universal Clipboard працює автоматично.
Запис в буфер:
// Текст
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
}
Обмеження, про які потрібно знати
Privacy change в iOS 16+. При читанні UIPasteboard.general з фону або без явної дії користувача система показує системний баннер «[App] pasted from [Device]». Це не баг — це навмисна поведінка Apple для конфіденційності. Відключити його неможливо.
Розмір даних. Буфер обміну не призначений для великих файлів. Зображення розміром більше кількох МБ сповільнюють синхронізацію між пристроями. Для передачі файлів використовуйте AirDrop або iCloud.
Чутливі дані. UIPasteboard.general — публічний буфер, його читає будь-яка програма. Для паролів та токенів краще показувати кнопку «Копіювати» з явною дією користувача, а не копіювати автоматично.
Приватний pasteboard. Для внутрішніх операцій всередині програми (drag and drop між компонентами) використовуйте UIPasteboard(name:create:) з унікальним ім'ям — такий буфер недоступний іншим програмам і не синхронізується через Continuity.
Коли це не Universal Clipboard, а щось інше
Якщо завдання — синхронізувати дані між пристроями у фоні, без участі користувача — це не Clipboard, це CloudKit або iCloud Documents. Clipboard — тільки явне копіювання/вставка.
Якщо потрібно передати дані одним рухом без буфера — AirDrop через UIActivityViewController.
Що входить до роботи
- Правильне API запису в
UIPasteboardз підтримкою кількох UTTypes - Читання з перевіркою доступних типів
- Обробка privacy banner (iOS 16+) — інформування користувачів
- При необхідності: приватний pasteboard для внутрішніх операцій
- Тестування на двох пристроях з одним Apple ID
Терміни
2–3 дні з урахуванням тестування на фізичних пристроях. Якщо завдання обмежується роботою з буфером обміну всередину однієї програми — 1 день. Вартість розраховується індивідуально.