Arbejd med patch
Ved hjælp af patches kan udviklere dele arbejde uden at gemme det i et opbevaringssted.
Det kan være nyttigt, når en udvikler vil bidrage til et projekt, der er delt via et opbevaringssted, og ikke har skriveadgang til opbevaringsstedet. I det tilfælde kan udvikleren oprette en patch og enten sende den til en udvikler, der har skriveadgang, eller knytte den til en fejl i fejlrapporteringssystemet, der anvendes af projektet, afhængigt af den proces der er defineret af projektet. En udvikler, som har skriveadgang, kan derefter anvende patchen på projektet og committe ændringerne.
Sådan opretter du en patch fra et CVS-projekt:
- Vælg den ressource, der indeholder de ændringer, der skal inkluderes i patchen. Du kan vælge ressourcer, der findes i flere projekter og på ethvert niveau, da guiden Opret patch, når den afvikles i standardtilstand, ved hvordan den opretter et multiprojekt. Patchen skal anvendes på de samme filrevisioner, som den er genereret på baggrund af. Du skal derfor sikre, at patchen anvendes på samme ressourcesammenstilling. Den nemmeste måde at gøre det på er at oprette patchen oven på revisionen.
- Vælg Team > Opret patch... i pop op-menuen. Guiden Opret patch vises.
- Vælg, hvor patchen skal gemmes:
- Gem i udklipsholder - Patchen placeres i udklipsholderen, så den kan sættes ind i en teksteditor, f.eks. et e-mail-program.
- Gem i filsystem - Patchen placeres i den angivne fil i det lokale filsystem.
- Gem i arbejdsområde - Patchen placeres i den angivne fil i et af de eksisterende arbejdsbænkprojekter.
Små patch kan overføres ved hjælp af udklipsholderen, men i de fleste tilfælde er det bedst at bruge det lokale filsystem.
- Du kan få vist resultatet af og fintune patchen ved at udvide træstrukturen Ressourcer, der vises i delvinduet Ændringer. Kun de elementer, der er valgte, inkluderes i patchen. Klik på Næste
for at konfigurere, hvordan patchen skal genereres.
- Vælg, hvordan patchen skal konfigureres:
- Diff-outputformat - Du kan vælge mellem flere forskellige, fælles diff-outputformater. Unified er det format, der benyttes af mange patchprogramværktøjer, bl.a. Eclipse. Det format, der bruges i Context- og Unified-diff'er, gør det muligt at anvende en patch, selvom det linjenummer, som er oplyst til hunk'en (patchterminologi) er forkert. I det tilfælde scanner algoritmen både fremad og bagud, når patchen anvendes, efter et sæt linjer, der matcher den kontekst, som er angivet for hunk'en.
- Patch-rod - Tillader dig at angive, på hvilket nivaeu din patch har rod. Valgene er Arbejdsområde, Projekt og Valg.
Arbejdsområde tillader dig at inkludere ressourcer fra flere projekter i din patch og er standardindstillingen. Arbejdsområde-patches kan anvendes på alle ressourcer i arbejdsområdet. De indeholder tilstrækkelige oplysninger til at tillade guiden Anvend patch til at konfigurere, hvilke ressourcer, der skal anvendes patch til.
Projekt-patches har rod på projektniveau. Det betyder, at de kun kan indeholde ressourcer fra ét projekt og skal anvendes på det samme projekt.
Valg-patches har rod i den valgte ressource og kan kun anvendes på den samme ressource.
- Klik på Afslut.
- Overfør patchen til det projekt, der skal opdateres med patch.
Sådan anvendes en patch:
- Vælg den ressource, som patchen blev genereret ud fra. Ressourcen skal indeholde de samme filrevisioner, som den sammenstilling patchen blev genereret ud fra.
- Vælg Team>Anvend patch... på pop op-menuen. Guiden Anvend patch åbnes.
Dette kan også opnås, hvis du kopierer patchindholdet til udklipsholderesn og indsætter det direkte i oversigten Package Explorer ved at vælge Redigér > Klistre.
I dette tilfælde kan du springe det næste trin over.
- Angiv, hvor patchen er placeret:
- Fil - Patchen er i en fil på det lokale filsystem. Angiv hele stien til filen, eller brug knappen
Gennemse... for at finde filen.
- Udklipsholder - Patchen er i udklipsholderen. Advarsel: Det er sikrere at benytte en filbaseret patch. Linjeslut håndteres evt. ikke korrekt, hvis du bruger udklipsholderen, og patchen er genereret på en anden platform, f.eks. Linux kontra Windows.
- URL - Patchen er placeret under den angivne URL. Advarsel;
Sørg for, at den URL, du angiver, er gyldig og indeholder en korrekt patch.
Ellers kan du ikke anvende den. Husk også, at det kan tage noget tid at anvende en patch direkte fra en URL.
- Arbejdsområde - Patchen er gemt et sted i arbejdsområdet.
Klik på Næste for at se virkningen af at anvende patchen.
-
Valgfri trin: Dette trin anvendes kun, hvis du har en patch med rod på projekt- eller valgniveau. Patches med rod i arbejdsområdet fortsætter automatisk til resultatsiden Patch. På siden Specifikation af patch-mål skal du vælge den ressource, der skal fungere som roden for patchen.
- Siden for visning af resultatet af patch viser, om patchen kan anvendes på filerne i arbejdsområdet. Det øverste delvindue viser listen over ændringer i patchen.
Der er to typer indgange i det øverste delvindue: filændringer og patch-segmenter uden match (kaldes 'hunk' i patchterminologi).
- Hvis et eller flere af patch-segmenter automatisk kan anvendes til filen, vises filen med en indikator for indgående ændring. Du kan undersøge ændringen ved at dobbeltklikke på filen.
- Hvis en eller flere hunks ikke kan anvendes automatisk, vises hunk-indgangene som underordnede for filen i det øverste delvindue, og et rødt udråbstegn angiver, at der er problemer med en patch eller hunk.
Du kan undersøge hunk'en ved at dobbeltklikke på den. Du kan derefter manuelt anvende hunk'en fra højre delvindue på filen til venstre. Hvis der gemmes i venstre delvindue, opdateres den overordnede filindgang i det øverste delvindue, men filen på disken ændres ikke. Filen på disken ændres først, når der klikkes på Afslut.
For at kunne anvende hele patchen korrekt skal du afhjælpe problemerne (røde udråbstegn), enten manuelt ved at anvende patch-segmenterne, ved at udelade patch-segmentet fra funktionen ved at vælge Fjern på kontekstmenuen eller ved at justere indstillingerne på denne side i guiden (se 'Indstillinger' nedenfor).
- Klik på Afslut for at anvende patchen, når alt ser fint ud. Arbejdsområdet indeholder nu udgående ændringer for hver af de filer, det er ændret ved hjælp af patchen.
Patches kan anvendes ved at synkronisere dem med lokalt indhold
Sådan synkroniseres med en patch:
-
Vælg funktionen Synkronisér... på menuen til knappen Synkronisér
i perspektivet Teamsynkronisering.
-
Vælg Synkronisér med patch på listen over mulige synkroniseringstyper, og klik på Næste.
- Angiv, hvor patchen er placeret:
- Fil - Patchen er i en fil på det lokale filsystem. Angiv hele stien til filen, eller brug knappen
Gennemse... for at finde filen.
- Udklipsholder - Patchen er i udklipsholderen. Advarsel: Det er sikrere at benytte en filbaseret patch. Linjeslut håndteres evt. ikke korrekt, hvis du bruger udklipsholderen, og patchen er genereret på en anden platform, f.eks. Linux kontra Windows.
- URL - Patchen er placeret under den angivne URL. Advarsel;
Sørg for, at den URL, du angiver, er gyldig og indeholder en korrekt patch.
Ellers kan du ikke anvende patchen. Husk også, at det kan tage noget tid at anvende en patch direkte fra en URL.
- Arbejdsområde - Patchen er gemt et sted i arbejdsområdet.
Klik på Næste for at se virkningen af at anvende patchen.
-
Valgfri trin: Dette trin anvendes kun, hvis du har en patch med rod på projekt- eller valgniveau. Patches med rod i arbejdsområdet fortsætter automatisk til resultatsiden Patch. På siden Specifikation af patch-mål skal du vælge den ressource, der skal fungere som roden for patchen.
-
Valgfrit trin: Dette trin skal kun anvendes, hvis patchen refererer til projekter, der ikke er tilgængelige - hvis alle projekter fra patch findes i arbejdsområdet og er åbne, springes siden over. På siden Projekter uden adgang kan du åbne lukkede projekter. Desuden vises oplysninger om ikke-eksisterende projekter.
Projekter, der er lukkede, eller som ikke findes i arbejdsområdet, kan ikke patches.
-
Klik på Afslut på den sidste side for at se et eksempel på patchændringer i oversigten Synkronisér.
Indstillinger i forbindelse med anvendelse af patch
Du skal have angivet følgende indstillinger for at få en succesfuld match af patchfilen:
-
Gå til første side i guiden Anvend patch, og vælg den korrekte ressource, som patchen skal anvendes på.
-
Hvis et fælles præfiks for stinavnene i patch-filen ikke matcher stinavnene i det aktuelle arbejdsområde, kan du vælge Ignorér foranstående stinavnssegmenter.
-
Du kan bruge knappen Ignorér tom plads til at gøre match-processen uafhængig af forskelle mellem tom plads i patchfilen og filer i arbejdsområdet.
-
Juster Fuzz-faktoren (patchterminologi). Denne faktor angiver, hvor mange hunk-kontekstlinjer der skal ignoreres.
Hvis værdien af Fuzz-faktoren er nul, skal alle linjer matche.
Hvis Fuzz-faktoren er større end nul, f.eks. 2, ignoreres de første to kontekstlinjer før hunk'en og de sidste to linjer efter hunk'en.
Klik på Gæt for at beregne den fuzz-faktor, som vil give det højeste antal matchede hunks.
-
Brug indstillingen Omvendt patch til patch-filer, der allerede er anvendt på arbejdsområdet. Denne indstilling er også nyttig i forbindelse med fortrydelse eller gentagelse af en patch.
-
For arbejdsområde-patches kan du vælge et andet projekt i arbejdsområdet, som patch-ændringerne skal anvendes til. Det gør du ved at vælge et projekt i det øverste delvindue og vælge Flyt på kontekstmenuen. Det åbner en dialogboks med en liste over tilgængelige projekter i arbejdsområdet. Vælg et projekt, og klik på OK. Patch-ændringerne anvendes på det valgte projekt.
-
Du kan bruge indstillingen Vis udeladte til at vise de hunks, du allerede har valgt ikke at inkludere i patchen.
-
Når du synkroniserer med en patch, er ovenstående indstillinger tilgængelige på menuen til oversigten Synkronisér.
Du kan også skifte mellem tilgængelige modeller for at få yderligere oplysninger om de ændringer, der anvendes.

Teamprogrammering med CVS

Sammenlign ressourcer
Synkronisér med opbevaringssted

Team
CVS