Membangun paket pra-rilis

Setiap kali Anda merilis paket yang diperbarui dengan nomor versi baru, NuGet menganggap bahwa paket tersebut sebagai "rilis stabil terbaru" seperti yang ditunjukkan, misalnya di antarmuka pengguna Manajer Paket dalam Visual Studio:

Package Manager UI showing the latest stable release

Rilis yang stabil adalah rilis yang dianggap cukup dapat diandalkan untuk digunakan dalam produksi. Rilis stabil terbaru juga merupakan rilis yang akan diinstal sebagai pembaruan paket atau selama pemulihan paket (tunduk pada batasan seperti yang dijelaskan dalam Menginstal ulang dan memperbarui paket).

Untuk mendukung siklus hidup rilis perangkat lunak, NuGet 1.6 dan yang lebih baru memungkinkan distribusi paket pra-rilis, di mana nomor versi menyertakan akhiran penerapan versi semantik seperti -alpha, , -betaatau -rc. Untuk informasi selengkapnya lihat Penerapan versi paket.

Anda dapat menentukan versi tersebut menggunakan salah satu cara berikut:

  • Jika proyek Anda menggunakan PackageReference: sertakan akhiran versi semantik dalam .csproj elemen file PackageVersion :

    <PropertyGroup>
        <PackageVersion>1.0.1-alpha</PackageVersion>
    </PropertyGroup>
    
  • Jika proyek Anda memiliki packages.config file: sertakan akhiran versi semantik dalam .nuspec elemen file version :

    <version>1.0.1-alpha</version>
    

Ketika Anda siap untuk merilis versi stabil, cukup hapus akhiran dan paket lebih diutamakan daripada versi pra-rilis apa pun. Sekali lagi, lihat Penerapan versi paket.

Menginstal dan memperbarui paket pra-rilis

Secara default, NuGet tidak menyertakan versi pra-rilis saat bekerja dengan paket, tetapi Anda dapat mengubah perilaku ini sebagai berikut:

  • UI Pengelola Paket di Visual Studio: Di UI Kelola Paket NuGet, centang kotak Sertakan prarilis:

    The Include prerelease checkbox in Visual Studio

    Mengatur atau menghapus kotak ini akan menyegarkan UI Manajer Paket dan daftar versi yang tersedia yang dapat Anda instal.

  • Konsol Manajer Paket: Gunakan sakelar -IncludePrerelease dengan Find-Packageperintah , , Get-PackageInstall-Package, Sync-Package, dan Update-Package . Lihat Referensi PowerShell.

  • NuGet CLI: Gunakan sakelar -prerelease dengan installperintah , , updatedelete, dan mirror . Lihat referensi NuGet CLI

Penerapan versi semantik

Konvensi Penerapan Versi Semantik atau SemVer menjelaskan cara menggunakan string dalam nomor versi untuk menyampaikan arti kode yang mendasar. Pelajari selengkapnya tentang dasar-dasar penerapan versi paket.