Jetpack Compose Android 示例项目教程
1. 项目的目录结构及介绍
目录结构
Jetpack-Compose-Android-Examples/
├── app/
│ ├── build.gradle
│ ├── proguard-rules.pro
│ └── src/
│ ├── androidTest/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/
│ │ │ └── mindorks/
│ │ │ └── jetpackcompose/
│ │ │ ├── example1/
│ │ │ ├── example2/
│ │ │ └── ...
│ │ └── res/
│ └── test/
├── build.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
├── settings.gradle
└── README.md
目录介绍
- app/: 包含应用程序的主要代码和资源。
- build.gradle: 应用程序的构建脚本。
- proguard-rules.pro: ProGuard 规则文件。
- src/: 源代码目录。
- androidTest/: 用于 Android 测试的代码。
- main/: 主代码目录。
- java/: Java 源代码目录。
- com/mindorks/jetpackcompose/: 包含各个示例的包。
- res/: 资源文件目录。
- java/: Java 源代码目录。
- test/: 用于单元测试的代码。
- build.gradle: 项目的根构建脚本。
- gradle.properties: Gradle 配置文件。
- gradlew 和 gradlew.bat: Gradle 包装器脚本。
- settings.gradle: 项目设置文件。
- README.md: 项目说明文档。
2. 项目的启动文件介绍
启动文件
项目的启动文件通常位于 app/src/main/java/com/mindorks/jetpackcompose/
目录下,具体文件名取决于项目的结构。例如,如果项目的主 Activity 是 MainActivity.kt
,则启动文件为:
package com.mindorks.jetpackcompose
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material.MaterialTheme
import androidx.compose.material.Surface
import androidx.compose.material.Text
import androidx.compose.runtime.Composable
import androidx.compose.ui.tooling.preview.Preview
import com.mindorks.jetpackcompose.ui.theme.JetpackComposeTheme
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
JetpackComposeTheme {
// A surface container using the 'background' color from the theme
Surface(color = MaterialTheme.colors.background) {
Greeting("Android")
}
}
}
}
}
@Composable
fun Greeting(name: String) {
Text(text = "Hello $name!")
}
@Preview(showBackground = true)
@Composable
fun DefaultPreview() {
JetpackComposeTheme {
Greeting("Android")
}
}
启动文件介绍
- MainActivity.kt: 这是应用程序的主 Activity,负责设置和显示 Compose UI。
- onCreate(): 重写的方法,用于设置 Compose 内容。
- Greeting(): 一个简单的 Composable 函数,显示文本。
- DefaultPreview(): 用于预览 Composable 函数的预览函数。
3. 项目的配置文件介绍
配置文件
- build.gradle: 项目的根构建脚本,包含项目级别的配置,如插件、依赖项和版本信息。
// 根目录下的 build.gradle
buildscript {
ext.kotlin_version = "1.5.21"
repositories {
google()
mavenCentral()
}
dependencies {
classpath "com.android.tools.build:gradle:7.0.0"
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
}
}