(Coming soon...)

KODA is a header-only cross-platform C++14 (or later) infrastructure library based on the STL. It provides lightweight yet powerful components for Async Tasks, RunLoop/Event Dispatching, IPC, and SigSlot. Seamlessly supports Windows, Darwin (iOS/macOS), Linux, Android, HarmonyOS, and other Unix-like systems with zero external dependencies

• Developer: Arlin (arlins.dps@gmail.com)
• Requirements: C++14 or later.

KODA architecture is cleanly decoupled into 5 core modules. Below is the precise component breakdown and its exact underlying design purpose:

Before calling any KODA components, you must initialize the framework via kd::startup() at your application's entry point, and release resources via kd::shutdown() before exiting.

To comply with strict OS Sandbox / Permission restrictions, you must provide dedicated writable directories on specific platforms to prevent security blocking:

#include "koda/koda.h"

int main() {
    // Configuration Guidelines for OS Sandboxes:
    // - Android / HarmonyOS: BOTH paths must be specified within a writable directory to avoid permission restrictions.
    // - Darwin (iOS / macOS): crossProcessDir MUST be set to a directory including the AppGroup path to work across apps.
    // - You can also specify these paths to override the default directories automatically defined by KODA.
    std::string inProcessDir = "/path/to/writable/app/internal/dir";
    std::string crossProcessDir = "/path/to/writable/shared/group/dir";

    // 1. Initialize KODA engine
    kd::startup(inProcessDir, crossProcessDir);

    // ... Your Main Application Business Logic ...

    // 2. Clean up resources before exit
    kd::shutdown();
    return 0;
}

To inspect synchronization and concurrency issues early during development, define KD_DEBUGGING_TOOLS before including KODA headers. This enables built-in diagnostic instruments such as Self-Deadlock detection in debug configurations:

// Define this macro to unlock KODA's internal debugging tools
#define KD_DEBUGGING_TOOLS
#include "koda/koda.h"

Since KODA is a header-only library, you do not need to build any source binaries. Simply include the koda/koda.h umbrella header and link against your target platform's native system libraries (both static and dynamic linking are fully supported without restriction):

• kernel32.lib
• user32.lib
• advapi32.lib

• libstdc++.a / .so
• libpthread.a / .so
• librt.a / .so

• libc++.tbd
• libpthread.tbd
• librt.tbd
• CoreFoundation.framework

• libc++_static.a / .so
• libpthread.a / .so
• librt.a / .so

• libc++.a / .so
• libpthread.a / .so

This project is licensed under the MIT License.