Bump version

Update IO and Serialization
Add explicit compatibility notes section
2026-02-04 21:30:10 +00:00 · 2024-05-07 08:57:17 -04:00 · 2024-05-07 05:31:42 -04:00 · 2024-05-06 22:40:39 -04:00 · 2024-05-06 22:30:58 -04:00 · 2024-05-06 21:59:37 -04:00
3 changed files with 27 additions and 12 deletions
--- a/BinaryObjectScanner/BinaryObjectScanner.csproj
+++ b/BinaryObjectScanner/BinaryObjectScanner.csproj
@@ -11,7 +11,7 @@
    <Nullable>enable</Nullable>
    <SuppressTfmSupportBuildWarnings>true</SuppressTfmSupportBuildWarnings>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
-    <Version>3.1.8</Version>
+    <Version>3.1.10</Version>
    <!-- Mostly added due to external libraries -->
    <WarningsNotAsErrors>CS0162;CS0612;CS8600;CS8601;CS8602;CS8603;CS8604;CS8605;CS8618;CS8625;CS8634;CS8765;IL3000;NU5100</WarningsNotAsErrors>
  
@@ -75,7 +75,7 @@
    <PackageReference Include="OpenMcdf" Version="2.3.1" />
  </ItemGroup>
  <ItemGroup Condition="!$(TargetFramework.StartsWith(`net2`)) AND !$(TargetFramework.StartsWith(`net3`)) AND !$(TargetFramework.StartsWith(`net40`)) AND !$(TargetFramework.StartsWith(`net452`))">
-    <PackageReference Include="SharpCompress" Version="0.37.0" />
+    <PackageReference Include="SharpCompress" Version="0.37.2" />
    <PackageReference Include="System.Text.Encoding.CodePages" Version="8.0.0" />
  </ItemGroup>
  <ItemGroup Condition="$(TargetFramework.StartsWith(`net4`)) AND !$(TargetFramework.StartsWith(`net40`))">
@@ -85,10 +85,10 @@
  <ItemGroup>
    <PackageReference Include="SabreTools.Compression" Version="0.5.1" />
    <PackageReference Include="SabreTools.Hashing" Version="1.2.0" />
-    <PackageReference Include="SabreTools.IO" Version="1.4.5" />
+    <PackageReference Include="SabreTools.IO" Version="1.4.10" />
    <PackageReference Include="SabreTools.Matching" Version="1.3.1" />
    <PackageReference Include="SabreTools.Models" Version="1.4.5" />
-    <PackageReference Include="SabreTools.Serialization" Version="1.6.0" />
+    <PackageReference Include="SabreTools.Serialization" Version="1.6.3" />
    <PackageReference Include="UnshieldSharp" Version="1.8.2" />
    <PackageReference Include="WiseUnpacker" Version="1.4.2" />
  </ItemGroup>
--- a/README.md
+++ b/README.md
@@ -9,16 +9,16 @@ C# protection, packer, and archive scanning library. This currently compiles as
 The following non-project libraries (or ports thereof) are used for file handling:

 - [LessIO](https://github.com/activescott/LessIO) - Used by libmspack4n for IO handling
- [libmspack4n](https://github.com/activescott/libmspack4n) MS-CAB extraction [Unused in .NET Frawework 2.0/3.5/4.0 and non-Windows builds due to Windows-specific libraries]
- [openmcdf](https://github.com/ironfede/openmcdf) - MSI extraction
+- [libmspack4n](https://github.com/activescott/libmspack4n) MS-CAB extraction [Unused in .NET Frawework 2.0/3.5/4.0, non-Windows, and non-x86 builds due to Windows-specific libraries]
+- [OpenMcdf](https://github.com/ironfede/openmcdf) - MSI extraction
 - [SharpCompress](https://github.com/adamhathcock/sharpcompress) - Common archive format extraction
- [StormLibSharp](https://github.com/robpaveza/stormlibsharp) - MoPaQ extraction [Unused in .NET Frawework 2.0/3.5/4.0 and non-Windows builds due to Windows-specific libraries]
+- [StormLibSharp](https://github.com/robpaveza/stormlibsharp) - MoPaQ extraction [Unused in .NET Frawework 2.0/3.5/4.0, non-Windows, and non-x86  builds due to Windows-specific libraries]
 - [UnshieldSharp](https://github.com/mnadareski/UnshieldSharp) - InstallShield CAB extraction
 - [WiseUnpacker](https://github.com/mnadareski/WiseUnpacker) - Wise Installer extraction

 The following projects have influenced this library:

- [BurnOut](http://burnout.sourceforge.net/) - Project that this library was initially based on. The only thing left from that original port is in the name of the library. This project is fully unaffiliated with the original BurnOut and its authors.
+- [BurnOut](http://burnout.sourceforge.net/) - Project that this library was initially based on. This project is fully unaffiliated with the original BurnOut and its authors.
 - [HLLibSharp](https://github.com/mnadareski/HLLibSharp) - Documentation around Valve package handling, including extraction.
 - [libbdplus](https://www.videolan.org/developers/libbdplus.html) - Documentation around the BD+ SVM files.
 - [libmspack](https://github.com/kyz/libmspack) - Documentation around the MS-CAB format and associated compression methods.
@@ -26,6 +26,21 @@ The following projects have influenced this library:

 Please visit our sibling project, [DRML](https://github.com/TheRogueArchivist/DRML), the DRM Library for a more in-depth look at some of the protections detected.

+## Compatibility Notes
+
+Binary Object Scanner strives to have both full compatibility for scanning across .NET versions as well as across OSes. Unfortunately, this is not always the case. Please see the below list for known compatibility issues.
+
+- **7-zip archive** - Extraction is only supported on .NET Framework 4.6.2 and higher due to `SharpCompress` support limitations
+- **bzip2 archive** - Extraction is only supported on .NET Framework 4.6.2 and higher due to `SharpCompress` support limitations
+- **gzip archive** - Extraction is only supported on .NET Framework 4.6.2 and higher due to `SharpCompress` support limitations
+- **MS-CAB** - Extraction is only supported in Windows x86 builds running .NET Framework 4.5.2 and higher due to native DLL requirements
+- **MSI** - Extraction is only supported on .NET Framework 4.0 and higher due to `OpenMcdf` support limitations
+- **MoPaQ** - Extraction is only supported in Windows x86 builds running .NET Framework 4.5.2 and higher due to native DLL requirements
+- **PKZIP and derived files (ZIP, etc.)** - Extraction is only supported on .NET Framework 4.6.2 and higher
+- **RAR archive** - Extraction is only supported on .NET Framework 4.6.2 and higher due to `SharpCompress` support limitations
+- **Tape archive** - Extraction is only supported on .NET Framework 4.6.2 and higher due to `SharpCompress` support limitations
+- **xz archive** - Extraction is only supported on .NET Framework 4.6.2 and higher due to `SharpCompress` support limitations
+
 ## Protections Detected

 Below is a list of protections detected by BinaryObjectScanner. The two columns explain what sort of checks are performed to determine how the protection is detected. Generally speaking, it's better to have a content check than a path check.
@@ -187,9 +202,9 @@ Below is a list of container formats that are supported in some way:
 | InstallShield CAB | Yes | Yes | Yes | Via `UnshieldSharp` |
 | Linear Executable | No | No | No | Skeleton only |
 | Link Data Security encrypted file | No | Yes | No | |
-| Microsoft cabinet file | Yes | Yes | Yes | |
+| Microsoft cabinet file | Yes | Yes | Yes* | Via `libmspack4n`, Windows x86 only, .NET Framework 4.5.2 and above |
 | Microsoft LZ-compressed files | No | Yes | Yes | |
-| MoPaQ game data archive (MPQ) | No | Yes | Yes | Via `StormLibSharp` |
+| MoPaQ game data archive (MPQ) | No | Yes | Yes* | Via `StormLibSharp`, Windows x86 only, .NET Framework 4.5.2 and above |
 | MS-DOS Executable | Yes | Yes | No | Incomplete |
 | New Exectuable | Yes | Yes | No | Incomplete |
 | Nintendo 3DS cart image | Yes | Yes | No | |
--- a/Test/Test.csproj
+++ b/Test/Test.csproj
@@ -28,10 +28,10 @@

  <ItemGroup>
    <PackageReference Include="SabreTools.Compression" Version="0.5.1" />
-    <PackageReference Include="SabreTools.IO" Version="1.4.5" />
+    <PackageReference Include="SabreTools.IO" Version="1.4.10" />
    <PackageReference Include="SabreTools.Matching" Version="1.3.1" />
    <PackageReference Include="SabreTools.Models" Version="1.4.5" />
-    <PackageReference Include="SabreTools.Serialization" Version="1.6.0" />
+    <PackageReference Include="SabreTools.Serialization" Version="1.6.3" />
    <PackageReference Include="UnshieldSharp" Version="1.8.2" />
  </ItemGroup>
Author	SHA1	Message	Date
Matt Nadareski	7432100139	Bump version	2024-05-07 08:57:17 -04:00
Matt Nadareski	29fabb44eb	Update IO and Serialization	2024-05-07 05:31:42 -04:00
Matt Nadareski	ad776d4189	Add explicit compatibility notes section	2024-05-06 22:40:39 -04:00
Matt Nadareski	4cf12c76a8	Update IO and Serialization	2024-05-06 22:30:58 -04:00
Matt Nadareski	39185f5ddd	Remove now-irrelevant note	2024-05-06 21:59:37 -04:00
Matt Nadareski	03477327c4	Clearer in another place	2024-05-06 21:59:10 -04:00
Matt Nadareski	29fa0d1ac7	Clarify support	2024-05-06 21:54:45 -04:00
Matt Nadareski	7eca23a7f3	Bump version	2024-04-28 19:51:22 -04:00
Matt Nadareski	f0c90bb332	Update packages for critical issues	2024-04-28 19:50:53 -04:00