Flutter物理模拟插件synbiodio_physics的使用

Flutter物理模拟插件synbiodio_physics的使用

Synbiodio Physics

Synbiodio Physics 是一个用于实现物理模拟功能的 Flutter 插件。

安装 💻

⚠️ 在开始使用 Synbiodio Physics 之前，必须在您的机器上安装 Dart SDK。

在 pubspec.yaml 文件中添加 synbiodio_physics：

dependencies:
  synbiodio_physics:

然后运行以下命令来安装依赖：

dart pub get

持续集成 🤖

Synbiodio Physics 自带了由 Very Good Workflows 提供的 GitHub Actions 工作流，但您也可以根据需求添加自己的 CI/CD 解决方案。

默认情况下，每次拉取请求或推送时，CI 会自动格式化代码、进行静态分析并运行测试。项目使用了 Very Good Analysis 来确保代码的一致性。代码覆盖率通过 Very Good Workflows 进行强制执行。

运行测试 🧪

要运行所有单元测试，请执行以下步骤：

1. 全局激活 coverage 包：

   dart pub global activate coverage 1.2.0

2. 运行测试并生成覆盖率报告：

   dart test --coverage=coverage
   dart pub global run coverage:format_coverage --lcov --in=coverage --out=coverage/lcov.info

3. 使用 lcov 查看生成的覆盖率报告：

   # 生成覆盖率报告
   genhtml coverage/lcov.info -o coverage/
   
   # 打开覆盖率报告
   open coverage/index.html

示例代码

以下是一个简单的示例，展示如何使用 Synbiodio Physics 插件创建一个带有物理效果的 Flutter 应用程序。

import 'package:flutter/material.dart';
import 'package:synbiodio_physics/synbiodio_physics.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: PhysicsExample(),
    );
  }
}

class PhysicsExample extends StatefulWidget {
  [@override](/user/override)
  _PhysicsExampleState createState() => _PhysicsExampleState();
}

class _PhysicsExampleState extends State<PhysicsExample> {
  late final PhysicsWorld _physicsWorld;

  [@override](/user/override)
  void initState() {
    super.initState();

    // 初始化物理世界
    _physicsWorld = PhysicsWorld(
      gravity: Vector2(0, -9.81), // 设置重力为 -9.81 m/s²
    );

    // 启动物理世界
    _physicsWorld.start();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Synbiodio Physics 示例'),
      ),
      body: GestureDetector(
        onTapDown: (details) {
          // 当用户点击屏幕时创建一个物体
          final position = Vector2(
            details.globalPosition.dx,
            details.globalPosition.dy,
          );
          _physicsWorld.addBody(
            Body(
              position: position,
              velocity: Vector2(5, 0), // 初始速度
            ),
          );
        },
        child: CustomPaint(
          painter: PhysicsPainter(physicsWorld: _physicsWorld),
          size: Size.infinite,
        ),
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    // 停止物理世界
    _physicsWorld.stop();
    super.dispose();
  }
}

class PhysicsPainter extends CustomPainter {
  final PhysicsWorld physicsWorld;

  PhysicsPainter({required this.physicsWorld});

  [@override](/user/override)
  void paint(Canvas canvas, Size size) {
    final paint = Paint()
      ..color = Colors.blue
      ..style = PaintingStyle.fill;

    // 绘制所有物体
    physicsWorld.bodies.forEach((body) {
      final rect = Rect.fromLTWH(
        body.position.x - 20,
        body.position.y - 20,
        40,
        40,
      );
      canvas.drawRect(rect, paint);
    });
  }

  [@override](/user/override)
  bool shouldRepaint(covariant PhysicsPainter oldDelegate) {
    return true;
  }
}