Share via

perintah restore (NuGet CLI)

  • Artikel

Berlaku untuk: konsumsi paket • Versi yang didukung: 2.7+

Mengunduh dan menginstal paket apa pun yang hilang dari packages folder. Saat digunakan dengan NuGet 4.0+ dan format PackageReference, menghasilkan <project>.nuget.props file, jika diperlukan, di obj folder . (File dapat dihilangkan dari kontrol sumber.)

Di Mac OSX dan Linux dengan CLI di Mono, memulihkan paket tidak didukung dengan PackageReference.

Penggunaan

nuget restore <projectPath> [options]

di mana <projectPath> menentukan lokasi solusi atau packages.config file. Lihat Keterangan di bawah ini untuk detail perilaku.

Opsi

  • -ConfigFile

    File konfigurasi NuGet yang akan diterapkan. Jika tidak ditentukan, %AppData%\NuGet\NuGet.Config (Windows), atau atau ~/.nuget/NuGet/NuGet.Config~/.config/NuGet/NuGet.Config (Mac/Linux) digunakan.

  • -DirectDownload

    (4.0+) Mengunduh paket secara langsung tanpa mengisi cache dengan biner atau metadata apa pun.

  • -DisableParallelProcessing

    Menonaktifkan pemulihan beberapa paket secara paralel.

  • -FallbackSource

    (3.2+) Daftar sumber paket yang akan digunakan sebagai fallback jika paket tidak ditemukan di sumber utama atau default. Gunakan titik koma untuk memisahkan entri daftar.

  • -Force

    Dalam proyek berbasis PackageReference, memaksa semua dependensi diselesaikan meskipun pemulihan terakhir berhasil. Menentukan bendera ini mirip dengan menghapus project.assets.json file. Ini tidak melewati http-cache.

  • -ForceEnglishOutput

    (3.5+) Memaksa nuget.exe untuk berjalan menggunakan budaya berbasis bahasa Inggris yang invarian.

  • -ForceEvaluate

    Memaksa pemulihan untuk mengevaluasi kembali semua dependensi bahkan jika file kunci sudah ada.

  • -?|-help

    Menampilkan informasi bantuan untuk perintah.

  • -LockFilePath

    Lokasi output tempat file kunci proyek ditulis. Secara default, ini adalah PROJECT_ROOT\packages.lock.json.

  • -LockedMode

    Jangan izinkan memperbarui file kunci proyek.

  • -MSBuildPath

    (4.0+) Menentukan jalur MSBuild untuk digunakan dengan perintah , lebih diutamakan daripada -MSBuildVersion.

  • -MSBuildVersion

    (3.2+) Menentukan versi MSBuild yang akan digunakan dengan perintah ini. Nilai yang didukung adalah 4, 12, 14, 15.1, 15.3, 15.4, 15.5, 15.6, 15.7, 15.8, 15.9. Secara default MSBuild di jalur Anda dipilih, jika tidak, MSBuild default ke versi MSBuild tertinggi yang diinstal.

  • -NoHttpCache

    Mencegah NuGet menggunakan paket http cache. Lihat Mengelola paket global dan folder cache.

  • -NonInteractive

    Menekan permintaan untuk input atau konfirmasi pengguna.

  • -OutputDirectory

    Menentukan folder tempat paket diinstal. Jika tidak ada folder yang ditentukan, folder saat ini akan digunakan. Diperlukan saat memulihkan dengan packages.config file kecuali PackagesDirectory atau SolutionDirectory digunakan.

  • -PackageSaveMode

    Menentukan jenis file yang akan disimpan setelah penginstalan paket: salah satu dari nuspec, nupkg, atau nuspec;nupkg.

  • -PackagesDirectory

    Sama seperti OutputDirectory. Diperlukan saat memulihkan dengan packages.config file kecuali OutputDirectory atau SolutionDirectory digunakan.

  • -Project2ProjectTimeOut

    Batas waktu dalam detik untuk menyelesaikan referensi proyek-ke-proyek.

  • -Recursive

    (4.0+) Memulihkan semua proyek referensi untuk proyek UWP dan .NET Core. Tidak berlaku untuk proyek menggunakan packages.config.

  • -RequireConsent

    Memverifikasi bahwa memulihkan paket diaktifkan sebelum mengunduh dan menginstal paket. Untuk detailnya, lihat Pemulihan Paket.

  • -SolutionDirectory

    Menentukan folder solusi. Tidak valid saat memulihkan paket untuk solusi. Diperlukan saat memulihkan dengan packages.config file kecuali PackagesDirectory atau OutputDirectory digunakan.

  • -Source

    Menentukan daftar sumber paket (sebagai URL) yang akan digunakan untuk pemulihan. Jika dihilangkan, perintah menggunakan sumber yang disediakan dalam file konfigurasi, lihat Mengonfigurasi perilaku NuGet. Gunakan titik koma untuk memisahkan entri daftar.

  • -UseLockFile

    Memungkinkan file kunci proyek dibuat dan digunakan dengan pemulihan.

  • -Verbosity [normal|quiet|detailed]

    Menentukan jumlah detail yang ditampilkan dalam output: normal (default), quiet, atau detailed.

Lihat juga Variabel lingkungan

Keterangan

Perintah pemulihan melakukan langkah-langkah berikut:

  1. Tentukan mode operasi perintah pemulihan.

    jenis file projectPath Perilaku
    Solusi (folder) NuGet mencari .sln file dan menggunakannya jika ditemukan; jika tidak, memberikan kesalahan. (SolutionDir)\.nuget digunakan sebagai folder awal.
    File .sln Pulihkan paket yang diidentifikasi oleh solusi; memberikan kesalahan jika -SolutionDirectory digunakan. $(SolutionDir)\.nuget digunakan sebagai folder awal.
    packages.config atau file proyek Pulihkan paket yang tercantum dalam file, menyelesaikan dan menginstal dependensi.
    Jenis file lainnya File diasumsikan sebagai .sln file seperti di atas; jika bukan solusi, NuGet memberikan kesalahan.
    (projectPath tidak ditentukan)
    • NuGet mencari file solusi di folder saat ini. Jika satu file ditemukan, file tersebut digunakan untuk memulihkan paket; jika beberapa solusi ditemukan, NuGet memberikan kesalahan.
    • Jika tidak ada file solusi, NuGet mencari packages.config dan menggunakannya untuk memulihkan paket.
    • Jika tidak ada solusi atau packages.config file yang ditemukan, NuGet akan memberikan kesalahan.

  2. Tentukan folder paket menggunakan urutan prioritas berikut (NuGet memberikan kesalahan jika tidak ada folder ini yang ditemukan):

    • Folder yang ditentukan dengan -PackagesDirectory.
    • Nilai repositoryPath dalam Nuget.Config
    • Folder yang ditentukan dengan -SolutionDirectory
    • $(SolutionDir)\packages

  3. Saat memulihkan paket untuk solusi, NuGet melakukan hal berikut:

    • Memuat file solusi.
    • Memulihkan paket tingkat solusi yang tercantum dalam $(SolutionDir)\.nuget\packages.configpackages folder.
    • Pulihkan paket yang tercantum dalam $(ProjectDir)\packages.configpackages folder. Untuk setiap paket yang ditentukan, pulihkan paket secara paralel kecuali -DisableParallelProcessing ditentukan.

Contoh

# Restore packages for a solution file
nuget restore a.sln

# Restore packages for a solution file, using MSBuild version 14.0 to load the solution and its project(s)
nuget restore a.sln -MSBuildVersion 14

# Restore packages for a project's packages.config file, with the packages folder at the parent
nuget restore proj1\packages.config -PackagesDirectory ..\packages

# Restore packages for the solution in the current folder, specifying package sources
nuget restore -source "https://api.nuget.org/v3/index.json;https://www.myget.org/F/nuget"