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 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 berdampingan dan manifes perakitannya diinstal 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 menentukan aplikasi. Untuk informasi selengkapnya tentang assemblyIdentity konteks DEF, lihat Manifes Aplikasi.

4. Jika rakitan berisi rakitan dependen apa pun, masukkan nilai atribut ke dalam subelemen 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 biner yang dapat dieksekusi 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 lebih diutamakan.

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

7. Rakitan privat dapat diinstal menggunakan Penginstal Windows versi 2.0. Tulis 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 Pemasang 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>