Skip to main content Skip to docs navigation

Document not reviewed yet, might be outdated. Please, let us know if you find something invalid here.
To access this functionality you can include the: com.soywiz.korge:korge-foundation:5.1.0 artifact from maven central. All the functionality yields in the korlibs.inject package .
On this page

Portable Kotlin Common package to do dependency injection.

Creating a new injector

An injector allow to hold instances, singletons and class constructions, so it allows to access instances later.

val injector = Injector()

Creating a child injector

A child injector, will be able to access/create instances created by parent and ancestor injectors, but all the new mappings will be limited to the child injector.

val injector = injector.child()


Before getting or constructing instances, it is mandatory to map some instances, singletons or prototypes.


If you want to save an already constructed instance for later usage, you can map an instance like this:

// or

Instances are useful for configurations.


If you want to construct a singleton, in a way that all its dependencies are resolved automatically, you can use a singleton. A singleton will create a single instance per injector once, lazily when first requested.

injector.mapSingleton<MyClass> { MyClass(get(), get(), get(), ...) }

Depending on the number of constructor parameters, it is needed to provide the exact number of get(). Singletons are useful for services.


If you want to construct a new object every time a specific type instance is requested, you can map prototypes. Similarly to singletons:

injector.mapPrototype<MyClass> { MyClass(get(), get(), get(), ...) }

Getting instances

Once the injector has been configured, you can start to request instances. If the requested class was mapped as an instance, the provided instance will be returned, if the requested class was mapped as a singleton, a new instance will be created once, cached, and returned every time. And if the requested class was mapped as a prototype, a new class will be constructed and returned every time.

val instanceOrThrow: MyClass = injector.get<MyClass>()
val nullable: MyClass? = injector.getOrNull<MyClass>()
Was this article useful?