İzlenecek yol: ClickOnce uygulamasını el ile dağıtma
Uygulamanızı dağıtmak için Visual Studio veya Güvenilen Uygulama Dağıtımı gibi gelişmiş dağıtım özelliklerini kullanıyorsanız bildirimlerinizi oluşturmak içinMage.exekomut satırı aracını ClickOnce ClickOnce kullanmalısınız. Bu kılavuzda, komut satırı sürümünü (Mage.exe) veya uygulamanın grafik sürümünü (MageUI.exe) kullanarak dağıtım ClickOnce Bildirim Oluşturma ve Düzenleme Aracı.****
Önkoşullar
Bu kılavuzda, dağıtımdan önce seçmeniz gereken bazı önkoşullar ve seçenekler vardır.
yükleme Mage.exe ve MageUI.exe.
Mage.exe ve MageUI.exe, 'nin bir Windows Software Development Kit (SDK) parçasıdır. yüklü veya ile Windows SDK’sı birlikte bulunan sürümünün yüklü olması Windows SDK’sı Visual Studio. Daha fazla bilgi için msdn'Windows SDK'sı konusuna bakın.
Dağıtıla bir uygulama sağlama.
Bu kılavuzda, dağıtıma hazır Windows bir uygulamanın olduğu varsaylanır. Bu uygulama AppToDeploy olarak adlandırılır.
Dağıtımın nasıl dağıtılacaklarını belirleme.
Dağıtım seçenekleri şunlardır: Web, dosya paylaşımı veya CD. Daha fazla bilgi için bkz. ClickOnce ve Dağıtım.
Uygulamanın yükseltilmiş bir güven düzeyi gerektirdiğini belirleme.
Uygulamanıza Tam Güven (örneğin, kullanıcının sistemine tam erişim) gerektiriyorsa, bunu ayarlamak içinMage.exe
-TrustLevelseçeneğini kullanabilirsiniz. Uygulamanıza yönelik özel bir izin kümesi tanımlamak için İnternet veya intranet izni bölümünü başka bir bildirimden kopyalayıp, kendi ihtiyaçlarınıza uyacak şekilde değiştirebilir ve bir metin düzenleyicisi ya da bir metin düzenleyici kullanarak uygulama bildirimine MageUI.exe. 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, MakeCert.exevePvk2Pfx.exearaçlarını kullanarak bir test sertifikası oluşturabilirsiniz veya bir Sertifika Yetkilisi'den (CA) bir sertifika edinebilirsiniz. Güvenilen Uygulama Dağıtımı kullanmayı seçerseniz, sertifikanın tüm istemci bilgisayarlara tek kullanımlık bir yüklemesini de gerçekleştirmeniz gerekir. Daha fazla bilgi için bkz. Güvenilen Uygulama Dağıtımına Genel Bakış.
Not
Dağıtımınızı bir Sertifika Yetkilisini elde etmek için bir CNG sertifikasıyla da imza atabilirsiniz.
Uygulamanın UAC bilgilerine sahip bir bildirime sahip olmadığını emin olun.
Uygulamanıza öğe gibi Kullanıcı Hesabı Denetimi (UAC) bilgileri içeren bir bildirim olup olmadığını belirlemeniz
<dependentAssembly>gerekir. Bir uygulama bildirimini incelemek için Sysinternals Sigcheck Windows yardımcı programını kullanabilirsiniz.Uygulamanız UAC ayrıntılarını içeren bir bildirim içeriyorsa UAC bilgileri olmadan yeniden derlemeniz gerekir. Bir C# projesi için Visual Studio proje özelliklerini açın ve Uygulama sekmesini seçin. Bildirim açılan listesinde Bildirim olmadan uygulama oluştur'a tıklayın. Bir Visual Basic projesinde Visual Studio özelliklerini açın, Uygulama sekmesini seçin ve UAC'yi görüntüle'ye tıklayın Ayarlar. Açılan bildirim dosyasında, tek öğe içindeki tüm öğeleri
<asmv1:assembly>kaldırın.Uygulamanın istemci bilgisayarda önkoşullar gerektirdiğini belirleme.
ClickOncebir önkoşul olan Visual Studio önkoşul yükleme önyükleyicisi (setup.exe) içerebilir. Bu izlenecek yol, bir dağıtım için gereken iki bildirimi ClickOnce oluşturur. GenerateBootstrapper görevini kullanarak önkoşul önyükleyicisi oluşturabilirsiniz.
Komut satırı aracını kullanarak Mage.exe dağıtmak için
Dağıtım dosyalarınızı depolayacak bir ClickOnce dizin oluşturun.
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 dizinine 1.0.0.0 adını girin.
Not
Dağıtım sürümünüz, uygulamanın sürümünden farklı olabilir.
Tüm uygulama dosyalarınızı yürütülebilir dosyalar, derlemeler, kaynaklar ve veri dosyaları da dahil olmak üzere sürüm alt dizinine kopyalayın. Gerekirse, ek dosyalar içeren ek alt dizinler oluşturabilirsiniz.
veya Windows SDK’sı komut Visual Studio açın ve sürüm alt dizinine yazın.
Mage.exeçağrısıyla uygulama bildirimini oluşturun. Aşağıdaki deyim, Intel x86 işlemcisinde çalıştıracak ş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 sonrası olan noktayı (.)
-FromDirectorydahil etmek istediğinizden emin olun. Nokta belirtmezseniz uygulama dosyalarınızın yolunu belirtmeniz gerekir.Uygulama bildirimini Authenticode sertifikanız ile imzalar. mycert.pfx dosyasını sertifika dosyanıza giden yol ile değiştirin. passwd'i sertifika dosyanız için parolayla değiştirin.
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwdVisual Studio ve Windows SDK ile dağıtılan .NET Framework 4.6.2 SDK'sı ile mage.exe, bildirimleri hem CNG hem de Authenticode sertifikaları ile imzalar. Authenticode sertifikalarla aynı komut satırı parametrelerini kullanın.
Dağıtım dizininin kök dizinine kadar olan bölümü seçin.
bir çağrısıyla dağıtım bildirimini Mage.exe. Varsayılan olarak Mage.exe, hem çevrimiçi hem de çevrimdışı çalıştırılamayacak ClickOnce şekilde dağıtımınızı yüklü bir uygulama olarak işaretlemektedir. Uygulamayı yalnızca kullanıcı çevrimiçi olduğunda kullanılabilir yapmak için değerini
-Installkullanarak seçeneğinifalsekullanın. Varsayılanı kullanırsanız ve kullanıcılar web sitesinden veya dosya paylaşımından uygulamanızı yükleyecekse, seçeneğin değerinin Web sunucusunda veya paylaşımında uygulama bildiriminin konumunu-ProviderUrlgöstermesini sağlar.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.applicationAuthenticode veya CNG sertifikanız ile dağıtım bildirimini imzalar.
mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwdDağıtım dizininde yer alan tüm dosyaları dağıtım hedefine veya medyaya kopyalayın. Bu bir Web sitesinde veya FTP sitesinde bulunan bir klasör, dosya paylaşımı veya CD-ROM olabilir.
Kullanıcılarınıza, uygulamalarınızı yüklemek için gereken URL' yi, UNC'yi veya fiziksel medyayı belirtin. Bir URL veya UNC sağlarsanız, kullanıcılarınıza dağıtım bildiriminin tam yolunu vermalısınız. Örneğin, AppToDeploy AppToDeploy dizininde 'ye http://webserver01/ dağıtılırsa, tam URL yolu http://webserver01/AppToDeploy/AppToDeploy.application olur.
Uygulamanın grafik aracıyla MageUI.exe için
Dağıtım dosyalarınızı depolayacak bir ClickOnce dizin oluşturun.
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 dizinine 1.0.0.0 adını girin.
Not
Dağıtım sürümünüz büyük olasılıkla uygulamanın sürümünden farklıdır.
Tüm uygulama dosyalarınızı yürütülebilir dosyalar, derlemeler, kaynaklar ve veri dosyaları da dahil olmak üzere sürüm alt dizinine kopyalayın. Gerekirse, ek dosyalar içeren ek alt dizinler oluşturabilirsiniz.
Grafik MageUI.exe aracını başlatma.
MageUI.exeMenüden Dosya , Yeni , Uygulama Bildirimi'yi seçerek yeni bir uygulama bildirimi oluşturun.
Varsayılan Ad sekmesinde, bu dağıtımın adını ve sürüm numarasını yazın. Ayrıca, x86 gibi, uygulamanın yerleşik olduğu İşlemciyi belirtin.
Dosyalar sekmesini 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.
Uygulama dosyalarınızı içeren sürüm alt dizinini ve ardından Tamam'ı seçin.
Internet Information Services 'den (IIS) dağıtacaksanız, .deploy uzantısını doldurmak için .deploy uzantısını sahip olmadığınız herhangi bir dosyaya ekle onay kutusunu seçin.
Tüm uygulama dosyalarınızı dosya listesine eklemek için Doldurmak düğmesine gidin. Uygulamanız birden fazla yürütülebilir dosya içeriyorsa, Dosya Türü açılan listesinden Giriş Noktası'ı seçerek bu dağıtım için ana yürütülebilir dosyayı başlangıç uygulaması olarak işaret edin. (Uygulamanız yalnızca bir yürütülebilir dosya içeriyorsaMageUI.exe sizin için işaretlemektedir.)
Gerekli İzinler sekmesini seçin ve uygulamanıza onaylamanız gereken güven düzeyini seçin. Varsayılan değer, çoğu uygulama için uygun olacak olan FullTrust'tır.
Menüden Dosya , Farklı Kaydet'i seçin. Uygulama bildirimini imzalamanız istendiğinde bir İmzalama Seçenekleri iletişim kutusu görüntülenir.
Dosya sisteminize 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 depolamada tutuluyorsa, Depolanan sertifikayla imzala seçeneğini belirleyin ve sağlanan listeden sertifikayı seçin.
Uygulama bildiriminizi imzalamak için Tamam'ı seçin. Farklı Kaydet iletişim kutusu görüntülenir.
Farklı Kaydet iletişim kutusunda sürüm dizinini belirtin ve Kaydet'i seçin.
Dağıtım bildiriminizi oluşturmak için menüden Dosya , Yeni , Dağıtım Bildirimi'ne tıklayın.
Ad sekmesinde, bu dağıtım için bir ad ve sürüm numarası belirtin (bu örnekte 1.0.0.0). Ayrıca, x86 gibi, uygulamanın yerleşik olduğu İşlemciyi belirtin.
Açıklama sekmesini seçin ve Publisher ve Product değerlerini belirtin. (Ürün, uygulamanıza çevrimdışı kullanım için Windows Başlat menüsü bir istemci bilgisayara yüklenirken uygulamanıza verilen addır.)
Dağıtım Seçenekleri sekmesini seçin ve Başlangıç Konumu metin kutusunda, Web sunucusunda veya paylaşımında uygulama bildiriminin konumunu belirtin. Örneğin, \ \myServer\myShare\AppToDeploy.application.
Önceki bir adımda .deploy uzantısını eklediysanız burada .deploy dosya adı uzantısını kullan'ı da seçin.
Güncelleştirme Seçenekleri sekmesini seçin ve bu uygulamanın ne sıklıkta güncelleştirilsini istediğinizi belirtin. Uygulamanız UpdateCheckInfo güncelleştirmeleri kendisi için kullanıyorsa Bu uygulama güncelleştirmeleri denetlemeli onay kutusunun işaretini kaldırın.
Uygulama Başvurusu sekmesini seçin ve bildirim seç düğmesine gidin. Açık bir iletişim kutusu görüntülenir.
Daha önce oluşturduğunuz uygulama bildirimini ve ardından Aç'ı seçin.
Menüden Dosya , Farklı Kaydet'i seçin. Dağıtım bildirimini imzalamanızı istediğiniz bir İmzalama Seçenekleri iletişim kutusu görüntülenir.
Dosya sisteminize 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 depolamada tutuluyorsa, Depolanan sertifikayla imzala seçeneğini belirleyin ve sağlanan listeden sertifikayı seçin.
Dağıtım bildiriminizi imzalamak için Tamam'a gidin. Farklı Kaydet iletişim kutusu görüntülenir.
Farklı Kaydet iletişim kutusunda, dağıtım kök dizinine bir dizin yukarı taşının ve Kaydet'i seçin.
Dağıtım dizininde yer alan tüm dosyaları dağıtım hedefine veya medyaya kopyalayın. Bu bir Web sitesinde veya FTP sitesinde bulunan bir klasör, dosya paylaşımı veya CD-ROM olabilir.
Kullanıcılarınıza, uygulamalarınızı yüklemek için gereken URL' yi, UNC'yi veya fiziksel medyayı belirtin. Url veya UNC sağlarsanız, kullanıcılarınıza dağıtım bildiriminin tam yolunu vermalısınız. Örneğin, AppToDeploy AppToDeploy dizininde 'ye http://webserver01/ dağıtılırsa, tam URL yolu http://webserver01/AppToDeploy/AppToDeploy.application olur.
Sonraki adımlar
Uygulamanın yeni bir sürümünü dağıtmanız gerekirken, 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şturmak ve imzalamak ve dağıtım bildirimini güncelleştirmek ve imzalamak için önceki adımları izlemeniz gerekir. Yalnızca daha yüksek sürümleri güncelleştirmesi ve en sol tamsayı en önemli olduğuMage.exe ve çağrılarında aynı yüksek sürümü -New -Update ClickOnce belirtmeye dikkat edin. MageUI.exekullandıysanız, uygulamayı açarak, Uygulama Başvurusu sekmesini seçerek, Bildirim Seç düğmesine gidip güncelleştirilmiş uygulama bildirimini seçerek dağıtım bildirimini güncelleştirebilirsiniz. **