README.md

libdigidocpp

• License: LGPL 2.1
• © Estonian Information System Authority
• Architecture of ID-software

Building

Ubuntu

1. Install dependencies

    sudo apt install cmake libxml-security-c-dev xsdcxx libssl-dev zlib1g-dev
   

   • doxygen - Optional, for API documentation
   • libboost-test-dev - Optional, for unittests

2. Fetch the source

    git clone --recursive https://github.com/open-eid/libdigidocpp
    cd libdigidocpp
   

3. Configure

    mkdir build
    cd build
    cmake ..
   

4. Build

    make
   

5. Install

    sudo make install
   

6. Execute

    /usr/local/bin/digidoc-tool
   

macOS

1. Install dependencies from

   • XCode
   • CMake

2. Fetch the source

    git clone --recursive https://github.com/open-eid/libdigidocpp
    cd libdigidocpp
   

3. Prepare dependencies (available targets: osx, ios, iossimulator, androidarm, androidarm64, androidx86)

    sh prepare_osx_build_environment.sh osx all
   

4. Configure, build and install (available targets: osx, ios, iossimulator, androidarm, androidarm64, androidx86)

    ./build-library.sh osx install
   

5. Execute

    /Library/libdigidocpp/bin/digidoc-tool
   

Windows

1. Install dependencies and necessary tools from

   • Visual Studio Community 2015/2017/2019
   • CMake
   • Swig - Optional, for C# and Java bindings
   • Wix toolset - Optional, for creating Windows installation packages

   Toolset:

   • 140 - Visual Studio 2015
   • 141 - Visual Studio 2017 (Default)
   • 142 - Visual Studio 2019

2. Fetch the source

    git clone --recursive https://github.com/open-eid/libdigidocpp
    cd libdigidocpp
   

3. Prepare

    powershell -ExecutionPolicy ByPass -File prepare_win_build_environment.ps1 -toolset 141
   

4. Configure

    mkdir build
    cd build
    cmake ..
   

   Optional CMake parameters:

   -DSWIG_EXECUTABLE=C:/swigwin-4.0.1/swig.exe
   

   After running the cmake build, digidoc_csharp.dll along with the C# source files will be created, more info at examples/DigiDocCSharp/README.md.

5. Build

    nmake
   

6. Alternative to steps 4. and 5. -

    powershell -ExecutionPolicy ByPass -File build.ps1 -toolset 141
   

   The build script builds executables and installation media for all platforms (x86 and x64 / Debug and Release with debug symbols)

7. Execute

    src/digidoc-tool.exe
   

Examples

examples/README.md

Support

Official builds are provided through official distribution point id.ee. If you want support, you need to be using official builds. Contact our support via www.id.ee for assistance.

Source code is provided on "as is" terms with no warranty (see license for more information). Do not file Github issues with generic support requests.