Fastbar
Powrót do strony głównej
Trzymaj pliki na gmclan.org!
Game Maker w pytaniach i odpowiedziach!
Polska dokumentacja
Tabela wyników ligi 24
Pobierz GM
Akademia GMCLANu
Kategorie bazy artykułów
Artykuły -> Game Maker
Treść artykułu
SVN - kontrola wersji plików w GM:STUDIO / HTML5
autor: gnysek (3.03.12)
W tym poradniku dowiesz się, jak wprowadzić do swojego projektu kontrolę wersji, dzięki czemu będziesz mógł pracować w zespole równolegle na tym samym projekcie, oraz śledzić zmiany dokonane w kodzie.
Ten poradnik wykorzystuje system kontroli SVN. Chociaż nie oferuje tylu opcji co GIT, SVN jest bardzo prosty w nauce, a GameMaker:Studio w wersji beta wspiera jedynie ten system.

Co będzie potrzebne?

1. Zdalne repozytorium SVN. Darmowe udostępnia kilka serwisów, niestety większość z nich wymaga, aby taki projekt był widoczny publicznie. Dlatego mój wybór padł na Assemblę - ale jeśli znajdziecie jakiś inny hosting, wszystko powinno wykonywać się w ten sam sposób.

2. Tortoise SVN. Wizualny klient SVN dla Windowsa. Jego obsługa jest łatwiejsza niż wpisywanie komend w konsoli - wystarczy kliknąć odpowiednie opcje z menu kontekstowego.
Oferuje też bardzo przejrzysty podgląd zmian, czy rozwiązywanie konfliktów.

Czego się nauczę?

Jak założyć repozytorium, jak wysyłać zmiany w kodzie, jak aktualizować projekt, jak cofać zmiany, jak rozwiązać konflikty, jak podejrzeć zmiany.

Zanim rozpoczniesz ten samouczek, pobierz i zainstaluj TortoiseSVN, oraz uruchom ponownie komputer po jego instalacji! Dopiero wtedy możesz przejść do kroku 1.

Krok 1: zakładamy repozytorium

Rejestrujemy się na stronie www.assembla.com . Klikamy "Utwórz własną przestrzeń roboczą". W kroku 1 z menu po lewej wybieramy "ALL", a następnie "Free Private Subversion Repository" (przycisk "Select").

W "Space Name" wpisz nazwę swojego projektu. Dla mnie będzie to "Kurs Studio SVN". Pola description i tags można pominąć, a sekcji Security nie modyfikujemy (chyba, że chcemy umożliwić wszystkim z zewnątrz wgląd do kodu, lub jego modyfikację). Klikamy "Create", przewijamy na sam dół strony i tam znajdziemy link "Continue to your space".

Przechodzimy do zakładki "Kod źródłowy/Svn". W polu SVN URL jest adres naszego repozytorium. Login i hasło będą takie jak do konta Assembla.

Krok 2: tworzymy projekt z kontrolą wersji

INFO: Jeśli masz już istniejący projekt dla którego chcesz dodać kontrolę wersji, w miejsce kroku w którym utworzymy nowy projekt GM:Studio, po prostu przekopiuj swój projekt.

W dowolnym miejscu swojego komputera, tam gdzie lubisz trzymać projekty, utwórz katalog. np. "Mój Projekt". Kliknij prawym przyciskiem myszy na utworzonym folderze i wybierz opcję "SVN Checkout". W pole "URL of repository" wklej "SVN URL" z assembli i zatwierdź.
Tortoise zapyta Cię o hasło - możesz je zapamiętać, wtedy nie będziesz musiał go podawać ponownie - np. ja nie musiałem wcale, bo mam już w assembli inny projekt.

Jak widzisz w oknie Tortoise, zostały dodane dwa pliki do tego repozytorium - to pliki które zostały domyślnie utworzone przez assemblę jako pierwsza wrzutka.



Nasz projekt umieścimy w folderze trunk. Jest taka zasada, że bierzący kod trzyma się w folderze trunk, a wszelkie jego odnogi w folderach Branch (do ich tworzenia jest specjalna funkcja w Tortoise SVN, jednak tej tematyki nie poruszamy - i jeśli mam być szczery, to branchowanie w systemie GIT bije na głowę to z SVN).

Jak zauważyłeś, ikony folderu w którym zrobiliśmy checkout i wszystko w nim ma teraz w rogu zielone ikonki - oznaczające, że te pliki nie zostały zmodyfikowane. UWAGA! Nie zostały zmodyfikowane na Twoim komputerze, od czasu ostatniej aktualizacji, co nie znaczy, że druga osoba pracująca nad projektem ich nie zmieniła. Pamiętaj aby ZAWSZE przed wysłaniem swoich zmian, zrobić SVN UPDATE - pobiera on wszystkie zmiany z serwera i automatycznie łączy je z Twoimi plikami, jeśli zmiany w kodzie nie naruszają Twoich zmian (np. ktoś edytował inną funkcję czy inny fragment kodu). Jeśli jednak ktoś edytował dokładnie ten sam fragment - powstanie konflikt - ale o tym później - nie martw się, da sie to rozwiązać :)

Teraz otwieramy GM:Studio. Tworzymy nowy projekt w ścieżce:
"Mój Projekt\trunk\Nazwa projektu".

Dodajemy nowy skrypt, zamykamy go i na razie zamykamy Studio. Projekt jest teraz w ścieżce "Mój Projekt\trunk\Nazwa projektu\Nazwa projektu.gmx". Jak widzisz, nowo dodane pliki nie mają żadnych ikonek SVNa. Trzeba je dodać do projektu! Można to zrobić, zaznaczając folder/pliki które chcemy dodać i wybierając z menu kontekstowego. Gdy będziemy robić commit na całym projekcie, również możemy dodać pliki które jeszcze nie są w repozytorium. Jeśli wrócimy do głównego folderu repozytorium (tego w którym jest folder trunk), to widać, że ikonka z zielonej zmieniła się na czerwoną, co oznacza, ze mamy zmiany w projekcie, które nie zostały wysłane na serwer.

Krok 3: aktualizacja projektu

Wybieramy na tej części projektu którą chcemy zaktualizować opcję Commit - która pozwala na wrzucenie plików na serwer. Najlepiej robić to na głównym katalogu ("Mój projekt"), ale można też na podrzędnych, jeśli chcemy wrzucić zmiany tylko z jednego pliku/katalogu.
Tortoise zapyta nas, które pliki chcemy zaktualizować. Podajemy też komentarz do tej wrzutki. Np. "Inicjalizacja projektu". Klikamy OK.

Krok 4: codzienna praca - modyfikacja kodu

Wracamy do Studio. Otwieramy nasz skrypt i wpisujemy "var a;" i zapisujemy projekt. Wracamy do folderu i znów robimy commit.
Teraz, zamiast słowa "added" przy pliku ze skryptem, jest napis MODIFIED. Na pliki z tym statusem można dwa razy kliknąć, aby zobaczyć zmiany wprowadzone od ostatniej wersji.
Dodajemy komentarz - "testowa zmienna". I klikamy OK.
Wracamy do Studio. Zmieniamy "var a;" na "var b;". Znów robimy commit. W oknie Tortoisa kliknij teraz dwa razy na plik "script0.script.gmx" - widzisz? Z lewej strony mam poprzednią wersję pliku, z prawej tą którą chcemy wrzucać. Zaznaczona jest na kolorowo literka "b", bo tylko ją zmieniliśmy. Dzięki podejrzeniu zmian łatwo można sprawdzić, które fragmenty kodu zostały zmienione a które nie. Zamykamy okno z podglądem zmian, dodajemy komentarz "pomyłka" i wysyłamy kod.

Aktualizacja kodu przez inne osoby

Dodatkowe osoby do projektu dodajemy w Assembli w zakładce "Grupa". Każda z tych osób może w ten sam sposób jak powyżej modyfikować kod i wysyłać zmiany.
Jak już powiedziałem, przed wysłaniem zmian zawsze należy zrobić Update. Jeśli tego nie zrobimy, SVN nie pozwoli na wysłanie zmian (chyba, że od czasu naszej ostatniej zmiany nikt nic nie wrzucał). SVN przy Update stara się sam łączyć pliki, jeśli dwóch programistów pracowało na tym samym pliku, nie mniej może zaistnieć sytuacja konfliktu - najczęściej gdy jeden programista wywali kawałek kodu, a drugi do tego starego kawałka coś dodał. Powstaje wtedy konflikt.

Rozwiązywanie konfliktów

Gdy zrobimy update i dostaniemy czerwony komunikat "one or more files in conflicted state", nie należy zamykać okna ze stanem pobranych plików, ale odnaleźć na liście czerwone pliki z konfliktem i dla każdego z nich przeprowadzić tę operację:

Klikamy prawym i wybieramy "Resolve Conflicts". Otwiera się okno podglądu zmian, takie jak przy commicie, ale dodatkowo na dole jest podgląd wersji złączonej obu plików. Teraz dla każdego konfliktu (czerwone), mozemy wybrać z prawym przyciskiem myszy w lewym lub prawym oknie który fragment kodu mamy użyć (theirs to ten z SVN, mine to ten lokalny), ale możemy też edytować plik w tym oknie i wpisać jeszcze co innego (jakbyśmy byli w edytorze kodu). Gdy już rozwiążemy konflikty, zapisujemy plik (ikona dyskietki) i zaznaczamy rozwiązanie konfliktu (ikona trójkąta z haczykiem, oznaczającym zatwierdzenie).

Wykonujemy to dla wszystkich plików.

Oczywiście jeśli zamkniemy po Update okno, konflikty można nadal rozwiązać używając menu kontekstowego SVNa na folderze - np. wybierając opcję "check for modifications" dostajemy listę podobną jak przy commicie - dalej postępujemy jak wyżej.

Rozwiązywanie konfliktów do prostych nie należy - ale w porównaniu do wersji konsolowej, ta i tak jest lepsza...

Gdy wszystkie konflikty są już rozwiązane, można w końcu przeprowadzić Commit.

Wycofywanie zmiany

Wycofywanie zmiany jest dziecinnie proste. Wybieramy na pliku który chcemy cofnąć (lub na całym głównym folderze, jeżeli chcemy cofnąć cały update) opcję Show Log. Na najnowszej zmianie z menu kontekstowego wybieramy "Revert changes from that commit", zatwierdzamy i tyle. Prawda, że proste? W oknie "Show log" można tez zawsze sprawdzić, jakie zmiany były dokonane w ostatnich commitach (każdy commit ma kolejną liczbę naturalną, zwaną numerem rewizji) - klikamy dwa razy na wybranym pliku po zaznaczeniu rewizji i znów w znajomym oknie podglądu różnic widzimy co zostało zmienione.

Używanie Kontroli wersji w Studio.

Obecnie nie ma opcji korzystania z SVN bezpośrednio z programu - należy wykorzystywać Tortoise SVN lub inne programy.
głosów: 5 | ocena: 7.59 oceń zasób | dodał: gnysek
Komentarze
stron: 1

1


av

Uzjel (2:43, 4.03.2012)

Dajesz newsa o jakiś viewach, a o takim dobrym arcie nie. :Nowieszco:
Jest to dostępne teraz w 5PICE?

av

gnysek (14:01, 4.03.2012)

Tak, w obu programach można z tego korzystać, bowiem każdy zasób zapisują w plikach XML (z rozszerzeniem GMX, ale to pliki XML).

Newsa nie dałem, bo... pełna wersja Studio ma mieć dodatkowo obsługę kontroli wersji wbudowaną (a zatem commit i update bezp. z programu)

av

Threef (17:58, 19.04.2012)

Po godzinie prób i błędów udało mi się (chyba) skonfigurować SVN. Teraz Ja i Shil pracujemy na tej samej wersji PentaSphere!

av

gnysek (20:28, 19.04.2012)

Na początku to faktycznie nie jest łatwe. Po paru tygodniach - dziecinnie proste.

av

Threef (20:34, 19.04.2012)

To jest dziecinnie proste, ale jakoś to trzeba to jakoś wytłumaczyć tej drugiej stronie.

av

Threef (20:36, 19.04.2012)

Poza tym czy działa już ten wbudowany? Mi nigdy nie udało się wykonać update.

av

gnysek (21:00, 19.04.2012)

Niby działa, ale wciąż są jakieś problemy - tortoise jest zdecydowanie lepszy

av

Piotrek1910 (1:06, 11.07.2014)

Gnysku co sądzisz o Google Code? Bo też oferują SVN.

av

PsichiX (1:22, 11.07.2014)

Bogowie, SVN - seriously YYG? D:

av

gnysek (11:39, 12.07.2014)

Sądzę, że nie.
Bitbucket + Mercurual/Git i darmowe prywatne repozytorium, ewentualnie Github jak chcesz żeby każdy oglądał. Co prawda zarządzasz wtedy poza GM:S, ale dla mnie to nie robi problemu (ba, nawet ze Studia właśnie czasem gorsze problemy są i lepiej korzystać z CMD lub Tortoisa).

stron: 1

1



Dodaj komentarz:
Treść:
Menu
Panel użytkownika
Jesteś niezalogowany!

Nie masz konta? Zarejestruj się
Użytkownicy on-line
1 użytkownik(ów) aktywny(ch) przez ostatnie 15 minut:
gości: 1, userów: 0, ukrytych: 0
Użytkownicy na czacie discord
Nikas (20:14, 17.12.17):
xDDDDDD
Wojo (21:00, 16.12.17):
Jak są maczane w zimnych ogniach to tak
I am vader (16:08, 16.12.17):
Ja koniec koncow nie wiem czy maja sie iskrzyc czy nie.
gnysek (14:10, 15.12.17):
o maczanach ?
Wojo (13:44, 15.12.17):
Swoją drogą jeśli jesteśmy przy temacie palenia to pamięam te wywody o maczanach, które się iskrzą
Wojo (13:43, 15.12.17):
Pierwsza rzecz jaką robię po spaleniu kuchni to napisanie o tym na gmclanie
gnysek (16:06, 14.12.17):
I już zaktualizowali GMS2 ponownie z hotfixem, bo to nowe okienko w room editorze nie działało prawidłowo...
Gibki Kaktus (12:49, 14.12.17):
Zgadnijcie kto spalił kuchnię i musial się wynieść? XD
gnysek (11:33, 14.12.17):
@Wojo - ten typek dawno sprzedał ten film i teraz robi go Disney
ANtY (9:49, 14.12.17):
szanuje
Chell (17:15, 13.12.17):
wysoka piątka
I am Lord (17:15, 13.12.17):
Nie oglądałem ani jednej części SW i jestem z tego dumny
Wojo (13:23, 13.12.17):
z resztą typek jest na tyle smutny ze musi wypuszczac co jakis czas nowa czesc swojego filmu bo nie potrafił zrobić jednego porządnego filmu
Wojo (13:22, 13.12.17):
nigdy nie ogladalem gwiezdnych wojen i jakos mnie do tego nie ciagnie
gnysek (10:32, 13.12.17):
ja wczoraj kupiłem bilet na SW na dziś, podobno 9/10
Chell (20:07, 12.12.17):
byle bez warnow
I am vader (19:52, 12.12.17):
A ja bede antychellowski i powiem, ze SW jest dobre, harry potter ok, a lotr to gówno i syf. A i SW I nie istnieje, tylko II-VI
Chell (19:51, 12.12.17):
to ja bede do bolu offstreamowy i powiem, ze SW to zawsze byla dla mnie mordega, najnudniejsze na swiecie, plus meczacy overhype. Harrego Pottera tez nie znosze, tylko LOTR
gnysek (17:06, 12.12.17):
i jeszcze zapomniałeś dodać, że zaczeło się na 4 części
Ignatus (16:49, 12.12.17):
Dałem radę wytrzymać połowę poprzedniej części, wątpie czy będzie lepiej..Będę do bólu mainstreamowy ale SW sie skoczylo na 6 episodzie tak jak obcy na 3 czeci
gnysek (16:40, 12.12.17):
na star warsy kto idzie do kina ?
gnysek (16:40, 12.12.17):
nic koleżku
ANtY (16:10, 12.12.17):
hehe co tam kolegowie
Wojo (16:49, 11.12.17):
Nie no zajebiscie jest sie starzec
Nikas (22:28, 10.12.17):
xDDDD no nieźle typy
Wojo (10:26, 10.12.17):
swoją drogą też bardzo nie lubię swoich urodzin
Wojo (10:26, 10.12.17):
Kiedyś miałem komplex dużych uszów
Wojzax (21:36, 9.12.17):
i wielkość uszu
Wojzax (21:36, 9.12.17):
wiek to tylko liczba
I am Lord (16:23, 9.12.17):
Mi o mojej osiemnastce powiedziała nauczycielka z angola
Sutikku (15:52, 9.12.17):
prosze nie straszyc za pare miesiecy mam 17
I am vader (15:17, 9.12.17):
Moje życie skończyło się po siedemnastce
exp (18:40, 8.12.17):
dwudzieste urodziny to była dla mnie trauma
Wojo (20:43, 7.12.17):
ja chyba z 9
ANtY (13:48, 6.12.17):
a ja 420 hihihihihui
gnysek (11:10, 6.12.17):
a ja 30! jestem 2x starszy niż gmclan
Morro (21:48, 5.12.17):
ja wciąż 14
I am Lord (21:29, 5.12.17):
Uzjel czemu w twoim filmie z flappy birdem przyjales taki zlo nawykowy styl pisania kodu?
PsichiX (21:15, 5.12.17):
a ja 69
Chell (20:29, 5.12.17):
(ja mam 18 jakby co)
Chell (20:29, 5.12.17):
nigdzie juz nie mozna sprawdzac wieku userow!
Adriann (22:45, 29.11.17):
Nie musisz dawać..wystarczy że postawisz serwer;3
Morro (20:52, 29.11.17):
Czyli tak jak myślałem
I am Lord (20:43, 29.11.17):
bo czat pewnie po tcp a ruch po udp :p
Sutikku (19:56, 29.11.17):
albo dopowiedz co jest nie tak, ze czat w almorce dziala spoko, ale grasz nie porusza sie po mapie?
Morro (19:41, 29.11.17):
a może zlitujesz się i wrzucisz na jakimś laptopie w tle serwer Almorki ;> ?
gnysek (19:01, 29.11.17):
mam mam, z Szczecin Games Show, aczkolwiek to nie musi być ostatnia wersja serwera.
Chell (18:44, 29.11.17):
bo nie masz
PsichiX (17:14, 29.11.17):
no to sobie pogralismy :<
gnysek (17:02, 29.11.17):
ja mam ale nie dam, bo łatwo zdekopilować
Ankieta
» Jakie kursy najchętniej widziałbyś na stronie ?
GM Studio
GM Studio 2
Godot
Construct

GMCLAN to serwis o programie Game Maker i nie tylko.
Copyright © 2002-2017. GMCLAN.ORG
Wszelkie prawa zastrzeżone. Kopiowanie materiałów bez zgody redakcji zabronione!
© 2002-2017 Ranmus (ranmus.pl), © 2017 {=|=} fable_inside();

[ Czas generowania strony: 0.02099 sekund ] [ Liczba zapytań MySQL: 13 ]