Cross-module service provisioning framework enables service implementation retrieval through annotations, supporting multi-module projects and Compose Multiplatform environments, with automatic dependency resolution and initialization.
Surfaced from shared tags and platforms — no rankings paid for.
Cross-Module Service Provisioning Framework with KMP Support
Across all modules:
// build.gradle.kts
plugins {
id("com.google.devtools.ksp")
id("io.github.985892345.KtProvider") version "x.y.z"
}
dependencies {
// The provider-manager dependency can be optionally added.
// Additionally, you have the option to implement your own provider-manager.
implementation(ktProvider.manager)
// ksp
ksp(ktProvider.ksp)
}
Kotlin/Jvm: It is recommended to perform initialization in the main function.
fun main() {
// Invoking the generated XXXKtProviderInitializer (Module Name + KtProviderInitializer) via KSP
XXXKtProviderInitializer.tryInitKtProvider()
}
Android: It is recommended to perform initialization in the Application#onCreate method.
class App : Application() {
override fun onCreate() {
super.onCreate()
XXXKtProviderInitializer.tryInitKtProvider()
}
}
iOS: I'm not proficient in iOS, so this may not be the most optimal approach.
Swift: App#init
@main
struct iOSApp: App {
init() {
XXXKtProviderInitializer.shared.tryInitKtProvider()
}
}
Objective-C: application:didFinishLaunchingWithOptions:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[XXXKtProviderInitializer.shared tryInitKtProvider];
}
Add interface
interface ITestService {
fun get(): String
}
Implement interface
@ImplProvider(clazz = ITestService::class, name = "test")
class TestServiceImpl : ITestService {
override fun get(): String {
return "123"
}
}
| Annotation | |
|---|---|
| ImplProvider | Obtain an instance, which becomes a singleton when the implementation class is an object. |
| KClassProvider | Retrieve the KClass of the implementation class (can be used for Class<out Activity> in Android). |
Use interface
val service = KtProvider.implOrNull(ITestService::class, "test")
println(service.get())
Similar to the following code:
// Implementation class of KtProviderInitializer
object ModuleKtProviderInitializer : KtProviderInitializer() {
override val router: KtProviderRouter = ModuleKtProviderRouter
override val otherModuleKtProvider: List<KtProviderInitializer> = listOf(
// Here, based on the module dependency relationship during Gradle compilation,
// the implementation class of KtProviderInitializer for the dependent modules is generated.
Module1KtProviderInitializer,
Module2KtProviderInitializer
)
}
// Implementation class of KtProviderRouter
internal object ModuleKtProviderRouter : KtProviderRouter() {
override fun initRouter(delegate: IKtProviderDelegate) {
// By using KSP, find all annotations and then add the implementation classes.
delegate.addImplProvider(ITestService::class, "abc") { TestServiceImpl }
delegate.addImplProvider(ITestService2::class, "123") { TestServiceImpl2 }
}
}
Copyright 2023 985892345
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this except compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
// build.gradle.kts
plugins {
id("com.google.devtools.ksp")
id("io.github.985892345.KtProvider") version "x.y.z"
}
kotlin {
sourceSets {
commonMain.dependencies {
// The provider-manager dependency can be optionally added.
// Additionally, you have the option to implement your own provider-manager.
implementation(ktProvider.manager)
}
}
}
dependencies {
// Please refer to the official documentation for KSP configurations:
// https://kotlinlang.org/docs/ksp-multiplatform.html
add("kspCommonMainMetadata", ktProvider.ksp)
add("kspAndroid", ktProvider.ksp)
add("kspDesktop", ktProvider.ksp) // dependent on JVM source set configuration
add("kspIosX64", ktProvider.ksp)
add("kspIosArm64", ktProvider.ksp)
add("kspIosSimulatorArm64", ktProvider.ksp)
// ...
// The provider-api dependency is already included with the Gradle plugin.
}