İzlenecek yol: ClickOnce uygulamasını el ile dağıtma

  • Makale

ClickOnce uygulamanızı dağıtmak için Visual Studio'yu kullanamıyorsanız veya Güvenilen Uygulama Dağıtımı gibi gelişmiş dağıtım özelliklerini kullanmanız gerekiyorsa, ClickOnce bildirimlerinizi oluşturmak için komut satırı aracını kullanmanız Mage.exe gerekir. Bu kılavuzda, Bildirim Oluşturma ve Düzenleme Aracı komut satırı sürümünü (Mage.exe) veya grafik sürümünü (MageUI.exe) kullanarak ClickOnce dağıtımının nasıl oluşturulacağı açıklanır.

Not

.NET Core 3.1 ve .NET 5 veya üzeri için ClickOnce'da Mage.exe yerine dotnet-mage.exe kullanın. Daha fazla bilgi için bkz . .NET için ClickOnce.

Önkoşullar

Bu kılavuzda, dağıtım oluşturmadan önce seçmeniz gereken bazı önkoşullar ve seçenekler vardır.

  • Yükleyin Mage.exe ve MageUI.exe.

    Mage.exe ve MageUI.exe Windows Yazılım Geliştirme Seti'nin (SDK) bir parçasıdır. Windows SDK'sının yüklü olması veya Windows SDK'sının Visual Studio'da bulunan sürümüne sahip olmanız gerekir. Daha fazla bilgi için bkz . MSDN'de Windows SDK'sı .

  • Dağıtılacak bir uygulama sağlayın.

    Bu kılavuzda, dağıtmaya hazır olduğunuz bir Windows uygulamanız olduğu varsayılır. Bu uygulama AppToDeploy olarak adlandırılır.

  • Dağıtımın nasıl dağıtılacağını belirleyin.

    Dağıtım seçenekleri şunlardır: Web, dosya paylaşımı veya CD. Daha fazla bilgi için bkz . ClickOnce Güvenlik ve Dağıtım.

  • Uygulamanın yükseltilmiş bir güven düzeyi gerekip gerekmediğini belirleyin.

    Uygulamanız Tam Güven gerektiriyorsa (örneğin, kullanıcının sistemine tam erişim), bunu ayarlamak için seçeneğini Mage.exe kullanabilirsiniz-TrustLevel. Uygulamanız için özel bir izin kümesi tanımlamak istiyorsanız, başka bir bildirimden İnternet veya intranet izin bölümünü kopyalayabilir, gereksinimlerinize uyacak şekilde değiştirebilir ve bir metin düzenleyicisi veya MageUI.exe kullanarak uygulama bildirimine ekleyebilirsiniz. Daha fazla bilgi için bkz . Güvenilen Uygulama Dağıtımına genel bakış.

  • Authenticode sertifikası alın.

    Dağıtımınızı bir Authenticode sertifikasıyla imzalamanız gerekir. Visual Studio, MageUI.exe, veya MakeCert.exePvk2Pfx.exe araçları kullanarak bir test sertifikası oluşturabilir veya Sertifika Yetkilisi'nden (CA) bir sertifika alabilirsiniz. Güvenilen Uygulama Dağıtımı'nı kullanmayı seçerseniz, sertifikanın tüm istemci bilgisayarlara tek seferlik yüklenmesini de gerçekleştirmeniz gerekir. Daha fazla bilgi için bkz . Güvenilen Uygulama Dağıtımına Genel Bakış.

    Not

    Ayrıca, dağıtımınızı sertifika yetkilisinden edinebileceğiniz bir CNG sertifikasıyla da imzalayabilirsiniz.

  • Uygulamanın UAC bilgilerini içeren bir bildirimi olmadığından emin olun.

    Uygulamanızın bir öğe gibi Kullanıcı Hesabı Denetimi (UAC) bilgilerini içeren bir <dependentAssembly> bildirim içerip içermediğini belirlemeniz gerekir. Bir uygulama bildirimini incelemek için Windows Sysinternals Sigcheck yardımcı programını kullanabilirsiniz.

    Uygulamanız UAC ayrıntılarını içeren bir bildirim içeriyorsa, UAC bilgileri olmadan yeniden oluşturmanız gerekir. Visual Studio'daki bir C# projesi için proje özelliklerini açın ve Uygulama sekmesini seçin. Bildirim açılan listesinde Bildirim olmadan uygulama oluştur'u seçin. Visual Studio'daki bir Visual Basic projesi için proje özelliklerini açın, Uygulama sekmesini seçin ve UAC Ayarlar Görüntüle'ye tıklayın. Açılan bildirim dosyasında, tek <asmv1:assembly> öğe içindeki tüm öğeleri kaldırın.

  • Uygulamanın istemci bilgisayarda önkoşulları gerektirip gerektirmediğini belirleyin.

    Visual Studio'dan dağıtılan ClickOnce uygulamaları, dağıtımınıza bir önkoşul yükleme önyükleyicisi (setup.exe) içerebilir. Bu izlenecek yol, ClickOnce dağıtımı için gereken iki bildirimi oluşturur. GenerateBootstrapper görevini kullanarak önkoşul önyükleyicisi oluşturabilirsiniz.

Mage.exe komut satırı aracıyla uygulama dağıtmak için

  1. ClickOnce dağıtım dosyalarınızı depoladığınız bir dizin oluşturun.

  2. Yeni oluşturduğunuz dağıtım dizininde bir sürüm alt dizini oluşturun. Uygulamayı ilk kez dağıtıyorsanız sürüm alt dizinini 1.0.0.0 olarak adlandırın.

    Not

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

  3. Yürütülebilir dosyalar, derlemeler, kaynaklar ve veri dosyaları dahil olmak üzere tüm uygulama dosyalarınızı sürüm alt dizinine kopyalayın. Gerekirse, ek dosyalar içeren ek alt dizinler oluşturabilirsiniz.

  4. Windows SDK'sını veya Visual Studio komut istemini açın ve sürüm alt dizinine geçin.

  5. Mage.exe çağrısıyla uygulama bildirimini oluşturun. Aşağıdaki deyim, Intel x86 işlemcisinde çalıştırılacak şekilde derlenmiş kod için bir uygulama bildirimi oluşturur.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .

    Not

    Geçerli dizini gösteren seçeneğin -FromDirectory arkasına nokta (.) eklemeyi unutmayın. Noktayı eklemezseniz, uygulama dosyalarınızın yolunu belirtmeniz gerekir.

  6. Uygulama bildirimini Authenticode sertifikanızla imzalayın. değerini sertifika dosyanızın yoluyla değiştirin mycert.pfx . passwd değerini sertifika dosyanızın parolası ile değiştirin.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd

    Visual Studio ve Windows SDK ile dağıtılan .NET Framework 4.6.2 SDK'sı ile başlayarak, mage.exe bildirimleri CNG ve Authenticode sertifikaları ile imzalar. Authenticode sertifikalarıyla aynı komut satırı parametrelerini kullanın.

  7. Dağıtım dizininin köküne geçin.

  8. çağrısıyla dağıtım bildirimini Mage.exeoluş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 değerini falseiçeren seçeneğini kullanın-Install. Varsayılanı kullanırsanız ve kullanıcılar uygulamanızı bir Web sitesinden veya dosya paylaşımından yüklerse, seçenek değerinin -ProviderUrl Web sunucusu veya paylaşımındaki uygulama bildiriminin konumunu gösterdiğinden emin olun.

    mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application

  9. Authenticode veya CNG sertifikanızla dağıtım bildirimini imzalayın.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

  10. Dağıtım dizinindeki tüm dosyaları dağıtım hedefine veya medyasına kopyalayın. Bu, Web sitesindeki veya FTP sitesindeki bir klasör, dosya paylaşımı veya CD-ROM olabilir.

  11. Kullanıcılarınıza uygulamanızı yüklemek için gereken URL, UNC veya fiziksel medyayı sağlayın. BIR URL veya UNC sağlarsanız, kullanıcılarınıza dağıtım bildiriminin tam yolunu vermelisiniz. Örneğin, AppToDeploy appToDeploy dizininde uygulamasına http://webserver01/ dağıtılırsa, tam URL yolu olacaktır http://webserver01/AppToDeploy/AppToDeploy.application.

bir uygulamayı MageUI.exe grafik aracıyla dağıtmak için

  1. ClickOnce dağıtım dosyalarınızı depoladığınız bir dizin oluşturun.

  2. Yeni oluşturduğunuz dağıtım dizininde bir sürüm alt dizini oluşturun. Uygulamayı ilk kez dağıtıyorsanız sürüm alt dizinini 1.0.0.0 olarak adlandırın.

    Not

    Dağıtımınızın sürümü büyük olasılıkla uygulamanızın sürümünden farklıdır.

  3. Yürütülebilir dosyalar, derlemeler, kaynaklar ve veri dosyaları dahil olmak üzere tüm uygulama dosyalarınızı sürüm alt dizinine kopyalayın. Gerekirse, ek dosyalar içeren ek alt dizinler oluşturabilirsiniz.

  4. MageUI.exe Grafik aracı başlatın.

    MageUI.exe

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

  6. Varsayılan Ad sekmesinde, bu dağıtımın adını ve sürüm numarasını yazın. Ayrıca uygulamanızın oluşturulduğu İşlemciyi (örneğin, x86) belirtin.

  7. Dosyalar sekmesini seçin ve ardından Uygulama dizini metin kutusunun yanındaki üç nokta (...) düğmesini seçin. Klasöre Gözat iletişim kutusu görüntülenir.

  8. Uygulama dosyalarınızı içeren sürüm alt dizinini ve ardından Tamam'ı seçin.

  9. Internet Information Services'ten (IIS) dağıtım yapacaksanız, Açılırken .deploy uzantısını sahip olmayan herhangi bir dosyaya ekleyin onay kutusunu seçin.

  10. Tüm uygulama dosyalarınızı dosya listesine eklemek için Doldur düğmesine gidin. 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şaretler.)

  11. Gerekli İzinler sekmesini seçin ve uygulamanızın onaylaması gereken güven düzeyini seçin. Varsayılan değer, çoğu uygulama için uygun olan FullTrust'dır.

  12. Menüden Dosya, Farklı Kaydet'i seçin. Uygulama bildirimini imzalamanızı isteyen bir İmzalama Seçenekleri iletişim kutusu görüntülenir.

  13. Dosya sisteminizde dosya olarak depolanan bir sertifikanız varsa Sertifika dosyasıyla imzala seçeneğini kullanın ve üç nokta (...) düğmesini kullanarak dosya sisteminden sertifikayı seçin. Ardından sertifika parolanızı yazın.

    -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.

  14. Uygulama bildiriminizi imzalamak için Tamam'ı seçin. Farklı Kaydet iletişim kutusu açılır.

  15. Farklı Kaydet iletişim kutusunda sürüm dizinini belirtin ve kaydet'i seçin.

  16. Dağıtım bildiriminizi oluşturmak için menüden Dosya, Yeni, Dağıtım Bildirimi'ni seçin.

  17. Ad sekmesinde, bu dağıtım için bir ad ve sürüm numarası belirtin (bu örnekte 1.0.0.0). Ayrıca uygulamanızın oluşturulduğu İşlemciyi (örneğin, x86) belirtin.

  18. Açıklama sekmesini seçin ve Publisher ve Product değerlerini belirtin. (Ürün, uygulamanız çevrimdışı kullanım için bir istemci bilgisayara yüklendiğinde Windows Başlat menüsü uygulamanıza verilen addır.)

  19. Dağıtım Seçenekleri sekmesini seçin ve Başlangıç Konumu metin kutusunda Web sunucusu veya paylaşımındaki uygulama bildiriminin konumunu belirtin. Örneğin, \\myServer\myShare\AppToDeploy.application.

  20. Uzantıyı .deploy önceki bir adımda eklediyseniz, burada .deploy dosya adı uzantısını kullan'ı da seçin.

  21. Güncelleştirme Seçenekleri sekmesini seçin ve bu uygulamanın ne sıklıkta güncelleştirileceğini belirtin. Uygulamanız güncelleştirmeleri denetlemek için kullanıyorsa UpdateCheckInfo Bu uygulama güncelleştirmeleri denetlemelidir onay kutusunu temizleyin.

  22. Uygulama Başvurusu sekmesini seçin ve bildirim seç düğmesine gidin. Açık bir iletişim kutusu görüntülenir.

  23. Daha önce oluşturduğunuz uygulama bildirimini ve ardından Aç'ı seçin.

  24. Menüden Dosya, Farklı Kaydet'i seçin. Dağıtım bildirimini imzalamanızı isteyen bir İmzalama Seçenekleri iletişim kutusu görüntülenir.

  25. Dosya sisteminizde dosya olarak depolanan bir sertifikanız varsa Sertifika dosyasıyla imzala seçeneğini kullanın ve üç nokta (...) düğmesini kullanarak dosya sisteminden sertifikayı seçin. Ardından sertifika parolanızı yazın.

    -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.

  26. Dağıtım bildiriminizi imzalamak için Tamam'a gidin. Farklı Kaydet iletişim kutusu açılır.

  27. Farklı Kaydet iletişim kutusunda, dağıtımınızın köküne bir dizin yukarı gidin ve Kaydet'i seçin.

  28. Dağıtım dizinindeki tüm dosyaları dağıtım hedefine veya medyasına kopyalayın. Bu, Web sitesindeki veya FTP sitesindeki bir klasör, dosya paylaşımı veya CD-ROM olabilir.

  29. Kullanıcılarınıza uygulamanızı yüklemek için gereken URL, UNC veya fiziksel medyayı sağlayın. URL veya UNC sağlarsanız, kullanıcılarınıza dağıtım bildiriminin tam yolunu vermelisiniz. Örneğin, AppToDeploy appToDeploy dizininde uygulamasına http://webserver01/ dağıtılırsa, tam URL yolu olacaktır http://webserver01/AppToDeploy/AppToDeploy.application.

Sonraki adımlar

Uygulamanın yeni bir sürümünü dağıtmanız gerektiğinde, yeni sürümden (örneğin, 1.0.0.1) sonra adlı yeni bir dizin oluşturun ve yeni uygulama dosyalarını yeni dizine kopyalayın. Ardından, yeni bir uygulama bildirimi oluşturup imzalamak ve dağıtım bildirimini güncelleştirmek ve imzalamak için önceki adımları izlemeniz gerekir. Hem hem de Mage.exe-New-Update çağrılarında aynı yüksek sürümü belirtmeye dikkat edin. ClickOnce yalnızca en yüksek sürümleri güncelleştirir ve en soldaki tamsayı en önemli olur. MageUI.exe kullandıysanız dağıtım bildirimini açarak, Uygulama Başvurusu sekmesini seçerek, Bildirim Seç düğmesine gidip güncelleştirilmiş uygulama bildirimini seçerek güncelleştirebilirsiniz.

İlgili içerik