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:

UI Manajer Paket memperlihatkan rilis stabil terbaru

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 Penentuan 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 merilis versi stabil, cukup dengan menghapus akhiran, dan paket tersebut akan lebih diprioritaskan dibandingkan versi pra-rilis mana 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 :

    Kotak centang Sertakan prarilis di 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 perintah Find-Package, Get-Package, Install-Package, Sync-Package, dan Update-Package. Lihat Referensi PowerShell.

  • NuGet CLI: Gunakan sakelar -prerelease dengan perintah install, update, delete, dan mirror. Rujuklah pada dokumen referensi NuGet CLI

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.