dotnet restoredotnet restore

Cette rubrique s’applique au : ✓ SDK .NET Core 1.x SDK .NET Core 2.xThis topic applies to: ✓ .NET Core 1.x SDK .NET Core 2.x SDK

NameName

dotnet restore : Restaure les dépendances et les outils d’un projet.dotnet restore - Restores the dependencies and tools of a project.

RésuméSynopsis

dotnet restore [<ROOT>] [--configfile] [--disable-parallel] [--force] [--ignore-failed-sources] [--no-cache]
    [--no-dependencies] [--packages] [-r|--runtime] [-s|--source] [-v|--verbosity] [--interactive]
dotnet restore [-h|--help]

DescriptionDescription

La commande dotnet restore utilise NuGet pour restaurer les dépendances, ainsi que les outils spécifiques aux projets qui sont spécifiés dans le fichier projet.The dotnet restore command uses NuGet to restore dependencies as well as project-specific tools that are specified in the project file. Par défaut, la restauration des dépendances et celle des outils sont exécutées en parallèle.By default, the restoration of dependencies and tools are executed in parallel.

Notes

À partir du kit SDK .NET Core 2.0, vous n’avez pas à exécuter dotnet restore, car il est exécuté implicitement par toutes les commandes qui réclament une restauration, comme dotnet new, dotnet build et dotnet run.Starting with .NET Core 2.0 SDK, you don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet new, dotnet build and dotnet run. Cette commande reste néanmoins valide dans certains scénarios où une restauration explicite est nécessaire, comme des builds d’intégration continue dans Azure DevOps Services ou dans les systèmes de génération qui doivent contrôler explicitement le moment auquel la restauration se produit.It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control the time at which the restore occurs.

Pour restaurer les dépendances, NuGet a besoin des flux où sont situés les packages.To restore the dependencies, NuGet needs the feeds where the packages are located. Les flux sont généralement fournis par le fichier de configuration NuGet.config.Feeds are usually provided via the NuGet.config configuration file. Un fichier de configuration par défaut est fourni lors de l’installation des outils CLI.A default configuration file is provided when the CLI tools are installed. Vous pouvez spécifier d’autres flux en créant votre propre fichier NuGet.config dans le répertoire du projet.You specify additional feeds by creating your own NuGet.config file in the project directory. Vous pouvez également spécifier des flux supplémentaires par appel dans une invite de commandes.You also specify additional feeds per invocation at a command prompt.

Pour les dépendances, vous pouvez spécifier l’emplacement des packages restaurés pendant l’opération de restauration à l’aide de l’argument --packages.For dependencies, you specify where the restored packages are placed during the restore operation using the --packages argument. Si aucune valeur n’est spécifiée, le cache du package NuGet par défaut est utilisé. Il se trouve dans le répertoire .nuget/packages, situé dans le répertoire de base de l’utilisateur, sur tous les systèmes d’exploitation.If not specified, the default NuGet package cache is used, which is found in the .nuget/packages directory in the user's home directory on all operating systems. Par exemple, /home/user1 sur Linux ou C:\Users\user1 sur Windows.For example, /home/user1 on Linux or C:\Users\user1 on Windows.

Pour les outils spécifiques au projet, dotnet restore commence par restaurer le package dans lequel l’outil est empaqueté, puis il restaure les dépendances de l’outil, comme spécifié dans son fichier projet.For project-specific tooling, dotnet restore first restores the package in which the tool is packed, and then proceeds to restore the tool's dependencies as specified in its project file.

Le comportement de la commande dotnet restore est affecté par certains paramètres du fichier Nuget.Config, le cas échéant.The behavior of the dotnet restore command is affected by some of the settings in the Nuget.Config file, if present. Par exemple, si vous définissez globalPackagesFolder dans NuGet.Config, les packages NuGet restaurés sont placés dans le dossier spécifié.For example, setting the globalPackagesFolder in NuGet.Config places the restored NuGet packages in the specified folder. Cette méthode permet également de spécifier l’option --packages sur la commande dotnet restore.This is an alternative to specifying the --packages option on the dotnet restore command. Pour plus d’informations, consultez Informations de référence sur NuGet.Config.For more information, see the NuGet.Config reference.

dotnet restore impliciteImplicit dotnet restore

À compter de .NET Core 2.0, dotnet restore est au besoin exécuté implicitement quand vous exécutez les commandes suivantes :Starting with .NET Core 2.0, dotnet restore is run implicitly if necessary when you issue the following commands:

Dans la plupart des cas, vous n’avez plus besoin d’utiliser explicitement la commande dotnet restore.In most cases, you no longer need to explicitly use the dotnet restore command.

Parfois, il peut s’avérer fastidieux d’exécuter dotnet restore implicitement.Sometimes, it might be inconvenient to run dotnet restore implicitly. Par exemple, certains systèmes automatisés, comme les systèmes de génération, doivent appeler explicitement dotnet restore pour contrôler quand la restauration a lieu afin de pouvoir contrôler l’utilisation du réseau.For example, some automated systems, such as build systems, need to call dotnet restore explicitly to control when the restore occurs so that they can control network usage. Pour empêcher l’exécution implicite de dotnet restore, vous pouvez utiliser l’indicateur --no-restore avec l’une de ces commandes afin de désactiver la restauration implicite.To prevent dotnet restore from running implicitly, you can use the --no-restore flag with any of these commands to disable implicit restore.

ArgumentsArguments

ROOT

Chemin facultatif du fichier projet à restaurer.Optional path to the project file to restore.

OptionsOptions

--configfile <FILE>

Fichier de configuration NuGet (NuGet.config) à utiliser pour l’opération de restauration.The NuGet configuration file (NuGet.config) to use for the restore operation.

--disable-parallel

Désactive la restauration de plusieurs projets en parallèle.Disables restoring multiple projects in parallel.

--force

Force la résolution de toutes les dépendances même si la dernière restauration a réussi.Forces all dependencies to be resolved even if the last restore was successful. Définir cet indicateur revient à supprimer le fichier project.assets.json.Specifying this flag is the same as deleting the project.assets.json file.

-h|--help

Affiche une aide brève pour la commande.Prints out a short help for the command.

--ignore-failed-sources

N’avertit en cas d’échec des sources que si des packages répondent aux exigences de versions.Only warn about failed sources if there are packages meeting the version requirement.

--no-cache

Spécifie de ne pas mettre en cache les packages et les requêtes HTTP.Specifies to not cache packages and HTTP requests.

--no-dependencies

En cas de restauration d’un projet avec des références entre projets (P2P), restaure le projet racine et non les références.When restoring a project with project-to-project (P2P) references, restores the root project and not the references.

--packages <PACKAGES_DIRECTORY>

Spécifie le répertoire des packages restaurés.Specifies the directory for restored packages.

-r|--runtime <RUNTIME_IDENTIFIER>

Spécifie un runtime pour la restauration du package.Specifies a runtime for the package restore. Cela permet de restaurer les packages des runtimes qui ne sont pas explicitement listés dans la balise <RuntimeIdentifiers> du fichier .csproj.This is used to restore packages for runtimes not explicitly listed in the <RuntimeIdentifiers> tag in the .csproj file. Pour connaître les identificateurs de runtime, consultez le catalogue des identificateurs de runtime.For a list of Runtime Identifiers (RIDs), see the RID catalog. Fournissez plusieurs identificateurs de runtime en spécifiant cette option plusieurs fois.Provide multiple RIDs by specifying this option multiple times.

-s|--source <SOURCE>

Spécifie la source de package NuGet à utiliser pendant l’opération de restauration.Specifies a NuGet package source to use during the restore operation. Ce paramètre remplace toutes les sources spécifiées dans les fichiers NuGet.config.This setting overrides all of the sources specified in the NuGet.config files. Vous pouvez spécifier plusieurs sources en spécifiant cette option plusieurs fois.Multiple sources can be provided by specifying this option multiple times.

--verbosity <LEVEL>

Définit le niveau de détail de la commande.Sets the verbosity level of the command. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic].

--interactive

Permet à la commande de s’arrêter et d’attendre une saisie ou une action de l’utilisateur (par exemple, s’identifier).Allows the command to stop and wait for user input or action (for example to complete authentication). Depuis .NET Core 2.1.400.Since .NET Core 2.1.400.

ExemplesExamples

Restaurez des dépendances et des outils pour le projet se trouvant dans le répertoire actif :Restore dependencies and tools for the project in the current directory:

dotnet restore

Restaurez des dépendances et des outils pour le projet app1 se trouvant à l’emplacement donné :Restore dependencies and tools for the app1 project found in the given path:

dotnet restore ~/projects/app1/app1.csproj

Restaurer les dépendances et les outils du projet se trouvant dans le répertoire actif en utilisant le chemin d’accès de fichier fourni comme source :Restore the dependencies and tools for the project in the current directory using the file path provided as the source:

dotnet restore -s c:\packages\mypackages

Restaurer les dépendances et les outils du projet se trouvant dans le répertoire actif en utilisant les deux chemins d’accès de fichiers fournis comme sources :Restore the dependencies and tools for the project in the current directory using the two file paths provided as sources:

dotnet restore -s c:\packages\mypackages -s c:\packages\myotherpackages

Restaurer les dépendances et les outils du projet se trouvant dans le répertoire actif et afficher uniquement une sortie minimale :Restore dependencies and tools for the project in the current directory and shows only minimal output:

dotnet restore --verbosity minimal