Bazaar (lub bzr) to projekt autorstwa Kanoniczny do łatwego i prostego przeprowadzania kontroli wersji w rozwoju oprogramowania open source. Jest to narzędzie używane w programie Launchpad do zarządzania wersjami pakietów. W Launchpad przechowywane wiele projektów open source ale nie wszystko; więc ten samouczek posłuży tylko do współpracy przy tworzeniu aplikacji tam przechowywanych.
Jeśli nigdy nie tworzyłeś projektu w Launchpad ponieważ uważasz to za bardzo skomplikowane, ten artykuł Cię zainteresuje. |
Wprowadzenie
Aby rozpocząć, musisz zainstalować bzr:
sudo apt-get zainstaluj bzr
Bazaar polega na kluczach SSH do przesyłania plików na konto Launchpad. Jeśli nie masz klucza SSH, możesz postępować zgodnie z poniższymi instrukcjami, aby uzyskać klucz SSH z Launchpada. Jeśli już go masz, możesz pominąć tę część i przejść bezpośrednio do sekcji „Korzystanie z Bazaru”.
Klucz Launchpad / SSH
Aby utworzyć klucz SSH:
ssh-keygen -t dsa
Odpowiedz na pierwsze pytanie opcją domyślną, naciskając klawisz Enter, a następnie wprowadź „hasło” lub „hasło” dla klucza SSH. Kiedy skończyłem, pobiegłem:
cat ~ / .ssh / id_dsa.pub
Skopiuj swój klucz publiczny, który został pokazany w poprzednim kroku, przejdź do Launchap i edytuj swój klucz SSH:
https://launchpad.net/~username/+editsshkeys
Nie zapomnij zmienić nazwy użytkownika x swoje imię i nazwisko oraz editsshkeys x swój klucz SSH.
Wklej klucz w polu „Dodaj klucz SSH” i kliknij „Importuj klucz publiczny”.
Korzystanie z Bazaar
Powiedzmy, że na Launchpadzie znalazłeś projekt, nad którym chcesz współpracować, a może chcesz pobrać jego kod źródłowy, aby dostosować go do swoich potrzeb. Załóżmy również, że ten projekt jest perlbot. W takim przypadku musiałbyś udać się do:
https://code.launchpad.net/~drsmall/perlbot/trunk
Możesz zobaczyć katalog ze wszystkimi plikami („trunk”), a także zobaczyć wersje projektu.
Jeśli chcesz pobrać kopię "pnia" na swój dysk twardy, wystarczy uruchomić:
bzr pull lp: perlbot
To polecenie pobierze kod źródłowy Perlbot do ~ / perlbot na dysku twardym. Możesz go zmodyfikować i przesłać swoje modyfikacje z powrotem do linii głównej (z niezbędnymi uprawnieniami).
Załóżmy więc, że chcesz rozpocząć własną wersję (lub „gałąź”), w której możesz przechowywać i udostępniać modyfikacje wprowadzone w programie lub może to być również coś stworzonego przez Ciebie, co chcesz rozwijać jako zespół . Aby to zrobić, zbierz wszystkie pliki umieszczone w twojej "gałęzi" w Launchpadzie i umieść je w katalogu lokalnym. Następnie uruchomić:
inicjacja bzr
To zmienia ten katalog w gałąź. Jeśli spróbujesz spojrzeć, zobaczysz, że w twoim katalogu znajduje się teraz nowy katalog o nazwie .bzr. To tam są przechowywane wszystkie wersje i pliki do użytku przez bzr. Teraz dodaj wszystkie pliki do gałęzi:
bzr dodaj *
Warto przyzwyczaić się do uruchomienia następnego polecenia, aby sprawdzić zmiany między najnowszą a aktualną wersją. Nie powinieneś tego robić za pierwszym razem.
bzr różnica
W następnym kroku zamierzamy zatwierdzić nasze zmiany w nowej wersji. Warto obficie komentować swoje recenzje.
bzr commit -m "Komentarz z wersji XX"
Teraz będziesz mógł przesłać swoją recenzję do swojej „gałęzi” w Launchpadzie. Jeśli gałąź jeszcze nie istnieje, zostanie utworzona. Możesz mieć wiele oddziałów, więc radzę nadać im prawidłowe nazwy. To polecenie może zająć kilka minut, ale pamiętaj, że musi utworzyć „gałąź”, przesłać pliki, utworzyć poprawki itp.
bzr push lp: ~ użytkownik / nazwa projektu / nazwa gałęzi
Inne przydatne polecenia:
Utwórz oddział:
inicjacja bzr
Pobierz oddział:
bzr ciągnąć
Zaktualizuj oddział:
bzr pchać
Dodaj pliki do swojego oddziału:
bzr dodaj
Sprawdź różnicę między wersjami:
bzr różnica
Zatwierdź recenzję:
bzr commit -m "Komentarz do wersji"
Resztę podstawowych poleceń znajdziesz, uruchamiając:
człowiek bzr