pure::variants – Connector per
Manual de gestió del codi font
Parametric Technology GmbH
Versió 6.0.7.685 per a pure::variants 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Introducció

pure::variants El connector per a la gestió del codi font (Connector) permet als desenvolupadors gestionar la variabilitat del codi font mitjançant pure::variants. La gestió del codi font de pure::variants ofereix una oportunitat flexible per sincronitzar les estructures de directoris i el codi font files fàcilment amb models purs::variants. D'aquesta manera, la gestió de variants es pot aplicar fins i tot a projectes de programari complexos. A més, les connexions entre les funcions pure::variants i el codi font es poden gestionar més fàcilment amb el creador i són molt accessibles mitjançant la gestió del codi font.
1.1. Requisits de programari
El connector pure::variants per a la gestió del codi font és una extensió per a pure::variants i està disponible a totes les plataformes compatibles.
1.2. Instal·lació
Si us plau, consulteu la secció Connectors pure::variants a la Guia de configuració de pure::variants per obtenir informació detallada sobre com instal·lar el connector (menú Ajuda -> Continguts d'ajuda i després Guia de configuració pure::variants -> Connectors pure::variants).
1.3. Sobre aquest manual
S'espera que el lector tingui coneixements bàsics i experiències amb pure::variants. Si us plau, consulteu el seu material introductori abans de llegir aquest manual. El manual està disponible a l'ajuda en línia així com en format PDF imprimible aquí.

Utilitzant el connector

2.1. Començant pure::variants
Depenent del mètode d'instal·lació utilitzat, inicieu l'Eclipse habilitat per a pure::variants o, a Windows, seleccioneu l'element pure::variants al menú del programa.
Si la perspectiva de Gestió de variants encara no està activada, feu-ho seleccionant-la des de Perspectiva oberta->Altres... al menú Finestra.
2.2. Importa un arbre de directoris a un model familiar
Abans d'importar un arbre de directoris a un model familiar, s'ha de crear un projecte de variants. També és suggeridor tenir ja característiques definides en un model de característiques. Si us plau, consulteu la documentació de pure::variants per obtenir ajuda sobre aquests passos.
La importació real s'inicia seleccionant l'acció Importa... al menú contextual dels Projectes view o amb el menú Importa... al menú File menú. Seleccioneu Models de variants o Projectes de la categoria Gestió de variants i premeu Següent. A la pàgina següent, seleccioneu Importa un model familiar de les carpetes d'origen i torneu a prémer Següent.
Trieu el tipus de codi font per importar
Apareix l'assistent d'importació (vegeu la figura 1, “Pàgina de l'assistent d'importació per seleccionar el tipus de codi font que es pot importar”). Seleccioneu un tipus de projecte per importar i premeu Següent. Cada tipus conté un conjunt predefinit de file tipus per importar al model.
Figura 1. Pàgina de l'assistent d'importació per seleccionar el tipus de codi font que es pot importarSeleccioneu Font i Destí
A la següent pàgina de l'assistent (Figura 2, "Pàgina de l'assistent d'importació per seleccionar l'origen i l'objectiu de la importació") s'han d'especificar el directori font i el model de destinació.
Premeu el botó Navega... per seleccionar el directori on hi ha el codi font que s'ha d'importar. Per defecte, l'espai de treball actual està seleccionat perquè aquest pot ser un punt útil per començar a navegar.
A continuació, podeu especificar un patró d'inclusió i exclusió. Aquests patrons han de ser expressions regulars de Java. Cada camí d'entrada, en relació a la carpeta arrel d'origen, es comprova amb aquests patrons. Si el patró d'inclusió coincideix, s'importa una carpeta, si el patró d'exclusió no coincideix. El que significa que el patró d'inclusió selecciona prèviament les carpetes a importar, el patró d'exclusió restringeix aquesta preselecció.
Després de seleccionar el directori del codi font, s'ha de definir un model de destinació. Per tant, seleccioneu un projecte variant o una carpeta on s'ha d'emmagatzemar el model i introduïu un nom de model. El file El nom s'amplia automàticament amb l'extensió .ccfm si no es dóna en aquest diàleg. Per defecte s'establirà amb el mateix nom que el mateix nom del model. Aquesta és la configuració recomanada.
Després d'especificar una carpeta d'origen convenient i el nom del model desitjat, el diàleg es podria acabar prement Finalitza. Si es prem el botó Següent, apareixerà una pàgina més on es poden fer configuracions addicionals.
Figura 2. Pàgina de l'assistent d'importació per seleccionar l'origen i el destí de la importacióCanvia les preferències d'importació
A la darrera pàgina de l'assistent (Figura 3, "Pàgina de l'assistent d'importació per definir una configuració individual”) hi ha preferències que es poden fer per personalitzar el comportament d'importació per al projecte de programari importat.
La pàgina de diàleg mostra una taula on el file es defineixen els tipus, que seran considerats pel procés d'importació.
Cada línia consta de quatre camps.

• El camp Descripció conté un text descriptiu breu per identificar-lo file tipus.
• El File El camp del patró de nom s'utilitza per seleccionar files que s'importaran quan coincideixin amb el valor dels camps. El camp utilitza la sintaxi següent:

1. El cas d'ús més comú pot ser a file extensió. La sintaxi habitual és .EXT, on EXT és el desitjat file extensió (per exemple, .java).
2. Una altra situació habitual és una especial file, com una marcafile. Per tant, és possible fer coincidir exactament file nom. Per fer-ho, només cal introduir file nom al camp (per exemple, build.xml).
3. En alguns casos, els desitjos de mapes són més específics, per tant només fileS'han d'importar els que coincideixin amb un patró especial. Per adaptar-se a aquest requisit, és possible utilitzar expressions regulars al fitxer File camp de patró de nom.
   Descriure la sintaxi de les expressions regulars superaria la intenció d'aquesta ajuda. Si us plau, consulteu la secció d'expressions regulars del capítol de referència a la guia de l'usuari de pure::variants (p.

• El camp Tipus d'element mapat estableix l'assignació entre a file tipus i un tipus d'element familiar pur::variants. El tipus d'element familiar és un descriptor de la font file per proporcionar més informació a l'element mapa en el model importat. Les seleccions típiques són ps:class o ps:makefile.
• El Mapejat file El camp de tipus estableix la correspondència entre a file tipus i una pura::variants file tipus. El file type in pure::variants és un descriptor per a la font file per proporcionar més informació a l'element mapa en el model importat. Les seleccions típiques són impl per a les implementacions o def per a la definició files.

Figura 3. Pàgina de l'assistent d'importació per definir una configuració individualNou file es poden afegir tipus mitjançant el botó Afegeix mapeig. Tots els camps s'emplenen amb el valor no definit i els ha d'omplir l'usuari. Per editar un valor en un camp, feu clic al camp amb el ratolí. El valor es pot editar i es pot canviar. No és possible canviar el valor predeterminat file patrons de nom de la taula. Per flexibilitzar una personalització, és possible deseleccionar a file escriviu deseleccionant la fila. Desseleccionat file els patrons de nom es mantenen a la configuració, però l'importador no els farà servir. Definit per l'usuari file Els tipus es poden tornar a eliminar utilitzant el botó Elimina mapes.
Per defecte un altre files file El patró de nom està disponible a la taula però no està seleccionat. Normalment no es vol importar-ho tot files, però això es pot canviar fàcilment seleccionant la fila corresponent.
Hi ha tres opcions generals d'importació per personalitzar el comportament de l'importador.

• No importeu directoris sense coincidir files (per exemple, directoris CVS).
  Si l'importador troba un directori on no coincideix file hi és i on cap subdirectori té una coincidència file, el directori no s'importarà. Això sovint és útil si els projectes són gestionats per sistemes de gestió de versions com CVS. Per a CVS, cada directori rellevant conté un directori CVS quan és irrellevant files emmagatzemen. Si se selecciona aquesta opció i el CVS-files no coincideixen amb cap file tipus definit anteriorment, el directori no s'importarà com a component al model familiar.
• Ordena files i directoris.
  Activeu aquesta opció per ordenar files i directoris cadascun per ordre alfabètic.
• Gestió de camins d'importació.
  Per a una sincronització addicional, l'importador ha d'emmagatzemar la ruta original de tots els elements importats al model.
  En molts casos, els models familiars es comparteixen amb altres usuaris. L'estructura del directori pot ser diferent per a cada usuari. Per donar suport als escenaris d'ús més habituals, l'importador pot funcionar en diferents modes:

Absoluta	La ruta absoluta a l'element importat s'emmagatzemarà al model. Per a la sincronització posterior i durant la transformació el files han de col·locar exactament a la mateixa ubicació que durant la primera importació.
Relatiu a l'espai de treball	Els camins s'emmagatzemen en relació a la carpeta de l'espai de treball. Per a la sincronització files ha de formar part de l'espai de treball Eclipse. La transformació ha d'utilitzar l'espai de treball Eclipse com a directori d'entrada.
Relatiu al projecte	Els camins s'emmagatzemen en relació al projecte. Per a la sincronització files formen part del projecte dins d'Eclipse. La transformació ha d'utilitzar la carpeta del projecte com a directori d'entrada.
Relatiu al camí	Els camins s'emmagatzemen en relació amb el camí donat. Per a la sincronització files'han de col·locar exactament al mateix lloc. El directori d'entrada de transformació és el mateix que el camí relatiu durant la importació.

Totes les preferències d'aquest diàleg s'emmagatzemen de manera persistent. Les personalitzacions personals no s'han de tornar a fer cada vegada que s'executa la importació. Això fa que el flux de treball d'importació sigui fàcil i ràpid.
2.3. Actualització de models des de l'arbre de directoris
Premeu el botó Sincronitza per sincronitzar un model importat amb la seva ruta de directori. La ruta arrel del projecte s'emmagatzema al model de manera que es sincronitzarà amb el mateix directori que abans. Per activar el botó Sincronitza, obriu el model i seleccioneu qualsevol element. Després de prémer el botó Sincronitza, s'obre un editor de comparació on s'oposa el model familiar actual i el model de l'estructura de directoris actual (vegeu la figura 4, "Actualització del model des de l'arbre de directoris a l'editor de comparació").
Figura 4. Actualització del model des de l'arbre de directoris a l'editor de comparació   L'editor de comparació s'utilitza a les pure::variants per comparar les versions del model, però en aquest cas s'utilitza per comparar l'estructura del directori físic (que es mostra a la part inferior dreta) amb el model actual pure::variants (inferior esquerre). Tots els canvis s'enumeren com a elements separats a la part superior de l'editor, ordenats pels elements afectats.
La selecció d'un element d'aquesta llista destaca el canvi respectiu en ambdós models. En l'exampLle, un element afegit està marcat amb una casella a la part dreta i connectat amb la seva posició factible en el model a la part esquerra. La barra d'eines Combina entre les finestres de l'editor superior i inferior ofereix eines per copiar un sol o fins i tot tots els canvis (no conflictius) en conjunt del model d'arbre de directoris al Model de funcions.
Nota
La sincronització es fa amb la darrera configuració de l'importador utilitzat. Això fa possible actualitzar el model amb altres paràmetres tal com es va fer mentre es va fer la importació.

Ús de l'indexador de relacions

El connector per a la gestió del codi font millora les relacions View amb informació sobre les connexions entre els elements del model pur::variants i el codi font. S'afegeixen relacions per a les característiques que s'utilitzen en condicions dels elements ps:condxml i ps:condtext.
Per a ps:flag i ps:flagfile elements la ubicació de les constants del preprocessador a la font C/C++ filees mostren s. A més, es mostren les ubicacions de les constants del preprocessador coincidents per a una característica seleccionada mitjançant la correspondència entre els noms únics de les característiques i les constants del preprocessador.
3.1. Afegir l'indexador de relacions a un projecte
L'indexador de relacions es pot activar en una pàgina especial de propietats del projecte. Seleccioneu el projecte i trieu l'element Propietats al menú contextual. Al proper diàleg, seleccioneu la pàgina Indexador de relacions.
Figura 5. Pàgina de propietats del projecte per a l'indexador de relacions

L'indexador de relacions s'activa per al projecte seleccionant l'opció Habilita l'indexador de relacions (1). Després d'habilitar l'indexador, hi ha algunes opcions més per definir el comportament específic del projecte. La indexació de condicions pure::variants i constants de preprocessador C/C++ es pot activar per separat (2). La llista amb file Els patrons de nom (3) s'utilitzen per seleccionar el files per a la indexació. Només files'escanegen els que coincideixen amb un dels patrons. Afegiu el "*" com a patró per escanejar-ho tot files d'un projecte.
Després d'activar l'indexador d'un projecte, s'afegeix un constructor al projecte. Aquesta exploració del constructor ha canviat files per a noves relacions amb els elements del model pur::variants automàticament.
3.2. Les relacions amb el codi font
Amb l'indexador de relacions activat les Relacions View conté entrades addicionals. Aquestes entrades mostren el nom del file i el número de línia del punt variant. La informació sobre l'eina mostra la secció adequada del fitxer file. Fent doble clic a l'entrada file s'obrirà a un editor.
pure::variants Condicions
La condició pure::variants es pot utilitzar per incloure o excloure seccions de a file en funció de la selecció d'una característica. L'indexador de condicions busca aquestes regles i extreu les característiques de referència. Si aquesta característica està seleccionada a l'editor, les Relacions View ho mostrarà tot files i línies on es troba una condició amb la característica seleccionada (vegeu la figura 6, “Representació d'una condició en les relacions View”).
Figura 6. Representació d'una condició en les relacions ViewPer obtenir una explicació detallada sobre com definir les condicions, consulteu la secció ps:condtext del capítol 9.5.7 de la Guia de l'usuari de pure::variants (Referència–>Tipus d'elements font predefinits–>ps:condtext).
Constants del preprocessador C/C++
L'indexador de preprocessador C/C++ explora files per a les constants utilitzades a les regles del preprocessador (per exemple, #ifdef, #ifndef, …).
Si és ps:flag o ps:flagfile es selecciona l'element Relacions View mostra l'ús de la constant del preprocessador definida.
Les Relacions View també mostra les constants del preprocessador connectades a les característiques mitjançant patrons de mapatge. Per a això els patrons s'amplien amb les dades de la característica seleccionada. Els símbols resultants s'utilitzen per cercar constants del preprocessador coincidents. Figura 7, "Representació d'una constant de preprocessador C/C++ a les relacions View” mostra un example amb el patró fame{Nom}. El patró s'amplia amb el nom únic de la funció a fameNative. Al codi indexat hi ha 76 ubicacions on s'utilitza la constant del preprocessador fameNative.
Aquestes ubicacions es mostren a les Relacions View. Els patrons es poden definir a les preferències (vegeu la Secció 3.3, "Les preferències").
Figura 7. Representació d'una constant de preprocessador C/C++ en les relacions View

3.3. Les Preferències
Per canviar el comportament predeterminat de l'indexador, obriu les preferències de l'Eclipse i seleccioneu la pàgina Indexador de relacions a la categoria Gestió de variants. La pàgina mostra dues llistes.
Figura 8. Pàgina de preferències de l'indexador de relacionsLa llista superior conté el valor predeterminat file patrons per a l'indexador (1). Aquesta llista és la configuració inicial del patró per als projectes recentment activats.
La llista inferior conté el mapeig entre les característiques i les constants del preprocessador (2). Aquest mapatge s'utilitza per a tots els projectes. La taula 1, "Substitucions de mapes admeses" mostra totes les substitucions possibles.
Taula 1. Substitucions de mapes admeses

Comodí	Descripció	Example: CaracterísticaA
Nom	el nom únic de la característica seleccionada	FLAG_{Nom} – FLAG_FeatureA
NOM	el nom únic en majúscula de la característica seleccionada	FLAG_{NAME} – FLAG_FEATUREA
nom	el nom únic en minúscula de la característica seleccionada	bandera_{nom} – característica_bandera

Documents/Recursos

Connector pure-systems 2024 per al programari de gestió de codi font [pdfManual d'usuari 2024, 2024 Connector per a programari de gestió de codi font, connector per a programari de gestió de codi font, programari de gestió de codi font, programari de gestió, programari

Referències

• Manual d'usuari