# studyAndroid

**Repository Path**: yang1yu/study-android

## Basic Information

- **Project Name**: studyAndroid
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FirstAndroidApp

这是一个专门为 Android 初学者准备的第一个项目，技术栈是 **Kotlin + Jetpack Compose**。

你会在这个 App 中看到：

- 输入名字后，界面立即显示问候语
- 点击按钮，计数器加一
- 点击重置，计数归零
- 旋转屏幕后，名字和计数仍然保留

## 第一次运行

1. 打开 Android Studio。
2. 点击 **Open**，选择 `D:\CodeStudy\Android`。
3. 等待右下角 Gradle Sync 和依赖下载完成。
4. 在顶部设备菜单中选择一个模拟器；如果没有，打开 **Tools > Device Manager > Add a new device** 创建一个。
5. 点击绿色三角形 **Run 'app'**。

如果 Android Studio 询问 Gradle JDK，请选择它自带的 `jbr-17`。本项目需要 JDK 17。

## 从哪里开始读代码

首先打开：

`app/src/main/java/com/example/firstandroidapp/MainActivity.kt`

推荐按这个顺序观察：

1. `MainActivity.onCreate()`：App 的页面入口。
2. `setContent {}`：开始使用 Compose 绘制界面。
3. `WelcomeScreen()`：当前页面的全部内容。
4. `name` 和 `count`：页面状态。
5. `Button(onClick = { count++ })`：响应用户点击。

## 学习文档

1. [00-开始之前](docs/00-开始之前.md)
2. [01-Kotlin基础](docs/01-Kotlin基础.md)
3. [02-Android基础](docs/02-Android基础.md)
4. [03-数据与网络](docs/03-数据与网络.md)
5. [04-学习路线与练习](docs/04-学习路线与练习.md)
6. [05-Android项目完整实战流程](docs/05-Android项目完整实战流程.md)

建议不要一次读完。先运行 App，然后每天读一小节并亲手修改代码。

## 项目结构

```text
FirstAndroidApp/
├─ app/
│  ├─ build.gradle.kts              # app 模块的配置和依赖
│  └─ src/main/
│     ├─ AndroidManifest.xml        # 声明应用和入口 Activity
│     ├─ java/.../MainActivity.kt   # 主页面代码
│     └─ res/values/                # 应用名称、系统主题等资源
├─ docs/                            # 中文学习文档
├─ build.gradle.kts                 # 整个项目的插件版本
└─ settings.gradle.kts              # 项目名称、模块和仓库
```

## 当前技术版本

- Android Gradle Plugin 9.0.1
- Gradle 9.1.0
- Kotlin 2.2.10（由 AGP 内置支持）
- compileSdk / targetSdk 36
- minSdk 23
- Compose BOM 2026.05.00

这些版本是构建工具配置，不需要现在背下来。