GenerateDeploymentManifest-Aufgabe
Aktualisiert: November 2007
Generiert ein ClickOnce-Bereitstellungsmanifest. Ein ClickOnce-Bereitstellungsmanifest beschreibt die Bereitstellung einer Anwendung, indem eine eindeutige Identität für die Bereitstellung definiert wird, Merkmale der Bereitstellung wie Installations- oder Onlinemodus angegeben werden, Einstellungen für Anwendungsaktualisierungen und Aktualisierungspfade festgelegt werden und das entsprechende ClickOnce-Anwendungsmanifest angegeben wird.
Parameter
In der folgenden Tabelle werden die Parameter für die GenerateDeploymentManifest-Aufgabe beschrieben.
Parameter |
Beschreibung |
|---|---|
AssemblyName |
Optionaler String-Parameter. Gibt das Name-Feld der Assemblyidentität für das generierte Manifest an. Wenn dieser Parameter nicht angegeben wird, wird der Name vom EntryPoint-Parameter oder InputManifest-Parameter abgeleitet. Wenn der Name nicht abgeleitet werden kann, löst die Aufgabe einen Fehler aus. |
AssemblyVersion |
Optionaler String-Parameter. Gibt das Version-Feld der Assemblyidentität für das generierte Manifest an. Wenn dieser Parameter nicht angegeben wird, verwendet die Aufgabe den Wert "1.0.0.0". |
DeploymentUrl |
Optionaler String-Parameter. Gibt den Aktualisierungspfad der Anwendung an. Wenn dieser Parameter nicht angegeben wird, wird kein Aktualisierungspfad für die Anwendung definiert. Weist der UpdateEnabled-Parameter jedoch den Wert true auf, muss der Aktualisierungspfad angegeben werden. Der angegebene Wert muss eine vollqualifizierte URL oder ein UNC-Pfad sein. |
Description |
Optionaler String-Parameter. Gibt eine optionale Beschreibung der Anwendung an. |
DisallowUrlActivation |
Optionaler Boolean-Parameter. Gibt an, ob die Anwendung automatisch ausgeführt werden soll, wenn sie über eine URL geöffnet wird. Wenn dieser Parameter den Wert true aufweist, kann die Anwendung nur über das Startmenü gestartet werden. Der Standardwert dieses Parameters ist false. Diese Eingabe ist nur gültig, wenn der Wert des Install-Parameters true ist. |
EntryPoint |
Optionaler ITaskItem[]-Parameter. Gibt den Einstiegspunkt für die generierte Manifestassembly an. Bei einem ClickOnce-Bereitstellungsmanifest gibt diese Eingabe das ClickOnce-Anwendungsmanifest an. In Visual Studio 2005 erforderte das GenerateApplicationManifest-Aufgabe einen EntryPoint zum Generieren eines Anwendungsmanifests. (Assemblys oder systemeigene Manifeste erfordern keinen EntryPoint.) Beim Erzwingen der Anforderung wurde folgender Buildfehler ausgegeben: "MSB3185: Der EntryPoint wurde für das Manifest nicht angegeben". In Visual Studio 2008 gibt MSBuild diesen Fehler nicht aus, wenn der EntryPoint-Aufgabenparameter nicht angegeben wird. Stattdessen wird das <customHostSpecified>-Tag als untergeordnetes Element des <entryPoint>-Tags eingefügt, z. B.: <entryPoint xmlns="urn:schemas- microsoft-com:asm.v2"> <co.v1:customHostSpecified /> </entryPoint> Sie können dem Anwendungsmanifest DLL-Abhängigkeiten hinzufügen, indem Sie die folgenden Schritte ausführen:
|
InputManifest |
Optionaler ITaskItem-Parameter. Gibt ein Eingabe-XML-Dokument an, das als Basis für den Manifestgenerator dienen soll. Dadurch können strukturierte Daten, wie z. B. benutzerdefinierte Manifestdefinitionen, im Ausgabemanifest dargestellt werden. Das Stammelement im XML-Dokument muss ein Assemblyknoten im asmv1-Namespace sein. |
Install |
Optionaler Boolean-Parameter. Gibt an, ob die Anwendung eine installierte Anwendung oder eine reine Onlineanwendung ist. Wenn dieser Parameter den Wert true aufweist, wird die Anwendung installiert, kann über das Startmenü gestartet und im Dialogfeld Software entfernt werden. Weist dieser Parameter den Wert false auf, ist die Anwendung zur Onlineverwendung von einer Webseite bestimmt. Der Standardwert dieses Parameters ist true. |
MapFileExtensions |
Optionaler Boolean-Parameter. Gibt an, ob die Zuordnung für die Dateinamenerweiterung .deploy verwendet wird. Wenn dieser Parameter den Wert true aufweist, wird jede Programmdatei mit der Dateinamenerweiterung .deploy veröffentlicht. Diese Option bietet sich für die Webserversicherheit an, um die Anzahl der Dateinamenerweiterungen zu begrenzen, deren Blockierung aufgehoben werden muss, damit die ClickOnce-Anwendungsbereitstellung aktiviert wird. Der Standardwert dieses Parameters ist false. |
MaxTargetPath |
Optionaler String-Parameter. Gibt die maximal zulässige Länge eines Dateipfads in einer ClickOnce-Anwendungsbereitstellung an. Wenn dieser Parameter angegeben wird, wird die Länge jedes Dateipfads in der Anwendung mit dem Grenzwert verglichen. Alle Elemente, die den Grenzwert übersteigen, lösen eine Buildwarnung aus. Wenn dieser Parameter nicht angegeben wird oder den Wert 0 (null) hat, wird keine Prüfung ausgeführt. |
MinimumRequiredVersion |
Optionaler String-Parameter. Gibt an, ob der Benutzer die Aktualisierung überspringen kann. Wenn der Benutzer nicht mindestens über die erforderliche Version verfügt, steht die Option zum Überspringen der Aktualisierung nicht zur Verfügung. Diese Eingabe ist nur gültig, wenn der Wert des Install-Parameters true ist. |
OutputManifest |
Optionaler ITaskItem-Parameter. Gibt den Namen der generierten Ausgabemanifestdatei an. Wenn dieser Parameter nicht angegeben wird, wird der Name der Ausgabedatei von der Identität des generierten Manifests abgeleitet. |
Platform |
Optionaler String-Parameter. Gibt die Zielplattform für die Anwendung an. Dieser Parameter kann die folgenden Werte aufweisen:
Der Standardwert ist AnyCPU. |
Product |
Optionaler String-Parameter. Gibt den Namen der Anwendung an. Wenn dieser Parameter nicht angegeben wird, wird der Name von der Identität des generierten Manifests abgeleitet. Dieser Name wird für die Verknüpfung im Startmenü verwendet und ist Teil des Namens, der im Dialogfeld Software angezeigt wird. |
Publisher |
Optionaler String-Parameter. Gibt den Herausgeber der Anwendung an. Wenn dieser Parameter nicht angegeben wird, wird der Name vom registrierten Benutzer oder von der Identität des generierten Manifests abgeleitet. Dieser Name wird für den Ordner im Startmenü verwendet und ist Teil des Namens, der im Dialogfeld Software angezeigt wird. |
SupportUrl |
Optionaler String-Parameter. Gibt den Link an, der im Dialogfeld Software für die Anwendung angezeigt wird. Der angegebene Wert muss eine vollqualifizierte URL oder ein UNC-Pfad sein. |
TargetCulture |
Optionaler String-Parameter. Identifiziert die Kultur der Anwendung und gibt das Language-Feld der Assemblyidentität für das generierte Manifest an. Wenn dieser Parameter nicht angegeben wird, wird davon ausgegangen, dass die Anwendung kulturinvariant ist. |
TrustUrlParameters |
Optionaler Boolean-Parameter. Gibt an, ob URL-Abfragezeichenfolgen-Parameter für die Anwendung verfügbar gemacht werden sollen. Der Standardwert dieses Parameters ist false, was bedeutet, dass der Anwendung keine Parameter zur Verfügung stehen. |
UpdateEnabled |
Optionaler Boolean-Parameter. Gibt an, ob die Anwendung für Aktualisierungen aktiviert wird. Der Standardwert dieses Parameters ist false. Dieser Parameter ist nur gültig, wenn der Wert des Install-Parameters true ist. |
UpdateInterval |
Optionaler Int32-Parameter. Gibt das Aktualisierungsintervall für die Anwendung an. Der Standardwert dieses Parameters ist 0 (null). Dieser Parameter ist nur gültig, wenn sowohl der Install-Parameter als auch der UpdateEnabled-Parameter den Wert true aufweisen. |
UpdateMode |
Optionaler String-Parameter. Gibt an, ob vor dem Start der Anwendung im Vordergrund oder nach dem Start der Anwendung im Hintergrund nach Aktualisierungen gesucht werden soll. Dieser Parameter kann die folgenden Werte aufweisen:
Der Standardwert dieses Parameters ist Background. Dieser Parameter ist nur gültig, wenn sowohl der Install-Parameter als auch der UpdateEnabled-Parameter den Wert true aufweisen. |
UpdateUnit |
Optionaler String-Parameter. Gibt die Einheiten für den UpdateInterval-Parameter an. Dieser Parameter kann die folgenden Werte aufweisen:
Dieser Parameter ist nur gültig, wenn sowohl der Install-Parameter als auch der UpdateEnabled-Parameter den Wert true aufweisen. |
Hinweise
Informationen über die Verwendung der GenerateDeploymentManifest-Aufgabe finden Sie unter GenerateApplicationManifest-Aufgabe.
Siehe auch
Konzepte
Referenz
GenerateApplicationManifest-Aufgabe