Alur kerja pembuatan paket
Membuat paket dimulai dengan kode yang dikompilasi (biasanya rakitan .NET) yang ingin Anda kemas dan bagikan dengan orang lain, baik melalui galeri nuget.org publik atau galeri privat dalam organisasi Anda. Paket ini juga dapat menyertakan file tambahan seperti readme yang ditampilkan saat paket diinstal, dan dapat menyertakan transformasi ke file proyek tertentu.
Paket juga dapat berfungsi untuk hanya menarik sejumlah dependensi lain, tanpa berisi kodenya sendiri. Paket semacam itu adalah cara mudah untuk mengirimkan SDK yang terdiri dari beberapa paket independen. Dalam kasus lain, paket mungkin hanya berisi file simbol (.pdb
) untuk membantu penelusuran kesalahan.
Catatan
Saat Anda membuat paket untuk digunakan oleh pengembang lain, penting untuk dipahami bahwa mereka mengambil dependensi pada pekerjaan Anda. Dengan demikian, membuat dan menerbitkan paket juga menyiratkan komitmen untuk memperbaiki bug dan membuat pembaruan lain, atau setidaknya membuat paket tersedia sebagai sumber terbuka sehingga orang lain dapat membantu mempertahankannya.
Apa pun masalahnya, membuat paket dimulai dengan memutuskan pengidentifikasi, nomor versi, lisensi, informasi hak cipta, dan konten lain yang diperlukan. Setelah selesai, Anda dapat menggunakan perintah "pack" untuk menggabungkan semuanya ke dalam .nupkg
file. File ini dapat diterbitkan ke umpan NuGet, seperti nuget.org.
Tip
Paket NuGet dengan .nupkg
ekstensi hanyalah file ZIP. Untuk memeriksa konten paket apa pun dengan mudah, ubah ekstensi menjadi .zip
dan perluas kontennya seperti biasa. Pastikan untuk mengubah ekstensi kembali ke .nupkg
sebelum mencoba mengunggahnya ke host.
Untuk mempelajari dan memahami proses pembuatan, mulailah dengan Membuat paket yang memandu Anda melalui proses inti yang umum untuk semua paket.
Dari sana, Anda dapat mempertimbangkan sejumlah opsi lain untuk paket Anda:
- Mendukung Beberapa Kerangka Kerja Target menjelaskan cara membuat paket dengan beberapa varian untuk .NET Frameworks yang berbeda.
- Membuat Paket Yang Dilokalkan menjelaskan cara menyusun paket dengan beberapa sumber daya bahasa dan cara menggunakan paket satelit yang dilokalkan terpisah.
- Paket pra-rilis menunjukkan cara merilis paket alfa, beta, dan rc kepada pelanggan yang tertarik.
- Transformasi File Sumber dan Konfigurasi menjelaskan bagaimana Anda dapat melakukan penggantian token satu arah dalam file yang ditambahkan ke proyek, dan memodifikasi
web.config
danapp.config
dengan pengaturan yang juga didukung saat paket dihapus instalasinya. - Paket Simbol menawarkan panduan untuk menyediakan simbol untuk pustaka Anda yang memungkinkan konsumen melangkah ke kode Anda saat penelusuran kesalahan.
- Penerapan versi paket membahas cara mengidentifikasi versi yang tepat yang Anda izinkan untuk dependensi Anda (paket lain yang Anda gunakan dari paket Anda).
- Paket Asli menjelaskan proses pembuatan paket untuk konsumen C++.
- Paket Penandatanganan menjelaskan proses untuk menambahkan tanda tangan digital ke paket.
Ketika Anda kemudian siap untuk menerbitkan paket ke nuget.org, ikuti proses sederhana dalam Menerbitkan paket.
Jika Anda ingin menggunakan umpan privat alih-alih nuget.org, lihat Gambaran Umum Paket Hosting