Mendistribusikan Komponen Runtime Windows terkelola

Anda dapat mendistribusikan Komponen runtime Windows anda dengan salinan file. Namun, jika komponen Anda terdiri dari banyak file, penginstalan bisa melelahkan bagi pengguna Anda. Selain itu, kesalahan dalam menempatkan file atau kegagalan untuk mengatur referensi dapat menyebabkan masalah bagi mereka. Anda dapat mengemas komponen kompleks sebagai SDK ekstensi Visual Studio, untuk memudahkan penginstalan dan penggunaan. Pengguna hanya perlu mengatur satu referensi untuk seluruh paket. Mereka dapat dengan mudah menemukan dan menginstal komponen Anda dengan menggunakan kotak dialog Ekstensi dan Pembaruan, seperti yang dijelaskan dalam Menemukan dan Menggunakan Ekstensi Visual Studio.

Merencanakan Komponen Runtime Windows yang dapat didistribusikan

Pilih nama unik untuk file biner, seperti file .winmd Anda. Kami merekomendasikan format berikut untuk memastikan keunikan:

company.product.purpose.extension
For example: Microsoft.Cpp.Build.dll

File biner Anda akan diinstal dalam paket aplikasi, mungkin dengan file biner dari pengembang lain. Lihat "SDK Ekstensi" di Membuat Kit Pengembangan Perangkat Lunak.

Untuk memutuskan cara mendistribusikan komponen Anda, pertimbangkan betapa kompleksnya komponen tersebut. Ekstensi SDK atau manajer paket serupa disarankan saat:

  • Komponen Anda terdiri dari beberapa file.
  • Anda menyediakan versi komponen untuk beberapa platform (x86 dan Arm, misalnya).
  • Anda menyediakan versi debug dan rilis komponen Anda.
  • Komponen Anda memiliki file dan rakitan yang hanya digunakan pada waktu desain.

SDK ekstensi sangat berguna jika lebih dari salah satu hal di atas benar.

Catatan Untuk komponen yang kompleks, sistem manajemen paket NuGet menawarkan alternatif sumber terbuka untuk SDK ekstensi. Seperti SDK ekstensi, NuGet memungkinkan Anda membuat paket yang menyederhanakan penginstalan komponen kompleks. Untuk perbandingan paket NuGet dan SDK ekstensi Visual Studio, lihat Menambahkan Referensi Menggunakan NuGet Versus SDK Ekstensi.

Distribusi berdasarkan salinan file

Jika komponen Anda terdiri dari satu file .winmd, atau file .winmd dan file indeks sumber daya (.pri), Anda cukup membuat file .winmd tersedia bagi pengguna untuk disalin. Pengguna dapat meletakkan file di mana pun mereka inginkan dalam proyek, gunakan kotak dialog Tambahkan Item yang Ada untuk menambahkan file .winmd ke proyek, lalu gunakan kotak dialog Manajer Referensi untuk membuat referensi. Jika Anda menyertakan file .pri atau file .xml, instruksikan pengguna untuk menempatkan file tersebut dengan file .winmd.

Perhatikan Visual Studio selalu menghasilkan file .pri saat Anda membangun Komponen Runtime Windows, meskipun proyek Anda tidak menyertakan sumber daya apa pun. Jika Anda memiliki aplikasi pengujian untuk komponen, Anda dapat menentukan apakah file .pri digunakan dengan memeriksa konten paket aplikasi di folder bin\debug\AppX. Jika file .pri dari komponen Anda tidak muncul di sana, Anda tidak perlu mendistribusikannya. Atau, Anda dapat menggunakan alat MakePRI.exe untuk mencadangkan file sumber daya dari proyek Komponen Runtime Windows Anda. Misalnya, di jendela Visual Studio Command Prompt, ketik: makepri dump /if MyComponent.pri /of MyComponent.pri.xml Anda dapat membaca selengkapnya tentang file .pri di Sistem Manajemen Sumber Daya (Windows).

Distribusi berdasarkan SDK ekstensi

Komponen kompleks biasanya mencakup Windows sumber daya, tetapi lihat catatan tentang mendeteksi file .pri kosong di bagian sebelumnya.

Untuk membuat SDK ekstensi

  1. Pastikan Anda telah menginstal SDK Visual Studio. Anda dapat mengunduh SDK Visual Studio dari halaman Unduhan Visual Studio.

  2. Buat proyek baru menggunakan templat Project VSIX. Anda dapat menemukan templat di bawah Visual C# atau Visual Basic, dalam kategori Ekstensibilitas. Templat ini diinstal sebagai bagian dari SDK Visual Studio. (Panduan: Membuat SDK menggunakan C# atau Visual Basic atau Panduan: Membuat SDK menggunakan C++, menunjukkan penggunaan templat ini dalam skenario yang sangat sederhana. )

  3. Tentukan struktur folder untuk SDK Anda. Struktur folder dimulai pada tingkat akar proyek VSIX Anda, dengan folder Referensi, Redist, dan DesignTime .

    • Referensi adalah lokasi untuk file biner yang dapat diprogram pengguna Anda. SDK ekstensi membuat referensi ke file-file ini di proyek Visual Studio pengguna Anda.
    • Redist adalah lokasi untuk file lain yang harus didistribusikan dengan file biner Anda, di aplikasi yang dibuat dengan menggunakan komponen Anda.
    • DesignTime adalah lokasi untuk file yang hanya digunakan saat pengembang membuat aplikasi yang menggunakan komponen Anda.

    Di setiap folder ini, Anda dapat membuat folder konfigurasi. Nama yang diizinkan adalah debug, ritel, dan CommonConfiguration. Folder CommonConfiguration adalah untuk file yang sama apakah digunakan oleh build ritel atau debug. Jika Anda hanya mendistribusikan build ritel komponen, Anda dapat meletakkan semuanya di CommonConfiguration dan menghilangkan dua folder lainnya.

    Di setiap folder konfigurasi, Anda dapat menyediakan folder arsitektur untuk file khusus platform. Jika Anda menggunakan file yang sama untuk semua platform, Anda dapat menyediakan satu folder bernama netral. Anda dapat menemukan detail struktur folder, termasuk nama folder arsitektur lainnya, di Buat Kit Pengembangan Perangkat Lunak. (Artikel itu membahas SDK platform dan SDK ekstensi. Anda mungkin merasa berguna untuk menciutkan bagian tentang SDK platform, untuk menghindari kebingungan. )

  4. Buat file manifes SDK. Manifes menentukan informasi nama dan versi, arsitektur yang didukung SDK Anda, versi .NET, dan informasi lain tentang cara Visual Studio menggunakan SDK Anda. Anda dapat menemukan detail dan contoh dalam Membuat Kit Pengembangan Perangkat Lunak.

  5. Membangun dan mendistribusikan SDK ekstensi. Untuk informasi mendalam, termasuk melokalisasi dan menandatangani paket VSIX, lihat Pengiriman Visual Studio Ekstensi.