Perancang Manifes VSIX

  • Artikel

Memodifikasi file manifes paket VSIX, yang mengatur perilaku penginstalan untuk ekstensi Visual Studio.

Perancang Manifes VSIX memetakan ke skema VSIX yang mendasar. Setiap elemen dalam skema dapat diatur dengan menggunakan kontrol yang sesuai di perancang. Untuk informasi selengkapnya tentang skema, lihat Referensi Skema Ekstensi VSIX 2.0.

Untuk membuka VSIX Manifest Designer, temukan file source.extension.vsixmanifest di Penjelajah Solusi, dan buka file. Jika file tidak berisi XML yang valid, perancang manifes tidak akan terbuka.

Catatan

File source.extension.vsixmanifest adalah output ke extension.vsixmanifest saat paket dibuat.

Daftar UIElement

Perancang Manifes VSIX berisi empat bagian yang sesuai dengan elemen tingkat atas skema ini:

  • Metadata
  • Pasang Target
  • Aset
  • Dependensi

Area judul berisi kontrol berikut:

  • Nama Produk menjelaskan nama ekstensi.
  • ID produk menentukan informasi identifikasi unik untuk paket ini.
  • Penulis menentukan nama penulis ekstensi.
  • Versi menentukan nomor versi ekstensi.

Tab Metadata berisi kontrol berikut:

  • Deskripsi menyediakan deskripsi teks ekstensi, yang akan ditampilkan di Pengelola Ekstensi.
  • Bahasa menentukan bahasa default untuk paket, yang sesuai dengan data tekstual dalam manifes. Atribut Language ini mengikuti konvensi kode lokal runtime bahasa umum (CLR) untuk rakitan sumber daya, misalnya, en-us, en, fr-fr. Secara default, nilainya netral, yang berarti paket akan berjalan pada versi bahasa Visual Studio apa pun.
  • Lisensi menentukan file teks yang berisi lisensi pengguna, jika ada.
  • Ikon menentukan file grafis (.png, .bmp, .jpeg, .ico) yang berisi ikon yang akan ditampilkan di Extension Manager, jika ikon ada. Gambar ikon harus 32x32 piksel atau diubah ukurannya menjadi dimensi tersebut. Jika tidak ada ikon yang ditentukan, Extension Manager menggunakan ikon default.
  • Gambar pratinjau menentukan file grafis (.png, .bmp, .jpeg, .ico) yang berisi gambar pratinjau yang akan ditampilkan di Extension Manager, jika gambar pratinjau ada. Gambar pratinjau harus 200x200 piksel. Jika tidak ada gambar pratinjau yang ditentukan, Extension Manager menggunakan gambar default.
  • Tag menambahkan tag teks yang akan digunakan untuk petunjuk pencarian.
  • Catatan Rilis menentukan file (.txt, .rtf) yang berisi catatan rilis. Juga mengambil URL situs web yang menampilkan catatan rilis.
  • Panduan Memulai menentukan file (.txt, .rtf) yang berisi informasi tentang cara menggunakan ekstensi atau konten dalam paket VSIX. Panduan ini muncul ketika penginstalan ekstensi selesai. Juga mengambil URL situs web yang menampilkan panduan.
  • URL Info Selengkapnya menentukan URL situs web yang berisi informasi tambahan tentang produk.

Tab Pasang Target berisi kontrol berikut ini:

  • Jenis penginstalan mencantumkan Ekstensi Visual Studio dan Ekstensi SDK sebagai jenis penginstalan target. Opsi berbeda, tergantung pada jenis yang Anda pilih.

    • Ekstensi Visual Studio mencantumkan elemen InstallationTarget yang menjelaskan bagaimana paket dapat diinstal dan ke dalam produk Visual Studio mana ekstensi ini dapat diinstal. Setiap produk diidentifikasi secara terpisah berdasarkan nama dan rentang versi atau versi. Produk dapat ditambahkan ke daftar, dimodifikasi, dan dihapus. Nama dan versi produk sesuai dengan atribut Id dan Versi dari elemen InstallationTarget terkait.

      • Rentang Versi adalah [12.0, 14.0] dan menggunakan notasi berikut:
        • [ - versi minimum inklusif
        • ] - versi maksimum inklusif
        • ( - versi minimum eksklusif
        • ) - versi maksimum eksklusif
        • Versi tunggal # - hanya versi yang ditentukan

    • Extension SDK menentukan penginstalan global yang tidak terlingkup ke produk dan versi tertentu. Pengidentifikasi Platform Target adalah platform, seperti "Windows", yang Anda targetkan. Versi Platform Target adalah versi, seperti 8.0, dari platform target Anda. Nama SDK dan Versi SDK adalah nama dan nomor versi SDK.

  • VSIX ini diinstal untuk semua pengguna (memerlukan elevasi saat diinstal). Jika Anda memilih kotak centang ini, ekstensi diinstal untuk semua pengguna; jika tidak, itu hanya diinstal untuk pengguna saat ini.

  • VSIX ini diinstal oleh Penginstal Windows. Jika Anda memilih kotak centang ini, ekstensi diinstal oleh Penginstal Windows (file.msi ); jika tidak, ekstensi diinstal sebagai paket VSIX biasa (file.vsix ).

Tab Aset berisi kontrol berikut:

  • Daftar aset mencantumkan elemen Aset yang menjelaskan elemen ekstensi atau konten yang dimunculkan paket ini. Setiap ekstensi atau elemen konten dicantumkan secara terpisah menurut sumber, jenis, dan jalur. Ekstensi dan elemen konten dapat ditambahkan ke daftar, dimodifikasi, dan dihapus. Jenis dan jalur ekstensi atau elemen konten sesuai dengan Type atribut dan Path elemen terkait Asset . Jenis berikut ini diketahui:

    • Microsoft.VisualStudio.Package
    • Microsoft.VisualStudio.MefComponent
    • Microsoft.VisualStudio.ToolboxControl
    • Microsoft.VisualStudio.Samples
    • Microsoft.VisualStudio.ProjectTemplate
    • Microsoft.VisualStudio.ItemTemplate
    • Microsoft.VisualStudio.Assembly
    • Microsoft.ExtensionSDK

    Untuk menambahkan atau mengedit aset, Anda harus menentukan jenis aset, apakah aset adalah proyek dalam solusi saat ini atau file dalam sistem file, dan nama proyek. Anda juga dapat menentukan nama folder yang akan disematkan.

    Anda juga dapat membuat jenis Anda sendiri dan memberinya nama unik.

Tab Dependensi berisi kontrol berikut:

  • Rentang Nama, Sumber, dan Versi mencantumkan elemen Dependensi dari paket ini, yang merupakan paket lain yang bergantung pada paket ini. Jika paket dependensi ditentukan, paket harus diinstal sebelum paket ini diinstal; jika tidak, paket ini harus menginstalnya.

    Paket dependensi ditentukan oleh pengidentifikasi, nama, rentang versi, sumber, dan bagaimana dependensi akan diselesaikan. Setiap paket dependensi dicantumkan secara terpisah berdasarkan nama, versi, dan sumber. Paket dependensi dapat ditambahkan ke daftar, dimodifikasi, dan dihapus.

    Pengidentifikasi harus cocok dengan ID atribut metadata paket dependensi. Sumber dapat menjadi proyek dalam solusi saat ini, ekstensi yang saat ini diinstal, atau file. Pengaturan Bagaimana dependensi diselesaikan dapat menjadi jalur relatif dari paket berlapis atau URL lokasi unduhan untuk dependensi. ID, versi, dan resolusi paket dependensi sesuai dengan Idatribut , Version, dan Location elemen terkait Dependency .

Baca juga