pure-systems pure::variants Versiju kontroles sistēmu savienotājs

Informācija par produktu

Pure::variants Connector for Version Control Systems (VCS) ir programmatūras paplašinājums, ko izstrādājusi pure-systems GmbH. Tas ir paredzēts vietējai sinhronizācijai files izmanto variantu transformācijās ar files no programmatūras konfigurācijas pārvaldības (SCM) repozitorija. Šis savienotājs nodrošina vispārīgu transformācijas moduli, kas izmanto VCS specifisku iesaiņojuma programmu, lai savienotu tīros::variants ar VCS klientu.

Ir svarīgi atzīmēt, ka populārām SCM sistēmām, piemēram, CVS un Subversion, ir pieejami īpaši savienotāji, kas pazīstami kā tīrais::variants savienotājs CVS un pure::variants savienotājs Subversion. Šajā lietotāja rokasgrāmatā ir paskaidrots, kā izmantot savienotāju, un sniegti norādījumi par VCS specifiskās programmas interfeisa ieviešanu. Tas ietver arī bijušoampCVS VCS iesaiņojuma le. Ir pieejama šī dokumenta drukājama versija.

Programmatūras prasības

• Connector for Version Control Systems (VCS) ir tīru::variantu paplašinājums un ir saderīgs ar visām atbalstītajām platformām.

Konspekts

• Tīrais::variants savienotājs versiju kontroles sistēmām (VCS) tiek izmantots, lai sinhronizētu vietējo files izmanto variantu transformācijās ar files no programmatūras konfigurācijas pārvaldības repozitorija.
• Šis paplašinājums nodrošina vispārīgu transformācijas moduli, izmantojot VCS specifisku iesaiņojuma programmu, lai savienotu tīros::variants ar VCS klientu.

Piezīme

• Populārajām SCM sistēmām CVS un Subversion ir pieejami īpaši savienotāji, ti, tīrie::varianti
• Savienotājs CVS un tīrs::variants Subversion savienotājs.
• Šajā dokumentā ir aprakstīts, kā tiek izmantots savienotājs un kā jārealizē VCS īpašās programmas interfeiss. Turklāt tas nodrošina bijušoamppopulārā CVS VCS iesaiņojuma le.
• Ir pieejama šī dokumenta drukājama versija.

Programmatūras prasības

• Connector for Version Control Systems (VCS) ir tīro::variantu paplašinājums un ir pieejams visās atbalstītajās platformās.

Koncepcija

Šī savienotāja mērķis ir sinhronizēt files transformācijas izvades direktorijā ar atbilstošo files no lokālas vai attālas VCS repozitorija šādā veidā. VCS pārvaldīts files ir modelēti, izmantojot ps: simfile avota elementi. Ja tāds modelēts file transformācijas izvades direktorijā vēl nepastāv, tas tiek izņemts no VCS repozitorija. Ja tiek norādīts lokālais VCS repozitorijs (vietējais darba direktorijs), file vispirms tiek meklēts tur. Pretējā gadījumā file tiek izrakstīta no attālās VCS repozitorija.

Ja a file jau pastāv transformācijas izvades direktorijā, tas ir sinhronizēts ar atbilstošo file VCS repozitorijā atbilstoši tās pārskatīšanas un izmaiņu stāvoklim. Atkal tas vispirms tiek meklēts vietējā darba direktorijā, ja tas ir norādīts. Lai sinhronizētu fileIzmantojot dažādas SCM sistēmas, savienotājs faktiskajai saziņai ar VCS izmanto VCS specifisku iesaiņojuma programmu. Šīs iesaiņojuma programmas īstenotājs ir atbildīgs par iepriekšminētā algoritma ieviešanu. Ieviesējs var izvēlēties, kādu funkcionalitāti nodrošina iesaiņotājs un kādu VCS klients. Ja, piemēram, konkrēts VCS neatbalsta vietējos darba direktorijus, iesaiņojuma programmas īstenotājs var atjaunot šo vai līdzīgu funkcionalitāti iesaiņojumā.

Piezīme: Lūdzam jautāt iesaiņojuma programmas ieviesējam, vai trūkst kādas funkcionalitātes vai kādu citu funkcionalitāti ievieš iesaiņotājs un konkrētais VCS.

Klienta autorizācija

Savienotājs paļaujas uz VCS klienta ārējo autorizāciju. Ja sinhronizācijas procesa laikā VCS klienta programma interaktīvi pieprasa lietotājvārdu un/vai paroli, tāpēc vai nu nav iespējams izmantot VCS savienotāju, vai arī iesaiņojuma programmai ir jānodrošina funkcionalitāte, lai nosūtītu nepieciešamo autorizācijas informāciju VCS klientam (ja klients pats nenodrošina atbilstošu funkcionalitāti).

Piezīme: Lūdzu, jautājiet iesaiņojuma programmas ieviesējam vai skatiet VCS dokumentāciju, lai iegūtu informāciju par to, kā nepieciešamības gadījumā nodrošināt VCS klienta autorizācijas informāciju.

Savienotāja uzstādīšana

• Lūdzu, skatiet sadaļu “pure::variants Connectors” Pure::variants iestatīšanas rokasgrāmatā, lai iegūtu detalizētu informāciju par savienotāja uzstādīšanu (izvēlne Palīdzība -> Palīdzības saturs un pēc tam pure::variants Iestatīšanas rokasgrāmata -> pure::variants Connectors) .

Izmantojot savienotāju

Pēc savienotāja instalēšanas ir pieejams jauns transformācijas modulis ar nosaukumu “scmwrapper”. Lai redzētu, vai savienotājs ir pieejams, atveriet konfigurācijas telpas rekvizītus, konfigurācijas telpas konteksta izvēlnē izvēloties Rekvizīti. Lapā Konfigurācijas telpa pārejiet uz cilni Transformācijas konfigurācija un pēc tam noklikšķiniet uz pogas Pievienot. Tiek atvērts dialoglodziņš, kurā parādīts pieejamo transformācijas moduļu saraksts. Tajā ir jāietver modulis “scmwrapper”, kā parādīts 2. attēlā “Pieejamie transformācijas moduļi”.

Savienotāja konfigurācija

Kā aprakstīts iepriekš, VCS savienotājs faktiskajai darbībai izmanto iesaiņojuma programmu file sinhronizācija. Komandrinda šīs iesaiņojuma programmas izsaukšanai ir jāievada savienotāja konfigurācijas lapā. Atveriet pieejamo transformācijas moduļu sarakstu, kā aprakstīts šīs nodaļas sākumā. Pārliecinieties, vai ir atzīmēta moduļa “scmwrapper” izvēles rūtiņa. Pēc tam noklikšķiniet uz pogas Tālāk, lai atvērtu VCS savienotāja konfigurācijas lapu (skatiet 3. attēlu, “VCS savienotāja konfigurācija”).

Modulim “scmwrapper” ir tieši viens parametrs.

Iesaiņojuma programma: Komandrinda iesaiņojuma programmas izsaukšanai. Aptinuma programma tiek izpildīta katram ps:scmfile avota elements ievades modeļos. Informācija par pašreizējo ps:scmfile avota elements tiek nodots iesaiņojumam, izmantojot vides mainīgos.

Lai transformācijas konfigurācija būtu derīga, ir jānorāda transformācijas izvades direktorijs. Šajā direktorijā files no VCS repozitorija ir rakstīti. Izvades direktorijs ir norādīts konfigurācijas telpas rekvizītu dialoga lapā Input-Output (sk. 4. attēlu, “Transformācijas izvades direktorijs”). Papildinformāciju par transformācijas iestatīšanu skatiet sadaļā "Transformācijas konfigurācijas lapa" nodaļā "5.3.7. Configuration Space Editor” no pure::variants Eclipse Plugin lietotāja rokasgrāmatas.

ps:scmfile Avota elements

VCS pārvaldīts files ir modelēti, izmantojot ps:scmfile avota elementi. Šī avota elementa atribūti ir norādīti tālāk. Šie atribūti ir kopēja informācijas kopa, kas nepieciešama VCS, lai sinhronizētu a file. Noteiktām SCM sistēmām dažiem atribūtiem var nebūt nozīmes vai tiem var būt nedaudz atšķirīga nozīme kā citām SCM sistēmām. Tādējādi tikai atribūti, lai norādītu VCS repozitorija atrašanās vietu un nosaukumu un ceļu file sinhronizācija ir obligāta.

Piezīme: Lūdzu, skatiet VCS dokumentāciju vai jautājiet iesaiņojuma programmas īstenotājam par šo atribūtu VCS specifisko nozīmi.

• repozitorijs: [Obligāts] VCS repozitorijs, kurā ir file.
• rež.: [Obligāts] Pārvaldītā VCS direktoriju daļa file attiecībā pret doto VCS moduli.
• file: [Obligāti] file nosaukuma daļa no pārvaldītās VCS file.
• srcdir: [Neobligāti] Pārvaldītā VCS direktorija daļa file attiecībā pret doto moduli. Jāizmanto, ja avota direktorija atrašanās vieta atšķiras no mērķa direktorija atrašanās vietas.
• srcfile: [Neobligāti] file daļa no VCS pārvaldītās file. Jāizmanto, ja avots file nosaukums atšķiras no mērķa file nosaukums.
• veids: [Neobligāti] veids file atbilstoši ps atribūtam “tips”:file avota elements.
• modulis: [Neobligāti] VCS repozitorijā esošā moduļa nosaukums, kurā ir file.
• filiāle: [Neobligāti] VCS repozitorija filiāles nosaukums, kas satur file.
• tag: [Neobligāti] tag no VCS pārvaldītās file.
• versija: [Neobligāti] Pārvaldītā VCS versija file.
• datums: [Neobligāti] Datums, kas norāda pārvaldītās VCS versiju file.
• darba direktors: [Neobligāti] Vietējais darba direktorijs, kurā ir vietējās kopijas files tiek pārvaldīts VCS repozitorijā.

Lai izveidotu jaunu ps:scmfile avota elementu izvēlieties Jauns->SCM File no daļas elementa konteksta izvēlnes. Tas atver jauno SCM File vednis, kā parādīts 5. attēlā, “Jauns SCM File Vednis”.

Pēc transformācijas un ieejas modeļu iestatīšanas tiek veikta modelētā VCS sinhronizācija files tiek sākts, veicot variantu transformāciju. Pilnīgs bijušaisamptīrā::variants Transformatora izmantošana programmatūras konfigurācijas pārvaldībai tiek piedāvāta ar “SCM Module” variantu pārvaldību ex.ample projekts. Šis bijušaisample projektu var instalēt pašreizējā darbvietā, izvēloties New->Example no Variantu projektu konteksta izvēlnes view un tad Examples->Variantu pārvaldība->SCM modulis.

Iesaiņojuma ieviešana

Iesaiņošanas programma ir atbildīga par a sinhronizācijas realizāciju file ar VCS repozitoriju (lokālo un/vai attālo). Varianta transformācijas laikā iesaiņotājs tiek izsaukts katram ps:scmfile ievades modeļu avota elements. Informācija par pašreizējo ps:scmfile avota elements, ti, tā atribūtu vērtības un transformācijas ievades un izvades direktorijas tiek nodotas iesaiņojumam, izmantojot vides mainīgos. Izmantojot šo informāciju, iesaiņotājs var izveidot piemērotu VCS klienta zvanu, lai sinhronizētu file tas tika aicināts.

Iesaiņotājam ir jāveic šādi uzdevumi

1. Sagatavojiet transformācijas izvades direktoriju. Piemēram, ja tā neeksistē, pārbaudiet fileTas var neizdoties atkarībā no tā, vai VCS klients sagaida, ka mērķa direktorijs ir vai nav.
2. Aprēķiniet avota atrašanās vietu file VCS repozitorijā un mērķa atrašanās vietu file transformācijas izvades direktorijā. Ja nepieciešams, aprēķiniet arī avota atrašanās vietu file vietējā darba direktorijā.
3. Zvaniet uz konkrēto VCS klientu.
   • Ja nepieciešams, iesaiņojumam ir arī jāsadarbojas ar lietotāju vai jāievieš funkcionalitāte, ko nenodrošina VCS klients. Piemēram, ja VCS klienta programma neieraksta mērķi file pats par sevi iesaiņojumam ir jāsaglabā izrakstīšanās file līdz aprēķinātajam mērķim file atrašanās vieta. Vai arī VCS nevarēja atbalstīt vietējos darba direktorijus. Šajā gadījumā iesaiņojuma programma, ja vēlas, varētu nodrošināt trūkstošo funkcionalitāti. Bet tas ir atkarīgs no iesaiņotā VCS klienta un var ievērojami atšķirties dažādām SCM sistēmām.

Vides mainīgie

Pirms VCS iesaiņojuma programmas izpildes tiek iestatīti šādi vides mainīgie.

• SCM_INPUTDIR: Ceļš uz transformācijas ievades direktoriju.
• SCM_OUTPUTDIR: Ceļš uz transformācijas izvades direktoriju.
• SCM_MODULE: Pašreizējā ps:scm atribūta “module” vērtībafile avota elements.
• SCM_DIR: Pašreizējā ps:scm atribūta "dir" vērtībafile avota elements.
• SCM_FILE: Vērtība 'filePašreizējā ps:scm atribūtsfile avota elements.
• SCM_SRCDIR: Pašreizējā ps:scm atribūta srcdir vērtībafile avota elements.
• SCM_SRCFILE: 'srcfilePašreizējā ps:scm atribūtsfile avota elements.
• SCM_BRANCH: Pašreizējā ps:scm atribūta "filiāle" vērtībafile avota elements.
• SCM_TAG: Vērtība 'tagPašreizējā ps:scm atribūtsfile avota elements.
• SCM_VERSION: Pašreizējā ps:scm atribūta “version” vērtībafile avota elements.
• SCM_DATE: Pašreizējā ps:scm atribūta “date” vērtībafile avota elements.
• SCM_REPOSITORY: Pašreizējā ps:scm atribūta "repozitorijs" vērtībafile avota elements.
• SCM_WORKINGDIR: Pašreizējā ps:scm atribūta “workingdir” vērtībafile avota elements.

Aprēķinot File Atrašanās vietas

Būtisks iesaiņojuma uzdevums ir pareizi aprēķināt avota un mērķa atrašanās vietas files. Mērķis files ir jāieraksta transformācijas izvades direktorijā. Ceļš uz šo direktoriju ir iestatīts mainīgajā SCM_OUTPUTDIR. Atrašanās vieta file izvades direktorijā tiek aprēķināts, pievienojot nosaukumu (mainīgais SCM_FILE) un direktoriju (mainīgais SCM_DIR). file šādi:

• SCM_OUTPUTDIR + + SCM_DIR + + SCM_FILE

Ceļa atdalītājs sistēmā Windows ir, piemēram, atpakaļvērstā slīpsvītra (piem., dir\file.txt) un slīpsvītra operētājsistēmā Linux (piemēram, dir/ file.txt). VCS atbalsta moduļiem (piemēram, CVS) var būt nepieciešams mērķa ceļā iekļaut moduļa nosaukumu (mainīgais SCM_MODULE), piemēram,

• SCM_OUTPUTDIR + + SCM_MODULE + + SCM_DIR + + SCM_FILE

Avota aprēķins file atrašanās vieta nedaudz atšķiras no mērķa aprēķina file atrašanās vietu, jo tai, iespējams, būs jāapsver pārskatīšanas informācija. Ja avota un mērķa nosaukums file ir identisks, un tādējādi SCM_SRCFILE un SRC_SRCDIR ir tukši, avota nosaukums file ir šāds.

• SCM_DIR + + SCM_FILE

Ja avota un mērķa nosaukums vai atrašanās vieta file ir atšķirīgs, SCM_SRCFILE resp. SCM_ vietā ir jāizmanto SCM_SRCDIRFILE resp. SCM_DIR. Piemēram, ja atšķiras direktorija daļa, tad avots file atrašanās vieta ir šāda.

• SCM_SRCDIR + + SCM_FILE

Ja ir norādīts lokālais darba direktorijs, pirms tam tiek pievienots ceļš uz darba direktoriju (mainīgais SCM_WORKINGDIR).

• SCM_WORKINGDIR + + SCM_DIR + + SCM_FILE

Atkarībā no VCS avotam ir jāpievieno informācija par versiju un moduļiem file ceļš. Lūdzu, skatiet konkrētā VCS dokumentāciju, lai uzzinātu, kā to izdarīt files VCS repozitorijā tiek risināti.

Example Iesaiņojuma programma

Sekojošā partija file ir bijušaisample iesaiņojums CVS VCS. Tā atbalsta informāciju par pārskatīšanu (datums, versija, tag, un filiāle) un moduļiem. Šis CVS ietvars neatbalsta vietējos darba direktorijus. Šis iesaiņojums ir daļa no “SCM Module” example projekts. Šis bijušaisample projektu var instalēt pašreizējā darbvietā, izvēloties New->Example no Variantu projektu konteksta izvēlnes view un tad Examples-> Variantu pārvaldība-> SCM modulis.

Katram ps:scmfile ievades modeļu avota elements veic izrakstīšanās darbību dotajā CVS repozitorijā file apraksta ps:scmfile avota elements. Šim nolūkam tas izmanto iepriekš uzskaitītos vides mainīgos, lai aprēķinātu avota atrašanās vietu un nosaukumu file CVS repozitorijā un mērķa atrašanās vietu un nosaukumu file vietējā repozitorijā. Tad tas izsauc CVS ​​klientu ar aprēķinātajiem argumentiem un uzraksta izrakstītu file uz mērķi file atrašanās vieta. Vispirms mainīgais klients tiek iestatīts uz pilnu CVS klienta programmas ceļu, kas vēlāk tiek izmantots skriptā, lai veiktu faktisko izrakstīšanās darbību.

• REM ceļš uz cvs klientu
• set client=”C:\Program Files\WinCvs 1.2\cvs.exe”

Nākamajā solī avota pārskatīšanas informācija file tiek savākts. Ja ir norādīts datums, šis datums tiek uzskatīts par pārskatīšanu. Citādi dotā versija, tag, vai tiek ņemta filiāle, pārbauda šādā secībā. Ja nevar noteikt pārskatīšanu, avota jaunākā versija file VCS repozitorijā tiks izņemts.

Nākamie koda bloki aprēķina visu ceļu uz avotu file kā aprakstīts iepriekš. Avota nosaukums file ir ņemts no mainīgā SCM_SRCFILE ja nav tukšs, pretējā gadījumā no mainīgā SCM_FILE. Direktorija daļa tiek ņemta no mainīgā SCM_SRCDIR, ja tā nav tukša, pretējā gadījumā no mainīgā SCM_DIR. Tā kā CVS sagaida slīpsvītras kā ceļa atdalītājus, visas slīpsvītras ceļā tiek aizstātas ar slīpsvītām. Pēc tam tiek izveidots pilns ceļš, izmantojot file nosaukums, direktorija daļa un, ja tāds ir, moduļa nosaukums, kas ņemts no mainīgā SCM_MODULE.

Pēc avota aprēķināšanas file ceļš nākamie koda bloki aprēķina visu ceļu uz mērķi file. Mērķa direktorija daļa file ceļš tiek ņemts no mainīgā SCM_DIR. Šeit slīpsvītras direktoriju daļā tiek aizstātas ar slīpsvītrām, jo ​​mērķis file atrodas vietējā file sistēma, izmantojot slīpsvītras kā ceļu atdalītājus. Kā aprakstīts iepriekš, mērķis file ir jāieraksta transformācijas izvades direktorijā. Izmantojot izvades direktoriju (mainīgais SCM_OUTPUTDIR), mērķa direktorija daļa file ceļš un mērķis file nosaukums (mainīgais SCM_FILE), pilns ceļš uz mērķi file ir uzbūvēts.

Lai varētu uzrakstīt mērķi file, ir jānodrošina, ka mērķa direktorijs pastāv. Tas tiek izveidots, ja tā nav.

• REM izveido mērķa direktoriju
• ja neeksistē “%targetdir%” mkdir “%targetdir%”

Pēc avota un mērķa aprēķināšanas file vietas un avota pārskatīšanu file lai pārbaudītu, pēdējais solis ir piezvanīt CVS klientam. CVS klients iegūst repozitorija atrašanās vietu, versiju un avotu file ceļu kā ievadi un ieraksta izrakstīto file uz stdout, kas tiek novirzīts uz mērķi file atrašanās vieta.

• REM zvanu cv klients
• %client% -d “%SCM_REPOSITORY%” co-n -p %revision% “%sourcefile%” > “%mērķisfile% ”

Autortiesības © 2003-2023 pure-systems GmbH

Dokumenti / Resursi

pure-systems pure::variants Versiju kontroles sistēmu savienotājs [pdfLietotāja rokasgrāmata tīri varianti, savienotājs versiju kontroles sistēmām, tīri varianti. savienotājs versiju kontroles sistēmām, tīri varianti savienotājs, savienotājs

Atsauces

• Lietotāja rokasgrāmata