Flusso di lavoro di creazione del pacchetto

La creazione di un pacchetto inizia con il codice compilato (in genere assembly .NET) che si vuole creare e condividere con altri utenti, tramite la raccolta di nuget.org pubblica o una raccolta privata all'interno dell'organizzazione. Il pacchetto può includere anche file aggiuntivi, ad esempio un file leggimi visualizzato quando il pacchetto è installato e può includere trasformazioni in determinati file di progetto.

Un pacchetto può anche servire esclusivamente per integrare un numero qualsiasi di altre dipendenze, senza contenere codice proprio. Un pacchetto di questo tipo è un modo pratico per distribuire un SDK composto da più pacchetti indipendenti. In altri casi, un pacchetto può contenere solo file di simboli (.pdb) per facilitare il debug.

Annotazioni

Quando si crea un pacchetto per l'uso da parte di altri sviluppatori, è importante comprendere che stanno facendo affidamento sul tuo pacchetto. Di conseguenza, la creazione e la pubblicazione di un pacchetto implicano anche l'impegno a correggere i bug e rendere altri aggiornamenti o almeno rendere il pacchetto disponibile come open source in modo che altri possano contribuire a gestirlo.

Indipendentemente dal caso, la creazione di un pacchetto inizia con la decisione del relativo identificatore, numero di versione, licenza, informazioni sul copyright e qualsiasi altro contenuto necessario. Al termine, è possibile usare il comando "pack" per mettere tutto insieme in un .nupkg file. 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, modificare l'estensione .zip in ed espanderne il contenuto come di consueto. Assicurarsi di modificare nuovamente l'estensione in .nupkg prima di tentare di caricarla in un host.

Per apprendere e comprendere il processo di creazione, iniziare con Creazione di un pacchetto che illustra i processi principali comuni a tutti i pacchetti.

Da qui, è possibile prendere in considerazione una serie di altre opzioni per il pacchetto:

• Supporto di più framework di destinazione descrive come creare un pacchetto con più varianti per diversi framework .NET.
• Creazione di pacchetti localizzati descrive come strutturare un pacchetto con più risorse di lingua e come usare pacchetti satellite localizzati separati.
• Pacchetti non definitive illustra come rilasciare pacchetti alfa, beta e rc per i clienti interessati.
• Le trasformazioni di file di origine e di configurazione descrivono come sia possibile effettuare sostituzioni unidirezionali dei token nei file aggiunti a un progetto e modificare web.config e app.config con le impostazioni che vengono ripristinate quando il pacchetto viene disinstallato.
• I pacchetti di simboli offrono indicazioni per fornire simboli alla vostra libreria, consentendo agli utenti di entrare nel vostro codice durante il debug.
• Il controllo delle versioni dei pacchetti illustra come identificare le versioni esatte consentite per le dipendenze (altri pacchetti utilizzati dal pacchetto).
• I pacchetti nativi descrivono il processo di creazione di un pacchetto per i consumer C++.
• Pacchetti di firma descrive il processo di aggiunta di una firma digitale a un pacchetto.

Quando si è pronti per pubblicare un pacchetto in nuget.org, seguire la procedura semplice in Pubblicare un pacchetto.

Se si vuole usare un feed privato invece di nuget.org, vedere Panoramica dei pacchetti di hosting