IXtfApplicationClient::DebugEnable
지정된 패키지 이름을 사용하여 앱 패키지에 대한 디버깅을 활성화하거나 비활성화합니다.
구문
public:
HRESULT DebugEnable(
LPCWSTR pszPackageMoniker,
BOOL fEnable
)
매개 변수
pszPackageMoniker
형식: LPCWSTR
앱의 패키지 모니커에 대한 포인터입니다.
fEnable
형식: BOOL
디버깅을 사용하도록 설정하려면 TRUE를 지정하고, 디버깅을 사용하지 않도록 설정하려면 FALSE를 지정합니다.
반환 값
형식: HRESULT
성공한 경우 S_OK을(를) 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
비고
참고 항목
이 방법은 Xbox One 소프트웨어 개발 키트\ERA 타이틀에만 적용됩니다. 이 메서드를 호출해도 Microsoft GDK(게임 개발 키트) 타이틀에는 영향을 주지 않습니다.
이 메서드는 pszPackageMoniker에 지정된 패키지 모니커를 사용하여 앱 패키지에 대해 디버깅을 사용하거나 사용하지 않도록 설정하며, 각각 해당 패키지에 대해 디버그 플래그를 설정하거나 해제합니다.
참고 항목
패키지가 실행되지 않는 경우에만 패키지에 대해 디버그 플래그를 설정해야 합니다. 실행 중인 패키지에서 디버그 플래그를 설정하면 예측할 수 없는 결과가 발생할 수 있습니다.
앱 패키지에 대해 디버그 플래그를 설정하면 앱 패키지의 모든 앱에 다음 효과가 적용됩니다.
- 활성화를 완료하는 데 45초 이상 소요되어도 앱이 종료되지 않습니다.
- 일시 중단하는 시간이 너무 오래 걸려도 앱이 종료되지 않습니다. 전용 앱의 경우 1초, 공유 앱의 경우 5초로 제한됩니다.
- 너무 오랫동안 표시되지 않으면 앱이 일시 중단되지 않습니다. 전용 앱의 경우 10분, 공유 앱의 경우 5초로 제한됩니다.
- 앱을 일시 중단하려면 xbapp suspend(NDA 항목)권한 부여 필요 명령을 호출하거나 IXtfApplicationClient::Suspend 함수를 호출합니다.
- 앱이 디버그 모드에 있을 때는 일반적인 PLM(프로세스 수명 관리) 제한이 적용되지 않으며, 사용자가 XTF(Xbox 도구 프레임워크) 도구를 사용하여 직접 작업을 수행하는 경우에만 일시 중단되거나 다시 시작됩니다.
참고 항목
디버그 모드에서는 일반적인 PLM 프로세스로 인해 앱이 일시 중단되지 않는 상태(예: 표시된 상태)로 앱을 일시 중단할 수 있습니다. 앱이 디버그 모드로 실행되는 동안 일시 중단 및 다시 시작 동작을 테스트할 때는 디버그 모드로 실행의 효과가 아니라 일반적인 동작을 테스트하도록 주의해야 합니다.
앱 패키지에 대해 디버그 플래그를 해제하면 앱 패키지의 앱에 다음 효과가 적용됩니다.
- 활성화를 완료하는 데 45초 이상 소요되면 앱이 종료됩니다.
- 일시 중단하는 시간이 너무 오래 걸리면 앱이 종료됩니다. 전용 앱의 경우 1초, 공유 앱의 경우 5초로 제한됩니다.
- 너무 오랫동안 표시되지 않으면 앱이 일시 중단됩니다. 전용 앱의 경우 10분, 공유 앱의 경우 5초로 제한됩니다.
디버그 플래그의 상태는 패키지 전체에 적용됩니다. 디버그 플래그가 설정된 상태의 단일 패키지에 여러 앱이 있으면, 모든 앱이 디버그 모드로 실행됩니다.
개발 키트를 다시 부팅하면 디버그 플래그가 지워집니다.
디버거가 앱 프로세스에 연결된 Visual Studio에서 F5 키(디버그 > 디버깅 시작)를 눌러 앱을 실행하면 앱이 실행되기 전에 디버그 플래그가 자동으로 설정되고 앱이 종료된 후 플래그가 지워집니다. 디버거를 앱 프로세스에 연결하지 않고 Ctrl+F5 키(디버그 > 디버깅 없이 시작)를 눌러 앱을 실행하면 앱이 실행되기 전에 디버그 플래그가 지워지고 앱이 종료된 후 플래그가 지워진 상태로 유지됩니다. 앱이 디버그 모드에서 충돌하고 Visual Studio가 앱에 연결되어 있으면 Visual Studio는 앱에서 분리될 때 디버그 플래그를 지웁니다.
다음 상황에서는 디버그 플래그 상태가 설정된 상태로 유지됩니다.
- 앱 충돌 시 Visual Studio 디버거가 연결되어 있지 않은 경우.
- 작업을 일시 중단했다가 다시 시작하는 경우.
- 종료 시 Visual Studio 디버거가 연결되어 있지 않은 경우.
게임 수명 주기 상태에 대한 자세한 내용은 Xbox 게임 수명 주기(NDA 항목)권한 부여 필요를 참조하세요.
요구 사항
헤더: xtfapplication.h
라이브러리: xtfapplication.lib
지원되는 플랫폼: Windows(Xbox 콘솔 도구용)