Archiwum kategorii: Programy

SVN tutorial – tworzymy repozytorium.

W poprzednim wpisie dot. SVN pisałem jak zainstalować program do wersjonowania kodu/dokumentów itp. Dzisiaj zajmiemy się praktyką, czyli stworzymy sobie nasze pierwsze repozytorium.

Dobrze to bez zbędnych wstępów zaczynamy.

Jak stworzyć repozytorium i zapisywać poszczególne wersje naszych plików pokażę na zwykłych plikach tekstowych.

Stwórz katalog dla plików projektu.

Żeby coś wersjonować musimy mieć jakiś projekt a w nim jakieś pliki. Jak dla artykułu stworzyłem nowy katalog na dysku C: o nazwie „SVN_Test”.

Teraz wewnątrz tego katalogu utworzymy dwa nowe katalogi. Pierwszym z nich będzie katalog w którym będziemy przechowywali pliki naszego projektu. Ja to nazwę „Pliki_projektu”.

Stwórz katalog na repozytorium.

W naszym katalogu SVN_Test stwórz także drugi katalog, który posłuży nam jako repozytorium dla plików projektu. Ja nazwę go „Repozytorium”.

Stwórz repozytorium.

Teraz przyszedł czas na utworzenie repozytorium z katalogu o takiej właśnie nazwie. Kliknij więc prawym przyciskiem myszy na tym katalogu i z menu podręcznego wybierz opcję „TortoiseSVN” a następnie „Create repository here”.

Pojawi nam się okno „Repository created” gdzie zobaczymy ścieżkę do naszego repozytorium. Dla pewności skopiuj ścieżkę naszego repozytorium.

Istnieje także możliwość stworzenia struktury tego repozytorium ale nie jest to konieczne i na razie nie będziemy z tej możliwości korzystać.

My pójdziemy szybką ścieżką i potwierdzimy wszystko przyciskiem OK.

Repozytorium zostało utworzone.

Powiąż repozytorium z katalogiem z plikami projektu.

Przyszedł czas na powiązanie dwóch rzeczy: katalogu z projektem i naszego repozytorium. W tym celu na katalogu „Pliki_projektu” kliknij prawym przyciskiem myszy i z menu wybierze opcję „SVN Checkout…”.

W oknie „Checkout” sprawdź czy wszystkie ścieżki się zgadzają. W polu „URL of repository” powinna znaleźć się ścieżka z kroku kiedy tworzyliśmy nasze repozytorium. Prosiłem Cię wtedy żebyś ją skopiował i właśnie teraz się to nam przyda. Jeśli nasza ścieżka jest inna niż wymagana, skopiuj ścieżkę do naszego repo.

W polu „Checkout directory” powinna być ścieżka do naszego katalogu z plikami projektu.

Jeśli wszystko się zgadza potwierdź wszystko przyciskiem OK.

Powinieneś otrzymać informację, że wszytko przebiegło bez problemów. Potwierdź wszystko przyciskiem OK.

Jak wejdziesz do naszego katalogu „SVN_Test” zobaczysz, że na katalogu „Pliki_projektu” pojawiła się taka zielona ikona z „fajką”, która informuje nas że repozytorium zostało zapisane i że wszystkie pliki zostały zapisane do najnowszej wersji.

No ale my przecież jeszcze nie mamy plików! No to czas je stworzyć.

Tworzenie kolejnych wersji dokumentów/kodu.

W katalogu „Pliki_projektu” stwórz plik „Test.txt” i wpisz do niego test „Pierwsza linia kodu”.

Jak pewnie zauważyłeś ikonka przy pliku Test.txt ma znak zapytania. Nasze repo nie wie jeszcze czy tworzyć kopię tego dokumentu. Żeby tak było kliknij na tym pliku prawym przyciskiem myszy i wybierz opcje: TurtoiseSVN -> Add.

Teraz ikona zmieniła się na niebieski plus, co oznacza, że plik będzie wersjonowany.

A jak cofniemy się do katalogu wyżej zobaczysz że na katalogu „Pliki_projektu” ikona zmieniła się na czerwony wykrzyknik.

Czyli w tym momencie pliki są zmodyfikowane w katalogu „Pliki_projektu” ale jeszcze nie są zmodyfikowane w naszym repozytorium”.

Musimy je zapisać w aktualnej wersji w repozytorium. Możemy to zrobić tworząc taki „punkt przywracania”. Co to oznacza? Że zapisujemy wersję wszystkich zmodyfikowanych plików i zawsze możemy wrócić do wersji tych dokumentów.

OK no to jak to zrobić?

Na katalogu „Pliki_projektu” klikamy prawym przyciskiem myszy i wybieramy opcję: „SVN Commit …”.

W oknie „Commit” w pierwszym polu „Message” wpisujemy swój komentarz przy tej wersji zostało zrobione. Ja dodałem informację że dodałem plik Test.txt i jedną linię tekstu.

W części „Changes made” masz jest informacja które pliki zostaną dodane lub zmodyfikowane. Wszystko potwierdzasz przyciskiem OK.

Otrzymasz potwierdzenie wykonania zapisu. I potwierdzasz „OK”.

W tym momencie ikona na katalogu „Pliki_projektu” znowu powinna się zmienić na zieloną, co oznacza że pliki projektu w obu lokalizacjach są wyrównane.

Jak wejdziesz do katalogu „Pliki_projektu” także zobaczysz zieloną ikonę na pliku Test.txt , co oznacza że plik jest identyczny w obu lokalizacjach (w plikach projektu i w repozytorium).

W taki właśnie sposób tworzysz i wersjonujesz pliku kodu/dokumentów Twojego projektu.

W kolejnych artykułach pokażę, Ci jak wracać do poszczególnych wersji plików w Twoim projekcie a na dzisiaj kończymy.

<< wróć do kategorii PROGRAMY

GitHub Desktop. Jak ściągnąć repozytorium na dysk lokalny ze strony GitHub.com?

Dzisiaj szybki post dotyczący ściągnięcie swojego repozytorium ze strony GitHub.com do lokalnego repozytorium zarządzanym przez GitHub Desktop.

  1. Zaloguj się do swojego konta na stronie GitHub.com i do programu GitHub Desktop.
  2. Na stronie GitHub.com przejdź na stronę repozytoriów (zakładka: Repositories).
  3. Wybierz któreś ze swoich repozytoriów, czyli kliknij w jego nazwę.
  4. Nad listą plików i katalogów po prawej stronie widnieje zielony przycisk „Code”. Kliknij w ten przycisk.
  5. Na liście rozwijalnej wybierze pozycję: Open with GitHub Desktop.
  6. Potwierdź komunikaty przeglądarki (komunikaty mogą się różnić w zależności od użytkowanej przeglądarki).
  7. W nowym oknie o nazwie „Clone a repository” masz informację o jakie repozytorium chodzi (nazwa użytkownika i nazwa repozytorium). W dolnej części okna masz wskazaną ścieżkę do lokalnego repozytorium, które zostanie utworzone jeśli potwierdzisz chęć klonowania tego repozytorium. Oczywiście lokalizację możesz zmienić.
  8. Wszystko potwierdź klikając w przycisk „Clone”.
  9. Gotowe. Na lokalnej maszynie masz teraz sklonowane repozytorium. Znajduje się ono w lokalizacji która została wskazana w pkt. 7.

<< wróć do kategorii PROGRAMY

TortoiseSVN czyli jak zacząć wersjonować kod, dokumenty itp.

Każdy z nas spotyka się z różnego rodzaju dokumentami tekstowymi. Jedni tworzą dokumenty w programie Word, programiści kodują … i tak dalej. Jeśli w danym momencie potrzebna jest nam tylko aktualna wersja dokumentów/kodu programisty to w porządku. Problem zaczyna się w momencie kiedy przydałoby się przechowywać (archiwizować) wcześniejsze wersje czy to dokumentów czy to kodu. Zaczyna się wtedy tworzenie jakichś skomplikowanych struktur katalogów i kopiowanie kolejnych wersji itp. Z czasem sami zaczynamy się w tym gubić i przestajemy nad tym panować.

Ale nie ma tego złego i z pomocą przychodzą nam systemy kontroli wersji. Są to narzędzia dzięki którym możemy cały czas pracować nad naszymi dokumentami/kodem ale w każdym momencie wrócić do każdego miejsca wcześniej, który oczywiście sobie zapisaliśmy. Jednym z bardziej popularnych narzędzi tego typu (przynajmniej moim zdaniem) jest program TortoiseSVN, zwyczajowo nazywany po prostu SVN. I w tej serii artykułów omówię jego podstawowe możliwości.

Instalacja.

W tym artykule zajmę się tylko instalacją a w kolejnych przejdziemy do tworzenia repozytorium i omówienia możliwości tego narzędzia. Jestem programistą więc możliwości SVN-a pokażę Wam na podstawie wersjonowania prostego kodu C++. No to jazda.

Ściągnij SVN z Internetu.

  1. Żeby ściągnąć SVN-a wejdź na stronę: https://tortoisesvn.net/.
    tortoise svn
    Strona główna tortoisesvn.net
  2. Kliknij na zakładkę „Download”.
    TortoiseSVN
  3. Teraz wybierz wersję która jest najbardziej odpowiednia dla Twojego sprzętu (u mnie będzie to 64 bitowa wersja).
    TortoiseSVN wybór wersji
    TortoiseSVN wybór wersji (64bit).
  4. Po kliknięciu w link i akceptacji ciasteczek na stronie na którą zostaniesz przekierowany zostanie uruchomiony proces ściągnięcia pliku instalacyjnego. Otworzy się okno dialogowe w którym musisz wskazać lokalizację gdzie chcesz ściągnąć plik instalacyjny.
  5. Teraz wejdź do lokalizacji którą wskazałeś i gdzie został pobrany plik instalatora i uruchom plik podwójnym kliknięciem.
  6. Pojawi się okno powitalne. W celu kontynuowania procesu instalacji kliknij w przycisk „Next”.
    TortoiseSVN instalacja okno powitalne
    TortoiseSVN instalacja okno powitalne
  7. W kolejnym oknie musisz wyrazić zgodę na warunki licencji. W celu kontynuacji kliknij w „Next”.
    TortoiseSVN instalacja potwierdzenie warunków licencji
    TortoiseSVN instalacja potwierdzenie warunków licencji
  8. Kolejne okno to wybór komponentów które chcesz zainstalować i wybór lokalizacji którą wybierzesz dla instalacji TortoiseSVN. Domyślą lokalizacją jest C:\Program Files\TortoiseSVN\ . Wszytko potwierdź przyciskiem „Next”.
    TortoiseSVN instalacja wybór komponentów i lokalizacji
    TortoiseSVN instalacja wybór komponentów i lokalizacji
  9. Teraz potwierdź chęć instalacji klikając w przycisk „Install”.
    TortoiseSVN potwierdzenie chęci instalacji
    TortoiseSVN potwierdzenie chęci instalacji
  10. Tak naprawdę dopiero teraz następuje proces instalacji narzędzia TortoiseSVN.
    TortoiseSVN instalacja narzędzia
    TortoiseSVN instalacja narzędzia
  11. Na koniec otrzymamy informację o zakończeniu procesu instalacji. Wszystko potwierdzamy klikając w „Finish”.
    TortoiseSVN zakończenie procesu instalacji
    TortoiseSVN zakończenie procesu instalacji

    W celu poprawnego działania programu TortoiseSVN należe zrestartować komputer o co zostaniem poproszony kolejnym komunikatem.

    Po restarcie komputera mamy już poprawnie zainstalowane narzędzie do kontroli wersji np. kodu lub innych dokumentów tekstowych. W kolejnym odcinku pokażę Wam jak utworzyć proste repozytorium i zapisywać kolejne wersje naszych dokumentów.

Do zobaczenia 🙂

<< wróć do kategorii PROGRAMY