开源项目教程：天气应用 – 基于Jetpack Compose的清洁架构示例

2 0 0

开源项目教程：天气应用 – 基于Jetpack Compose的清洁架构示例

weather_compose_clean_architectureThis is sample app about Jetpack Compose, Clean Architecture, etc.项目地址:https://gitcode.com/gh_mirrors/we/weather_compose_clean_architecture

本教程将指导您了解并使用位于GitHub的开源项目——一个采用现代Android技术栈实现的天气应用程序。它展示了如何通过洁构架构(Clean Architecture)、MVVM设计模式以及Jetpack Compose构建可展示当前和未来天气预报的UI。

1. 项目目录结构及介绍

该开源项目遵循清晰的多模块组织原则，确保代码结构清晰、职责分明。下面是主要的目录结构及其简要说明：

app: 主应用模块，包含了界面逻辑、视图组件等。

src/main/java: 应用的主要Java和Kotlin源代码，包括入口点。src/main/res: 资源文件，如布局文件、图片、字符串定义等。src/androidTest: 单元测试和UI测试。

domain: 包含领域层逻辑，这是业务逻辑的核心，与任何特定的框架或UI库无关。

data: 数据访问层，负责数据的获取（可能是从网络、数据库或其他来源）。

包括接口定义（例如API服务）、数据存储逻辑等。

presentation: 呈现层，这里是Jetpack Compose UI代码所在之处，与用户的交互紧密相关。

buildSrc: 自定义插件或共用的构建逻辑存放地。

gradle.properties 和 build.gradle 文件负责整个项目的构建配置。

settings.gradle(kts) 确定项目的模块依赖和设置。

2. 项目的启动文件介绍

在app模块下，主要的启动文件通常位于src/main/kotlin/com.example.app/MainActivity.kt或类似的路径中。虽然提供的链接不指向真实的仓库地址，正常情况下，这个文件负责初始化Jetpack Compose的Activity，并设置根级别的Composable作为应用的初始界面。它可能看起来像这样：




package com.example.weathercompose


 


import androidx.appcompat.app.AppCompatActivity


import android.os.Bundle


import androidx.compose.material.MaterialTheme


import androidx.compose.ui.platform.ComposeView


import androidx.compose.runtime.Composable


import androidx.compose.ui.tooling.preview.Preview


import androidx.compose.foundation.layout.fillMaxSize


import androidx.compose.material.Text


import androidx.compose.runtime.remember


import androidx.compose.ui.Alignment


import androidx.compose.ui.Modifier


import androidx.compose.ui.graphics.Color


import androidx.compose.ui.text.style.TextAlign


 


class MainActivity : AppCompatActivity() {


    override fun onCreate(savedInstanceState: Bundle?) {


        super.onCreate(savedInstanceState)


        setContent {


            MyApp()


        }


    }


}


 


@Composable


fun MyApp() {


    MaterialTheme {


        Greeting("Android User")


    }


}


 


@Composable


fun Greeting(name: String) {


    Text(text = "Hello $name!", modifier = Modifier.fillMaxSize().align(Alignment.Center),


        color = Color.White)


}

请注意，实际的启动文件可能会包含更复杂的逻辑来初始化依赖注入(DI)框架如Hilt，并且具体的Composable组件将会是展示天气数据的实际界面。

3. 项目的配置文件介绍

build.gradle (Module: app)

此文件定义了模块的依赖项、编译配置等。例子包括添加Jetpack Compose、Clean Architecture相关的库、Kotlin版本设定、Hilt以及其他必要的Gradle插件。




plugins {


    id 'com.android.application'


    id 'kotlin-android'


    id 'kotlin-kapt' // 用于处理注解处理器，比如Hilt


}


 


android {


    ...


    compileSdkVersion 31 // 或者是当前适用的最新版本


    defaultConfig {


        applicationId "com.example.weathercompose"


        minSdkVersion 21


        targetSdkVersion 31


        versionCode 1


        versionName "1.0"


        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"


    }


    buildTypes {


        release {


            minifyEnabled false


            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'


        }


    }


    // 其他配置如kotlinOptions { jvmTarget = '1.8' }


}


 


dependencies {


    implementation 'androidx.core:core-ktx:1.6.0' // 核心扩展库


    implementation 'androidx.activity:activity-compose:1.3.0' // Compose支持


    implementation 'androidx.compose.ui:ui-tooling-preview:1.0.1' // Compose预览工具


    kapt 'com.google.dagger:hilt-android-compiler:2.35.1' // Hilt的注解处理器


    // 更多具体依赖如数据访问层、网络请求库等


}

settings.gradle(kts)

控制项目的模块结构，引入其他子模块。




pluginManagement {


    repositories {


        gradlePluginPortal()


        google()


        mavenCentral()


    }


}


dependencyResolutionManagement {


    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)


    repositories {


        google()


        mavenCentral()


    }


}


rootProject.name = "weather_compose_clean_architecture"


include(":app", ":domain", ":data", ":presentation")

以上是基于典型结构和常规实践的概述，具体细节会根据实际项目有所不同。请参考实际仓库中的最新文件以获得最准确的信息。

weather_compose_clean_architectureThis is sample app about Jetpack Compose, Clean Architecture, etc.项目地址:https://gitcode.com/gh_mirrors/we/weather_compose_clean_architecture

# 随笔