Określanie adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych we wdrożeniu technologii ClickOnce

  • Artykuł

Wdrożenie ClickOnce może przetestować szereg wymagań wstępnych, które muszą być dostępne na komputerze klienckim, aby można było uruchomić aplikację ClickOnce. Te zależności obejmują wymaganą minimalną wersję programu .NET Framework, wersję systemu operacyjnego i wszystkie zestawy, które muszą być wstępnie zainstalowane w globalnej pamięci podręcznej zestawów (GAC). ClickOnce nie może jednak zainstalować żadnego z tych wymagań wstępnych; Jeśli nie znaleziono wymagań wstępnych, po prostu zatrzymuje instalację i wyświetla okno dialogowe z wyjaśnieniem, dlaczego instalacja nie powiodła się.

Istnieją dwie metody instalowania wymagań wstępnych. Można je zainstalować przy użyciu aplikacji programu inicjjącego. Alternatywnie można określić adres URL pomocy technicznej dla poszczególnych wymagań wstępnych, który jest wyświetlany użytkownikom w oknie dialogowym, jeśli nie znaleziono wymagań wstępnych. Strona, do którego odwołuje się ten adres URL, może zawierać linki do instrukcji dotyczących instalowania wymaganych wymagań wstępnych. Jeśli aplikacja nie określi adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych, clickOnce wyświetla adres URL pomocy technicznej określony w manifeście wdrożenia dla aplikacji jako całości, jeśli jest zdefiniowany.

Chociaż można używać programów Visual Studio, Mage.exe i MageUI.exe do generowania wdrożeń technologii ClickOnce, żaden z tych narzędzi bezpośrednio nie obsługuje określania adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych. W tym dokumencie opisano sposób modyfikowania manifestu aplikacji i manifestu wdrożenia wdrożenia w celu uwzględnienia tych adresów URL obsługi.

Określanie adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych

  1. Otwórz manifest aplikacji (plik manifestu) dla aplikacji ClickOnce w edytorze tekstów.

  2. W przypadku wymagań wstępnych systemu operacyjnego dodaj supportUrl atrybut do dependentOS elementu :

     <dependency>
    <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
      <osVersionInfo>
        <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

  3. Aby spełnić wymagania wstępne dotyczące określonej wersji środowiska uruchomieniowego języka wspólnego, dodaj supportUrl atrybut do dependentAssembly wpisu określającego zależność środowiska uruchomieniowego języka wspólnego:

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

  4. Aby spełnić wymagania wstępne dotyczące zestawu, który musi być wstępnie zainstalowany w globalnej pamięci podręcznej zestawów, ustaw supportUrl dla dependentAssembly elementu, który określa wymagany zestaw:

      <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>

  5. Opcjonalny. W przypadku aplikacji przeznaczonych dla programu .NET Framework 4 otwórz manifest wdrożenia ( plik aplikacji ) dla aplikacji ClickOnce w edytorze tekstów.

  6. W przypadku wymagań wstępnych programu .NET Framework 4 dodaj supportUrl atrybut do compatibleFrameworks elementu:

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

  7. Po ręcznym zmianie manifestu aplikacji należy ponownie podpisać manifest aplikacji przy użyciu certyfikatu cyfrowego, a następnie zaktualizować i ponownie podpisać manifest wdrożenia. Użyj narzędzi Mage.exe lub MageUI.exe SDK, aby wykonać to zadanie, ponieważ ponowne generowanie tych plików przy użyciu programu Visual Studio usuwa zmiany ręczne. Aby uzyskać więcej informacji na temat ponownego podpisywania manifestów przy użyciu narzędzia Mage.exe, zobacz Instrukcje: ponowne podpisywanie manifestów aplikacji i wdrażania.

zabezpieczenia .NET Framework

Adres URL obsługi nie jest wyświetlany w oknie dialogowym, jeśli aplikacja jest oznaczona do uruchamiania w częściowym zaufaniu.

Powiązana zawartość