ADS2024-02-15

Algorithms & Data Structures

Начало работы:

Посмотрите видео: Tutorial:QuickStart
(оно старое, но переписывать смысла нет, все понятно должно быть).

Инициализация. Нажмите Fork на странице https://github.com/Khmelov/ADS2024-02-15/
У вас в аккаунте fork появится тут https://github.com/ваш_логин/ADS2024-02-15
Выберите в IDEA git -> clone (или New-Project from Version control) и затем:
- укажите ссылку на Ваш fork https://github.com/ваш_логин/ADS2024-02-15;
- выберите путь к директории (папке) проекта без русских букв и пробелов;
- укажите имя директории проекта (например ADS2024-02-15_verXX - такой директории на диске быть не должно).
- после создания проекта нужно вручную добавить источник для обновлений VCS -> Git -> Remote имя upstream с URL: https://github.com/Khmelov/ADS2024-02-15/
если проект не компилируется, возможно потребуется подключить библиотеку init.jar (это модифицированный JUnit 4)
- удалите все библиотеки в свойствах проекта
- подключите init.jar (щелкните на ней правой кнопкой и выберите команду Add as library)

Перед каждым сеансом работы:

Обязательно проверьте что все закоммичено (это важно)
Получите последние изменения основного репозитория Git -> Pull (выберите upstream как источник)
Скопируйте папку с заданиями и тестами (by.it.a_khmelev.lessonXX) в свою папку ((by.it.groupXXXXXX.фамилия.lessonXX))
- фамилия, это пакет в java, поэтому допускаются только латинские буквы, и обязательно все в нижнем регистре
Отправьте эти изменения в свой репозиторий Git -> Commit + Push
Возможные ошибки (по этим причинам Pull Request не будет приниматься)
- НЕ решайте задания в a_khmelev
- НЕ переносите файлы из a_khmelev, а копируйте их
- НЕ создавайте папки с буквами в верхнем регистре
- НЕ изменяйте чужие файлы ни на байт (это приводит к ошибкам слияния)

Работаем с кодом:

Добавьте файлы ВСЕ java-файлы вашего пакета под контроль версий (Ctrl+Shift+A или Git -> Add)
Работайте с кодом. Добейтесь чтобы проект собирался и запускался без ошибок.
Делайте коммиты Ctrl+K. _возврат на пункт 2 нужное число раз
Отправьте накопленные изменения в свой репозиторий Git -> Push
Если работу нужно сдать, проверьте что проект собирается и запускается, затем можно сделать Git -> Pull Request (в master)
при коммитах видно какие изменяются файлы. Должны быть изменения только в вашей папке

ВНИМАНИЕ!

Если проект не запускается из-за ошибок в чужих директориях/папках/пакетах НЕ ИСПРАВЛЯЙТЕ ИХ!.
Кто-то их тоже исправит и будет конфликт слияния на github.
А как тогда сделать правильно? Просто отключите проблемную директорию (папку):

выделите её в дереве проекта
нажмите на ней правой кнопкой мыши
Выполните команду Mark Directory as -> Excluded
эта команда затронет только Ваш компьютер

Если все поломалось!

Значит пока не знаете git, или java, или Idea ;). Но исправить все можно даже не зная этого. Аварийный вариант восстановления репозитария.

Скопируйте свою папку из src/by/it/ в отдельное место на диске.
- найти свою папку на диске можно выделив ее в дереве папок в IDEA. Далее, правая кнопка -> Open in Explorer.
Удалите fork из своего аккаунта github (откройте форк на сайте, выберите Setting-Delete this repository)
Выполните всю последовательность из шапки (см. Начало работы).
Верните свою папку на место в свежем проекте.
Делайте коммит Ctrl+K.
Отправьте накопленные изменения в свой репозиторий Git -> Push

Версия java 21-я (это актуальня LTS-сборка). Другие версии НЕ ИСПОЛЬЗУЙТЕ, проект не соберется у других и при проверке.

С уважением, Александр Хмелев.