Flutter单位转换插件ucum的使用

发布于 1周前 作者 phonegap100 来自 Flutter

Flutter单位转换插件ucum的使用

Dart Library Mimicking the Unified Code for Units of Measure FHIR Library Functionality

感谢所有贡献者

所有功劳归于（我猜是）Graham以及其他在ChatGPT的帮助下将此库用Java编写出来的人。在他们的帮助下，我已经成功地将该库移植到了Dart。

使用说明

该包提供了围绕UCUM的一系列服务：

  1. 获取UCUM服务 首先，我们需要获取UCUM服务。

    // 获取UCUM服务实例
UcumService ucumService = await getUcumEssenceService();

  2. 验证UCUM单位 可以验证一个UCUM单位是否有效，也可以验证它是否与特定的基本单位一致。

    // 验证单位
bool isValid = ucumService.validate('/min');

  3. 单位转换 可以决定一个单位是否可以转换为另一个单位，并进行转换。

    // 将15分钟转换为小时
Decimal result = await ucumService.convert(Decimal.fromString('15'), '/min', '/h');

  4. 准备可读显示 可以准备一个单位的可读显示。

    // 准备可读显示
String readableUnit = ucumService.prepareDisplay('15 /min');

  5. 单位相乘 可以将两个量相乘。

    // 将两个量相乘
Decimal multipliedValue = ucumService.multiply(Decimal.fromString('15'), '/min', Decimal.fromString('2'));

维护声明

虽然我会维护这个包，但我要确保给予所有贡献者应得的正确致谢。

原始版权声明

/*******************************************************************************
BSD 3-Clause License

Copyright (c) 2023, Grey Faulkenberry
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this
  list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice,
  this list of conditions and the following disclaimer in the documentation
  and/or other materials provided with the distribution.

* Neither the name of the copyright holder nor the names of its
  contributors may be used to endorse or promote products derived from
  this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

*******************************************************************************/

示例代码

以下是一个完整的示例，展示了如何使用ucum插件进行单位转换。

import 'package:test/test.dart';
import 'package:ucum/ucum.dart';

void main() {
  group("grey's tests", () {
    late UcumService ucumService;

    setUpAll(() {
      ucumService = getUcumService();
    });

    test('make units', () {
      // 创建一个表示4小时的ValidatedQuantity对象
      final ValidatedQuantity quantity1 = ValidatedQuantity.fromString('4 hours');
      expect(quantity1.value.asUcumDecimal(), '4');
      expect(quantity1.unit, 'hours');

      // 创建一个表示16.5559988英里每小时的ValidatedQuantity对象
      final ValidatedQuantity quantity2 = ValidatedQuantity.fromString('16.5559988 mph');
      expect(ucumService.validate(quantity2.unit), isNull);
    });

    test('Equal', () {
      // 检查4米和400厘米是否相等
      final ValidatedQuantity quantity3 = ValidatedQuantity.fromString('4 m');
      final ValidatedQuantity quantity4 = ValidatedQuantity.fromString('400 cm');
      expect(ucumService.isEqual(quantity3, quantity4), true);

      // 检查2.54厘米和1英寸是否相等
      final ValidatedQuantity quantity5 = ValidatedQuantity.fromString('2.54 cm');
      final ValidatedQuantity quantity6 = ValidatedQuantity.fromString('1 inch');
      expect(ucumService.isEqual(quantity5, quantity6), true);
      expect(ucumService.isEqual(quantity6, quantity5), true);
    });
  });
}

// 获取UCUM服务实例
UcumService getUcumService() => UcumService();

更多关于Flutter单位转换插件ucum的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter单位转换插件ucum的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter项目中使用ucum（Unified Code for Units of Measure）单位转换插件的一个示例。这个示例将展示如何安装插件、导入必要的包以及进行基本的单位转换。

1. 安装ucum插件

首先，你需要在pubspec.yaml文件中添加ucum依赖项。确保你的Flutter环境已经配置好，并且你正在使用的IDE（如VSCode或Android Studio）已经打开了你的Flutter项目。

dependencies:
  flutter:
    sdk: flutter
  ucum: ^最新版本号 # 请替换为实际的最新版本号

运行flutter pub get来安装依赖项。

2. 导入ucum包

在你的Dart文件中，导入ucum包。例如，在main.dart中：

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

3. 使用ucum进行单位转换

以下是一个简单的示例，展示如何将米转换为英尺：

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('UCUM Unit Conversion Example'),
        ),
        body: Center(
          child: ConversionExample(),
        ),
      ),
    );
  }
}

class ConversionExample extends StatefulWidget {
  @override
  _ConversionExampleState createState() => _ConversionExampleState();
}

class _ConversionExampleState extends State<ConversionExample> {
  String result = '';

  @override
  void initState() {
    super.initState();
    _convertUnits();
  }

  void _convertUnits() async {
    // 初始化ucum库
    Ucum ucum = Ucum();
    await ucum.load();

    // 将1米转换为英尺
    double meters = 1.0;
    double feet = ucum.convert(meters, 'm', 'ft');

    setState(() {
      result = '1 meter is equal to $feet feet.';
    });
  }

  @override
  Widget build(BuildContext context) {
    return Text(result);
  }
}

4. 运行应用

确保你的Flutter开发环境配置正确，然后运行应用：

flutter run

这个示例展示了如何初始化ucum库，加载单位定义，并将1米转换为英尺。请注意，ucum.load()是一个异步操作，因此我们使用await关键字等待它完成。在实际应用中，你可能希望将转换逻辑放在一个按钮点击事件中，而不是在initState中直接调用，以提高用户体验。

注意事项

  • 确保你使用的ucum版本是最新的，因为库的API可能会随着版本更新而变化。
  • ucum库可能不支持所有单位转换，所以在使用前请查阅库的文档以了解支持哪些单位。
  • 对于复杂的单位转换，可能需要更详细的错误处理和用户反馈机制。

希望这个示例对你有所帮助！

回到顶部