패키징 확장을 사용하여 데스크톱 앱을 Windows와 통합
데스크톱 앱이 패키지된 경우(런타임에 패키지 ID가 있음) 확장 프로그램을 사용하여 패키지 매니페스트 미리 정의된확장을 사용하여 앱을 Windows와 통합할 수 있습니다. 패키지 식별 ID 이 필요한 기능도 참조하세요.
예를 들어 확장을 사용하여 방화벽 예외를 만듭니다. 앱을 파일 형식의 기본 애플리케이션으로 만듭니다. 또는 시작 타일을 앱으로 가리킵니다. 확장을 사용하려면 앱의 패키지 매니페스트 파일에 XML을 추가하기만 하면 됩니다. 코드가 필요하지 않습니다.
이 항목에서는 이러한 확장과 확장을 사용하여 수행할 수 있는 작업에 대해 설명합니다.
메모
이 항목에 설명된 기능을 사용하려면 앱이 패키지되어야 합니다(런타임에 패키지 ID 포함). 여기에는 패키지된 앱(패키지된 WinUI 3 데스크톱 앱새 프로젝트 만들기 참조) 및 외부 위치가 있는 패키지된 앱이 포함됩니다(외부 위치패키징하여 패키지 ID 부여 참조). 기능 중 패키지 ID을 필요로 하는 것도 참조하세요.
사용자를 앱으로 전환
사용자가 패키지된 앱으로 전환하는 데 도움이 됩니다.
- 기존 데스크톱 앱을 패키지된 앱으로 리디렉션하기
- 기존 시작 타일과 작업 표시줄 단추를 패키지된 앱으로 연결합니다
- 패키지된 앱이 데스크톱 앱 대신 파일을 열 수 있도록 설정하기
- 패키지된 앱을 파일 형식 집합과 연결
- 특정 파일 형식이 파일의 상황에 맞는 메뉴에 옵션 추가
- URL 사용하여 특정 형식의 파일을 직접 엽니다.
기존 데스크톱 앱을 패키지된 앱으로 리디렉션
사용자가 기존 패키지되지 않은 데스크톱 앱을 시작하면 패키지된 앱을 대신 열도록 구성할 수 있습니다.
메모
이 기능은 Windows Insider Preview 빌드 21313 이상 버전에서 지원됩니다.
이 동작을 사용하도록 설정하려면 다음을 수행합니다.
- 패키지되지 않은 데스크톱 앱 실행 파일을 패키지된 앱으로 리디렉션하는 레지스트리 항목을 추가합니다.
- 패키지되지 않은 데스크톱 앱 실행 파일이 시작될 때 시작할 패키지된 앱을 등록합니다.
패키지되지 않은 데스크톱 앱 실행 파일을 리디렉션하는 레지스트리 항목 추가
- 레지스트리에서 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options 키 아래에 데스크톱 앱 실행 파일의 이름을 사용하여 하위 키를 만듭니다.
- 이 하위 키 아래에 다음 값을 추가합니다.
- AppExecutionAliasRedirect(DWORD): 1로 설정하면 시스템에서 실행 파일과 이름이 같은 AppExecutionAlias 패키지 확장을 확인합니다. AppExecutionAlias 확장을 사용하도록 설정하면 해당 값을 사용하여 패키지된 앱이 활성화됩니다.
- AppExecutionAliasRedirectPackages(REG_SZ): 시스템은 나열된 패키지로만 리디렉션됩니다. 패키지는 세미콜론으로 구분된 패키지 패밀리 이름으로 나열됩니다. 특수 값 *이 사용되는 경우 시스템은 모든 패키지에서 AppExecutionAlias로 리디렉션합니다.
예를 들어:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\contosoapp.exe
AppExecutionAliasRedirect = 1
AppExecutionAliasRedirectPackages = "Microsoft.WindowsNotepad_8weky8webbe"
시작할 패키지된 앱 등록
패키지 매니페스트에서 패키지되지 않은 데스크톱 앱 실행 파일의 이름을 등록하는 AppExecutionAlias 확장을 추가합니다. 예를 들어:
<Package
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="uap3">
<Applications>
<Application>
<Extensions>
<uap3:Extension Category="windows.appExecutionAlias" EntryPoint="Windows.FullTrustApplication">
<uap3:AppExecutionAlias>
<desktop:ExecutionAlias Alias="contosoapp.exe" />
</uap3:AppExecutionAlias>
</uap3:Extension>
</Extensions>
</Application>
</Applications>
</Package>
리디렉션 사용 안 함
사용자는 다음 옵션을 통해 리디렉션을 해제하고 패키지되지 않은 앱 실행 파일을 시작할 수 있습니다.
- 그들은 당신의 앱의 패키징된 버전을 삭제할 수 있습니다.
- 사용자는 설정의 앱 실행 별칭 페이지에서 패키지된 앱의 AppExecutionAlias 항목을 비활성화할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10/3http://schemas.microsoft.com/appx/manifest/desktop/windows10
이 확장의 요소 및 특성
<uap3:Extension
Category="windows.appExecutionAlias"
EntryPoint="Windows.FullTrustApplication">
<uap3:AppExecutionAlias>
<desktop:ExecutionAlias Alias="[AliasName]" />
</uap3:AppExecutionAlias>
</uap3:Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.appExecutionAlias. |
| 실행 | 별칭이 호출될 때 시작할 실행 파일의 상대 경로입니다. |
| 별명 | 앱의 짧은 이름입니다. 항상 ".exe" 확장으로 끝나야 합니다. |
기존 시작 타일 및 작업 표시줄 단추를 패키지된 앱으로 가리킵니다.
사용자가 데스크톱 애플리케이션을 작업 표시줄 또는 시작 메뉴에 고정했을 수 있습니다. 이러한 바로 가기를 새 패키지 앱에 연결할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3
이 확장의 요소 및 특성
<Extension Category="windows.desktopAppMigration">
<DesktopAppMigration>
<DesktopApp AumId="[your_app_aumid]" />
<DesktopApp ShortcutPath="[path]" />
</DesktopAppMigration>
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.desktopAppMigration. |
| AumID | 패키지된 앱의 애플리케이션 사용자 모델 ID입니다. |
| 바로 가기 경로 | 앱의 데스크톱 버전을 시작하는 .lnk 파일의 경로입니다. |
본보기
<Package
xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
IgnorableNamespaces="rescap3">
<Applications>
<Application>
<Extensions>
<rescap3:Extension Category="windows.desktopAppMigration">
<rescap3:DesktopAppMigration>
<rescap3:DesktopApp AumId="[your_app_aumid]" />
<rescap3:DesktopApp ShortcutPath="%USERPROFILE%\Desktop\[my_app].lnk" />
<rescap3:DesktopApp ShortcutPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\[my_app].lnk" />
<rescap3:DesktopApp ShortcutPath="%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\[my_app_folder]\[my_app].lnk"/>
</rescap3:DesktopAppMigration>
</rescap3:Extension>
</Extensions>
</Application>
</Applications>
</Package>
관련 샘플
전환, 마이그레이션 및 제거 기능을 갖춘 WPF 사진 뷰어
데스크톱 앱 대신 패키지된 애플리케이션을 파일 열기로 설정
사용자가 앱의 데스크톱 버전을 여는 대신 특정 유형의 파일에 대해 기본적으로 패키지된 새 애플리케이션을 열도록 할 수 있습니다.
이렇게 하려면 파일 연결을 상속하려는 각 애플리케이션의 ProgID(프로그래밍 식별자) 지정합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10/3http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]">
<MigrationProgIds>
<MigrationProgId>"[ProgID]"</MigrationProgId>
</MigrationProgIds>
</FileTypeAssociation>
</Extension>
전체 스키마 참조를 에서로 찾아보세요.
| 이름 | 설명 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| MigrationProgId | 파일 연결을 상속하려는 데스크톱 애플리케이션의 애플리케이션, 구성 요소 및 버전을 설명하는 ProgID(프로그래밍 식별자). |
예시
<Package
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
IgnorableNamespaces="uap3, rescap3">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes">
<rescap3:MigrationProgIds>
<rescap3:MigrationProgId>Foo.Bar.1</rescap3:MigrationProgId>
<rescap3:MigrationProgId>Foo.Bar.2</rescap3:MigrationProgId>
</rescap3:MigrationProgIds>
</uap3:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
관련 샘플
WPF 사진 뷰어 - 전환/마이그레이션/제거 기능 포함
패키지된 애플리케이션을 파일 형식 집합과 연결
패키지된 애플리케이션을 파일 형식 확장과 연결할 수 있습니다. 사용자가 파일 탐색기에서 파일을 마우스 오른쪽 단추로 클릭한 다음 열기 옵션을 선택하면 애플리케이션이 제안 목록에 표시됩니다. 이 확장을 사용하는 방법에 대한 자세한 내용은 파일 탐색기패키지 데스크톱 앱 통합을 참조하세요.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/3
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]">
<SupportedFileTypes>
<FileType>"[file extension]"</FileType>
</SupportedFileTypes>
</FileTypeAssociation>
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| 파일 유형 | 앱에서 지원하는 파일 확장명입니다. |
예시
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="uap, uap3">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="mediafiles">
<uap:SupportedFileTypes>
<uap:FileType>.avi</uap:FileType>
</uap:SupportedFileTypes>
</uap3:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
관련 샘플
WPF 사진 뷰어 전환/마이그레이션/삭제과 함께
특정 파일 형식의 파일 상황에 맞는 메뉴에 옵션 추가
이 확장을 사용하면 사용자가 파일 탐색기에서 파일을 마우스 오른쪽 단추로 클릭할 때 표시되는 상황에 맞는 메뉴에 옵션을 추가할 수 있습니다. 이러한 옵션은 사용자에게 파일 인쇄, 편집 또는 미리 보기와 같은 파일과 상호 작용하는 다른 방법을 제공합니다. 이 확장을 사용하는 방법에 대한 자세한 내용은 파일 탐색기패키지 데스크톱 앱 통합을 참조하세요.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/2http://schemas.microsoft.com/appx/manifest/uap/windows10/3
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]">
<SupportedVerbs>
<Verb Id="[ID]" Extended="[Extended]" Parameters="[parameters]">"[verb label]"</Verb>
</SupportedVerbs>
</FileTypeAssociation>
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| 동사 | 파일 탐색기 상황에 맞는 메뉴에 표시되는 이름입니다. 이 문자열은 ms-resource사용하는 지역화 가능합니다. |
| 아이디 | 동사의 고유 ID입니다. 애플리케이션이 UWP 앱인 경우 사용자의 선택을 적절하게 처리할 수 있도록 활성화 이벤트 인수의 일부로 앱에 전달됩니다. 애플리케이션이 완전 신뢰 패키지 앱인 경우 대신 매개 변수를 받습니다(다음 글머리 기호 참조). |
| 매개 변수 | 동사와 연결된 인수 매개 변수 및 값 목록입니다. 애플리케이션이 완전 신뢰 패키지 앱인 경우 애플리케이션이 활성화될 때 이러한 매개 변수가 이벤트 인수로 애플리케이션에 전달됩니다. 다른 활성화 동사에 따라 애플리케이션의 동작을 사용자 지정할 수 있습니다. 변수에 파일 경로가 포함될 수 있는 경우 매개 변수 값을 따옴표로 래핑합니다. 이렇게 하면 경로에 공백이 포함된 경우 발생하는 문제를 방지할 수 있습니다. 애플리케이션이 UWP 앱인 경우 매개 변수를 전달할 수 없습니다. 앱은 대신 ID를 받습니다(이전 글머리 기호 참조). |
| 확장 | 사용자가 파일을 마우스 오른쪽 단추로 클릭하기 전에 Shift 키를 눌러 상황에 맞는 메뉴를 표시하는 경우에만 동사가 표시되도록 지정합니다. 이 특성은 선택 사항이며, 나열되지 않은 경우 기본값은 False(예: 항상 동사 표시)입니다. 각 동사에 대해 이 동작을 개별적으로 지정합니다("열기"는 항상 False로 설정되어 있습니다). |
본보기
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="uap, uap2, uap3">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes">
<uap2:SupportedVerbs>
<uap3:Verb Id="Edit" Parameters="/e "%1"">Edit</uap3:Verb>
<uap3:Verb Id="Print" Extended="true" Parameters="/p "%1"">Print</uap3:Verb>
</uap2:SupportedVerbs>
</uap3:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
관련 샘플
URL을 사용하여 특정 형식의 파일을 직접 엽니다.
사용자가 앱의 데스크톱 버전을 여는 대신 특정 유형의 파일에 대해 기본적으로 패키지된 새 애플리케이션을 열도록 할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/3
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]" UseUrl="true" Parameters="%1">
<SupportedFileTypes>
<FileType>"[FileExtension]"</FileType>
</SupportedFileTypes>
</FileTypeAssociation>
</Extension>
전체 스키마 참조 를에서 찾으세요.
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| UseUrl | URL 대상에서 직접 파일을 열지 여부를 나타냅니다. 이 값을 설정하지 않으면 애플리케이션에서 URL을 사용하여 파일을 열려고 하면 시스템에서 먼저 파일을 로컬로 다운로드합니다. |
| 매개 변수 | 선택적 매개 변수입니다. |
| 파일 형식 | 관련 파일 확장명입니다. |
본보기
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="uap, uap3">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes" UseUrl="true" Parameters="%1">
<uap:SupportedFileTypes>
<uap:FileType>.txt</uap:FileType>
<uap:FileType>.doc</uap:FileType>
</uap:SupportedFileTypes>
</uap3:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
설치 작업 수행
앱에 대한 방화벽 예외 만들기
애플리케이션에 포트를 통한 통신이 필요한 경우 방화벽 예외 목록에 애플리케이션을 추가할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
이 확장의 요소 및 특성
<Extension Category="windows.firewallRules">
<FirewallRules Executable="[executable file name]">
<Rule
Direction="[Direction]"
IPProtocol="[Protocol]"
LocalPortMin="[LocalPortMin]"
LocalPortMax="LocalPortMax"
RemotePortMin="RemotePortMin"
RemotePortMax="RemotePortMax"
Profile="[Profile]"/>
</FirewallRules>
</Extension>
여기에서 전체 스키마 참조 를 찾으세요.
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.firewallRules |
| 실행 | 방화벽 예외 목록에 추가하려는 실행 파일의 이름입니다. |
| 방향 | 규칙이 인바운드 또는 아웃바운드 규칙인지 여부를 나타냅니다. |
| IP 프로토콜 | 통신 프로토콜 |
| LocalPortMin | 로컬 포트 번호 범위의 하위 포트 번호입니다. |
| LocalPortMax | 로컬 포트 번호 범위의 가장 높은 포트 번호입니다. |
| RemotePortMax | 원격 포트 번호 범위의 낮은 포트 번호입니다. |
| RemotePortMax | 원격 포트 번호 범위의 가장 높은 포트 번호입니다. |
| 프로필 | 네트워크 유형 |
본보기
<Package
xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
IgnorableNamespaces="desktop2">
<Extensions>
<desktop2:Extension Category="windows.firewallRules">
<desktop2:FirewallRules Executable="Contoso.exe">
<desktop2:Rule Direction="in" IPProtocol="TCP" Profile="all"/>
<desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="domain"/>
<desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="public"/>
<desktop2:Rule Direction="out" IPProtocol="UDP" LocalPortMin="1339" LocalPortMax="1340" RemotePortMin="15"
RemotePortMax="19" Profile="domainAndPrivate"/>
<desktop2:Rule Direction="out" IPProtocol="GRE" Profile="private"/>
</desktop2:FirewallRules>
</desktop2:Extension>
</Extensions>
</Package>
패키지의 폴더에 DLL 파일 배치
uap6:LoaderSearchPathOverride 확장을 사용하여 앱 패키지 루트 경로를 기준으로 앱 패키지에서 최대 5개의 폴더 경로를 선언하여 앱 프로세스의 로더 검색 경로에 사용할 수 있습니다.
Windows 앱에 대한 DLL 검색 순서 패키지에 실행 권한이 있는 경우 패키지 종속성 그래프에 패키지가 포함됩니다. 기본적으로 여기에는 기본, 선택적 및 프레임워크 패키지가 포함되지만 패키지 매니페스트의 uap6:AllowExecution 요소로 덮어쓸 수 있습니다.
DLL 검색 순서에 포함된 패키지는 기본적으로 유효 경로포함합니다. 유효 경로에 대한 자세한 내용은 WinRT(EffectivePath 속성) 및 PackagePathType 열거형(Win32)을 참조하세요.
패키지가 uap6:LoaderSearchPathOverride 지정하는 경우 이 정보는 패키지의 유효 경로 대신 사용됩니다.
각 패키지에는 하나의 uap6:LoaderSearchPathOverride 확장만 포함될 수 있습니다. 즉, 해당 구성 요소 중 하나를 기본 패키지에 추가한 다음, 각 선택적 패키지와 관련 집합에도 각각 하나씩 추가할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10/6
이 확장의 요소 및 특성
앱 매니페스트의 패키지 수준에서 이 확장을 선언합니다.
<Extension Category="windows.loaderSearchPathOverride">
<LoaderSearchPathOverride>
<LoaderSearchPathEntry FolderPath="[path]"/>
</LoaderSearchPathOverride>
</Extension>
| 이름 | 설명 |
|---|---|
| 범주 | 항상 windows.loaderSearchPathOverride. |
| 폴더 경로 | DLL 파일이 포함된 폴더의 경로입니다. 패키지의 루트 폴더에 상대적인 경로를 지정합니다. 한 확장에서 최대 5개의 경로를 지정할 수 있습니다. 시스템에서 패키지의 루트 폴더에 있는 파일을 검색하려면 이러한 경로 중 하나에 빈 문자열을 사용합니다. 중복 경로를 포함하지 말고 경로에 선행 및 후행 슬래시 또는 백슬라이시가 포함되지 않도록 합니다. 시스템은 하위 폴더를 검색하지 않으므로 시스템이 로드할 DLL 파일이 포함된 각 폴더를 명시적으로 나열해야 합니다. |
본보기
<Package
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/6"
IgnorableNamespaces="uap6">
...
<Extensions>
<uap6:Extension Category="windows.loaderSearchPathOverride">
<uap6:LoaderSearchPathOverride>
<uap6:LoaderSearchPathEntry FolderPath=""/>
<uap6:LoaderSearchPathEntry FolderPath="folder1/subfolder1"/>
<uap6:LoaderSearchPathEntry FolderPath="folder2/subfolder2"/>
</uap6:LoaderSearchPathOverride>
</uap6:Extension>
</Extensions>
...
</Package>
파일 탐색기와 통합
사용자가 파일을 구성하고 친숙한 방식으로 상호 작용할 수 있도록 도와줍니다.
- 사용자가 여러 파일을 동시에 선택하고 열 때 애플리케이션이 작동하는 방식 정의
- 파일 탐색기 내의 썸네일 이미지에 파일 내용 표시
- 파일 탐색기 미리 보기 창에 파일 내용 표시
- 파일 탐색기 종류 열을 사용하여 사용자가 파일을 그룹화할 수 있도록 설정
- 검색, 인덱스, 속성 대화 상자 및 세부 정보 창에서 파일 속성을 사용할 수 있도록
- 파일 형식에 대한 상황에 맞는 메뉴 처리기 지정
- 클라우드 서비스의 파일을 파일 탐색기 표시합니다.
사용자가 동시에 여러 파일을 선택하고 열 때 애플리케이션의 동작 방식 정의
사용자가 여러 파일을 동시에 열 때 애플리케이션의 동작 방식을 지정합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/2http://schemas.microsoft.com/appx/manifest/uap/windows10/3
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]" MultiSelectModel="[SelectionModel]">
<SupportedVerbs>
<Verb Id="Edit" MultiSelectModel="[SelectionModel]">Edit</Verb>
</SupportedVerbs>
<SupportedFileTypes>
<FileType>"[FileExtension]"</FileType>
</SupportedFileTypes>
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| MultiSelectModel | 아래 참조 |
| 파일 형식 | 관련 파일 확장명입니다. |
MultiSelectModel
패키지된 데스크톱 앱에는 일반 데스크톱 앱과 동일한 세 가지 옵션이 있습니다.
-
Player: 애플리케이션이 한 번 활성화됩니다. 선택한 모든 파일이 인수 매개 변수로 애플리케이션에 전달됩니다. -
Single: 애플리케이션이 처음 선택한 파일에 대해 한 번 활성화됩니다. 다른 파일은 무시됩니다. -
Document: 선택한 각 파일에 대해 별도의 새 애플리케이션 인스턴스가 활성화됩니다.
다른 파일 형식 및 작업에 대해 다른 기본 설정을 지정할 수 있습니다. 예를 들어 문서를 문서 모드에서 열고, 이미지를 플레이어 모드에서 열 수 있습니다.
예시
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="uap, uap2, uap3">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes" MultiSelectModel="Document">
<uap2:SupportedVerbs>
<uap3:Verb Id="Edit" MultiSelectModel="Player">Edit</uap3:Verb>
<uap3:Verb Id="Preview" MultiSelectModel="Document">Preview</uap3:Verb>
</uap2:SupportedVerbs>
<uap:SupportedFileTypes>
<uap:FileType>.txt</uap:FileType>
</uap:SupportedFileTypes>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
사용자가 15개 이하의 파일을 여는 경우 MultiSelectModel 특성의 기본 선택은 플레이어입니다. 그렇지 않으면 기본값은 문서. UWP 앱은 항상 플레이어로 시작됩니다.
파일 탐색기 내의 미리 보기 이미지에 파일 내용 표시
파일 아이콘이 중간 크기, 큰 크기 또는 초대형으로 표시되면 사용자가 파일 내용의 축소판 그림을 볼 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/2http://schemas.microsoft.com/appx/manifest/uap/windows10/3http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]">
<SupportedFileTypes>
<FileType>"[FileExtension]"</FileType>
</SupportedFileTypes>
<ThumbnailHandler
Clsid ="[Clsid ]" />
</FileTypeAssociation>
</Extension>
전체 스키마 참조 를 여기에서 찾으세요.
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| 파일 유형 | 관련 파일 확장명입니다. |
| Clsid | 앱의 클래스 ID입니다. |
본보기
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
IgnorableNamespaces="uap, uap2, uap3, desktop2">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes">
<uap:SupportedFileTypes>
<uap:FileType>.bar</uap:FileType>
</uap:SupportedFileTypes>
<desktop2:ThumbnailHandler
Clsid ="20000000-0000-0000-0000-000000000001" />
</uap3:FileTypeAssociation>
</uap::Extension>
</Extensions>
</Application>
</Applications>
</Package>
파일 탐색기의 미리 보기 창에 파일 내용 표시
사용자가 파일 탐색기의 미리 보기 창에서 파일 내용을 미리 볼 수 있도록 합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/2http://schemas.microsoft.com/appx/manifest/uap/windows10/3http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]">
<SupportedFileTypes>
<FileType>"[FileExtension]"</FileType>
</SupportedFileTypes>
<DesktopPreviewHandler Clsid ="[Clsid ]" />
</FileTypeAssociation>
</Extension>
전체 스키마 참조 를 여기에서 찾으십시오.
| 이름 | 설명 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| 파일 유형 | 관련 파일 확장명입니다. |
| Clsid | 앱의 클래스 ID입니다. |
본보기
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
IgnorableNamespaces="uap, uap2, uap3, desktop2">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes">
<uap:SupportedFileTypes>
<uap:FileType>.bar</uap:FileType>
</uap:SupportedFileTypes>
<desktop2:DesktopPreviewHandler Clsid ="20000000-0000-0000-0000-000000000001" />
</uap3:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
사용자가 파일 탐색기에서 종류 열을 사용하여 파일을 그룹화할 수 있도록 설정
파일 형식에 대해 하나 이상의 미리 정의된 값을 종류 필드와 연결할 수 있습니다.
파일 탐색기에서 사용자는 해당 필드를 사용하여 해당 파일을 그룹화할 수 있습니다. 또한 시스템 구성 요소는 인덱싱과 같은 다양한 용도로 이 필드를 사용합니다.
종류 필드 및 이 필드에 사용할 수 있는 값에 대한 자세한 내용은 종류 이름을(를) 참조하세요.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3
이 확장의 요소 및 특성
<Extension Category="windows.fileTypeAssociation">
<FileTypeAssociation Name="[Name]">
<SupportedFileTypes>
<FileType>"[FileExtension]"</FileType>
</SupportedFileTypes>
<KindMap>
<Kind value="[KindValue]">
</KindMap>
</FileTypeAssociation>
</Extension>
여기에서 전체 스키마 참조 를 찾으세요.
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| 파일 유형 | 관련 파일 확장명입니다. |
| 값 | 유효한 종류 값 |
본보기
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
IgnorableNamespaces="uap, rescap">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap:FileTypeAssociation Name="mediafiles">
<uap:SupportedFileTypes>
<uap:FileType>.m4a</uap:FileType>
<uap:FileType>.mta</uap:FileType>
</uap:SupportedFileTypes>
<rescap:KindMap>
<rescap:Kind value="Item">
<rescap:Kind value="Communications">
<rescap:Kind value="Task">
</rescap:KindMap>
</uap:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
검색, 인덱스, 속성 대화 상자 및 세부 정보 창에 파일 속성을 사용할 수 있도록 합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10http://schemas.microsoft.com/appx/manifest/uap/windows10/3http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
이 확장의 요소 및 특성
<uap:Extension Category="windows.fileTypeAssociation">
<uap:FileTypeAssociation Name="[Name]">
<SupportedFileTypes>
<FileType>.bar</FileType>
</SupportedFileTypes>
<DesktopPropertyHandler Clsid ="[Clsid]"/>
</uap:FileTypeAssociation>
</uap:Extension>
여기에서 전체 스키마 참조 를 찾으세요.
| 이름 | 설명 |
|---|---|
| 범주 | 항상 windows.fileTypeAssociation. |
| 이름 | 파일 형식 연결의 이름입니다. 이 이름을 사용하여 파일 형식을 구성하고 그룹화할 수 있습니다. 이름은 공백이 없는 모든 소문자여야 합니다. |
| 파일 유형 | 관련 파일 확장명입니다. |
| Clsid | 앱의 클래스 ID입니다. |
예시
<Package
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
IgnorableNamespaces="uap, uap3, desktop2">
<Applications>
<Application>
<Extensions>
<uap:Extension Category="windows.fileTypeAssociation">
<uap3:FileTypeAssociation Name="myfiletypes">
<uap:SupportedFileTypes>
<uap:FileType>.bar</uap:FileType>
</uap:SupportedFileTypes>
<desktop2:DesktopPropertyHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
</uap3:FileTypeAssociation>
</uap:Extension>
</Extensions>
</Application>
</Applications>
</Package>
파일 형식에 대한 상황에 맞는 메뉴 처리기 지정
데스크톱 애플리케이션이 상황에 맞는 메뉴 처리기정의하는 경우 이 확장을 사용하여 메뉴 처리기를 등록합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/foundation/windows10http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
이 확장의 요소 및 특성
<Extensions>
<com:Extension Category="windows.comServer">
<com:ComServer>
<com:SurrogateServer AppId="[AppID]" DisplayName="[DisplayName]">
<com:Class Id="[Clsid]" Path="[Path]" ThreadingModel="[Model]"/>
</com:SurrogateServer>
</com:ComServer>
</com:Extension>
<desktop4:Extension Category="windows.fileExplorerContextMenus">
<desktop4:FileExplorerContextMenus>
<desktop4:ItemType Type="[Type]">
<desktop4:Verb Id="[ID]" Clsid="[Clsid]" />
</desktop4:ItemType>
</desktop4:FileExplorerContextMenus>
</desktop4:Extension>
</Extensions>
전체 스키마 참조를 여기에서 찾으세요: com:ComServer 및 desktop4:FileExplorerContextMenus.
지시
상황에 맞는 메뉴 처리기를 등록하려면 다음 지침을 따릅니다.
데스크톱 애플리케이션에서 IExplorerCommand 또는 IExplorerCommandState 인터페이스를 구현하여 상황에 맞는 메뉴 처리기 구현합니다. 샘플은 ExplorerCommandVerb 코드 샘플을 참조하세요. 각 구현 개체에 대한 클래스 GUID를 정의해야 합니다. 예를 들어 다음 코드는 IExplorerCommand구현하기 위한 클래스 ID를 정의합니다.
class __declspec(uuid("00001111-aaaa-2222-bbbb-3333cccc4444")) CExplorerCommandVerb;패키지 매니페스트에서 com 서로게이트 서버를 상황에 맞는 메뉴 처리기 구현의 클래스 ID로 등록하는 com:ComServer 애플리케이션 확장을 지정합니다.
<com:Extension Category="windows.comServer"> <com:ComServer> <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler"> <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/> </com:SurrogateServer> </com:ComServer> </com:Extension>패키지 매니페스트에서 상황에 맞는 메뉴 처리기 구현을 등록하는 desktop4:FileExplorerContextMenus 애플리케이션 확장을 지정합니다.
<desktop4:Extension Category="windows.fileExplorerContextMenus"> <desktop4:FileExplorerContextMenus> <desktop4:ItemType Type=".rar"> <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" /> </desktop4:ItemType> </desktop4:FileExplorerContextMenus> </desktop4:Extension>
본보기
<Package
xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
IgnorableNamespaces="desktop4">
<Applications>
<Application>
<Extensions>
<com:Extension Category="windows.comServer">
<com:ComServer>
<com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
<com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
</com:SurrogateServer>
</com:ComServer>
</com:Extension>
<desktop4:Extension Category="windows.fileExplorerContextMenus">
<desktop4:FileExplorerContextMenus>
<desktop4:ItemType Type=".contoso">
<desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
</desktop4:ItemType>
</desktop4:FileExplorerContextMenus>
</desktop4:Extension>
</Extensions>
</Application>
</Applications>
</Package>
클라우드 서비스의 파일이 파일 탐색기에 표시되도록 만들기
애플리케이션에서 구현하는 처리기를 등록합니다. 사용자가 파일 탐색기에서 클라우드 기반 파일을 마우스 오른쪽 단추로 클릭할 때 나타나는 상황에 맞는 메뉴 옵션을 추가할 수도 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/desktop/windows10
이 확장의 요소 및 특성
<Extension Category="windows.cloudfiles" >
<CloudFiles IconResource="[Icon]">
<CustomStateHandler Clsid ="[Clsid]"/>
<ThumbnailProviderHandler Clsid ="[Clsid]"/>
<ExtendedPropertyhandler Clsid ="[Clsid]"/>
<CloudFilesContextMenus>
<Verb Id ="Command3" Clsid= "[GUID]">[Verb Label]</Verb>
</CloudFilesContextMenus>
</CloudFiles>
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.cloudfiles. |
| 아이콘 리소스 | 클라우드 파일 공급자 서비스를 나타내는 아이콘입니다. 이 아이콘은 파일 탐색기의 탐색 창에 나타납니다. 사용자는 이 아이콘을 선택하여 클라우드 서비스의 파일을 표시합니다. |
| CustomStateHandler Clsid | CustomStateHandler를 구현하는 애플리케이션의 클래스 ID입니다. 시스템은 이 클래스 ID를 사용하여 클라우드 파일에 대한 사용자 지정 상태 및 열을 요청합니다. |
| ThumbnailProviderHandler Clsid | ThumbnailProviderHandler를 구현하는 애플리케이션의 클래스 ID입니다. 시스템은 이 클래스 ID를 사용하여 클라우드 파일에 대한 썸네일 이미지를 요청합니다. |
| ExtendedPropertyHandler Clsid | ExtendedPropertyHandler를 구현하는 애플리케이션의 클래스 ID입니다. 시스템은 이 클래스 ID를 사용하여 클라우드 파일에 대한 확장 속성을 요청합니다. |
| 동사 | 클라우드 서비스에서 제공하는 파일의 파일 탐색기 상황에 맞는 메뉴에 표시되는 이름입니다. |
| 아이디 | 동사의 고유 ID입니다. |
본보기
<Package
xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
IgnorableNamespaces="desktop">
<Applications>
<Application>
<Extensions>
<Extension Category="windows.cloudfiles" >
<CloudFiles IconResource="images\Wide310x150Logo.png">
<CustomStateHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
<ThumbnailProviderHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
<ExtendedPropertyhandler Clsid ="20000000-0000-0000-0000-000000000001"/>
<desktop:CloudFilesContextMenus>
<desktop:Verb Id ="keep" Clsid=
"20000000-0000-0000-0000-000000000001">
Always keep on this device</desktop:Verb>
</desktop:CloudFilesContextMenus>
</CloudFiles>
</Extension>
</Extensions>
</Application>
</Applications>
</Package>
다양한 방법으로 애플리케이션 시작
- 프로토콜 사용하여 애플리케이션 시작
- 별칭 사용하여 애플리케이션 시작
- 사용자가 Windows 로그인할 때 실행 파일 시작
- 사용자가 디바이스를 PC에 연결할 때 애플리케이션을 시작할 수
- Microsoft Store 업데이트를 받은 후 자동으로 다시 시작
프로토콜을 사용하여 애플리케이션 시작
프로토콜 연결을 사용하면 다른 프로그램 및 시스템 구성 요소가 패키지된 앱과 상호 운용될 수 있습니다. 프로토콜을 사용하여 패키지된 애플리케이션을 시작할 때 활성화 이벤트 인수에 전달할 특정 매개 변수를 지정하여 적절하게 동작할 수 있습니다. 매개 변수는 패키지된 완전 신뢰 앱에 대해서만 지원됩니다. UWP 앱은 매개 변수를 사용할 수 없습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
이 확장의 요소 및 특성
<Extension
Category="windows.protocol">
<Protocol
Name="[Protocol name]"
Parameters="[Parameters]" />
</Extension>
여기에서 전체 스키마 참조를확인하세요.
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.protocol. |
| 이름 | 프로토콜의 이름입니다. |
| 매개 변수 | 애플리케이션이 활성화될 때 애플리케이션에 이벤트 인수로 전달할 매개 변수 및 값 목록입니다. 변수에 파일 경로가 포함될 수 있는 경우 매개 변수 값을 따옴표로 래핑합니다. 이렇게 하면 경로에 공백이 포함된 경우 발생하는 문제를 방지할 수 있습니다. |
예시
<Package
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
IgnorableNamespaces="uap3, desktop">
<Applications>
<Application>
<Extensions>
<uap3:Extension
Category="windows.protocol">
<uap3:Protocol
Name="myapp-cmd"
Parameters="/p "%1"" />
</uap3:Extension>
</Extensions>
</Application>
</Applications>
</Package>
별칭을 사용하여 애플리케이션 시작
사용자 및 기타 프로세스는 앱의 전체 경로를 지정하지 않고도 별칭을 사용하여 애플리케이션을 시작할 수 있습니다. 별칭 이름을 지정할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10/3http://schemas.microsoft.com/appx/manifest/desktop/windows10
이 확장의 요소 및 특성
<uap3:Extension
Category="windows.appExecutionAlias"
Executable="[ExecutableName]"
EntryPoint="Windows.FullTrustApplication">
<uap3:AppExecutionAlias>
<desktop:ExecutionAlias Alias="[AliasName]" />
</uap3:AppExecutionAlias>
</uap3:Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항 상 windows.appExecutionAlias. |
| 실행 | 별칭이 호출될 때 시작할 실행 파일의 상대 경로입니다. |
| 별명 | 앱의 짧은 이름입니다. 항상 ".exe" 확장으로 끝나야 합니다. 패키지의 각 애플리케이션에 대해 단일 앱 실행 별칭만 지정할 수 있습니다. 여러 앱이 동일한 별칭에 등록하는 경우 시스템은 등록된 마지막 앱을 호출하므로 다른 앱이 재정의할 가능성이 없는 고유한 별칭을 선택해야 합니다. |
예시
<Package
xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
IgnorableNamespaces="uap3">
<Applications>
<Application>
<Extensions>
<uap3:Extension
Category="windows.appExecutionAlias"
Executable="exes\launcher.exe"
EntryPoint="Windows.FullTrustApplication">
<uap3:AppExecutionAlias>
<desktop:ExecutionAlias Alias="Contoso.exe" />
</uap3:AppExecutionAlias>
</uap3:Extension>
</Extensions>
</Application>
</Applications>
</Package>
전체 스키마 참조 를 여기에서 찾으세요.
사용자가 Windows에 로그인할 때 실행 파일 시작
시작 작업을 사용하면 사용자가 로그온할 때마다 애플리케이션에서 실행 파일을 자동으로 실행할 수 있습니다.
메모
이 시작 작업을 등록하려면 사용자가 애플리케이션을 한 번 이상 시작해야 합니다.
애플리케이션은 여러 시작 작업을 선언할 수 있습니다. 각 작업은 독립적으로 시작됩니다. 모든 시작 작업은 앱의 매니페스트에 지정한 이름과 앱 아이콘이 있는 시작 탭 아래 작업 관리자에 표시됩니다. 작업 관리자는 작업의 시작 영향을 자동으로 분석합니다.
사용자는 작업 관리자를 사용하여 앱의 시작 작업을 수동으로 사용하지 않도록 설정할 수 있습니다. 사용자가 작업을 사용하지 않도록 설정하면 프로그래밍 방식으로 다시 사용하도록 설정할 수 없습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/desktop/windows10
이 확장의 요소 및 특성
<Extension
Category="windows.startupTask"
Executable="[ExecutableName]"
EntryPoint="Windows.FullTrustApplication">
<StartupTask
TaskId="[TaskID]"
Enabled="true"
DisplayName="[DisplayName]" />
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.startupTask. |
| 실행 | 시작할 실행 파일의 상대 경로입니다. |
| 작업ID | 작업에 대한 고유 식별자입니다. 애플리케이션은 이 식별자를 사용하여 windows.ApplicationModel.StartupTask 클래스 API를 호출하여 시작 작업을 프로그래밍 방식으로 사용하거나 사용하지 않도록 설정할 수 있습니다. |
| 활성화됨 | 태스크를 처음 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 나타냅니다. 활성화된 작업은 다음에 사용자가 로그온할 때 실행됩니다(사용자가 사용하지 않도록 설정하지 않는 한). |
| 표시 이름 | 작업 관리자에 표시되는 작업의 이름입니다.
ms-resource사용하여 이 문자열을 지역화할 수 있습니다. |
본보기
<Package
xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
IgnorableNamespaces="desktop">
<Applications>
<Application>
<Extensions>
<desktop:Extension
Category="windows.startupTask"
Executable="bin\MyStartupTask.exe"
EntryPoint="Windows.FullTrustApplication">
<desktop:StartupTask
TaskId="MyStartupTask"
Enabled="true"
DisplayName="My App Service" />
</desktop:Extension>
</Extensions>
</Application>
</Applications>
</Package>
사용자가 디바이스를 PC에 연결할 때 애플리케이션을 시작할 수 있도록 설정
자동 실행은 사용자가 디바이스를 PC에 연결할 때 애플리케이션을 옵션으로 표시할 수 있습니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/desktop/windows10/3
이 확장의 요소 및 특성
<Extension Category="windows.autoPlayHandler">
<AutoPlayHandler>
<InvokeAction ActionDisplayName="[action string]" ProviderDisplayName="[name of your app/service]">
<Content ContentEvent="[Content event]" Verb="[any string]" DropTargetHandler="[Clsid]" />
<Content ContentEvent="[Content event]" Verb="[any string]" Parameters="[Initialization parameter]"/>
<Device DeviceEvent="[Device event]" HWEventHandler="[Clsid]" InitCmdLine="[Initialization parameter]"/>
</InvokeAction>
</AutoPlayHandler>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.autoPlayHandler. |
| 동작 표시 이름 | 사용자가 PC에 연결하는 장치로 수행할 수 있는 작업을 나타내는 문자열입니다(예: "파일 가져오기" 또는 "비디오 재생"). |
| 제공자 표시 이름 | 애플리케이션 또는 서비스를 나타내는 문자열입니다(예: "Contoso 비디오 플레이어"). |
| 콘텐츠 이벤트 | 사용자에게 ActionDisplayName 및 ProviderDisplayName메시지를 표시하는 콘텐츠 이벤트의 이름입니다. 콘텐츠 이벤트는 카메라 메모리 카드, 썸 드라이브 또는 DVD와 같은 볼륨 디바이스가 PC에 삽입될 때 발생합니다. 이러한 이벤트의 전체 목록은 여기에서찾을 수 있습니다. |
| 동사 | 동사 설정은 선택한 옵션에 대해 애플리케이션에 전달되는 값을 식별합니다. 자동 실행 이벤트에 대해 여러 시작 작업을 지정하고 동사 설정을 사용하여 사용자가 앱에 대해 선택한 옵션을 결정할 수 있습니다. 앱에 전달된 시작 이벤트 인수의 동사 속성을 확인하여 사용자가 선택한 옵션을 알 수 있습니다. 예약된 open을 제외한 동사 설정에 모든 값을 사용할 수 있습니다. |
| DropTargetHandler | IDropTarget 인터페이스를 구현하는 애플리케이션의 클래스 ID입니다. 이동식 미디어의 파일은 IDropTarget 구현의 Drop 메서드로 전달됩니다. |
| 매개 변수 | 모든 콘텐츠 이벤트에 대해 IDropTarget 인터페이스를 구현할 필요는 없습니다. 콘텐츠 이벤트의 경우 IDropTarget 인터페이스를 구현하는 대신 명령줄 매개 변수를 제공할 수 있습니다. 이러한 이벤트의 경우 자동 실행은 해당 명령줄 매개 변수를 사용하여 애플리케이션을 시작합니다. 앱의 초기화 코드에서 이러한 매개 변수를 구문 분석하여 자동 실행에서 시작되었는지 확인한 다음 사용자 지정 구현을 제공할 수 있습니다. |
| 장치 이벤트 | 사용자에게 ActionDisplayName 메시지가 표시되고 ProviderDisplayName디바이스 이벤트의 이름입니다. 디바이스가 PC에 연결되면 디바이스 이벤트가 발생합니다. 디바이스 이벤트는 문자열 WPD로 시작하며, 여기 에서나열된 이벤트를 찾을 수 있습니다. |
| HW 이벤트 핸들러 | IHWEventHandler 인터페이스를 구현하는 애플리케이션의 클래스 ID입니다. |
| InitCmdLine | IHWEventHandler 인터페이스의 Initialize 메서드에 전달하려는 문자열 매개 변수입니다. |
본보기
<Package
xmlns:desktop3="http://schemas.microsoft.com/appx/manifest/desktop/windows10/3"
IgnorableNamespaces="desktop3">
<Applications>
<Application>
<Extensions>
<desktop3:Extension Category="windows.autoPlayHandler">
<desktop3:AutoPlayHandler>
<desktop3:InvokeAction ActionDisplayName="Import my files" ProviderDisplayName="ms-resource:AutoPlayDisplayName">
<desktop3:Content ContentEvent="ShowPicturesOnArrival" Verb="show" DropTargetHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8"/>
<desktop3:Content ContentEvent="PlayVideoFilesOnArrival" Verb="play" Parameters="%1" />
<desktop3:Device DeviceEvent="WPD\ImageSource" HWEventHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8" InitCmdLine="/autoplay"/>
</desktop3:InvokeAction>
</desktop3:AutoPlayHandler>
</Extensions>
</Application>
</Applications>
</Package>
Microsoft Store에서 업데이트를 받은 후 자동으로 다시 시작
사용자가 업데이트를 설치할 때 애플리케이션이 열려 있으면 애플리케이션이 닫힙니다.
업데이트가 완료된 후 해당 애플리케이션을 다시 시작하려면 다시 시작하려는 모든 프로세스에서 RegisterApplicationRestart 함수를 호출합니다.
애플리케이션의 각 활성 창은 WM_QUERYENDSESSION 메시지를 받습니다. 이 시점에서 애플리케이션은 RegisterApplicationRestart 함수를 다시 호출하여 필요한 경우 명령줄을 업데이트할 수 있습니다.
애플리케이션의 각 활성 창이 WM_ENDSESSION 메시지를 받으면 애플리케이션은 데이터를 저장하고 종료해야 합니다.
메모
또한 애플리케이션이 WM_ENDSESSION 메시지를 처리하지 않는 경우 활성 창에서 WM_CLOSE 메시지를 받습니다.
이 시점에서 애플리케이션은 자체 프로세스를 닫는 데 30초가 있거나 플랫폼이 강제로 종료합니다.
업데이트가 완료되면 애플리케이션이 다시 시작됩니다.
다른 애플리케이션 작업
다른 앱과 통합하거나, 다른 프로세스를 시작하거나, 정보를 공유합니다.
- 인쇄 지원하는 애플리케이션에서 애플리케이션을 인쇄 대상으로 표시합니다.
- 다른 Windows 응용 프로그램과 글꼴 공유
- 유니버설 Windows 플랫폼(UWP) 앱에서 Win32 프로세스를 시작하기
애플리케이션을 인쇄를 지원하는 애플리케이션에서 인쇄 대상으로 표시
사용자가 메모장과 같은 다른 응용 프로그램에서 데이터를 인쇄하려는 경우 응용 프로그램이 사용 가능한 인쇄 대상 목록에 인쇄 대상으로 표시되도록 할 수 있습니다.
XPS(XML Paper Specification) 형식으로 인쇄 데이터를 받도록 애플리케이션을 수정해야 합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2
이 확장의 요소 및 특성
<Extension Category="windows.appPrinter">
<AppPrinter
DisplayName="[DisplayName]"
Parameters="[Parameters]" />
</Extension>
전체 스키마 참조 를 여기서 찾을 수 있습니다.
| 이름 | 설명 |
|---|---|
| 범주 | 항상 windows.appPrinter. |
| 표시 이름 | 앱의 인쇄 대상 목록에 표시할 이름입니다. |
| 매개 변수 | 애플리케이션이 요청을 제대로 처리하는 데 필요한 모든 매개 변수입니다. |
예시
<Package
xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
IgnorableNamespaces="desktop2">
<Applications>
<Application>
<Extensions>
<desktop2:Extension Category="windows.appPrinter">
<desktop2:AppPrinter
DisplayName="Send to Contoso"
Parameters="/insertdoc %1" />
</desktop2:Extension>
</Extensions>
</Application>
</Applications>
</Package>
이 확장을 사용하는 샘플 찾기 여기
다른 Windows 애플리케이션과 글꼴 공유
사용자 지정 글꼴을 다른 Windows 애플리케이션과 공유합니다.
메모
이 확장을 사용하는 앱을 스토어에 제출하려면 먼저 스토어 팀의 승인을 받아야 합니다. 승인을 받으려면 https://aka.ms/storesupport이동하여 문의를 클릭하고 대시보드에 앱을 제출하는 데 관련된 옵션을 선택합니다. 이 승인 프로세스는 앱에서 설치한 글꼴과 OS와 함께 설치된 글꼴 간에 충돌이 없도록 하는 데 도움이 됩니다. 승인을 받지 못하면 앱을 제출할 때 다음과 유사한 오류가 표시됩니다. "패키지 승인 유효성 검사 오류: 이 계정으로 확장 windows.sharedFonts를 사용할 수 없습니다. 이 확장을 사용할 수 있는 권한을 요청하려면 지원 팀에 문의하세요."
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/uap/windows10/4
이 확장의 요소 및 특성
<Extension Category="windows.sharedFonts">
<SharedFonts>
<Font File="[FontFile]" />
</SharedFonts>
</Extension>
| 이름 | 설명 |
|---|---|
| 범주 | 항상 windows.sharedFonts. |
| 파일 | 공유할 글꼴이 들어 있는 파일입니다. |
본보기
<Package
xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
IgnorableNamespaces="uap4">
<Applications>
<Application>
<Extensions>
<uap4:Extension Category="windows.sharedFonts">
<uap4:SharedFonts>
<uap4:Font File="Fonts\JustRealize.ttf" />
<uap4:Font File="Fonts\JustRealizeBold.ttf" />
</uap4:SharedFonts>
</uap4:Extension>
</Extensions>
</Application>
</Applications>
</Package>
UWP(유니버설 Windows 플랫폼) 앱에서 Win32 프로세스 시작
완전 신뢰에서 실행되는 Win32 프로세스를 시작합니다.
XML 네임스페이스
http://schemas.microsoft.com/appx/manifest/desktop/windows10
이 확장의 요소 및 특성
<Extension Category="windows.fullTrustProcess" Executable="[executable file]">
<FullTrustProcess>
<ParameterGroup GroupId="[GroupID]" Parameters="[Parameters]"/>
</FullTrustProcess>
</Extension>
| 이름 | 묘사 |
|---|---|
| 범주 | 항상 windows.fullTrustProcess. |
| 그룹 ID | 실행 파일에 전달하려는 매개 변수 집합을 식별하는 문자열입니다. |
| 매개 변수 | 실행 파일에 전달하려는 매개 변수입니다. |
본보기
<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
...
<Capabilities>
<rescap:Capability Name="runFullTrust"/>
</Capabilities>
<Applications>
<Application>
<Extensions>
<desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
<desktop:FullTrustProcess>
<desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
<desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
</desktop:FullTrustProcess>
</desktop:Extension>
</Extensions>
</Application>
</Applications>
</Package>
이 확장은 모든 디바이스에서 실행되는 유니버설 Windows 플랫폼 사용자 인터페이스를 만들려고 하지만 Win32 애플리케이션의 구성 요소가 완전 신뢰에서 계속 실행되도록 하려는 경우에 유용할 수 있습니다.
Win32 앱용 Windows 앱 패키지를 만들기만 하면 됩니다. 그런 다음 UWP 앱의 패키지 파일에 이 확장을 추가합니다. 이 확장은 Windows 앱 패키지에서 실행 파일을 시작하려는 경우를 나타냅니다. UWP 앱과 Win32 앱 간에 통신하려는 경우 이를 위해 하나 이상의 앱 서비스를 설정할 수 있습니다. 이 시나리오에 대한 자세한 내용은 여기 .
다음 단계
질문이 있으세요? Stack Overflow에 대해 문의하세요. 우리 팀은 이러한 태그모니터링합니다. 여기에서 요청할 수도 있습니다.
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
Windows developer