빠른 시작: 파일 선택기 계약과 통합(Windows 런타임 앱)

아티클
12/11/2015

[ 이 문서는 Windows 런타임 앱을 작성하는 Windows에서 8.x 및 Windows Phone 8.x 개발자를 대상으로 합니다. Windows 10용으로 개발하는 경우에는 최신 설명서를 참조하세요.]

파일 열기 선택기 계약, 파일 저장 선택기 계약 또는 캐시된 파일 업데이트 프로그램 계약과 앱을 통합하여 파일 선택기를 통해 앱 콘텐츠에 대한 액세스, 저장 위치 또는 파일 업데이트를 제공합니다.

사전 요구 사항

앱이 파일 선택기 창에서 제공할 서비스 결정

앱에서는 관련 앱 계약과 통합하여 다음과 같은 서비스를 다른 앱에 제공할 수 있습니다. 계약에 참여하려면 앱 매니페스트에 계약을 선언하고, 해당하는 활성화된 이벤트에 응답하고, 특수 앱 보기를 만들어야 합니다.

파일에 대한 액세스 제공

앱에서 해당 파일의 표시가 고유하거나 중요한 경우 또는 사용자가 다른 방법으로는 파일에 쉽게 액세스할 수 없는 경우 파일 선택기에서 파일에 액세스할 수 있도록 합니다.

앱 계약: 파일 열기 선택기 계약

활성화된 이벤트 정보: fileOpenPickerActivatedEventArgs

저장 위치 제공

사용자가 나중에 앱에서 파일을 열어 작업할 수 있도록 파일을 저장하려는 경우를 위해 파일 선택기를 통한 저장 위치를 제공합니다.

앱 계약: 파일 저장 선택기 계약

활성화된 이벤트 정보: fileSavePickerActivatedEventArgs

파일에 대한 실시간 업데이트 제공

사용자가 앱에서 액세스를 제공하거나 앱을 사용하여 저장 위치로 저장된 파일의 중앙 리포지토리로 앱을 사용하려는 경우를 위해 파일 선택기를 통해 파일을 추적하고 업데이트합니다.

앱 계약: 캐시된 파일 업데이트 프로그램 계약

활성화된 이벤트 정보: cachedFileUpdaterActivatedEventArgs

앱에서 파일 선택기를 통해 제공할 수 있는 서비스에 대한 자세한 내용은 파일 선택기를 사용하여 파일에 액세스를 참조하세요.

앱 매니페스트에 계약 선언

Microsoft Visual Studio에서 프로젝트를 연 상태로 다음 단계를 따라 앱 계약을 매니페스트에 추가합니다.

프로젝트에 대한 새 항목 추가 창을 표시하고, 가운데 창에서 계약을 선택하고, 추가 단추를 클릭하여 앱 계약을 추가합니다.

다음 여러 가지 방법으로 Visual Studio에서 새 항목 추가 창을 표시할 수 있습니다.
- 프로젝트 > 새 항목 추가... 메뉴 옵션 선택
- 프로젝트의 상황에 맞는 메뉴에서 추가 > 새 항목... 메뉴 옵션 선택
- Crtl+Shift+A 바로 가기 키 사용
팁 이러한 계약을 추가하면 Visual Studio에서는 자동으로 "package.appmanifest" 매니페스트 파일을 업데이트하고 앱의 서비스를 호출할 때 파일 선택기 창에서 호스트되는 보기의 동작 및 레이아웃을 정의하는 데 사용하는 파일을 프로젝트에 추가합니다.
기본 설정이 앱에 적합하지 않은 경우 Visual Studio에서 계약 설정을 사용자 지정합니다.
1. "package.appmanifest"를 엽니다.
2. 선언 탭을 엽니다.
3. 지원되는 선언 목록에서 계약 이름을 선택합니다.
4. 특정 파일 형식에 대한 지원을 추가합니다.
  
  지원되는 파일 형식 상자에서 SupportsAnyFileType 확인란의 선택을 취소합니다.
  
  이 단계에서 지원할 각 파일 형식에 대해 새 FileType 필드를 추가합니다.
  1. 새로 추가 단추를 클릭합니다.
  2. 지원할 파일 형식의 확장명을 FileType 필드에 입력합니다(예: *.ext).
  팁 앱, 사용자 및 계약과 직접 관련이 있는 파일 형식만 추가하세요. 이와 같이 파일 형식을 제한하면 파일 선택기 보기를 깔끔하고 사용하기 편하게 유지할 수 있습니다.
또한 앞의 단계를 수행하고 제거할 형식에 대해 제거 단추를 클릭하여 파일 형식에 대한 지원을 제거할 수도 있습니다. 제거 단추는 FileType 필드 바로 위에 있습니다.

매니페스트 파일에서 추가한 계약에 대한 표시가 업데이트됩니다. 추가한 계약을 나타내는 요소가 매니페스트 XML 표시에 Extensions 요소의 하위 요소로 삽입됩니다. 예를 들어 모든 파일 형식을 지원하는 파일 열기 선택기 계약에 대한 표시는 다음과 같습니다.


  <Extension Category="windows.filePicker" StartPage="filePicker.html">
    <FileOpenPicker>
      <SupportedFileTypes SupportsAnyFileType="true" />
    </FileOpenPicker>
  </Extension>

파일 선택기에서 응용 프로그램이 활성화될 때 응답

처리기에 전달된 개체가 매니페스트에 선언한 계약과 관련이 있는지 테스트한 다음 앱의 파일 선택기 보기를 표시하는 코드를 활성화된 이벤트 처리기에 추가합니다.

각 계약은 앱에서 제공하는 서비스 중 하나를 파일 선택기에서 호출할 때 발생하는 활성화된 이벤트에 대한 정보를 제공하는 개체와 연결되어 있습니다.

파일 열기 선택기 계약 - fileOpenPickerActivatedEventArgs

파일 저장 선택기 계약 - fileSavePickerActivatedEventArgs

캐시된 파일 업데이트 프로그램 계약 - cachedFileUpdaterActivatedEventArgs

파일 선택기에 호스트될 앱의 특수 보기 만들기

파일 선택기에 대한 지침 및 검사 목록의 지침은 파일 선택기에서 호스트되는 앱 보기를 디자인하는 데 도움이 됩니다.

궁극적으로 보기는 다음 항목으로 구성되어야 합니다.

파일 선택기 레터박스를 적절히 사용자 지정하는 코드
파일 선택기의 (파일이 표시되는) 프레임 영역 레이아웃을 정의하는 태그 및 스타일
프레임 영역에 파일이 표시되도록 데이터 원본을 태그에 바인딩하는 코드

다른 앱에서 호출한 파일 선택기에서 앱이 제공하는 서비스 테스트

앱이 파일 선택기에서 제공하는 서비스를 테스트하려면 앱이 제공하는 서비스에 해당하는 활성화된 이벤트를 트리거해야 합니다. 앱을 직접 실행해서는 이 이벤트를 트리거할 수 없습니다.

대신 다음 단계에 따라 각 계약에 해당하는 활성화된 이벤트를 트리거하세요.

앱의 파일 열기 선택기 계약 참여를 테스트하는 방법:

자신의 앱이 아닌 앱을 실행합니다.
이 다른 앱의 UI를 통해 파일 선택기 창을 호출하여 파일에 액세스합니다.
파일 선택기의 위치 목록에서 자신의 앱을 선택하여 파일 선택기에 호스트된 상태로 앱을 표시합니다.

앱의 파일 저장 선택기 계약 참여를 테스트하는 방법:

자신의 앱이 아닌 앱을 실행합니다.
이 다른 앱의 UI를 통해 파일 선택기 창을 호출하여 파일을 저장합니다.
파일 선택기의 위치 목록에서 자신의 앱을 선택하여 파일 선택기에 호스트된 상태로 앱을 표시합니다.

앱의 캐시된 파일 업데이트 프로그램 계약 참여를 테스트하는 방법:

자신의 앱이 아닌 앱을 실행합니다.
이 다른 앱의 UI를 통해 파일 선택기 창을 호출하여 업데이트 표시한 파일을 액세스하거나 저장합니다.

요약

앱에서는 앱 계약에 참여하여 다른 앱에 서비스를 제공할 수 있습니다. 계약에 참여하려면 앱 매니페스트에 계약을 선언하고, 해당하는 활성화된 이벤트에 응답하고, 특수 앱 보기를 만들어야 합니다.