Udostępnij za pośrednictwem


Przepływ pracy tworzenia pakietów

Tworzenie pakietu rozpoczyna się od skompilowanego kodu (zazwyczaj zestawów .NET), który chcesz spakować i udostępnić innym osobom za pośrednictwem publicznej galerii nuget.org lub galerii prywatnej w organizacji. Pakiet może również zawierać dodatkowe pliki, takie jak plik readme wyświetlany podczas instalowania pakietu i może zawierać przekształcenia do niektórych plików projektu.

Pakiet może również służyć tylko do ściągania dowolnej liczby innych zależności bez konieczności używania własnego kodu. Taki pakiet to wygodny sposób dostarczania zestawu SDK składającego się z wielu niezależnych pakietów. W innych przypadkach pakiet może zawierać tylko pliki symboli (.pdb), które ułatwiają debugowanie.

Uwaga

Podczas tworzenia pakietu do użycia przez innych deweloperów ważne jest, aby zrozumieć, że biorą one zależność od pracy. W związku z tym tworzenie i publikowanie pakietu oznacza również zobowiązanie do naprawiania usterek i wprowadzania innych aktualizacji lub przynajmniej udostępnienia pakietu jako open source, aby inni mogli go utrzymać.

Niezależnie od tego, czy tworzenie pakietu zaczyna się od decydowania o jego identyfikatorze, numerze wersji, licencji, informacjach o prawach autorskich i innych niezbędnych treściach. Po zakończeniu możesz użyć polecenia "pack", aby umieścić wszystko razem w .nupkg pliku. Ten plik można opublikować w kanale informacyjnym NuGet, takim jak nuget.org.

Napiwek

Pakiet NuGet z .nupkg rozszerzeniem jest po prostu plikiem ZIP. Aby łatwo sprawdzić zawartość dowolnego pakietu, zmień rozszerzenie na .zip i rozwiń jego zawartość w zwykły sposób. Przed podjęciem próby przekazania go do hosta pamiętaj o zmianie rozszerzenia z powrotem .nupkg na .

Aby dowiedzieć się i zrozumieć proces tworzenia, zacznij od artykułu Tworzenie pakietu , który przeprowadzi Cię przez podstawowe procesy wspólne dla wszystkich pakietów.

W tym miejscu możesz rozważyć szereg innych opcji pakietu:

  • Obsługa wielu platform docelowych opisuje sposób tworzenia pakietu z wieloma wariantami dla różnych platform .NET Framework.
  • Tworzenie zlokalizowanych pakietów opisuje sposób tworzenia struktury pakietu z wieloma zasobami językowymi i używania oddzielnych zlokalizowanych pakietów satelitarnych.
  • Pakiety wersji wstępnej pokazują, jak wydać pakiety alfa, beta i rc dla tych klientów, którzy są zainteresowani.
  • Przekształcenia plików źródłowych i konfiguracji opisują, jak można wykonywać zamiany tokenów jednokierunkowych w plikach dodawanych do projektu oraz modyfikować web.config ustawienia app.config , które również są wyparte po odinstalowaniu pakietu.
  • Pakiety symboli zawierają wskazówki dotyczące dostarczania symboli biblioteki, które umożliwiają użytkownikom przejście do kodu podczas debugowania.
  • Przechowywanie wersji pakietów zawiera omówienie sposobu identyfikowania dokładnych wersji, które umożliwiają korzystanie z zależności (innych pakietów używanych z pakietu).
  • Pakiety natywne opisują proces tworzenia pakietu dla użytkowników języka C++.
  • Pakiety podpisywania opisują proces dodawania podpisu cyfrowego do pakietu.

Gdy wszystko będzie gotowe do opublikowania pakietu w celu nuget.org, postępuj zgodnie z prostym procesem w temacie Publikowanie pakietu.

Jeśli chcesz użyć prywatnego kanału informacyjnego zamiast nuget.org, zobacz Omówienie pakietów hostingu