pure::variants – Konektilo por
Manlibro pri Administrado de Fontkodo
Parametric Technology GmbH
Versio 6.0.7.685 por pure::variants 6.0
Kopirajto © 2003-2024 Parametric Technology GmbH
2024

Enkonduko

pure::variants Konektilo por Fontkoda Administrado (Konektilo) ebligas al programistoj administri fontkodŝanĝeblecon uzante pure::variants. La Fontkoda Administrado de pure::variantoj disponigas flekseblan ŝancon sinkronigi dosierujojn kaj fontkodon files facile kun pure::variants modeloj. Tiel administrado de variantoj povas aplikiĝi farebla eĉ al kompleksaj programaj projektoj. Krome, ligoj inter puraj::variantaĵoj kaj fontkodo povas esti administritaj pli facile kun la konstruanto kaj estas tre alireblaj per la Fontkoda Administrado.
1.1. Programaraj Postuloj
La pura::variants Konektilo por Fontkoda Administrado estas etendaĵo por pure::variants kaj disponeblas sur ĉiuj subtenataj platformoj.
1.2. Instalado
Bonvolu konsulti sekcion pure::variants Konektiloj en la pure::variants Agorda Gvidilo por detalaj informoj pri kiel instali la konektilon (menuo Helpo -> Helpo Enhavo kaj poste pure::variants Agorda Gvidilo -> pure::variants Konektiloj).
1.3. Pri ĉi tiu manlibro
Oni atendas, ke la leganto havos bazajn konojn kaj spertojn pri puraj::variaĵoj. Bonvolu konsulti ĝian enkondukan materialon antaŭ legi ĉi tiun manlibron. La manlibro haveblas en reta helpo kaj ankaŭ en printebla PDF-formato ĉi tie.

Uzante Konektilon

2.1. Komencante pure::variantoj
Depende de la instal-metodo uzata aŭ lanĉu la pure::variants-ebligitan Eklipso aŭ sub Vindozo elektu la pure::variants eron el la programmenuo.
Se la perspektivo pri Varianta Administrado ne estas jam aktivigita, faru tion elektante ĝin el Malferma Perspektivo->Alia... en la Fenestra menuo.
2.2. Importu Dosierujon en Familian Modelon
Antaŭ importi dosierujon en Familian Modelon, oni devas krei variantan projekton. Ankaŭ estas sugeste havi funkciojn jam difinitajn en Karakterizaĵa Modelo. Bonvolu konsulti la pure::variants dokumentaron por helpo pri ĉi tiuj paŝoj.
La efektiva importo komenciĝas elektante la agon Importi... ĉu en la kunteksta menuo de la Projektoj view aŭ kun Importi... menuo en la File menuo. Elektu Variajn Modelojn aŭ Projektojn el kategorio Varianta Administrado kaj premu Sekvan. Sur la sekva paĝo elektu Importi Familian Modelon el fontaj dosierujoj kaj premu Sekvan denove.
Elektu tipon de fontkodo por importi
La importa sorĉisto aperas (vidu Figuro 1, "Paĝo de la importa sorĉisto por elekti la tipon de fontkodo kiu povas esti importita"). Elektu projekt-specon por importi kaj premu Sekvan. Ĉiu tipo enhavas antaŭdifinitan aron de file tipoj por importi al la modelo.
Figuro 1. Paĝo de la importa sorĉisto por elekti la tipon de fontkodo kiu povas esti importitaElektu Fonton kaj Celon
Sur la sekva paĝo de sorĉisto (Figuro 2, "Paĝo de la importa sorĉisto por elekti la fonton kaj la celon por la importo") la fonta dosierujo kaj la celmodelo devas esti specifitaj.
Premu la butonon Folumi... por elekti la dosierujon, kie ekzistas la fontkodo, kiu devus esti importita. Defaŭlte la nuna laborspaco estas elektita ĉar ĉi tio povus esti utila punkto por komenci navigi.
Malsupre vi povas specifi inkluzivi kaj ekskludi ŝablonon. Ĉi tiuj ŝablonoj devas esti java regulaj esprimoj. Ĉiu eniga vojo, rilate al la fonta radika dosierujo, estas kontrolita per ĉi tiu ŝablono. Se la inkluziva ŝablono kongruas, dosierujo estas importita, se la ekskluziva ŝablono ne kongruas. Tio signifas, ke la inkluziva ŝablono antaŭelektas la dosierujojn por importi, la ekskluziva ŝablono limigas ĉi tiun preselekton.
Post elekto de la fontkoda dosierujo, celmodelo devas esti difinita. Tial elektu variantan projekton aŭ dosierujon, kie la modelo estu konservita kaj enigu modelnomon. La file nomo estas etendita aŭtomate kun la etendo .ccfm se ĝi ne estas donita en ĉi tiu dialogo. Defaŭlte ĝi estos agordita al la sama nomo kiel la modelnomo mem. Ĉi tiu estas la rekomendinda agordo.
Post kiam oportuna fonta dosierujo kaj la dezirata modelnomo estas specifitaj, la dialogo povas esti finita premante Fini. Se la Sekva butono estas premata, plia paĝo aperos, kie pliaj agordoj povas esti faritaj.
Figuro 2. Paĝo de la importa sorĉisto por elekti la fonton kaj la celon por la importoŜanĝi Importo-Preferojn
Sur la lasta paĝo de sorĉisto (Figuro 3, "Paĝo de la importa sorĉisto por difini individuan agordon”) estas preferoj, kiuj povas esti faritaj por personecigi la importkonduton por la importita programara projekto.
La dialogpaĝo montras tabelon kie la file tipoj estas difinitaj, kiuj estos konsiderataj de la importa procezo.
Ĉiu linio konsistas el kvar kampoj.

• La kampo Priskribo enhavas mallongan priskriban tekston por identigi la file tajpu.
• La File nomo ŝablono kampo estas uzata por elekti files esti importitaj kiam ili kongruas kun la valoro de la kampoj. La kampo uzas la sekvan sintakson:

1. La plej ofta uzokazo povas esti a file etendo. La kutima sintakso estas .EXT, kie EXT estas la dezirata file etendo (ekz. .java).
2. Alia ofta situacio estas speciala file, kiel farofile. Tial, eblas kongrui sur la ĝusta file nomo. Por fari tion, simple enigu la file nomo en la kampon (ekz. build.xml).
3. En kelkaj kazoj la mapdeziroj estas pli specifaj, do nur files kiuj kongruas kun speciala ŝablono estu importitaj. Por konveni ĉi tiun postulon eblas uzi regulajn esprimojn en la File nomo ŝablono kampo.
   Priskribi la sintakson de regulaj esprimoj superus la intencon de ĉi tiu helpo. Bonvolu konsulti la sekcion pri regulaj esprimoj de la referenca ĉapitro en la gvidilo de pure::variants (ekz.

• La kampo Mapped element-tipo fiksas la mapadon inter a file tipo kaj pura::variants familia elemento tipo. La familia elemento tipo estas priskribilo por la fonto file provizi pliajn informojn al la mapita elemento en la importita modelo. Tipaj elektoj estas ps:class aŭ ps:makefile.
• La Mapita file tajpa kampo fiksas la mapadon inter a file tipo kaj pura::variaĵoj file tajpu. La file type in pure::variants estas priskribilo por la fonto file provizi pliajn informojn al la mapita elemento en la importita modelo. Tipaj elektoj estas impl por efektivigoj aŭ def por difino files.

Figuro 3. Paĝo de la importa sorĉisto por difini individuan agordonNova file tipoj povas esti aldonitaj per la butono Aldoni Mapado. Ĉiuj kampoj estas plenigitaj kun la valoro nedifinita kaj devas esti plenigitaj de la uzanto. Por redakti valoron en kampo, simple klaku en la kampon per la muso. La valoro iĝas redaktebla kaj povas esti ŝanĝita. Ne eblas ŝanĝi la defaŭltan file nompadronoj de la tabelo. Por fleksebla personigo, eblas malelekti a file tajpu malelektante la vicon. Malelektita file nomŝablonoj restas en la agordo sed ne estos uzataj de la importisto. Uzanto difinita file tipoj povas esti forigitaj denove uzante la butonon Forigi Mapadon.
Defaŭlte Alia files file nomo ŝablono estas disponebla en la tabelo sed malelektita. Kutime ĝi ne volas importi ĉion files sed ĉi tio povas esti facile ŝanĝita elektante la konforman vicon.
Estas tri ĝeneralaj importopcioj por personecigi la konduton de la importisto.

• Ne importu dosierujojn sen kongruo files (ekz. CVS-dosierujoj).
  Se la importisto trovas dosierujon kie neniu kongruo file estas en ĝi kaj kie neniu subdosierujo havas kongruon file, la dosierujo ne estos importita. Ĉi tio ofte estas utila, se projektoj estas administritaj de versio-administradsistemoj kiel CVS. Por CVS, ĉiu koncerna dosierujo enhavas CVS-dosierujon kie sensignifa files estas konservitaj. Se ĉi tiu opcio estas elektita kaj la CVS-files ne kongruas al iu ajn file tipo difinita supre, la dosierujo ne estos importita kiel komponanto en la Familia Modelo.
• Ordigi files kaj adresaroj.
  Ebligu ĉi tiun opcion por ordigi files kaj dosierujoj ĉiu en alfabeta ordo.
• Import-vojtraktado.
  Por plia sinkronigo la importisto devas konservi la originan vojon de ĉiuj importitaj elementoj en la modelon.
  En multaj kazoj Familiaj Modeloj estas dividitaj kun aliaj uzantoj. La dosierujo-strukturo povas esti malsama por ĉiu uzanto. Por subteni plej oftajn uzajn scenarojn la importisto povas funkcii en malsamaj reĝimoj:

Absoluta	La absoluta vojo al la importita elemento estos konservita en la modelon. Por posta sinkronigo kaj dum la transformo la files devas meti sur la ekzakte sama loko kiel dum la unua importo.
Rilate al Laborspaco	La vojoj estas konservitaj rilate al la laborspaca dosierujo. Por sinkronigado la files devas esti parto de la laborspaco Eclipse. La transformo devas uzi la laborspacon Eclipse kiel eniga dosierujo.
Rilate al Projekto	La vojoj estas konservitaj relative al la projekto. Por sinkronigado la files estas parto de la projekto ene de Eclipse. La transformo devas uzi la projektan dosierujon kiel eniga dosierujo.
Rilate al Pado	La vojoj estas konservitaj relative al la donita vojo. Por sinkronigado la files devas esti metitaj sur la ekzakte sama loko. La transforma eniga dosierujo estas la sama kiel la relativa vojo dum la importo.

Ĉiuj preferoj de ĉi tiu dialogo estas konservitaj konstante. La personaj personigoj ne devas refari ĉiufoje kiam la importado funkcias. Ĉi tio faras la importan laborfluon facila kaj rapida.
2.3. Ĝisdatigi Modelojn de Dosierujo-Arbo
Premu la butonon Sinkronigi por sinkronigi importitan modelon kun ĝia dosieruja vojo. La radika vojo de la projekto estas konservita en la modelo, do ĝi sinkronigos al la sama dosierujo kiel antaŭe. Por ebligi la butonon Sinkronigi, malfermu la modelon kaj elektu iun ajn elementon. Post premado de la butono Sinkronigi, Kompara Redaktoro estas malfermita kie la nuna Familia Modelo kaj la modelo de la nuna dosierujo-strukturo estas kontraŭaj (vidu Figuro 4, "Modela ĝisdatigo de Dosierujo en Kompara Redaktoro").
Figuro 4. Modela ĝisdatigo de Dosierujo-Arbo en Komparredaktilo   La kompara redaktilo estas uzata tra pure::variants por kompari modelversiojn sed ĉi-kaze estas uzata por kompari la fizikan dosierujon (montritan en la malsupra dekstra flanko) kun la nuna pure::variants modelo (malsupra maldekstra flanko). Ĉiuj ŝanĝoj estas listigitaj kiel apartaj eroj en la supra parto de la redaktilo, ordonitaj per la tuŝitaj elementoj.
Elektante eron en ĉi tiu listo reliefigas la respektivan ŝanĝon en ambaŭ modeloj. En la eksample, aldonita elemento estas markita per skatolo sur la dekstra flanko kaj konektita kun ĝia realigebla pozicio en la modelo sur la maldekstra flanko. La ilobreto Kunfandi inter supra kaj malsupra redaktilo-fenestroj disponigas ilojn por kopii unuopajn aŭ eĉ ĉiujn (ne-konfliktajn) ŝanĝojn entute de la dosierujo-arbomodelo al la Karakterizaĵa Modelo.
Notu
La sinkronigo estas farita kun la laste uzataj importaj agordoj. Ĉi tio ebligas ĝisdatigi la modelon kun aliaj agordoj kiel faritaj dum la importado estis farita.

Uzante Rilatan Indeksilon

La Konektilo por Fontkoda Administrado plibonigas la Rilatojn View kun informoj pri ligoj inter pure::variants modelelementoj kaj fontkodo. Rilatoj estas aldonitaj por funkcioj kiuj estas uzataj en kondiĉoj de la ps:condxml kaj ps:condtext elementoj.
Por ps:flag kaj ps:flagfile elementoj la loko de antaŭprocesorkonstantoj en C/C++ fonto files estas montritaj. Krome la lokoj de kongruaj antaŭprocesorkonstantoj estas montritaj por elektita trajto uzante la mapadon inter trajto unikaj nomoj kaj antaŭprocesorkonstantoj.
3.1. Aldonante la Rilatan Indeksilon al Projekto
La rilatindeksilo povas esti aktivigita sur speciala projekta proprietpaĝo. Elektu la projekton kaj elektu la eron de Propraĵoj en la kunteksta menuo. En la venonta dialogo elektu la paĝon de Relation Indexer.
Figuro 5. Projekta Proprieto-Paĝo por la Rilata Indeksilo

La rilato-indeksilo estas aktivigita por la projekto elektante la opcion Ebligi Rilatan Indeksilon (1). Post ebligo de la indeksilo ekzistas kelkaj pliaj ebloj por difini la projektan specifan konduton. La indeksado de pure::variants Kondiĉoj kaj C/C++ Antaŭprocesora Konstantoj povas esti aktivigita aparte (2). La listo kun file nomo ŝablonoj (3) estas uzata por elekti la files por indeksado. Nur files kiuj kongruas kun unu el la ŝablonoj estas skanitaj. Aldonu la "*" kiel ŝablonon por skani ĉion files de projekto.
Post aktivigo de la indeksilo por projekto konstruanto estas aldonita al la projekto. Ĉi tiu konstruaĵskanado ŝanĝiĝis files por novaj rilatoj al pure::variants modelelementoj aŭtomate.
3.2. La Rilatoj al la Fontkodo
Kun aktivigita rilato-indeksilo la Rilatoj View enhavas pliajn enskribojn. Ĉi tiuj enskriboj montras la nomon de la file kaj la linionumero de la varianta punkto. La ila konsileto montras la taŭgan sekcion de la file. Duoble alklakante la enskribon la file estos malfermita en redaktilon.
pure::variants Kondiĉoj
La pure::variants kondiĉo povas esti uzata por inkluzivi aŭ ekskludi sekciojn de a file depende de karakteriza elekto. La Kondiĉa Indeksilo serĉas tiajn regulojn kaj ĉerpas la referencajn funkciojn. Se tia funkcio estas elektita en la redaktilo la Rilatoj View montros ĉion files kaj linioj kie troviĝas kondiĉo kun la elektita trajto (vidu Figuro 6, "Reprezento de Kondiĉo en la Rilatoj View").
Figuro 6. Reprezento de Kondiĉo en la Rilatoj ViewPor ricevi detalan klarigon pri kiel difini kondiĉojn, konsultu la sekcion ps:condtext de ĉapitro 9.5.7 de la pure::variants Uzanta Gvidilo (Referenco–>Predifinitaj Font-Elementoj–>ps:condtext).
C/C++ Antaŭprocesoro Konstantoj
La C/C++ Antaŭprocesoro-Indeksilo skanas files por konstantoj uzataj en antaŭprocesoraj reguloj (ekz. #ifdef, #ifndef, …).
Se ps:flag aŭ ps:flagfile elemento estas elektita la Rilatoj View montras la uzadon de la difinita antaŭprocesora konstanto.
La Rilatoj View ankaŭ montras antaŭprocesorajn konstantojn ligitajn al ecoj uzante mapajn ŝablonojn. Por tio la ŝablonoj estas vastigitaj kun la datumoj de la elektita trajto. La rezultaj simboloj estas uzataj por serĉi kongruajn antaŭprocesorajn konstantojn. Figuro 7, "Reprezento de C/C++ Antaŭprocesoro Konstanto en la Rilatoj View” montras eksample kun la ŝablono famo{Nomo}. La ŝablono estas vastigita kun la unika nomo de la trajto al fameNative. En la indeksita kodo estas 76 lokoj kie la antaŭprocesora konstanta fameNative estas uzata.
Ĉi tiuj lokoj estas montritaj en la Rilatoj View. La ŝablonoj povas esti difinitaj en la preferoj (vidu Sekcion 3.3, "La Preferoj").
Figuro 7. Reprezento de C/C++ Antaŭprocesoro Konstanto en la Rilatoj View

3.3. La Preferoj
Por ŝanĝi la defaŭltan konduton de la indeksilo malfermu la Eclipse-preferojn kaj elektu la paĝon de Rilato-Indeksilo en la kategorio Variant Management. La paĝo montras du listojn.
Figuro 8. Relation Indexer PreferpaĝoLa supra listo enhavas la defaŭltan file ŝablonoj por la indeksilo (1). Ĉi tiu listo estas la komenca ŝablono por lastatempe ebligitaj projektoj.
La malsupra listo enhavas la mapadon inter trajtoj kaj antaŭprocesoraj konstantoj (2). Ĉi tiu mapado estas uzata por ĉiuj projektoj. Tabelo 1, "Subtenitaj Mapaj Anstataŭaĵoj" montras ĉiujn eblajn anstataŭaĵojn.
Tabelo 1. Subtenataj Mapaj Anstataŭaĵoj

Ĵetanto	Priskribo	Example: FeatureA
Nomo	la Unika Nomo de la elektita trajto	FLAG_{Nomo} – FLAG_FeatureA
NOMO	la majuskla Unika Nomo de la elektita trajto	FLAG_{NAME} – FLAG_FEATUREA
nomo	la minuskla Unika Nomo de la elektita trajto	flago_{nomo} – flago_trajto

Dokumentoj/Rimedoj

pure-systems 2024 Konektilo por Fontkoda Administrada Programaro [pdf] Uzanto-manlibro 2024, 2024 Konektilo por Fontkoda Administrada Programaro, Konektilo por Fonta Koda Administrada Programaro, Fonta Koda Administrada Programaro, Mastrumada Programaro, Programaro

Referencoj

• Uzanto Manlibro