icu.net
2.10.0
See the version list below for details.
dotnet add package icu.net --version 2.10.0
NuGet\Install-Package icu.net -Version 2.10.0
<PackageReference Include="icu.net" Version="2.10.0" />
paket add icu.net --version 2.10.0
#r "nuget: icu.net, 2.10.0"
// Install icu.net as a Cake Addin #addin nuget:?package=icu.net&version=2.10.0 // Install icu.net as a Cake Tool #tool nuget:?package=icu.net&version=2.10.0
icu.net
Overview
icu-dotnet is the C# wrapper for a subset of ICU.
ICU is a mature, widely used set of C/C++ and Java libraries providing Unicode and Globalization support for software applications. ICU is widely portable and gives applications the same results on all platforms and between C/C++ and Java software.
Usage
This library provides .NET classes and methods for (a subset of) the ICU C API. Please refer to the ICU API documentation. In icu.net you'll find classes that correspond to the C++ classes of ICU4C.
Although not strictly required it is recommended to call Icu.Wrapper.Init()
at the start of
the application. This will allow to use icu.net from multiple threads
(c.f. ICU Initialization and Termination).
Similarly, it might be beneficial to call Icu.Wrapper.Cleanup()
before exiting.
Sample code:
static class Program
{
public static void Main(string[] args)
{
Icu.Wrapper.Init();
// Will output "NFC form of XA\u0308bc is XÄbc"
Console.WriteLine($"NFC form of XA\\u0308bc is {Icu.Normalizer.Normalize("XA\u0308bc",
Icu.Normalizer.UNormalizationMode.UNORM_NFC)}");
Icu.Wrapper.Cleanup();
}
}
Building
To build the current version of icu-dotnet you'll need .NET 8.0 installed.
icu-dotnet can be built from the command line as well as Visual Studio or JetBrains Rider.
Running Unit Tests
You can build and run the unit tests by running:
dotnet test source/icu.net.sln
or, if wanting to run tests on just one specific .net version (v8.0 in this example):
dotnet test source/icu.net.sln -p:TargetFramework=net8.0
Linux and macOS
It is important for icu.net.dll.config
to be bundled with your application when not
running on Windows. If it doesn't copy reliably to the output directory, you might find
adding something like the following to your csproj
file will resolve the issue. Note
that the version number in the path must match the version number of icu.net that is
referenced in the project.
<ItemGroup>
<None Update="$(NuGetPackageRoot)\icu.net\2.9.0\contentFiles\any\any\icu.net.dll.config">
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
</None>
</ItemGroup>
Docker
icu-dotnet depends on libc dynamic libraries at run time. If running within Docker, you may need to install them, for example:
FROM mcr.microsoft.com/dotnet/aspnet:3.1
# Install system dependencies.
RUN apt-get update \
&& apt-get install -y \
# icu.net dependency: libdl.so
libc6-dev \
&& rm -rf /var/lib/apt/lists/*
...
ICU versions
Linux
icu-dotnet links with any installed version of ICU shared objects. It is recommended to install the version provided by the distribution. As of 2016, Ubuntu Trusty uses version ICU 52 and Ubuntu Xenial 55.
If the version provided by the Linux distribution doesn't match your needs, Microsoft's ICU package includes builds for Linux.
Windows
Rather than using the full version of ICU (which can be ~25 MB), a custom minimum build can be used. It can be installed by the Icu4c.Win.Min nuget package. The full version of ICU is also available as Icu4c.Win.Full.Lib and Icu4c.Win.Full.Bin.
Microsoft also makes the full version available as Microsoft.ICU.ICU4C.Runtime.
What's in the minimum build
- Characters
- ErrorCodes
- Locale
- Normalizer
- Rules-based Collator
- Unicode set to pattern conversions
macOS
macOS doesn't come preinstalled with all the normal icu4c libraries. They must be installed separately. One option is to use MacPorts. The icu package on MacPorts has the icu4c libraries needed for icu.net to run properly.
If the icu4c libraries are not installed in a directory that is in the system path or your application directory, you will need to set an environment variable for the OS to find them. For example:
export DYLD_FALLBACK_LIBRARY_PATH="$HOME/lib:/usr/local/lib:/usr/lib:/opt/local/lib"
If you need to set environment variables like the above, consider adding them to
your .zprofile
so you don't have to remember to do it manually.
Troubleshooting
- make sure you added the nuget package
icu.net
and have native ICU libraries available. - the binaries of the nuget packages need to be copied to your output directory.
For
icu.net
this happens by the assembly reference that the package adds to your project. The binaries ofIcu4c.Win.Min
are only relevant on Windows. They will get copied by theIcu4c.Win.Min.targets
file included in the nuget package.
On Windows, the package installer should have added an import to the *.csproj
file similar
to the following:
<Import Project="..\..\packages\Icu4c.Win.Min.54.1.31\build\Icu4c.Win.Min.targets"
Condition="Exists('..\..\packages\Icu4c.Win.Min.54.1.31\build\Icu4c.Win.Min.targets')" />
Contributing
We love contributions! The library mainly contains the functionality we need for our products. If you miss something that is part of ICU4C but not yet wrapped in icu.net, add it and create a pull request.
If you find a bug - create an issue on GitHub, then preferably fix it and create a pull request!
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.6 is compatible. netstandard2.0 was computed. netstandard2.1 was computed. |
.NET Framework | net40 is compatible. net403 was computed. net45 was computed. net451 is compatible. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETFramework 4.0
- System.ValueTuple (>= 4.5.0)
-
.NETFramework 4.5.1
- Microsoft.Extensions.DependencyModel (>= 2.0.4)
- System.ValueTuple (>= 4.5.0)
-
.NETStandard 1.6
- Microsoft.Extensions.DependencyModel (>= 2.0.4)
- NETStandard.Library (>= 1.6.1)
- System.Diagnostics.TraceSource (>= 4.3.0)
- System.Runtime.InteropServices.RuntimeInformation (>= 4.3.0)
- System.ValueTuple (>= 4.4.0)
-
net8.0
- Microsoft.Extensions.DependencyModel (>= 2.0.4)
- System.ValueTuple (>= 4.5.0)
NuGet packages (8)
Showing the top 5 NuGet packages that depend on icu.net:
Package | Downloads |
---|---|
SIL.WritingSystems
SIL.WritingSystems contains classes for managing and persisting writing systems using the Locale Data Markup Language (LDML) format. This library also contains classes for processing IETF (BCP-47) language tags and accessing the SIL Locale Data Repository (SLDR). |
|
ParatextData
Dll for use by third party applications needing to access Paratext's data. Compatible with SIL.Lib 12.0.x (required). Backwards compatible with data from Paratext 8.0 and 9.x. NOTE: This version of ParatextData is built using a AnyCPU configuration, but certain projects will not open correctly when run as 32-bit because of dependencies on native 64-bit libraries. |
|
SIL.Windows.Forms.Keyboarding
The SIL.Windows.Forms.Keyboarding library provides cross-platform functionality for keyboard selection and switching in Windows Forms applications. Currently, this library supports system and Keyman keyboards on Windows, and X keyboard extension (XKB) and Intelligent Input Bus (IBus) keyboards on Linux. |
|
SIL.WritingSystems.Tests
Unit tests for SIL.WritingSystems |
|
GlyssenEngine
Library for working with Glyssen project data, including scripts and casting |
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on icu.net:
Repository | Stars |
---|---|
RWS/Sdl-Community
This is the place where we develop and maintain most of SDL's plugins for Trados Studio. If you want to help us or just looking for some examples this is the perfect place.
|
Version | Downloads | Last updated | |
---|---|---|---|
3.0.0 | 512 | 11/21/2024 | |
3.0.0-beta.297 | 2,118 | 8/29/2024 | |
3.0.0-beta.296 | 5,765 | 8/1/2024 | |
2.10.1-beta.5 | 6,041 | 7/4/2024 | |
2.10.1-beta.4 | 1,563 | 6/26/2024 | |
2.10.0 | 7,174 | 6/17/2024 | |
2.9.0 | 74,276 | 2/15/2023 | |
2.8.1 | 94,603 | 7/8/2022 | |
2.8.0 | 2,562 | 6/24/2022 | |
2.7.1 | 69,246 | 3/4/2021 | |
2.6.0 | 224,316 | 9/27/2019 | |
2.5.4 | 44,414 | 1/9/2019 | |
2.5.3 | 1,750 | 12/17/2018 | |
2.5.2 | 8,242 | 12/10/2018 | |
2.5.0 | 2,773 | 11/27/2018 | |
2.4.0 | 1,879 | 10/24/2018 | |
2.3.4 | 9,044 | 8/27/2018 | |
2.3.3 | 3,641 | 7/3/2018 | |
2.3.2 | 21,219 | 3/14/2018 | |
2.3.0 | 5,127 | 2/28/2018 | |
2.2.0 | 2,632 | 9/29/2017 | |
2.1.0 | 2,509 | 3/17/2017 | |
2.0.1 | 14,747 | 12/19/2016 |
Changes since version 2.9.0
Added:
- Support macOS
Changed:
- Move .NET 6.0 builds to .NET 8.0
- Update some GitHub Actions versions
See full changelog at https://github.com/sillsdev/icu-dotnet/blob/master/CHANGELOG.md.