Bubble Bottom Bar 项目教程

1. 项目目录结构及介绍

bubble_bottom_bar/
├── lib/
│   ├── bubble_bottom_bar.dart
│   ├── bubble_bottom_bar_item.dart
│   └── main.dart
├── pubspec.yaml
├── README.md
└── test/
    └── bubble_bottom_bar_test.dart

目录结构说明

• lib/: 包含项目的核心代码文件。

  • bubble_bottom_bar.dart: 定义了 BubbleBottomBar 组件的主要逻辑和界面。
  • bubble_bottom_bar_item.dart: 定义了 BubbleBottomBarItem 组件，用于每个底部导航栏的选项。
  • main.dart: 项目的启动文件，包含应用的入口函数 main()。

• pubspec.yaml: 项目的配置文件，定义了项目的依赖、版本信息等。

• README.md: 项目的说明文档，通常包含项目的简介、安装方法、使用示例等。

• test/: 包含项目的测试代码。

  • bubble_bottom_bar_test.dart: 针对 BubbleBottomBar 组件的单元测试文件。

2. 项目启动文件介绍

main.dart

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Bubble Bottom Bar Example'),
        ),
        body: Center(
          child: Text('Hello, Bubble Bottom Bar!'),
        ),
        bottomNavigationBar: BubbleBottomBar(
          opacity: .2,
          currentIndex: 0,
          onTap: (index) {},
          borderRadius: BorderRadius.vertical(top: Radius.circular(16)),
          elevation: 8,
          items: [
            BubbleBottomBarItem(
              backgroundColor: Colors.red,
              icon: Icon(Icons.dashboard, color: Colors.black),
              activeIcon: Icon(Icons.dashboard, color: Colors.red),
              title: Text("Home"),
            ),
            BubbleBottomBarItem(
              backgroundColor: Colors.deepPurple,
              icon: Icon(Icons.access_time, color: Colors.black),
              activeIcon: Icon(Icons.access_time, color: Colors.deepPurple),
              title: Text("History"),
            ),
          ],
        ),
      ),
    );
  }
}

启动文件说明

• main(): 应用的入口函数，调用 runApp() 方法启动应用。
• MyApp: 应用的主组件，继承自 StatelessWidget，定义了应用的整体结构。
• MaterialApp: 应用的根组件，配置了应用的主题、路由等。
• Scaffold: 提供了应用的基本布局结构，包括 AppBar、Body 和 BottomNavigationBar。
• BubbleBottomBar: 自定义的底部导航栏组件，配置了导航栏的样式和选项。

3. 项目配置文件介绍

pubspec.yaml

name: bubble_bottom_bar
description: A Flutter package for a customizable bottom navigation bar.
version: 2.0.0

environment:
  sdk: ">=2.12.0 <3.0.0"

dependencies:
  flutter:
    sdk: flutter
  badges: ^2.0.0

dev_dependencies:
  flutter_test:
    sdk: flutter

flutter:
  uses-material-design: true

配置文件说明

• name: 项目的名称。
• description: 项目的简要描述。
• version: 项目的版本号。
• environment: 定义了项目所需的 Dart SDK 版本范围。
• dependencies: 列出了项目依赖的其他包，如 flutter 和 badges。
• dev_dependencies: 列出了开发依赖的包，如 flutter_test。
• flutter: 配置了 Flutter 相关的设置，如 uses-material-design。

通过以上内容，您可以了解 Bubble Bottom Bar 项目的目录结构、启动文件和配置文件的基本信息。希望这份教程对您有所帮助！