프로젝트 구성 개체

프로젝트 구성 개체는 UI에 대한 구성 정보의 표시를 관리합니다.

Visual Studio 프로젝트 구성

프로젝트 구성 속성 페이지

프로젝트 구성 공급자는 프로젝트 구성을 관리합니다. 환경 및 기타 패키지는 프로젝트 구성에 대한 액세스 권한을 얻고 정보를 검색하려면 프로젝트 구성 공급자 개체에 연결된 인터페이스를 호출합니다.

참고 항목

솔루션 구성 파일은 프로그래밍 방식으로 만들거나 편집할 수 없습니다. DTE.SolutionBuilder을 사용해야 합니다. 자세한 내용은 솔루션 구성을 참조하세요.

구성 UI에 사용할 표시 이름을 게시하려면 프로젝트에서 get_DisplayName을 구현해야 합니다. 환경은 환경의 UI에 나열될 구성 및 플랫폼 정보의 표시 이름을 가져오는 데 사용할 수 있는 IVsCfg 포인터 목록을 반환하는 GetCfgs를 호출합니다. 활성 구성 및 플랫폼은 활성 솔루션 구성에 저장된 프로젝트 구성에 따라 결정됩니다. FindActiveProjectCfg 메서드를 사용하여 활성 프로젝트 구성을 검색할 수 있습니다.

IVsProjectCfgProvider 개체는 표준 프로젝트 구성 이름을 기반으로 IVsProjectCfg2 개체를 검색할 수 있도록 IVsCfgProviderEventsHelper 개체와 함께 IVsCfgProvider2 개체에 선택적으로 구현될 수 있습니다.

환경 및 기타 프로젝트에 프로젝트 구성에 대한 액세스 권한을 제공하는 또 다른 방법은 프로젝트에서 하나 이상의 구성 개체를 반환하는 IVsCfgProvider2::GetCfgs 메서드의 구현을 제공하는 것입니다. 프로젝트는 구성별 정보를 제공하기 위해 IVsProjectCfg 및 이에 따라 IVsCfg에서 상속하는 IVsProjectCfg2을 구현할 수도 있습니다. IVsCfgProvider2는 프로젝트 구성 추가, 삭제 및 이름 바꾸기를 위한 플랫폼 및 기능을 지원합니다.

참고 항목

Visual Studio는 더 이상 두 가지 구성 유형으로 제한되지 않으므로 구성을 처리하는 코드는 구성 수에 대한 가정으로 작성되어서는 안 되며, 하나의 구성만 있는 프로젝트가 반드시 디버그 또는 정품이라는 가정으로 작성되어서도 안 됩니다. 이로 인해 get_IsReleaseOnlyget_IsDebugOnly 사용이 더 이상 사용되지 않습니다.

검색에서 반환된 개체를 IVsGetCfgProvider::GetCfgProvider 호출 QueryInterface 합니다IVsCfgProvider2. IVsProject3 프로젝트 개체에서 QueryInterface를 호출하여 IVsGetCfgProvider를 찾을 수 없는 경우 IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_BrowseObject)에 대해 반환된 개체의 계층 루트 브라우저 개체에서 QueryInterface를 호출하거나 IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_ConfigurationProvider)를 통해 구성 제공자 개체에 액세스할 수 있습니다.

IVsProjectCfg2는 주로 빌드, 디버그 및 배포 관리 개체에 대한 액세스를 제공하고 프로젝트에서 출력을 자유롭게 그룹화할 수 있습니다. IVsProjectCfgIVsProjectCfg2 메서드를 사용하여 빌드 프로세스를 관리하기 위한 IVsBuildableProjectCfg과 구성의 출력 그룹에 대한 IVsOutputGroup 포인터를 구현할 수 있습니다.

그룹에 포함된 출력 수가 구성마다 다를 수 있지만 프로젝트는 지원하는 각 구성에 대해 동일한 수의 그룹을 반환해야 합니다. 또한 그룹은 프로젝트 내의 구성에서 구성에 이르기까지 식별자 정보(정식 이름, 표시 이름, 그룹 정보)를 포함해야 합니다. 자세한 내용은 출력에 대한 프로젝트 구성을 참조하세요.

디버깅을 사용하도록 설정하려면 구성에서 IVsDebuggableProjectCfg를 구현해야 합니다. IVsDebuggableProjectCfg는 디버거가 구성을 시작할 수 있도록 프로젝트에서 구현한 선택적 인터페이스이며 IVsCfgIVsProjectCfg을 사용하여 구성 개체에서 구현됩니다. 사용자가 F5 키를 눌러 디버거를 시작하도록 선택하면 환경에서 이를 호출합니다.

ISpecifyPropertyPagesIDispatch는 속성 페이지와 함께 사용되어 사용자에게 구성 종속 정보를 검색하고 표시합니다. 자세한 내용은 속성 페이지를 참조하세요.

참고 항목