You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The KApps libraries are modules used by PIA Desktop that also expose C-linkage public APIs. These do not depend on Qt and are not brand-specific.
4
+
5
+
A simple application using the logger and some sample APIs is included in `pia_desktop/tools/kapps-lib-test`.
6
+
7
+
## Product integration
8
+
9
+
To incorporate these libraries in your build process:
10
+
11
+
* add inc/ from the library artifact to your header include directories
12
+
* add lib/ from the library artifact to your library search path (and bin/ on Windows)
13
+
* include headers like `<kapps_core/logger.h>`, `<kapps_net/firewall.h>` as needed
14
+
* link to `kapps_core`, `kapps_net`, etc.
15
+
* ship the dynamic libraries with your product
16
+
17
+
## Supportability
18
+
19
+
To troubleshoot field issues should they occur, be sure you:
20
+
21
+
* capture debug logging from the libraries using the logger API in kapps_core
22
+
* on Windows, preserve PDB symbol files needed to analyze crash dumps
23
+
24
+
### Logging
25
+
26
+
Enable debug logging and configure a debug log message callback to consume debug messages. Capture these messages with your program's debug logging. Note that the callback can be invoked on any thread, including APC threads on Windows, but that invocations are serialized by the logger's mutex.
27
+
28
+
Simple example from kapps-lib-test:
29
+
30
+
```
31
+
void initLogging()
32
+
{
33
+
// Enable logging and set up a logging sink (using the C-linkage public API)
34
+
::DtopCoreEnableLogging(true);
35
+
// Use our log sink as the callback. We don't need any context in this
36
+
// example.
37
+
::DtopCoreLogCallback sinkCallback{};
38
+
sinkCallback.pWriteFn = &writeLogMsg;
39
+
// DtopCoreLogInit copies the callback struct, so we can safely let
40
+
// sinkCallback be destroyed
41
+
::DtopCoreLogInit(&sinkCallback);
42
+
}
43
+
```
44
+
45
+
See kapps-lib-test for more details, including a sample message callback, and see kapps_core/logger.h for more information on the logger APIs.
46
+
47
+
### Debug symbols
48
+
49
+
PDB symbol files are included in the library artifact on Windows. These don't have to be shipped with the application, but should be preserved for later postmortem dump debugging should problems occur.
50
+
51
+
## Building
52
+
53
+
To build the libraries, set up the pia_desktop build environment as detailed in pia_desktop/README.md. `rake libs` builds all libs and the output artifact; `rake tools` builds all tools including the test application.
54
+
55
+
Currently, Qt is still needed for the build process, as the MSVC toolchain selection in the build scripts selects the same version of MSVC as was used to build Qt. This requirement could probably be relaxed with some build refactoring.
0 commit comments