pure-systems pure::variants Penyambung untuk Sistem Kawalan Versi

Maklumat Produk

The pure::variants Connector for Version Control Systems (VCS) ialah sambungan perisian yang dibangunkan oleh pure-systems GmbH. Ia direka untuk menyegerakkan tempatan files digunakan dalam transformasi varian dengan files daripada repositori Pengurusan Konfigurasi Perisian (SCM). Penyambung ini menyediakan modul transformasi generik yang menggunakan program pembalut khusus VCS untuk menyambung::varian tulen dengan klien VCS.

Adalah penting untuk ambil perhatian bahawa terdapat penyambung khas yang tersedia untuk sistem SCM yang popular seperti CVS dan Subversion, yang dikenali sebagai pure::variants Connector for CVS dan pure::variants Connector for Subversion. Manual pengguna ini menerangkan cara menggunakan penyambung dan menyediakan arahan untuk melaksanakan antara muka program khusus VCS. Ia juga termasuk bekasampsatu pembalut untuk CVS VCS. Versi boleh cetak dokumen ini tersedia.

Keperluan Perisian

• Penyambung untuk Sistem Kawalan Versi (VCS) ialah sambungan untuk varian tulen::dan serasi dengan semua platform yang disokong.

Sinopsis

• Penyambung::variants tulen untuk Sistem Kawalan Versi (VCS) digunakan untuk menyegerakkan setempat files digunakan dalam transformasi varian dengan files daripada repositori Pengurusan Konfigurasi Perisian.
• Sambungan ini menyediakan modul transformasi generik menggunakan program pembalut khusus VCS untuk menyambungkan::varian tulen dengan klien VCS.

Nota

• Untuk sistem SCM popular CVS dan Subversion penyambung khas tersedia, iaitu::varian tulen
• Penyambung untuk CVS dan tulen::variants Penyambung untuk Subversion.
• Dokumen ini menerangkan cara penyambung digunakan dan cara antara muka program khusus VCS perlu dilaksanakan. Selain itu ia menyediakan bekasampsatu pembalut untuk CVS VCS yang popular.
• Versi boleh cetak dokumen ini tersedia.

Keperluan Perisian

• Penyambung untuk Sistem Kawalan Versi (VCS) ialah sambungan untuk varian tulen::dan tersedia pada semua platform yang disokong.

Konsep

Tujuan penyambung ini adalah untuk menyegerak files dalam direktori output transformasi dengan sepadan files daripada repositori VCS tempatan atau jauh dengan cara berikut. diuruskan VCS files dimodelkan menggunakan ps: simfile unsur sumber. Jika dimodelkan sedemikian file belum lagi wujud dalam direktori output transformasi ia diperiksa dari repositori VCS. Jika repositori VCS tempatan (direktori kerja tempatan) diberikan, fail file pertama kali dicari di sana. Jika tidak file diperiksa keluar dari repositori VCS jauh.

Jika a file sudah wujud dalam direktori output transformasi ia disegerakkan dengan yang sepadan file dalam repositori VCS mengikut keadaan semakan dan perubahannya. Sekali lagi ia pertama kali dicari dalam direktori kerja tempatan jika diberikan. Untuk menyegerakkan files dengan pelbagai sistem SCM, penyambung menggunakan program pembalut khusus VCS untuk komunikasi sebenar dengan VCS. Pelaksana program pembalut ini bertanggungjawab untuk melaksanakan algoritma di atas. Ia adalah dalam budi bicara pelaksana fungsi yang disediakan oleh pembungkus dan apa yang oleh klien VCS. Jika misalnya VCS tertentu tidak menyokong direktori kerja tempatan, pelaksana program pembungkus boleh membina semula ini atau fungsi serupa dalam pembungkus.

Nota: Sila tanya pelaksana program pembalut jika beberapa fungsi hilang atau fungsi lain yang dilaksanakan oleh pembungkus dan VCS tertentu.

Keizinan Pelanggan

Penyambung bergantung pada kebenaran luaran klien VCS. Jika semasa proses penyegerakan, program klien VCS meminta nama pengguna dan/atau kata laluan secara interaktif, oleh itu adalah tidak mungkin untuk menggunakan penyambung VCS atau program pembalut perlu menyediakan fungsi untuk menghantar maklumat kebenaran yang diperlukan kepada klien VCS (jika pelanggan itu sendiri tidak menyediakan fungsi yang sepadan).

Nota: Sila tanya pelaksana program pembalut atau rujuk dokumentasi VCS untuk mendapatkan maklumat tentang cara memberikan maklumat kebenaran untuk klien VCS jika diperlukan.

Memasang Penyambung

• Sila rujuk bahagian “pure::variants Connectors” dalam pure::variants setup Guide untuk mendapatkan maklumat terperinci tentang cara memasang penyambung (menu Help -> Help Contents dan kemudian pure::variants Setup Guide -> pure::variants Connectors) .

Menggunakan Penyambung

Selepas memasang penyambung, modul transformasi baharu tersedia dipanggil "scmwrapper". Untuk melihat sama ada penyambung tersedia, buka sifat ruang konfigurasi dengan memilih Sifat daripada menu konteks ruang konfigurasi. Pada halaman Ruang Konfigurasi tukar kepada tab Konfigurasi Transformasi dan kemudian klik pada butang Tambah. Ini membuka dialog yang menunjukkan senarai modul transformasi yang tersedia. Ia mesti mengandungi modul "scmwrapper" seperti yang ditunjukkan dalam Rajah 2, "Modul Transformasi Tersedia".

Konfigurasi Penyambung

Seperti yang diterangkan di atas penyambung VCS menggunakan program pembungkus untuk yang sebenar file penyegerakan. Baris arahan untuk menggunakan program pembalut ini perlu dimasukkan pada halaman konfigurasi penyambung. Buka senarai modul transformasi yang tersedia seperti yang diterangkan pada permulaan bab ini. Pastikan kotak semak modul "scmwrapper" ditandakan. Kemudian klik pada butang Seterusnya untuk membuka halaman konfigurasi penyambung VCS (lihat Rajah 3, "Konfigurasi Penyambung VCS").

Modul "scmwrapper" mempunyai tepat satu parameter.

Program Pembungkus: Baris arahan untuk panggilan program pembalut. Program pembalut dilaksanakan untuk setiap ps:scmfile elemen sumber dalam model input. Maklumat mengenai ps:scm semasafile elemen sumber dihantar ke pembalut menggunakan pembolehubah persekitaran.

Untuk konfigurasi transformasi yang sah, direktori output transformasi perlu ditentukan. Ke dalam direktori ini files daripada repositori VCS ditulis. Direktori output dinyatakan pada halaman Input-Output dialog sifat ruang konfigurasi (lihat Rajah 4, "Direktori Output Transformasi"). Untuk maklumat lanjut tentang cara untuk menyediakan transformasi lihat bahagian "Halaman Konfigurasi Transformasi" dalam bab "5.3.7. Editor Ruang Konfigurasi” bagi::variants tulen Panduan Pengguna Eclipse Plugin.

ps:scmfile Elemen Sumber

VCS diuruskan files dimodelkan menggunakan ps:scmfile elemen sumber. Atribut elemen sumber ini disenaraikan di bawah. Atribut ini mewakili set biasa maklumat yang diperlukan oleh VCS untuk menyegerakkan a file. Untuk sistem SCM tertentu sesetengah atribut mungkin tidak bermakna atau mungkin mempunyai makna yang sedikit berbeza seperti sistem SCM yang lain. Oleh itu hanya atribut untuk menentukan lokasi repositori VCS dan nama serta laluan file untuk menyegerakkan adalah wajib.

Nota: Sila rujuk dokumentasi VCS atau tanya pelaksana program pembalut untuk makna khusus VCS bagi atribut ini.

• repositori: [Mandatori] Repositori VCS yang mengandungi file.
• pengarah: [Mandatori] Bahagian direktori VCS diuruskan file berbanding dengan modul VCS yang diberikan.
• file: [Wajib] Yang file namakan sebahagian daripada VCS yang diuruskan file.
• srcdir: [Pilihan] Bahagian direktori VCS diurus file berbanding modul yang diberikan. Untuk digunakan jika lokasi direktori sumber berbeza daripada lokasi direktori sasaran.
• srcfile: [Pilihan] The file sebahagian daripada VCS yang diuruskan file. Untuk digunakan jika sumber file nama berbeza dari sasaran file nama.
• jenis: [Pilihan] Jenis file mengikut atribut "jenis" ps:file unsur sumber.
• modul: [Pilihan] Nama modul dalam repositori VCS yang mengandungi file.
• cawangan: [Pilihan] Nama cawangan repositori VCS yang mengandungi file.
• tag: [Pilihan] The tag daripada VCS yang diuruskan file.
• versi: [Pilihan] Versi VCS terurus file.
• tarikh: [Pilihan] Tarikh yang menyatakan versi VCS yang diuruskan file.
• workingdir: [Pilihan] Direktori kerja tempatan yang mengandungi salinan tempatan files diuruskan dalam repositori VCS.

Untuk mencipta ps:scm baharufile elemen sumber pilih Baharu->SCM File daripada menu konteks unsur bahagian. Ini membuka SCM Baharu File wizard seperti yang ditunjukkan dalam Rajah 5, “SCM baharu File Ahli sihir”.

Selepas menyediakan transformasi dan model input, penyegerakan VCS yang dimodelkan files dimulakan dengan melakukan transformasi varian. Bekas lengkapamppenggunaan tulen::variants Transformer untuk Pengurusan Konfigurasi Perisian dipersembahkan oleh pengurusan varian "Modul SCM" exampprojek itu. bekas iniampprojek boleh dipasang di ruang kerja semasa dengan memilih Baharu->Cthample daripada menu konteks Projek Varian view dan kemudian Cthamples->Pengurusan Varian->Modul SCM.

Melaksanakan Pembungkus

Program pembalut bertanggungjawab untuk merealisasikan penyegerakan a file dengan repositori VCS (tempatan dan/atau jauh). Semasa transformasi varian, pembalut dipanggil untuk setiap ps:scmfile elemen sumber model input. Maklumat mengenai ps:scm semasafile elemen sumber, iaitu nilai atributnya, dan direktori input dan output transformasi dihantar ke pembalut menggunakan pembolehubah persekitaran. Dengan maklumat ini pembungkus boleh membina panggilan pelanggan VCS yang sesuai untuk menyegerakkan file ia dipanggil untuk.

Tugas berikut perlu dilakukan oleh pembungkus

1. Sediakan direktori output transformasi. Sebagai contoh jika ia tidak wujud, semak keluar files kepadanya mungkin gagal bergantung pada sama ada klien VCS menjangkakan direktori sasaran akan hadir atau tidak.
2. Kira lokasi sumber file dalam repositori VCS dan lokasi sasaran file dalam direktori output transformasi. Jika perlu juga mengira lokasi sumber file dalam direktori kerja tempatan.
3. Panggil klien VCS tertentu.
   • Jika perlu pembungkus juga perlu berinteraksi dengan pengguna atau perlu melaksanakan fungsi yang tidak disediakan oleh klien VCS. Contohnya jika program klien VCS tidak menulis sasaran file dengan sendirinya, pembungkus perlu menyimpan yang telah didaftar keluar file kepada sasaran yang dikira file lokasi. Atau VCS tidak dapat menyokong direktori kerja tempatan. Dalam kes ini, program pembalut boleh menyediakan fungsi yang hilang jika dikehendaki. Tetapi ini bergantung pada klien VCS yang dibungkus dan mungkin sangat berbeza untuk sistem SCM yang berbeza.

Pembolehubah Persekitaran

Pembolehubah persekitaran berikut ditetapkan sebelum program pembalut VCS dilaksanakan.

• SCM_INPUTDIR: Laluan ke direktori input transformasi.
• SCM_OUTPUTDIR: Laluan ke direktori output transformasi.
• SCM_MODULE: Nilai atribut 'modul' ps:scm semasafile unsur sumber.
• SCM_DIR: Nilai atribut 'dir' ps:scm semasafile unsur sumber.
• SCM_FILE: Nilai 'file' atribut ps:scm semasafile unsur sumber.
• SCM_SRCDIR: Nilai atribut 'srcdir' ps:scm semasafile unsur sumber.
• SCM_SRCFILE: Nilai 'srcfile' atribut ps:scm semasafile unsur sumber.
• SCM_BRANCH: Nilai atribut 'cawangan' ps:scm semasafile unsur sumber.
• SCM_TAG: Nilai 'tag' atribut ps:scm semasafile unsur sumber.
• SCM_VERSION: Nilai atribut 'versi' ps:scm semasafile unsur sumber.
• SCM_DATE: Nilai atribut 'tarikh' ps:scm semasafile unsur sumber.
• SCM_REPOSITORY: Nilai atribut 'repositori' ps:scm semasafile unsur sumber.
• SCM_WORKINGDIR: Nilai atribut 'workingdir' ps:scm semasafile unsur sumber.

Mengira File Lokasi

Tugas penting pembungkus ialah mengira lokasi sumber dan sasaran yang betul files. Sasaran files perlu ditulis ke direktori output transformasi. Laluan ke direktori ini ditetapkan dalam pembolehubah SCM_OUTPUTDIR. Lokasi yang file dalam direktori output dikira dengan menambahkan nama (pembolehubah SCM_FILE) dan direktori (pembolehubah SCM_DIR) bagi file seperti berikut:

• SCM_OUTPUTDIR + + SCM_DIR + + SCM_FILE

Pemisah laluan adalah sebagai contoh garis miring ke belakang pada Windows (cth dir\file.txt) dan garis miring pada Linux (cth dir/ file.txt). Untuk modul sokongan VCS (seperti CVS) mungkin perlu memasukkan nama modul (pembolehubah SCM_MODULE) dalam laluan sasaran, cth.

• SCM_OUTPUTDIR + + SCM_MODULE + + SCM_DIR + + SCM_FILE

Pengiraan sumber file lokasi berbeza sedikit daripada pengiraan sasaran file lokasi kerana ia mungkin perlu mempertimbangkan maklumat semakan. Jika nama sumber dan sasaran file adalah sama, dan dengan itu SCM_SRCFILE dan SRC_SRCDIR kosong, nama sumber file adalah seperti berikut.

• SCM_DIR + + SCM_FILE

Jika nama atau lokasi sumber dan sasaran file adalah berbeza, SCM_SRCFILE resp. SCM_SRCDIR perlu digunakan dan bukannya SCM_FILE resp. SCM_DIR. Cth jika bahagian direktori berbeza, maka sumbernya file lokasi adalah seperti berikut.

• SCM_SRCDIR + + SCM_FILE

Jika direktori kerja tempatan diberikan, maka laluan ke direktori kerja (pembolehubah SCM_WORKINGDIR) ditambah.

• SCM_WORKINGDIR + + SCM_DIR + + SCM_FILE

Bergantung pada VCS, maklumat semakan dan modul perlu ditambah pada sumber file laluan. Sila rujuk dokumentasi VCS khusus untuk mengetahui caranya files dalam repositori VCS ditangani.

ExampProgram Pembungkus

Kumpulan berikut file adalah bekasamppembungkus untuk CVS VCS. Ia menyokong maklumat semakan (tarikh, versi, tag, dan cawangan) dan modul. Direktori kerja tempatan tidak disokong oleh pembungkus CVS ini. Pembalut ini adalah sebahagian daripada "Modul SCM" cthampprojek itu. bekas iniampprojek boleh dipasang di ruang kerja semasa dengan memilih Baharu->Cthample daripada menu konteks Projek Varian view dan kemudian Cthamples-> Pengurusan Varian->Modul SCM.

Untuk setiap ps:scmfile elemen sumber model input yang menjalankan operasi pembayaran pada repositori CVS yang diberikan untuk file diterangkan oleh ps:scmfile unsur sumber. Untuk tujuan ini ia menggunakan pembolehubah persekitaran yang disenaraikan di atas untuk mengira lokasi dan nama sumber file dalam repositori CVS dan lokasi serta nama sasaran file dalam repositori tempatan. Kemudian ia memanggil klien CVS dengan hujah yang dikira dan menulis yang didaftar keluar file kepada sasaran file lokasi. Mula-mula klien pembolehubah ditetapkan kepada laluan penuh program klien CVS yang digunakan kemudian dalam skrip untuk melaksanakan operasi pembayaran sebenar.

• Laluan REM ke pelanggan cvs
• set client="C:\Program Files\WinCvs 1.2\cvs.exe”

Dalam langkah seterusnya maklumat semakan sumber file dikumpul. Jika tarikh diberikan, maka tarikh ini diambil sebagai semakan. Jika tidak versi yang diberikan, tag, atau cawangan diambil, ditandakan dalam susunan ini. Jika tiada semakan boleh ditentukan, semakan terbaru sumber file dalam repositori VCS akan diperiksa.

Blok kod seterusnya mengira laluan lengkap ke sumber file seperti yang diterangkan di atas. Nama sumber file diambil daripada pembolehubah SCM_SRCFILE jika tidak kosong, sebaliknya daripada pembolehubah SCM_FILE. Bahagian direktori diambil daripada pembolehubah SCM_SRCDIR jika tidak kosong, sebaliknya daripada pembolehubah SCM_DIR. Memandangkan CVS menjangkakan garis miring sebagai pemisah laluan, semua garis miring ke belakang dalam laluan digantikan dengan garis miring. Kemudian laluan lengkap dibina menggunakan file nama, bahagian direktori, dan, jika diberikan, nama modul diambil daripada pembolehubah SCM_MODULE.

Selepas mengira sumber file laluan blok kod seterusnya mengira laluan lengkap ke sasaran file. Bahagian direktori sasaran file laluan diambil daripada pembolehubah SCM_DIR. Di sini garis miring di bahagian direktori digantikan dengan garis miring ke belakang kerana sasaran file terletak di kawasan tempatan file sistem menggunakan garis miring ke belakang sebagai pemisah laluan. Seperti yang diterangkan di atas, sasaran file perlu ditulis ke direktori output transformasi. Menggunakan direktori output (pembolehubah SCM_OUTPUTDIR), bahagian direktori sasaran file laluan, dan sasaran file nama (pembolehubah SCM_FILE), laluan penuh ke sasaran file dibina.

Untuk dapat menulis sasaran file, ia perlu dipastikan bahawa direktori sasaran wujud. Ia dicipta jika ia tidak wujud.

• REM mencipta direktori sasaran
• jika tidak wujud “%targetdir%” mkdir “%targetdir%”

Selepas mengira sumber dan sasaran file lokasi dan semakan sumber file untuk menyemak, langkah terakhir ialah menghubungi pelanggan CVS. Pelanggan CVS mendapat lokasi repositori, semakan dan sumber file laluan sebagai input dan menulis yang didaftar keluar file ke stdout yang dihalakan semula ke sasaran file lokasi.

• Pelanggan cv panggilan REM
• %client% -d “%SCM_REPOSITORY%” co -n -p %revision% “%sourcefile%” > “%targetfile% ”

Hak Cipta © 2003-2023 pure-systems GmbH

Dokumen / Sumber

pure-systems pure::variants Penyambung untuk Sistem Kawalan Versi [pdf] Manual Pengguna varian tulen, Penyambung untuk Sistem Kawalan Versi, varian tulen Penyambung untuk Sistem Kawalan Versi, varian tulen Penyambung, Penyambung

Rujukan

• Manual Pengguna