Mendistribusikan Komponen Windows Runtime terkelola

  • Artikel

Anda dapat mendistribusikan Komponen Windows Runtime 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 Updates, seperti yang dijelaskan dalam Menemukan dan Menggunakan Ekstensi Visual Studio.

Merencanakan Komponen Windows Runtime 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.

Catatan 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 Windows Runtime Anda. Misalnya, di jendela Prompt Perintah Visual Studio, ketik: makepri dump /if MyComponent.pri /of MyComponent.pri.xml Anda dapat membaca selengkapnya tentang file .pri di Resource Management System (Windows).

Distribusi berdasarkan SDK ekstensi

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

Untuk membuat SDK ekstensi

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

  2. Buat proyek baru menggunakan templat Proyek VSIX. Anda dapat menemukan templat di bawah Visual C# atau Visual Basic, dalam kategori Ekstensibilitas. Templat ini diinstal sebagai bagian dari Visual Studio SDK. (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 lainnya 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 Ekstensi Visual Studio.