Что такое формат файла WSP?
.wsp - это пакет решения SharePoint, файл развертывания, используемый для установки пользовательских функций, сборок и шаблонов в локальных средах Microsoft SharePoint. Несмотря на расширение .wsp, файл является стандартным архивом Microsoft Cabinet (.cab), который можно идентифицировать по магическим байтам MSCF (4D 53 43 46) со смещением 0. Переименование .wsp в .cab позволяет просматривать его в Проводнике Windows или с помощью 7-Zip.
Внутри архива файл manifest.xml выступает в роли корневого дескриптора, объявляющего идентификатор решения, компоненты, сборки .NET (DLL), шаблоны страниц ASPX/ASCX, JavaScript, CSS и графические ресурсы. Развертывание осуществляется через PowerShell (Add-SPSolution, затем Install-SPSolution) или Центр администрирования SharePoint, а не путем прямого открытия файла.
Существует два типа решений: решения для фермы (farm solutions) запускаются с полным доверием и имеют неограниченный доступ к серверу; песочницы (sandbox solutions) работали в ограниченном процессе, признаны устаревшими начиная с SharePoint 2013 и не поддерживаются в SharePoint Online. Для SharePoint Online и Microsoft 365 современным преемником является формат пакетов SharePoint Framework - .sppkg.
Visual Studio автоматически генерирует файлы .wsp при сборке проектов SharePoint. Версия схемы решения, объявленная в manifest.xml, ориентирована на версии от SharePoint 2007 до SharePoint Subscription Edition. Сборки .NET внутри пакета имеют подписи Strong Name для проверки целостности.
Безопасность и защита
РИСК: MEDIUMWSP (решение фермы) - это пакет с полным доверием, который развертывает скомпилированные сборки .NET на сервере SharePoint. Вредоносный .wsp может содержать код, запускаемый от имени удостоверения пула приложений (часто это доменная сервисная учетная запись). Никогда не развертывайте WSP из ненадежных источников без предварительного изучения manifest.xml и содержимого DLL (сначала используйте 7-Zip для проверки, затем проверьте сборки с помощью декомпилятора, например ILSpy). Решения в песочнице менее рискованны из-за изолированного процесса, но они устарели. SharePoint Online не принимает файлы WSP - только проверенные .sppkg через каталог приложений.
Детали формата
в двух словах- Файл информации о рабочей области Microsoft Visual C++ - Очень старые версии Visual C++ (до 2000-х годов) использовали .wsp для файлов состояния рабочей области; фактически устарели и встречаются крайне редко.
- Файл макроса/рабочей области WordPerfect - Старые версии WordPerfect использовали .wsp для хранения рабочих областей или макросов; только устаревшие системы.
Программы, открывающие файлы WSP
Технические подробности
глубокая спецификация| Формат контейнера | Microsoft Cabinet (CAB) - магические байты 4D 53 43 46 (MSCF) со смещением 0 |
| Порядок байтов | Little-endian (стандарт формата CAB) |
| Сжатие | MS-ZIP (на базе DEFLATE) или LZX для каждого файла внутри CAB |
| Корневой дескриптор | manifest.xml - XML-файл, объявляющий ID решения, компоненты, пути к сборкам .NET и сопоставления файлов |
| Целостность сборок | DLL-библиотеки .NET имеют подпись Strong Name (токен открытого ключа) для проверки целостности |
| Типы решений | Решение фермы (полное доверие, полный доступ к серверу) или решение в песочнице (ограниченный процесс, устарело в SharePoint 2019 и не поддерживается в SharePoint Online) |
| Команды развертывания | Add-SPSolution (регистрация в ферме), затем Install-SPSolution (активация развертывания) через SharePoint Management Shell |
| Версия схемы решения | Объявляется в manifest.xml; ориентирована на SharePoint 2007, 2010, 2013, 2016, 2019 или Subscription Edition |
| Типичное содержимое | manifest.xml, DLL-библиотеки .NET, XML-файлы определений компонентов, шаблоны ASPX/ASCX, ресурсы JS/CSS/изображения |
| Типичный размер файла | от 10 КБ до 500 МБ (от небольшого компонента до крупного корпоративного решения фермы) |
| Инструмент разработки | Тип проекта Microsoft Visual Studio SharePoint генерирует файлы .wsp через свою систему упаковки |
| Современный преемник | .sppkg (пакет SharePoint Framework) для SharePoint Online и Microsoft 365 |
| MIME-тип | application/octet-stream (зарегистрированный MIME-тип отсутствует; содержимое CAB иногда идентифицируется как application/x-cab) |
| Выпущен | Windows SharePoint Services 3.0 / SharePoint 2007 |
| Последняя версия | SharePoint Server Subscription Edition (2024) / SharePoint Online |
| Спецификация | learn.microsoft.com |
Конвертации WSP
Вопросы и ответы сообщества
спрошено пользователямиВопросов пока нет - станьте первым, кто спросит о файлах WSP.