pure::variants – Conector para
Manual de xestión do código fonte
Parametric Technology GmbH
Versión 6.0.7.685 para pure::variants 6.0
Copyright © 2003-2024 Parametric Technology GmbH
2024

Introdución

pure::variants O conector para a xestión do código fonte (Conector) permite aos desenvolvedores xestionar a variabilidade do código fonte usando pure::variants. A xestión do código fonte de pure::variants ofrece unha oportunidade flexible para sincronizar estruturas de directorios e código fonte files facilmente con modelos puros::variants. Deste xeito, a xestión de variantes pódese aplicar incluso a proxectos de software complexos. Ademais, as conexións entre as funcións pure::variants e o código fonte poden xestionarse máis facilmente co creador e son moi accesibles a través da Xestión do código fonte.
1.1. Requisitos de software
O conector pure::variants para a xestión do código fonte é unha extensión para pure::variants e está dispoñible en todas as plataformas compatibles.
1.2. Instalación
Consulte a sección Conectores de pure::variants na Guía de configuración de pure::variants para obter información detallada sobre como instalar o conector (menú Axuda -> Contidos de axuda e despois Guía de configuración de pure::variants -> Conectores de pure::variants).
1.3. Acerca deste manual
Espérase que o lector teña coñecementos básicos e experiencias con pura::variantes. Consulte o seu material introductorio antes de ler este manual. O manual está dispoñible na axuda en liña así como en formato PDF imprimible aquí.

Usando o conector

2.1. Comezando pure::variants
Dependendo do método de instalación empregado, inicie o Eclipse habilitado para pure::variants ou en Windows seleccione o elemento pure::variants no menú do programa.
Se a perspectiva Xestión de variantes aínda non está activada, faino seleccionándoa en Abrir perspectiva->Outro... no menú Ventá.
2.2. Importar unha árbore de directorios nun modelo familiar
Antes de importar unha árbore de directorios nun modelo familiar, hai que crear un proxecto de variantes. Tamén é suxestivo ter características xa definidas nun modelo de características. Consulte a documentación de pure::variants para obter axuda sobre estes pasos.
A importación real iníciase seleccionando a acción Importar... no menú contextual dos Proxectos view ou co menú Importar... no menú File menú. Seleccione Modelos de variantes ou Proxectos da categoría Xestión de variantes e prema Seguinte. Na páxina seguinte, seleccione Importar un modelo familiar dos cartafoles de orixe e prema Seguinte de novo.
Escolla o tipo de código fonte para importar
Aparece o asistente de importación (consulte a Figura 1, "Páxina do asistente de importación para seleccionar o tipo de código fonte que se pode importar"). Seleccione un tipo de proxecto para importar e prema Seguinte. Cada tipo contén un conxunto predefinido de file tipos para importar ao modelo.
Figura 1. Páxina do asistente de importación para seleccionar o tipo de código fonte que se pode importarSeleccione Orixe e Destino
Na seguinte páxina do asistente (Figura 2, "Páxina do asistente de importación para seleccionar a orixe e o destino para a importación") debe especificarse o directorio de orixe e o modelo de destino.
Prema o botón Examinar... para seleccionar o directorio onde existe o código fonte que se debe importar. De forma predeterminada, o espazo de traballo actual está seleccionado porque este pode ser un punto útil para comezar a navegar.
Abaixo podes especificar un patrón de inclusión e exclusión. Estes patróns teñen que ser expresións regulares de Java. Cada ruta de entrada, relativa ao cartafol raíz de orixe, compróbase con estes patróns. Se o patrón de inclusión coincide, impórtase un cartafol, se o patrón de exclusión non coincide. É dicir, o patrón de inclusión selecciona previamente os cartafoles a importar, o patrón de exclusión restrinxe esta preselección.
Despois de seleccionar o directorio do código fonte, debe definirse un modelo de destino. Polo tanto, seleccione un proxecto variante ou un cartafol onde se debe almacenar o modelo e introduza un nome de modelo. O file o nome esténdese automaticamente coa extensión .ccfm se non se indica neste diálogo. Por defecto, establecerase co mesmo nome que o propio nome do modelo. Esta é a configuración recomendada.
Despois de especificar un cartafol fonte conveniente e o nome do modelo desexado, o diálogo pode rematar premendo Finalizar. Se se preme o botón Seguinte, aparecerá unha páxina máis onde se poden facer axustes adicionais.
Figura 2. Páxina do asistente de importación para seleccionar a orixe e o destino da importaciónCambiar as preferencias de importación
Na última páxina do asistente (Figura 3, "Páxina do asistente de importación para definir unha configuración individual”) hai preferencias que se poden facer para personalizar o comportamento de importación para o proxecto de software importado.
A páxina de diálogo amosa unha táboa onde o file defínense tipos, que serán considerados polo proceso de importación.
Cada liña consta de catro campos.

• O campo Descrición contén un breve texto descritivo para identificar file tipo.
• O File O campo de patrón de nome úsase para seleccionar files que se importarán cando coincidan co valor dos campos. O campo usa a seguinte sintaxe:

1. O caso de uso máis común pode ser a file extensión. A sintaxe habitual é .EXT, onde EXT é o desexado file extensión (por exemplo, .java).
2. Outra situación común é unha especial file, como unha marcafile. Polo tanto, é posible facer coincidir o exacto file nome. Para iso, só tes que introducir o file nome no campo (por exemplo, build.xml).
3. Nalgúns casos, os desexos de mapeo son máis específicos, polo que só filedeben importarse os que coincidan cun patrón especial. Para axustar este requisito é posible usar expresións regulares no File campo de patrón de nome.
   Describir a sintaxe das expresións regulares excedería o propósito desta axuda. Consulte a sección de expresións regulares do capítulo de referencia na guía do usuario de pure::variants (por exemplo, .*).

• O campo Tipo de elemento mapeado establece a asignación entre a file tipo e un tipo de elemento familiar puro::variants. O tipo de elemento familiar é un descritor para a fonte file para proporcionar máis información ao elemento mapeado no modelo importado. As seleccións típicas son ps:class ou ps:makefile.
• O Mapeado file campo de tipo establece a asignación entre a file tipo e unha pura::variantes file tipo. O file type in pure::variants é un descritor para a fonte file para proporcionar máis información ao elemento mapeado no modelo importado. As seleccións típicas son impl para implementacións ou def para definición files.

Figura 3. Páxina do asistente de importación para definir unha configuración individualNovo file pódense engadir tipos usando o botón Engadir mapeo. Todos os campos están cubertos co valor non definido e deben ser cubertos polo usuario. Para editar un valor nun campo, só tes que premer no campo co rato. O valor faise editable e pódese cambiar. Non é posible cambiar o valor predeterminado file patróns de nome da táboa. Para facer unha personalización flexible, é posible deseleccionar a file escriba anulando a selección da fila. Desseleccionado file os patróns de nomes permanecen na configuración pero non serán utilizados polo importador. Definido polo usuario file os tipos pódense eliminar de novo usando o botón Eliminar mapeo.
Por defecto un Outro files file O patrón de nome está dispoñible na táboa pero deseleccionado. Normalmente non se quere importar todo files pero isto pódese cambiar facilmente seleccionando a fila correspondente.
Existen tres opcións xerais de importación para personalizar o comportamento do importador.

• Non importe directorios sen coincidencia files (por exemplo, directorios CVS).
  Se o importador atopa un directorio onde non hai coincidencias file está nel e onde ningún subdirectorio ten unha coincidencia file, o directorio non será importado. Isto adoita ser útil se os proxectos son xestionados por sistemas de xestión de versións como CVS. Para CVS, cada directorio relevante contén un directorio CVS cando non é relevante files almacénanse. Se se selecciona esta opción e o CVS-files non coinciden con ningún file tipo definido anteriormente, o directorio non se importará como compoñente no modelo familiar.
• Ordenar files e directorios.
  Activa esta opción para ordenar files e directorios cada un por orde alfabética.
• Xestión de rutas de importación.
  Para unha maior sincronización, o importador debe almacenar a ruta orixinal de todos os elementos importados no modelo.
  En moitos casos os modelos familiares compártense con outros usuarios. A estrutura do directorio pode ser diferente para cada usuario. Para admitir os escenarios de uso máis comúns, o importador pode funcionar en diferentes modos:

Absoluto	A ruta absoluta ao elemento importado almacenarase no modelo. Para a sincronización posterior e durante a transformación o files teñen que colocarse exactamente no mesmo lugar que durante a primeira importación.
Relativo ao espazo de traballo	Os camiños almacénanse en relación ao cartafol do espazo de traballo. Para a sincronización files ten que formar parte do espazo de traballo Eclipse. A transformación ten que usar o espazo de traballo Eclipse como directorio de entrada.
Relativo ao Proxecto	Os camiños almacénanse en relación ao proxecto. Para a sincronización files forman parte do proxecto dentro de Eclipse. A transformación ten que usar o cartafol do proxecto como directorio de entrada.
Relativo ao Camiño	Os camiños almacénanse en relación ao camiño indicado. Para a sincronización files teñen que colocarse exactamente no mesmo lugar. O directorio de entrada de transformación é o mesmo que o camiño relativo durante a importación.

Todas as preferencias deste diálogo almacénanse de forma persistente. Non se deben refacer as personalizacións persoais cada vez que se executa a importación. Isto fai que o fluxo de traballo de importación sexa fácil e rápido.
2.3. Actualizando modelos desde a árbore de directorios
Prema o botón Sincronizar para sincronizar un modelo importado coa súa ruta de directorio. A ruta raíz do proxecto almacénase no modelo polo que se sincronizará co mesmo directorio que antes. Para activar o botón Sincronizar, abra o modelo e seleccione calquera elemento. Despois de premer o botón Sincronizar ábrese un Editor de comparación onde se opón o modelo familiar actual e o modelo da estrutura de directorio actual (consulte a Figura 4, "Actualización do modelo desde a árbore de directorios no Editor de comparación").
Figura 4. Actualización do modelo desde a árbore de directorios no Editor de comparación   O editor de comparación utilízase en pure::variants para comparar versións de modelos, pero neste caso utilízase para comparar a estrutura do directorio físico (mostrada na parte inferior dereita) co modelo puro::variants actual (parte inferior esquerda). Todos os cambios aparecen como elementos separados na parte superior do editor, ordenados polos elementos afectados.
Ao seleccionar un elemento desta lista destaca o cambio respectivo en ambos os modelos. No example, un elemento engadido está marcado cunha caixa no lado dereito e conectado coa súa posición factible no modelo no lado esquerdo. A barra de ferramentas Combinar entre as ventás do editor superior e inferior ofrece ferramentas para copiar cambios únicos ou incluso todos (non conflitivos) no seu conxunto do modelo de árbore de directorios ao Modelo de características.
Nota
A sincronización realízase coas últimas opcións de importación utilizadas. Isto fai posible actualizar o modelo con outras configuracións tal e como se fixo mentres se fixo a importación.

Usando o indexador de relacións

O conector para a xestión do código fonte mellora as relacións View con información sobre as conexións entre os elementos do modelo pure::variants e o código fonte. Engádense relacións para funcións que se usan nas condicións dos elementos ps:condxml e ps:condtext.
Para ps:flag e ps:flagfile elementos a localización das constantes do preprocesador na fonte C/C++ filemóstranse s. Ademais, móstranse as localizacións das constantes do preprocesador coincidentes para unha característica seleccionada mediante a asignación entre os nomes únicos das características e as constantes do preprocesador.
3.1. Engadir o indexador de relacións a un proxecto
O indexador de relacións pódese activar nunha páxina de propiedades do proxecto especial. Seleccione o proxecto e escolle o elemento Propiedades no menú contextual. No seguinte diálogo, seleccione a páxina do indexador de relacións.
Figura 5. Páxina de propiedades do proxecto para o indexador de relacións

O indexador de relacións actívase para o proxecto seleccionando a opción Activar indexador de relacións (1). Despois de activar o indexador, hai algunhas opcións máis para definir o comportamento específico do proxecto. A indexación das condicións pure::variants e das constantes do preprocesador C/C++ pódese activar por separado (2). A lista con file patróns de nome (3) úsase para seleccionar o files para indexar. Só fileOs que coincidan cun dos patróns son escaneados. Engade o "*" como patrón para escanear todo files dun proxecto.
Despois de activar o indexador dun proxecto, engádese un constructor ao proxecto. Estes escaneos do constructor cambiaron files para novas relacións cos elementos do modelo pure::variants automaticamente.
3.2. As relacións co código fonte
Co indexador de relacións activado Relacións View contén entradas adicionais. Estas entradas mostran o nome do file e o número de liña do punto variante. A suxestión da ferramenta mostra a sección adecuada do file. Facendo dobre clic na entrada file abrirase nun editor.
pure::variants Condicións
A condición pure::variants pódese usar para incluír ou excluír seccións de a file dependendo da selección dunha característica. O indexador de condicións busca tales regras e extrae as funcións referenciadas. Se tal característica está seleccionada no editor Relacións View mostrará todo files e liñas onde se atopa unha condición coa característica seleccionada (consulte a Figura 6, “Representación dunha condición nas relacións View").
Figura 6. Representación dunha condición nas relacións ViewPara obter unha explicación detallada sobre como definir as condicións, consulte a sección ps:condtext do capítulo 9.5.7 da Guía do usuario de pure::variants (Referencia–>Tipos de elementos fonte predefinidos–>ps:condtext).
Constantes do preprocesador C/C++
O indexador do preprocesador C/C++ analiza files para as constantes usadas nas regras do preprocesador (por exemplo, #ifdef, #ifndef, …).
Se é ps:flag ou ps:flagfile se selecciona o elemento Relacións View mostra o uso da constante de preprocesador definida.
As Relacións View tamén mostra as constantes do preprocesador conectadas a características mediante o uso de patróns de mapeo. Para iso amplíanse os patróns cos datos da característica seleccionada. Os símbolos resultantes úsanse para buscar constantes do preprocesador coincidentes. Figura 7, “Representación dunha constante do preprocesador C/C++ nas relacións View” amosa un example co patrón fame{Nome}. O patrón amplíase co nome único da función a fameNative. No código indexado hai 76 localizacións onde se usa a constante do preprocesador fameNative.
Estes lugares móstranse nas Relacións View. Os patróns pódense definir nas preferencias (consulte a Sección 3.3, "As preferencias").
Figura 7. Representación dunha constante do preprocesador C/C++ nas relacións View

3.3. As Preferencias
Para cambiar o comportamento predeterminado do indexador, abra as preferencias de Eclipse e seleccione a páxina do indexador de relacións na categoría Xestión de variantes. A páxina mostra dúas listas.
Figura 8. Páxina de preferencias do indexador de relaciónsA lista superior contén o valor predeterminado file patróns para o indexador (1). Esta lista é a configuración inicial do patrón para proxectos recentemente activados.
A lista inferior contén a correspondencia entre as características e as constantes do preprocesador (2). Este mapeo úsase para todos os proxectos. A Táboa 1, "Substitucións de mapas compatibles" mostra todas as substitucións posibles.
Táboa 1. Substitucións de cartografía admitidas

Comodín	Descrición	Example: Característica A
Nome	o Nome único da característica seleccionada	FLAG_{Nome} – FLAG_FeatureA
NOME	o Nome único en maiúscula da característica seleccionada	FLAG_{NAME} – FLAG_FEATUREA
nome	a minúscula Nome único da característica seleccionada	bandeira_{nome} – característica_bandeira

Documentos/Recursos

Conector pure-systems 2024 para software de xestión de código fonte [pdfManual do usuario 2024, 2024 Conector para software de xestión de código fonte, conector para software de xestión de código fonte, software de xestión de código fonte, software de xestión, software

Referencias

• Manual de usuario