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 / Notatka

Podczas tworzenia pakietu do użycia przez innych deweloperów ważne jest, aby zrozumieć, że przyjmują oni zależność od Twojej 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ć.

Rozpoczęcie tworzenia pakietu polega na ustaleniu jego identyfikatora, numeru wersji, licencji, informacji o prawach autorskich oraz wszelkich innych niezbędnych treści. 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.

Wskazówka

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. Upewnij się, że przed próbą przekazania go do hosta zmienisz rozszerzenie z powrotem na .nupkg.

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 plików konfiguracyjnych opisują, jak można wykonywać jednokierunkowe zamiany tokenów w plikach dodawanych do projektu oraz modyfikować web.config ustawienia app.config, które są również przywracane po odinstalowaniu pakietu.
• Pakiety symboli oferują wskazówki dotyczące dostarczania symboli dla twojej biblioteki, które umożliwiają użytkownikom przejście do Twojego kodu podczas debugowania.
• Wersjonowanie pakietów opisuje, jak identyfikować dokładne wersje, które dopuszczasz do używania dla swoich zależności (paczki, które konsumujesz z swojego pakietu).
• Pakiety natywne opisują proces tworzenia pakietu dla użytkowników języka C++.
• Pakiety podpisywania opisują proces dodawania podpisu cyfrowego do pakietu.

Kiedy będziesz gotowy, aby opublikować pakiet do nuget.org, zobacz prosty proces w Publikowanie pakietu.

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