Menggunakan Rakitan Berdampingan

Gunakan prosedur berikut untuk mengembangkan aplikasi baru, atau memperbarui aplikasi yang ada, untuk menggunakan rakitan berdampingan yang tersedia dari Microsoft atau penerbit rakitan berdampingan lainnya. Untuk daftar rakitan berdampingan yang saat ini disediakan oleh Microsoft, lihat Rakitan Berdampingan Microsoft yang didukung. Perhatikan bahwa aplikasi harus dijalankan setidaknya 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 berdampingan ini dan 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 subelemen assemblyIdentity konteks DEF dari manifes aplikasi yang secara unik mendefinisikan aplikasi. Untuk informasi selengkapnya tentang assemblyIdentity konteks DEF, lihat Manifes Aplikasi.

4. Jika rakitan berisi rakitan dependen apa pun, masukkan nilai atribut ke dalam sublemen assemblyIdentity konteks REF yang sesuai dari manifes aplikasi. Untuk informasi selengkapnya tentang assemblyIdentity konteks REF, lihat Manifes Aplikasi.

   <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 aplikasi yang dapat dieksekusi biner.

   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 lebih diutamakan.

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

7. Rakitan privat dapat diinstal menggunakan Windows Installer versi 2.0. Tulis paket Windows Installer 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 memiliki assembly berdampingan yang terdaftar.

9. Sebarkan aplikasi atau pembaruan Anda sebagai paket alat 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>