GenerateDeploymentManifest-Aufgabe
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 Anwendungsupdates und Updatepfade 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". |
CreateDesktopShortcut |
Optionaler Boolean-Parameter. Wenn "true", wird während der Installation der ClickOnce-Anwendung ein Symbol auf dem Desktop erstellt. |
DeploymentUrl |
Optionaler String-Parameter. Gibt den Updatepfad der Anwendung an. Wenn dieser Parameter nicht angegeben wird, wird kein Updatepfad für die Anwendung definiert. Weist der UpdateEnabled-Parameter jedoch den Wert true auf, muss der Updatepfad 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 die 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". MSBuild gibt diesen Fehler nicht aus, wenn der EntryPoint-Aufgabenparamenter nicht angegeben ist. 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:
|
ErrorReportUrl |
Optionaler [String]-Parameter. Gibt die URL der Webseite an, die während der ClickOnce-Installationen in den Dialogfeldern angezeigt wird. |
InputManifest |
Optionaler ITaskItem-Parameter. Gibt ein Eingabe-XML-Dokument an, das als Basis für den Manifestgenerator dienen soll. Dadurch können strukturierte Daten im Ausgabemanifest dargestellt werden, beispielsweise benutzerdefinierte Manifestdefinitionen. 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 im Startmenü des Benutzers installiert und kann über das 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 das Update überspringen kann. Wenn der Benutzer nicht mindestens über die erforderliche Version verfügt, steht die Option zum Überspringen des Updates 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 ist, wird der Name vom registrierten Benutzer oder von der Identität des generierten Manifests abgeleitet. Dieser Name wird für den Ordnernamen im Startmenü verwendet und ist Teil des Namens, der im Dialogfeld "Software" angezeigt wird. |
SuiteNamel |
Optionaler String-Parameter. Gibt den Namen des Ordners im Menü "Start" an, in dem sich die Anwendung nach der ClickOnce-Bereitstellung befindet. |
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 ist, 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 Updates 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 Updateintervall 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 Updates 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
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der GenerateManifestBase-Klasse, die selbst von der Task-Klasse erbt. Eine Liste der Parameter der "Task"-Klasse finden Sie unter Aufgabenbasisklasse.
Siehe auch
Referenz
GenerateApplicationManifest-Aufgabe