Gewusst wie: Angeben eines Support-URLs für einzelne erforderliche Komponenten in einer ClickOnce-Bereitstellung
Aktualisiert: November 2007
Wie in Vorbedingungen für die Anwendungsbereitstellung beschrieben, kann eine ClickOnce-Bereitstellung eine Reihe von erforderlichen Komponenten prüfen, die auf dem Clientcomputer verfügbar sein müssen, damit die ClickOnce-Anwendung ausgeführt wird. Hierzu gehören die mindestens benötigte Version von .NET Framework, die Version des Betriebssystems und der Assemblys, die im globalen Assemblycache (GAC) vorinstalliert sein müssen. ClickOnce kann jedoch keine dieser erforderlichen Komponenten selbst installieren. Wenn eine von ihnen nicht gefunden wird, so wird die Installation einfach angehalten und in einem Dialogfeld erklärt, warum sie nicht erfolgreich war.
Es gibt zwei Methoden für die Installation von erforderlichen Komponenten. Sie können sie, wie im oben angegebenen Dokument erläutert, mit einer Bootstrapperanwendung installieren. Alternativ können Sie einen Support-URL für einzelne erforderliche Komponenten angeben. Er wird für die Benutzer in einem Dialogfeld angezeigt, wenn die erforderliche Komponente nicht gefunden wird. Die Seite, auf die von diesem URL verwiesen wird, kann Verknüpfungen zu Anweisungen für die Installation der erforderlichen Komponente enthalten. Wenn eine Anwendung keinen Support-URL für eine einzelne erforderliche Komponente angibt, zeigt ClickOnce den Support-URL an, der im Bereitstellungsmanifest für die gesamte Anwendung angegeben ist (sofern definiert).
Visual Studio, Mage.exe und MageUI.exe können zwar alle zum Generieren von ClickOnce-Bereitstellungen verwendet werden, aber keines dieser Tools unterstützt unmittelbar die Angabe eines Support-URLs für einzelne erforderliche Komponenten. In diesem Dokument wird beschrieben, wie Sie das Anwendungsmanifest Ihrer Bereitstellung ändern, um diese Support-URLs aufzunehmen.
Angeben eines Support-URLs für eine einzelne erforderliche Komponente
Öffnen Sie das Anwendungsmanifest für die ClickOnce-Anwendung in einem Text-Editor.
Fügen Sie für ein erforderliches Betriebssystem das supportUrl-Attribut dem dependentOS-Element hinzu:
<dependency> <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm"> <osVersionInfo> <os majorVersion="4" minorVersion="0" servicePackMajor="0" servicePackMinor="0" /> </osVersionInfo> </dependentOS> </dependency>Fügen Sie für eine bestimmte erforderliche Common Language Runtime-Version das supportUrl-Attribut dem dependentAssembly-Eintrag hinzu, der die Common Language Runtime-Abhängigkeit angibt:
<dependency> <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm"> <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.40607.0" /> </dependentAssembly> </dependency>Für eine erforderliche Assembly, die im globalen Assemblycache vorinstalliert sein muss, legen Sie den supportUrl für das dependentAssembly-Element fest, dass die erforderliche Assembly angibt:
<dependency> <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm"> <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" /> </dependentAssembly> </dependency>Nachdem Sie das Anwendungsmanifest manuell geändert haben, müssen Sie es mit Ihrem digitalen Zertifikat neu signieren und anschließend das Bereitstellungsmanifest ebenfalls neu generieren und signieren. Sie müssen für diese Aufgabe das SDK-Tool Mage.exe oder MageUI.exe verwenden, da Ihre manuell durchgeführten Änderungen bei der Neugenerierung dieser Dateien mit Visual Studio rückgängig gemacht werden. Weitere Informationen zur Verwendung von MageUI.exe zum Signieren und Generieren von Manifesten finden Sie unter Tool zum Generieren und Bearbeiten von Manifesten (Mage.exe) und Exemplarische Vorgehensweise: Manuelles Bereitstellen einer ClickOnce-Anwendung.
Sicherheit
Der Support-URL wird nicht im Dialogfeld angezeigt, wenn die Anwendung für die Ausführung mit teilweiser Vertrauenswürdigkeit gekennzeichnet ist.