¶ Начало разработки
Необходимо клонировать репозиторий https://git.miem.hse.ru/19111/miemappios. Запустить XCode и отрыть корневой файл проекта.
¶ Правила разработки.
При начале работы над задачей необходимо создать ветку (название по id задачи в taiga). При завершении работы, нужно сделать push в репозиторий.
¶ Зависимости
Следующие зависимости подключаются через CocoaPods:
- GoogleOAuth
- Alamofire
- BEMCheckBox
- TinyConstraints
Модуль навигации подключается через SPM
¶ Архитектура проекта
Каждый модуль по сути является одним основным экраном, внутри которого может осуществляться своя навигация, независимо от главного приложения. Этому модулю также могут быть нужны доступ к постоянному хранилищу данных или сетевым запросам. Таким образом весь модуль можно свести к одной основной сущности, которая при инициализации принимает необходимые зависимости в виде аргументов, а затем предоставляет свой основной экран главному приложению. Затем на основе полученных экранов строится меню, которое позволяет открывать эти экраны. Это происходит подстановкой выбранного экрана в экран главного приложения.
Данный подход позволяет свести к минимуму количество точек интеграции модуля. Преимуществом этого является быстрая интеграция модуля, так как чтобы его экран отображался в приложении и его меню надо всего лишь создать сущность модуля и затем передать его экран в меню. Это позволяет снизить количество конфликтов при разработке сразу несколькими программистами. Также такая архитектура позволяет заменять одну реализацию модуля на другую, например, в случае смены дизайна интерфейса.
Каждый модуль может быть разработан внутри с использованием своей архитектуры. Это даёт возможность сторонним разработчикам гибкость и удобство выбора. Однако такой подход может привести к тому, что новым разработчикам будет трудно понять строение программы. Поэтому все модули имеют одинаковую архитектуру. Она основана на архитектурном шаблоне Model-View-View Model. Внутри основной сущности модуля создаются источник данных и основное представление на основе полученных зависимостей от основного приложения. Источник данных предоставляет модель для представления на основе данных с диска и из сети. Он также несёт ответственность за обновление данных в результате действий пользователя.
¶ Текущая структура проекта
¶ Информация пользователя
- AwardCell – интерфейс карточек достижений пользователя
- GitCell – интерфейс карточек статистики Git пользователя
- ApplicationModel – модель с информацией о заявках
- ProjectModel – модель с информацией о проектах
- ProfileScreenLoad – экран пользовательской информации
- ProfileGraph – основная сущность модуля пользовательской информации
- ProfileDataSource – сущность для сетевых запросов и получения информации от серверов кабинета МИЭМ
¶ Авторизация
- AuthGraph – основная сущность модуля авторизации
- AuthScreenLoad – экран авторизации
- AuthServices - сущность для сетевых запросов к серверам кабинета МИЭМ
¶ Расписание
- TimetableScreenLoad – основной экран модуля расписания
- TimetableModel – модель расписания
- TimetableItemCell – представление одной ячейки с парой
- TimetableGraph – основная сущность модуля
- TimetableDataSource – сущность для получения расписания из API РУЗ
- TimetableSectionHeader – представление даты и дня недели
- TimetableDatesHeades – представление с выбранными датами
- DatePickerView – представление для выбора дат
- TouchDetectingView – сущность для определения касаний и скрытия выбора дат
¶ Список проектов
- ProjectsScreenLoad – экран списка проектов
- ProjectsGraph – основная сущность модуля
- ProjectsDataSource – сущность сетевых взаимодействий
¶ Подробная информация о проекте
- MoreProjectScreenLoad – экран подробной информации о проекте
- MoreProjectDataSource – сущность для сетевых запросов и получения информации о проекте от серверов кабинета МИЭМ
- MoreProjectGraph – основная сущность модуля
¶ Песочница проектов
- SandboxScreenLoad – экран песочницы проектов
- SandboxGraph – основная сущность модуля
- SandboxDataSource – сущность сетевых взаимодействий
- SandboxCell - интерфейс карточки проекта в списке
- SandboxStatus – модель статусов проектов
¶ Для связи с разработчиками
- Zulip chat #19111 MIEM App
iOS разработчик Кофман Мелани
стажеры iOS разработчики:
Королев Дмитрий
Рыбаковский Никита
Савин Ярослав