GenerateDeploymentManifest – úloha
Generuje manifest nasazení ClickOnce.Manifest nasazení ClickOnce popisuje nasazení aplikace definicí jedinečné identity pro nasazení, určením vlastností nasazení (například instalace nebo online režimu), upřesněním nastavení aktualizace aplikace a umístění aktualizací a označením odpovídajícího manifestu aplikace ClickOnce.
Parametry
Následující tabulka popisuje parametry úkolu GenerateDeploymentManifest.
Parametr |
Description |
---|---|
AssemblyName |
Volitelné parametry String. Určuje pole Name identity sestavení pro generovaný manifest.Pokud tento parametr nezadáte, název je odvozen z parametrů EntryPoint nebo InputManifest.Pokud název nelze odvodit, úloha vyvolá chybu. |
AssemblyVersion |
Volitelné parametry String. Určuje pole Version identity sestavení pro generovaný manifest.Pokud tento parametr není zadán, použije úloha výchozí hodnotu "1.0.0.0". |
CreateDesktopShortcut |
Volitelné parametry Boolean. Pokud je hodnota true, je vytvořena ikona na ploše během instalace aplikace ClickOnce. |
DeploymentUrl |
Volitelné parametry String. Zadejte umístění aktualizace pro aplikaci.Pokud není tento parametr zadán, není definováno žádné umístění aktualizace pro aplikaci.Pokud však parametr UpdateEnabled je true, umístění aktualizace musí být zadáno.Zadaná hodnota musí být úplná cesta URL nebo UNC. |
Description |
Volitelné parametry String. Určuje volitelný popis aplikace. |
DisallowUrlActivation |
Volitelné parametry Boolean. Určuje, zda je aplikace spouštěna automaticky při otevření prostřednictvím adresy URL.Pokud je tento parametr true, aplikaci lze spustit pouze z nabídky Start.Výchozí hodnota tohoto parametru je false.Tento vstup platí pouze tehdy, když hodnota parametru Install je true. |
EntryPoint |
Volitelné parametry ITaskItem[]. Označuje položku zadání pro generované sestavení manifestu.Pro manifest nasazení ClickOnce tento vstup určuje manifest aplikace ClickOnce. V Visual Studio 2005, GenerateApplicationManifest – úloha vyžaduje EntryPoint ke generování manifestu aplikace. (Sestavení nebo nativní manifesty nevyžadují EntryPoint.) Tento požadavek byl vynuceno chybou sestavení: „MSB3185: Nebyl zadán parametr EntryPoint pro manifest.“. MSBuild nevydává tuto chybu, když není parametr úlohy EntryPoint zadán.Místo toho je vložena značka <customHostSpecified> jako podřízený značky <entryPoint>, například: <entryPoint xmlns="urn:schemas- microsoft-com:asm.v2"> <co.v1:customHostSpecified /> </entryPoint> Závislosti mezi knihovnami DLL k manifestu aplikace můžete přidat pomocí následujících kroků:
|
ErrorReportUrl |
Volitelné parametry [String]. Určuje adresu URL webové stránky, která se zobrazí v dialogových oknech během instalace ClickOnce. |
InputManifest |
Volitelné parametry ITaskItem. Označuje vstupní dokument XML sloužící jako základ pro generátor manifestu.To umožňuje strukturovaným datům, například definicím vlastního manifestu, se projevovat ve výstupním manifestu.Kořenový prvek v dokumentu XML musí být uzel sestavení v oboru názvů asmv1. |
Install |
Volitelné parametry Boolean. Určuje, zda je aplikace nainstalovaná aplikace nebo aplikace pouze online.Pokud je tento parametr true, aplikace bude nainstalována v v nabídce Start uživatele a lze ji odstranit pomocí dialogového okna Přidat nebo odebrat programy.Pokud je tento parametr false, aplikace je určena pro použití online z webové stránky.Výchozí hodnota tohoto parametru je true. |
MapFileExtensions |
Volitelné parametry Boolean. Určuje, zda je použito mapování přípon názvů souborů .deploy.Pokud je tento parametr true, každý programový soubor je publikován 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é musí být odblokovány pro povolení nasazení aplikace ClickOnce.Výchozí hodnota tohoto parametru je false. |
MaxTargetPath |
Volitelné parametry String. Určuje maximální povolenou délku cesty souboru v nasazení aplikace ClickOnce.Pokud je tento parametr zadán, délka každé cesty souboru v aplikaci je porovnávána s tímto limitem.Všechny položky, které překračují limit, způsobí upozornění sestavení.Pokud tento vstup není zadán nebo je nula, žádná kontrola se neprovádí. |
MinimumRequiredVersion |
Volitelné parametry String. Určuje, zda uživatel může přeskočit aktualizaci.Má-li uživatel verzi, která je nižší než požadované minimum, nebude mít možnost přeskočit aktualizaci.Tento vstup platí pouze tehdy, když hodnota parametru Install je true. |
OutputManifest |
Volitelné parametry ITaskItem. Specifikuje název generovaného výstupního souboru manifestu.Pokud tento parametr nezadáte, název výstupního souboru je odvozen z identity generovaného manifestu. |
Platform |
Volitelné parametry String. Určuje cílovou platformu aplikace.Tento parametr může mít následující hodnoty:
Výchozí hodnota je AnyCPU. |
Product |
Volitelné parametry String. Určuje název aplikace.Pokud tento parametr nezadáte, název je odvozen z identity generované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é parametry String. Určuje název vydavatele aplikace.Pokud tento parametr nezadáte, název je odvozen z registrovaného uživatele nebo z identity generované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é parametry String. Určuje název složky v nabídce Start, kde je umístěna aplikace po nasazení ClickOnce. |
SupportUrl |
Volitelné parametry String. Určuje odkaz, který se zobrazí v dialogovém okně Přidat nebo odebrat programy pro aplikaci.Zadaná hodnota musí být úplná cesta URL nebo UNC. |
TargetCulture |
Volitelné parametry String. Určuje jazykovou verzi aplikace a určuje pole Language identity sestavení pro generovaný manifest.Pokud není tento parametr zadán, předpokládá se, že aplikace je invariantní jazyková verze. |
TrustUrlParameters |
Volitelné parametry Boolean. Určuje, zda parametry řetězce dotazu adresy URL by měly být aplikaci k dispozici.Výchozí hodnota tohoto parametru je false, což znamená, že parametry nebudou k dispozici aplikaci. |
UpdateEnabled |
Volitelné parametry Boolean. Označuje, zda je aplikace povolena pro aktualizace.Výchozí hodnota tohoto parametru je false.Tento parametr platí pouze tehdy, když hodnota parametru Install je true. |
UpdateInterval |
Volitelné parametry Int32. Zadejte interval aktualizace pro aplikaci.Výchozí hodnota tohoto parametru je nula.Tento parametr platí pouze tehdy, když hodnoty parametrů Install a UpdateEnabled jsou obě true. |
UpdateMode |
Volitelné parametry String. Určuje, zda mají být aktualizace zkontrolovány na popředí před spuštěním aplikace nebo na pozadí, když aplikace běží.Tento parametr může mít následující hodnoty:
Výchozí hodnota tohoto parametru je Background.Tento parametr platí pouze tehdy, když hodnoty parametrů Install a UpdateEnabled jsou obě true. |
UpdateUnit |
Volitelné parametry String. Určuje jednotky pro parametr UpdateInterval.Tento parametr může mít následující hodnoty:
Tento parametr platí pouze tehdy, když hodnoty parametrů Install a UpdateEnabled jsou obě true. |
Poznámky
Kromě výše uvedených parametrů zdědí tento úkol parametry ze třídy GenerateManifestBase, která sama dědí ze třídy Task.Seznam parametrů třídy Úkoly naleznete v části Třída Base úlohy.
Viz také
Referenční dokumentace
GenerateApplicationManifest – úloha