icu.net 3.0.2

• .NETFramework 4.0

  • System.ValueTuple (>= 4.5.0)

• .NETFramework 4.5.1

  • Microsoft.Extensions.DependencyModel (>= 2.0.4)
  • System.ValueTuple (>= 4.5.0)

• .NETStandard 2.0

  • Microsoft.Extensions.DependencyModel (>= 2.0.4)
  • System.ValueTuple (>= 4.5.0)

• net8.0

  • Microsoft.Extensions.DependencyModel (>= 2.0.4)
  • System.ValueTuple (>= 4.5.0)

Changes since version 3.0.1

Added:
- In Character class, added all enums from Unicode's uchar.h that were missing:
 UBidiPairedBracketType, UBlockCode, UEastAsianWidth, UPropertyNameChoice, UJoiningType,
 UJoiningGroup, UGraphemeClusterBreak, UWordBreakValues, USentenceBreak, ULineBreak,
 UHangulSyllableType, UIndicPositionalCategory, UIndicSyllabicCategory, UIndicConjunctBreak,
 UVerticalOrientation, UIdentifierStatus, UIdentifierType.

Fixed:
- Fixed macOS crash at process exit (.NET 6+): `u_cleanup()` and `NativeLibrary.Free` are now
 skipped on macOS so dyld does not fire ICU's destructor against already-cleaned state. Also
 fixed an independent ordering bug on all platforms: `u_cleanup()` was previously called after
 `ResetIcuVersionInfo()`, causing the runtime to look up the nonexistent symbol `u_cleanup_0`
 and silently skip the call.
- Fixed ICU library discovery on macOS: `LocateIcuLibrary` now falls back to Homebrew
 (`/opt/homebrew/opt/icu4c/lib` on Apple Silicon, `/usr/local/opt/icu4c/lib` on Intel) and
 MacPorts (`/opt/local/lib`) when no bundled ICU is found. Bundled ICU (in the assembly
 directory or `runtimes/` subdirectories) is always preferred over system installations.
- Removed no-op `LD_LIBRARY_PATH` manipulation on macOS. (Changing it to the mac-specific
 `DYLD_LIBRARY_PATH` would also be a no-op, because SIP strips all `DYLD_*` variables from
 protected processes at launch, so setting it at runtime has no effect.)
- Fixed `umsg_open` `locale` parameter marshaling from Unicode to ANSI, correcting ICU message
 formatting on macOS where the locale string was being passed as wide characters.
- Fixed `SafeEnumeratorHandle` and `Transliterator.SafeTransliteratorHandle` finalizers to
 silently swallow exceptions during .NET shutdown, when ICU may no longer be accessible.
- Fixed test teardown instability on macOS: `NativeMethodsHelperTests` now deletes dummy ICU
 files before resetting version state (preventing "Can't load ICU library (version 90)" failures
 in subsequent tests); `IcuWrapperTests` now skips `ConfineIcuVersions` on macOS, where
 `NativeLibrary.Free` is omitted so the library stays resident and version constraints must not
 be reset against it.
- Fixed `IsInitialized` not being reset on cleanup paths that skip `u_cleanup()`: it was a side
 effect of `u_cleanup()` rather than an explicit step, so any code path that skipped
 `u_cleanup()` (e.g. macOS on .NET 6+) would leave `IsInitialized = true` after cleanup.
 `IsInitialized = false` is now set unconditionally in `Cleanup()` and removed from `u_cleanup()`.
- Fixed `MessageFormatter.Format` crashing on ARM64 (.NET only): it now throws
 `PlatformNotSupportedException` instead. The AAPCS64 calling convention passes variadic
 float arguments through integer registers, incompatible with .NET's fixed-slot P/Invoke
 marshaling of the variadic C function `umsg_format`.
- Fixed `Transliterator.GetDisplayName` and `GetIdsAndNames` on ARM64: both now catch the
 `PlatformNotSupportedException` from `umsg_format` and fall back to the English
 "source to target" display name form. On non-ARM64 Unix with ICU 74+, where a calling-convention
 mismatch produces empty output rather than a crash, the existing `IsNullOrEmpty` fallback now
 covers macOS in addition to Linux.
- Fixed `Transliterator.GetDisplayName` returning empty display names on Linux ICU 74+.
 `umsg_format` is a variadic C function; on Linux ICU 74+ a calling-convention mismatch
 causes the `double` argument to be read as 0, producing empty output from the
 `TransliteratorNamePattern` choice format. The method now falls back to constructing
 the display name directly from the localized source and target script names.
- Fixed regex patterns in `NativeMethodsHelper` for Linux (`libicu*.so.*`) and macOS
 (`libicu*.dylib`): unescaped `.` matched any character instead of a literal dot.
- Fixed `NativeMethodsHelper` combined regex: `$` end-anchor now applies to all three
 platform alternatives, not only the macOS branch.
- Fixed `NativeMethodsHelper` regex patch-version segments: `(\.[0-9])*` changed to
 `(\.[0-9]+)*` to allow multi-digit patch components.
- Fixed `TimeZoneTests.GetTZVersionTest`: version pattern is now anchored (`^[0-9]{4}[a-z]$`)
 so it validates the full string rather than a substring.

Deprecated:
- In Character class, added \[Obsolete\] attribute to enum members UDecompositionType.COUNT and
 UNumericType.COUNT.

See full changelog at https://github.com/sillsdev/icu-dotnet/blob/master/CHANGELOG.md.