DeveloperTips

Building

Building in sandboxed environment.

Comment out lines
https://github.com/open-eid/DigiDoc4-Client/blob/master/client/CMakeLists.txt#L3-L10
Replace line
https://github.com/open-eid/DigiDoc4-Client/blob/master/client/CMakeLists.txt#L16
qt5_add_resources( SOURCES images/images.qrc fonts/fonts.qrc ${CMAKE_CURRENT_BINARY_DIR}/tr.qrc ${CMAKE_CURRENT_BINARY_DIR}/TSL.qrc )
with
qt5_add_resources( SOURCES images/images.qrc fonts/fonts.qrc ${CMAKE_CURRENT_BINARY_DIR}/tr.qrc TSL.qrc )

Download latest TSL files to qdigidoc/client
https://ec.europa.eu/tools/lotl/eu-lotl.xml -> eu-lotl.xml
https://sr.riik.ee/tsl/estonian-tsl.xml -> EE.xml
and create file qdigidoc/client/TSL.qrc with content
<RCC><qresource prefix="TSL"><file>tl-mp.xml</file><file>EE.xml</file></qresource></RCC>

Comment out lines
https://github.com/open-eid/qt-common/blob/master/CMakeLists.txt#L48-L53
Replace line
https://github.com/open-eid/qt-common/blob/master/CMakeLists.txt#L54
qt5_add_resources( SOURCES ${CMAKE_CURRENT_BINARY_DIR}/config.qrc )
with
qt5_add_resources( SOURCES config.qrc )

Download latest Config files to qdigidoc/common

• https://id.eesti.ee/config.json
• https://id.eesti.ee/config.rsa
• https://id.eesti.ee/config.pub

Runtime

qdigidoc4 needs opensc-pkcs11.so library. If you have it installed in not an usual location then provide LD_LIBRARY_PATH prefix. For example: LD_LIBRARY_PATH=/path/to/opensc-pkcs11.so qdigidocclient.

Logging

Create qdigidoc4.log file in temp folder (WIN %TEMP%, OSX $TMPDIR, Linux $TEMP) and start application

Configuration parameters

Detailed description of fallback paths and rules

• http://doc.qt.io/qt-5/qsettings.html#platform-specific-notes
• http://doc.qt.io/qt-5/qsettings.html#fallback-mechanism

Parameter	Description
showIntro	Show intro
TSLOnlineDigest*	Enable online TSL digest verification
AccessCertUsage2020XX	Access cert usage counter
PKCS12Disable*	PKCS12 usage option
MobileCode	MID settings
MobileNumber	MID settings
proxyConfig	0: Disabled, 1: Auto, 2: Manual
ProxyHost*	Network settings
ProxyPass*	Network settings
ProxyPort*	Network settings
ProxyUser*	Network settings
City	Signature properties
Country	Signature properties
State	Signature properties
Zip	Signature properties
Role	Signature properties
language	Application language
lastPath	File selection dialog path
DefaultDir	Target file default directory
LastCheck	Version check
RoleAddressInfo	Toggles info dialog
ShowPrintSummary	Toggles summary dialog
ProxyTunnelSSL*	May be used to enable downloading TSL-s in case of HTTPS connections and proxy
TSA-URL	TSA-URL
MobileSettings	Remember MID
tokenBackend	Windows only: CNG,CAPI,PKCS11
cdocwithddoc	Use always ddoc container in cdoc documents

* Location in windows is %APPDATA%/digidocpp/digidocpp.xml

See also libdigidocpp configuration http://open-eid.github.io/libdigidocpp/manual.html#parameters

Windows

• [HKEY_CURRENT_USER\Software\RIA\qdigidoc4]

OSX

• defaults read ee.ria.qdigidoc4
• ~/Library/Containers/ee.ria.qdigidoc4/Data/Library/Preferences/ee.ria.qdigidoc4.plist
• ~/Library/Preferences/ee.ria.qdigidoc4.plist

Linux

• ~/.config/RIA/qdigidoc4.conf
• ~/.config/RIA.conf

Other paths

OSX

TSL cache, crypto certificate history

• ~/Library/Containers/ee.ria.qdigidoc4/Data/Library/Application Support/RIA/qdigidoc4/