mirror of
https://github.com/oliverbooth/X10D
synced 2024-11-25 20:48:47 +00:00
69 lines
2.8 KiB
Markdown
69 lines
2.8 KiB
Markdown
# Migration from 3.x.x
|
|
|
|
X10D 4.0.0 is a major release that introduces breaking changes. This document will help you migrate your code from 3.x.x
|
|
to 4.0.0.
|
|
|
|
When a breaking change is mentioned, the compatibility mirrors that of the Microsoft documentation for .NET, which you
|
|
can find [here](https://learn.microsoft.com/en-us/dotnet/core/compatibility/categories).
|
|
|
|
## Removed APIs
|
|
|
|
### X10D.DSharpPlus library
|
|
|
|
The `X10D.DSharpPlus` library has been removed. This library was used to provide extension methods for the DSharpPlus
|
|
wrapper library. However, I have since moved to using a different library, and as such, I feel it is no longer in the
|
|
scope of X10D or in my best interest to maintain it. The library will remain available on NuGet until DSharpPlus release
|
|
5.0.0 as stable, and X10D.DSharpPlus will NOT be part of X10D 4.0.0. I'm sorry for any inconvenience this may cause.
|
|
|
|
### X10D.Unity library
|
|
|
|
The `X10D.Unity` library has been removed. This library was used to provide extension methods for the Unity API. Due to
|
|
game development politics, I no longer feel it in my best interest to continue development of the Unity package. The
|
|
library will remain on NuGet for the foreseeable future but will no longer be maintained. The `upm` branch of the Git
|
|
repository will remain available indefinitely also.
|
|
|
|
|
|
### `Endianness` enum
|
|
|
|
**Source incompatible change**
|
|
|
|
The `Endianness` enum was used to specify the endianness of data when reading or writing to a stream. This was causing
|
|
some clutter, and makes it harder to develop X10D, so it was removed. In its stead, any method which accepted an
|
|
`Endianness` parameter now has two overloads: one for big-endian, and one for little-endian. For example, the following
|
|
code:
|
|
|
|
```csharp
|
|
someStream.Write(12345, Endianness.BigEndian);
|
|
|
|
// or
|
|
|
|
Span<byte> buffer = stackalloc byte[4];
|
|
12345.TryWriteBytes(buffer, Endianness.BigEndian);
|
|
```
|
|
|
|
would now be written as:
|
|
|
|
```csharp
|
|
someStream.WriteBigEndian(12345);
|
|
|
|
// or
|
|
|
|
Span<byte> buffer = stackalloc byte[4];
|
|
12345.TryWriteLittleEndianBytes(buffer);
|
|
```
|
|
|
|
### `IEnumerable<T>.ConcatOne(T)` extension method
|
|
|
|
**Source incompatible change**
|
|
|
|
The `IEnumerable<T>.ConcatOne` extension method was used to concatenate a single item to an enumerable. At the time, I
|
|
was unaware of the `Enumerable.Append` method, which does the same thing. As such, `ConcatOne` has been removed. There
|
|
is no migration path for this, as the built in `Append` method from LINQ is a drop-in replacement.
|
|
|
|
## Exception Changes
|
|
|
|
**Source incompatible change**
|
|
|
|
If you were previously catching TypeInitializationException when calling `Stream.GetHash<>` or `Stream.TryWriteHash<>`,
|
|
you will now need to catch a ArgumentException instead. The justification for this change is that ArgumentException is
|
|
more general, and more easily understood by developers. |