pure::variants – Penyambung untuk
Manual Pengurusan Kod Sumber
Teknologi Parametrik GmbH
Versi 6.0.7.685 untuk pure::variants 6.0
Hak Cipta © 2003-2024 Parametric Technology GmbH
2024

pengenalan

pure::variants Penyambung untuk Pengurusan Kod Sumber (Penyambung) membolehkan pembangun mengurus kebolehubahan kod sumber menggunakan pure::variants. Pengurusan Kod Sumber bagi varian tulen:: menyediakan peluang yang fleksibel untuk menyegerakkan struktur direktori dan kod sumber files mudah dengan model tulen::variants. Dengan itu pengurusan varian boleh digunakan secara praktikal walaupun untuk projek perisian yang kompleks. Tambahan pula, sambungan antara ciri::variants tulen dan kod sumber boleh diuruskan dengan lebih mudah dengan pembina dan sangat boleh diakses melalui Pengurusan Kod Sumber.
1.1. Keperluan Perisian
Penyambung::variants tulen untuk Pengurusan Kod Sumber ialah lanjutan untuk varian tulen::varian dan tersedia pada semua platform yang disokong.
1.2. Pemasangan
Sila rujuk bahagian pure::variants Penyambung dalam Panduan Persediaan pure::variants untuk maklumat terperinci tentang cara memasang penyambung (menu Bantuan -> Kandungan Bantuan dan kemudian tulen::variants Panduan Persediaan -> pure::variants Penyambung).
1.3. Mengenai manual ini
Pembaca diharapkan mempunyai pengetahuan asas tentang dan pengalaman dengan::variants tulen. Sila rujuk bahan pengenalannya sebelum membaca manual ini. Manual ini tersedia dalam bantuan dalam talian serta dalam format PDF boleh cetak di sini.

Menggunakan Penyambung

2.1. Bermula tulen::variants
Bergantung pada kaedah pemasangan yang digunakan sama ada mulakan Pure::variants-enabled Eclipse atau di bawah Windows pilih item pure::variants daripada menu program.
Jika perspektif Pengurusan Varian belum diaktifkan, lakukan dengan memilihnya daripada Perspektif Terbuka->Lain... dalam menu Tetingkap.
2.2. Import Pokok Direktori ke dalam Model Keluarga
Sebelum mengimport pepohon direktori ke dalam Model Keluarga, projek varian perlu dibuat. Juga adalah digalakkan untuk mempunyai ciri yang ditakrifkan dalam Model Ciri sudah. Sila rujuk dokumentasi pure::variants untuk mendapatkan bantuan tentang langkah-langkah ini.
Import sebenar dimulakan dengan memilih tindakan Import… sama ada dalam menu konteks Projek view atau dengan Import… menu dalam File menu. Pilih Model atau Projek Varian daripada kategori Pengurusan Varian dan tekan Seterusnya. Pada halaman berikut pilih Import Model Keluarga daripada folder sumber dan tekan Seterusnya sekali lagi.
Pilih jenis kod sumber untuk diimport
Wizard import muncul (lihat Rajah 1, "Halaman wizard import untuk memilih jenis kod sumber yang mungkin diimport"). Pilih jenis projek untuk diimport dan tekan Seterusnya. Setiap jenis mengandungi set pratakrif file jenis untuk diimport ke model.
Rajah 1. Halaman wizard import untuk memilih jenis kod sumber yang mungkin diimportPilih Sumber dan Sasaran
Pada halaman wizard seterusnya (Rajah 2, "Halaman wizard import untuk memilih sumber dan sasaran untuk import") direktori sumber dan model sasaran mesti ditentukan.
Tekan butang Semak Imbas… untuk memilih direktori tempat kod sumber wujud yang harus diimport. Secara lalai, ruang kerja semasa dipilih kerana ini mungkin titik yang berguna untuk mula menavigasi.
Di bawah anda boleh menentukan sertakan dan tidak termasuk corak. Corak ini mestilah ungkapan biasa java. Setiap laluan input, berbanding dengan folder akar sumber, disemak dengan corak ini. Jika corak sertakan padan, folder akan diimport, jika corak kecualikan tidak sepadan. Bermaksud corak sertakan tidak memilih folder untuk diimport, corak kecualikan menyekat prapilihan ini.
Selepas memilih direktori kod sumber, model sasaran mesti ditentukan. Oleh itu pilih projek varian atau folder di mana model harus disimpan dan masukkan nama model. The file nama dilanjutkan secara automatik dengan sambungan .ccfm jika ia tidak diberikan dalam dialog ini. Secara lalai ia akan ditetapkan kepada nama yang sama dengan nama model itu sendiri. Ini adalah tetapan yang disyorkan.
Selepas folder sumber yang sesuai dan nama model yang diingini ditentukan, dialog mungkin selesai dengan menekan Selesai. Jika butang Seterusnya ditekan, halaman selanjutnya akan muncul di mana tetapan tambahan boleh dilakukan.
Rajah 2. Halaman wizard import untuk memilih sumber dan sasaran untuk importTukar Keutamaan Import
Pada halaman wizard terakhir (Rajah 3, “Halaman wizard import untuk menentukan konfigurasi individu”) terdapat pilihan yang boleh dilakukan untuk menyesuaikan gelagat import untuk projek perisian yang diimport.
Halaman dialog menunjukkan jadual di mana file jenis ditentukan, yang akan dipertimbangkan oleh proses import.
Setiap baris terdiri daripada empat medan.

• Medan Penerangan mengandungi teks deskriptif pendek untuk mengenal pasti file taip.
• The File medan corak nama digunakan untuk memilih files untuk diimport apabila ia sepadan dengan nilai medan. Medan menggunakan sintaks berikut:

1. Kes penggunaan yang paling biasa mungkin a file sambungan. Sintaks biasa ialah .EXT, di mana EXT adalah yang dikehendaki file sambungan (cth .java).
2. Satu lagi keadaan biasa adalah istimewa file, seperti buatanfile. Oleh itu, adalah mungkin untuk dipadankan dengan tepat file nama. Untuk melakukan ini, masukkan sahaja file namakan ke dalam medan (cth build.xml).
3. Dalam sesetengah kes, keinginan pemetaan adalah lebih khusus, begitu sahaja files yang sepadan dengan corak khas harus diimport. Untuk memenuhi keperluan ini adalah mungkin untuk menggunakan ungkapan biasa dalam File medan corak nama.
   Menghuraikan sintaks ungkapan biasa akan melebihi niat bantuan ini. Sila rujuk bahagian ungkapan biasa dalam bab rujukan dalam panduan pengguna tulen::variants (cth .*).

• Medan jenis elemen Mapped menetapkan pemetaan antara a file jenis dan tulen::variants jenis elemen keluarga. Jenis elemen keluarga ialah deskriptor untuk sumber file untuk memberikan maklumat lanjut kepada elemen yang dipetakan dalam model yang diimport. Pilihan biasa ialah ps:class atau ps:makefile.
• Yang Dipetakan file medan jenis menetapkan pemetaan antara a file jenis dan tulen::variants file taip. The file taip dalam pure::variants ialah deskriptor untuk sumber file untuk memberikan maklumat lanjut kepada elemen yang dipetakan dalam model yang diimport. Pilihan biasa adalah impl untuk pelaksanaan atau def untuk definisi files.

Rajah 3. Halaman wizard import untuk menentukan konfigurasi individubaru file jenis boleh ditambah dengan menggunakan butang Tambah Pemetaan. Semua medan diisi dengan nilai yang tidak ditentukan dan mesti diisi oleh pengguna. Untuk mengedit nilai dalam medan, cuma klik ke dalam medan dengan tetikus. Nilai menjadi boleh diedit dan boleh diubah. Ia tidak mungkin untuk menukar lalai file nama corak jadual. Untuk menjadikan penyesuaian fleksibel, anda boleh menyahpilih a file taip dengan menyahpilih baris. Dinyahpilih file corak nama kekal dalam konfigurasi tetapi tidak akan digunakan oleh pengimport. Ditakrifkan pengguna file jenis boleh dialih keluar semula dengan menggunakan butang Alih Keluar Pemetaan.
Secara lalai, Lain-lain files file corak nama tersedia dalam jadual tetapi dinyahpilih. Biasanya ia tidak mahu mengimport semua files tetapi ini boleh diubah dengan mudah dengan memilih baris mengikut.
Terdapat tiga pilihan import umum untuk menyesuaikan tingkah laku pengimport.

• Jangan import direktori tanpa padanan files (cth direktori CVS).
  Jika pengimport menemui direktori yang tiada padanan file berada di dalamnya dan di mana tiada subdirektori mempunyai padanan file, direktori tidak akan diimport. Ini selalunya berguna, jika projek diuruskan oleh sistem pengurusan versi seperti CVS. Untuk CVS, setiap direktori yang berkaitan mengandungi direktori CVS yang tidak berkaitan files disimpan. Jika pilihan ini dipilih dan CVS-files tidak sepadan dengan mana-mana file jenis yang ditakrifkan di atas, direktori tidak akan diimport sebagai komponen ke dalam Model Keluarga.
• Isih files dan direktori.
  Dayakan pilihan ini untuk mengisih files dan direktori setiap satu dalam susunan abjad.
• Pengendalian laluan import.
  Untuk penyegerakan selanjutnya pengimport perlu menyimpan laluan asal semua elemen yang diimport ke dalam model.
  Dalam kebanyakan kes, Model Keluarga dikongsi dengan pengguna lain. Struktur direktori mungkin berbeza untuk setiap pengguna. Untuk menyokong kebanyakan senario penggunaan biasa, pengimport boleh berfungsi dalam mod yang berbeza:

mutlak	Laluan mutlak ke elemen yang diimport akan disimpan ke dalam model. Untuk penyegerakan kemudian dan semasa transformasi files perlu diletakkan di lokasi yang sama seperti semasa import pertama.
Berbanding dengan Ruang Kerja	Laluan disimpan secara relatif kepada folder ruang kerja. Untuk penyegerakan files mesti menjadi sebahagian daripada ruang kerja Eclipse. Transformasi perlu menggunakan ruang kerja Eclipse sebagai direktori input.
Berkaitan dengan Projek	Laluan disimpan secara relatif kepada projek. Untuk penyegerakan files adalah sebahagian daripada projek di dalam Eclipse. Transformasi perlu menggunakan folder projek sebagai direktori input.
Berbanding dengan Path	Laluan disimpan relatif kepada laluan yang diberikan. Untuk penyegerakan files perlu diletakkan di lokasi yang sama. Direktori input transformasi adalah sama dengan laluan relatif semasa import.

Semua pilihan dialog ini disimpan secara berterusan. Penyesuaian peribadi tidak boleh dibuat semula setiap kali import dijalankan. Ini menjadikan aliran kerja import mudah dan pantas.
2.3. Mengemas kini Model daripada Pokok Direktori
Tekan butang Segerakkan untuk menyegerakkan model yang diimport dengan laluan direktorinya. Laluan akar projek disimpan dalam model supaya ia akan disegerakkan ke direktori yang sama seperti sebelumnya. Untuk mendayakan butang Segerak, buka model dan pilih mana-mana elemen. Selepas menekan butang Segerakkan Editor Bandingkan dibuka di mana Model Keluarga semasa dan model struktur direktori semasa bertentangan (lihat Rajah 4, "Kemas kini model daripada Pokok Direktori dalam Editor Bandingkan").
Rajah 4. Kemas kini model daripada Directory Tree dalam Compare Editor   Editor bandingkan digunakan di seluruh pure::variants untuk membandingkan versi model tetapi dalam kes ini digunakan untuk membandingkan struktur direktori fizikal (dipaparkan di sebelah kanan bawah) dengan model pure::variants semasa (sebelah kiri bawah). Semua perubahan disenaraikan sebagai item berasingan di bahagian atas editor, disusun mengikut elemen yang terjejas.
Memilih item dalam senarai ini menyerlahkan perubahan masing-masing dalam kedua-dua model. Dalam bekasampOleh itu, elemen tambahan ditandakan dengan kotak di sebelah kanan dan disambungkan dengan kedudukannya yang boleh dilaksanakan dalam model di sebelah kiri. Bar alat Gabung antara tetingkap editor atas dan bawah menyediakan alat untuk menyalin perubahan tunggal atau bahkan semua (tidak bercanggah) secara keseluruhan daripada model pepohon direktori kepada Model Ciri.
Nota
Penyegerakan dilakukan dengan tetapan pengimport yang terakhir digunakan. Ini memungkinkan untuk mengemas kini model dengan tetapan lain seperti yang dibuat semasa import dilakukan.

Menggunakan Pengindeks Perhubungan

Penyambung untuk Pengurusan Kod Sumber meningkatkan Perhubungan View dengan maklumat tentang hubungan antara elemen model tulen::varian dan kod sumber. Perhubungan ditambah untuk ciri yang digunakan dalam keadaan elemen ps:condxml dan ps:condtext.
Untuk ps:flag dan ps:flagfile elemen lokasi pemalar prapemproses dalam sumber C/C++ files ditunjukkan. Selain itu, lokasi pemalar prapemproses yang sepadan ditunjukkan untuk ciri yang dipilih dengan menggunakan pemetaan antara nama unik ciri dan pemalar prapemproses.
3.1. Menambah Pengindeks Perhubungan pada Projek
Pengindeks hubungan boleh diaktifkan pada halaman harta projek khas. Pilih projek dan pilih item Properties dalam menu konteks. Dalam dialog akan datang pilih halaman Pengindeks Perhubungan.
Rajah 5. Halaman Harta Projek untuk Pengindeks Perhubungan

Pengindeks hubungan diaktifkan untuk projek dengan memilih pilihan Dayakan Pengindeks Perhubungan (1). Selepas mendayakan pengindeks terdapat beberapa lagi pilihan untuk menentukan tingkah laku khusus projek. Pengindeksan tulen::variants Syarat dan Pemalar Prapemproses C/C++ boleh diaktifkan secara berasingan (2). Senarai dengan file corak nama (3) digunakan untuk memilih files untuk pengindeksan. Sahaja files yang sepadan dengan salah satu corak diimbas. Tambahkan "*" sebagai corak untuk mengimbas semua files sesuatu projek.
Selepas mengaktifkan pengindeks untuk projek, pembina ditambahkan pada projek. Imbasan pembina ini berubah files untuk hubungan baharu dengan unsur model tulen::varian secara automatik.
3.2. Hubungan dengan Kod Sumber
Dengan pengindeks hubungan diaktifkan, Relations View mengandungi entri tambahan. Entri ini menunjukkan nama file dan nombor baris bagi titik varian. Petua alat menunjukkan bahagian yang sesuai bagi file. Dengan mengklik dua kali pada entri file akan dibuka menjadi editor.
pure::variants Syarat
Syarat::variants tulen boleh digunakan untuk memasukkan atau mengecualikan bahagian a file bergantung pada pemilihan ciri. Pengindeks Keadaan mengimbas peraturan sedemikian dan mengekstrak ciri yang dirujuk. Jika ciri sedemikian dipilih dalam editor Perhubungan View akan menunjukkan semua files dan baris di mana keadaan dengan ciri yang dipilih terletak (lihat Rajah 6, “Perwakilan Keadaan dalam Perhubungan View”).
Rajah 6. Perwakilan Keadaan dalam Perhubungan ViewUntuk mendapatkan penjelasan terperinci tentang cara mentakrifkan syarat, rujuk bahagian ps:condtext bab 9.5.7 pure::variants Panduan Pengguna (Rujukan–>Jenis Elemen Sumber Dipratentukan–>ps:condtext).
Pemalar Prapemproses C/C++
Pengindeks Prapemproses C/C++ mengimbas files untuk pemalar yang digunakan dalam peraturan prapemproses (cth #ifdef, #ifndef, …).
Jika ps:flag atau ps:flagfile elemen dipilih Perhubungan View menunjukkan penggunaan pemalar prapemproses yang ditentukan.
Perhubungan View juga menunjukkan pemalar prapemproses yang disambungkan kepada ciri dengan menggunakan corak pemetaan. Untuk ini corak dikembangkan dengan data ciri yang dipilih. Simbol yang terhasil digunakan untuk mencari pemalar prapemproses yang sepadan. Rajah 7, “Perwakilan Pemalar Prapemproses C/C++ dalam Perhubungan View” menunjukkan bekasample dengan kemasyhuran corak{Name}. Corak ini dikembangkan dengan nama unik ciri kepada fameNative. Dalam kod diindeks terdapat 76 lokasi di mana fameNative malar prapemproses digunakan.
Lokasi ini ditunjukkan dalam Perhubungan View. Corak boleh ditakrifkan dalam pilihan (lihat Bahagian 3.3, "Keutamaan").
Rajah 7. Perwakilan Pemalar Prapemproses C/C++ dalam Perhubungan View

3.3. Keutamaan
Untuk menukar tingkah laku lalai pengindeks buka keutamaan Eclipse dan pilih halaman Pengindeks Perhubungan dalam kategori Pengurusan Varian. Halaman menunjukkan dua senarai.
Rajah 8. Halaman Keutamaan Pengindeks PerhubunganSenarai atas mengandungi lalai file corak untuk pengindeks (1). Senarai ini ialah tetapan corak awal untuk projek yang baru didayakan.
Senarai bawah mengandungi pemetaan antara ciri dan pemalar prapemproses (2). Pemetaan ini digunakan untuk semua projek. Jadual 1, "Penggantian Pemetaan yang Disokong" menunjukkan semua penggantian yang mungkin.
Jadual 1. Penggantian Pemetaan yang Disokong

Kad bebas	Penerangan	Example: CiriA
Nama	Nama Unik bagi ciri yang dipilih	FLAG_{Nama} – FLAG_FeatureA
NAMA	huruf besar Nama Unik bagi ciri yang dipilih	FLAG_{NAME} – FLAG_FEATUREA
nama	huruf kecil Nama Unik bagi ciri yang dipilih	flag_{name} – flag_featurea

Dokumen / Sumber

pure-systems 2024 Connector untuk Perisian Pengurusan Kod Sumber [pdf] Manual Pengguna 2024, 2024 Penyambung untuk Perisian Pengurusan Kod Sumber, Penyambung untuk Perisian Pengurusan Kod Sumber, Perisian Pengurusan Kod Sumber, Perisian Pengurusan, Perisian

Rujukan

• Manual Pengguna