iOS Integration
Pada iOS (iOS 18+), modul Widget terintegrasi penuh ke dalam sistem operasi melalui widget di Home Screen, Lock Screen, maupun StandBy Mode. Antarmuka dan alur navigasi deep link dibangun sepenuhnya menggunakan SwiftUI modern.
1. Alur Penanganan Deep Link
Ketika pengguna mengetuk widget di Home Screen atau Lock Screen iOS, aplikasi Maktabah diaktifkan dan menangkap tautan melalui modifier .onOpenURL. Alur diproses dalam diagram sekuens modular dengan 4 partisipan:
sequenceDiagram
autonumber
actor User
participant View as iOSMainView
participant Nav as iOSNavigationManager
participant Reader as iOSReaderView
User->>View: Ketuk Widget (maktabah://...)
Note over View: .onOpenURL()<br/>WidgetDeepLink.parse()
rect rgb(240, 248, 255)
Note over View,Reader: Kasus Anotasi / Riwayat
View->>Nav: openBook(book, options:)
Nav-->>View: Update State (selectedBook)
View->>Reader: adaptiveReaderPush()
Note over Reader: Render teks & scroll ke target
end
2. Pemrosesan URL di SwiftUI (iOSMainView)
Penanganan skema URL diintegrasikan pada root view aplikasi:
private func handleOpenURL(_ url: URL, bManager: iOSNavigationManager) {
guard let deepLink = WidgetDeepLink.parse(from: url) else { return }
Task {
switch deepLink {
case let .annotation(annId):
if let annotation = AnnotationStore.shared.loadAnnotationById(annId),
let book = LibraryDataManager.shared.getBook([annotation.bkId]).first
{
await MainActor.run {
bManager.openBook(
book,
options: OpenBookOptions(
contentId: Int(annotation.contentId),
annotationEvent: ReaderAnnotationEvent(annotation: annotation)
)
)
}
}
case let .history(bkId, contentId):
if let book = LibraryDataManager.shared.getBook([bkId]).first {
await MainActor.run {
bManager.openBook(book, options: OpenBookOptions(contentId: contentId))
}
}
}
}
}
- Resolusi Entitas: ID buku dan konten diambil secara efisien melalui
LibraryDataManager.shared.getBook([bkId]). - MainActor Dispatch: Pembaruan state navigasi dipindahkan ke
@MainActoragar perubahan binding UI berjalan mulus tanpa gangguan visual (visual glitch). - Adaptive Reader Push:
iOSNavigationManagermemicu navigasi tumpukan (navigation stack push) pada iPhone atau pembaruan split-detail reader pada iPad.
3. Komponen Antarmuka SwiftUI
Antarmuka widget dioptimalkan untuk berbagai ukuran keluarga widget (WidgetFamily):
AnnotationView&HistoryView: Root view yang mengevaluasi ukuran widget (.systemSmall,.systemMedium,.systemLarge) dan merender state kosong jika data belum tersedia.WidgetContainerView: Menyediakan padding konsisten serta latar belakang material tembus pandang (.thickMaterial) yang menyatu dengan wallpaper iOS.WidgetHeaderView: Menampilkan ikon SF Symbols yang relevan (highlighter,books.vertical.fill) bersanding dengan judul widget.WidgetCardView: Sel kartu modular yang dibungkus denganLink(destination: deepLink.url). Komponen ini memanfaatkanViewThatFitsuntuk beralih secara responsif antara tata letak satu baris dan dua baris padat ketika judul kitab dalam aksara Arab terlalu panjang.TightArabicText: Komponen teks tipografi Arab dengan penyesuaianlineSpacingnegatif agar karakter Arab berharakat dapat ditampilkan secara proporsional tanpa terpotong di dalam kontainer kecil.