GenerateDeploymentManifest — zadanie

  • Artykuł

Generuje manifest wdrożenia ClickOnce. Manifest wdrożenia ClickOnce opisuje wdrażanie aplikacji przez zdefiniowanie unikatowej tożsamości wdrożenia, identyfikowanie cech wdrożenia, takich jak instalacja lub tryb online, określanie ustawień aktualizacji aplikacji i lokalizacji aktualizacji oraz wskazanie odpowiedniego manifestu aplikacji ClickOnce.

Parametry

W poniższej tabeli opisano parametry zadania GenerateDeploymentManifest .

Parametr Opis
AssemblyName Opcjonalny String parametr.

Określa Name pole tożsamości zestawu dla wygenerowanego manifestu. Jeśli ten parametr nie zostanie określony, nazwa zostanie wywnioskowana z EntryPoint parametrów lub InputManifest . Jeśli nie można wywnioskować nazwy, zadanie zgłasza błąd.
AssemblyVersion Opcjonalny String parametr.

Określa Version pole tożsamości zestawu dla wygenerowanego manifestu. Jeśli ten parametr nie zostanie określony, zadanie używa wartości "1.0.0.0".
CreateDesktopShortcut Opcjonalny Boolean parametr.

Jeśli wartość true, na pulpicie zostanie utworzona ikona podczas instalacji aplikacji ClickOnce.
DeploymentUrl Opcjonalny String parametr.

Określa lokalizację aktualizacji aplikacji. Jeśli ten parametr nie zostanie określony, nie zdefiniowano lokalizacji aktualizacji dla aplikacji. UpdateEnabled Jeśli jednak parametr ma truewartość , należy określić lokalizację aktualizacji. Określona wartość powinna być w pełni kwalifikowanym adresem URL lub ścieżką UNC.
Description Opcjonalny String parametr.

Określa opcjonalny opis aplikacji.
DisallowUrlActivation Opcjonalny Boolean parametr.

Określa, czy aplikacja powinna być uruchamiana automatycznie po otwarciu za pośrednictwem adresu URL. Jeśli ten parametr to true, aplikację można uruchomić tylko z menu Start . Wartość domyślna tego parametru to false. Te dane wejściowe mają zastosowanie tylko wtedy, gdy wartość parametru Install to true.
EntryPoint Opcjonalny ITaskItem[] parametr.

Wskazuje punkt wejścia dla wygenerowanego zestawu manifestu. W przypadku manifestu wdrożenia Technologii ClickOnce dane wejściowe określają manifest aplikacji ClickOnce.

EntryPoint Jeśli parametr zadania nie zostanie określony, <customHostSpecified> tag zostanie wstawiony jako element podrzędny tagu<entryPoint>, na przykład:

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

<co.v1:customHostSpecified />

</entryPoint>

Zależności bibliotek DLL można dodać do manifestu aplikacji, wykonując następujące kroki:

1. Rozwiąż odwołania do zestawu za pomocą wywołania metody ResolveAssemblyReference.
2. Przekaż dane wyjściowe poprzedniego zadania i sam zestaw do ResolveManifestFileselementu .
3. Przekaż zależności przy użyciu parametru Dependencies do GenerateApplicationManifest.
ErrorReportUrl Opcjonalny System.String parametr.

Określa adres URL strony internetowej, która jest wyświetlana w oknach dialogowych podczas instalacji Technologii ClickOnce.
InputManifest Opcjonalny ITaskItem parametr.

Wskazuje wejściowy dokument XML służący jako podstawa generatora manifestu. Dzięki temu dane ustrukturyzowane, takie jak definicje manifestu niestandardowego, będą odzwierciedlane w manifeście wyjściowym. Element główny w dokumencie XML musi być węzłem zestawu w przestrzeni nazw asmv1.
Install Opcjonalny Boolean parametr.

Określa, czy aplikacja jest zainstalowaną aplikacją, czy aplikacją tylko w trybie online. Jeśli ten parametr to true, aplikacja zostanie zainstalowana w menu Start użytkownika i może zostać usunięta za pomocą okna dialogowego Dodawanie lub usuwanie programów. Jeśli ten parametr to false, aplikacja jest przeznaczona do użytku online ze strony internetowej. Wartość domyślna tego parametru to true.
MapFileExtensions Opcjonalny Boolean parametr.

Określa, czy jest używane mapowanie rozszerzenia nazwy pliku.deploy . Jeśli ten parametr to true, każdy plik programu jest publikowany z rozszerzeniem .deploy nazwy pliku. Ta opcja jest przydatna w przypadku zabezpieczeń serwera internetowego, aby ograniczyć liczbę rozszerzeń nazw plików, które należy odblokować, aby włączyć wdrożenie aplikacji ClickOnce. Wartość domyślna tego parametru to false.
MaxTargetPath Opcjonalny String parametr.

Określa maksymalną dozwoloną długość ścieżki pliku we wdrożeniu aplikacji ClickOnce. Jeśli ten parametr zostanie 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żenie kompilacji. Jeśli te dane wejściowe nie są określone lub nie są zerowe, nie jest wykonywane sprawdzanie.
MinimumRequiredVersion Opcjonalny String parametr.

Określa, czy użytkownik może pominąć aktualizację. Jeśli użytkownik ma wersję mniejszą niż minimalna wymagana, nie będzie miał możliwości pominięcia aktualizacji. Te dane wejściowe mają zastosowanie tylko wtedy, gdy wartość parametru Install to true.
OutputManifest Opcjonalny ITaskItem parametr.

Określa nazwę wygenerowanego pliku manifestu wyjściowego. Jeśli ten parametr nie zostanie określony, nazwa pliku wyjściowego zostanie wywnioskowana z tożsamości wygenerowanego manifestu.
Platform Opcjonalny String parametr.

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

- AnyCPU
- x86
- x64
- Itanium

Wartość domyślna to AnyCPU.
Product Opcjonalny String parametr.

Określa nazwę aplikacji. Jeśli ten parametr nie zostanie określony, nazwa zostanie wywnioskowana z tożsamości wygenerowanego manifestu. Ta nazwa jest używana dla nazwy skrótu w menu Start i jest częścią nazwy wyświetlanej w oknie dialogowym Dodawanie lub usuwanie programów .
Publisher Opcjonalny String parametr.

Określa wydawcę aplikacji. Jeśli ten parametr nie zostanie określony, nazwa zostanie wywnioskowana z zarejestrowanego użytkownika lub tożsamość wygenerowanego manifestu. Ta nazwa jest używana dla nazwy folderu w menu Start i jest częścią nazwy wyświetlanej w oknie dialogowym Dodawanie lub usuwanie programów .
SuiteNamel Opcjonalny String parametr.

Określa nazwę folderu w menu Start , w którym znajduje się aplikacja po wdrożeniu Technologii ClickOnce.
SupportUrl Opcjonalny String parametr.

Określa link wyświetlany w oknie dialogowym Dodawanie lub usuwanie programów dla aplikacji. Określona wartość powinna być w pełni kwalifikowanym adresem URL lub ścieżką UNC.
TargetCulture Opcjonalny String parametr.

Identyfikuje kulturę aplikacji i określa Language pole tożsamości zestawu dla wygenerowanego manifestu. Jeśli ten parametr nie zostanie określony, zakłada się, że aplikacja jest niezmienna w kulturze.
TrustUrlParameters Opcjonalny Boolean parametr.

Określa, czy parametry ciągu zapytania adresu URL powinny być udostępniane aplikacji. Wartość domyślna tego parametru to false, która wskazuje, że parametry nie będą dostępne dla aplikacji.
UpdateEnabled Opcjonalny Boolean parametr.

Wskazuje, czy aplikacja jest włączona dla aktualizacji. Wartość domyślna tego parametru to false. Ten parametr ma zastosowanie tylko wtedy, gdy wartość parametru Install to true.
UpdateInterval Opcjonalny Int32 parametr.

Określa interwał aktualizacji aplikacji. Wartość domyślna tego parametru to zero. Ten parametr ma zastosowanie tylko wtedy, gdy wartości parametrów Install i UpdateEnabled to true.
UpdateMode Opcjonalny String parametr.

Określa, czy aktualizacje mają być zaewidencjonowane na pierwszym planie przed uruchomieniem aplikacji, czy w tle, gdy aplikacja jest uruchomiona. Ten parametr może mieć następujące wartości:

- Foreground
- Background

Wartość domyślna tego parametru to Background. Ten parametr ma zastosowanie tylko wtedy, gdy wartości parametrów Install i UpdateEnabled to true.
UpdateUnit Opcjonalny String parametr.

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

- Hours
- Days
- Weeks

Ten parametr ma zastosowanie tylko wtedy, gdy wartości parametrów Install i UpdateEnabled to true.

Uwagi

Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z GenerateManifestBase klasy, która sama dziedziczy z Task klasy. Aby uzyskać listę parametrów klasy Task, zobacz Task base class (Klasa podstawowa zadania).

Zobacz też