Menggunakan Rakitan Berdampingan

Gunakan prosedur berikut untuk mengembangkan aplikasi baru, atau memperbarui aplikasi yang sudah ada, agar dapat menggunakan assembly berdampingan yang tersedia dari Microsoft atau penerbit assembly berdampingan lainnya. Untuk daftar rakitan berdampingan yang saat ini disediakan oleh Microsoft, lihat Rakitan Berdampingan yang Didukung oleh Microsoft. Perhatikan bahwa aplikasi harus dijalankan setidaknya pada Windows XP untuk menginstal rakitan sebagai rakitan berdampingan. Untuk informasi selengkapnya, lihat Panduan untuk Membuat Rakitan Berdampingan.

Untuk menambahkan rakitan berdampingan ke aplikasi

1. Identifikasi rakitan berdampingan yang diperlukan aplikasi Anda. Dimulai dengan Windows XP, rakitan-rakitan berdampingan ini dan manifes-manifes perakitannya dipasang dengan sistem operasi tetapi tidak terdaftar secara global.

2. Gunakan editor XML untuk membuat manifes aplikasi . Lihat contoh manifes aplikasi di bawah ini. Untuk informasi selengkapnya, lihat Manifes Aplikasi di Referensi File Manifes .

3. Masukkan nilai atribut dalam rakitan konteks DEF subelemen manifes aplikasi yang secara unik mendefinisikan aplikasi. Untuk informasi selengkapnya tentang DEF-konteks assemblyIdentity, lihat Application Manifests.

4. Jika rakitan berisi rakitan dependen apa pun, masukkan nilai atribut ke dalam rakitan konteks REF yang sesuai subelemen manifes aplikasi. Untuk informasi lebih lanjut tentang konteks REF assemblyIdentity, silakan lihat Application Manifests.

   <dependentAssembly>
     <assemblyIdentity type="win32"
                       name="Microsoft.Windows.SampleAssembly"
                       version="6.0.0.0" processorArchitecture="x86"
                       publicKeyToken="a5aaf5ba15723d5"/>
   

5. Anda dapat menyertakan manifes aplikasi dalam file header yang dapat dieksekusi biner aplikasi.

   Dalam hal ini, tambahkan juga baris berikut ke file header aplikasi:

   CREATEPROCESS\_MANIFEST\_RESOURCE\_ID RT\_MANIFEST "YourApp.exe.manifest"

   Sebagai alternatif, Anda dapat menempatkan file manifes terpisah di direktori yang sama dengan file yang dapat dieksekusi aplikasi Anda. Sistem operasi memuat manifes dari sistem file terlebih dahulu, lalu memeriksa bagian sumber daya dari executable. Versi sistem file memiliki prioritas.

6. rakitan bersama harus diinstal menggunakan Windows Installer versi 2.0. Menulis paket Penginstal Windows seperti yang dijelaskan dalam Bagaimana Cara Menginstal Rakitan Win32 untuk Berbagi Berdampingan di Windows XP?.

7. rakitan pribadi dapat diinstal menggunakan Windows Installer versi 2.0. Menulis paket Penginstal Windows seperti yang dijelaskan dalam Bagaimana Cara Menginstal Rakitan Win32 untuk Penggunaan Privat Aplikasi di Windows XP?. Anda juga dapat menggunakan alat penginstal lain untuk menyalin rakitan privat dan manifesnya ke folder yang sama dengan file yang dapat dieksekusi aplikasi.

8. Uji aplikasi Anda untuk memastikan hasilnya. Perhatikan bahwa komputer pengujian Anda tidak boleh mendaftarkan rakitan berdampingan.

9. Sebarkan aplikasi Anda atau perbarui sebagai paket Penginstal Windows.

Contoh Manifes Aplikasi

Berikut ini adalah contoh manifes aplikasi:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity type="win32" name="Microsoft.Windows.mysampleapp" version="1.0.0.0" processorArchitecture="x86"/>
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" name="Microsoft.Windows.SampleAssembly" version="6.0.0.0" processorArchitecture="x86" publicKeyToken="a5aaf5ba15723d5"/>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly>
      <assemblyIdentity type="win32" name="Microsoft.Tools.MyPrivateDll" version="2.5.0.0" processorArchitecture="x86"/>
    </dependentAssembly>
  </dependency>
</assembly>