Flusso di lavoro della creazione di pacchetti
La creazione di un pacchetto ha inizio con la scelta del codice compilato (in genere assembly .NET) che si intende inserire in un pacchetto e condividere con altri utenti, tramite la raccolta nuget.org pubblica o una raccolta privata all'interno dell'organizzazione. Il pacchetto può includere anche file aggiuntivi, ad esempio un file Leggimi da visualizzare quando viene installato il pacchetto, e può includere trasformazioni per determinati file di progetto.
Un pacchetto può essere usato anche solo per eseguire il pull di un numero qualsiasi di altre dipendenze, senza contenere codice proprio. Un pacchetto di questo tipo costituisce una soluzione efficiente per fornire un SDK costituito da più pacchetti indipendenti. In altri casi, un pacchetto può contenere solo file di simboli (con estensione .pdb) per supportare il debug.
Nota
Quando si crea un pacchetto per l'uso da parte di altri sviluppatori, è importante comprendere che si crea anche una dipendenza dal proprio lavoro. In quanto tale, la creazione e la pubblicazione di un pacchetto implica anche un impegno a correggere bug e rilasciare altri aggiornamenti o per lo meno a rendere disponibile il pacchetto come open source in modo che altri utenti possano contribuire alla gestione.
Qualunque sia il caso, la creazione di un pacchetto inizia con la scelta di identificatore, numero di versione, licenza, informazioni sul copyright e altri contenuti necessari. È poi possibile usare il comando "pack" per riunire tutti gli elementi in un file .nupkg. Questo file può essere pubblicato in un feed NuGet, ad esempio nuget.org.
Suggerimento
Un pacchetto NuGet con l'estensione .nupkg è semplicemente un file ZIP. Per esaminare facilmente il contenuto di qualsiasi pacchetto, modificarne l'estensione in .zip ed espanderne normalmente il contenuto. Assicurarsi di modificare nuovamente l'estensione in .nupkg prima di tentare di caricarlo in un host.
Per saperne di più sul processo di creazione, iniziare dall'articolo Creazione di un pacchetto, che illustra i processi di base comuni a tutti i pacchetti.
Per continuare, sono disponibili diverse altre opzioni per i pacchetti:
- Supporto di più framework di destinazione descrive come creare un pacchetto con più varianti per diverse versioni di .NET Framework.
- Creazione di pacchetti localizzati descrive come strutturare un pacchetto con più risorse di lingua e come usare pacchetti satellite localizzati distinti.
- Pacchetti in versione non definitiva illustra come rilasciare pacchetti versione alfa, beta e rc ai clienti interessati.
- Trasformazioni di codice sorgente e file di configurazione descrive come eseguire sostituzioni di token unidirezionali nei file che vengono aggiunti a un progetto e modificare
web.configeapp.configcon impostazioni che vengono escluse quando si disinstalla il pacchetto. - Pacchetti di simboli offre le informazioni necessarie per fornire simboli per la libreria che consentono ai consumer di eseguire l'istruzione nel codice durante il debug.
- Controllo delle versioni dei pacchetti illustra come identificare le versioni esatte consentite per le dipendenze (altri pacchetti utilizzati dal pacchetto).
- Pacchetti nativi descrive il processo di creazione di un pacchetto per i consumer C++.
- Firma dei pacchetti descrive il processo per l'aggiunta di una firma digitale a un pacchetto.
Quando si è pronti per pubblicare un pacchetto su nuget.org, seguire la semplice procedura riportata in Pubblicare un pacchetto.
Se si intende usare un feed privato invece di nuget.org, vedere Panoramica dell'hosting dei pacchetti.