GenerateDeploymentManifest — Zadanie
Generuje manifest wdrażania ClickOnce.Manifest wdrażania ClickOnce opisuje wdrażanie aplikacji poprzez określenie unikatowej tożsamości wdrożenia, identyfikację cech wdrażania, takich jak instalowanie lub tryb online, określenie ustawienia aktualizacji aplikacji i lokalizacji aktualizacji oraz wskazanie odpowiedniego manifestu aplikacji ClickOnce.
Parametry
W poniższej tabeli przedstawiono parametry dla zadania GenerateDeploymentManifest.
Parametr |
Opis |
|---|---|
AssemblyName |
Parametr opcjonalny String. Określa pole tożsamości zestawu Name wygenerowanego manifestu.Jeśli ten parametr nie jest określony, nazwa wynika z parametru EntryPoint lub InputManifest.Jeśli nazwy nie można wywnioskować, zadanie generuje błąd. |
AssemblyVersion |
Parametr opcjonalny String. Określa pole tożsamości zestawu Version wygenerowanego manifestu.Jeśli ten parametr nie jest określony, zadanie używa wartości „1.0.0.0”. |
CreateDesktopShortcut |
Parametr opcjonalny Boolean. Jeśli ma wartość true, tworzona jest ikona na pulpicie podczas instalacji aplikacji ClickOnce. |
DeploymentUrl |
Parametr opcjonalny String. Określa lokalizację aktualizacji dla aplikacji.Jeśli ten parametr nie jest określony, lokalizacja aktualizacji nie jest zdefiniowana dla aplikacji.Jednak, jeśli parametr UpdateEnabled wynosi true, należy określić zaktualizowaną lokalizację.Określona wartość powinna być w pełni kwalifikowaną ścieżką URL lub UNC. |
Description |
Parametr opcjonalny String. Określa opcjonalny opis dla aplikacji. |
DisallowUrlActivation |
Parametr opcjonalny Boolean. Określa, czy aplikacja powinna zostać uruchomiona automatycznie po otwarciu go przy użyciu adresu URL.Jeśli ten parametr wynosi true, aplikacja może być uruchomiona tylko z menu Start.Wartość domyślna tego parametru to false.Wejście to stosuje się tylko wtedy, gdy Install wartość parametru- true. |
EntryPoint |
Parametr opcjonalny ITaskItem[]. Wskazuje punkt wejścia dla wygenerowanego zestawu manifestu.W przypadku manifestu wdrażania ClickOnce dane wejściowe określają manifest aplikacji ClickOnce. W Visual Studio 2005, GenerateApplicationManifest — Zadanie wymagane EntryPoint do generowania manifestu aplikacji. (Zestaw lub manifesty macierzyste nie wymagają EntryPoint.) Wymóg ten był stosowany z powodu błędu kompilacji: "MSB3185: punkt wejścia nie został określony dla manifestu." MSBuild nie wystawia tego błędu podczas EntryPoint gdy zadanie parametru nie jest określone.Zamiast tego, znacznik <customHostSpecified> jest wstawiany jako element podrzędny znacznika <punktu wejścia>, na przykład: <entryPoint xmlns="urn:schemas- microsoft-com:asm.v2"> <co.v1:customHostSpecified /> </entryPoint> Można dodać zależności DLL do manifestu aplikacji, wykonując następujące kroki:
|
ErrorReportUrl |
Parametr opcjonalny [String]. Określa adres URL strony sieci Web, która jest wyświetlana w oknach dialogowych podczas instalacji ClickOnce. |
InputManifest |
Parametr opcjonalny ITaskItem. Wskazuje dokument danych wejściowych XML, aby służyć jako podstawa do generatora manifestu.Dzięki temu dane strukturalnych, takie jak niestandardowe definicje manifestu są odzwierciedlane w manifeście danych wyjściowych.Element główny dokumentu XML musi być zbiorem węzła trustInfo w obszarze nazw asmv1. |
Install |
Parametr opcjonalny Boolean. Określa, czy aplikacja jest zainstalowaną aplikacją lub aplikacją tylko w Internecie.Jeśli ten parametr wynosi true, aplikacja zostanie zainstalowana w menu Start użytkownika i może być usunięte za pomocą okna dialogowego Dodaj lub usuń programy.Jeśli ten parametr ma wartość false, aplikacja jest przeznaczona do wykorzystania ze strony sieci Web w trybie online.Wartość domyślna tego parametru to true. |
MapFileExtensions |
Parametr opcjonalny Boolean. Określa, czy mapowanie rozszerzenia nazwy pliku .deploy jest używane.Jeśli ten parametr wynosi true, każdy plik programu jest publikowany z rozszerzeniem nazwy pliku .deploy.Ta opcja jest przydatna dla zabezpieczeń serwera sieci Web, aby ograniczyć liczbę rozszerzeń nazw plików, które muszą być odblokowane, żeby umożliwić ClickOnce wdrażanie aplikacji.Wartość domyślna tego parametru to false. |
MaxTargetPath |
Parametr opcjonalny String. Określa maksymalną dozwoloną długość ścieżki pliku we ClickOnce wdrażaniu aplikacji.Jeśli ten parametr jest określony, długość każdej ścieżki pliku w aplikacji jest sprawdzana względem tego limitu.Wszystkie elementy, które przekraczają limit spowodują ostrzeżenia kompilacji.Jeśli wejście to nie zostało określone lub jest równe zeru, żadne sprawdzanie nie jest przeprowadzane. |
MinimumRequiredVersion |
Parametr opcjonalny String. Określa, czy użytkownik może pominąć tę aktualizację.Jeśli użytkownik posiada wersję, która jest gorsza niż minimum wymagań, nie będzie mógł pominąć aktualizacji.Wejście to stosuje się tylko wtedy, gdy Install parametru- true. |
OutputManifest |
Parametr opcjonalny ITaskItem. Określa nazwę utworzonego wyjściowego pliku manifestu.Jeśli ten parametr nie jest określony, nazwa pliku danych zewnętrznych wynika z tożsamości wygenerowanego manifestu. |
Platform |
Parametr opcjonalny String. Określa platformę docelową aplikacji.Ten parametr może mieć następujące wartości:
Wartością domyślną jest AnyCPU. |
Product |
Parametr opcjonalny String. Określa nazwę aplikacji.Jeśli ten parametr nie jest określony, nazwa wynika z tożsamości wygenerowanego manifestu.Nazwa ta jest używaną nazwą skrótu w menu Start i jest częścią nazwy, która pojawia się w oknie dialogowym Dodaj lub Usuń programy. |
Publisher |
Parametr opcjonalny String. Określa wydawcę aplikacji.Jeśli ten parametr nie jest określony, nazwa wynika z zarejestrowanego użytkownika lub tożsamości wygenerowanego manifestu.Nazwa ta jest używaną nazwą folderu w menu start i jest częścią nazwy, która pojawia się w oknie dialogowym Dodaj lub Usuń programy. |
SuiteNamel |
Parametr opcjonalny String. Określa nazwę folderu menu Start, w którym znajduje się aplikacja po wdrażania ClickOnce. |
SupportUrl |
Parametr opcjonalny String. Umożliwia określenie łącza, który pojawia się w oknie dialogowym Dodaj lub usuń programy w aplikacji.Określona wartość powinna być w pełni kwalifikowaną ścieżką URL lub UNC. |
TargetCulture |
Parametr opcjonalny String. Identyfikuje kulturę aplikacji i określa pole Language tożsamości zestawu wygenerowanego manifestu.Jeśli ten parametr nie jest określony, zakłada się, że aplikacja jest kulturowo niezmienna. |
TrustUrlParameters |
Parametr opcjonalny Boolean. Określa, czy parametry ciągu zapytania URL powinny zostać udostępnione do aplikacji.Wartością domyślną tego parametru jest false, która wskazuje, że parametry nie będą dostępne dla aplikacji. |
UpdateEnabled |
Parametr opcjonalny Boolean. Wskazuje, czy aplikacja jest włączona dla aktualizacji.Wartość domyślna tego parametru to false.Ten parametr stosuje się tylko wtedy, gdy Install parametru wynosi true. |
UpdateInterval |
Parametr opcjonalny Int32. Określa interwał aktualizacji dla aplikacji.Wartość domyślna tego parametru to zero.Ten parametr stosuje się tylko wtedy, gdy wartość Install i UpdateEnabled parametry są zarówno true. |
UpdateMode |
Parametr opcjonalny String. Określa, czy aktualizacje powinny być sprawdzane na pierwszym planie, zanim aplikacja jest uruchomiona lub jest uruchomiona w tle jako aplikacja.Ten parametr może mieć następujące wartości:
Wartość domyślna tego parametru to Background.Ten parametr stosuje się tylko wtedy, gdy wartość Install i UpdateEnabled parametry są zarówno true. |
UpdateUnit |
Parametr opcjonalny String. Określa jednostki dla UpdateInterval parametru.Ten parametr może mieć następujące wartości:
Ten parametr stosuje się tylko wtedy, gdy wartość Install i UpdateEnabled parametry są zarówno true. |
Uwagi
Oprócz parametrów wymienionych powyżej, to zadanie dziedziczy parametry z klasy GenerateManifestBase, która sama dziedziczy z klasy Task.Aby uzyskać listę parametrów klasy Zadanie, zobacz Klasa podstawowa zadania.
Zobacz też
Informacje
GenerateApplicationManifest — Zadanie