Werken met patches

Dankzij patches kunnen ontwikkelaars hun werk met anderen delen zonder dit in een repository op te slaan. Dit is handig wanneer een ontwikkelaar iets wil bijdragen aan een project dat via een repository wordt gedeeld maar geen toegang tot de repository heeft. In dat geval kan de ontwikkelaar een patch maken en deze e-mailen naar een ontwikkelaar die wel schrijftoegang heeft of de patch koppelen aan een fout in het foutrapportagesysteem dat door het project wordt gebruikt, afhankelijk van het proces dat door het project is gedefinieerd. Een ontwikkelaar die schrijftoegang heeft kan de patch vervolgens toepassen op het project en de wijzigingen vastleggen.

Een patch maken vanuit een CVS-project:

  1. Selecteer de resource die de wijzigingen bevat die in de patch moeten worden opgenomen. Als in de wizard Patch maken (indien uitgevoerd in de standaardwerkstand) bekend is hoe een patch voor meerdere projecten moet worden gemaakt, kunt u resources selecteren die deel uitmaken van meerdere projecten en die op alle niveaus voorkomen. De patch moet ook worden toegepast op dezelfde bestandsherzieningen als waarop deze is gegenereerd en er moeten stappen worden genomen om ervoor te zorgen dat de patch wordt toegepast op dezelfde resourceline-up (de gemakkelijkste manier om dit te doen is door de patch boven op een versie te maken).
  2. Selecteer Team > Patch maken... in het voorgrondmenu. De wizard Patch maken worden geopend.
  3. Kies de plaats waar u de patch wilt opslaan:
    1. Opslaan naar klembord - hiermee plaatst u de patch op het klembord zodat u deze in een teksteditor zoals een e-mailprogramma kunt plakken.
    2. Opslaan in bestandssysteem - hiermee plaatst u de patch in het opgegeven bestand in het lokale bestandssysteem.
    3. Opslaan in werkgebied - hiermee plaatst u de patch in het opgegeven bestand binnen een van de bestaande workbenchprojecten.
    Voor kleine patches kan het aanvaardbaar zijn om de patch over te brengen met behulp van het klembord maar in de meeste gevallen kunt u het beste gebruikmaken van het lokale bestandssysteem.
  4. U kunt een preview bekijken van de patchselectie en deze verfijnen door de structuur voor resources in het venster met wijzigingen uit te vouwen. Alleen de elementen die zijn geselecteerd, worden in de patch opgenomen. Klik op Volgende om op te geven hoe de patch moet worden geconfigureerd.
  5. Kies een methode voor de configuratie van de patch:
    1. Verschil uitvoerindeling - Maakt de keuze mogelijk uit meerdere uitvoerindelingen. Verenigd is de indeling die wordt gebruikt door veel patchprogramma's zoals Eclipse. De indeling die wordt gebruikt in context- en verenigde diffs maakt het mogelijk een patch aan te brengen, zelfs als het aangegeven regelnummer voor de hunk (patchterminologie) onjuist is. In een dergelijk geval wordt tijdens het aanbrengen van de patch met een algoritme voor- en achterwaarts gezocht naar een set regels die overeenkomen met de aangegeven context voor de hunk.
    2. Patchroot - Hiermee kunt u aangeven op welk rootniveau de patch zich bevindt. U kunt kiezen uit Werkgebied, Project en Selectie.

      Met Werkgebied kunt u resources uit meerdere projecten in uw patch opnemen (de standaardoptie). Werkgebiedpatches kunnen worden toegepast op elke resource in het werkgebied; ze bevatten voldoende informatie voor de wizard Patch toepassen om te bepalen welke resources in de patch moeten worden opgenomen.

      Project-patches vinden plaats op projectniveau, wat betekent dat ze resources uit slechts één project kunnen bevatten en op hetzelfde project moeten worden toegepast.

      Selectie-patches vinden plaats op het niveau van de geselecteerde resource en moeten worden toegepast op dezelfde resource.
  6. Klik op Voltooien.
  7. Breng de patch zoals gewenst over naar het project waarin u de patch wilt aanbrengen.

Om een patch toe te passen, gaat u als volgt te werk:

  1. Selecteer de resource waarop de patch is gegenereerd. Deze resource moet dezelfde bestandsherzieningen bevatten als de line-up waarop de patch is gegenereerd.
  2. Selecteer Team > Patch toepassen... in het voorgrondmenu. De wizard Patch Toepassen worden geopend.

    U kunt dit ook doen door de inhoud van de patch naar het klembord te kopiëren en deze rechtstreeks naar de Pakketverkenner te kopiëren door Bewerken > Plakken te kiezen. In dit geval kunt u de volgende stap overslaan.
  3. Geef aan waar de patch kan worden gevonden:
    1. Bestand - de patch bevindt zich in een bestand op het lokale bestandssysteem. Typ het volledige pad van het bestand of gebruik de knop Bladeren... om het bestand te zoeken.
    2. Klembord - de patch staat op het klembord. Waarschuwing: Het is veiliger om een patch te gebruiken die zich in een bestand bevindt. Regeleinden kunnen niet goed worden verwerkt wanneer u gebruik maakt van het klembord en de patch op een ander platform is gegenereerd (bijvoorbeeld Linux versus Windows).
    3. URL - de patch bevindt zich onder de aangegeven URL. Waarschuwing: Controleer of de ingevoerde URL geldig is en een correct pad heeft. Anders kunt u deze niet toepassen. Onthoud ook dat het toepassen van de patch rechtstreeks vanuit een URL enige tijd vergt.
    4. Werkgebied - De patch is op een willekeurige plek in het werkgebied opgeslagen.
    Klik op Volgende om het effect van het toepassen van de patch te zien.
  4. Optionele stap: deze stap is alleen van toepassing als uw patch zich op project- of selectieniveau bevindt. Voor werkgebiedpatches wordt de previewpagina voor patches automatisch afgebeeld. Selecteer op de pagina Patchdoelspecificatie de resource die moet dienen als root van de patch.
  5. Op de patchpreviewpagina wordt aangegeven of patch kan worden toegepast op de bestanden in het werkgebied. In het bovenste venster vindt u een lijst van wijzigingen in de patch. Het bovenste venster bevat twee typen items: bestandswijzigingen en niet-overeenkomende patchsegmenten (ook wel 'hunk' genoemd in patchterminologie).
    1. Als een of meer patchsegmenten automatisch op het bestand kunnen worden toegepast, wordt het bestand afgebeeld met een inkomende wijzigingsindicator. U kunt de wijziging bekijken door te dubbelklikken op het bestand.
    2. Als een of meer hunks niet automatisch kunnen worden toegepast, verschijnen de hunkitems als onderliggend items van het bestand in het bovenste venster en geeft een rood uitroepteken aan dat er een probleem met een patch of hunk is. U kunt de hunk bekijken door hierop te dubbelklikken. U kunt dan handmatig de hunk uit het rechtervenster toepassen op het bestand in het linkervenster. Als u bestanden opslaat in het linkervenster wordt het bovenliggende bestandsitem in het bovenste venster bijgewerkt maar wordt het bestand niet op de schijf gewijzigd. Het bestand op de schijf wordt alleen gewijzigd als op Voltooien wordt geklikt. Om de volledige patch te kunnen toepassen moet u de problemen (rode uitroeptekens) oplossen door de patchsegmenten handmatig toe te passen, door het patchsegment uit te sluiten van de bewerking door Verwijderen te selecteren uit het contextmenu of door de opties op deze wizardpagina aan te passen (zie 'Opties').
  6. Als alle problemen zijn opgelost, klikt u op Voltooien om de patch toe te passen. Het werkgebied bevat nu uitgaande wijzigingen voor elk bestand dat door de patch is gewijzigd.

Patches kunnen worden toegepast door ze te synchroniseren met lokale content

Om te synchroniseren met een patch doet u het volgende:

  1. Selecteer in het perspectief Teamsynchronisatie de actie Synchroniseren... uit het voorgrondmenu Synchroniseren .
  2. Selecteer Synchroniseren met patch uit de lijst met mogelijke synchronisatietypen en klik op Volgende.
  3. Geef aan waar de patch kan worden gevonden:
    1. Bestand - de patch bevindt zich in een bestand op het lokale bestandssysteem. Typ het volledige pad van het bestand of gebruik de knop Bladeren... om het bestand te zoeken.
    2. Klembord - de patch staat op het klembord. Waarschuwing: Het is veiliger om een patch te gebruiken die zich in een bestand bevindt. Regeleinden kunnen niet goed worden verwerkt wanneer u gebruik maakt van het klembord en de patch op een ander platform is gegenereerd (bijvoorbeeld Linux versus Windows).
    3. URL - de patch bevindt zich onder de aangegeven URL. Waarschuwing: Controleer of de ingevoerde URL geldig is en een correct pad heeft. Anders kunt u de patch niet toepassen. Onthoud ook dat het toepassen van de patch rechtstreeks vanuit een URL enige tijd vergt.
    4. Werkgebied - De patch is op een willekeurige plek in het werkgebied opgeslagen.
    Klik op Volgende om het effect van het toepassen van de patch te zien.
  4. Optionele stap: deze stap is alleen van toepassing als uw patch zich op project- of selectieniveau bevindt. Voor werkgebiedpatches wordt de previewpagina voor patches automatisch afgebeeld. Selecteer op de pagina Patchdoelspecificatie de resource die moet dienen als root van de patch.
  5. Optionele stap: deze stap is alleen van toepassing als uw patch verwijst naar projecten die niet toegankelijk zijn - als alle projecten van de patch in het werkgebied aanwezig zijn en open zijn, wordt deze pagina overgeslagen. Op de pagina met niet-toegankelijke projecten kunt u alle gesloten projecten openen.Daarnaast worden detailgegevens over niet-bestaande projecten afgebeeld. Op projecten die gesloten zijn of niet in het werkgebied aanwezig zijn, kan geen patch worden toegepast.
  6. Op de laatste pagina klikt u op Voltooien om een preview te bekijken van de wijzigingen die door de patch worden aangebracht.

Opties voor toepassing van een patch

Om patches met succes toe te passen, kunt u de volgende opties gebruiken:
  1. Ga terug naar de wizard Patch toepassen en selecteer de resource waarop de patch moet worden toegepast.
  2. Als een gemeenschappelijk voorvoegsel van de padnamen in het patchbestand niet overeenkomt met de padnamen in uw huidige werkgebied, kunt u de optie Voorloop-padnaamsegmenten negeren selecteren.
  3. Gebruik de knop Witruimte negeren om bij het vergelijkingsproces geen rekening te houden met verschillen tussen de gebruikte witruimten in het patchbestand en in de bestanden in uw werkgebied.
  4. Aanpassen van de Fuzzfactor (patchterminologie). Deze factor geeft aan hoeveel contextregels voor de hunk moeten worden genegeerd. Als de waarde voor de fuzzfactor nul is moeten alle regels overeenkomen. Als de fuzzfactor groter is dan nul, bijvoorbeeld twee, worden de eerste twee contextregels voor de hunk en de laatste twee contextregels na de hunk genegeerd. Klik op Schatten om de fuzzfactor te berekenen waarmee de meeste hunks kunnen worden afgestemd.
  5. Gebruik de optie Patch omkeren voor patchbestanden die al op uw werkgebied zijn toegepast. Deze optie is ook handig voor het ongedaan maken of opnieuw uitvoeren van een patch.
  6. Voor werkgebiedpatches kunt u een ander project in uw werkgebied te selecteren waarop de patchwijzigingen moeten worden toegepast. Hiertoe selecteert u een project in het bovenste venster en selecteert u Verplaatsen in het voorgrondmenu. Hiermee wordt een dialoogvenster gestart waarin een lijst wordt afgebeeld van alle beschikbare projecten in uw werkgebied. Selecteer een project en klik op OK; De patchwijzigingen worden op het geselecteerde project toegepast.
  7. Gebruik de optie Uitgesloten items afbeelden om de hunks af te beelden die u al hebt geselecteerd om deze niet in de patch op te nemen.
  8. Bij de synchronisatie met een patch zijn de bovenstaande opties beschikbaar in het menu van de view Synchroniseren. U kunt ook schakelen tussen beschikbare modellen voor extra informatie over de wijzigingen die worden toegepast.

Verwante concepten
Programmeren in teams met CVS

Verwante taken
Resources vergelijken
Synchroniseren met de repository

Verwante onderwerpen
Team CVS