GenerateDeploymentManifest – úloha

  • Článek

Vygeneruje manifest nasazení ClickOnce. Manifest nasazení ClickOnce popisuje nasazení aplikace definováním jedinečné identity pro nasazení, identifikací vlastností nasazení, jako je instalace nebo online režim, určení nastavení aktualizace aplikace a umístění aktualizace a indikující odpovídající manifest aplikace ClickOnce.

Parametry

Následující tabulka popisuje parametry úlohy GenerateDeploymentManifest .

Parametr Popis
AssemblyName Volitelný String parametr.

Určuje Name pole identity sestavení pro vygenerovaný manifest. Pokud tento parametr není zadaný, název se odvodí z EntryPoint parametrů nebo InputManifest parametrů. Pokud název nelze odvodit, úloha vyvolá chybu.
AssemblyVersion Volitelný String parametr.

Určuje Version pole identity sestavení pro vygenerovaný manifest. Pokud tento parametr není zadaný, použije úloha hodnotu 1.0.0.0.
CreateDesktopShortcut Volitelný Boolean parametr.

Pokud ano, během instalace aplikace ClickOnce se na ploše vytvoří ikona.
DeploymentUrl Volitelný String parametr.

Určuje umístění aktualizace aplikace. Pokud tento parametr není zadán, není pro aplikaci definováno žádné umístění aktualizace. Pokud je truevšak UpdateEnabled parametr , musí být zadáno umístění aktualizace. Zadaná hodnota by měla být plně kvalifikovaná adresa URL nebo cesta UNC.
Description Volitelný String parametr.

Určuje volitelný popis aplikace.
DisallowUrlActivation Volitelný Boolean parametr.

Určuje, jestli se má aplikace spustit automaticky při otevření prostřednictvím adresy URL. Pokud je truetento parametr, lze aplikaci spustit pouze z nabídky Start . Výchozí hodnota tohoto parametru je false. Tento vstup platí pouze v případě, že hodnota parametru Install je true.
EntryPoint Volitelný ITaskItem[] parametr.

Označuje vstupní bod pro vygenerované sestavení manifestu. Pro manifest nasazení ClickOnce určuje tento vstup manifest aplikace ClickOnce.

EntryPoint Pokud není zadaný parametr úkolu, <customHostSpecified> značka se vloží jako podřízená značka<entryPoint>, například:

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

<co.v1:customHostSpecified />

</entryPoint>

K manifestu aplikace můžete přidat závislosti knihovny DLL pomocí následujícího postupu:

1. Vyřešte odkazy na sestavení voláním ResolveAssemblyReference.
2. Předejte výstup předchozího úkolu a samotné sestavení do ResolveManifestFiles.
3. Předejte závislosti pomocí parametru Dependencies do GenerateApplicationManifest.
ErrorReportUrl Volitelný System.String parametr.

Určuje adresu URL webové stránky, která se zobrazí v dialogových oknech během instalací ClickOnce.
InputManifest Volitelný ITaskItem parametr.

Označuje vstupní dokument XML, který bude sloužit jako základ pro generátor manifestu. To umožňuje, aby se strukturovaná data, jako jsou vlastní definice manifestu, projevila ve výstupním manifestu. Kořenový prvek v dokumentu XML musí být uzel sestavení v oboru názvů asmv1.
Install Volitelný Boolean parametr.

Určuje, jestli je aplikace nainstalovanou nebo pouze online aplikací. Pokud je truetento parametr , aplikace se nainstaluje v nabídce Start uživatele a lze ji odebrat pomocí dialogového okna Přidat nebo odebrat programy. Pokud je falsetento parametr, aplikace je určená pro online použití z webové stránky. Výchozí hodnota tohoto parametru je true.
MapFileExtensions Volitelný Boolean parametr.

Určuje, jestli se používá mapování přípony názvu souboru .deploy . Pokud je truetento parametr, každý programový soubor se publikuje s příponou názvu souboru .deploy . Tato možnost je užitečná pro zabezpečení webového serveru k omezení počtu přípon názvů souborů, které je nutné odblokovat, aby bylo možné povolit nasazení aplikace ClickOnce. Výchozí hodnota tohoto parametru je false.
MaxTargetPath Volitelný String parametr.

Určuje maximální povolenou délku cesty k souboru v nasazení aplikace ClickOnce. Pokud je tento parametr zadán, délka každé cesty k souboru v aplikaci je kontrolována proti tomuto limitu. Všechny položky, které tento limit překročí, způsobí upozornění na sestavení. Pokud tento vstup není zadaný nebo je nulový, neprovádí se žádná kontrola.
MinimumRequiredVersion Volitelný String parametr.

Určuje, jestli uživatel může aktualizaci přeskočit. Pokud má uživatel verzi, která je menší než minimální požadovaná hodnota, nebude mít možnost aktualizaci přeskočit. Tento vstup platí pouze v případě, že hodnota parametru Install je true.
OutputManifest Volitelný ITaskItem parametr.

Určuje název vygenerovaného výstupního souboru manifestu. Pokud tento parametr není zadaný, název výstupního souboru se odvodí z identity vygenerovaného manifestu.
Platform Volitelný String parametr.

Určuje cílovou platformu aplikace. Tento parametr může mít následující hodnoty:

- AnyCPU
- x86
- x64
- Itanium

Výchozí hodnota je AnyCPU.
Product Volitelný String parametr.

Určuje název aplikace. Pokud tento parametr není zadaný, název se odvodí z identity vygenerovaného manifestu. Tento název se používá pro název zástupce v nabídce Start a je součástí názvu, který se zobrazí v dialogovém okně Přidat nebo odebrat programy .
Publisher Volitelný String parametr.

Určuje vydavatele aplikace. Pokud tento parametr není zadaný, název se odvodí od registrovaného uživatele nebo identity vygenerovaného manifestu. Tento název se používá pro název složky v nabídce Start a je součástí názvu, který se zobrazí v dialogovém okně Přidat nebo odebrat programy .
SuiteNamel Volitelný String parametr.

Určuje název složky v nabídce Start , kde se aplikace nachází po nasazení ClickOnce.
SupportUrl Volitelný String parametr.

Určuje odkaz, který se zobrazí v dialogovém okně Přidat nebo odebrat programy pro aplikaci. Zadaná hodnota by měla být plně kvalifikovaná adresa URL nebo cesta UNC.
TargetCulture Volitelný String parametr.

Identifikuje jazykovou verzi aplikace a určuje Language pole identity sestavení pro vygenerovaný manifest. Pokud tento parametr není zadán, předpokládá se, že aplikace je invariantní.
TrustUrlParameters Volitelný Boolean parametr.

Určuje, jestli mají být parametry řetězce dotazu adresy URL zpřístupněny aplikaci. Výchozí hodnota tohoto parametru je false, což značí, že parametry nebudou pro aplikaci k dispozici.
UpdateEnabled Volitelný Boolean parametr.

Určuje, jestli je aplikace povolená pro aktualizace. Výchozí hodnota tohoto parametru je false. Tento parametr platí pouze v případě, že hodnota parametru Install je true.
UpdateInterval Volitelný Int32 parametr.

Určuje interval aktualizace pro aplikaci. Výchozí hodnota tohoto parametru je nula. Tento parametr se použije pouze v případě, že jsou truehodnoty Install obou UpdateEnabled parametrů .
UpdateMode Volitelný String parametr.

Určuje, zda mají být aktualizace vráceny se změnami v popředí před spuštěním aplikace, nebo na pozadí při spuštění aplikace. Tento parametr může mít následující hodnoty:

- Foreground
- Background

Výchozí hodnota tohoto parametru je Background. Tento parametr se použije pouze v případě, že jsou truehodnoty Install obou UpdateEnabled parametrů .
UpdateUnit Volitelný String parametr.

Určuje jednotky parametru UpdateInterval . Tento parametr může mít následující hodnoty:

- Hours
- Days
- Weeks

Tento parametr se použije pouze v případě, že jsou truehodnoty Install obou UpdateEnabled parametrů .

Poznámky

Kromě výše uvedených parametrů tato úloha dědí parametry z GenerateManifestBase třídy, která sama dědí z Task třídy. Seznamparametrůch

Viz také