Zadanie GenerateDeploymentManifest

Generuje ClickOnce wdrażania manifestu.A ClickOnce manifestu rozmieszczania opisuje wdrażanie aplikacji definiowanie unikatowej tożsamości wdrożenia, identyfikując wdrażania cech, takich jak instalowanie lub w trybie online, określając ustawienia aktualizacji aplikacji i lokalizacji aktualizacji i wskazujące odpowiednią ClickOnce manifest aplikacji.

Parametry

W poniższej tabeli opisano parametry dla GenerateDeploymentManifest zadania.

Parametr

Opis

AssemblyName

Opcjonalny String parametru.

Określa Name pola tożsamości zestawu wygenerowanego manifestu.Jeśli ten parametr nie jest określony, nazwa jest wywnioskować z EntryPoint lub InputManifest parametry.Jeśli nazwy nie można wywnioskować, zadanie wygeneruje błąd.

AssemblyVersion

Opcjonalny String parametru.

Określa Version pola tożsamości zestawu wygenerowanego manifestu.Jeśli ten parametr nie jest określony, zadanie używa wartości "1.0.0.0".

CreateDesktopShortcut

Opcjonalny Boolean parametru.

Jeśli wartość true, ikona na pulpicie jest tworzony podczas instalacji aplikacji ClickOnce.

DeploymentUrl

Opcjonalny String parametru.

Określa lokalizację aktualizacji dla aplikacji.Jeżeli nie określono tego parametru, lokalizacja aktualizacji nie jest zdefiniowany dla aplikacji.Jednakże jeśli UpdateEnabled jest parametr true, musi być określona lokalizacja aktualizacji.Określona wartość powinna być w pełni kwalifikowana ścieżka adresu URL lub ścieżkę UNC.

Description

Opcjonalny String parametru.

Określa opcjonalny opis dla aplikacji.

DisallowUrlActivation

Opcjonalny Boolean parametru.

Określa, czy aplikacja powinny być uruchamiane automatycznie po jego otwarciu za pośrednictwem adresu URL.Jeśli ten parametr jest true, tylko można uruchomić aplikacji z Start menu.Wartością domyślną tego parametru jest false.Input ten stosuje się tylko wtedy, gdy Install wartość parametru jest true.

EntryPoint

Opcjonalny ITaskItem[] parametru.

Wskazuje punkt wejścia dla wygenerowanego manifestu zestawu.Dla ClickOnce manifest wdrażania, to wejście Określa ClickOnce manifest aplikacji.

W Visual Studio 2005, Zadanie GenerateApplicationManifest wymagane EntryPoint do generowania manifest aplikacji.(Montażu lub manifesty macierzysty nie wymagają EntryPoint.) To wymaganie zostało wymuszone z powodu błędu kompilacji: "MSB3185: punkt wejścia nie jest określony dla manifestu."

MSBuildnie wydają ten błąd podczas EntryPoint nie określono parametru zadania.Zamiast tego <customHostSpecified> znacznik jest wstawiany jako element podrzędny <entryPoint> tag, na przykład:

<entryPoint xmlns="urn:schemas-

microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

Można dodać zależności biblioteki DLL do manifest aplikacji, wykonując następujące kroki:

  1. Rozpoznać odwołania do zestawów z zaproszeniem do ResolveAssemblyReference.

  2. Przekazać dane wyjściowe poprzedniego zadania i samego montażu do ResolveManifestFiles.

  3. Przekazać zależności za pomocą Dependencies parametr GenerateApplicationManifest.

ErrorReportUrl

Opcjonalny [String] parametru.

Określa adres URL strony sieci Web, która jest wyświetlana w oknach dialogowych podczas instalacji ClickOnce.

InputManifest

Opcjonalny ITaskItem parametru.

Wskazuje wejściowe dokumentu XML, aby służyć jako podstawa dla manifestu generator.Dzięki temu danych strukturalnych, takich jak niestandardowe definicje manifestu, były odzwierciedlane w manifeście danych wyjściowych.Element główny dokumentu XML musi być węzła zestawu w obszarze nazw asmv1.

Install

Opcjonalny Boolean parametru.

Określa, czy aplikacja jest zainstalowanej aplikacji lub aplikacji tylko online.Jeśli ten parametr jest true, aplikacja zostanie zainstalowana w menu Start użytkownika i można usunąć za pomocą okna dialogowego Dodaj lub usuń programy.Jeśli ten parametr jest false, aplikacja jest przeznaczone do wykorzystania ze strony sieci Web w trybie online.Wartością domyślną tego parametru jest true.

MapFileExtensions

Opcjonalny Boolean parametru.

Określa, czy jest używane mapowanie rozszerzenia nazwy pliku .deploy.Jeśli ten parametr jest true, co plik programu jest publikowana z rozszerzeniem nazwy pliku .deploy.Ta opcja jest przydatna dla zabezpieczeń serwera sieci Web ograniczyć liczbę rozszerzeń nazw plików, które muszą zostać odblokowana, aby umożliwić ClickOnce wdrażanie aplikacji.Wartością domyślną tego parametru jest false.

MaxTargetPath

Opcjonalny String parametru.

Określa maksymalną dozwoloną długość ścieżki pliku w ClickOnce wdrażanie aplikacji.Jeśli ten parametr jest określony, długość każdej ścieżki pliku w aplikacji jest sprawdzany na podstawie tego limitu.Wszystkie elementy, które przekraczają limit spowoduje ostrzeżenie kompilacji.Jeśli to dane wejściowe nie została określona lub jest równa zero, sprawdzanie nie jest wykonywane.

MinimumRequiredVersion

Opcjonalny String parametru.

Określa, czy użytkownik może pominąć aktualizacji.Jeśli użytkownik posiada wersję, która jest mniejsza niż minimalna wymagana, nie będzie on opcji, aby pominąć tę aktualizację.Kiedy dotyczy tylko tego wprowadzania wartości Install jest parametr true.

OutputManifest

Opcjonalny ITaskItem parametru.

Określa nazwę pliku manifestu wygenerowanych danych wyjściowych.Jeśli ten parametr nie jest określony, nazwa pliku wyjściowego jest wywnioskować na podstawie tożsamości wygenerowanego manifestu.

Platform

Opcjonalny String parametru.

Określa platformy docelowej aplikacji.Ten parametr może mieć następujące wartości:

  • AnyCPU

  • x86

  • x64

  • Itanium

Wartością domyślną jest AnyCPU.

Product

Opcjonalny String parametru.

Określa nazwę aplikacji.Jeśli ten parametr nie jest określony, nazwa jest wywnioskować na podstawie tożsamości wygenerowanego manifestu.Nazwa ta jest używana dla nazwy skrótów w Start menu i jest częścią nazwy, która pojawia się w oknie dialogowym Dodaj lub usuń programy.

Publisher

Opcjonalny String parametru.

Określa program publisher aplikacji.Jeśli ten parametr nie jest określony, nazwa jest wywnioskować z zarejestrowanym użytkownikiem lub tożsamości wygenerowanego manifestu.Nazwa ta jest używana nazwa folderu w Start menu i jest częścią nazwy, która pojawia się w oknie dialogowym Dodaj lub usuń programy.

SuiteNamel

Opcjonalny String parametru.

Określa nazwę folderu, w menu Start, w którym znajduje się aplikacja po wdrażania ClickOnce.

SupportUrl

Opcjonalny String parametru.

Określa łącze, które pojawia się w oknie dialogowym Dodaj lub usuń programy dla aplikacji.Określona wartość powinna być w pełni kwalifikowana ścieżka adresu URL lub ścieżkę UNC.

TargetCulture

Opcjonalny String parametru.

Identyfikuje kultury aplikacji i określa Language pola tożsamości zestawu wygenerowanego manifestu.Jeżeli nie określono tego parametru, zakłada się, że aplikacja jest niezmienna kultura.

TrustUrlParameters

Opcjonalny Boolean parametru.

Określa, czy parametry ciągu kwerendy URL powinny zostać udostępnione do aplikacji.Wartością domyślną tego parametru jest false, który wskazuje parametry nie będzie dostępne dla aplikacji.

UpdateEnabled

Opcjonalny Boolean parametru.

Wskazuje, czy aplikacja jest włączony dla aktualizacji.Wartością domyślną tego parametru jest false.Ten parametr dotyczy tylko, gdy wartość Install jest parametr true.

UpdateInterval

Opcjonalny Int32 parametru.

Określa interwał aktualizacji dla aplikacji.Wartością domyślną tego parametru jest zero.Ten parametr dotyczy tylko, gdy wartości Install i UpdateEnabled są oba parametry true.

UpdateMode

Opcjonalny String parametru.

Określa, czy aktualizacje są sprawdzane na pierwszym planie zanim aplikacja jest uruchomiona lub w tle jako aplikacja jest uruchomiona.Ten parametr może mieć następujące wartości:

  • Foreground

  • Background

Wartością domyślną tego parametru jest Background.Ten parametr dotyczy tylko, gdy wartości Install i UpdateEnabled są oba parametry true.

UpdateUnit

Opcjonalny String parametru.

Określa jednostki, dla UpdateInterval parametru.Ten parametr może mieć następujące wartości:

  • Hours

  • Days

  • Weeks

Ten parametr dotyczy tylko, gdy wartości Install i UpdateEnabled są oba parametry true.

Uwagi

Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z GenerateManifest , które sama klasa dziedziczy z Task klasy.Aby uzyskać listę parametrów klasy zadania, zobacz Klasa podstawowa zadania.

Zobacz też

Informacje

Zadanie GenerateApplicationManifest

Zadanie SignFile

Koncepcje

Program MSBuild zadań

Inne zasoby

Zadanie programu MSBuild odniesienia