- Информация о приложении
- Список используемых технологий и архитектура
- Технические детали реализации
- Какому классу соответствует каждый экран
Информация о приложении К оглавлению
AniShark - мобильное приложение-вики для поиска аниме.
Создатели:
Дизайн собственный, ссылка.
Техническое задание: ссылка
Флоу:
- Домашний экран (видео)
- Каталог (видео)
- Экран фильтров каталога (видео)
- Экран закладок (видео)
- Экран поиска (видео)
- Экран деталей аниме (фото)
- Сплэш-экран(видео) - не совсем флоу, но да ладно
Приложение использует Jikan API как основной источник данных
Сделанные фичи:
| Фича | Стадия |
|---|---|
| Домашний экран | Готово (минорные баги) |
| Каталог | Почти готово |
| Закладки | Готово |
| Фильтры каталога | Готово |
| Поиск | Готово |
| Экран аниме | Готово |
Список используемых технологий К оглавлению
В приложении были использованы:
- Fragments
- ViewModel
- View Binding
- Room (кэширование + хранение закладок аниме на устройстве)
- RxJava
- Retrofit (+ Kotlinx Serialization + HTTP Logging Interceptor)
- Dagger2/Hilt
- Jetpack Preferences DataStore (Rx)
- Ktlint
Архитектура К оглавлению
В приложении используется MVVM и чистая архитектура с 3 слоями - Data, Domain, Presentation. Подробности ниже.
Структура пакетов и устройство приложения К оглавлению
В проекте используется чистая архитектура, то есть в приложении 3 слоя, и это отражается на структуре пакетов:
- Data находится в ru.anishark.data (папка модулей) и включает в
себя
- Подпакет database, в котором находится код, связанный с хранением данных в SQLite БД, используя Room
- Подпакет remote, в котором находится код, связанный с получением данных по сети, используя Retrofit
- Подпакет repository, в котором находятся реализации репозиториев из доменного слоя
- Domain находится в ru.anishark.domain (модуль :
domain) и включает
в себя
- Подпакет model, в котором находятся модели доменного слоя
- Подпакет repository, в котором находятся интерфейсы репозиториев
- Подпакет usecase, в котором находятся юзкейсы
- Presentation находится
в ru.anishark.app.presentation (модуль :app) и
включает в
себя
- Подпакет anime, в котором находится код, связанный с экраном информации об одном аниме
- Подпакет bookmark, в котором находится код, связанный с экраном закладок
- Подпакет catalog, в котором находится код, связанный с экраном каталога
- Подпакет filter, в котором находится код, связанный с экраном фильтра
- Подпакет home, в котором находится код, связанный с домашним экраном
- Подпакет main, в котором находится код, связанный с главным активити (которое содержит в себе домашний экран, экран каталога, экран закладок)
- Подпакет search, в котором находится код, связанный с поиском
Особенности реализации архитектуры/структуры DI К оглавлению
Для Presentation слоя выбран шаблон проектирования MVVM.
Юзкейсы зависят от абстракций репозиториев, чтобы если что оттестировать их без привлечения моков и без нарушения Dependency Rule.
Реализации репозиториев связаны с их интерфейсами через DI (связанные, т.е. binded реализации берутся из DI контейнера). Они выполняют (в теории, на практике пока этого кода нет) роль выбора источника данных для сохранения. Условно, если нам потребуется кэшировать результат в базе, при этом основным источником будет сеть, то такая архитектура позволит с минимальными затратами реализовать такое внутри реализации репозитория.
Все модели начиная с DataSource и выше по цепочке вызовов являются доменными. Для источников данных допускается иметь свои сущности (Entity, DBO...), либо DTO.
Что используется для хранения данных/многопоточной работы К оглавлению
Для хранения данных используются библиотеки Room (для представления данных) и Jetpack Preferences DataStore (для хранения данных в формате ключ-значение).
В Room мы храним закладки, топы, актуальные аниме
Примерный DDL:
CREATE TABLE bookmarks(
animeId INTEGER NOT NULL PRIMARY KEY,
image TEXT,
title TEXT NOT NULL
);
CREATE TABLE topAnime(
animeId INTEGER NOT NULL PRIMARY KEY,
image TEXT,
title TEXT NOT NULL,
episodes INTEGER,
rating REAL
);
CREATE TABLE actualAnime(
animeId INTEGER NOT NULL PRIMARY KEY,
image TEXT,
title TEXT NOT NULL,
episodes INTEGER,
rating REAL
);В датасторе мы храним текущую тему приложения.
RxJava используется во всех трёх слоях приложения - для работы Room и Retrofit с Observable были добавлены зависимости на соответствующие адаптеры вызовов.
Многомодульность К оглавлению
В модуле build-logic есть подмодуль convention, в котором 2 Gradle Convention плагина:
- Библиотека AniShark, доставляет в зависимости к модулям AGP (библиотечный), Kotlin, RxJava, RxKotlin, Dagger2/Hilt
- Приложение AniShark, доставляет в зависимости к модулям AGP (приложение), Kotlin, RxJava, RxKotlin, Dagger2/Hilt
:data - папка с подмодулями :data:repository (реализации репозиториев), :data:database (БД), :data: remote (сеть) :domain - юзкейсы, модели, интерфейсы репозиториев :app - презентационная логика и остальное
Какому классу соответствует каждый экран К оглавлению
- Домашнему экрану соответствует HomeFragment
- Экрану каталога соответствует CatalogFragment
- Экрану закладок соответствует BookmarkFragment
- Экрану деталей аниме соответствует AnimeScreenActivity
- Экрану фильтров каталога соответствует FilterActivity
- Экрану поиска соответствует SearchFragment

