Releaseopmerkingen voor NuGet 1.4

Releaseopmerkingen | voor NuGet 1.3Releaseopmerkingen voor NuGet 1.5

NuGet 1.4 is uitgebracht op 17 juni 2011.

Features

Update-Package verbeteringen

NuGet 1.4 introduceert veel verbeteringen in de Update-Package opdracht, waardoor het eenvoudiger is om pakketten op dezelfde versie in meerdere projecten in een oplossing te houden. Wanneer u bijvoorbeeld een pakket bijwerkt naar de nieuwste versie, is het gebruikelijk dat alle projecten waarop dat pakket is geïnstalleerd, worden bijgewerkt naar dezelfde versie.

Met de Update-Package opdracht kunt u het volgende eenvoudiger doen:

Alle pakketten in één project bijwerken

Update-Package -Project MvcApplication1

Een pakket in alle projecten bijwerken

Update-Package PackageId

Alle pakketten in alle projecten bijwerken

Update-Package

Een 'veilige' update uitvoeren op alle pakketten

De -Safe vlag beperkt upgrades naar alleen versies met hetzelfde onderdeel primaire en secundaire versie. Als bijvoorbeeld versie 1.0.0 van een pakket is geïnstalleerd en versie 1.0.1, 1.0.2 en 1.1 beschikbaar zijn in de feed, -Safe wordt het pakket bijgewerkt naar 1.0.2. Upgraden zonder de -Safe vlag zou het pakket upgraden naar de nieuwste versie, 1.1.

Update-Package -Safe

Pakketten beheren op oplossingsniveau

Vóór NuGet 1.4 was het installeren van een pakket in meerdere projecten lastig met behulp van het dialoogvenster. Hiervoor moet het dialoogvenster eenmaal per project worden gestart.

NuGet 1.4 voegt ondersteuning toe voor het installeren/verwijderen/bijwerken van pakketten in meerdere projecten tegelijk. Start de knop door met de rechtermuisknop op de oplossing te klikken en de menuoptie NuGet-pakketten beheren te selecteren.

U ziet dat in de titelbalk van het dialoogvenster de naam van de oplossing wordt weergegeven, niet de naam van een project. Pakketbewerkingen bieden nu een lijst met selectievakjes met de lijst met projecten waarop de bewerking moet worden toegepast.

Zie het onderwerp over het beheren van pakketten voor de oplossing voor meer informatie.

Upgrades beperken tot toegestane versies

Wanneer u de Update-Package opdracht op een pakket uitvoert (of het pakket bijwerkt met behulp van een dialoogvenster), wordt deze standaard bijgewerkt naar de nieuwste versie in de feed. Met de nieuwe ondersteuning voor het bijwerken van alle pakketten, kunnen er gevallen zijn waarin u een pakket wilt vergrendelen voor een specifiek versiebereik. U weet bijvoorbeeld van tevoren dat uw toepassing alleen werkt met versie 2.* van een pakket, maar niet met 3.0 en hoger. Om te voorkomen dat het pakket per ongeluk wordt bijgewerkt naar 3, voegt NuGet 1.4 ondersteuning toe voor het beperken van het bereik van versies waarnaar pakketten kunnen worden geüpgraded door het packages.config bestand handmatig te bewerken met behulp van het nieuwe allowedVersions kenmerk.

In het volgende voorbeeld ziet u hoe u het SomePackage-pakket vergrendelt in de versie-range 2.0 - 3.0 (exclusief). Het allowedVersions kenmerk accepteert waarden in het versiebereikformaat.

<?xml version="1.0" encoding="utf-8"?>
<packages>
    <package id="SomePackage" version="2.1.0" allowedVersions="[2.0, 3.0)" />
</packages>

Houd er rekening mee dat in 1.4 het vergrendelen van een pakket aan een specifiek versiebereik met de hand moet worden bewerkt. In NuGet 1.5 willen we ondersteuning toevoegen voor het plaatsen van dit bereik via de Install-Package opdracht.

Pakket Visualisator

Met de nieuwe pakket visualiseren, gestart via de menuoptie Tools ->Library Package Manager ->Package Visualizer , kunt u eenvoudig alle projecten en de bijbehorende pakketafhankelijkheden binnen een oplossing visualiseren.

Belangrijke opmerking: Deze functie maakt gebruik van de DGML-ondersteuning in Visual Studio. Het maken van de visualisatie wordt alleen ondersteund in Visual Studio Ultimate. Het weergeven van een DGML-diagram wordt alleen ondersteund in Visual Studio Premium of Hoger.

Automatische updatecontrole voor het Dialoogvenster NuGet

Sommige versies van NuGet introduceren nieuwe functies die worden uitgedrukt via het .nuspec bestand dat niet wordt begrepen door oudere versies van het NuGet-dialoogvenster. Een voorbeeld hiervan is de inleiding in NuGet 1.4 voor het opgeven van frameworkassembly's. Daarom is het belangrijk om de nieuwste versie van NuGet te gebruiken om ervoor te zorgen dat u pakketten kunt gebruiken die profiteren van de nieuwste functies. Als u updates voor NuGet zichtbaarder wilt maken, bevat het Dialoogvenster NuGet logica om te markeren wanneer er een nieuwere versie beschikbaar is.

Opmerking: de controle wordt alleen uitgevoerd als het tabblad Online is geselecteerd in de huidige sessie.

Als u de automatische controle op updates wilt uitschakelen, gaat u naar het dialoogvenster NuGet-instellingen en schakelt u Automatisch controleren op updates uit.

Deze functie is eigenlijk toegevoegd in NuGet 1.3, maar zou natuurlijk pas zichtbaar zijn als er een update naar 1.3, zoals NuGet 1.4, beschikbaar is gesteld.

Verbeteringen in het dialoogvenster Package Manager

• Menunamen zijn verbeterd: menuopties om het dialoogvenster te starten, zijn voor de duidelijkheid gewijzigd. De menuoptie is nu NuGet-pakketten beheren.
• In het detailvenster wordt de laatste updatedatum weergegeven: in het dialoogvenster NuGet wordt de datum weergegeven van de meest recente update in het detailvenster voor een pakket wanneer het tabblad Online of Updates is geselecteerd.
• Lijst met weergegeven tags: in het dialoogvenster Nuget worden tags weergegeven.

PowerShell-verbeteringen

• Ondertekende PowerShell-scripts: NuGet bevat ondertekende PowerShell-scripts die het gebruik in meer beperkende omgevingen mogelijk maken.
• Ondersteuning voor prompts: De Package Manager-console ondersteunt nu prompts via de $host.ui.Prompt en $host.ui.PromptForChoice opdrachten.
• Pakketbronnamen: het opgeven van de naam van een pakketbron wordt ondersteund bij het opgeven van een pakketbron met behulp van de -Source vlag.

Verbeteringen in de opdrachtregel nuget.exe

• Aangepaste NuGet-opdrachten: nuget.exe is uitbreidbaar via aangepaste opdrachten met behulp van MEF.
• Eenvoudiger de werkstroom voor het maken van symbolenpakketten: de -Symbols vlag kan worden toegepast op een normale, op conventie gebaseerde mapstructuur die een symbolenpakket maakt door alleen de bron en .pdb bestanden in de map op te geven.
• Meerdere bronnen opgeven: de NuGet install opdracht ondersteunt het opgeven van meerdere bronnen met behulp van puntkomma's als scheidingsteken of door meerdere keren op te -Source geven.
• Ondersteuning voor proxyverificatie: NuGet 1.4 voegt ondersteuning toe voor het vragen om gebruikersreferenties bij het gebruik van NuGet achter een proxy waarvoor verificatie is vereist.
• nuget.exe Breaking Change bijwerken: de parameter -Self is nu vereist voor nuget.exe om zichzelf bij te werken. nuget.exe Update neemt nu een pad naar het packages.config bestand en probeert pakketten bij te werken. Houd er rekening mee dat deze update beperkt is omdat dit niet het volgende is: ** Bijwerken, toevoegen, verwijderen van inhoud in het projectbestand. ** Voer PowerShell-scripts uit binnen het pakket.

NuGet Server-ondersteuning voor pushpakketten met behulp van nuget.exe

NuGet bevat een eenvoudige manier om een lichtgewicht NuGet-opslagplaats op internet te hosten via het NuGet.Server NuGet-pakket. Met NuGet 1.4 biedt de lichtgewicht server ondersteuning voor het pushen en verwijderen van pakketten met behulp van nuget.exe. De nieuwste versie van NuGet.Server voegt een nieuwe appSetting, genaamd apiKey, toe. Wanneer de sleutel wordt weggelaten of leeg blijft, wordt het pushen van pakketten naar de feed uitgeschakeld. Als u de apiKey instelt op een waarde (idealiter een sterk wachtwoord), kunt u pakketten pushen met behulp van nuget.exe.

<appSettings>
    <!-- Set the value here to allow people to push/delete packages from the server.
            NOTE: This is a shared key (password) for all users. -->
    <add key="apiKey" value="" />
</appSettings>

Ondersteuning voor Windows Phone Tools Mango Edition

NuGet wordt nu ondersteund in de release-kandidaatversie van Windows Phone Tools for Mango. Op dit moment heeft Windows Phone Tools geen ondersteuning voor Visual Studio Extension Manager, dus om NuGet voor Windows Phone Tools te installeren, moet u de VSIX mogelijk handmatig downloaden en uitvoeren.

Voer de volgende opdracht uit om NuGet voor Windows Phone Tools te verwijderen.

vsixinstaller.exe /uninstall:NuPackToolsVsix.Microsoft.67e54e40-0ae3-42c5-a949-fddf5739e7a5

Oplossingen voor bugs

NuGet 1.4 had in totaal 88 werkitems opgelost. 71 van deze zijn gemarkeerd als bugs.

Voor een volledige lijst met werkitems die zijn opgelost in NuGet 1.4, bekijkt u de [NuGet Issue Tracker for this release](http://nuget.codeplex.com/workitem/list/advanced?keyword=&status=All&type=All&priority=All&release=NuGet%201.4&assignedTo=All&component=All&sortField=LastUpdatedDate&sortDirection=Descending&page=0).

Opgeloste fouten die de moeite waard zijn om te noteren:

• [Issue 603](http://nuget.codeplex.com/workitem/603): Pakketafhankelijkheden in verschillende repositories worden correct opgelost wanneer een specifieke pakketbron wordt opgegeven.
• [Issue 1036](http://nuget.codeplex.com/workitem/1036): Het toevoegen NuGet Pack SomeProject.csproj aan een gebeurtenis na de build veroorzaakt geen oneindige lus meer.
• [Issue 961](http://nuget.codeplex.com/workitem/961): -Source vlag ondersteunt relatieve paden.

NuGet 1.4-Update

Kort na de release van NuGet 1.4 hebben we een aantal problemen gevonden die belangrijk waren om op te lossen. Het specifieke versienummer van deze update naar 1.4 is 1.4.20615.9020.

Oplossingen voor bugs

• [Issue 1220](http://nuget.codeplex.com/workitem/1220): Update-Package wordt niet uitgevoerd install.ps1/uninstall.ps1 in alle projecten wanneer er meer dan één project is
• [Issue 1156](http://nuget.codeplex.com/workitem/1156): Package Manager Consol is vastgelopen op W2K3/XP (wanneer Powershell 2 niet is geïnstalleerd)