오프라인 색인 작성/가져오기

AIX 및 Linux용 IBM® Rational® Developer에서 제공하는 강력한 C/C++ 시각화 및 편집 기능은 색인이라는 항목에 기반합니다. 이는 기본적으로 프로젝트 코드의 구조에 대한 정보를 저장하는 데이터베이스 파일입니다. 일반적으로 프로젝트 파일을 구문 분석하여 이 색인 데이터베이스를 채우고 나중에 개발 환경의 C/C++ 소스 인식 기능을 사용하는 경우 이 데이터베이스를 부분적으로 사용하여 코드에 대한 정보를 검색합니다. 소스 코드를 구문 분석하고 여기에서 색인을 빌드하는 데 필요한 시간은 프로젝트 크기에 따라 달라집니다. 컴파일할 때 코드를 구문 분석하고 분석하는 방법과 마찬가지로, 소형 프로젝트는 구문 분석하고 색인화하는 데 초 단위의 시간이 걸리지만, 대형 프로젝트는 여러 시간이 걸릴 수 있습니다. AIX 및 Linux용 IBM® Rational® Developer의 소스 인식 기능을 사용하는 데 필요한 시간을 최소화하도록 IDE는 지원되는 원격 시스템의 명령행에서 색인 파일 작성을 지원합니다. 나중에 구문 분석 실행을 기다리지 않고도 컨텐츠로 색인을 미리 채울 수 있도록 이를 IDE에서 가져올 수 있습니다. 이러한 방법으로 팀의 한 사용자가 수동으로 명령행에서 색인 파일을 작성한 후 동료와 공유할 수 있습니다. 또는 자동화된 명령행 빌드 프로세스(예: 야간 빌드 또는 연속 통합 시스템)에서 색인을 생성하여 나중에 개발자가 이를 가져올 수 있습니다.


오프라인 중에 색인 작성

오프라인 색인기는 지원되는 원격 시스템의 AIX 및 Linux용 IBM® Rational® Developer 서버 디렉토리에 있는 offlineIndexer.sh라고 하는 쉘 스크립트로 실행됩니다. 명령 형식은 다음과 같습니다.

offlineIndexer.sh $SOURCE_DIRECTORY_INFULLPATH $OFFLINE_INDEXER_CONFIGFILE_INFULLPATH

여기서 $SOURCE_DIRECTORY_INFULLPATH는 소스 코드 디렉토리에 대한 절대 경로이며, $OFFLINE_INDEXER_CONFIGFILE_INFULLPATH는 오프라인 색인기 구성 특성 파일에 대한 절대 경로입니다(이 파일 형식은 아래에서 설명함).

색인 작성을 완료한 후 오프라인 색인 zip을 소스 코드 디렉토리 아래 .standalone_index 디렉토리에 작성합니다.

오프라인 색인기 구성


오프라인 색인기는 Java 특성 형식(일반적으로 각 행은 PROPERTY=VALUE 형식임)을 준수하는 특성 파일로 구성됩니다. 허용 가능한 특성 목록은 다음 테이블에 나열됩니다. 값이 지정되지 않은 경우 기본값이 나열된 특성은 지정된 값을 수신합니다.

여기에서 템플리트 구성 특성 파일이 제공됩니다(offlineIndex_config.properties).

특성 기본값 설명
offlineIndexer_log_filename 해당사항 없음 진행상태 및 정보를 로그하는 파일에 대한 절대 경로입니다. 기본적으로 로그는 stdout에 출력됩니다.
trace_level 0 로깅 추적 레벨: 0 - 로그 오류 메시지, 1 - 로그 오류 및 정보
build_log_filename 해당사항 없음 빌드 로그 파일에 대한 절대 경로입니다. 오프라인 색인기는 빌드 프로세스에서 지정한 포함 경로 및 매크로를 찾기 위해 이를 구문 분석할 수 있습니다. 이러한 매크로 및 포함 경로를 사용하여 소스 코드가 색인화될 때 구문 분석기를 구성합니다.
build_directory 해당사항 없음 빌드 로그가 생성될 때 사용되는 작업 디렉토리에 대한 절대 경로입니다.
projectScope_language_nature C/C++ 프로젝트의 언어 유형(C/C++ 또는 C)
projectScope_complier_name XL 소스 코드를 빌드하는 데 사용되는 컴파일러입니다. 이는 다른 컴파일러에서 다른 언어의 통용어를 지원할 때 코드를 구문 분석하는 방법에 영향을 줍니다. 허용 가능한 값은 XL 또는 GNU입니다.
compiler_executable_directory XL의 경우 /usr/vacpp/bin/
GNU의 경우 /usr/bin/
컴파일러 실행 파일 디렉토리입니다. 이를 사용하여 매크로 및 포함 경로에 빌드된 컴파일러의 항목을 판별하도록 컴파일러를 호출하기 위해 사용됩니다.
projectScope_includePathes 해당사항 없음 소스 코드를 구문 분석할 때 사용하는 추가 포함 경로입니다.
projectScope_macros   소스 코드를 구문 분석할 때 사용하는 추가 매크로입니다.
projectScope_encoding Cp1252 소스 파일의 유니코드 코드 페이지입니다. 이 설정은 파일별 설정이 설정되지 않은 모든 소스 파일에 대해 사용되는 기본값입니다.
$filename_encoding   개별 파일에 대한 특정 유니코드 코드 페이지 맵핑을 지정합니다. 특성 키의 파일 이름은 색인화할 소스 디렉토리에 대해 상대적이어야 합니다.
indexAllFiles true 빌드 여부와 상관없이 모든 파일의 구문 분석 여부를 표시하는 부울입니다. 허용 가능한 값은 true 및 false입니다.
skipReferences false 색인기가 모든 ID 참조를 건너뛸 것인지 여부를 표시하는 부울입니다. 허용 가능한 값은 true 및 false입니다.
skipTypeReferences false 색인기가 유형 참조를 건너뛸 것인지 여부를 표시하는 부울입니다. 허용 가능한 값은 true 및 false입니다.
skipMacroReferences false 색인기가 매크로 참조를 건너뛸 것인지 여부를 표시하는 부울입니다. 허용 가능한 값은 true 및 false입니다.
SUPPORT_VECTOR_TYPES true 벡터 유형의 XL 컴파일러 언어 확장 기능이 사용 가능한지 여부를 표시하는 부울입니다.
SUPPORT_DECIMAL_FLOATING_POINT_TYPES true 10진수 부동 소수점 유형의 XL 컴파일러 언어 확장 기능이 사용 가능한지 여부를 표시하는 부울입니다.
SUPPORT_COMPLEX_IN_CPP true "복합" 유형의 XL 컴파일러 언어 확장 기능이 사용 가능한지 여부를 표시하는 부울입니다.
SUPPORT_RESTRICT_IN_CPP true "restrict" 키워드에 대한 XL 컴파일러 언어 확장 기능이 사용 가능한지 여부를 표시하는 부울입니다.
SUPPORT_STATIC_ASSERT true 정적 어설션에 대한 XL 컴파일러 언어 확장 기능이 사용 가능한지 여부를 표시하는 부울입니다.

색인 가져오기


색인 파일은 프로젝트 작성 중에 원격 C/C++ 프로젝트로 가져오거나 기존 원격 C/C++ 프로젝트로 가져올 수 있습니다.

  1. 프로젝트 작성 중:

  2. 색인 가져오기

  3. 기존 원격 C/C++ 프로젝트로 색인 가져오기:

  4. 색인 가져오기

  5. 가져오기를 완료하면 색인 가져오기를 완료했음을 확인하도록 메시지 대화 상자가 팝업됩니다.

  6. 가져오기 완료

  7. 참고: 가져오는 색인은 원격 C/C++ 프로젝트와는 다른 설정을 사용하여 작성되었을 수 있습니다. 이 경우 다른 대화 상자 페이지가 나타나 추가 옵션(색인 가져오기를 계속하거나 대신 프로젝트를 다시 색인화함)을 제공합니다.

  8. 다른 설정

  9. 가져오기에 실패하면 대신 색인을 다시 빌드할 것인지 묻는 대화 상자가 팝업됩니다.

  10. 가져오기에 실패함