다음을 통해 공유


AppExtensionCatalog.PackageInstalled 이벤트

정의

확장 패키지가 설치될 때 발생하는 이벤트입니다.

// Register
event_token PackageInstalled(TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;

// Revoke with event_token
void PackageInstalled(event_token const* cookie) const;

// Revoke with event_revoker
AppExtensionCatalog::PackageInstalled_revoker PackageInstalled(auto_revoke_t, TypedEventHandler<AppExtensionCatalog, AppExtensionPackageInstalledEventArgs const&> const& handler) const;
public event TypedEventHandler<AppExtensionCatalog,AppExtensionPackageInstalledEventArgs> PackageInstalled;
function onPackageInstalled(eventArgs) { /* Your code */ }
appExtensionCatalog.addEventListener("packageinstalled", onPackageInstalled);
appExtensionCatalog.removeEventListener("packageinstalled", onPackageInstalled);
- or -
appExtensionCatalog.onpackageinstalled = onPackageInstalled;
Public Custom Event PackageInstalled As TypedEventHandler(Of AppExtensionCatalog, AppExtensionPackageInstalledEventArgs) 

이벤트 유형

설명

AppExtensionPackageInstalledEventArgs.Extensions 이벤트 인수에는 확장 패키지 내의 확장 목록이 포함됩니다.

확장은 확장의 Package.appxmanifest 파일에 정의된 에 의해 <uap3:AppExtension Name=...> 범위가 지정됩니다. 호스트의 Package.appxmanifest 파일에 정의된 확장과 일치하는 <uap3:AppExtension Name=...> 확장만 확장 목록에 있습니다.

이 이벤트에 대한 이벤트 처리기는 각 앱 확장에서 정확성을 검사하고 사용자에게 사용할 수 있는 옵션을 제공하는 데 적합합니다.

AppExtension에 대한 배포 단위는 패키지입니다. 이것이 AppExtension 설치 이벤트가 아닌 패키지 설치 이벤트인 이유입니다.

일반적으로 패키지에는 하나의 확장만 있습니다. 그러나 패키지에 여러 확장이 있는 경우를 처리하도록 준비해야 합니다.

AppExtension.Id 사용하여 동일한 패키지의 확장을 구분합니다. 앱에서 확장을 고유하게 식별하려면 AppInfo.AppUserModelId 를 연결하고 다음을 AppExtension.Id.

_uniqueId = yourAppExtention.AppInfo.AppUserModelId + "!" + yourAppExtention.Id;

이렇게 하면 각 AppExtension 에 앱에서 추적할 수 있는 고유한 이름이 보장됩니다. 지정된 AppExtension이 이미 알고 있는 AppExtension 인지 효율적이고 정확하게 식별할 수 있도록 AppExtensions 의 키로 사용하는 것이 좋습니다.

적용 대상