Opětovné podepisování manifestů aplikace a nasazení

  • Článek

Po provedení změn vlastností nasazení v manifestu aplikace pro model Windows Forms aplikace, aplikace Windows Presentation Foundation (xbap) nebo řešení Office je nutné znovu podepsat manifesty aplikace i nasazení pomocí certifikátu. Tento proces pomáhá zajistit, aby na počítačích koncových uživatelů nebyly nainstalovány manipulované soubory.

Dalším scénářem, ve kterém můžete manifesty znovu podepsat, je situace, kdy zákazníci chtějí podepsat manifesty aplikace a nasazení pomocí vlastního certifikátu.

Opětovné podepsání manifestů aplikace a nasazení

Tento postup předpokládá, že jste již provedli změny v souboru manifestu aplikace (.manifest). Další informace naleznete v tématu Postupy: Změna vlastností nasazení.

Poznámka:

V clickOnce pro .NET Core 3.1 a .NET 5 nebo novější použijte dotnet-mage.exe místo Mage.exe. Další informace naleznete v tématu ClickOnce pro .NET.

Opětovné podepsání manifestů aplikace a nasazení pomocí mage.exe

  1. Otevřete okno příkazového řádku sady Visual Studio.

  2. Přejděte do složky obsahující soubory manifestu, které chcete podepsat.

  3. Zadáním následujícího příkazu podepište soubor manifestu aplikace. Nahraďte ManifestFileName názvem souboru manifestu a příponou. Nahraďte certifikát relativní nebo plně kvalifikovanou cestou souboru certifikátu a nahraďte heslo heslem pro certifikát.

    mage -sign ManifestFileName.manifest -CertFile Certificate -Password Password

    Můžete například spustit následující příkaz, který podepíše manifest aplikace pro doplněk, aplikaci Windows Form nebo aplikaci prohlížeče Windows Presentation Foundation. Dočasné certifikáty vytvořené sadou Visual Studio se nedoporučují pro nasazení do produkčních prostředí.

    mage -sign WindowsFormsApplication1.exe.manifest -CertFile ..\WindowsFormsApplication1_TemporaryKey.pfx
mage -sign ExcelAddin1.dll.manifest -CertFile ..\ExcelAddIn1_TemporaryKey.pfx
mage -sign WpfBrowserApplication1.exe.manifest -CertFile ..\WpfBrowserApplication1_TemporaryKey.pfx

  4. Zadáním následujícího příkazu aktualizujte a podepište soubor manifestu nasazení a nahraďte zástupné názvy jako v předchozím kroku.

    mage -update DeploymentManifest -appmanifest ApplicationManifest -CertFile Certificate -Password Password

    Spuštěním následujícího příkazu můžete například aktualizovat a podepsat manifest nasazení pro doplněk Excelu, aplikaci model Windows Forms nebo aplikaci prohlížeče Windows Presentation Foundation.

    mage -update WindowsFormsApplication1.application -appmanifest WindowsFormsApplication1.exe.manifest -CertFile ..\WindowsFormsApplication1_TemporaryKey.pfx
mage -update ExcelAddin1.vsto -appmanifest ExcelAddin1.dll.manifest -CertFile ..\ExcelAddIn1_TemporaryKey.pfx
mage -update WpfBrowserApplication1.xbap -appmanifest WpfBrowserApplication1.exe.manifest -CertFile ..\WpfBrowserApplication1_TemporaryKey.pfx

  5. Volitelně můžete zkopírovat hlavní manifest nasazení (publish\<appname.application>) do adresáře nasazení verze (publish\Application Files\<appname>_<version>).

Aktualizace a opětovné podepsání manifestů aplikace a nasazení

Tento postup předpokládá, že jste již provedli změny v souboru manifestu aplikace (.manifest), ale existují další soubory, které byly aktualizovány. Při aktualizaci souborů musí být také aktualizována hodnota hash, která představuje soubor.

Aktualizace a opětovné podepsání manifestů aplikace a nasazení pomocí Mage.exe

  1. Otevřete okno příkazového řádku sady Visual Studio.

  2. Přejděte do složky obsahující soubory manifestu, které chcete podepsat.

  3. Odeberte příponu souboru .deploy ze souborů ve výstupní složce pro publikování.

  4. Zadáním následujícího příkazu aktualizujte manifest aplikace novými hodnotami hash pro aktualizované soubory a podepište soubor manifestu aplikace. Nahraďte ManifestFileName názvem souboru manifestu a příponou. Nahraďte certifikát relativní nebo plně kvalifikovanou cestou souboru certifikátu a nahraďte heslo heslem pro certifikát.

    mage -update ManifestFileName.manifest -CertFile Certificate -Password Password

    Můžete například spustit následující příkaz, který podepíše manifest aplikace pro doplněk, aplikaci Windows Form nebo aplikaci prohlížeče Windows Presentation Foundation. Dočasné certifikáty vytvořené sadou Visual Studio se nedoporučují pro nasazení do produkčních prostředí.

    mage -update WindowsFormsApplication1.exe.manifest -CertFile ..\WindowsFormsApplication1_TemporaryKey.pfx
mage -update ExcelAddin1.dll.manifest -CertFile ..\ExcelAddIn1_TemporaryKey.pfx
mage -update WpfBrowserApplication1.exe.manifest -CertFile ..\WpfBrowserApplication1_TemporaryKey.pfx

  5. Zadáním následujícího příkazu aktualizujte a podepište soubor manifestu nasazení a nahraďte zástupné názvy jako v předchozím kroku.

    mage -update DeploymentManifest -appmanifest ApplicationManifest -CertFile Certificate -Password Password

    Spuštěním následujícího příkazu můžete například aktualizovat a podepsat manifest nasazení pro doplněk Excelu, aplikaci model Windows Forms nebo aplikaci prohlížeče Windows Presentation Foundation.

    mage -update WindowsFormsApplication1.application -appmanifest WindowsFormsApplication1.exe.manifest -CertFile ..\WindowsFormsApplication1_TemporaryKey.pfx
mage -update ExcelAddin1.vsto -appmanifest ExcelAddin1.dll.manifest -CertFile ..\ExcelAddIn1_TemporaryKey.pfx
mage -update WpfBrowserApplication1.xbap -appmanifest WpfBrowserApplication1.exe.manifest -CertFile ..\WpfBrowserApplication1_TemporaryKey.pfx

  6. Přidejte příponu souboru .deploy zpět do souborů s výjimkou souborů manifestu aplikace a nasazení.

  7. Volitelně můžete zkopírovat hlavní manifest nasazení (publish\<appname.application>) do adresáře nasazení verze (publish\Application Files\<appname>_<version>).

Související obsah