GenerateDeploymentManifest görevi

  • Makale

ClickOnce dağıtım bildirimi oluşturur. ClickOnce dağıtım bildirimi, dağıtım için benzersiz bir kimlik tanımlayarak, yükleme veya çevrimiçi mod gibi dağıtım özelliklerini tanımlayarak, uygulama güncelleştirme ayarlarını ve güncelleştirme konumlarını belirterek ve ilgili ClickOnce uygulama bildirimini belirterek bir uygulamanın dağıtımını açıklar.

Parametreler

Aşağıdaki tabloda görevin parametreleri GenerateDeploymentManifest açıklanmaktadır.

Parametre Tanım
AssemblyName İsteğe bağlı String parametre.

Name Oluşturulan bildirim için derleme kimliğinin alanını belirtir. Bu parametre belirtilmezse, ad veya InputManifest parametrelerinden EntryPoint çıkarılır. Ad çıkarılamıyorsa, görev bir hata oluşturur.
AssemblyVersion İsteğe bağlı String parametre.

Version Oluşturulan bildirim için derleme kimliğinin alanını belirtir. Bu parametre belirtilmezse, görev "1.0.0.0" değerini kullanır.
CreateDesktopShortcut İsteğe bağlı Boolean parametre.

True ise, ClickOnce uygulaması yüklemesi sırasında masaüstünde bir simge oluşturulur.
DeploymentUrl İsteğe bağlı String parametre.

Uygulamanın güncelleştirme konumunu belirtir. Bu parametre belirtilmezse, uygulama için hiçbir güncelleştirme konumu tanımlanmaz. Ancak parametresi ise UpdateEnabledtruegüncelleştirme konumu belirtilmelidir. Belirtilen değer tam URL veya UNC yolu olmalıdır.
Description İsteğe bağlı String parametre.

Uygulama için isteğe bağlı bir açıklama belirtir.
DisallowUrlActivation İsteğe bağlı Boolean parametre.

Uygulamanın URL aracılığıyla açıldığında otomatik olarak çalıştırılıp çalıştırılmayacağını belirtir. Bu parametre isetrue, uygulama yalnızca Başlat menüsünden başlatılabilir. Bu parametrenin varsayılan değeridir false. Bu giriş yalnızca parametre değeri olduğunda Installtrueuygulanır.
EntryPoint İsteğe bağlı ITaskItem[] parametre.

Oluşturulan bildirim derlemesi için giriş noktasını gösterir. ClickOnce dağıtım bildirimi için bu giriş ClickOnce uygulama bildirimini belirtir.

EntryPoint Görev parametresi belirtilmezse, <customHostSpecified> etiket etiketin <entryPoint> alt öğesi olarak eklenir, örneğin:

<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

Aşağıdaki adımları kullanarak uygulama bildirimine DLL bağımlılıkları ekleyebilirsiniz:

1. derleme başvurularını çağrısıyla ResolveAssemblyReferenceçözün.
2. Önceki görevin ve derlemenin çıkışını öğesine ResolveManifestFilesgeçirin.
3. parametresini kullanarak Dependencies bağımlılıkları geçirin GenerateApplicationManifest.
ErrorReportUrl İsteğe bağlı System.String parametre.

ClickOnce yüklemeleri sırasında iletişim kutularında görüntülenen web sayfasının URL'sini belirtir.
InputManifest İsteğe bağlı ITaskItem parametre.

Bildirim oluşturucu için temel görevi görecek giriş XML belgesini gösterir. Bu, özel bildirim tanımları gibi yapılandırılmış verilerin çıkış bildirimine yansıtılabilmesini sağlar. XML belgesindeki kök öğenin asmv1 ad alanında bir derleme düğümü olması gerekir.
Install İsteğe bağlı Boolean parametre.

Uygulamanın yüklü bir uygulama mı yoksa yalnızca çevrimiçi bir uygulama mı olduğunu belirtir. Bu parametre isetrue, uygulama kullanıcının Başlat menüsüne yüklenir ve Program Ekle veya Kaldır iletişim kutusu kullanılarak kaldırılabilir. Bu parametre ise false, uygulama bir web sayfasından çevrimiçi kullanıma yöneliktir. Bu parametrenin varsayılan değeridir true.
MapFileExtensions İsteğe bağlı Boolean parametre.

.deploy dosya adı uzantısı eşlemesinin kullanılıp kullanılmayacağını belirtir. Bu parametre ise true, her program dosyası bir .deploy dosya adı uzantısıyla yayımlanır. Bu seçenek, ClickOnce uygulama dağıtımını etkinleştirmek için engeli kaldırılması gereken dosya adı uzantılarının sayısını sınırlamak için web sunucusu güvenliği için yararlıdır. Bu parametrenin varsayılan değeridir false.
MaxTargetPath İsteğe bağlı String parametre.

ClickOnce uygulama dağıtımında bir dosya yolunun izin verilen en büyük uzunluğunu belirtir. Bu parametre belirtilirse, uygulamadaki her dosya yolunun uzunluğu bu sınıra göre denetlenebilir. Sınırı aşan öğeler derleme uyarısına neden olur. Bu giriş belirtilmezse veya sıfırsa, hiçbir denetim gerçekleştirilmez.
MinimumRequiredVersion İsteğe bağlı String parametre.

Kullanıcının güncelleştirmeyi atlayıp atlayamayacağını belirtir. Kullanıcının gereken en düşük sürümden küçük bir sürümü varsa, güncelleştirmeyi atlama seçeneğine sahip olmaz. Bu giriş yalnızca parametresinin Install değeri olduğunda truegeçerlidir.
OutputManifest İsteğe bağlı ITaskItem parametre.

Oluşturulan çıkış bildirim dosyasının adını belirtir. Bu parametre belirtilmezse, çıktı dosyasının adı oluşturulan bildirimin kimliğinden çıkarılır.
Platform İsteğe bağlı String parametre.

Uygulamanın hedef platformunu belirtir. Bu parametre aşağıdaki değerlere sahip olabilir:

- AnyCPU
- x86
- x64
- Itanium

AnyCPU varsayılan değerdir.
Product İsteğe bağlı String parametre.

Uygulamanın adını belirtir. Bu parametre belirtilmezse, ad oluşturulan bildirimin kimliğinden çıkarılır. Bu ad, Başlat menüsündeki kısayol adı için kullanılır ve Program Ekle veya Kaldır iletişim kutusunda görünen adın bir parçasıdır.
Publisher İsteğe bağlı String parametre.

Uygulamanın yayımcısını belirtir. Bu parametre belirtilmezse, ad kayıtlı kullanıcıdan veya oluşturulan bildirimin kimliğinden çıkarılır. Bu ad, Başlat menüsündeki klasör adı için kullanılır ve Program Ekle veya Kaldır iletişim kutusunda görünen adın bir parçasıdır.
SuiteNamel İsteğe bağlı String parametre.

ClickOnce dağıtımından sonra uygulamanın bulunduğu Başlat menüsündeki klasörün adını belirtir.
SupportUrl İsteğe bağlı String parametre.

Uygulamanın Program Ekle veya Kaldır iletişim kutusunda görüntülenen bağlantıyı belirtir. Belirtilen değer tam URL veya UNC yolu olmalıdır.
TargetCulture İsteğe bağlı String parametre.

Uygulamanın kültürünü tanımlar ve oluşturulan bildirim için derleme kimliğinin alanını belirtir Language . Bu parametre belirtilmezse, uygulamanın kültür sabiti olduğu varsayılır.
TrustUrlParameters İsteğe bağlı Boolean parametre.

URL sorgu dizesi parametrelerinin uygulama için kullanılabilir hale getirilip getirilmeyeceğini belirtir. Bu parametrenin varsayılan değeri, parametrelerin uygulama tarafından kullanılamayacağını gösteren değeridir false.
UpdateEnabled İsteğe bağlı Boolean parametre.

Uygulamanın güncelleştirmeler için etkinleştirilip etkinleştirilmediğini gösterir. Bu parametrenin varsayılan değeridir false. Bu parametre yalnızca parametresinin Install değeri olduğunda truegeçerlidir.
UpdateInterval İsteğe bağlı Int32 parametre.

Uygulamanın güncelleştirme aralığını belirtir. Bu parametrenin varsayılan değeri sıfırdır. Bu parametre yalnızca ve UpdateEnabled parametrelerinin Install değerleri her ikisi olduğunda truegeçerlidir.
UpdateMode İsteğe bağlı String parametre.

Uygulama başlatılmadan önce ön planda veya uygulama çalışırken arka planda güncelleştirmelerin denetlenip denetlenmeyeceğini belirtir. Bu parametre aşağıdaki değerlere sahip olabilir:

- Foreground
- Background

Bu parametrenin varsayılan değeridir Background. Bu parametre yalnızca ve UpdateEnabled parametrelerinin Install değerleri her ikisi olduğunda truegeçerlidir.
UpdateUnit İsteğe bağlı String parametre.

parametresinin birimlerini UpdateInterval belirtir. Bu parametre aşağıdaki değerlere sahip olabilir:

- Hours
- Days
- Weeks

Bu parametre yalnızca ve UpdateEnabled parametrelerinin Install değerleri her ikisi olduğunda truegeçerlidir.

Açıklamalar

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından GenerateManifestBase devralan sınıfından Task parametreleri devralır. Task sınıfının parametrelerinin listesi için bkz . Görev temel sınıfı.

Ayrıca bkz.