Aplikasi BookTracker

BookTracker adalah aplikasi seluler yang dirancang untuk membantu pengguna mengelola dan melacak kemajuan membaca mereka. Aplikasi ini menyediakan fitur untuk mencatat halaman terakhir yang Anda baca dari sebuah buku, memvisualisasikan aktivitas membaca, dan menemukan buku baru melalui integrasi Google Books.

Fitur Utama

• Pelacakan Kemajuan Membaca: Catat dengan mudah halaman terakhir yang Anda baca di buku apa pun. Data ini disimpan menggunakan SwiftData dan dikelola oleh BookService.
• Dasbor Aktivitas Membaca: Visualisasikan kebiasaan dan riwayat membaca Anda melalui dasbor aktivitas yang intuitif, termasuk peta panas (heatmap) yang dihasilkan dari sesi membaca Anda. Aktivitas membaca dimuat dan ditampilkan dari data ReadingSession melalui BookService.
• Berbagi Laporan Aktivitas Membaca: Buat dan bagikan kartu visual aktivitas membaca 6 bulan Anda, lengkap dengan QR code untuk mempromosikan aplikasi.
• Pemindai Halaman Otomatis: Gunakan kamera perangkat Anda untuk memindai nomor halaman secara cepat dan akurat, membuat pembaruan progres membaca Anda lebih mudah. (Didukung oleh VisionKit)
• Integrasi Google Books: Cari buku menggunakan Google Books API. Aplikasi ini memungkinkan Anda menambahkan buku ke perpustakaan dengan mengambil detail dan gambar sampul langsung dari Google Books.
• Manajemen Buku: Tambah, edit, dan lihat detail buku Anda.
• Tema Dinamis: Seluruh antarmuka aplikasi, termasuk kartu yang dapat dibagikan, secara otomatis beradaptasi dengan pengaturan mode terang atau gelap sistem Anda untuk pengalaman visual yang nyaman.

Penyempurnaan & Pengalaman Pengguna (UX)

• Pengalaman Pengguna Baru yang Ditingkatkan: Tampilan kosong yang ramah di layar utama kini memandu pengguna baru untuk menambahkan buku pertama mereka.
• Umpan Balik Pengguna yang Lebih Baik: Lembar "Update Progres" (Update Progress) memberikan umpan balik yang jelas dan kontekstual jika nomor halaman tidak valid, mencegah kesalahan pengguna.
• Penanganan Izin yang Andal: Aplikasi menangani izin kamera dan perpustakaan foto dengan baik, memandu pengguna ke pengaturan sistem jika akses ditolak.
• Layar "Tentang" Dinamis: Halaman "Tentang" secara otomatis menampilkan versi aplikasi saat ini dan nomor build dari Info.plist proyek.
• Dukung Developer: Halaman khusus memungkinkan pengguna untuk mendukung pengembangan aplikasi melalui berbagai platform donasi.

Arsitektur

Aplikasi ini dibangun mengikuti pola arsitektur MVVM (Model-View-ViewModel), yang mendorong pemisahan tanggung jawab yang jelas:

• Model: Struktur data yang mewakili entitas inti aplikasi, seperti Book dan ReadingSession, yang dipertahankan menggunakan SwiftData.
• View: Komponen UI yang bertanggung jawab untuk menyajikan informasi kepada pengguna (misalnya, HomeView, BookEditorView).
• ViewModel: Bertindak sebagai perantara antara View dan Model, menangani logika tampilan, manajemen status, dan mengatur aliran data (misalnya, HomeViewModel, BookEditorViewModel).
• Layanan (Services): Lapisan layanan khusus (BookService, GoogleBooksService) merangkum logika bisnis, operasi persistensi data (SwiftData), dan interaksi API eksternal (Google Books API).

Dependency Injection

Aplikasi ini menggunakan sistem Dependency Injection (DI) berbasis singleton yang terpusat melalui kelas Injection. Pola ini memastikan bahwa dependensi dibuat dan dikelola secara konsisten di seluruh aplikasi, meningkatkan modularitas dan kemampuan pengujian.

• Setup Terpusat: Instans ModelContainer disediakan ke Injection.shared sekali saat aplikasi dimulai (BookTrackerApp.swift).
• Penyedia Dependensi: Injection menyediakan metode khusus (misalnya, provideHomeViewModel(), provideBookEditorViewModel(book:)) yang bertanggung jawab untuk membuat ViewModel dan secara otomatis menyuntikkan Layanan yang dibutuhkan.
• Penggunaan yang Bersih: View atau ViewModel tidak secara langsung membuat dependensinya, melainkan memintanya dari Injection.shared. Hal ini membuat kode lebih bersih dan lebih mudah untuk dipahami alur dependensinya.

Teknologi yang Digunakan

• Swift: Bahasa pemrograman utama.
• SwiftUI: Untuk membangun antarmuka pengguna deklaratif.
• SwiftData: Untuk persistensi dan manajemen data lokal.
• Google Books API: Untuk mencari dan mengambil informasi buku.
• VisionKit: Digunakan untuk fungsionalitas pemindaian halaman otomatis.
• CoreImage: Digunakan untuk menghasilkan QR code pada kartu berbagi.

Pengujian Unit (Unit Testing)

Proyek ini mencakup pengujian unit untuk lapisan layanannya guna memastikan keandalan dan kebenbasan. Secara khusus:

• BookServiceTest.swift: Menguji logika inti untuk mengelola buku dan sesi membaca.
• GoogleBookServiceTest.swift: Menguji integrasi dengan Google Books API, menggunakan MockURLProtocol untuk mensimulasikan respons jaringan dan memastikan pengujian yang terisolasi danandal.

Memulai

(Instruksi tentang cara menyiapkan dan menjalankan proyek akan ditambahkan di sini.)

Run di Simulator pake terminal

1

xcodebuild -project BookTracker.xcodeproj
-scheme BookTracker
-configuration Debug
-sdk iphonesimulator
-derivedDataPath build

2

xcrun simctl install booted build/Build/Products/Debug-iphonesimulator/BookTracker.app

3

xcrun simctl launch booted id.ios.rajaongkirios.BookTracker