MPFlutter 工程模板

本仓库是 MPFlutter 工程壳模板，你可以下载本仓库，并根据需要移除不必要的部分，然后开始开发。

在根目录下，weapp 是微信小程序工程，web 是 H5 工程，如果你不需要对应的输出端，可以移除。

Flutter 版本要求

本模板 master 分支要求 Flutter 版本 >= 3.7.0。

如果你的 Flutter 版本 < 3.7.0，请使用 flutter_3.3.0 分支。

环境准备

至少需要以下开发环境

• 操作系统：macOS / Windows / Linux 任一操作系统
• 代码编辑器：VSCode
• VSCode 扩展：Dart 和 Flutter
• Flutter 开发环境
• Chrome 浏览器

Flutter 开发环境可以在 https://flutter.dev 或 https://flutter-io.cn 下载安装。

开发

1. 使用 Git clone 或直接下载本仓库，使用 VSCode 打开本仓库根目录。
2. 使用命令行，locate 到本仓库根目录，执行命令 ./mpflutter packages get（划重点，这里是执行 ./mpflutter 而不是 flutter）。
3. 按下键盘上的 'F5' 键，开始调试，在 VSCode 的调试控制台上出现如下输出。

Connecting to VM Service at http://127.0.0.1:61276/OgoUGNgV_fE=/
lib/main.dart: Warning: Interpreting this as package URI, 'package:mpflutter_template/main.dart'.
Hot reloading enabled
Listening for file changes at ./lib
Serve on 0.0.0.0:9898
Use browser open http://0.0.0.0:9898/index.html or use MiniProgram Developer Tools import './dist/weapp' for dev.

3. 打开 Chrome 浏览器，输入网址 http://0.0.0.0:9898/index.html ，如无意外，你将看到 Hello, MPFlutter! 提示。
4. 在 VSCode 中打开 lib/main.dart，尝试修改 Hello, MPFlutter! 文本，并保存，看看是否可以实现 Hot-Reload?
5. 如果没有问题，你可以在 lib 目录下开展业务开发了。

微信小程序

如果需要在微信小程序中实现边开发边调试能力，可以直接将 weapp 目录导入到『微信开发者工具』中。

你也可以通过修改 weapp 目录下的文件，实现定制化功能。

构建

H5

使用操作系统的命令行工具，locate 到工程根目录，执行以下命令。

dart scripts/build_web.dart

执行完成后，H5 产物在 build 目录下，你可以上传到 HTTP 服务器上使用。

微信小程序

使用操作系统的命令行工具，locate 到工程根目录，执行以下命令。

dart scripts/build_weapp.dart

执行完成后，微信小程序产物在 build 目录下，你可以打开『微信开发者工具』，导入 build 目录，进一步编译、测试并上传审核。