macOS
У macOS Hokusai підключає libvips і Cairo із системи, на практиці — з Homebrew. Усе, що запускає ваш бінарний файл, потребує цих встановлених бібліотек.
Встановлення
Section titled “Встановлення”brew install vips cairo pkg-configbrew install pango # лише якщо використовуєте HokusaiPDFHokusai потребує macOS 13 або новішої, Swift 6.0 або новішого, libvips 8.16+ і Cairo 1.16+. Перевірте, що ви отримали:
pkg-config --modversion vips cairo # напр. 8.18.7 і 1.18.6swift run hokusai info # або зібраний архів hokusai із релізу на GitHubhokusai info друкує формати та можливості вашого встановлення (HEIF, AVIF, відтворення тексту, вхід PDF), тобто те, що може використовувати ваш код (Середовище виконання).
Додавання Hokusai
Section titled “Додавання Hokusai”dependencies: [ .package(url: "https://github.com/ivantokar/hokusai.git", from: "2.0.0")],targets: [ .executableTarget(name: "MyTool", dependencies: [ .product(name: "Hokusai", package: "hokusai"), // .product(name: "HokusaiPDF", package: "hokusai"), // векторні PDF-документи // .product(name: "HokusaiNIO", package: "hokusai"), // ByteBuffer зі SwiftNIO ])]Виконувані приклади
Section titled “Виконувані приклади”Кожне зображення й кожен блок коду в цій документації створює пакет SwiftPM у репозиторії, тож він водночас слугує проєктом macOS, з якого можна почати:
git clone https://github.com/ivantokar/hokusai-docs.gitcd hokusai-docs/examplesswift run DocsExamples run resize # виконати приклади, ідентифікатор яких починається з «resize»swift run DocsExamples run # виконати всі; результати йдуть у ../public/generatedПопередження лінкера
Section titled “Попередження лінкера”Збірка з бібліотеками Homebrew друкує попередження такого вигляду:
ld: warning: building for macOS-13.0, but linking with dylib '/opt/homebrew/opt/vips/lib/libvips.42.dylib' which was built for newer version 27.0Вони нешкідливі під час збірки й повідомляють щось справжнє: бібліотеки Homebrew орієнтовані на новішу macOS, ніж мінімум пакета (13), тож бінарний файл, зібраний так, працює на версіях macOS, які підтримують ваші бібліотеки Homebrew. Якщо ви поширюєте бінарний файл іншим Mac, на них потрібні сумісні libvips і Cairo (установлені або вбудовані вами): Hokusai не вбудовує нативні бібліотеки.
У застосунку
Section titled “У застосунку”Конвеєри — це незмінні значення, а завершальні операції async, тож вони безпосередньо пасують до застосунку зі Swift concurrency: будуйте конвеєр на будь-якому акторі, виконуйте в Task і передавайте Output.data в NSImage чи Image. Скасовуйте завдання, коли користувач змінює вхід; завершальна операція викидає CancellationError, і нічого напівзаписаного не лишається. Налаштовуйте RuntimeConfiguration один раз під час запуску, до першого виконання.