如何在Android Studio中创建并使用Dart Frog项目？

一、准备工作 #

先完成基础环境配置：

• 安装Dart SDK（版本需≥2.19.0），可通过dart --version验证安装状态
• 安装Dart Frog CLI工具，执行命令：

  dart pub global activate dart_frog_cli
  

  安装后确认pub global的路径已加入系统环境变量（macOS/Linux为~/.pub-cache/bin，Windows为%APPDATA%\Pub\Cache\bin），避免dart_frog命令无法识别
• 在Android Studio中安装Dart插件：打开Settings > Plugins，搜索"Dart"并启用

二、创建Dart Frog项目 #

直接在Android Studio终端完成项目创建：

1. 打开Android Studio底部的Terminal标签
2. 切换到项目存放目录，示例：

   cd ~/Projects
   

3. 执行创建命令，替换my_dart_frog_service为你的项目名：

   dart_frog create my_dart_frog_service
   

4. 项目生成后，通过File > Open选择刚创建的项目文件夹，导入到Android Studio

三、核心项目结构说明 #

导入后可见标准Dart Frog项目结构：

• lib/：核心代码目录
  • main.dart：服务入口文件，负责启动Dart Frog服务
  • routes/：路由逻辑存放目录，每个文件对应一个接口路径（如routes/user.dart对应/user接口）
• pubspec.yaml：依赖配置文件，可在此添加第三方Dart包
• test/：单元测试代码目录，用于编写接口测试用例

四、运行项目 #

启动开发服务器步骤：

1. 在终端切换到项目根目录：

   cd my_dart_frog_service
   

2. 执行开发启动命令：

   dart_frog dev
   

3. 服务启动后默认监听http://localhost:8080，可通过浏览器访问或curl测试：

   curl http://localhost:8080
   

   会返回默认的Hello World!响应

五、编写自定义路由 #

添加一个带参数的接口示例：

1. 在lib/routes目录新建welcome.dart文件
2. 写入如下代码：

   import 'package:dart_frog/dart_frog.dart';
   
   Response onRequest(RequestContext context) {
     final username = context.request.uri.queryParameters['username'] ?? 'Stranger';
     return Response(body: 'Welcome, $username!');
   }
   

3. 保存后访问http://localhost:8080/welcome?username=Bob，即可得到Welcome, Bob!的响应

六、调试项目 #

Android Studio支持断点调试：

1. 执行带调试参数的启动命令：

   dart_frog dev --debug
   

2. 命令输出中会显示调试端口（默认8181）
3. 点击Android Studio的Run > Attach to Process，选择对应端口的Dart进程，即可开始调试
4. 在路由代码中设置断点，发起请求后就能触发断点调试

常见问题解决 #

• dart_frog命令无法识别：检查环境变量是否包含pub global路径，或重启Android Studio
• 依赖拉取失败：在项目根目录执行dart pub get手动同步依赖
• 端口被占用：执行dart_frog dev --port 9090指定其他端口启动服务

内容的提问来源于stack exchange，提问作者Roger Gusmao