Skip to content
AniSharkAppPublic

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

AniShark

Содержание

Информация о приложении К оглавлению

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

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages