URI etkinleştirmeyi işleme

Tekdüzen Kaynak Tanımlayıcısı (URI) düzeni adının varsayılan işleyicisi olmak üzere bir uygulamayı kaydetmeyi öğrenin. Hem Windows masaüstü uygulamaları hem de Evrensel Windows Platformu (UWP) uygulamaları, URI düzeni adı için varsayılan işleyici olarak kaydedilebilir. Kullanıcı bir URI düzeni adı için varsayılan işleyici olarak uygulamanızı seçerse, bu tür URI her başlatıldığında uygulamanız etkinleştirilir.

Yalnızca bu tür URI düzeni için tüm URI başlatmalarını işlemeyi bekliyorsanız bir URI düzeni adına kaydolmanızı öneririz. Bir URI düzeni adına kaydolmayı seçerseniz, uygulamanız bu URI düzeni için etkinleştirildiğinde beklenen işlevselliği son kullanıcıya sağlamanız gerekir. Örneğin, mailto: URI düzeni adına kaydolan bir uygulama, kullanıcının yeni bir e-posta oluşturabilmesi için yeni bir e-posta iletisine açılmalıdır. URI ilişkilendirmeleri hakkında daha fazla bilgi için bkz. Dosyalar, klasörler ve kitaplıklar.

Bu adımlar, alsdk://özel bir URI düzeni adının nasıl kaydedileceğini ve kullanıcı bir alsdk:// URI'si başlattığında uygulamanızın nasıl etkinleştirileceğini gösterir.

Önemli API'ler

Bu konuda aşağıdaki API'ler kullanılır:

• Windows.ApplicationModel.Activation.ProtocolActivatedEventArgs
• Windows.UI.Xaml.Application.OnActivated
• AppInstance.GetActivatedEventArgs

1. Adım: Paket bildiriminde uzantı noktasını belirtin

Uygulama yalnızca paket bildiriminde listelenen URI düzeni adları için etkinleştirme olaylarını alır. Uygulamanızın alsdk URI düzeni adını işlediğini şu şekilde belirtirsiniz.

1. Çözüm Gezginipackage.appxmanifest dosyasına çift tıklayarak bildirim tasarımcısını açın. Bildirimler sekmesini seçin ve Kullanılabilir Bildirimler açılır listesinden Protokolü seçin ve ardından Ekle'yi tıklayın.

   Protokol bildirim tasarımcısında doldurabileceğiniz alanların her birinin kısa bir açıklaması aşağıdadır (ayrıntılar için bkz. AppX Paket Bildirimi):

2. images\Icon.png'ı Logoolarak girin.

3. Görünen ad olarak SDK Sample URI Scheme girin

4. alsdk'ı Adıolarak girin.

5. Package.appxmanifest dosyasının değişikliğini kaydetmek için Ctrl+S tuşlarına basın.

   Bu, paket bildirimine bunun gibi bir Uzantısı öğesi ekler. windows.protocol kategorisi, uygulamanın alsdk URI düzeni adını işlediğini gösterir.

    <Applications>
        <Application Id= ... >
            <Extensions>
                <uap:Extension Category="windows.protocol">
                  <uap:Protocol Name="alsdk">
                    <uap:Logo>images\icon.png</uap:Logo>
                    <uap:DisplayName>SDK Sample URI Scheme</uap:DisplayName>
                  </uap:Protocol>
                </uap:Extension>
          </Extensions>
          ...
        </Application>
   </Applications>

2. Adım: Uygun simgeleri ekleme

URI düzeni adı için varsayılan haline gelen uygulamaların simgeleri, varsayılan programlar denetim masası gibi sistem genelinde çeşitli yerlerde görüntülenir. Bu amaçla projenize 44x44 simgesi ekleyin. Uygulama kutucuğu logosunun görünümünü eşleştirin ve simgeyi saydam hale getirmek yerine uygulamanızın arka plan rengini kullanın. Logonun boşluk bırakmadan kenarlara kadar genişlemesini sağlayın. Simgelerinizi beyaz arka planlarda test edin. Simgeler hakkında daha fazla bilgi için bkz. Uygulama simgeleri ve logoları.

3. Adım: Etkinleştirilmiş olayı işleme

UWP uygulamalarında, OnActivated olay işleyicisi tüm etkinleştirme olaylarını alır. Kind özelliği etkinleştirme olayının türünü gösterir. Bu örnek, Protokolü etkinleştirme olaylarını işleyecek şekilde ayarlanmıştır.

public partial class App
{
   protected override void OnActivated(IActivatedEventArgs args)
  {
      if (args.Kind == ActivationKind.Protocol)
      {
         ProtocolActivatedEventArgs eventArgs = args as ProtocolActivatedEventArgs;
         // TODO: Handle URI activation
         // The received URI is eventArgs.Uri.AbsoluteUri
      }
   }
}

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs const& args)
{
    if (args.Kind() == Windows::ApplicationModel::Activation::ActivationKind::Protocol)
    {
        auto protocolActivatedEventArgs{ args.as<Windows::ApplicationModel::Activation::ProtocolActivatedEventArgs>() };
        // TODO: Handle URI activation  
        auto receivedURI{ protocolActivatedEventArgs.Uri().RawUri() };
    }
}

void App::OnActivated(Windows::ApplicationModel::Activation::IActivatedEventArgs^ args)
{
   if (args->Kind == Windows::ApplicationModel::Activation::ActivationKind::Protocol)
   {
      Windows::ApplicationModel::Activation::ProtocolActivatedEventArgs^ eventArgs =
          dynamic_cast<Windows::ApplicationModel::Activation::ProtocolActivatedEventArgs^>(args);
      
      // TODO: Handle URI activation  
      // The received URI is eventArgs->Uri->RawUri
   }
}

Aşağıdaki kod, uygulamayı URI'sini kullanarak program aracılığıyla başlatır:

   // Launch the URI
   var uri = new Uri("alsdk:");
   var success = await Windows.System.Launcher.LaunchUriAsync(uri)

Bir uygulamayı URI aracılığıyla başlatma hakkında daha fazla bilgi için bkz. URI için varsayılan uygulamayı başlatma.

Uygulamaların yeni bir sayfa açan her etkinleştirme olayı için yeni bir XAML Çerçeve oluşturması önerilir. Bu şekilde, yeni XAML Frame için gezinti arka yığını, uygulamanın askıya alındığında geçerli pencerede sahip olabileceği önceki içeriği içermez. Başlatma ve Dosya Sözleşmeleri için tek bir XAML Çerçeve kullanmaya karar veren uygulamalar, yeni bir sayfaya geçmeden önce Çerçeve gezinti günlüğündeki sayfaları temizlemelidir.

Protokol etkinleştirme yoluyla başlatıldığında, uygulamalar kullanıcının uygulamanın en üst sayfasına geri dönmesine izin veren kullanıcı arabirimini dahil etmeyi göz önünde bulundurmalıdır.

Açıklamalar

Herhangi bir uygulama veya web sitesi, kötü amaçlı olanlar da dahil olmak üzere URI düzeni adınızı kullanabilir. Bu nedenle URI'de elde ettiğiniz tüm veriler güvenilmeyen bir kaynaktan gelebilir. URI'de aldığınız parametrelere göre hiçbir zaman kalıcı bir eylem gerçekleştirmemenizi öneririz. Örneğin, URI parametreleri uygulamayı bir kullanıcının hesap sayfasında başlatmak için kullanılabilir, ancak bunları kullanıcının hesabını doğrudan değiştirmek için hiçbir zaman kullanmamanızı öneririz.

Uygulamaların yeni bir Uri hedefi açan her etkinleştirme olayı için yeni bir XAML Çerçeve oluşturmasını öneririz. Bu şekilde, yeni XAML Frame için gezinti arka yığını, uygulamanın askıya alındığında geçerli pencerede sahip olabileceği önceki içeriği içermez.

Uygulamalarınızın Başlatma ve Protokol Sözleşmeleri için tek bir XAML Çerçeve kullanmasına karar verirseniz, yeni bir sayfaya geçmeden önce Frame gezinti günlüğündeki sayfaları temizleyin. Protokol Sözleşmesi aracılığıyla başlatıldığında, kullanıcının uygulamanın en üstüne geri dönmesine izin veren kullanıcı arabirimini uygulamalarınıza eklemeyi göz önünde bulundurun.

İlgili içerik

• Association UWP örnek başlatan
• Varsayılan Programlar
• Dosya etkinleştirme işlemini yönet