Uwzględnione pakietu NuGet w projekcieInclude a NuGet package in your project

NuGet jest najbardziej popularnych Menedżer pakietów dla programowania na platformie .NET i wbudowanej w program Visual Studio dla komputerów Mac i Visual Studio na Windows.NuGet is the most popular package manager for .NET development and is built in to Visual Studio for Mac and Visual Studio on Windows. Można wyszukiwać i dodawać pakiety do projektów Xamarin.iOS i Xamarin.Android przy użyciu dowolnego środowiska IDE.You can search for and add packages to your Xamarin.iOS and Xamarin.Android projects using either IDE.

W tym artykule opisano, jak dołączyć pakietu NuGet w projekcie i pokazuje łańcuch narzędzi, który sprawia, że proces jest bezproblemowe.This article describes how to include a NuGet package in a project and demonstrates the tool chain that makes the process seamless.

NuGet w programie Visual Studio dla komputerów MacNuGet in Visual Studio for Mac

Aby zademonstrować funkcje pakietu NuGet, najpierw przeprowadzimy przez tworzenie nowej aplikacji i dodawanie pakietu do niego.To demonstrate the NuGet package functionality, we'll first walk through creating a new application and adding a package to it. Następnie omówimy funkcji środowiska IDE, które ułatwia zarządzanie pakietami.Then we'll discuss the IDE features that help manage packages.

Tworzenie nowego projektuCreate a new project

Najpierw utwórz projekt o nazwie HelloNuget tak jak przedstawiono poniżej.First, create a project named HelloNuget as illustrated below. W tym przykładzie przedstawiono szablon aplikacja pojedynczego widoku dla systemu iOS, ale będzie działać w dowolnym typem projektu obsługiwane:This example shows the iOS Single View Application template, but any supported project type would work:

Tworzenie nowego projektu dla systemu iOS

Dodawanie pakietuAdding a Package

Otwórz w programie Visual Studio dla komputerów Mac projektu, kliknij prawym przyciskiem myszy pakietów folderu w konsoli rozwiązania i wybierz Dodawanie pakietów:With the project open in Visual Studio for Mac, right-click on the Packages folder in the Solution Pad and select Add Packages:

Dodaj nową akcję kontekstu pakietu NuGet

Spowoduje to uruchomienie Dodawanie pakietów okna.This launches the Add Packages window. Upewnij się, że źródło listy rozwijanej, jest ustawiona na nuget.org:Ensure that the Source drop-down, is set to nuget.org:

Źródło listy rozwijanej

Po otwarciu przez okna ładuje listę pakietów z domyślnego źródła pakietu: nuget.org. Początkowe wyniki wyglądać następująco:When the window opens it loads a list of packages from the default package source: nuget.org. The initial results look like this:

Lista pakietów NuGet

Użyj pola wyszukiwania w prawym górnym rogu, aby znaleźć określony pakiet, na przykład azure.Use the search box in the top-right corner to find a specific package, for example azure. Po znalezieniu pakietu, który chcesz użyć, zaznacz go i kliknij Dodaj pakiet przycisk, aby rozpocząć instalację.When you've found a package that you wish to use, select it and click the Add Package button to begin installation.

Dodaj pakiet NuGet platformy AzureAdd Azure NuGet Package

Po pobraniu pakietu zostanie dodany do projektu.Once the package has been downloaded, it will be added to your project. Rozwiązanie zmieni się w następujący sposób:The solution will change as follows:

  • Odwołania węzeł będzie zawierać listę wszystkich zestawów, które są częścią pakietu NuGet.The References node will contain a list of all the assemblies that are part of a NuGet package.
  • Pakietów węzła wyświetla każdego pakietu NuGet, które zostały pobrane.The Packages node displays each NuGet package that you have downloaded. Można zaktualizować lub usunąć pakiet z tej listy.You can update or remove a package from this list.
  • A packages.config plik zostanie dodany do projektu.A packages.config file will be added to the project. Ten plik XML jest używany przez środowisko IDE do śledzenia wersji pakietu, które są określone w tym projekcie.This XML file is used by the IDE to track which package versions are referenced in this project. Ten plik nie powinien być ręcznie edytowany, ale należy go przechowywać w kontroli wersji.This file should not be hand-edited, but you should keep it in version control. Należy pamiętać, że plik project.json mogą być używane zamiast pliku packages.config.Note that a project.json file can be used instead of a packages.config file. Plik project.json jest nowym formacie plików pakietu wprowadzone w programie NuGet 3, która obsługuje Przywracanie przechodnie.The project.json file is a new package file format introduced with NuGet 3, which supports transitive restore. Bardziej szczegółowe informacje o pliku project.json znajdują się w dokumentacja programu NuGet.More detailed information on project.json can be found in the NuGet documentation. Plik project.json musi zostać dodane ręcznie, a projekt zamknięciu i ponownym otwarciu przed pliku project.json jest używany w programie Visual Studio dla komputerów Mac.The project.json file needs to be added manually and the project closed and re-opened before the project.json file is used in Visual Studio for Mac.

Za pomocą pakietów NuGetUsing NuGet Packages

Po dodaniu pakietu NuGet i odwołania do projektu, zaktualizowany, można programować względem interfejsy API, co w przypadku dowolnego odwołania do projektu.Once the NuGet package has been added and the project references updated, you can program against the APIs as you would with any project reference.

Upewnij się, Dodaj wymagane using dyrektywy na początku pliku:Ensure that you add any required using directives to the top of your file:

using Newtonsoft.Json;

Większość NuGet zawierają dodatkowe informacje, takie jak plik README lub projektu łącze strony do źródła pakietów Nuget.Most NuGet provide additional information, such as a README or Project page link to the Nuget source. Zwykle znajduje się łącze do tego w notka pakietu na stronie Dodawanie pakietów:You can normally find a link to this in the package blurb on the Add Packages page:

Link do wyświetlenia strony projektuView Project Page link

Pakiet aktualizacjiPackage Updates

Pakiet aktualizacji może się to odbywać wszystko naraz, klikając prawym przyciskiem myszy pakietów węzła, lub osobno dla każdego składnika.Package updates can be done either all at once, by right-clicking on the Packages node, or individually on each component.

Kliknij prawym przyciskiem myszy pakietów dostęp do menu kontekstowego:Right-click on Packages to access the context menu:

Menu pakietów

  • Dodaj pakiety — powoduje otwarcie okna, aby dodać więcej pakietów do projektu.Add Packages - Opens the window to add more packages to the project.
  • Aktualizacja — sprawdza, czy serwer źródłowy dla każdego pakietu i pobiera wszystkie nowsze wersje.Update - Checks the source server for each package and downloads any newer versions.
  • Przywróć — pliki do pobrania wszystkie brakujące pakiety (bez aktualizowania istniejące pakiety do nowszych wersji).Restore - Downloads any missing packages (without updating existing packages to newer versions).

Aktualizacja opcje przywracania są również dostępne na poziomie rozwiązania i wpływają na wszystkie projekty w rozwiązaniu.Update and Restore options are also available at the Solution level, and affect all the projects in the solution.

Użytkownik może również kliknij prawym przyciskiem myszy poszczególnych pakietów na dostęp do menu kontekstowego:You can also right-click on individual packages to access a context menu:

Menu pakietów

  • Numer wersji — numer wersji jest wyłączonego elementu menu — jest ona udostępniana tylko w celach informacyjnych.Version Number - The version number is a disabled menu item - it is provided for informational purposes only.
  • Aktualizacja — sprawdza, czy serwer źródłowy i pliki do pobrania jest nowsza wersja (jeśli istnieje).Update - Checks the source server and downloads a newer version (if it exists).
  • Usuń — usuwa pakiet z tego projektu i usunięcie odpowiednich zestawów z odwołaniami do projektów.Remove - Removes the package from this project and removes the relevant assemblies from the project's References.

Dodawanie źródła pakietówAdding Package Sources

Dostępne do zainstalowania pakietów początkowo są pobierane z witryny nuget.org. Jednak dodać inne lokalizacje pakietu programu Visual Studio dla komputerów Mac.Packages available for installation are initially retrieved from nuget.org. However, you can add other package locations to Visual Studio for Mac. Może to być przydatne w przypadku testowania pakietów NuGet w fazie projektowania lub użyć prywatny serwer NuGet wewnątrz firmy lub organizacji.This can be useful for testing your own NuGet packages under development, or to use a private NuGet server inside your company or organization.

W programie Visual Studio dla komputerów Mac, przejdź do programu Visual Studio > Preferencje > NuGet > źródeł do wyświetlania i edytowania listy źródeł pakietów.In Visual Studio for Mac, navigate to Visual Studio > Preferences > NuGet > Sources to view and edit the list of package sources. Należy pamiętać, że źródła może być (określone za pomocą adresu URL) serwera zdalnego lub katalogu lokalnego.Note that sources can be a remote server (specified by a URL) or a local directory.

Źródła pakietów

Kliknij przycisk Dodaj do konfiguracji nowego źródła.Click Add to set-up a new source. Wprowadź przyjazną nazwę i adres URL (lub ścieżka do pliku) do źródła pakietu.Enter a friendly name and the URL (or file path) to the package source. Jeśli źródło jest zabezpieczonym serwerze sieci web, wprowadź nazwę użytkownika i hasło, a także, w przeciwnym razie pozostaw puste następujące wpisy:If the source is a secure web server, enter the username and password as well, otherwise leave these entries blank:

Dodawanie źródła pakietów

Następnie można wybrać różnych źródeł, aby wyszukać pakiety:Different sources can then be selected when searching for packages:

Dodawanie źródła pakietów

Kontrola wersjiVersion Control

W tym artykule omówiono dokumentacji NuGet za pomocą narzędzia NuGet nie poświęcając pakietów do kontroli źródła.The NuGet documentation discusses using NuGet without committing packages to source control. Jeśli nie chcesz przechowywać pliki binarne i nieużywanych informacji w kontroli źródła, można skonfigurować program Visual Studio for Mac automatycznie przywrócić pakiety z serwera.If you prefer not to store binaries and unused information in source control, you can configure Visual Studio for Mac to automatically restore packages from the server. Oznacza to, że kiedy Deweloper pobiera projektu z kontroli źródła po raz pierwszy, Visual Studio dla komputerów Mac automatycznie pobierze i zainstaluje wymagane pakiety.This means that when a developer retrieves the project from source control for the first time, Visual Studio for Mac will automatically download and install the required packages.

Automatycznie przywracanie pakietów

Można znaleźć w dokumentacji kontroli konkretnego źródła, aby uzyskać szczegółowe informacje na temat wykluczania packages katalogu z są śledzone.Refer to your particular source control documentation for details on how to exclude the packages directory from being tracked.

Zobacz takżeSee also