정적 라이브러리(C++/CX)

UWP(유니버설 Windows 플랫폼) 앱에서 사용되는 정적 라이브러리에는 STL 형식을 비롯한 ISO 표준 C++ 코드와 Windows 런타임 앱 플랫폼에서 제외되지 않은 Win32 API 호출도 포함될 수 있습니다. 정적 라이브러리는 Windows 런타임 구성 요소를 사용하고 특정 제한 사항이 있는 Windows 런타임 구성 요소를 만들 수 있습니다.

정적 라이브러리 만들기

새 프로젝트를 만드는 지침은 설치한 Visual Studio 버전에 따라 달라집니다. 기본 설정된 버전의 Visual Studio에 대한 설명서를 보려면 버전 선택기 컨트롤을 사용하세요. 이 페이지의 목차 맨 위에 있습니다.

Visual Studio에서 UWP 정적 라이브러리를 만들려면

1. 메뉴 모음에서 새 프로젝트 파일을>선택하여 새>프로젝트 만들기 대화 상자를 엽니다.

2. 대화 상자 맨 위에서 언어를 C++로 설정하고, 플랫폼을 Windows로 설정하고, 프로젝트 유형을 UWP로 설정합니다.

3. 필터링된 프로젝트 형식 목록에서 정적 라이브러리(유니버설 Windows - C++/CX)를 선택한 다음, 다음을 선택합니다. 다음 페이지에서 프로젝트 이름을 지정하고 원하는 경우 프로젝트 위치를 지정합니다.

4. 만들기 단추를 선택하여 프로젝트를 만듭니다.

새 정적 라이브러리를 컴파일할 때 UWP 앱에 대해 제외된 Win32 API를 호출하면 컴파일러에서 "식별자를 찾을 수 없습니다."라는 오류 C3861이 발생합니다. Windows 런타임 지원되는 대체 방법을 찾으려면 UWP 앱에서 Windows API에 대한 대안을 참조하세요.

UWP 앱 솔루션에 C++ 정적 라이브러리 프로젝트를 추가하는 경우 UWP 지원 속성이 Yes로 설정되도록 라이브러리 프로젝트의 속성 설정을 업데이트해야 할 수 있습니다. 이 설정이 없으면 코드가 빌드되고 링크되지만 Microsoft Store용 앱을 확인하려고 하면 오류가 발생합니다. 정적 lib는 해당 lib를 사용하는 프로젝트와 동일한 컴파일러 설정을 사용하여 컴파일해야 합니다.

public ref 클래스, 공용 인터페이스 클래스 또는 공용 값 클래스를 만드는 정적 라이브러리를 사용하면 링커가 다음과 같은 경고를 발생시킵니다.

경고 LNK4264: /ZW를 사용하여 컴파일된 개체 파일을 정적 라이브러리에 보관합니다. Windows 런타임 형식을 작성할 때는 Windows 런타임 메타데이터가 포함된 정적 라이브러리와 연결하지 않는 것이 좋습니다.

정적 라이브러리가 라이브러리 자체 외부에서 사용되는 Windows 런타임 구성 요소를 생성하지 않는 경우에만 경고를 안전하게 무시할 수 있습니다. 라이브러리가 정의하는 구성 요소를 소비하지 않는 경우 퍼블릭 메타데이터에 형식 정보가 포함되어 있더라도 링커는 구현을 최적화할 수 있습니다. 즉, 정적 라이브러리의 공용 구성 요소는 컴파일되지만 런타임에 활성화되지 않습니다. 이러한 이유로 다른 구성 요소 또는 앱에서 사용할 Windows 런타임 구성 요소는 DLL(동적 연결 라이브러리)에서 구현되어야 합니다.

참고 항목

스레딩 및 마샬링