Android MVP框架实战：Dagger2+Retrofit+RxJava整合指南
1. 项目概述在Android开发领域构建一个稳定、可扩展的项目框架是每个开发者都会面临的挑战。这次我们要搭建的是一个基于MVP架构整合Dagger2、Retrofit、RxJava和OkHttp的基础框架。这个组合在业界被称为Android开发黄金搭档能够有效解决以下痛点代码耦合度高导致的维护困难网络请求与业务逻辑混杂依赖管理混乱异步操作难以追踪2. Dagger2核心概念解析2.1 依赖注入的本质Dagger2是一个编译时依赖注入框架它通过注解处理器在编译阶段生成依赖注入代码。与运行时依赖注入框架相比Dagger2具有以下优势编译时检查依赖关系避免运行时错误生成的代码效率高接近手写代码明确的依赖关系图便于维护2.2 核心注解详解Dagger2的核心注解包括Module定义提供依赖的类Provides在Module中标记提供依赖的方法Component作为Module和注入目标之间的桥梁Inject标记需要注入的依赖或提供依赖的构造方法3. 项目框架搭建实战3.1 环境准备首先在项目的build.gradle中添加Dagger2依赖// 项目根目录下的build.gradle buildscript { dependencies { classpath com.google.dagger:hilt-android-gradle-plugin:2.44 } } // app模块下的build.gradle plugins { id com.google.dagger.hilt.android } dependencies { implementation com.google.dagger:dagger:2.44 kapt com.google.dagger:dagger-compiler:2.44 // 如果使用Hilt implementation com.google.dagger:hilt-android:2.44 kapt com.google.dagger:hilt-android-compiler:2.44 }3.2 基础模块设计3.2.1 Application模块HiltAndroidApp class MyApplication : Application() { override fun onCreate() { super.onCreate() // 初始化代码 } }3.2.2 网络模块Module InstallIn(SingletonComponent::class) object NetworkModule { Provides Singleton fun provideOkHttpClient(): OkHttpClient { return OkHttpClient.Builder() .connectTimeout(30, TimeUnit.SECONDS) .readTimeout(30, TimeUnit.SECONDS) .addInterceptor(HttpLoggingInterceptor().apply { level HttpLoggingInterceptor.Level.BODY }) .build() } Provides Singleton fun provideRetrofit(okHttpClient: OkHttpClient): Retrofit { return Retrofit.Builder() .baseUrl(https://api.example.com/) .client(okHttpClient) .addConverterFactory(GsonConverterFactory.create()) .addCallAdapterFactory(RxJava3CallAdapterFactory.create()) .build() } }3.3 MVP架构实现3.3.1 基础契约接口interface BaseView { fun showLoading() fun hideLoading() fun showError(message: String) } interface BasePresenterV : BaseView { fun attachView(view: V) fun detachView() }3.3.2 具体Presenter实现class MainPresenter Inject constructor( private val repository: MainRepository ) : BasePresenterMainView { private var view: MainView? null override fun attachView(view: MainView) { this.view view } override fun detachView() { this.view null } fun loadData() { view?.showLoading() repository.getData() .subscribeOn(Schedulers.io()) .observeOn(AndroidSchedulers.mainThread()) .subscribe({ data - view?.hideLoading() view?.showData(data) }, { error - view?.hideLoading() view?.showError(error.message ?: Unknown error) }) } }4. 依赖注入实战技巧4.1 作用域管理Dagger2提供了多种作用域注解Singleton全局单例ActivityScopedActivity生命周期FragmentScopedFragment生命周期ViewModelScopedViewModel生命周期Module InstallIn(ActivityComponent::class) object ActivityModule { Provides ActivityScoped fun provideMainPresenter(repository: MainRepository): MainPresenter { return MainPresenter(repository) } }4.2 多模块依赖对于大型项目可以将依赖按功能拆分为多个模块Module(includes [NetworkModule::class, DatabaseModule::class]) InstallIn(SingletonComponent::class) object AppModule { Provides Singleton fun provideSharedPreferences(app: Application): SharedPreferences { return app.getSharedPreferences(app_prefs, Context.MODE_PRIVATE) } }5. 常见问题与解决方案5.1 循环依赖问题当两个类相互依赖时Dagger2会报错。解决方案使用Lazy延迟初始化引入Provider接口重构代码结构消除循环依赖class ClassA Inject constructor( private val classB: ProviderClassB ) class ClassB Inject constructor( private val classA: ProviderClassA )5.2 多实例问题确保同一依赖在相同作用域内只创建一个实例正确使用作用域注解检查Component的生命周期避免在Module中直接new对象5.3 编译错误排查常见的编译错误及解决方法Dagger/MissingBinding检查是否缺少Provides方法或Inject构造方法Dagger/DependencyCycle存在循环依赖Dagger/SubcomponentFactoryMissing子组件未正确声明6. 性能优化建议6.1 组件划分策略按功能划分将相关功能聚合到同一组件按生命周期划分不同生命周期的依赖放入不同组件按使用频率划分高频使用的依赖单独管理6.2 延迟加载技巧class MyViewModel Inject constructor( private val heavyDependency: LazyHeavyClass ) : ViewModel() { fun doWork() { heavyDependency.get().heavyOperation() } }6.3 编译时优化启用增量注解处理kapt { useBuildCache true correctErrorTypes true }避免过度使用Singleton合理规划作用域定期运行./gradlew clean build --profile分析构建性能7. 测试策略7.1 单元测试配置HiltAndroidTest class MainPresenterTest { get:Rule var hiltRule HiltAndroidRule(this) Inject lateinit var presenter: MainPresenter Before fun setup() { hiltRule.inject() } Test fun testLoadData() { // 测试代码 } }7.2 Mock依赖注入Module TestInstallIn( components [SingletonComponent::class], replaces [NetworkModule::class] ) object TestNetworkModule { Provides Singleton fun provideRetrofit(): Retrofit { return Retrofit.Builder() .baseUrl(http://localhost:8080/) .addConverterFactory(GsonConverterFactory.create()) .build() } }8. 项目结构最佳实践推荐的项目结构app/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ ├── di/ # 依赖注入相关 │ │ │ ├── data/ # 数据层 │ │ │ │ ├── local/ # 本地数据 │ │ │ │ ├── remote/ # 远程数据 │ │ │ │ └── repo/ # 仓库 │ │ │ ├── domain/ # 领域层 │ │ │ ├── presentation/ # 表现层 │ │ │ │ ├── view/ # 视图 │ │ │ │ ├── presenter/ # Presenter │ │ │ │ └── contract/ # 契约接口 │ │ │ └── App.kt # Application类 │ │ └── res/ # 资源文件 │ └── test/ # 单元测试 └── build.gradle9. 进阶技巧9.1 动态URL处理Module InstallIn(SingletonComponent::class) object DynamicUrlModule { Provides Named(dynamic) fun provideRetrofit( okHttpClient: OkHttpClient, Named(baseUrl) baseUrl: String ): Retrofit { return Retrofit.Builder() .baseUrl(baseUrl) .client(okHttpClient) .addConverterFactory(GsonConverterFactory.create()) .build() } Provides Named(baseUrl) fun provideBaseUrl(): String { return https://default.api.url/ } }9.2 多环境配置Module InstallIn(SingletonComponent::class) object EnvironmentModule { enum class Environment { DEV, STAGING, PROD } Provides fun provideEnvironment(): Environment { return when (BuildConfig.BUILD_TYPE) { debug - Environment.DEV staging - Environment.STAGING else - Environment.PROD } } }10. 代码质量保障10.1 静态代码分析配置Detekt和Ktlint// 根目录build.gradle plugins { id io.gitlab.arturbosch.detekt version 1.22.0 id org.jlleitschuh.gradle.ktlint version 11.0.0 } // app模块build.gradle detekt { config files($rootDir/config/detekt.yml) baseline file($rootDir/config/baseline.xml) } ktlint { android true ignoreFailures false }10.2 依赖版本管理使用版本目录// gradle/libs.versions.toml [versions] dagger 2.44 retrofit 2.9.0 [libraries] dagger { group com.google.dagger, name dagger, version.ref dagger } dagger-compiler { group com.google.dagger, name dagger-compiler, version.ref dagger } retrofit { group com.squareup.retrofit2, name retrofit, version.ref retrofit }在实际项目中我发现合理规划Dagger2的模块结构能显著提高代码可维护性。建议将全局依赖放在AppModule功能相关依赖放在各自特性模块这样在移除功能模块时依赖关系也能被干净地清除。
