Flutter插件zweidenker_heinzelmen的使用方法详解

这些是帮助Flutter开发的小工具，由ZWEIDENKER提供。

Flutter插件zweidenker_heinzelmen应用版本

在使用ZWEIDENKER的Flutter工作流构建Flutter应用时，构建号会基于pubspec.yaml文件中指定的版本生成，计算公式如下：

(major * 100000000) + (minor * 1000000) + (patch * 10000) + buildNumber

AppVersion小部件根据上述公式获取到构建号，并将其格式化为major.minor.patch+build。

const AppVersion(
  style: TextStyle(
    fontSize: 20,
    fontWeight: FontWeight.bold,
  ),
),

完整示例Demo

import 'package:flutter/material.dart';
import 'package:zweidenker_heinzelmen/app_version.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('App Version Demo')),
        body: Center(
          child: AppVersion(
            style: TextStyle(
              fontSize: 20,
              fontWeight: FontWeight.bold,
            ),
          ),
        ),
      ),
    );
  }
}

功能开关

功能开关是一个辅助工具，用于在某个小部件上注册点击事件。如果点击次数达到一定数量，则回调返回true，表示可以显示或激活该功能。这主要用于在点击某个小部件一定时间后显示额外的设置。

const featureToggle = FeatureToggle(
  requiredTaps: 3,
  coolOff: const Duration(seconds: 2),
);

...

GestureDetector(
    onTap: () {
      final enabled = featureToggle.registerTap();
      if (enabled) {
        setState(() {
            showFeature = true;
        });
      }  
    },
    child: const Text('Tap me'),
)

完整示例Demo

import 'package:flutter/material.dart';
import 'package:zweidenker_heinzelmen/feature_toggle.dart';

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

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

class _MyAppState extends State<MyApp> {
  bool showFeature = false;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Feature Toggle Demo')),
        body: GestureDetector(
          onTap: () {
            final enabled = featureToggle.registerTap();
            if (enabled) {
              setState(() {
                showFeature = true;
              });
            }  
          },
          child: const Text('Tap me'),
        ),
        floatingActionButton: showFeature ? FloatingActionButton(onPressed: () {}, child: Icon(Icons.settings)) : null,
      ),
    );
  }
}

链接启动器

链接启动器是一个简单的抽象层，用于启动链接。这样可以更方便地进行测试，外部打开链接或者在应用内部以标签页的形式打开链接。 如果你在iOS上使用checkTrackingPermission，则需要在你的Info.plist文件中声明NSUserTrackingUsageDescription的使用。

<key>NSUserTrackingUsageDescription</key>
<string>This website uses cookies to make the experience user-friendly and effective.</string>

完整示例Demo

import 'package:flutter/material.dart';
import 'package:url_launcher/url_launcher.dart';
import 'package:zweidenker_heinzelmen/link_launcher.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Link Launcher Demo')),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              await launchUrl(Uri.parse('https://flutter.dev'));
            },
            child: Text('Open Link'),
          ),
        ),
      ),
    );
  }
}

简单加载器混入

简单加载器混入为小部件提供了简单的加载功能。它提供了loading、error和data变量，以便根据状态构建UI。

// 假设有一个简单的加载器混入
mixin SimpleLoaderMixin<T> on State<T> {
  bool loading = false;
  dynamic error;
  dynamic data;

  void fetchData() async {
    setState(() {
      loading = true;
    });

    try {
      // 模拟数据获取
      data = await Future.delayed(Duration(seconds: 2), () => "Data Loaded");
    } catch (e) {
      error = e;
    }

    setState(() {
      loading = false;
    });
  }
}

完整示例Demo

import 'package:flutter/material.dart';
import 'package:zweidenker_heinzelmen/simple_loader_mixin.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Simple Loader Mixin Demo')),
        body: Center(
          child: MyWidget(),
        ),
      ),
    );
  }
}

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

class _MyWidgetState extends State<MyWidget> with SimpleLoaderMixin<MyWidget> {
  [@override](/user/override)
  void initState() {
    super.initState();
    fetchData();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    if (loading) {
      return CircularProgressIndicator();
    } else if (error != null) {
      return Text("Error: $error");
    } else if (data != null) {
      return Text("Data: $data");
    } else {
      return Text("Loading...");
    }
  }
}