Nasıl yapılır: uygulama ve dağıtım bildirimleri yeniden imzalamaya

Makale
02/25/2013

Windows Forms uygulamaları, Windows Presentation Foundation uygulamaları (xbap) veya Office çözümleri için dağıtım özelliklerinde değişiklikler yaptıktan sonra uygulama ve dağıtım bildirimlerini bir sertifika ile yeniden imzalamanız gerekir. Bu işlem, son kullanıcı bilgisayarları üzerinde değiştirilen dosyaların yüklenmediğini garanti eder.

Bildirimleri yeniden imzalayabileceğiniz başka bir senaryo da, uygulama ve dağıtım bildirimlerini müşterilerinizin kendilerine ait bir sertifika ile imzalamak istedikleri durumdur.

Uygulama ve Dağıtım Bildirimlerini Yeniden İmzalama.

Bu yordam, uygulama bildirimi dosyanızda (.manifest) önceden değişiklikler yaptığınızı varsayar. Daha fazla bilgi için bkz. Nasıl yapılır: dağıtım özelliklerini değiştirme.

Uygulama ve dağıtım bildirimlerini Mage.exe ile yeniden imzalamak için

Visual Studio Komut İstemi penceresi açın.
Dizinleri imzalamak istediğiniz bildirim dosyalarını içeren klasör olarak değiştirin.
Bildirim dosyasını imzalamak için aşağıdaki komutu yazın. ManifestFileName'i bildirim dosyasının adı ve uzantısı ile değiştirin. Sertifikayı göreli veya tümüyle belirtilmiş sertifika dosyası yolu ile değiştirin. Ardından Password'ü sertifika parolası ile değiştirin.
```
mage -sign ManifestFileName.manifest -CertFile Certificate -Password Password
```
Örneğin, bir eklentiye, Windows Form uygulamasına veya Windows Presentation Foundation gözatma uygulamasına ait bir uygulama bildirimi imzalamak için aşağıdaki komutu çalıştırabilirsiniz. Visual Studio tarafından oluşturulan geçici sertifikaların, üretim ortamları içine dağıtımı önerilmez.
```
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
```

Dağıtım bildirimi dosyasını güncelleştirmek ve imzalamak için önceki adımdaki gibi yer tutucu isimlerini değiştirerek aşağıdaki komutu yazın.

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

Örneğin, bir Excel eklentisine, Windows Forms uygulamasına veya Windows Presentation Foundation gözatma uygulamasına ait dağıtım bildirimini güncelleştirmek ve imzalamak için aşağıdaki komutu çalıştırabilirsiniz.

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

İsteğe bağlı olarak, ana dağıtım listesi kopyalama (publish\UygAdı.application) sürümünün dağıtımı dizininize (publish\Application Files\UygAdı_sürüm).

Uygulama ve Dağıtım Bildirimlerini Yeniden İmzalama

Bu yordam, uygulama bildirimi dosyasında (.manifest) değişiklikleri önceden yaptığınızı, ama güncelleştirilen dosyaların da bulunduğunu varsayar. Dosyalar güncelleştirildiğinde, dosyayı gösteren karma da güncelleştirilmelidir.

Uygulama ve dağıtım bildirimlerini Mage.exe ile güncelleştirmek ve yeniden imzalamak için

Visual Studio Komut İstemi penceresi açın.
Dizinleri imzalamak istediğiniz bildirim dosyalarını içeren klasör olarak değiştirin.
Yayımla çıktı klasöründeki dosyalardan .deploy dosya uzantısını kaldırın.
Güncelleştirilmiş dosyalara ait yeni karmalar ile uygulama bildirimini güncellemek için aşağıdaki komutu yazın ve uygulama bildirimi dosyasını imzalayın. ManifestFileName'i bildirim dosyasının adı ve uzantısı ile değiştirin. Sertifikayı göreli veya tümüyle belirtilmiş sertifika dosyası yolu ile değiştirin. Ardından Password'ü sertifika parolası ile değiştirin.
```
mage -update ManifestFileName.manifest -CertFile Certificate -Password Password
```
Örneğin, bir eklentiye, Windows Form uygulamasına veya Windows Presentation Foundation gözatma uygulamasına ait bir uygulama bildirimi imzalamak için aşağıdaki komutu çalıştırabilirsiniz. Visual Studio tarafından oluşturulan geçici sertifikaların, üretim ortamları içine dağıtımı önerilmez.
```
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
```

Dağıtım bildirimi dosyasını güncelleştirmek ve imzalamak için önceki adımdaki gibi yer tutucu isimlerini değiştirerek aşağıdaki komutu yazın.

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

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

.deploy dosya uzantısını uygulama ve dağıtım bildirimi dışındaki dosyalara tekrar ekleyin.
İsteğe bağlı olarak, ana dağıtım listesi kopyalama (publish\UygAdı.application) sürümünün dağıtımı dizininize (publish\Application Files\UygAdı_sürüm).