Praca z poprawkami
Poprawki umożliwiają programistom współużytkowanie swojej pracy bez konieczności zapisywania w repozytorium. Jest to przydatne rozwiązanie, jeśli programista chce wprowadzić zmiany w projekcie, który jest współużytkowany za pośrednictwem repozytorium, ale nie ma uprawnień do zapisu w tym repozytorium. W takiej sytuacji programista może utworzyć poprawkę i przesłać ją za pośrednictwem poczty elektronicznej do programisty z uprawnieniami do zapisu, bądź dodać ją w postaci załącznika do błędu w systemie raportowania błędów używanym przez projekt. Sposób postępowania jest zależny od procesu definiowanego przez ten projekt. Programista z uprawnieniami do zapisu może następnie zastosować poprawkę do projektu i zatwierdzić zmiany.
Aby utworzyć poprawkę z projektu CVS:
- Wybierz zasób zawierający modyfikacje, które mają zostać uwzględnione w poprawce. Może to być dowolny folder, ale najprościej jest wybrać sam projekt, ponieważ poprawka musi zostać zastosowana do tego samego zasobu, z którego została wygenerowana. Poprawka powinna być także zastosowana do tych samych podwersji pliku, na podstawie których została wygenerowana, dlatego też poprawkę należy zastosować do tego samego zestawu zasobów. Najlepiej więc utworzyć poprawkę na podstawie wersji.
- Z menu podręcznego wybierz kolejno opcje Zespół > Utwórz poprawkę. Zostanie otwarty kreator tworzenia poprawki.
- Wybierz położenie, w którym poprawka ma zostać zapisana:
- Zapisz w schowku - spowoduje umieszczenie poprawki w schowku, co umożliwi jej późniejsze wklejenie do edytora tekstu, takiego jak program pocztowy.
- Zapisz w systemie plików - spowoduje umieszczenie poprawki w określonym pliku w lokalnym systemie plików.
- Zapisz w obszarze roboczym - spowoduje umieszczenie poprawki w określonym pliku w jednym z istniejących projektów środowiska roboczego.
Małe poprawki można przenosić za pośrednictwem schowka, jednak w większości przypadków najlepszym rozwiązaniem jest użycie lokalnego systemu plików. Kliknij przycisk Dalej, aby skonfigurować sposób generowania poprawki.
- Wybierz sposób konfigurowania poprawki:
- Rekurencyjnie w podfolderach - wyłączenie tej opcji spowoduje uwzględnienie w poprawce tylko bezpośrednich elementów potomnych. W przeciwnym razie uwzględnione zostaną wszystkie elementy potomne.
- Włącz nowe pliki do poprawki - wyłączenie tej opcji spowoduje uwzględnienie w poprawce tylko plików objętych kontrolą wersji CVS. W przeciwnym razie uwzględnione zostaną również nowo utworzone pliki, które nie zostały dodane lub są ignorowane.
- Format danych wyjściowych diff - umożliwia wybranie typowych formatów wyjściowych diff. Wiele narzędzi służących do stosowania poprawek, w tym również platforma Eclipse, korzysta z formatu Zunifikowane.
-
Kliknij przycisk Zakończ.
- Prześlij poprawkę w sposób odpowiedni dla projektu, do którego ta poprawka ma być zastosowana.
Aby zastosować poprawkę:
- Wybierz zasób, dla którego została wygenerowana poprawka. Zasób powinien zawierać takie same podwersje plików, jak zestaw, dla którego poprawka została wygenerowana.
- Z menu podręcznego wybierz kolejno opcje Zespół > Zastosuj poprawkę. Zostanie otwarty kreator stosowania poprawek do zasobów.
- Wskaż położenie poprawki:
- Plik - poprawka znajduje się w pliku w lokalnym systemie plików. Należy wprowadzić pełną ścieżkę do tego pliku lub użyć przycisku Przeglądaj, aby znaleźć plik.
- Schowek - poprawka znajduje się w schowku. Ostrzeżenie: Użycie poprawki w pliku jest bezpieczniejsze. Znaki końca wierszy mogą być obsługiwane niepoprawnie, jeśli użyto schowka, a poprawka została wygenerowana na innej platformie (na przykład jeśli używane są systemy Linux i Windows).
Kliknij przycisk Dalej, aby zastosować poprawkę.
- W górnym panelu na tej stronie można sprawdzić, czy możliwe było pomyślne zastosowanie poprawki dla plików w obszarze roboczym. Wybranie w drzewie elementu liścia spowoduje wyświetlenie w dolnym panelu fragmentu pliku poprawki (określanego mianem "porcji"), który jest przedstawiany w czytelnej formie w formacie kolumnowym. Uwaga: W dolnym panelu nie jest wyświetlany podgląd zasobów po zastosowaniu tej porcji. Wyświetlana jest tylko treść pliku poprawki.
-
Zaznaczony element oznacza, że poprawkę (lub porcję) można z powodzeniem zastosować do zasobu obszaru roboczego.
Poprawki lub poszczególne porcje poprawek można wykluczać, anulując ich zaznaczenie.
-
Czerwony wykrzyknik wskazuje problem z poprawką lub porcją poprawki.
Może się tak zdarzyć, gdy poprawka nie jest poprawnie uformowana albo podwersja jednego lub większej liczby plików, na podstawie których poprawka została wygenerowana, nie odpowiada podwersjom, do których poprawka jest stosowana.
Przyczyna niepowodzenia jest podana w nawiasach.
Aby pomyślnie zastosować całą poprawkę, należy wyeliminować problemy (czerwone wykrzykniki) i spowodować zaznaczenie wszystkich pozycji, modyfikując opcje na tej stronie kreatora (patrz sekcja "Opcje").
- Jeśli wszystko wygląda poprawnie, kliknij przycisk Zakończ, aby zastosować poprawkę. Obszar roboczy będzie zawierał zmiany wychodzące dla każdego pliku zmodyfikowanego przez poprawkę.
Opcje dotyczące stosowania poprawek
Dostępne są następujące opcje umożliwiające dopasowanie pliku poprawki:
-
Powróć do pierwszej strony kreatora stosowania poprawek do zasobów i wybierz zasób, do którego poprawka ma zostać zastosowana.
-
Jeśli wspólny przedrostek nazw ścieżek przechowywanych w pliku poprawki nie odpowiada nazwom ścieżek w bieżącym obszarze roboczym, można wybrać opcję Ignoruj początkowe segmenty nazwy ścieżki.
-
Użyj opcji Ignoruj odstępy, aby podczas dopasowywania pliku poprawki i plików obszaru roboczego nie były brane pod uwagę różnice w zakresie znaków spacji, tabulacji lub nowego wiersza.
-
Dostosuj parametr Maksymalny współczynnik niedokładności. Ten współczynnik określa liczbę wierszy nad i pod oryginalnym wierszem, które mogą być przeszukiwane w celu dopasowania porcji poprawki. Wartością domyślną jest 2. Jeśli porcja poprawki nie zostanie dopasowana do wiersza określonego w pliku poprawki, kreator stosowania poprawek do zasobów spróbuje dopasować tę porcję poprawki do określonej współczynnikiem liczby wierszy nad i pod oryginalnym położeniem.
-
Opcja Wycofaj poprawkę umożliwia wycofanie poprawek, które już zostały zastosowane w obszarze roboczym. Ta opcja jest także przydatna do wycofywania lub przywracania poprawek.

Programowanie zespołowe za pomocą systemu CVS

Porównywanie zasobów

System CVS