murni :: varian - Konektor kanggo
Manual Manajemen Kode Sumber
Parametric Technology GmbH
Versi 6.0.7.685 kanggo murni :: varian 6.0
Hak cipta © 2003-2024 Parametric Technology GmbH
2024

Pambuka

murni :: varian Konektor kanggo Manajemen Kode Sumber (Connector) mbisakake pangembang kanggo ngatur variabilitas kode sumber nggunakake murni :: varian. Manajemen Kode Sumber saka varian murni:: menehi kesempatan fleksibel kanggo nyinkronake struktur direktori lan kode sumber files gampang karo murni:: model varian. Mangkono, manajemen varian bisa ditrapake malah kanggo proyek piranti lunak sing rumit. Salajengipun sambungan antarane murni:: fitur varian lan kode sumber bisa ngatur luwih gampang karo tukang lan banget diakses liwat Manajemen Kode Sumber.
1.1. Requirements Piranti Lunak
Konektor murni :: varian kanggo Manajemen Kode Sumber minangka extension kanggo varian murni:: lan kasedhiya ing kabeh platform sing didhukung.
1.2. Instalasi
Mangga takon bagean murni :: varian Konektor ing murni :: varians Guide Setup kanggo informasi rinci babagan carane nginstal konektor (menu Pitulung -> Isi Pitulung lan banjur murni :: varian Setup Guide -> murni :: varian Konektor).
1.3. Babagan manual iki
Sing maca samesthine duwe kawruh dhasar babagan lan pengalaman karo murni:: varian. Mangga takon materi pambuka sadurunge maca manual iki. Manual kasedhiya ing bantuan online uga ing format PDF bisa dicithak kene.

Nggunakake Konektor

2.1. Miwiti murni:: varian
Gumantung ing cara instalasi sing digunakake, miwiti Eclipse murni:: varian-enabled utawa ing Windows pilih item murni:: varian saka menu program.
Yen perspektif Manajemen Varian durung diaktifake, tindakake kanthi milih saka Open Perspective-> Other… ing menu Window.
2.2. Ngimpor Wit Direktori menyang Model Kulawarga
Sadurunge ngimpor wit direktori menyang Model Keluarga, proyek varian kudu digawe. Iku uga sugestif kanggo duwe fitur ditetepake ing Model Fitur wis. Mangga deleng dokumentasi murni:: varian kanggo bantuan babagan langkah-langkah iki.
Impor nyata diwiwiti kanthi milih Impor… tumindak ing menu konteks Proyek view utawa nganggo menu Import… ing File menu. Pilih Model Varian utawa Proyek saka kategori Manajemen Varian banjur pencet Sabanjure. Ing kaca ing ngisor iki pilih Impor Model Kulawarga saka folder sumber banjur pencet Sabanjure maneh.
Pilih jinis kode sumber sing arep diimpor
Wisaya impor katon (pirsani Gambar 1, "Kaca saka tuntunan impor kanggo milih jinis kode sumber sing bisa diimpor"). Pilih jinis proyek sing arep diimpor banjur pencet Sabanjure. Saben jinis ngemot set sing wis ditemtokake file jinis kanggo ngimpor kanggo model.
Gambar 1. Kaca tuntunan impor kanggo milih jinis kode sumber sing bisa diimporPilih Sumber lan Target
Ing kaca tuntunan sabanjure (Gambar 2, "Kaca saka tuntunan impor kanggo milih sumber lan target kanggo ngimpor") direktori sumber lan model target kudu ditemtokake.
Pencet tombol Telusuri… kanggo milih direktori ing ngendi kode sumber ana sing kudu diimpor. Kanthi gawan, ruang kerja saiki dipilih amarga iki bisa dadi titik sing migunani kanggo miwiti navigasi.
Ing ngisor iki sampeyan bisa nemtokake pola kalebu lan ora kalebu. Pola kasebut kudu ekspresi reguler Jawa. Saben path input, relatif marang folder root sumber, dicenthang nganggo pola kasebut. Yen kalebu pola sing cocog, folder bakal diimpor, yen ora kalebu pola ora cocog. Tegese pola kalebu wis milih folder sing arep diimpor, pola ora kalebu mbatesi preseleksi iki.
Sawise milih direktori kode sumber model target kudu ditetepake. Mulane pilih proyek varian utawa folder ing ngendi model kudu disimpen lan ketik jeneng model. Ing file jeneng lengkap kanthi otomatis karo extension .ccfm yen ora diwenehi ing dialog iki. Kanthi gawan bakal disetel jeneng sing padha karo jeneng model dhewe. Iki minangka setelan sing disaranake.
Sawise folder sumber sing migunani lan jeneng model sing dikarepake ditemtokake, dialog bisa rampung kanthi mencet Rampung. Yen tombol Sabanjure dipencet, kaca luwih bakal teka ing ngendi setelan tambahan bisa ditindakake.
Gambar 2. Kaca tuntunan impor kanggo milih sumber lan target kanggo ngimporNgganti Preferensi Impor
Ing kaca tuntunan pungkasan (Gambar 3, "Kaca saka tuntunan impor kanggo nemtokake konfigurasi individu”) ana pilihan sing bisa ditindakake kanggo ngatur prilaku impor kanggo proyek piranti lunak sing diimpor.
Kaca dialog nuduhake tabel ing ngendi file jinis ditetepake, sing bakal dianggep dening proses ngimpor.
Saben baris dumadi saka papat lapangan.

• Kolom Deskripsi ngemot teks deskriptif singkat kanggo ngenali file jinis.
• Ing File kolom pola jeneng digunakake kanggo milih files kanggo diimpor nalika padha cocog karo Nilai kothak. Lapangan nggunakake sintaks ing ngisor iki:

1. Kasus panggunaan sing paling umum yaiku a file ekstensi. Sintaks sing biasa yaiku .EXT, ing ngendi EXT sing dikarepake file ekstensi (eg .java).
2. Kahanan umum liyane yaiku khusus file, kaya gaweanfile. Mulane, iku bisa kanggo cocog ing pas file jeneng. Kanggo nindakake iki, mung ketik ing file jeneng menyang lapangan (eg build.xml).
3. Ing sawetara kasus, kepinginan pemetaan luwih spesifik, dadi mung files sing cocog karo pola khusus kudu diimpor. Kanggo pas karo syarat iki bisa nggunakake ekspresi biasa ing File kolom pola jeneng.
   Nggambarake sintaks ekspresi reguler bakal ngluwihi tujuan bantuan iki. Mangga deleng bagean ekspresi reguler saka bab referensi ing:: varians guide pangguna murni (contone .*).

• Kolom jinis unsur Mapped nyetel pemetaan antarane a file jinis lan murni :: varian jinis unsur kulawarga. Jinis unsur kulawarga minangka deskriptor kanggo sumber file kanggo nyedhiyakake informasi luwih lengkap menyang unsur sing dipetakan ing model sing diimpor. Pilihan sing khas yaiku ps:class utawa ps:makefile.
• The Maped file kolom jinis nyetel pemetaan antarane a file jinis lan murni :: varian file jinis. Ing file ketik murni :: varian minangka deskriptor kanggo sumber file kanggo nyedhiyakake informasi luwih lengkap menyang unsur sing dipetakan ing model sing diimpor. Pilihan umum yaiku impl kanggo implementasi utawa def kanggo definisi files.

Gambar 3. Kaca tuntunan ngimpor kanggo nemtokake konfigurasi individuAnyar file jinis bisa ditambahake kanthi nggunakake tombol Tambah Pemetaan. Kabeh kolom diisi karo nilai sing ora ditemtokake lan kudu diisi dening pangguna. Kanggo ngowahi nilai ing lapangan, mung klik menyang lapangan nganggo mouse. Nilai dadi bisa diowahi lan bisa diganti. Ora bisa ngganti standar file pola jeneng tabel. Kanggo nggawe pangaturan dhewe fleksibel, iku bisa kanggo mbusak pilihan a file ngetik kanthi mbatalake baris. Dibuwang file pola jeneng tetep ing konfigurasi nanging ora bakal digunakake dening importir. Pangguna ditetepake file jinis bisa dibusak maneh kanthi nggunakake tombol Copot Pemetaan.
Kanthi gawan liyane files file pola jeneng kasedhiya ing tabel nanging ora dipilih. Biasane ora pengin ngimpor kabeh files nanging iki bisa gampang diganti kanthi milih baris miturut.
Ana telung opsi impor umum kanggo ngatur prilaku importir.

• Aja ngimpor direktori tanpa cocog files (contone, direktori CVS).
  Yen importir nemokake direktori sing ora cocog file ana ing kono lan ora ana subdirektori sing cocog file, direktori ora bakal diimpor. Iki asring migunani, yen proyek dikelola dening sistem manajemen versi kaya CVS. Kanggo CVS, saben direktori cocog ngemot CVS-direktori ngendi ora salaras files disimpen. Yen pilihan iki dipilih lan CVS-files ora cocog karo sembarang file jinis sing ditetepake ing ndhuwur, direktori ora bakal diimpor minangka komponen menyang Model Keluarga.
• Urut files lan direktori.
  Aktifake pilihan iki kanggo ngurutake files lan direktori saben ing urutan abjad.
• Impor dalan penanganan.
  Kanggo sinkronisasi luwih importir kudu nyimpen path asli kabeh unsur diimpor menyang model.
  Ing akeh kasus, Model Keluarga dienggo bareng karo pangguna liyane. Struktur direktori bisa uga beda kanggo saben pangguna. Kanggo ndhukung skenario panggunaan sing paling umum, importir bisa digunakake ing macem-macem mode:

Absolute	Path mutlak menyang unsur sing diimpor bakal disimpen ing model kasebut. Kanggo sinkronisasi mengko lan sak transformasi ing files kudu diselehake ing lokasi persis padha nalika ngimpor pisanan.
Relatif kanggo Workspace	Path disimpen relatif menyang folder workspace. Kanggo sinkronisasi files kudu dadi bagean saka ruang kerja Eclipse. Transformasi kudu nggunakake ruang kerja Eclipse minangka direktori input.
Relatif kanggo Proyek	Path disimpen relatif kanggo project. Kanggo sinkronisasi files iku bagéan saka project nang Eclipse. Transformasi kudu nggunakake folder proyek minangka direktori input.
Relatif kanggo Path	Paths disimpen relatif kanggo path diwenehi. Kanggo sinkronisasi files kudu diselehake ing lokasi persis padha. Direktori input transformasi padha karo path relatif nalika ngimpor.

Kabeh pilihan dialog iki disimpen terus-terusan. Kustomisasi pribadhi ora kudu dibaleni maneh saben impor mlaku. Iki nggawe alur kerja impor gampang lan cepet.
2.3. Nganyari Model saka Directory Tree
Pencet tombol Sinkronisasi kanggo nyinkronake model sing diimpor karo path direktori. Path ROOT proyek disimpen ing model supaya bakal nyinkronake menyang direktori sing padha kaya sadurunge. Kanggo ngaktifake tombol Sinkronisasi, bukak model banjur pilih unsur apa wae. Sawise menet tombol Sinkronisasi mbukak Compare Editor ing ngendi Model Keluarga saiki lan model struktur direktori saiki dilawan (pirsani Figure 4, "Update model saka Wit Direktori ing Compare Editor").
Gambar 4. Nganyari model saka Directory Tree ing Compare Editor   Editor mbandhingake digunakake ing saindhenging varian murni:: kanggo mbandhingake versi model nanging ing kasus iki digunakake kanggo mbandhingake struktur direktori fisik (ditampilake ing sisih tengen ngisor) karo model murni:: varian saiki (sisih kiwa ngisor). Kabeh owah-owahan didhaptar minangka item kapisah ing sisih ndhuwur editor, diurutake dening unsur sing kena pengaruh.
Milih item ing dhaptar iki nyorot owah-owahan sing gegandhengan ing loro model kasebut. Ing mantanample, unsur ditambahaké ditandhani karo kothak ing sisih tengen lan disambungake karo posisi layak ing model ing sisih kiwa. Toolbar Gabung antarane jendhela editor ndhuwur lan ngisor nyedhiyakake alat kanggo nyalin siji utawa malah kabeh owah-owahan (ora konflik) sakabèhé saka model wit direktori menyang Model Fitur.
Cathetan
Sinkronisasi wis rampung karo setelan importir pungkasan digunakake. Iki ndadekake iku bisa kanggo nganyari model karo setelan liyane minangka digawe nalika ngimpor wis rampung.

Nggunakake Relation Indexer

Konektor kanggo Manajemen Kode Sumber nambah Hubungan View karo informasi bab sambungan antarane murni :: varian unsur model lan kode sumber. Hubungan ditambahake kanggo fitur sing digunakake ing kondisi unsur ps:condxml lan ps:condtext.
Kanggo ps:flag lan ps:flagfile unsur lokasi konstanta preprocessor ing sumber C / C ++ files ditampilake. Kajaba iku, lokasi sing cocog karo konstanta preprocessor ditampilake kanggo fitur sing dipilih kanthi nggunakake pemetaan antarane fitur jeneng unik lan konstanta preprocessor.
3.1. Nambahake Relation Indexer menyang Proyek
Indekser hubungan bisa diaktifake ing kaca properti proyek khusus. Pilih proyek lan pilih item Properti ing menu konteks. Ing dialog sing bakal teka, pilih kaca Relation Indexer.
Gambar 5. Kaca Properti Proyek kanggo Relation Indexer

Indexer hubungan diaktifake kanggo proyek kanthi milih opsi Aktifake Relation Indexer (1). Sawise ngaktifake indeksasi ana sawetara opsi liyane kanggo nemtokake prilaku tartamtu proyek. Pengindeksan saka murni:: varian Kondisi lan Konstanta Preprocessor C / C ++ bisa diaktifake kanthi kapisah (2). Dhaptar karo file pola jeneng (3) digunakake kanggo milih ing files kanggo indeksasi. mung files sing cocog karo salah sawijining pola sing dipindai. Tambah "*" minangka pola kanggo mindhai kabeh files saka proyek.
Sawise ngaktifake indeksasi kanggo proyek, tukang bangunan ditambahake menyang proyek kasebut. Pambangun iki mindai diganti files kanggo hubungan anyar kanggo murni:: varian unsur model otomatis.
3.2. Hubungane karo Kode Sumber
Kanthi indekser hubungan sing diaktifake Relations View ngandhut entri tambahan. Entri iki nuduhake jeneng saka file lan nomer baris saka titik varian. Tip alat nuduhake bagean cocok saka file. Kanthi ngeklik kaping pindho entri ing file bakal dibukak dadi editor.
murni:: varian Kahanan
Kondisi murni:: varian bisa digunakake kanggo nyakup utawa ngilangi bagean a file gumantung saka pilihan fitur. Pengindeks Kondisi mindai aturan kasebut lan ngekstrak fitur sing dirujuk. Yen fitur kasebut dipilih ing editor Relations View bakal nuduhake kabeh files lan garis ing ngendi kondisi karo fitur sing dipilih dumunung (pirsani Gambar 6, "Representasi Kondisi ing Hubungan View”).
Gambar 6. Representasi Kawontenan ing Sesambetan ViewKanggo entuk katrangan rinci babagan carane nemtokake kahanan, deleng bagean ps:kondteks bab 9.5.7 saka::varian murni Pandhuan pangguna (Referensi–>Jenis Unsur Sumber sing wis ditemtokake->ps:kondteks).
Konstanta C/C++ Preprocessor
C/C++ Preprocessor Indexer scan files kanggo konstanta sing digunakake ing aturan preprocessor (contone #ifdef, #ifndef, ...).
Yen ps:flag utawa ps:flagfile unsur sing dipilih Relations View nuduhake panggunaan konstanta preprocessor sing ditemtokake.
Hubungane View uga nuduhake konstanta preprocessor sing disambungake menyang fitur kanthi nggunakake pola pemetaan. Kanggo iki pola ditambahi karo data fitur sing dipilih. Simbol sing diasilake digunakake kanggo nggoleki konstanta preprocessor sing cocog. Gambar 7, "Representasi Konstanta Preprocessor C/C++ ing Relations View” nuduhake mantanample karo ketenaran pola {Jeneng}. Pola kasebut ditambahi kanthi jeneng unik fitur kasebut dadi fameNative. Ing kode sing diindeks ana 76 lokasi ing ngendi fameNative konstan preprocessor digunakake.
Lokasi iki ditampilake ing Relations View. Pola bisa ditetepake ing preferensi (pirsani Bagean 3.3, "Preferensi").
Gambar 7. Representasi Konstanta C/C++ Preprocessor ing Relations View

3.3. Preferensi
Kanggo ngganti prilaku standar indeksasi, bukak preferensi Eclipse banjur pilih kaca Relation Indexer ing kategori Manajemen Varian. Kaca kasebut nuduhake rong dhaptar.
Gambar 8. Kaca Preferensi Pengindeks RelasiDhaptar ndhuwur ngemot standar file pola kanggo indeks (1). Dhaptar iki minangka setelan pola awal kanggo proyek sing mentas diaktifake.
Dhaptar ngisor ngemot pemetaan antarane fitur lan konstanta preprocessor (2). Pemetaan iki digunakake kanggo kabeh proyek. Tabel 1, "Pengganti Pemetaan sing Didhukung" nuduhake kabeh panggantos sing bisa ditindakake.
Tabel 1. Didhukung Mapping Panggantos

Wildcard	Katrangan	Example: FiturA
jeneng	Jeneng Unik saka fitur sing dipilih	FLAG_{Jeneng} – FLAG_FeatureA
NAMA	huruf gedhe Jeneng Unik saka fitur sing dipilih	FLAG_{NAME} – FLAG_FEATUREA
jeneng	huruf cilik Jeneng Unik saka fitur sing dipilih	flag_ {jeneng} - flag_featurea

Dokumen / Sumber Daya

pure-sistem 2024 Konektor kanggo Software Manajemen Kode Sumber [pdf] Manual pangguna 2024, 2024 Konektor kanggo Piranti Lunak Manajemen Kode Sumber, Konektor kanggo Perangkat Lunak Manajemen Kode Sumber, Perangkat Lunak Manajemen Kode Sumber, Piranti Lunak Manajemen, Piranti Lunak

Referensi

• Manual pangguna