使用 Flutter 在 Windows 平台开发 Android 应用

以下是完整的开发流程，包括环境搭建、代码实现和应用发布，帮助你开发一个具有地图显示、TCP 通信功能的 Android 应用。

一、环境搭建

1. 安装 Flutter SDK

从 Flutter 官网下载最新稳定版 SDK
解压到本地目录（如 D:\flutter）
添加环境变量：
- FLUTTER_ROOT = D:\flutter
- 在 PATH 中添加 %FLUTTER_ROOT%\bin

2. 安装 Android Studio

从官网下载并安装 Android Studio
安装过程中选择安装 Android SDK、Android SDK Command-line Tools 和 Android Virtual Device

3. 配置 Android SDK

打开 Android Studio → SDK Manager
安装 Android 11 (R) 或更高版本
安装 Google Play services 和 Google Maps Android API

4. 安装 Flutter 和 Dart 插件

在 Android Studio 中，打开 File → Settings → Plugins
搜索并安装 Flutter 和 Dart 插件
重启 Android Studio

5. 验证环境配置

bash

flutter doctor

根据提示安装缺失的依赖（如 Android SDK 命令行工具、启用 USB 调试等）

二、创建 Flutter 项目

bash

flutter create map_tcp_app
cd map_tcp_app

三、添加依赖

在 pubspec.yaml 中添加以下依赖：

yaml

dependencies:flutter:sdk: fluttergoogle_maps_flutter: ^2.4.0      # 地图组件location: ^5.0.4                 # 位置服务permission_handler: ^10.4.3      # 权限管理tcp_socket_connection: ^1.0.3    # TCP通信provider: ^6.0.5                 # 状态管理fluttertoast: ^8.2.2             # 消息提示

运行 flutter pub get 安装依赖。

四、配置 AndroidManifest.xml

在 android/app/src/main/AndroidManifest.xml 中添加：

xml

<manifest xmlns:android="http://schemas.android.com/apk/res/android"><!-- 添加权限 --><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /><applicationandroid:label="map_tcp_app"android:icon="@mipmap/ic_launcher"><!-- 添加 Google Maps API 密钥 --><meta-dataandroid:name="com.google.android.geo.API_KEY"android:value="YOUR_GOOGLE_MAPS_API_KEY"/><activityandroid:name=".MainActivity"android:launchMode="singleTop"android:theme="@style/LaunchTheme"android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"android:hardwareAccelerated="true"android:windowSoftInputMode="adjustResize"><!-- 确保应用可以处理深层链接 --><intent-filter><action android:name="android.intent.action.MAIN"/><category android:name="android.intent.category.LAUNCHER"/></intent-filter></activity></application>
</manifest>

注意：需要替换 YOUR_GOOGLE_MAPS_API_KEY 为你在 Google Cloud Console 获取的 API 密钥。

五、实现地图与 TCP 通信功能

1. 状态管理（Provider）

创建 lib/providers/connection_provider.dart：

dart

import 'package:flutter/material.dart';
import 'package:tcp_socket_connection/tcp_socket_connection.dart';class ConnectionProvider with ChangeNotifier {late TcpSocketConnection _socket;bool _isConnected = false;String _serverMessage = '';String _serverIP = '15.113.126.155';int _serverPort = 5001;ConnectionProvider() {_initSocket();}void _initSocket() {_socket = TcpSocketConnection(_serverIP, _serverPort);_socket.connect().then((status) {_isConnected = status;if (status) {_serverMessage = '已连接到服务器';_startListening();} else {_serverMessage = '连接失败';}notifyListeners();});}void _startListening() {_socket.onMessageReceived((data) {_serverMessage = '服务器: $data';notifyListeners();});}void sendMessage(String message) {if (_isConnected) {_socket.sendMessage(message);}}void disconnect() {if (_isConnected) {_socket.disconnect();_isConnected = false;_serverMessage = '已断开连接';notifyListeners();}}void reconnect(String ip, int port) {_serverIP = ip;_serverPort = port;disconnect();_initSocket();}bool get isConnected => _isConnected;String get serverMessage => _serverMessage;String get serverIP => _serverIP;int get serverPort => _serverPort;
}

2. 主页面实现

修改 lib/main.dart：

dart

import 'package:flutter/material.dart';
import 'package:google_maps_flutter/google_maps_flutter.dart';
import 'package:location/location.dart';
import 'package:permission_handler/permission_handler.dart';
import 'package:provider/provider.dart';
import 'package:fluttertoast/fluttertoast.dart';
import 'providers/connection_provider.dart';void main() {runApp(MultiProvider(providers: [ChangeNotifierProvider(create: (_) => ConnectionProvider()),],child: const MyApp(),),);
}

六、自定义协议实现

在 lib/utils/protocol.dart 中添加：

import 'dart:convert';
import 'dart:typed_data';class Protocol {// 协议头标识static const int headerFlag = 0x55AA;// 构建消息包static Uint8List buildMessage(String content) {final contentBytes = utf8.encode(content);final buffer = ByteData(8 + contentBytes.length);// 设置协议头标识buffer.setUint16(0, headerFlag, Endian.big);// 设置消息长度buffer.setUint32(2, contentBytes.length, Endian.big);// 设置消息类型 (1: 文本消息)buffer.setUint16(6, 1, Endian.big);// 设置消息内容for (int i = 0; i < contentBytes.length; i++) {buffer.setUint8(8 + i, contentBytes[i]);}return buffer.buffer.asUint8List();}// 解析消息包static String? parseMessage(Uint8List data) {if (data.length < 8) return null;final buffer = ByteData.view(data.buffer);// 验证协议头final flag = buffer.getUint16(0, Endian.big);if (flag != headerFlag) return null;// 获取消息长度final length = buffer.getUint32(2, Endian.big);// 验证数据长度if (data.length < 8 + length) return null;// 获取消息内容final contentBytes = data.sublist(8, 8 + length);return utf8.decode(contentBytes);}
}

更新 ConnectionProvider 中的消息处理：

dart

// 在 ConnectionProvider 类中更新
void _startListening() {_socket.onMessageReceived((data) {final message = Protocol.parseMessage(Uint8List.fromList(data.codeUnits)) ?? data;_serverMessage = '服务器: $message';notifyListeners();});
}void sendMessage(String message) {if (_isConnected) {final packet = Protocol.buildMessage(message);_socket.sendMessage(String.fromCharCodes(packet));}
}