安卓开发学习笔记

Windows 系统手动安装 Flutter 环境

✅ 一、准备条件

操作系统：Windows 10/11（推荐 64 位）
安装要求：

Git（Flutter 安装依赖）

# 查看
git --version

# 默认安装路径
C:\Program Files\Git

Android SDK（用于构建 APK）

# 查看
sdkmanager --list

# 默认安装路径
C:\Users\<你的用户名>\AppData\Local\Android\Sdk

JDK（建议 JDK 17）

# 查看
java -version

# 默认安装路径
C:\Program Files\Java\jdk-17

✅ 二、安装 Flutter SDK

1. 下载 Flutter

下载地址：https://flutter.dev/docs/get-started/install/windows

直接下载链接（Flutter 3.13.7 稳定版）：

https://storage.googleapis.com/flutter_infra_release/releases/stable/windows/flutter_windows_3.13.7-stable.zip

2. 解压

解压到路径，例如：

C:\flutter

3. 配置环境变量

将以下路径添加到系统环境变量 Path 中：

C:\flutter\bin

然后重启终端（cmd/powershell）。

✅ 三、安装 Android SDK（命令行方式）

1. 下载 Android 命令行工具

官方地址：https://developer.android.com/studio#command-tools
下载 zip 并解压到：
```
C:\Android\cmdline-tools\latest\
```

注意：解压后的目录结构必须是：

C:\Android\cmdline-tools\latest\bin

2. 配置环境变量

添加以下环境变量：

ANDROID_HOME=C:\Android
Path += C:\Android\platform-tools
Path += C:\Android\cmdline-tools\latest\bin

3. 安装必要组件

sdkmanager --sdk_root=C:\Android "platform-tools" "platforms;android-34" "build-tools;34.0.0"

✅ 四、安装 JDK（建议 JDK 17）

下载：https://jdk.java.net/17/
安装后设置环境变量：

JAVA_HOME = C:\Program Files\Java\jdk-17
Path += %JAVA_HOME%\bin

✅ 五、验证安装

flutter doctor

检查是否识别出所有组件并显示 ✅。

✅ 六、创建和构建项目

1. 创建项目

flutter create myapp
cd myapp

2. 构建 APK

flutter build apk --release

输出文件路径：

build\app\outputs\flutter-apk\app-release.apk

✅ 附：常见建议

项目	推荐配置
JDK	OpenJDK 17
Android SDK	platform-tools, android-34, build-tools-34
构建命令	flutter build apk --release
不建议使用权限	尽量不要使用管理员/root 构建

Flutter 现代化项目目录结构

my_flutter_app/                    # 项目根目录
├── android/                      # Android 平台相关代码（自动生成）
├── ios/                          # iOS 平台相关代码（自动生成）
├── lib/                          # Flutter 应用主代码目录
│   ├── main.dart                 # 入口文件，应用启动点
│   ├── src/                     # 业务代码目录（可按需自定义）
│   │   ├── widgets/             # 复用 Widget 组件
│   │   ├── pages/               # 页面级 Widget（Screen）
│   │   ├── models/              # 数据模型
│   │   ├── services/            # 业务逻辑或 API 请求
│   │   ├── utils/               # 工具类函数
│   │   └── providers/           # 状态管理（如 Provider、Riverpod）
├── assets/                       # 静态资源目录（图片、字体等）
│   ├── images/                   # 图片资源
│   ├── fonts/                    # 字体资源
│   └── translations/             # 国际化资源（如 ARB 文件）
├── test/                        # 单元测试代码
├── pubspec.yaml                 # Flutter 项目配置文件，管理依赖、资源
├── analysis_options.yaml        # Dart 分析规则配置（lint 规则）
├── .gitignore                   # Git 忽略文件
├── README.md                    # 项目说明文档
└── build/                       # 构建输出目录（自动生成）

关键说明

lib/main.dart
应用程序入口，通常调用 runApp() 启动根组件。
lib/src/
按功能模块划分代码，方便维护和扩展。现代项目推荐做清晰分层。
assets/
存放静态资源，需在 pubspec.yaml 中声明才能使用。
pubspec.yaml
核心配置文件，声明Flutter SDK版本、依赖包、资源路径、国际化等。
analysis_options.yaml
代码风格和静态检查配置，确保代码质量。

现代 Flutter 项目技术栈示例

状态管理：Provider / Riverpod / Bloc / GetX
网络请求：Dio / http
国际化：Flutter Intl（ARB 文件）
路由管理：GoRouter / AutoRoute
代码生成：Freezed（数据模型），JsonSerializable（序列化）
UI 框架：Material 3 / Cupertino Widgets
持续集成：GitHub Actions / Codemagic

Windows 下手动安装 Kotlin + Gradle 开发环境

✅ 一、准备条件

JDK（建议 JDK 17）

# 查看
java -version

# 默认安装路径
C:\Program Files\Java\jdk-17

Android SDK（用于构建 APK）

# 查看
sdkmanager --list

# 默认安装路径
C:\Users\<你的用户名>\AppData\Local\Android\Sdk

Gradle 构建工具

# 查看
gradle -v

# 默认安装路径
C:\Gradle\gradle-8.0

你下载并解压 Gradle 后，一般会放在一个目录，比如上面路径。

这个目录下有bin文件夹，里面有gradle.bat，需要把这个bin路径加到系统环境变量 PATH 中，才能全局使用gradle命令。

✅ 二、安装 JDK

1. 下载 JDK

推荐下载 OpenJDK 17：
https://jdk.java.net/17/

2. 安装并配置环境变量

假设你将 JDK 安装在：

C:\Program Files\Java\jdk-17

添加系统环境变量：

JAVA_HOME = C:\Program Files\Java\jdk-17
Path += %JAVA_HOME%\bin

✅ 三、安装 Gradle

1. 下载 Gradle

地址：https://gradle.org/releases/
下载 Binary-only 版本 zip 包

2. 解压并配置环境变量

假设你解压到：

C:\gradle\gradle-8.7

添加环境变量：

GRADLE_HOME = C:\gradle\gradle-8.7
Path += %GRADLE_HOME%\bin

3. 验证

gradle -v

✅ 四、安装 Android SDK（命令行方式）

1. 下载 Android 命令行工具

官方地址：https://developer.android.com/studio#command-tools
下载 zip 并解压到：
```
C:\Android\cmdline-tools\latest\
```

注意：解压后的目录结构必须是：

C:\Android\cmdline-tools\latest\bin

2. 配置环境变量

添加以下环境变量：

ANDROID_HOME=C:\Android
Path += C:\Android\platform-tools
Path += C:\Android\cmdline-tools\latest\bin

3. 安装必要组件

sdkmanager --sdk_root=C:\Android "platform-tools" "platforms;android-34" "build-tools;34.0.0"

✅ 五、创建 Kotlin + Gradle 项目

1. 创建项目结构

mkdir kotlin-app
cd kotlin-app
gradle init

在交互中选择：

Type of project: application
Language: Kotlin
Build script DSL: Kotlin
Test framework: JUnit

2. 项目结构

kotlin-app/
├── build.gradle.kts     // Kotlin DSL 构建脚本
├── settings.gradle.kts
└── src/
    └── main/
        └── kotlin/
            └── App.kt

3. 示例代码（`src/main/kotlin/App.kt`）

fun main() {
    println("你好，Kotlin！")
}

✅ 六、构建和运行项目

构建项目

gradle build

运行程序

gradle run

依赖管理

gradle dependencies   # 查看依赖树
gradle --refresh-dependencies  # 强制刷新依赖

✅ 七、常见问题建议

项目	建议版本/说明
JDK	JDK 17
Gradle	Gradle 8.x（支持 Kotlin DSL）
Kotlin	可使用内置 Gradle 插件版本
IDE	可选，命令行即可开发

✅ 附加资源

Kotlin 官方文档：https://kotlinlang.org/docs/home.html
Gradle Kotlin DSL 指南：https://docs.gradle.org/current/userguide/kotlin_dsl.html

Gradle国内镜像

bin.zip 只含运行环境。

腾讯：https://mirrors.cloud.tencent.com/gradle/gradle-8.4-bin.zip
阿里：https://mirrors.aliyun.com/gradle/gradle-8.4-bin.zip

Kotlin项目常见目录结构

MyAndroidProject/               # 项目根目录
├── app/                       # 应用模块（主程序）
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/           # Java 或 Kotlin 源代码目录
│   │   │   │   └── ...         # 按包名分目录，比如 com/example/app
│   │   │   ├── res/            # 资源文件目录（布局、图片、字符串等）
│   │   │   │   ├── layout/     # 界面布局 XML 文件
│   │   │   │   ├── drawable/   # 图片资源（png、jpg等）
│   │   │   │   ├── mipmap/     # 启动图标（多分辨率）
│   │   │   │   ├── values/     # 字符串、颜色、尺寸、样式等 XML
│   │   │   │   ├── font/       # 字体文件（ttf/otf）
│   │   │   │   └── anim/       # 动画资源 XML 文件
│   │   │   ├── AndroidManifest.xml  # 应用清单文件，配置应用信息、权限等
│   │   │   └── assets/         # 原始资源文件（无需预处理，如字体、html）
│   │   └── test/               # 单元测试代码目录
│   ├── build.gradle            # 模块级 Gradle 构建脚本
│   └── proguard-rules.pro      # 混淆配置文件
├── build/                     # 构建输出目录（编译生成文件）
├── gradle/                    # Gradle 包装器相关文件
│   └── wrapper/
│       └── gradle-wrapper.properties  # Gradle 版本配置
├── gradle.properties          # Gradle 全局配置参数
├── settings.gradle            # 项目设置文件（包含模块配置）
├── build.gradle               # 项目级 Gradle 构建脚本，配置插件版本等
└── local.properties           # 本地 SDK 路径等私有配置（通常不上传）

说明

app/src/main/java/：写业务逻辑代码、界面逻辑代码的地方，按包名组织。
app/src/main/res/：存放 UI 相关的静态资源，如布局文件、图片、字符串等。
AndroidManifest.xml：Android 应用的元数据文件，声明权限、组件等。
assets/：类似资源文件夹，但内容不被编译，可以原样读取（例如加载html）。
build.gradle（根目录）：定义项目通用配置、依赖管理、插件版本。
build.gradle（app目录）：定义模块级别的 SDK 版本、依赖库、构建配置。
local.properties：存放本地 SDK 路径，不应提交到版本控制。

项目环境依赖版本查看

项目文件	查什么版本	关键词示例
`gradle-wrapper.properties`	Gradle 构建版本	`distributionUrl=...gradle-8.4-bin.zip`
`build.gradle`（项目级）	Gradle 插件 / Kotlin 插件版本	`com.android.tools.build:gradle:8.4.0`
`gradle.properties`	Kotlin 配置 / JVM 参数	`kotlin.code.style=official`
`app/build.gradle`	compileSdk / minSdk / targetSdk / Kotlin 版本	`compileSdk 34`, `jvmTarget = "1.8"`
`dependencies`	所依赖的所有库和版本	`implementation 'androidx.core:core-ktx:1.15.0'`

安卓开发学习笔记

安卓开发学习笔记

Windows 系统手动安装 Flutter 环境

✅ 一、准备条件

Git（Flutter 安装依赖）

Android SDK（用于构建 APK）

JDK（建议 JDK 17）

✅ 二、安装 Flutter SDK

1. 下载 Flutter

2. 解压

3. 配置环境变量

✅ 三、安装 Android SDK（命令行方式）

1. 下载 Android 命令行工具

2. 配置环境变量

3. 安装必要组件

✅ 四、安装 JDK（建议 JDK 17）

✅ 五、验证安装

✅ 六、创建和构建项目

1. 创建项目

2. 构建 APK

✅ 附：常见建议

Flutter 现代化项目目录结构

关键说明

现代 Flutter 项目技术栈示例

Windows 下手动安装 Kotlin + Gradle 开发环境

✅ 一、准备条件

JDK（建议 JDK 17）

Android SDK（用于构建 APK）

Gradle 构建工具

✅ 二、安装 JDK

1. 下载 JDK

2. 安装并配置环境变量

✅ 三、安装 Gradle

1. 下载 Gradle

2. 解压并配置环境变量

3. 验证

✅ 四、安装 Android SDK（命令行方式）

1. 下载 Android 命令行工具

2. 配置环境变量

3. 安装必要组件

✅ 五、创建 Kotlin + Gradle 项目

1. 创建项目结构

2. 项目结构

3. 示例代码（src/main/kotlin/App.kt）

✅ 六、构建和运行项目

构建项目

运行程序

依赖管理

✅ 七、常见问题建议

✅ 附加资源

Gradle国内镜像

Kotlin项目常见目录结构

说明

项目环境依赖版本查看

3. 示例代码（`src/main/kotlin/App.kt`）