> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XBOX 개발용 Visual Studio 속성

> XBOX 개발용 Visual Studio 속성

Microsoft Game Development Kit (GDK)에는 XBOX 프로젝트를 구성하는 데 사용되는 사용자 지정 Visual Studio 속성 페이지가 포함되어 있습니다.

#### XBOX 속성 페이지에 액세스하려면

1. **솔루션 탐색기**에서 프로젝트 이름을 마우스 오른쪽 버튼으로 클릭한 다음 **속성**을 선택합니다.
2. **구성 속성**을 확장합니다.
3. **XBOX General**, **XBOX Deploy**, **XBOX Layout** 및 **Debugging** 속성 페이지를 확인합니다.

다음 **XBOX** 및 관련 속성 페이지를 사용할 수 있습니다.

* [XBOX General](#general)
* [XBOX Deploy](#deploy)
* [XBOX Layout](#layout)
* [Debugging](#debugging)
* [관련 속성 페이지](#related)
* [Game Dependency Lookup](#gamedependency)

<a id="general" />

## XBOX General

**XBOX General** 속성 페이지에는 다음 속성이 포함되어 있습니다.

* **Gaming Edition Target.** 프로젝트가 빌드될 GDK 에디션을 지정합니다. 개발 PC에 설치된 GDK의 최상위 버전이 기본값입니다.
* **Gaming Extension Libraries.** 사용할 Gaming Extension 라이브러리 집합(예: Xbox.Services.API.C)을 지정합니다.
* **Alternate Binary Subdirectory** 이 선택적 속성은 게임 루트 아래에서 바이너리 및 CRT 종속성용 하위 디렉터리를 지정하는 데 사용됩니다. Layout 폴더의 구조를 미러링하는 데 사용되며, 디버깅 시 디버거가 실행 파일을 찾는 데 활용됩니다. 하위 디렉터리를 지정할 때 MicrosoftGame.config는 여전히 타이틀의 루트에 위치해야 합니다. 실행 파일 위치에 대한 MicrosoftGame.config의 경로 변경 사항도 업데이트해야 합니다.
* **Remote IP Address.** 원격 콘솔 이름 또는 IP 주소를 지정합니다. 이는 빌드된 프로젝트가 배포, 실행 및 디버깅되는 콘솔입니다. 이 속성을 비워두거나 공백으로 설정하면 [Connect (xbconnect.exe)](/tools/tools-console/commandlinetools/xbconnect), [XBOX Manager](/tools/tools-console/xbom/xbom) 또는 [Windows Device Portal](/tools/tools-console/wdp/wdp)에서 지정한 기본 원격 콘솔이 사용됩니다.
* **Package Localization Dir.** 지역화된 셸 리소스를 생성할 때 사용할 프로젝트 디렉터리 기준의 선택적 디렉터리를 지정합니다. 프로젝트에 지역화된 리소스를 추가하는 것에 관한 추가 정보는 [MicrosoftGame.config 지역화](/build/core-features/common/game-config/MicrosoftGameConfig-Localization)를 참조하세요.

**그림 1.   XBOX General 속성 페이지** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_general.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2dd98c01503a3c4b3a5a8fb40167fca2" alt="General property page" width="1162" height="809" data-path="images/gdk/tools/property_page_general.png" />

<Note>
  프로젝트 디렉터리에 *project*.vcxproj와 함께 저장된 *project*.vcxproj.user 파일에서 원격 IP를 지정할 수도 있습니다. 해당 파일은 다음 형식이어야 합니다.
</Note>

```text theme={null}
  <?xml version="1.0" encoding="utf-8"?>  
  <Project ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">  
    <PropertyGroup>  
      <RemoteAddress>10.10.10.10</RemoteAddress>  
    </PropertyGroup>  
  </Project>  
```

위 예제에서 \_10.10.10.10\_은 원격 콘솔 주소로 대체됩니다.

<a id="deploy" />

## XBOX Deploy

**XBOX Deploy** 속성 페이지에서는 각 배포(Deploy) 방식을 선택할 수 있습니다. 선택에 따라 속성 페이지에 서로 다른 옵션이 표시됩니다. 배포에 관한 자세한 내용은 [XBOX 개발 키트로 타이틀 배포하기](/home/setup-install/concepts/deployment)를 참조하세요.

### XBOX Deploy 방식: Push (개발 키트에서 실행)

이 배포 방식은 타이틀을 개발 키트의 폴더(기본값: xD:\Titles)에 배포합니다. 이 배포 방식에는 다음 속성이 포함됩니다.

* **Deployment folder path override.** 개발 키트의 기본 배포 경로를 재정의하는 데 사용되는 선택적 속성입니다.
* **Remove extra files from target device.** 선택 시 프로젝트 빌드 출력의 일부가 아닌(고아) 파일을 콘솔에서 제거하는 선택적 속성입니다.

### XBOX Deploy 방식: External (배포에 Visual Studio를 사용하지 않음)

이 배포 방식은 배포를 외부의 독립적인 메커니즘에 위임합니다. 이 배포 방식에는 다음 속성이 포함됩니다.

* **Title launch string.** 디버깅이 시작될 때(F5) 타이틀을 실행하는 데 사용되는 실행 문자열입니다.
* **Target devkit titles.** 대상 개발 키트에서 현재 프로젝트와 일치하는 타이틀 목록에서 선택하여 타이틀 실행 문자열을 채웁니다.

### XBOX Deploy 방식: Run from PC (네트워크 공유 등록)

이 배포 방식은 개발 키트에서 액세스할 수 있는 네트워크 공유를 통해 개발 PC에서 타이틀을 실행합니다.

* **Network share path override.** Run From PC 배포의 기본 네트워크 공유 경로를 재정의하는 데 사용되는 선택적 속성입니다.
* **Network share username.** 자격 증명(SMB 네트워크 공유)이 필요한 네트워크 공유 위치에 액세스하는 데 사용되는 선택적 속성입니다.
* **Network share password.** 자격 증명(SMB 네트워크 공유)이 필요한 네트워크 공유 위치에 액세스하는 데 사용되는 선택적 속성입니다.

> <img src="https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29" alt="caution" width="11" height="11" data-path="images/gdk/tools/caution.gif" />**주의:** 이 사용자 이름과 암호는 일반 텍스트로 전달되며 로컬에 일반 텍스트로 저장됩니다. 보안을 강화하려면 이 필드를 비워 두고 [XBOX Device Portal (Windows Device Portal on XBOX)](/tools/tools-console/wdp/wdp) 또는 [콘솔의 Developer Home (Dev Home)](/tools/tools-console/devhome/devhome)에 표시된 대로 자격 증명을 관리하세요.

**그림 2.   배포 방식에 따른 XBOX Deploy 속성 페이지** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=2645bd2b57441d389e5d623a215d9602" alt="Deploy property page for Push" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_external.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=6956ecceabb322d6b75dae3477011d39" alt="External의 Deploy 속성 페이지" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_external.png" />

<img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_deploy_rfpc.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=cc068e6967bb903be4e5a6c57149bd2c" alt="Run from PC의 Deploy 속성 페이지" width="1173" height="817" data-path="images/gdk/tools/property_page_deploy_rfpc.png" />

<a id="layout" />

## XBOX Layout

**XBOX Layout** 속성 페이지에는 다음 속성이 포함되어 있습니다.

* **Layout Directory.** 빌드 결과가 배치되는 로컬 디렉터리를 지정합니다. 애플리케이션은 이 디렉터리에서 원격 콘솔로 배포됩니다.
* **Exclusion Filter.** 빌드 출력 디렉터리에서 레이아웃 디렉터리로 복사되지 않을 파일과 파일 형식을 지정합니다. 이 속성은 빌드 출력 디렉터리 외부에 있는 파일을 제외하는 용도로는 사용할 수 없습니다.
* **Isolate Configurations.** **Yes**로 설정하면 Visual Studio가 각 빌드 구성을 별개의 출력으로 취급하여 레이아웃 디렉터리로 복사되는 파일 목록을 결정합니다. 기본값은 **No**입니다.
* **Game OS.** 타이틀의 느슨한 파일 레이아웃과 함께 제공될 Game OS 경로를 지정합니다.
* **Deploy from Outdir.** **Yes**로 설정하면 Visual Studio가 배포 전에 파일을 레이아웃 디렉터리로 복사하지 않고 빌드 출력 디렉터리의 내용을 그대로 배포합니다. **Layout Directory**, **Exclusion Filter**, **Isolate Configurations** 속성 값은 무시됩니다.

**그림 3.   XBOX Layout 속성 페이지** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_layout.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=996357b982ee8d5b00c0ea2b5252398c" alt="Layout property page" width="785" height="545" data-path="images/gdk/tools/property_page_layout.png" />

<a id="debugging" />

## Debugging

**Debugging** 속성 페이지에는 다음 속성이 포함되어 있습니다.

* **Debugger to launch:** XBOX 프로젝트의 경우 **XBOX Game Core Debugger**를 선택합니다.
* **Debugger Type.** 사용할 디버거 유형을 지정합니다. Auto로 설정된 경우, .exe 파일의 내용에 따라 디버거 유형이 선택됩니다.
* **Command Arguments.** 애플리케이션에 전달할 명령줄 인수입니다.
* **Log Module Loading.** 모듈 로딩 정보를 포함한 자세한 디버그 출력을 활성화합니다. **Log Module Loading** 옵션은 "종속 dll을 찾을 수 없음" 문제를 디버깅할 때 유용합니다.

**그림 4.   Debugging 속성 페이지** <img src="https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/property_page_debug.png?fit=max&auto=format&n=6TXzXmujKayly5Sf&q=85&s=76a15961c2b3b73d8fc332052faa57f8" alt="Debugging property page" width="1172" height="812" data-path="images/gdk/tools/property_page_debug.png" />

<a id="related" />

## 관련 속성 페이지

XBOX에 고유하지는 않지만 XBOX 애플리케이션에 필수 또는 권장되는 설정을 갖는 추가 속성이 있습니다. 이러한 설정은 XBOX 애플리케이션이 올바르고 최적으로 작동하도록 하며 다음과 같습니다.

**RandomizedBaseAddress:** **Yes**로 설정해야 하며, 이는 GDK 프로젝트의 기본값입니다. 이 설정은 주소 공간 레이아웃 무작위화(ASLR)가 작동하는 데 필요합니다. XBOX 애플리케이션에는 ASLR이 필요합니다. **RandomizedBaseAddress**를 **No**로 설정하거나 ASLR을 비활성화하려고 시도하지 마세요.

**RandomizedBaseAddress**는 **Linker**/**Advanced** 속성 페이지에서 설정됩니다.

<a id="gamedependency" />

## Game Dependency Lookup

프로젝트 내에서 게임 종속성을 지정하면 로컬 경로 외에도 게임 루트 G: 및 모든 하위 디렉터리에서 종속 파일을 검색합니다.

<a id="ID4EIIAC" />

## 참고 항목

[Application Management (xbapp.exe)](/tools/tools-console/commandlinetools/xbapp)

[Connect (xbconnect.exe)](/tools/tools-console/commandlinetools/xbconnect)

[XBOX 개발 키트로 타이틀 배포하기](/home/setup-install/concepts/deployment)

[방법: Visual Studio를 사용하여 게임 리소스 파일 배포하기](/tools/tools-console/visualstudio/how-to-deploy-resources)


## Related topics

- [Visual Studio 2022 GDK 지원 정보](/ko/tools/tools-console/visualstudio/vs-2022-support-notes.md)
- [Visual Studio 2026 GDK 지원 정보](/ko/tools/tools-console/visualstudio/vs-2026-support-notes.md)
- [XBOX Gaming Project Control](/ko/tools/tools-console/visualstudio/xbox-gaming-project-control.md)
- [Visual Studio를 사용한 XBOX 프로젝트 디버깅](/ko/tools/tools-console/visualstudio/debugging-with-visualstudio.md)
- [XBOX Gaming Explorer](/ko/tools/tools-console/visualstudio/xbox-gaming-explorer.md)