Co to jest format pliku WSP?
.wsp to SharePoint Solution Package - plik wdrożeniowy używany do instalowania niestandardowych funkcji, zestawów i szablonów w środowiskach lokalnych Microsoft SharePoint. Pomimo rozszerzenia .wsp, plik jest standardowym archiwum Microsoft Cabinet (.cab), identyfikowalnym po „magic bytes” MSCF (4D 53 43 46) pod offsetem 0. Zmiana nazwy .wsp na .cab pozwala na jego sprawdzenie w Eksploratorze Windows lub programie 7-Zip.
Wewnątrz archiwum plik manifest.xml pełni rolę głównego deskryptora, deklarując tożsamość rozwiązania, funkcje, zestawy .NET (DLL), szablony stron ASPX/ASCX, JavaScript, CSS oraz zasoby graficzne. Wdrażanie odbywa się za pomocą PowerShell (Add-SPSolution, a następnie Install-SPSolution) lub Administracji centralnej SharePoint - nie poprzez bezpośrednie otwarcie pliku.
Istnieją dwa typy rozwiązań: farm solutions (rozwiązania farmy) działają z pełnym zaufaniem i mają nieograniczony dostęp do serwera; sandbox solutions (rozwiązania piaskownicy) działały w ograniczonym procesie, są przestarzałe od wersji SharePoint 2013 i nieobsługiwane w SharePoint Online. Dla SharePoint Online i Microsoft 365 nowoczesnym następcą jest format pakietu SharePoint Framework .sppkg.
Visual Studio generuje pliki .wsp automatycznie podczas budowania projektów SharePoint. Wersja schematu rozwiązania zadeklarowana w manifest.xml jest przeznaczona dla wersji od SharePoint 2007 do SharePoint Subscription Edition. Zestawy .NET wewnątrz pakietu posiadają podpisy Strong Name w celu weryfikacji integralności.
Bezpieczeństwo
RYZYKO: MEDIUMPlik WSP (rozwiązanie farmy) to pakiet pełnego zaufania, który wdraża skompilowane zestawy .NET na serwerze SharePoint. Złośliwy plik .wsp może zawierać kod uruchamiany z tożsamością puli aplikacji (często konto usługi domenowej). Nigdy nie wdrażaj pliku WSP z niezaufanego źródła bez sprawdzenia manifest.xml i zawartości DLL (najpierw użyj 7-Zip do inspekcji, a następnie sprawdź zestawy dekompilatorem, np. ILSpy). Rozwiązania piaskownicy (sandbox) niosą mniejsze ryzyko ze względu na izolowany proces, ale są przestarzałe. SharePoint Online nie akceptuje plików WSP - jedynie zweryfikowane .sppkg poprzez katalog aplikacji.
Szczegóły formatu
w pigułce- Microsoft Visual C++ Workspace Info File - Bardzo stare wersje Visual C++ (sprzed lat 2000.) używały .wsp dla plików stanu obszaru roboczego; obecnie format przestarzały i rzadko spotykany.
- WordPerfect Macro/Workspace file - Starsze wersje WordPerfect używały .wsp do przechowywania obszarów roboczych lub makr; format archiwalny.
Programy otwierające pliki WSP
Szczegóły techniczne
specyfikacja| Format kontenera | Microsoft Cabinet (CAB) - magic bytes 4D 53 43 46 (MSCF) pod offsetem 0 |
| Kolejność bajtów | Little-endian (standard formatu CAB) |
| Kompresja | MS-ZIP (oparta na DEFLATE) lub LZX dla poszczególnych plików wewnątrz CAB |
| Główny deskryptor | manifest.xml - plik XML deklarujący ID rozwiązania, funkcje, ścieżki zestawów .NET i mapowania plików |
| Integralność zestawów | Pliki DLL .NET posiadają podpisy Strong Name (token klucza publicznego) w celu weryfikacji integralności |
| Typy rozwiązań | Rozwiązanie farmy (pełne zaufanie, pełny dostęp do serwera) vs. rozwiązanie piaskownicy (ograniczony proces, przestarzałe w SharePoint 2019 i nieobsługiwane w SharePoint Online) |
| Polecenia wdrożeniowe | Add-SPSolution (rejestruje w farmie), a następnie Install-SPSolution (aktywuje wdrożenie) poprzez SharePoint Management Shell |
| Wersja schematu rozwiązania | Deklarowana w manifest.xml; przeznaczona dla SharePoint 2007, 2010, 2013, 2016, 2019 lub Subscription Edition |
| Typowa zawartość | manifest.xml, pliki DLL .NET, pliki definicji Feature XML, szablony ASPX/ASCX, zasoby JS/CSS/obrazy |
| Typowy rozmiar pliku | 10 KB - 500 MB (od małej funkcji do dużego rozwiązania farmy dla przedsiębiorstw) |
| Narzędzie programistyczne | Typ projektu Microsoft Visual Studio SharePoint generuje pliki .wsp poprzez swój system pakowania |
| Nowoczesny następca | .sppkg (pakiet SharePoint Framework) dla SharePoint Online i Microsoft 365 |
| Typ MIME | application/octet-stream (brak zarejestrowanego typu MIME; zawartość CAB czasem identyfikowana jako application/x-cab) |
| Wydano | Windows SharePoint Services 3.0 / SharePoint 2007 |
| Najnowsza wersja | SharePoint Server Subscription Edition (2024) / SharePoint Online |
| Specyfikacja | learn.microsoft.com |
Konwersje WSP
Pytania i odpowiedzi społeczności
pytania użytkownikówBrak pytań - bądź pierwszą osobą, która zapyta o pliki WSP.