NuGet Package Manager-alternativ i Visual Studio

Visual Studio innehåller flera alternativsidor för att konfigurera NuGet Package Manager-beteende. Konfigurationsinställningarna för NuGet lagras i din NuGet.Config-fil(er).

Komma åt NuGet-alternativ

Det finns flera sätt att komma åt NuGet Package Manager-alternativ:

1. Från huvudmenyn: Gå till Verktygsalternativ >och expandera sedan NuGet Package Manager i den vänstra rutan.
2. Från NuGet-menyn finns under menykommandot Verktyg > NuGet Package Manager > Package Manager-inställningar .
3. Snabbsökning: Använd Visual Studio-sökning för att söka efter "NuGet" eller ett NuGet-relaterat inställningsnamn för att snabbt gå till sidan Alternativ.
4. Från Package Manager-användargränssnittet: Tryck på inställningsikonen (kugghjulsikonen) i verktygsfältet för Package Manager-användargränssnittet.
5. Från Package Manager-konsolen: Klicka på inställningsikonen (kugghjulet) i verktygsfältet i Package Manager Console.

General

Sidan Allmänna alternativ innehåller inställningar som styr NuGets pakethanteringsbeteende.

Paketåterställning

Inställningar för automatisk paketåterställning under byggåtgärder:

• Tillåt att NuGet laddar ned paket som saknas: Välj för att aktivera paketåterställning och kommandot Återställ NuGet Packages.
• Sök automatiskt efter paket som saknas under kompilering i Visual Studio: Välj om du vill återställa eventuella paket som saknas automatiskt när du kör en version från Visual Studio.

Mer information om hur du återställer paket finns i Paketåterställning .

Bindningsomdirigeringar

• Hoppa över att tillämpa bindningsomdirigeringar: När det är aktiverat lägger NuGet inte automatiskt till eller uppdaterar bindningsomdirigeringar i app.config eller web.config filer under paketinstallationen eller uppdateringarna

Pakethantering

• Standardformat för pakethantering: Välj mellan NuGet-formaten PackageReference (rekommenderas för de flesta projekt) och packages.config (äldre format för äldre projekt). Mer information finns i Välj standardformat för pakethantering.

  • PackageReference: Lagrar paketreferenser direkt i projektfiler. Det här är det moderna format som stöder bättre beroendematchning och som krävs för SDK-liknande projekt
  • packages.config: Äldre XML-filformat som lagrar paketinformation separat från projektfilen

• Fråga efter formatval vid första paketinstallationen: När det är aktiverat ber Visual Studio dig att välja mellan PackageReference och packages.config första gången du installerar ett paket i ett projekt som inte redan har paket.

Rensa Lokala NuGet-resurser

Med kommandoknappen Rensa NuGet-lokala resurser kan du rensa NuGets lokala cacheminnen, inklusive:

• http-cache: Hämtade paketmetadata och paket
• global-packages: Installerad paketmapp
• temp: Temporära filer
• plugins-cache: Resultat av plugin-åtgärder

Mer information om NuGet-cacheminnen och mappar finns i Hantera globala paket, cacheminnen och temporära mappar.

Konfigurationsfiler

På sidan Alternativ för konfigurationsfiler visas NuGet.Config-filerna som gäller för den aktuella lösningen och gör att du kan öppna dem direkt i Visual Studio för redigering.

Om du vill redigera en fil väljer du en sökväg och trycker på knappen "Öppna". Filen öppnas på en ny flik i Visual Studio där den kan redigeras direkt.

Konfigurationsfiler visas i ordning från högsta till lägsta prioritet. NuGet använder ett hierarkiskt konfigurationssystem där inställningar från flera konfigurationsfiler sammanfogas. Mer information finns i Vanliga NuGet-konfigurationer.

Paketkällor

På sidan Alternativ för paketkällor kan du hantera de källor som NuGet laddar ned paket från.

Hantera paketkällor

Visar en lista över alla konfigurerade paketkällor enligt nuGet.Config-filerna.

• Namn: Visningsnamn för källan
• Källa: URL eller filsökväg för paketkällan
• Kryssrutan Aktiverad: Aktivera eller inaktivera en källa utan att ta bort den.
• Tillåt osäkra anslutningar: Aktivera eller inaktivera tillåta osäkra HTTP-anslutningar

Om du vill ändra använder du knapparna Lägg till, Redigera och Ta bort under tabellen. Kryssrutor kan växlas direkt i tabellen. Tryck på Spara i dialogrutan Lägg till/redigera så uppdateras ändringarna i relevant NuGet.Config-fil.

Paketkällor för hela datorn

Paketkällor som definierats på datornivå visas i ett dedikerat avsnitt nedan. Dessa etableras vanligtvis av Visual Studio-arbetsbelastningar och kan endast aktiveras eller inaktiveras med hjälp av kryssrutan i kolumnen Aktiverad.

Tillåt osäkra anslutningar

Av säkerhetsskäl framtvingar NuGet användning av HTTPS-källor som standard. Om du behöver använda en HTTP-källa måste du uttryckligen tillåta den. När en HTTP-källa används visar den första kolumnen i tabellen Paketkällor en ikon med information om en varning eller ett fel med paketkällan på den raden.

⚠️ När en HTTP-paketkälla används och Tillåt osäkra anslutningar är aktiverat visas en varning i kolumnen längst till vänster:

HTTP-källor är osäkra. Överväg att använda HTTPS i stället. "AllowInsecureConnections" är aktiverat, vilket tillåter HTTP-åtkomst.

❌ När en HTTP-källa används och Tillåt osäkra anslutningar inaktiveras visas ett fel i kolumnen längst till vänster och NuGet-återställningen misslyckas:

NuGet kräver HTTPS-källor. Om du vill använda en HTTP-källa måste du uttryckligen ange "allowInsecureConnections" till true i NuGet.Config-filen.

Mer information om hur du konfigurerar HTTP-källbehörigheter finns i https://aka.ms/nuget-https-everywhere.

Mappning av paketkälla

Med paketkällmappning kan du styra vilka paketkällor som används för specifika paket, vilket förbättrar säkerheten i leveranskedjan.

Om du vill ändra använder du knapparna Lägg till, Redigera och Ta bort under tabellen.

Hantera paketkällamappningar

Visar en lista över alla konfigurerade paketkällmappningar enligt dina NuGet.Config-filer.

• Paketmönster: Paketmönster som för närvarande är mappat (t.ex. Microsoft.* eller Contoso.Contracts)
• Källa: En eller flera paketkällor som mappats till paketmönstret. Paketkällor måste vara aktiverade för att visas.

Om du vill ändra använder du knapparna Lägg till, Redigera och Ta bort under tabellen. Tryck på Spara i dialogrutan Lägg till/redigera så uppdateras ändringarna i relevant NuGet.Config-fil.

Mer information finns i Mappning av paketkälla.

Ogiltiga källmappningar

Om en paketkälla som anges i din befintliga källmappning inte är aktiverad i nuGet.Config-filen eller -filerna visas ett fel i kolumnen längst till vänster.

Kontrollera att alla källvärden i dina mappningar refererar till paketkällor som både är tillgängliga och aktiverade. Annars kanske mappningen inte fungerar som förväntat.