pure-systems 2024 소스 코드 관리 소프트웨어 사용자 매뉴얼을 위한 커넥터

pure::variants – 커넥터
소스코드 관리 매뉴얼
파라메트릭 테크놀로지 GmbH
pure::variants 6.0.7.685용 버전 6.0
저작권 © 2003-2024 Parametric Technology GmbH
2024

내용물 숨다

소개

pure::variants Connector for Source Code Management(Connector)를 사용하면 개발자가 pure::variants를 사용하여 소스 코드 가변성을 관리할 수 있습니다. pure::variants의 소스 코드 관리 기능은 디렉토리 구조와 소스 코드를 동기화할 수 있는 유연한 기회를 제공합니다. filepure::variants 모델을 사용하면 쉽게 가능합니다. 따라서 변형 관리가 복잡한 소프트웨어 프로젝트에도 실용적으로 적용될 수 있습니다. 또한 pure::variants 기능과 소스 코드 간의 연결은 빌더를 사용하여 더 쉽게 관리할 수 있으며 소스 코드 관리를 통해 매우 쉽게 접근할 수 있습니다.
1.1. 소프트웨어 요구 사항
소스 코드 관리를 위한 pure::variants 커넥터는 pure::variants를 위한 확장 기능이며 지원되는 모든 플랫폼에서 사용할 수 있습니다.
1.2. 설치
커넥터 설치 방법에 대한 자세한 내용은 pure::variants 설정 가이드의 pure::variants 커넥터 섹션을 참조하십시오(메뉴 도움말 -> 도움말 콘텐츠 및 pure::variants 설정 가이드 -> pure::variants 커넥터).
1.3. 본 매뉴얼에 대하여
독자는 pure::variants에 대한 기본 지식과 경험이 있어야 합니다. 이 매뉴얼을 읽기 전에 소개 자료를 참조하세요. 매뉴얼은 온라인 도움말과 인쇄 가능한 PDF 형식으로 여기에서 제공됩니다.

커넥터 사용

2.1. pure::variants 시작
사용한 설치 방법에 따라 pure::variants가 활성화된 Eclipse를 시작하거나 Windows에서는 프로그램 메뉴에서 pure::variants 항목을 선택합니다.
변형 관리 관점이 아직 활성화되지 않은 경우 창 메뉴에서 관점 열기->기타…를 선택하여 활성화합니다.
2.2. 디렉토리 트리를 패밀리 모델로 가져오기
디렉토리 트리를 패밀리 모델로 가져오기 전에 변형 프로젝트를 만들어야 합니다. 또한 피처 모델에 이미 정의된 피처가 있는 것이 좋습니다. 이러한 단계에 대한 도움말은 pure::variants 설명서를 참조하십시오.
실제 가져오기는 프로젝트의 컨텍스트 메뉴에서 가져오기… 작업을 선택하여 시작됩니다. view 또는 가져오기… 메뉴를 사용하여 File 메뉴. Variant Management 범주에서 Variant Models 또는 Projects를 선택하고 Next를 누릅니다. 다음 페이지에서 Import a Family Model from source folder를 선택하고 Next를 다시 누릅니다.
가져올 소스 코드 유형을 선택하세요
가져오기 마법사가 나타납니다(그림 1, "가져올 수 있는 소스 코드 유형을 선택하는 가져오기 마법사 페이지" 참조). 가져올 프로젝트 유형을 선택하고 다음을 누릅니다. 각 유형에는 사전 정의된 다음 세트가 포함됩니다. file 모델로 가져올 유형.
그림 1. 가져올 수 있는 소스 코드 유형을 선택하는 가져오기 마법사 페이지소스 및 타겟 선택
다음 마법사 페이지에서 (그림 2, “가져오기 마법사의 소스 및 대상을 선택하는 페이지”) 소스 디렉토리와 대상 모델을 지정해야 합니다.
Browse… 버튼을 눌러 가져올 소스 코드가 있는 디렉토리를 선택합니다. 기본적으로 현재 작업 공간이 선택되어 있는데, 이는 탐색을 시작하기에 유용한 지점일 수 있기 때문입니다.
아래에서 포함 및 제외 패턴을 지정할 수 있습니다. 이러한 패턴은 Java 정규 표현식이어야 합니다. 소스 루트 폴더를 기준으로 한 각 입력 경로는 이러한 패턴으로 검사됩니다. 포함 패턴이 일치하면 폴더가 가져오고 제외 패턴이 일치하지 않으면 가져옵니다. 즉, 포함 패턴은 가져올 폴더를 미리 선택하고 제외 패턴은 이 미리 선택을 제한합니다.
소스 코드 디렉토리를 선택한 후 대상 모델을 정의해야 합니다. 따라서 변형 프로젝트나 모델을 저장할 폴더를 선택하고 모델 이름을 입력합니다. file 이 대화 상자에서 지정하지 않으면 이름은 .ccfm 확장자로 자동 확장됩니다. 기본적으로 모델 이름과 동일한 이름으로 설정됩니다. 이것이 권장 설정입니다.
적절한 소스 폴더와 원하는 모델 이름을 지정한 후 Finish를 눌러 대화 상자를 마칠 수 있습니다. Next 버튼을 누르면 추가 설정을 할 수 있는 추가 페이지가 나옵니다.
그림 2. 가져오기 마법사의 페이지는 가져오기에 대한 소스와 대상을 선택합니다.가져오기 환경 설정 변경
마지막 마법사 페이지에서 (그림 3, 개별 구성을 정의하기 위한 가져오기 마법사 페이지”) 가져온 소프트웨어 프로젝트에 대한 가져오기 동작을 사용자 지정하기 위해 수행할 수 있는 기본 설정이 있습니다.
대화 상자 페이지에는 다음이 포함된 표가 표시됩니다. file 정의된 유형은 가져오기 프로세스에서 고려됩니다.
각 줄은 4개의 필드로 구성됩니다.

설명 필드에는 식별을 위한 짧은 설명 텍스트가 포함되어 있습니다. file 유형.
그만큼 File 이름 패턴 필드는 선택에 사용됩니다. file필드 값과 일치할 때 가져올 s입니다. 필드는 다음 구문을 사용합니다.

가장 일반적인 사용 사례는 다음과 같습니다. file 확장자입니다. 일반적인 구문은 .EXT이며 여기서 EXT는 원하는 확장자입니다. file 확장자(예: .java).
또 다른 일반적인 상황은 특별한 것입니다 file, 만드는 것과 같다file. 따라서 정확한 일치가 가능합니다. file 이름. 이렇게 하려면 다음을 입력하기만 하면 됩니다. file 필드에 이름을 입력합니다(예: build.xml).

어떤 경우에는 매핑 요구 사항이 더 구체적이므로 file특수 패턴과 일치하는 s를 가져와야 합니다. 이 요구 사항을 충족하려면 정규 표현식을 사용할 수 있습니다. File 이름 패턴 필드.
정규 표현식의 구문을 설명하는 것은 이 도움말의 의도를 넘어섭니다. pure::variants 사용자 가이드의 참조 장의 정규 표현식 섹션을 참조하세요(예: .*).

Mapped 요소 유형 필드는 다음 간의 매핑을 설정합니다. file 유형 및 pure::variants 패밀리 요소 유형. 패밀리 요소 유형은 소스에 대한 설명자입니다. file 가져온 모델의 매핑된 요소에 추가 정보를 제공합니다. 일반적인 선택은 ps:class 또는 ps:make입니다.file.

매핑된 file 유형 필드는 매핑을 설정합니다. file 유형 및 pure::variants file 유형. file pure::variants의 유형은 소스에 대한 설명자입니다. file 가져온 모델의 매핑된 요소에 추가 정보를 제공합니다. 일반적인 선택은 구현의 경우 impl, 정의의 경우 def입니다. files.

그림 3. 개별 구성을 정의하기 위한 가져오기 마법사 페이지새로운 file 매핑 추가 버튼을 사용하여 유형을 추가할 수 있습니다. 모든 필드는 정의되지 않은 값으로 채워지며 사용자가 채워야 합니다. 필드의 값을 편집하려면 마우스로 필드를 클릭하기만 하면 됩니다. 값이 편집 가능해지고 변경할 수 있습니다. 기본값을 변경할 수 없습니다. file 테이블의 이름 패턴입니다. 사용자 정의를 유연하게 하려면 다음을 선택 취소할 수 있습니다. file 행 선택을 해제하여 입력합니다. 선택 해제됨 file 이름 패턴은 구성에 남아 있지만 임포터에서는 사용되지 않습니다. 사용자 정의 file 매핑 제거 버튼을 사용하면 유형을 다시 제거할 수 있습니다.
기본적으로 다른 files file 이름 패턴은 테이블에서 사용할 수 있지만 선택이 해제되었습니다. 일반적으로 모든 것을 가져오고 싶지 않습니다. file하지만 해당 행을 선택하면 쉽게 변경할 수 있습니다.
가져오기 프로그램의 동작을 사용자 정의하기 위한 세 가지 일반적인 가져오기 옵션이 있습니다.

일치하지 않는 디렉토리를 가져오지 마십시오. files (예: CVS 디렉토리).
가져오기 프로그램이 일치하는 디렉토리가 없는 디렉토리를 찾은 경우 file 그 안에 있고 일치하는 하위 디렉토리가 없는 경우 file, 디렉토리는 가져오지 않습니다. 이는 프로젝트가 CVS와 같은 버전 관리 시스템에 의해 관리되는 경우 종종 유용합니다. CVS의 경우 각 관련 디렉토리에는 관련 없는 디렉토리가 있는 CVS 디렉토리가 포함됩니다. files가 저장됩니다. 이 옵션을 선택하고 CVS-files는 어느 것과도 일치하지 않습니다 file 위에 정의된 유형으로 인해 디렉토리가 패밀리 모델에 구성요소로 가져오지 않습니다.
종류 files 및 디렉토리.
이 옵션을 활성화하여 정렬합니다. file각 디렉토리는 알파벳순으로 정리되어 있습니다.

경로 처리 가져오기.
추가 동기화를 위해 가져오기 프로그램은 가져온 모든 요소의 원래 경로를 모델에 저장해야 합니다.
많은 경우 패밀리 모델은 다른 사용자와 공유됩니다. 디렉토리 구조는 사용자마다 다를 수 있습니다. 가장 일반적인 사용 시나리오를 지원하기 위해 임포터는 다양한 모드에서 작업할 수 있습니다.

순수한	가져온 요소의 절대 경로는 모델에 저장됩니다. 이후 동기화 및 변환 중에 file첫 번째 가져올 때와 정확히 동일한 위치에 배치해야 합니다.
작업공간에 대한 상대적	경로는 작업 공간 폴더를 기준으로 저장됩니다. 동기화를 위해 files는 Eclipse 작업공간의 일부여야 합니다. 변환은 Eclipse 작업공간을 입력 디렉토리로 사용해야 합니다.
프로젝트와 관련하여	경로는 프로젝트를 기준으로 저장됩니다. 동기화를 위해 files는 Eclipse 내부의 프로젝트의 일부입니다. 변환은 프로젝트 폴더를 입력 디렉토리로 사용해야 합니다.
경로에 대한 상대적	경로는 주어진 경로에 상대적으로 저장됩니다. 동기화를 위해 files는 정확히 같은 위치에 배치해야 합니다. 변환 입력 디렉토리는 가져오기 중 상대 경로와 동일합니다.

이 대화 상자의 모든 기본 설정은 영구적으로 저장됩니다. 개인 사용자 지정은 가져오기가 실행될 때마다 다시 실행해서는 안 됩니다. 이렇게 하면 가져오기 워크플로가 쉽고 빠릅니다.
2.3. 디렉토리 트리에서 모델 업데이트
동기화 버튼을 누르세요 가져온 모델을 디렉토리 경로와 동기화합니다. 프로젝트의 루트 경로는 모델에 저장되므로 이전과 동일한 디렉토리에 동기화됩니다. 동기화 버튼을 활성화하려면 모델을 열고 요소를 선택합니다. 동기화 버튼을 누르면 현재 패밀리 모델과 현재 디렉토리 구조의 모델이 반대되는 비교 편집기가 열립니다(그림 4, "비교 편집기에서 디렉토리 트리의 모델 업데이트" 참조).
그림 4. Compare Editor의 디렉토리 트리에서 모델 업데이트 비교 편집기는 pure::variants 전반에 걸쳐 모델 버전을 비교하는 데 사용되지만 이 경우 물리적 디렉토리 구조(오른쪽 하단에 표시됨)를 현재 pure::variants 모델(왼쪽 하단에 표시됨)과 비교하는 데 사용됩니다. 모든 변경 사항은 영향을 받는 요소별로 정렬되어 편집기 상단에 별도 항목으로 나열됩니다.
이 목록에서 항목을 선택하면 두 모델 모두의 해당 변경 사항이 강조 표시됩니다. example, 추가된 요소는 오른쪽에 상자로 표시되고 왼쪽에 있는 모델에서 실행 가능한 위치와 연결됩니다. 위쪽과 아래쪽 편집기 창 사이의 Merge 툴바는 디렉토리 트리 모델에서 Feature Model로 단일 또는 모든(충돌하지 않는) 변경 사항을 전체적으로 복사하는 도구를 제공합니다.
메모
동기화는 마지막으로 사용된 임포터 설정으로 수행됩니다. 이를 통해 임포트가 수행되는 동안 만들어진 다른 설정으로 모델을 업데이트할 수 있습니다.

관계 인덱서 사용

소스 코드 관리를 위한 커넥터는 관계를 강화합니다. View pure::variants 모델 요소와 소스 코드 간의 연결에 대한 정보가 포함되어 있습니다. ps:condxml 및 ps:condtext 요소의 조건에서 사용되는 기능에 대한 관계가 추가되었습니다.
ps:flag 및 ps:flag의 경우file C/C++ 소스에서 전처리기 상수의 위치 요소 files가 표시됩니다. 또한, 기능 고유 이름과 전처리기 상수 간의 매핑을 사용하여 선택된 기능에 대한 일치하는 전처리기 상수의 위치가 표시됩니다.
3.1. 프로젝트에 관계 인덱서 추가
관계 인덱서는 특수 프로젝트 속성 페이지에서 활성화할 수 있습니다. 프로젝트를 선택하고 컨텍스트 메뉴에서 속성 항목을 선택합니다. 다음 대화 상자에서 관계 인덱서 페이지를 선택합니다.
그림 5. 관계 인덱서의 프로젝트 속성 페이지

프로젝트에 대한 관계 인덱서는 Enable Relation Indexer 옵션(1)을 선택하여 활성화됩니다. 인덱서를 활성화한 후에는 프로젝트별 동작을 정의하기 위한 몇 가지 옵션이 더 있습니다. pure::variants Conditions 및 C/C++ Preprocessor Constants의 인덱싱은 별도로 활성화할 수 있습니다(2). file 이름 패턴(3)을 사용하여 선택합니다. file인덱싱을 위한 s. 오직 file패턴 중 하나와 일치하는 s가 스캔됩니다. 모든 패턴을 스캔하려면 패턴으로 "*"를 추가합니다. file프로젝트의 s.
프로젝트에 대한 인덱서를 활성화한 후 빌더가 프로젝트에 추가됩니다. 이 빌더는 변경된 내용을 스캔합니다. filepure::variants 모델 요소에 대한 새로운 관계를 자동으로 생성합니다.
3.2. 소스 코드와의 관계
활성화된 관계 인덱서를 사용하면 관계가 View 추가 항목이 포함되어 있습니다. 이 항목은 다음 이름을 표시합니다. file 그리고 변형점의 줄 번호. 도구 설명은 해당 섹션을 보여줍니다. file. 항목을 두 번 클릭하면 file 편집기에서 열립니다.
pure::variants 조건
pure::variants 조건은 섹션을 포함하거나 제외하는 데 사용할 수 있습니다. file 기능 선택에 따라 다릅니다. 조건 인덱서는 이러한 규칙을 스캔하고 참조된 기능을 추출합니다. 편집기에서 이러한 기능이 선택된 경우 관계 View 모두 보여줄 것이다 file선택된 기능이 있는 조건이 있는 s 및 라인(그림 6, "관계의 조건 표현" 참조) View”).
그림 6. 관계의 조건 표현 View조건을 정의하는 방법에 대한 자세한 설명을 보려면 pure::variants 사용자 가이드의 9.5.7장 ps:condtext 섹션을 참조하세요(참조–>미리 정의된 소스 요소 유형–>ps:condtext).
C/C++ 전처리기 상수
C/C++ 전처리기 인덱서 스캔 file전처리기 규칙에 사용되는 상수(예: #ifdef, #ifndef, ...)를 나타냅니다.
ps:flag 또는 ps:flag인 경우file 요소가 선택되었습니다 관계 View 정의된 전처리기 상수의 사용법을 보여줍니다.
관계 View 또한 매핑 패턴을 사용하여 피처에 연결된 전처리기 상수를 보여줍니다. 이를 위해 패턴은 선택된 피처의 데이터로 확장됩니다. 결과 심볼은 일치하는 전처리기 상수를 검색하는 데 사용됩니다. 그림 7, "관계에서 C/C++ 전처리기 상수의 표현" View”는 전직을 보여줍니다ample는 fame{Name} 패턴을 사용합니다. 패턴은 기능의 고유한 이름을 fameNative로 확장합니다. 색인된 코드에는 전처리기 상수 fameNative가 사용되는 위치가 76개 있습니다.
이 위치는 관계에 표시됩니다. View. 패턴은 환경 설정에서 정의할 수 있습니다(섹션 3.3, "환경 설정" 참조).
그림 7. 관계에서 C/C++ 전처리기 상수의 표현 View

3.3. 선호사항
인덱서의 기본 동작을 변경하려면 Eclipse 환경 설정을 열고 Variant Management 범주에서 Relation Indexer 페이지를 선택합니다. 페이지에 두 개의 목록이 표시됩니다.
그림 8. 관계 인덱서 기본 설정 페이지위 목록에는 기본값이 포함되어 있습니다 file 인덱서(1)에 대한 패턴입니다. 이 목록은 새로 활성화된 프로젝트에 대한 초기 패턴 설정입니다.
아래 목록에는 기능과 전처리기 상수(2) 간의 매핑이 포함되어 있습니다. 이 매핑은 모든 프로젝트에 사용됩니다. 표 1, "지원되는 매핑 대체"는 모든 가능한 대체를 보여줍니다.
표 1. 지원되는 매핑 교체

와일드카드	설명	Example: FeatureA
이름	선택된 기능의 고유 이름	FLAG_{이름} – FLAG_기능A
이름	선택한 기능의 대문자 고유 이름	플래그_{이름} – 플래그_특징A
이름	선택된 기능의 소문자 고유 이름	플래그_{이름} – 플래그_특징a