İzlenecek yol: El ile ClickOnce uygulama dağıtma

Makale
02/25/2013

ClickOnce uygulamanızı dağıtmak için Visual Studio kullanamıyorsanız veya Güvenilir Uygulama Dağıtımı gibi gelişmiş dağıtım özelliklerini kullanmanız gerekiyorsa, ClickOnce bildirimlerinizi oluşturmak için Mage.exe komut satırı aracını kullanmalısınız. Bu talimatlar, Bildirim Oluşturma ve Düzenleme Aracının komut satırı sürümünü (Mage.exe) ya da grafik sürümünü (MageUI.exe) kullanarak ClickOnce dağıtımını nasıl oluşturacağınızı tarif eder.

Önkoşullar

Bu talimatlar bir dağıtım oluşturmadan önce seçmeniz gereken bazı önkoşul ve seçenekleri içerir.

Mage.exe ve MageUI.exe'yi yükleyin

Mage.exe ve MageUI.exe Windows Software Development Kit (SDK)'in parçasıdır. Yüklü bir Windows SDK veya Visual Studio'ya eklenmiş Windows SDK sürümüne sahip olmanız gerekir. Daha fazla bilgi için bkz: Windows sdk MSDN'de.
Dağıtılmak üzere bir uygulama sağlayın.

Bu talimatlar dağıtım için hazır olan bir Windows uygulamasına sahip olduğunuzu varsayar. Bu uygulamadan AppToDeploy olarak bahsedilecektir.
Dağıtımın nasıl yapılacağını belirtin.

Dağıtım Seçenekleri şunları içerir: Web, dosya paylaşımı veya cd. Daha fazla bilgi için bkz. ClickOnce Güvenliği ve Dağıtımı.
Uygulamanın yükseltilmiş bir güven düzeyine ihtiyacı olup olmadığını belirleyin.

Kullanıcının sistemine sınırsız erişim için, uygulamanızın Tam Güven'e ihtiyacı vardır. Bunu ayarlamak için Mage.exe'nin -TrustLevel seçeneğini kullanabilirsiniz. Uygulamanız için özel bir izin kümesi tanımlamak istiyorsanız, başka bir bildirimden Internet veya Intranet izin bölümünü kopyalayın; bunu ihtiyaçlarınıza uyacak şekilde değiştirin ve MageUI.exe vaya bir metin düzenleyicisi kullanarak uygulama bildirimine ekleyin. Daha fazla bilgi için bkz. Güvenilir Uygulama Dağıtımına Genel Bakış.
Bir Authenticode sertifikası edinin.

Bir Authenticode sertifikası ile dağıtımınızı imzalamalısınız. Visual Studio, MageUI.exe veya MakeCert.exe ile Pvk2Pfx.exe araçları kullanarak bir test sertifikası oluşturun. Bunun yerine Sertifika Yetkilisi'nden de (CA) bir sertifika alabilirsiniz. Güvenilir Uygulama Dağıtımını seçerseniz, tüm sunucu bilgisayarlar üzerinde bir defalık sertifika yüklemesi yapmanız da gerekecektir. Daha fazla bilgi için bkz. Güvenilir Uygulama Dağıtımına Genel Bakış.
Uygulamanın, UAC bilgisi içeren bir bildirime sahip olmamasından emin olun.

Uygulamanızın bir <dependentAssembly> öğesi gibi Kullanıcı Hesap Denetimi (UAC) bilgisi içeren bir bildirime sahip olup olmadığını belirlemeniz gerekir. Bir uygulama bildirimi incelemek için Windows Sysinternals kullanabilirsiniz Sigcheck yardımcı programı.

Uygulamanız UAC ayrıntıları içeren bir bildirime sahipse, UAC bilgisi olmadan uygulamayı yeniden yapılandırmanız gerekir. Visual Studio'da bir C# projesi için, proje özelliklerini açın ve Uygulama sekmesini seçin. Bildirim açılır listesinde, Create application without a manifest'i (Uygulamayı bildirim olmadan oluşturun) seçin. Visual Studio'da bir Visual Basic projesi için, proje özelliklerini açın, uygulama sekmesini seçin, ve View UAC Settings'i (UAC Ayarlarını Görüntüle) tıklayın. Açılan bildirim dosyasında, tek <asmv1:assembly> öğesi içinde tüm öğeleri kaldırın.
Uygulamanın istemci bilgisayar üzerinde önkoşullara ihtiyacı olup olmadığını belirtin.

Visual Studio'dan dağıtılan ClickOnce uygulamaları, dağıtım ile birlikte bir önkoşul önyükleyicisi (setup.exe) içerebilir. Bu yönerge ClickOnce dağıtımı için gerekli iki bildirim oluşturur. GenerateBootstrapper görev kullanarak bir önkoşul önyükleyicisi oluşturabilirsiniz.

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

ClickOnce dağıtım dosyalarını depolayacağınız bir dizin oluşturun.
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ü uygulama dosyalarınızın sürümünden farklı olabilir.
Çalıştırılabilir dosyalar, derlemeler, kaynaklar ve veri dosyaları da dahil olmak üzere uygulamanızın tüm dosyalarını sürüm alt dizinine kopyalayın. Gerekiyorsa, ek dosyaları içerecek ek alt dizinler oluşturabilirsiniz.
Windows SDK veya Visual Studio komut satırı açın ve sürüm alt dizinine geçin.
Mage.exe'yi çağırarak uygulama bildirimini oluşturun. Aşağıdaki kullanım, Intel x86 işlemci üzerinde çalışmak üzere 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

-FromDirectory seçeneğinden sonra bulunduğunuz dizini gösteren noktayı (.) eklediğinizden emin olun.Noktayı eklemezseniz, uygulama dosyalarınızın yolunu belirtmeniz gerekir.
Authenticoe sertifikanız ile uygulama bildirimini imzalayın. mycert.pfx'i sertifika dosyası yolunuzla değiştirin. passwd'ü sertifika dosyanızın parolasıyla değiştirin.
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
Dağıtım dizini köküne gelin.
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, false değeri ile -Install bağımsız değişkenini kullanın. Varsayılan değeri kullanırsanız ve kulllanıcılar uygulamanızı bir Web sitesi veya dosya paylaşımından yükleyecekse, -ProviderUrl seçeneğinin Web sunucusu veya paylaşım üzerindeki 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
```

Authenticoe sertifikanız ile uygulama bildirimini imzalayın.

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

Dağıtım dizininde bulunan tüm dosyaları dağıtımın hedefine veya ortamına kopyalayın. Bu; Web veya FTP üzerinde bir dosya, bir dosya paylaşımı veya bir CD-ROM olabilir.
Uygulamayı yüklemek için gereken URL, UNC veya fiziksel ortamı kullanıcılara sağlayın. Bir URL veya UNC sağlarsanız, kullanıcılarınıza dağıtım bildirimi tam yolunu vermelisiniz. Örneğin; AppToDeploy, AppToDeploy dizininde http://webserver01/'e konuşlandırıldıysa, tam URL yolu http://webserver01/AppToDeploy/AppToDeploy.application olacaktır.

MageUI.exe grafik aracını kullanarak bir uygulama dağıtmak için

ClickOnce dağıtım dosyalarını depolayacağınız bir dizin oluşturun.
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ü uygulama dosyalarınızın sürümünden farklı olabilir.
Çalıştırılabilir dosyalar, derlemeler, kaynaklar ve veri dosyaları da dahil olmak üzere uygulamanızın tüm dosyalarını sürüm alt dizinine kopyalayın. Gerekiyorsa, ek dosyaları içerecek ek alt dizinler oluşturabilirsiniz.
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 uygulamanızın uygun olarak yapılandırıldığı İşlemci'yi belirtin. Örneğin; x86.
Dosyalar sekmesini seçin ve Uygulama Dizini metin kutusu yanindaki üç nokta (...) düğmesini tıklayın. Klasöre Gözat iletişim kutusu görünür.
Uygulama dosyalarını içeren sürüm alt dizinini seçin ve Tamam'ı tıklayın.
Internet Information Services (IIS) kullanarak dağıtım yapacaksanız, When populating add the .deploy extension to any file that does not have it (Doldururken .deploy uzantısına sahip olmayan tüm dosyalara bu uzantıyı ekle) onay kutusunu seçin.
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 uygulamaların bir çoğu için uygun olan FullTrust'tır.
Dosya menüsünden, Farklı Kaydet'i seçin. Uygulama bildirimini imzalamanızı isteyen İmzalama Seçenekleri iletişim kutusu görüntülenir.
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. Sertifika parolanızı yazın.

-veya-

Sertifikanız bilgisayarınızdan erişilen bir sertifika depolama alanında tutuluyorsa, Sign with stored certificate seçeneğini (Depolanan sertifika ile imzalayın) ve verilen listeden sertifikayı seçin.
Uygulama bildirimini imzalamak için Tamam'ı tıklayın. Farklı Kaydet iletişim kutusu görüntülenir.
Farklı Kaydet iletişim kutusunda, sürüm dizinini belirtin ve Kaydet'i tıklayın.
Dağıtım bildiriminizi oluşturmak için menüden Dosya, Yeni, Dağıtım Bildirimi'ni seçin.
Üzerinde ad sekmesinde, bu dağıtım (Bu örnekte 1.0.0.0) adını ve sürüm numarasını belirtin. Ayrıca uygulamanızın uygun olarak yapılandırıldığı İşlemci'yi belirtin. Örneğin; x86.
Tanımlama sekmesini seçin ve Yayımcı ile Ürün için değerleri belirtin. (Ürün uygulamanıza Windows Başlat menüsünde çevrimdışı kullanım için istemci bilgisayarda uygulama yüklerken verilen addır.)
Deployment Options (Dağıtım Seçenekleri) sekmesini seçin ve Start Location (Başlat Konumu) metin kutusunda Web sunucusu veya paylaşımdaki uygulama bildiriminin konumunu belirtin. Örneğin, \\myServer\myShare\AppToDeploy.application.
Önceki adımda .deploy uzantısı eklediyseniz, burada Use .deploy file name extension'ı da (.deploy dosya adı uzantısını kullanın) seçin.
Update Options (Güncelleştirme Seçenekleri) sekmesini seçin ve bu uygulamayı hangi sıklıkta güncelleştirmek istediğinizi belirtin. Uygulamanız güncelleştirmeleri kontrol etmesi için UpdateCheckInfo kullanıyorsa, This application should check for updates (Uygulama güncelleştirmeleri denetlesin) onay kutusundan işareti kaldırın.
Application Reference (Uygulama başvuru) sekmesini seçin ve sonra Select Manifest (Bildirim Seç) düğmesini tıklayın. Açık bir iletişim kutusu görüntülenir.
Daha önce oluşturduğunuz uygulama bildirimini seçin ve sonra Aç'ı tıklayın.
Dosya menüsünden, Farklı Kaydet'i seçin. Uygulama bildirimini imzalamanızı isteyen İmzalama Seçenekleri iletişim kutusu görüntülenir.
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. Sertifika parolanızı yazın.

-veya-

Sertifikanız bilgisayarınızdan erişilen bir sertifika depolama alanında tutuluyorsa, Sign with stored certificate seçeneğini (Depolanan sertifika ile imzalayın) ve verilen listeden sertifikayı seçin.
Uygulama bildirimini imzalamak için Tamam'ı tıklayın. Farklı Kaydet iletişim kutusu görüntülenir.
Farklı Kaydet iletişim kutusunda, bir dizini dağıtımınızın köküne taşıyın ve sonra Kaydet'i tıklayın.
Dağıtım dizininde bulunan tüm dosyaları dağıtımın hedefine veya ortamına kopyalayın. Bu; Web veya FTP üzerinde bir dosya, bir dosya paylaşımı veya bir CD-ROM olabilir.
Uygulamayı yüklemek için gereken URL, UNC veya fiziksel ortamı kullanıcılara sağlayın. Bir URL veya UNC sağlarsanız, kullanıcılarınıza dağıtım bildirimi tam yolunu vermelisiniz. Örneğin; AppToDeploy, AppToDeploy dizininde http://webserver01/'e konuşlandırıldıysa, tam URL yolu http://webserver01/AppToDeploy/AppToDeploy.application olacaktır.

Sonraki Adımlar

Uygulamanın yeni bir sürümünü dağıtmak istediğinizde, yeni versiyonun sonrası olacak şekilde adlandırılan (örneğin, 1.0.0.1) yeni bir dizin oluşturun ve tüm yeni uygulama dosyalarını bu dizine kopyalayın. Ardından, yeni bir uygulama bildirimi oluşturup imzalamak ve dağıtım bildirimini güncelleştirip imzalamak için önceki adımları takip etmeniz gerekir. ClickOnce, en soldaki tamsayı en önemli mantığı ile sadece daha yüksek sürümleri güncelleştirdiği için, -New ve –Update çağrılarında aynı yükseltilmiş sürümü belirttiğinizden emin olun. MageUI.exe kullandıysanız, dağıtım bildirimini güncelleştirmek için bildirimi açın ve Application Reference (Uygulama Başvuru) sekmesini seçin. Sonra Select Manifest (Bildirim Seç) düğmesini tıklayıp güncelleştirilmiş uygulama bildirimini seçin.