İzlenecek yol: El ile Re-Signing gerektirmez ve marka bilgilerini korur, ClickOnce uygulama dağıtma

Makale
02/25/2013

Bir ClickOnce uygulaması oluşturup ardından bunu dağıtıp yayımlaması işin bir müşteriye verdiğinizde, müşteri geleneksel olarak dağıtım bildirimini güncelleştirmek ve yeniden imzalamak zorundadır. Çoğu durumda bu hala tercih edilen yöntemken, .NET Framework 3.5 yeni bir dağıtım bildirimi oluşturmadan müşteriler tarafından dağıtılan ClickOnce dağıtımları oluşturmanıza imkan verir. Daha fazla bilgi için bkz. Sınama ve Üretim Sunucuları için Teslim Etmeden ClickOnce Uygulamaları Dağıtımı.

ClickOnce uygulaması oluşturup bunu müşteriye yayımlaması ve dağıtması için verdiğinizde, uygulama müşterinin markasını veya sizin markanızı kullanabilir. Örneğin, uygulama kişiye özel tek bir uygulama ise, markanızı korumak isteyebilirsiniz. Uygulama her müşteri için yüksek düzeyde özelleştirilmiş ise, müşterinin markasını kullanmak isteyebilirsiniz. .NET Framework 3.5, uygulamanızı dağıtım için bir kuruluşa verdiğinizde markanızı, yayımcı bilgisi ve güvenlik imzasını korumanıza imkan verir. Daha fazla bilgi için bkz. Başkalarının Dağıtması için Clickonce Uygulaması Oluşturma.

Not

Bu yönergeyi tamamlamak için, dağıtımları komut satırı aracı Mage.exe ya da grafik aracı MageUI.exe kullanarak el ile oluşturun.Otomatik olmayan dağıtımlar hakkında daha fazla bilgi için, bkz. İzlenecek yol: El ile ClickOnce uygulama dağıtma.

Önkoşullar

Bu yönergedeki adımları gerçekleştirmek için şunu yapmanız gerekir:

Dağıtıma hazır olan bir Windows Forms uygulaması. Bu uygulama WindowsFormsApp1 olarak bahsedilecektir.
Visual Studio veya Windows SDK.

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

Visual Studio komut istemi veya Windows SDK komut istemi açın. Sonra ClickOnce dosyalarınızı depolayacağınız dizine geçin.
Dağıtımınızın güncel sürümünden sonra adlandırılan bir dizin oluşturun. Uygulamayı ilk kez dağıtıyorsanız, büyük olasılıkla 1.0.0.0'ı seçeceksiniz.

Not

Dağıtımınızın sürümü uygulama dosyalarınızın sürümünden farklı olabilir.
bin olarak adlandırılan bir alt dizin oluşturun ve çalıştırılabilir dosyalar, derlemeler, kaynaklar ile veri dosyaları da dahil tüm uygulama dosyalarınızı kopyalayın.

Mage.exe'yi çağırarak uygulama bildirimini 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"

Dijital sertifikanız ile uygulama bildirimini imzalayın.

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

Mage.exe'yi çağırarak dağıtım bildirimini oluşturun. Varsayılan değer olarak, uygulamanın hem çevrimiçi hem çevrimdışı çalışması için, Mage.exe ClickOnce dağıtımınızı yüklenmiş bir uygulama olarak işaretleyecektir. Uygulamayı yalnızca çevrimiçi kullanılabilir yapmak için, f değeri ile -i bağımsız değişkenini kullanın. Bu uygulamanın birden çok dağıtım özelliğinden faydalanması için, -providerUrl bağımsız değişkenini Mage.exe'ye dışlayın. (.NET Framework'ün 3.5 öncesi sürümlerinde, çevrimdışı bir uygulama için -providerUrl'yi dışlamak 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 
```
Dağıtım bildirimini imzalamayın.
Kendi ağı üzerinde uygulamayı dağıtacak müşteriye tüm dosyaları sağlayın.
Bu noktada, müşteri kendisinin oluşturduğu sertifika ile dağıtım bildirimini imzalamalıdır. Örneğin, müşteri Adventure Works adlı bir şirket için çalışıyorsa, MakeCert.exe aracını kullanarak kendisinin imzaladığı bir sertifikayı oluşturur. Ardından Pvk2pfx.exe aracını, MakeCert.exe tarafından oluşturulan dosyaları, Mage.exe'ye geçirilebilen bir PFX dosyası içinde birleştirmek için kullanır.
```
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
```
Müşteri daha sonra bu sertifikayı dağıtım bildirimlerini imzalamak için kullanır.
```
mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
```
Müşteri uygulamayı kullanıcılarına dağıtır.

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

Visual Studio komut istemi veya Windows SDK komut istemi açın. Sonra ClickOnce dosyalarınızı depolayacağınız dizine geçin.
bin olarak adlandırılan bir alt dizin oluşturun ve çalıştırılabilir dosyalar, derlemeler, kaynaklar ile veri dosyaları da dahil tüm uygulama dosyalarınızı kopyalayın.
Dağıtımınızın güncel sürümünden sonra adlandırılan bir dizin oluşturun. Uygulamayı ilk kez dağıtıyorsanız, büyük olasılıkla 1.0.0.0'ı seçeceksiniz.

Not

Dağıtımınızın sürümü uygulama dosyalarınızın sürümünden farklı olabilir.
2. Adımda oluşturduğunuz dizine \bin dizinine taşıyın.
MageUI.exe grafik aracını başlatın.
```
MageUI.exe
```
Uygulama Bildirimi menüsünden Dosya, Yeni'yi seçerek yeni bir uygulama bildirimi oluşturun.
Varsayılan İsim sekmesinde, bu dağıtımın adını ve sürüm numarasını girin. Ayrıca uygulama dağıtıldığında, uygulamanın Başlat menüsündeki kısayol bağlantısı için klasör ismi olarak da kullanılacak Yayımcı'ya bir değer girin.
Uygulama Seçenekleri sekmesini seçin ve Use Application Manifest for Trust Information'ı (Güven Bilgisi için Uygulama Bildirimini Kullanın) tıklayın. Bu, ClickOnce uygulamasına ait üçüncü taraf markayı etkinleştirecektir.
Dosyalar sekmesini seçin ve Uygulama Dizini metin kutusunun yanında bulunan Gözat düğmesini tıklayın.
İkinci adımda oluşturduğunuz uygulama dosyalarınızı içeren dizini seçin ve klasör seçimi iletişim kutusundaki Tamam'ı tıklayın.
Populate (Doldur) düğmesini tüm uygulama dosyalarını dosya listesine eklemesi için tıklayın. Uygulamanız birden fazla çalıştırılabilir dosya içeriyorsa, ana çalıştırılabilir dosyayı açılır liste Dosya Türü'nden Entry Point'i (Girdi Noktası) seçerek bu dağıtım için başlangıç uygulaması olarak işaretleyin. (Uygulama yalnızca bir çalıştırılabilir dosya içeriyorsa, MageUI.exe bunu sizin için işaretler.)
Permissions Required (Gerekli İzinler) sekmesini seçin ve uygulamanız için gereken izin düzeyini seçin. Varsayılan değer çoğu uygulamalar için de uygun olan Tam Güven'dir.
Menüden Dosya, Kaydet'i seçin ve uygulama bildirimini kaydedin. Kaydettikten sonra uygulama bildirimini imzalamanız istenecektir.
Sisteminizde dosya olarak depolanan bir sertifikanız varsa, Sign as certificate file (Sertifika dosyası olarak imzalayın) seçeneğini kullanın ve üç nokta (...) düğmesini kullanarak dosya sisteminden sertifikayı seçin.

-veya-

Sertifikanız bilgisayarınızdan erişilen bir sertifika depolama alanında tutuluyorsa, Sign with stored certificate option'ı (Depolanan sertifika seçeneği ile imzalayın) ve verilen listeden sertifikayı seçin.
Seçin Dosya, Yeni, Dağıtım listesi dağıtım listenizin oluşturmak için menüden ve daha sonra üzerinde ad sekmesinde, bir ad ve sürüm numarası (Bu örnekte 1.0.0.0) sağlayın.
Güncelle sekmesine geçin ve bu uygulamanın hangi sıklıkta güncelleştirileceğini belirtin. Uygulamanız güncelleştirmeleri kontrol etmesi için ClickOnce Dağıtım API'si kullanıyorsa, This application should check for updates (Uygulama güncelleştirmeleri denetlesin) onay kutusundan işareti kaldırın.
Application Reference (Uygulama Başvurusu) sekmesine geçin. Select Manifest (Bildirim Seç) düğmesine tıklayıp önceki adımlarda oluşturduğunuz uygulama bildirimini seçerek bu sekmedeki değerlerin tümünü önceden doldurabilirsiniz.
Kaydet'i seçin ve dağıtım bildirimini diske kaydedin. Kaydettikten sonra uygulama bildirimini imzalamanız istenecektir. Bildirimi imzalamadan kaydetmek için İptal'i tıklayın.
Müşteriye tüm uygulama dosyalarını sağlayın.
Bu noktada, müşteri kendisinin oluşturduğu sertifika ile dağıtım bildirimini imzalamalıdır. Örneğin, müşteri Adventure Works adlı bir şirket için çalışıyorsa, MakeCert.exe aracını kullanarak kendisinin imzaladığı bir sertifikayı oluşturur. Ardından Pvk2pfx.exe aracını, MakeCert.exe tarafından oluşturulan dosyaları, Mage.exe'ye geçirilebilen bir PFX dosyası içinde birleştirmek için kullanır.
```
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
```
Oluşturulan sertifika ile, müşteri şimdi MageUI.exe içinde dağıtım bildirimini açıp kaydederek bildirimi imzalar. İmzalama iletişim kutusu görüntülendiğinde, müşteri Sign as certificate file (Sertifika dosyası olarak imzala) seçeneğini ve disk üzerinde kaydettiği PFX dosyasını seçer.
Müşteri uygulamayı kullanıcılarına dağıtır.

Ayrıca bkz.

Başvuru

Mage.exe (bildirim oluşturma ve düzenleme aracı)

MageUI.exe (bildirim oluşturma ve düzenleme aracı, grafiksel istemci)

MakeCert.exe (sertifika oluşturma aracı)

Aracılığıyla paylaş