See also ReadMe_linux.txt and ReadMe_windows.txt.

These are the main encoding converters used by Fieldworks and SIL Converters to transform language data. The converters are mainly used to change character encoding. Encoding converters in this package include IcuRegEx, IcuTransliterator, TecKit, Perl, Python, and CC

The NuGet package https://www.nuget.org/packages/Encoding-Converters-Core/ is built from this repository.

In Ubuntu Linux,

Add packages.sil.org repository by following instructions at https://packages.sil.org/ .

Install build dependencies.

sudo apt-get install automake g++ python-dev libicu-dev mono5-sil icu-dev-fw libteckit-dev

(. environ && ./autogen.sh && make)

(. environ && make)

# Optionally use non-global common dir
export EC_COMMON_APPLICATION_DATA_PATH="$(pwd)/ec-common"
export MONO_REGISTRY_PATH="${EC_COMMON_APPLICATION_DATA_PATH}/registry"

# Copy RunTests.exe to directory with the other DLLs to be found.
(cp -a src/RunTests/bin/x64/Debug/RunTests.exe output/x64/Debug/ &&
  . environ && mono output/x64/Debug/RunTests.exe)

The installer can be somewhat tested by doing the following.

rm -rf test_install &&
  (source environ &&
    ./autogen.sh &&
    DESTDIR="$(pwd)/test_install" make install)

In Windows,

1. Open EncConverters 2015.sln in Visual Studio Community 2015.
2. Choose Build > Build Solution.

To build new packages:

1. Run a release build for both 32 and 64bit
2. Increase the version in Package.nuspec
3. Run 'nuget.exe pack' from the root directory of the repository

See this webpage for hints on using the EncConverters core in your application