Android Kotlin 依赖注入全解:Koin appModule 配置与多 ViewModel 数据共享实战指南

一、基础配置与概念

1. 什么是 appModule

appModule 是 Koin 依赖注入框架中的核心配置模块,用于集中管理应用中的所有依赖项。它本质上是一个 Koin 模块(org.koin.core.module.Module),通过 DSL 方式声明各种组件的创建方式和依赖关系。

2. 基本结构

kotlin 复制代码
val appModule = module {
    // 在这里声明各种依赖项
    single { } // 单例组件
    factory { } // 每次创建新实例
    viewModel { } // ViewModel组件
}

二、完整配置示例

1. 基础配置(app/build.gradle)

gradle 复制代码
dependencies {
    // Koin 核心
    implementation "io.insert-koin:koin-core:3.4.3"
    implementation "io.insert-koin:koin-android:3.4.3"
    
    // ViewModel
    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2"
    
    // 协程
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3"
}

2. 完整 appModule 示例

kotlin 复制代码
// di/KoinModules.kt
import org.koin.android.ext.koin.androidContext
import org.koin.androidx.viewmodel.dsl.viewModel
import org.koin.dsl.module

val appModule = module {
    // 1. 单例组件
    single { 
        SharedPreferencesManager(
            androidContext().getSharedPreferences("app_prefs", Context.MODE_PRIVATE)
        ) 
    }
    
    // 2. 带接口绑定的Repository
    single<UserRepository> { UserRepositoryImpl(get()) }
    
    // 3. ViewModel
    viewModel { MainViewModel(get(), get()) }
    
    // 4. 带参数的ViewModel
    viewModel { (userId: String) -> 
        UserDetailViewModel(userId, get()) 
    }
    
    // 5. 网络服务
    single {
        Retrofit.Builder()
            .baseUrl("https://api.example.com/")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
            .create(ApiService::class.java)
    }
    
    // 6. 协程Dispatcher
    single(named("IO")) { Dispatchers.IO }
    single(named("Main")) { Dispatchers.Main }
}

三、实战应用

1. Application 初始化

kotlin 复制代码
// MyApp.kt
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        
        startKoin {
            androidContext(this@MyApp)
            modules(appModule)
            
            // 调试日志
            if (BuildConfig.DEBUG) {
                androidLogger(Level.DEBUG)
            }
        }
    }
}

2. 在 Activity 中使用

kotlin 复制代码
class MainActivity : AppCompatActivity() {
    // 普通ViewModel注入
    private val mainViewModel: MainViewModel by viewModel()
    
    // 带参数的ViewModel
    private val userViewModel: UserDetailViewModel by viewModel { 
        parametersOf(intent.getStringExtra("USER_ID") ?: "") 
    }
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        // 直接使用已注入的ViewModel
        mainViewModel.loadData()
    }
}

3. 在 Fragment 中使用

kotlin 复制代码
class UserFragment : Fragment() {
    // 共享Activity的ViewModel
    private val sharedViewModel: MainViewModel by sharedViewModel()
    
    // 本Fragment独有的ViewModel
    private val userViewModel: UserViewModel by viewModel()
}

四、高级用法

1. 多模块组织

kotlin 复制代码
// di/modules/
val networkModule = module {
    single { createOkHttpClient() }
    single { createRetrofit(get()) }
    single { get<Retrofit>().create(ApiService::class.java) }
}

val databaseModule = module {
    single { createDatabase(androidContext()) }
    single { get<AppDatabase>().userDao() }
}

val repositoryModule = module {
    single<UserRepository> { UserRepositoryImpl(get(), get()) }
}

val viewModelModule = module {
    viewModel { MainViewModel(get()) }
}

2. 作用域控制

kotlin 复制代码
val sessionModule = module {
    // 用户会话期间有效的作用域
    scope(named("SessionScope")) {
        scoped { UserSessionManager(get()) }
    }
}

// 使用
class LoginActivity : AppCompatActivity() {
    private val sessionScope = getKoin().createScope("user_session", named("SessionScope"))
    
    private val sessionManager: UserSessionManager by inject()
    
    override fun onDestroy() {
        sessionScope.close()
        super.onDestroy()
    }
}

3. 属性注入

kotlin 复制代码
val configModule = module {
    single { 
        AppConfig(
            apiUrl = getProperty("API_URL", "https://default.api"),
            timeout = getProperty("TIMEOUT_MS", 5000L)
        )
    }
}

// 在启动时加载属性
startKoin {
    androidContext(this@MyApp)
    modules(configModule)
    fileProperties("/config.properties") // 从assets加载
}

五、测试方案

1. 测试模块配置

kotlin 复制代码
val testModule = module {
    // 覆盖正式实现
    single<ApiService>(override = true) { MockApiService() }
    single<Database>(override = true) { InMemoryDatabase() }
}

@Before
fun setup() {
    startKoin {
        modules(testModule)
    }
}

@After
fun tearDown() {
    stopKoin()
}

2. ViewModel 测试

kotlin 复制代码
class MainViewModelTest {
    private lateinit var viewModel: MainViewModel
    
    @Before
    fun setup() {
        val testModule = module {
            viewModel { MainViewModel(get()) }
            single<UserRepository> { FakeUserRepository() }
        }
        
        startKoin { modules(testModule) }
        viewModel = get()
    }
    
    @Test
    fun testLoadData() = runTest {
        viewModel.loadData()
        assertEquals(3, viewModel.users.value?.size)
    }
}

六、最佳实践

  1. 模块化组织:

    • 按功能拆分模块(network/database/repository等)
    • 每个模块文件不超过200行
  2. 依赖顺序:

    kotlin 复制代码
    startKoin {
        modules(
            coreModule,      // 基础组件
            networkModule,   // 网络层
            databaseModule,  // 数据层
            viewModelModule  // 最后加载ViewModel
        )
    }
  3. 生命周期管理:

    • 单例用于全局服务
    • factory用于无状态工具类
    • viewModel严格遵循生命周期
  4. 命名规范:

    kotlin 复制代码
    single(named("AuthApi")) { createAuthApi(get()) }
    single(named("PublicApi")) { createPublicApi(get()) }
    
    // 使用处
    class MyViewModel(
        @Named("AuthApi") private val authApi: ApiService,
        @Named("PublicApi") private val publicApi: ApiService
    ) : ViewModel()

七、常见问题解决

问题1:循环依赖

错误示例:

kotlin 复制代码
class A(val b: B)
class B(val a: A)

解决方案:

  • 使用 lazy 延迟初始化
  • 重构设计,引入第三方类

问题2:依赖找不到

检查步骤:

  1. 确认模块已正确加载

  2. 检查 get() 参数类型是否匹配

  3. 查看 Koin 日志:

    kotlin 复制代码
    startKoin {
        androidLogger(Level.DEBUG)
    }

问题3:内存泄漏

预防措施:

kotlin 复制代码
// Fragment中正确使用
private val viewModel by viewModels<MyViewModel>()

// 避免在Application中持有Activity引用

通过以上配置和实践,你可以构建出清晰、可维护的Android应用依赖注入体系。Koin的appModule让依赖管理变得直观且类型安全,特别适合Kotlin开发的Android项目。

相关推荐
FungLeo4 小时前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
yz_aiks5 小时前
Termux 使用教程:把安卓手机变成随身 Linux(装 Python、SSH 远程、跑自动化脚本)
android·linux·python·智能手机·ssh·termux
booboosui13 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
雨白1 天前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m1 天前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui1 天前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149062 天前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭2 天前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1232 天前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c