NUPKG File – What is .nupkg file and how to open it?

NUPKG (NuGet Package) є extension for files representing software packages created by NuGet, a package management system for Microsoft .NET. Ці пакети містять assemblies, PDB files, license information, та інші metadata необхідні для будівництва і розробки .NET applications.

Description

У файлі NUPKG є архівний формат, який використовується для розповсюдження packages software within .NET ecosystem. Це складений файл, який містить необхідний код, metadata, і залежність від компонента. NUPKG файли є спільним використанням для розповсюджених libraries, інструментів, та інших матеріалів, що розповсюджують функціональність .NET applications.

Key Features

NUPKG файли є розроблені для того, щоб бути портативними і доступними. Вони можуть бути легко перекладені і налаштовані за допомогою NuGet package manager, який є принциповим інструментом для .NET розробників. NuGet package manager застосовує процеси discovering, installing, updating software packages. NUPKG файли також support versioning, дозволяючи розробникам до трафіку і керування різними versions of the same package. Додатково, NUPKG файли можуть включати документацію, license information, і інші metadata, що helps developers understand і use the software package effectively.

Opening NUPKG Files with NuGet Package Manager

NuGet package files (.nupkg) є використаним для розповсюдження та налагодження пакетів в NuGet package manager ecosystem. Ці файли містять package's metadata, dependencies, and assemblies. До Open NUPKG файл, ви можете використовувати NuGet Package Manager, який є інструментом, що міститься в Visual Studio.

Щоб відкрити файл NUPKG у програмі NuGet Package Manager, натисніть на файл menu в Visual Studio і виберіть “Відкритий NuGet Package…” (або використовувати keyboard shortcut Ctrl+Q). У “Open Package” dialog box, browse to location of file NUPKG and select it.package's contents буде розповсюджений в NuGet Package Manager window, де ви можете побачити metadata, dependencies, and assemblies. Ви можете також налаштувати пакет за допомогою "Install" button.

Інші методи для Opening NUPKG Files

Крім того, ви можете відкрити файл NUPKG, використовуючи текст editor, так як записник або Visual Studio Code. Незважаючи на це, цей метод тільки дозволить вам побачити вміст package manifest файлу і він не забезпечує повну функціональність NuGet Package Manager. Якщо ви потрібні для встановлення або керування NuGet Packages, це буде переглянуто за допомогою NuGet Package Manager.

NuGet Package Structure

NUPKG файли є архівні файли, які містять contents of NuGet package. Вони є структурованими в конкретній мірі для забезпечення того, що всі необхідні відомості включаються для встановлення і використання пакета. File contains a manifest file (.nuspec), що описує package's metadata, such as name, version, authors, and dependencies. Це також включає в себе вміст файлів, які можуть включати assemblies (DLLs), configuration files, documentation, і інші ресурси. Складні файли є організованими в directory structure, що відображає package's namespace and assembly structure.

Package Management

NUPKG файли є використаними для управління залежностями в .NET applications. Розробники можуть бути легко завантажені, налагоджені, оновлені, і необладнані пакети, використовуючи NuGet Package Manager, які входять до Visual Studio і інших розробок навколишнього середовища. Використовуючи NUPKG файли, розробники можуть share and reuse code, libraries, і інші приналежності з іншими розробниками, сприятливим фастером і більше ефективним application development.

Manual Package Download

PowerShell Gallery supports downloading package з веб-сайту безпосередньо без використання PowerShellGet cmdlets. Ви можете завантажити будь-який пакет як NuGet пакет ( .nupkg ) файл, який ви можете скопіювати до внутрішньої репозиторії.

Manual package download is not intended as a replacement for Install-Module cmdlet. Downloading package doesn't install the module або script. Залежності не включаються в NuGet package downloaded. Ці наступні інструкції будуть виконані для референнції, якіприймаються тільки.

За допомогою manual download to acquire a package

Кожна сторінка має link для Manual Download, як показує:

To download manually, click on Download the raw nupkg файл. Копія пакету скопіюється до download folder for your browser with name ..nupkg .

У пакеті NuGet є ZIP архів з іншими файлами, що містять інформацію про вмісти в пакеті. Один браузер, як Internet Explorer, автоматично переміщує .nupkg file extension with .zip . Щоб розширити пакет, перенести файл .nupkg до .zip , якщо потрібно, потім виконати вмісту до локального folder.

A NuGet package file includes the following NuGet-specific elements що немає частини оригінального пакетного коду:

• A folder named _rels - contains a .rels file that lists the dependencies
• A folder named package - contains the NuGet-specific data
• A file named [Content_Types].xml - описані як extensions як PowerShellGet work with NuGet
• A file named .nuspec - contains the bulk of thedatadata

Installing PowerShell modules від NuGet package

Ці інструкції DO NOT give the same result as running Install-Module . Ці інструкції fulfill minimum requirements. Вони не встановлюються як заміна для Install-Module . Кілька кроків створені за допомогою Install-Module не включаються.

Theeasiest approach is to remove the NuGet-specific elements з folder. Removing the elements leaves the PowerShell code created by the package author. Для опису NuGet-specific elements, viz За допомогою manual download to acquire a package.

The steps are as follows:

1. Unblock Internet-downloaded NuGet пакет ( .nupkg ) файл, для прикладу використання Unblock-File -Path C:\Downloads\module.nupkg cmdlet.
2. Extract the contents of NuGet package to local folder.
3. Delete NuGet-specific elements з folder.
4. Rename the folder. The default folder name is usually. . У версії може бути включений -перезавершення, і якщо модуль є зафіксований як попередньої версії. Натисніть на folder на just module name. Для прикладу, azurerm.storage.5.0.4-preview becomes azurerm.storage .
5. Copy the folder to one of the folders в $env:PSModulePath value . $env:PSModulePath є semicolon-звільнений набор файлів в яких PowerShell повинен триматися для modules.

У manual manual download не входять будь-які dependencies, які вимагають module. Якщо пакет має відповідності, вони повинні бути налаштовані в системі для цього module до роботи коректно. PowerShell Gallery показує всі dependencies, які вимагають пакету.

Installing PowerShell scripts from a NuGet package

Ці інструкції DO NOT give the same result as running Install-Script . Ці інструкції fulfill minimum requirements. Вони не встановлюються для заміни для Install-Script .

Theeasiest approach is to extract the NuGet package, then use the script directly.

The steps are as follows:

1. Unblock Internet-downloaded NuGet пакет ( .nupkg ) файл, для прикладу використання Unblock-File -Path C:\Downloads\package.nupkg cmdlet.
2. Extract the contents of the NuGet package.
3. .PS1 файл в folder може бути використаний безпосередньо з цього місця.
4. Ви можете скористатися NuGet-specific elements в folder.

Для опису NuGet-specific elements, viz За допомогою manual download to acquire a package.

У manual manual download не входять будь-які dependencies, які вимагають module. Якщо пакет має відповідності, вони повинні бути налаштовані в системі для цього module до роботи коректно. PowerShell Gallery показує всі dependencies, які вимагають пакету.

Source для цього вмісту може бути зроблено на GitHub, де ви можете також створити і переглянути питання і пилюки. Для більшої інформації, будь-який contributor guide.