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, wykonaj następujące czynności:

  1. Wybierz zasób zawierający modyfikacje, które mają zostać uwzględnione w poprawce. Można wybrać zasoby znajdujące się w wielu projektach na dowolnym poziomie, ponieważ kreator tworzenia poprawki uruchomiony w trybie domyślnym potrafi utworzyć poprawki dla wielu projektów. 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.
  2. Z menu podręcznego wybierz opcję Zespół > Utwórz poprawkę. Zostanie otwarty kreator tworzenia poprawki.
  3. Wybierz położenie, w którym poprawka ma zostać zapisana:
    1. Zapisz w schowku - spowoduje umieszczenie poprawki w schowku, co umożliwi jej późniejsze wklejenie do edytora tekstu, takiego jak program pocztowy.
    2. Zapisz w systemie plików - spowoduje umieszczenie poprawki w określonym pliku w lokalnym systemie plików.
    3. 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.
  4. Można wyświetlić i dostosować wybór poprawek, rozwijając drzewo Zasoby w panelu Zmiany. Tylko zaznaczone elementy zostaną włączanie do poprawki. Kliknij przycisk Dalej, aby skonfigurować sposób generowania poprawki.
  5. Wybierz sposób konfigurowania poprawki:
    1. 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 (Unified). Formaty Kontekstowy (Context) oraz Zunifikowany (Unified) należące do formatów diff umożliwiają zastosowanie poprawki nawet w przypadku, gdy numer wiersza podany dla porcji (terminologia związana z poprawkami) nie jest poprawny. W tym przypadku podczas stosowania poprawki algorytm szuka zarówno w przód, jak i wstecz w zbiorze wierszy zgodnym z kontekstem podanym dla porcji.
    2. Katalog główny poprawki - umożliwia określenie na jakim poziomie umieszczony zostanie katalog główny poprawki. Można wybrać Obszar roboczy, Projekt albo Wybór.

      Opcja Obszar roboczy umożliwia włączenie do poprawki zasobów z wielu projektów, jest to opcja domyślna. Poprawki obszaru roboczego mogą zostać zastosowane do dowolnego zasobu w obszarze roboczym - zawierają one dostateczne informacje, aby kreator stosowania poprawek był w stanie określić, do których zasobów należy zastosować poprawkę.

      Dla opcji Projekt katalog główny poprawki znajduje się na poziomie projektu - oznacza to, że poprawka może zawierać tylko zasoby z jednego projektu i można ją stosować do tego samego projektu.

      Dla opcji Wybór katalog główny poprawki znajduje na poziomie wybranego zasobu, a poprawkę można zastosować tylko do tego zasobu.
  6. Kliknij przycisk Zakończ.
  7. Prześlij poprawkę w sposób odpowiedni dla projektu, do którego ta poprawka ma być zastosowana.

Aby zastosować poprawkę, wykonaj następujące czynności:

  1. 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.
  2. Z menu podręcznego wybierz opcję Zespół > Zastosuj poprawkę. Zostanie otwarty kreator stosowania poprawek.

    Ten sam efekt można także osiągnąć przez skopiowanie treści poprawki do schowka i wklejenie jej bezpośrednio w widoku Eksplorator pakietów, wybierając opcję Edycja > Wklej. W takim przypadku można pominąć następny krok.
  3. Wskaż położenie poprawki:
    1. 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.
    2. 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).
    3. Adres URL - poprawka znajduje się pod podanym adresem URL. Ostrzeżenie: należy upewnić się, że wprowadzony adres URL jest poprawny i zawiera odpowiednią poprawkę. W przeciwnym razie nie będzie można jej zastosować. Trzeba również pamiętać, że zastosowanie poprawki bezpośrednio z adresu URL może zająć trochę czasu.
    4. Obszar roboczy - poprawka znajduje się gdzieś w obszarze roboczym.
    Kliknij przycisk Dalej, aby zastosować poprawkę.
  4. Czynność opcjonalna: ta czynność ma zastosowanie tylko wtedy, gdy katalog główny poprawki znajduje się na poziomie projektu lub wyboru - dla poprawek o katalogu głównym na poziomie obszaru roboczego następuje automatyczne przejście do strony podglądu poprawki. Na stronie określania elementu docelowego poprawki należy wybrać zasób, na poziomie którego będzie katalog główny poprawki.
  5. Na stronie podglądu poprawki można sprawdzić, czy możliwe będzie pomyślne zastosowanie poprawki dla plików w obszarze roboczym. W górnym panelu wyświetlana jest lista zmian zawartych w poprawce. W panelu górnym są dwa typy pozycji: zmiany w pliku i niezgodne segmenty poprawek (w terminologii poprawek nazywane porcjami).
    1. Jeśli co najmniej jeden segment poprawki można zastosować automatycznie do pliku, plik ten zostanie oznaczony indykatorem zmiany przychodzącej. Aby sprawdzić tę zmianę, kliknij dwukrotnie plik.
    2. Jeśli co najmniej jedna porcja poprawki nie może zostać zastosowana automatycznie, pozycja porcji poprawki zostanie wyświetlona jako element potomny pliku w panelu górnym, a czerwony wykrzyknik wskaże, że wystąpił problem z poprawką lub porcją poprawki. Aby sprawdzić porcję poprawki, kliknij ją dwukrotnie. Następnie można samodzielnie zastosować porcję poprawki z prawego panelu do pliku wyświetlanego z lewej strony. Zapisanie zmian w lewym panelu spowoduje aktualizację nadrzędnej pozycji pliku w górnym panelu, ale nie spowoduje modyfikacji pliku na dysku. Plik na dysku jest modyfikowany tylko po naciśnięciu przycisku Zakończ. Aby pomyślnie zastosować całą poprawkę, należy wyeliminować problemy (czerwone wykrzykniki), samodzielnie stosując segmenty poprawek, wykluczając segment poprawki (wybierając w menu kontekstowym opcję Usuń) albo modyfikując opcje na stronie kreatora (patrz sekcja "Opcje").
  6. 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ę.

Poprawki można zastosować, synchronizując je z treścią lokalną.

Synchronizowanie z poprawką

  1. W perspektywie Synchronizowanie zespołów kliknij przycisk rozwijany Synchronizacja i wybierz akcję Synchronizuj.
  2. Z listy możliwych typów synchronizacji wybierz pozycję Synchronizuj z poprawką, a następnie kliknij przycisk Dalej.
  3. Wskaż położenie poprawki:
    1. 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.
    2. 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).
    3. Adres URL - poprawka znajduje się pod podanym adresem URL. Ostrzeżenie: należy upewnić się, że wprowadzony adres URL jest poprawny i zawiera odpowiednią poprawkę. W przeciwnym razie nie będzie można jej zastosować. Trzeba również pamiętać, że zastosowanie poprawki bezpośrednio z adresu URL może zająć trochę czasu.
    4. Obszar roboczy - poprawka znajduje się gdzieś w obszarze roboczym.
    Kliknij przycisk Dalej, aby zastosować poprawkę.
  4. Czynność opcjonalna: ta czynność ma zastosowanie tylko wtedy, gdy katalog główny poprawki znajduje się na poziomie projektu lub wyboru - dla poprawek o katalogu głównym na poziomie obszaru roboczego następuje automatyczne przejście do strony podglądu poprawki. Na stronie określania elementu docelowego poprawki należy wybrać zasób, na poziomie którego będzie katalog główny poprawki.
  5. Czynność opcjonalna: ta czynność ma zastosowanie tylko wtedy, gdy poprawka odwołuje się do projektów, które są niedostępne. Jeśli wszystkie projekty z poprawki znajdują się w obszarze roboczym i są otwarte, ta strona zostanie pominięta. Na stronie Niedostępne projekty można otworzyć dowolne zamknięte projekty. Ponadto wyświetlane są szczegóły dotyczące nieistniejących projektów. Poprawki nie można zastosować do projektów zamkniętych lub nieistniejących w obszarze roboczym.
  6. Na ostatniej stronie kliknij przycisk Zakończ, aby wyświetlić podgląd zmian z poprawki w widoku Synchronizacja.

Opcje dotyczące stosowania poprawek

Dostępne są następujące opcje umożliwiające dopasowanie pliku poprawki:
  1. Wróć do pierwszej strony kreatora stosowania poprawek i wybierz zasób, do którego poprawka ma zostać zastosowana.
  2. 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.
  3. Użyj przycisku 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.
  4. Dopasuj Współczynnik niedoskonałości (terminologia związana z poprawkami). Ten współczynnik wskazuje liczbę wierszy kontekstu porcji, które należy zignorować. Jeśli wartość współczynnika niedoskonałości wynosi zero, wszystkie wiersze muszą być zgodne. Jeśli wartość współczynnika niedoskonałości wynosi więcej niż zero, na przykład 2, dwa pierwsze wiersze kontekstu przed porcją i dwa ostatnie wiersze kontekstu za porcją są ignorowane. Kliknij przycisk Określ, aby obliczyć współczynnik niedokładności umożliwiający osiągnięcie zgodności przez większość porcji poprawek.
  5. Użyj opcji Wycofaj poprawkę w odniesieniu do plików poprawek, które już zostały zastosowane w obszarze roboczym. Ta opcja jest także przydatna do wycofywania lub przywracania poprawek.
  6. Dla poprawek obszaru roboczego można wybrać inny projekt w obszarze roboczym, do którego można zastosować zmiany z poprawki. W tym celu wybierz projekt w panelu górnym i wybierz w menu kontekstowym opcję Przenieś. Spowoduje to wyświetlenie okna dialogowego z listą wszystkich projektów, które są dostępne w obszarze roboczym. Wybierz projekt i kliknij przycisk OK; zmiany z poprawki zostaną zastosowane do wybranego projektu.
  7. Użyj opcji Pokaż wykluczone, aby wyświetlić porcje poprawek wybrane do wykluczenia z poprawki.
  8. Podczas synchronizowania z poprawką powyższe opcje są dostępne w menu rozwijanym widoku Synchronizacja. Istnieje również możliwość przełączania się między dostępnymi modelami w celu uzyskania dodatkowych informacji o stosowanych zmianach.

Pojęcia pokrewne
Programowanie zespołowe za pomocą systemu CVS

Czynności pokrewne
Porównywanie zasobów
Synchronizowanie z repozytorium

Informacje pokrewne
Zespół System CVS