nmbh1122@126.com
410 lines
6.0 KiB
Markdown
410 lines
6.0 KiB
Markdown
# Flutter 项目如何写 Android 应用
|
||
|
||
Flutter 不是“Web 项目”或“Android 项目”分开的。当前项目是一个跨平台 Flutter App，只是当前调试时默认选中了 Web。要写 Android 应用，主要还是写 `lib/` 里的 Flutter 代码，然后用 Android 设备或模拟器运行。
|
||
|
||
## 核心结论
|
||
|
||
写 Android App 主要还是写这里：
|
||
|
||
```text
|
||
lib/
|
||
main.dart
|
||
app/
|
||
features/
|
||
shared/
|
||
```
|
||
|
||
不是主要写：
|
||
|
||
```text
|
||
android/
|
||
```
|
||
|
||
`android/` 是 Android 原生壳工程，只有在需要权限、包名、签名、原生 SDK 时才改。
|
||
|
||
## 为什么默认打开是 Web
|
||
|
||
因为当前环境里 Flutter 可用的设备可能优先显示了 Web，或者 IDE 选择的运行设备是 Chrome / Web。
|
||
|
||
可以用这个命令看当前可用设备：
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
如果看到类似：
|
||
|
||
```text
|
||
Chrome (web)
|
||
Linux (desktop)
|
||
Android SDK built for x86
|
||
```
|
||
|
||
说明 Flutter 可以选择不同平台运行。
|
||
|
||
运行 Web 是：
|
||
|
||
```bash
|
||
flutter run -d chrome
|
||
```
|
||
|
||
运行 Android 是：
|
||
|
||
```bash
|
||
flutter run -d <android-device-id>
|
||
```
|
||
|
||
## 要运行 Android 需要准备什么
|
||
|
||
### 1. Android SDK
|
||
|
||
当前环境里已经有 Android SDK：
|
||
|
||
```text
|
||
Android SDK version 37.0.0
|
||
```
|
||
|
||
这个没问题。
|
||
|
||
### 2. Android 模拟器或真机
|
||
|
||
需要至少有一个 Android 设备。
|
||
|
||
检查：
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
如果没有 Android 设备，需要：
|
||
|
||
- 打开 Android Studio
|
||
- 启动 Android Emulator
|
||
- 或者连接 Android 手机并打开 USB 调试
|
||
|
||
## 用真机运行 Android
|
||
|
||
手机上操作：
|
||
|
||
1. 打开开发者选项
|
||
2. 打开 USB 调试
|
||
3. 用 USB 连接电脑
|
||
4. 手机弹出授权时点允许
|
||
|
||
然后电脑运行：
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
如果看到类似：
|
||
|
||
```text
|
||
xxx device • android-arm64 • Android xx
|
||
```
|
||
|
||
就可以运行：
|
||
|
||
```bash
|
||
flutter run -d xxx
|
||
```
|
||
|
||
如果只有一个 Android 设备，也可以：
|
||
|
||
```bash
|
||
flutter run
|
||
```
|
||
|
||
## 用模拟器运行 Android
|
||
|
||
如果使用 Android Studio：
|
||
|
||
1. 打开 Android Studio
|
||
2. 打开 Device Manager
|
||
3. 创建一个 Android Virtual Device
|
||
4. 启动模拟器
|
||
5. 回到项目目录运行：
|
||
|
||
```bash
|
||
flutter devices
|
||
flutter run
|
||
```
|
||
|
||
或者指定设备：
|
||
|
||
```bash
|
||
flutter run -d emulator-5554
|
||
```
|
||
|
||
## Android 应用代码写哪里
|
||
|
||
Flutter 页面、业务逻辑、状态管理还是写在：
|
||
|
||
```text
|
||
lib/
|
||
```
|
||
|
||
例如：
|
||
|
||
```text
|
||
lib/
|
||
main.dart
|
||
app/
|
||
app.dart
|
||
theme.dart
|
||
features/
|
||
home/
|
||
home_page.dart
|
||
```
|
||
|
||
Android 和 Web 会共用这套 Dart 代码。
|
||
|
||
也就是说，写：
|
||
|
||
```dart
|
||
Scaffold(
|
||
appBar: AppBar(title: const Text('首页')),
|
||
body: const Center(child: Text('这是 Android App')),
|
||
)
|
||
```
|
||
|
||
它既可以跑在 Android，也可以跑在 Web。只是最终运行目标不同。
|
||
|
||
## 什么时候才需要改 `android/`
|
||
|
||
平时不要一开始就去 `android/` 写代码。
|
||
|
||
只有这些情况需要改：
|
||
|
||
### 1. 改 Android 包名
|
||
|
||
比如从默认包名改成：
|
||
|
||
```text
|
||
com.yourcompany.patbond
|
||
```
|
||
|
||
会涉及：
|
||
|
||
```text
|
||
android/app/build.gradle.kts
|
||
android/app/src/main/AndroidManifest.xml
|
||
android/app/src/main/kotlin/...
|
||
```
|
||
|
||
### 2. 加 Android 权限
|
||
|
||
比如相机、相册、定位、网络、蓝牙。
|
||
|
||
一般改：
|
||
|
||
```text
|
||
android/app/src/main/AndroidManifest.xml
|
||
```
|
||
|
||
例如网络权限：
|
||
|
||
```xml
|
||
<uses-permission android:name="android.permission.INTERNET" />
|
||
```
|
||
|
||
定位权限：
|
||
|
||
```xml
|
||
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
|
||
```
|
||
|
||
### 3. 配置应用图标和启动页
|
||
|
||
常见会用插件：
|
||
|
||
```text
|
||
flutter_launcher_icons
|
||
flutter_native_splash
|
||
```
|
||
|
||
### 4. 配置签名打包
|
||
|
||
发布 APK / AAB 时需要改 Android 签名配置。
|
||
|
||
常见文件：
|
||
|
||
```text
|
||
android/key.properties
|
||
android/app/build.gradle.kts
|
||
```
|
||
|
||
### 5. 接入原生 SDK
|
||
|
||
比如：
|
||
|
||
- 微信登录
|
||
- 支付宝支付
|
||
- 高德地图
|
||
- 极光推送
|
||
- Firebase
|
||
- 原生蓝牙能力
|
||
|
||
## 现在应该怎么开始写 Android App
|
||
|
||
建议顺序：
|
||
|
||
1. 先把运行设备切到 Android
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
然后选择 Android 设备运行：
|
||
|
||
```bash
|
||
flutter run -d 设备ID
|
||
```
|
||
|
||
2. 不要改 `android/`，先写 `lib/`
|
||
|
||
把默认计数器 Demo 替换成自己的首页。
|
||
|
||
3. 按这个结构开始：
|
||
|
||
```text
|
||
lib/
|
||
main.dart
|
||
app/
|
||
app.dart
|
||
theme.dart
|
||
features/
|
||
home/
|
||
home_page.dart
|
||
```
|
||
|
||
4. 如果后面需要接口，再加：
|
||
|
||
```text
|
||
lib/core/network/
|
||
```
|
||
|
||
5. 如果需要登录，再加：
|
||
|
||
```text
|
||
lib/features/auth/
|
||
```
|
||
|
||
6. 如果需要 Android 权限，再去改：
|
||
|
||
```text
|
||
android/app/src/main/AndroidManifest.xml
|
||
```
|
||
|
||
## Android 和 Web 写法有什么区别
|
||
|
||
大部分 UI 和业务代码一样。
|
||
|
||
但是有些能力要注意平台差异：
|
||
|
||
```text
|
||
相机
|
||
相册
|
||
定位
|
||
蓝牙
|
||
文件系统
|
||
推送
|
||
支付
|
||
扫码
|
||
后台服务
|
||
本地通知
|
||
```
|
||
|
||
这些功能在 Android 上通常需要：
|
||
|
||
- Flutter 插件
|
||
- Android 权限
|
||
- 有时还需要 Android 原生配置
|
||
|
||
例如访问相机，可能需要：
|
||
|
||
```yaml
|
||
dependencies:
|
||
image_picker: ^x.x.x
|
||
```
|
||
|
||
然后 AndroidManifest 里配置权限。
|
||
|
||
## 如何确认现在运行的是 Android
|
||
|
||
运行成功后，终端会显示类似：
|
||
|
||
```text
|
||
Launching lib/main.dart on Android SDK built for x86 in debug mode...
|
||
```
|
||
|
||
如果是 Web，则会显示：
|
||
|
||
```text
|
||
Launching lib/main.dart on Chrome in debug mode...
|
||
```
|
||
|
||
所以看这一行就知道当前跑在哪个平台。
|
||
|
||
## 常用命令
|
||
|
||
查看设备：
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
运行到 Android：
|
||
|
||
```bash
|
||
flutter run -d <android-device-id>
|
||
```
|
||
|
||
运行到 Chrome：
|
||
|
||
```bash
|
||
flutter run -d chrome
|
||
```
|
||
|
||
构建 Android APK：
|
||
|
||
```bash
|
||
flutter build apk
|
||
```
|
||
|
||
构建 Android App Bundle，发布 Google Play 用：
|
||
|
||
```bash
|
||
flutter build appbundle
|
||
```
|
||
|
||
清理构建缓存：
|
||
|
||
```bash
|
||
flutter clean
|
||
```
|
||
|
||
重新拉依赖：
|
||
|
||
```bash
|
||
flutter pub get
|
||
```
|
||
|
||
## 建议先做这一步
|
||
|
||
先运行：
|
||
|
||
```bash
|
||
flutter devices
|
||
```
|
||
|
||
如果能看到 Android 设备，就用它的 ID 运行：
|
||
|
||
```bash
|
||
flutter run -d 设备ID
|
||
```
|
||
|
||
如果看不到 Android 设备，那不是代码问题，是还没有连接真机或启动模拟器。
|
||
|
||
代码开发上，继续写 `lib/` 即可。Flutter 的 Android App 本质上就是这套 Dart UI 跑在 Android 容器里。
|