Bagikan melalui

Menandatangani ulang manifes aplikasi dan penyebaran

  • Artikel

Setelah Anda membuat perubahan pada properti penyebaran di manifes aplikasi untuk aplikasi Formulir Windows, aplikasi Windows Presentation Foundation (xbap), atau solusi Office, Anda harus menandatangani ulang aplikasi dan manifes penyebaran dengan sertifikat. Proses ini membantu memastikan bahwa file yang diubah tidak diinstal pada komputer pengguna akhir.

Skenario lain saat Anda mungkin menandatangani ulang manifes adalah ketika pelanggan Anda ingin menandatangani aplikasi dan manifes penyebaran dengan sertifikat mereka sendiri.

Menandatangani ulang Aplikasi dan Manifes Penyebaran

Prosedur ini mengasumsikan bahwa Anda telah membuat perubahan pada file manifes aplikasi Anda (.manifest). Untuk informasi selengkapnya, lihat Cara: Mengubah properti penyebaran.

Catatan

Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, gunakan dotnet-mage.exe alih-alih Mage.exe. Untuk informasi selengkapnya, lihat ClickOnce untuk .NET.

Untuk menandatangani ulang aplikasi dan manifes penyebaran dengan Mage.exe

  1. Buka jendela Perintah Visual Studio.

  2. Ubah direktori ke folder yang berisi file manifes yang ingin Anda tanda tangani.

  3. Ketik perintah berikut untuk menandatangani file manifes aplikasi. Ganti ManifestFileName dengan nama file manifes Anda ditambah ekstensi. Ganti Sertifikat dengan jalur relatif atau sepenuhnya memenuhi syarat dari file sertifikat dan ganti Kata sandi dengan kata sandi untuk sertifikat.

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

    Misalnya, Anda dapat menjalankan perintah berikut untuk menandatangani manifes aplikasi untuk add-in, aplikasi Formulir Windows, atau aplikasi browser Windows Presentation Foundation. Sertifikat sementara yang dibuat oleh Visual Studio tidak disarankan untuk penyebaran ke lingkungan produksi.

    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. Ketik perintah berikut untuk memperbarui dan menandatangani file manifes penyebaran, mengganti nama tempat penampung seperti pada langkah sebelumnya.

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

    Misalnya, Anda dapat menjalankan perintah berikut untuk memperbarui dan menandatangani manifes penyebaran untuk add-in Excel, aplikasi Formulir Windows, atau aplikasi browser 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. Secara opsional, salin manifes penyebaran master (publish\<appname>.application) ke direktori penyebaran versi Anda (publish\Application Files\<appname>_<version>).

Memperbarui dan menandatangani ulang aplikasi dan manifes penyebaran

Prosedur ini mengasumsikan bahwa Anda telah membuat perubahan pada file manifes aplikasi Anda (.manifest), tetapi ada file lain yang diperbarui. Saat file diperbarui, hash yang mewakili file juga harus diperbarui.

Untuk memperbarui dan menandatangani ulang aplikasi dan manifes penyebaran dengan Mage.exe

  1. Buka jendela Perintah Visual Studio.

  2. Ubah direktori ke folder yang berisi file manifes yang ingin Anda tanda tangani.

  3. Hapus ekstensi file .deploy dari file di folder output penerbitan.

  4. Ketik perintah berikut untuk memperbarui manifes aplikasi dengan hash baru untuk file yang diperbarui dan menandatangani file manifes aplikasi. Ganti ManifestFileName dengan nama file manifes Anda ditambah ekstensi. Ganti Sertifikat dengan jalur relatif atau sepenuhnya memenuhi syarat dari file sertifikat dan ganti Kata sandi dengan kata sandi untuk sertifikat.

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

    Misalnya, Anda dapat menjalankan perintah berikut untuk menandatangani manifes aplikasi untuk add-in, aplikasi Formulir Windows, atau aplikasi browser Windows Presentation Foundation. Sertifikat sementara yang dibuat oleh Visual Studio tidak disarankan untuk penyebaran ke lingkungan produksi.

    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. Ketik perintah berikut untuk memperbarui dan menandatangani file manifes penyebaran, mengganti nama tempat penampung seperti pada langkah sebelumnya.

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

    Misalnya, Anda dapat menjalankan perintah berikut untuk memperbarui dan menandatangani manifes penyebaran untuk add-in Excel, aplikasi Formulir Windows, atau aplikasi browser 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. Tambahkan kembali ekstensi file .deploy ke file, kecuali file manifes aplikasi dan penyebaran.

  7. Secara opsional, salin manifes penyebaran master (publish\<appname>.application) ke direktori penyebaran versi Anda (publish\Application Files\<appname>_<version>).

Konten terkait