İzlenecek yol: Yeniden imzalama gerektirmeyen ve marka bilgilerini koruyan bir ClickOnce uygulamasını el ile dağıtma

Bir ClickOnce uygulaması oluşturduğunuzda ve bunu yayımlamak ve dağıtmak için bir müşteriye verdiğinizde, müşterinin geleneksel olarak dağıtım bildirimini güncelleştirmesi ve yeniden imzalaması gerekir. Çoğu durumda tercih edilen yöntem bu olsa da, .NET Framework 3.5 yeni bir dağıtım bildirimi oluşturmak zorunda kalmadan müşteriler tarafından dağıtılabilir ClickOnce dağıtımları oluşturmanıza olanak tanır. Daha fazla bilgi için bkz . İstifa etmeden test ve üretim sunucuları için ClickOnce uygulamalarını dağıtma.

Bir ClickOnce uygulaması oluşturduğunuzda ve bunu yayımlamak ve dağıtmak için bir müşteriye verdiğinizde, uygulama müşterinin markasını kullanabilir veya markanızı koruyabilir. Örneğin, uygulama tek bir özel uygulamaysa markanızı korumak isteyebilirsiniz. Uygulama her müşteri için yüksek oranda özelleştirilmişse, müşterinin markasını kullanmak isteyebilirsiniz. .NET Framework 3.5, bir kuruluşa dağıtılacak bir uygulama verdiğinizde markanızı, yayımcı bilgilerinizi ve güvenlik imzanızı korumanıza olanak tanır. Daha fazla bilgi için bkz . Başkalarının dağıtacağı ClickOnce uygulamaları oluşturma.

Önkoşullar

Bu kılavuzdaki adımları gerçekleştirmek için aşağıdakilere ihtiyacınız vardır:

• Dağıtmaya hazır olduğunuz bir Windows Forms uygulaması. Bu uygulamaya WindowsFormsApp1 adı verilecektir.

• Visual Studio veya Windows SDK'sı.

Mage.exe kullanarak birden çok dağıtım ve marka desteğine sahip bir ClickOnce uygulaması dağıtmak için

1. Bir Visual Studio komut istemi veya Windows SDK komut istemi açın ve ClickOnce dosyalarınızı depoladığınız dizine geçin.

2. Dağıtımınızın geçerli sürümünden sonra adlı bir dizin oluşturun. Uygulamayı ilk kez dağıtıyorsanız büyük olasılıkla 1.0.0.0'ı seçersiniz.

   Dekont

   Dağıtımınızın sürümü, uygulama dosyalarınızın sürümünden farklı olabilir.

3. Bin adlı bir alt dizin oluşturun ve yürütülebilir dosyalar, derlemeler, kaynaklar ve veri dosyaları dahil olmak üzere tüm uygulama dosyalarınızı buraya kopyalayın.

4. Mage.exe çağrısıyla uygulama bildirimi oluşturun.

   mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"
   

5. Uygulama bildirimini dijital sertifikanızla imzalayın.

   mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
   

6. Mage.exe çağrısıyla dağıtım bildirimi oluşturun. Varsayılan olarak, Mage.exe ClickOnce dağıtımınızı yüklü bir uygulama olarak işaretler, böylece hem çevrimiçi hem de çevrimdışı çalıştırılabilir. Uygulamayı yalnızca kullanıcı çevrimiçi olduğunda kullanılabilir hale getirmek için bağımsız değişkenini -i değeriyle fkullanın. Bu uygulama birden çok dağıtım özelliğinden yararlanacağı için Mage.exe bağımsız değişkenini -providerUrl hariç tutun. (.NET Framework'ün 3.5 sürümünden önceki sürümlerinde, çevrimdışı bir uygulama hariç olmak -providerUrl hataya neden olur.)

   mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest
   

7. Dağıtım bildirimini imzalamayın.

8. Tüm dosyaları, uygulamayı ağına dağıtacak olan müşteriye sağlayın.

9. Bu noktada müşterinin dağıtım bildirimini kendi kendi ürettiği sertifikayla imzalaması gerekir. Örneğin müşteri Adventure Works adlı bir şirkette çalışıyorsa MakeCert.exe aracını kullanarak otomatik olarak imzalanan bir sertifika oluşturabilir. Ardından, MakeCert.exe tarafından oluşturulan dosyaları Mage.exe'ye geçirilebilen bir PFX dosyasında birleştirmek için Pvk2pfx.exe aracını kullanın.

   makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
   pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
   

10. Müşteri daha sonra dağıtım bildirimini imzalamak için bu sertifikayı kullanır.

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
    

11. Müşteri uygulamayı kullanıcılarına dağıtır.

MageUI.exe kullanarak birden çok dağıtım ve marka desteğine sahip bir ClickOnce uygulaması dağıtmak için

1. Bir Visual Studio komut istemi veya Windows SDK komut istemi açın ve ClickOnce dosyalarınızı depoladığınız dizine gidin.

2. Bin adlı bir alt dizin oluşturun ve yürütülebilir dosyalar, derlemeler, kaynaklar ve veri dosyaları dahil olmak üzere tüm uygulama dosyalarınızı buraya kopyalayın.

3. Dağıtımınızın geçerli sürümünden sonra adlı bir alt dizin oluşturun. Uygulamayı ilk kez dağıtıyorsanız büyük olasılıkla 1.0.0.0'ı seçersiniz.

   Dekont

   Dağıtımınızın sürümü, uygulama dosyalarınızın sürümünden farklı olabilir.

4. \bin dizinini 2. adımda oluşturduğunuz dizine taşıyın.

5. MageUI.exe grafik aracını başlatın.

   MageUI.exe
   

6. Menüden Dosya, Yeni, Uygulama Bildirimi'ni seçerek yeni bir uygulama bildirimi oluşturun.

7. Varsayılan Ad sekmesinde, bu dağıtımın adını ve sürüm numarasını girin. Ayrıca Publisher için, dağıtıldığında uygulamanın Başlat menüsü kısayol bağlantısı için klasör adı olarak kullanılacak bir değer sağlayın.

8. Uygulama Seçenekleri sekmesini seçin ve Güven Bilgileri için Uygulama Bildirimini Kullan'a tıklayın. Bu, bu ClickOnce uygulaması için üçüncü taraf markasını etkinleştirir.

9. Dosyalar sekmesini seçin ve Uygulama Dizini metin kutusunun yanındaki Gözat düğmesine tıklayın.

10. 2. adımda oluşturduğunuz uygulama dosyalarınızı içeren dizini seçin ve klasör seçimi iletişim kutusunda Tamam'a tıklayın.

11. Tüm uygulama dosyalarınızı dosya listesine eklemek için Doldur düğmesine tıklayın. Uygulamanız birden fazla yürütülebilir dosya içeriyorsa, Dosya Türü açılan listesinden Giriş Noktası'nı seçerek bu dağıtımın ana yürütülebilir dosyasını başlangıç uygulaması olarak işaretleyin. (Uygulamanız yalnızca bir yürütülebilir dosya içeriyorsa, MageUI.exe sizin için işaretleyecektir.)

12. İzinler Gerekli sekmesini seçin ve uygulamanızın onaylaması için ihtiyacınız olan güven düzeyini seçin. Varsayılan değer, çoğu uygulama için uygun olan Tam Güven'dir.

13. Menüden Dosya, Kaydet'i seçin ve uygulama bildirimini kaydedin. Kaydettiğinizde uygulama bildirimini imzalamanız istenir.

14. Dosya sisteminizde dosya olarak depolanan bir sertifikanız varsa, Sertifika dosyası olarak imzala seçeneğini kullanın ve üç nokta (...) düğmesini kullanarak dosya sisteminden sertifikayı seçin.

    -veya-

    Sertifikanız bilgisayarınızdan erişilebilen bir sertifika deposunda tutuluyorsa, Depolanan sertifikayla imzala seçeneğini belirleyin ve sağlanan listeden sertifikayı seçin.

15. Dağıtım bildiriminizi oluşturmak için menüden Dosya, Yeni, Dağıtım Bildirimi'ni seçin ve ardından Ad sekmesinde bir ad ve sürüm numarası (bu örnekte 1.0.0.0) sağlayın.

16. Güncelleştir sekmesine geçin ve bu uygulamanın ne sıklıkta güncelleştirilmesini istediğinizi belirtin. Uygulamanız güncelleştirmeleri denetlemek için ClickOnce Dağıtım API'sini kullanıyorsa Bu uygulama güncelleştirmeleri denetlemelidir etiketli onay kutusunu temizleyin.

17. Uygulama Başvurusu sekmesine geçin. Bildirim Seç düğmesine tıklayıp önceki adımlarda oluşturduğunuz uygulama bildirimini seçerek bu sekmedeki tüm değerleri önceden doldurabilirsiniz.

18. Kaydet'i seçin ve dağıtım bildirimini diske kaydedin. Kaydettiğinizde uygulama bildirimini imzalamanız istenir. Bildirimi imzalamadan kaydetmek için İptal'e tıklayın.

19. Tüm uygulama dosyalarını müşteriye sağlayın.

20. Bu noktada müşterinin dağıtım bildirimini kendi kendi ürettiği sertifikayla imzalaması gerekir. Örneğin müşteri Adventure Works adlı bir şirkette çalışıyorsa MakeCert.exe aracını kullanarak otomatik olarak imzalanan bir sertifika oluşturabilir. Ardından, MakeCert.exe tarafından oluşturulan dosyaları MageUI.exe dosyasına geçirilebilen bir PFX dosyasında birleştirmek için Pvk2pfx.exe aracını kullanın.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
    pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
    

21. Sertifika oluşturulduktan sonra müşteri artık dağıtım bildirimini MageUI.exe dosyasında açıp kaydederek dağıtım bildirimini imzalar. İmzalama iletişim kutusu görüntülendiğinde müşteri Sertifika dosyası olarak imzala seçeneğini belirler ve diske kaydettiği PFX dosyasını seçer.

22. Müşteri uygulamayı kullanıcılarına dağıtır.

İlgili içerik

• Mage.exe (Bildirim Oluşturma ve Düzenleme Aracı)
• MageUI.exe (Bildirim Oluşturma ve Düzenleme Aracı, Grafik İstemci)
• Makecert