Lokalne repo i używanie owego z poziomu Eclipse

To najłatwiejsza część zadania. Wystarczy wykonać komendę

hg init

w katalogu, w którym ma się znaleźć repozytorium.

Najpierw instalujemy hgeclipse. Więcej informacji na stronie projektu, a tutaj tylko zrzuty ekranu pokazujące, jak to zrobić. W oknie, które się pojawi po wybraniu z menu opcji Help → Install New Software należy kliknąć przycisk New, a dalej, to już widać poniżej.


Potem tylko dalej, akceptujemy licencję i to w sumie tyle.

W oknie nowego projektu wybieramy Clone repository using Mercurial:

W repository location klikamy na local i wybieramy folder na dysku, w którym znajduje się repozytorium.

Potem pokazuje nam się okienko, które w sumie niewiele nam daje, więc klikamy na finish i wszystko powinno być ok.

Możliwe, że zajdzie konieczność przekonwertowania projektu na projekt C/C++. Robimy to za pomocą funkcji Convert to a C/C++ Project, którą możemy znaleźć w menu nowego projektu.

Tak prezentuje się menu funkcji Mercuriala. Teraz opiszę kilka typowych scenariuszy działania:

• Wybieramy opcję Pull…. Jeśli nie pracowaliśmy na żadnej osobnej gałęzi, powinniśmy teraz mieć przed sobą najnowszą wersję kodu.

• Wybieramy opcję Commit, wpisujemy opis wprowadzonych zmian (ważne, przyda się w przyszłości).
• Wybieramy opcję Pull…, żeby zaktualizować repozytorium na wypadek, gdyby ktoś w trakcie naszej pracy wrzucił coś nowego.
• Wybieramy opcję Merge. Pojawi się na dole lista różnic pomiędzy tym, co zrobiliśmy, a tym, co ktoś inny zrobił. Klikając dwukrotnie pojawi nam się porównanie obu wersji. Łączymy w jedno, po czym prawym przyciskiem na konflikcie na dole zaznaczamy jako Resolved.
• Kiedy już wszystko mamy połączone, to wybieramy opcję Push…. Jeśli nie pojawi się żaden błąd, to jest wszystko w porządku.

• Po wprowadzeniu jako takich zmian zamiast od razu commitować wybieramy Add branch. W tym okienku wpisujemy nazwę gałęzi (jaka nam wygodnie, byle było jasne, co w niej się znajduje).
• Następnie możemy kontynuować wysyłanie tak, jak to widać w poprzednim punkcie.

Ważne: jak już utworzymy gałąź, to na niej Eclipse będzie pracować! Czyli, wszelkie zmiany, jakie wprowadzimy, będą niezależne od tego, co ktoś inny zrobi w innej gałęzi. To tak, jakby skopiować projekt i wkleić go w inny folder, i w nim edytować. Domyślna, główna gałąź, to default, i z nią powinno się potem łączyć gałąź (czyli Mergować z gałęzią default). Warto też wiedzieć, że do zmiany gałęzi, na której się aktualnie pracuje, służy opcja Switch To….

• Do tego służy opcja Revert…. Jeśli nie podawaliśmy wcześniej sensownych opisów przy commitowaniu, to jest bida, i trzeba zgadywać. W innym wypadku jest elegancja i kulturka.

Warto wiedzieć, że można commitować nie pushując, czyli zapisywać postęp prac nie wrzucając tego do wspólnego folderu. Jeśli nie mamy połączenia z internetem, to tego należy używać. W skrócie: jeśli Dropbox się nie łączy, lub akurat coś mieli, to NIE należy pushować