Flutter消息分段计算插件message_segment_calculator的使用

《SMS Segment Calculator》是一款Dart包，专为开发者准确计算短信所需的段数而设计。它支持GSM-7和UCS-2编码标准，为涉及短信的应用程序提供了一个强大的解决方案。该包通过优化消息分割和编码来确保成本效益。

主要特性

• 准确的消息分段：根据消息内容和所需编码（GSM-7或UCS-2）自动计算所需的段数。
• 特殊字符和表情符号的支持：检测包含表情符号或特殊字符的文本，并在必要时切换到UCS-2编码。
• 全面的编码管理：处理单个字符的编码并管理其转换为适当的编码格式。
• 成本管理：提供精确的段数计数，以有效预算和规划短信费用。
• 行断处理：识别不同的行断风格，并在检测到不兼容的风格时发出警告。

安装

要在Dart或Flutter项目中集成《SMS Segment Calculator》，请将以下依赖项添加到pubspec.yaml文件中：

dependencies:
  sms_segment_calculator: ^0.1.0

使用

import 'package:flutter/material.dart';
import 'package:message_segment_calculator/src/segmented_message.dart';

void main() {
  runApp(const App());
}

/// 应用程序的根小部件。
class App extends StatelessWidget {
  const App({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const MaterialApp(
      home: MessageSegmentCalculatorWidget(),
    );
  }
}

/// 提供用于计算消息段的小部件。
class MessageSegmentCalculatorWidget extends StatefulWidget {
  const MessageSegmentCalculatorWidget({super.key});

  [@override](/user/override)
  State<MessageSegmentCalculatorWidget> createState() => _MessageSegmentCalculatorWidgetState();
}

/// MessageSegmentCalculatorWidget的状态类。
class _MessageSegmentCalculatorWidgetState extends State<MessageSegmentCalculatorWidget> {
  final textEditingController = TextEditingController();
  SegmentedMessage? segmentedMessage;

  [@override](/user/override)
  void dispose() {
    textEditingController.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('消息段计算器'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(10),
        child: Column(
          children: [
            const Text('输入文本'),
            const SizedBox(height: 10),
            TextFormField(
              decoration: const InputDecoration(),
              controller: textEditingController,
              onChanged: (value) {
                setState(() {
                  segmentedMessage = SegmentedMessage(value);
                });
              },
            ),
            const SizedBox(height: 10),
            Text('字符数量: ${segmentedMessage?.numberOfCharacters}'),
            Text('段数量: ${segmentedMessage?.segmentsCount}'),
            Text('Unicode标量数量: ${segmentedMessage?.numberOfUnicodeScalars}'),
            Text('消息大小（位）: ${segmentedMessage?.messageSize}'),
            Text('总大小（位）: ${segmentedMessage?.totalSize}'),
          ],
        ),
      ),
    );
  }
}

关键补充

• 详细描述：每个类都有解释，以明确其在包中的作用。
• 使用示例：展示一个实用示例，帮助开发人员快速理解如何使用该包。
• 安装指南：指导用户如何将其添加到他们的项目中。
• 贡献指南：鼓励贡献，并提供了问题页面的链接。

此README提供了全面的概述，使用户更容易理解和有效地使用该包。

示例代码

import 'package:flutter/material.dart';
import 'package:message_segment_calculator/src/segmented_message.dart';

/// 应用程序的主入口点。
void main() {
  runApp(const App());
}

/// 应用程序的根小部件。
class App extends StatelessWidget {
  /// 构造一个[App]小部件。
  const App({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    /// 构建包含[MessageSegmentCalculatorWidget]的[MaterialApp]。
    return const MaterialApp(
      home: MessageSegmentCalculatorWidget(),
    );
  }
}

/// 提供一个用于计算消息段的小部件。
///
/// 此小部件使用[SegmentedMessage]类来基于用户在文本字段中的输入计算字符数量、段数量、Unicode标量数量、消息大小（位）和总大小（位）。
class MessageSegmentCalculatorWidget extends StatefulWidget {
  /// 构造一个[MessageSegmentCalculatorWidget]。
  const MessageSegmentCalculatorWidget({super.key});

  [@override](/user/override)
  State<MessageSegmentCalculatorWidget> createState() => _MessageSegmentCalculatorWidgetState();
}

/// MessageSegmentCalculatorWidget的状态类。
class _MessageSegmentCalculatorWidgetState extends State<MessageSegmentCalculatorWidget> {
  /// 控制用户输入消息文本的文本字段。
  final textEditingController = TextEditingController();

  /// 保存分段消息数据以显示结果。
  SegmentedMessage? segmentedMessage;

  [@override](/user/override)
  void dispose() {
    /// 在小部件被销毁时处置[textEditingController]。
    textEditingController.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    /// 构建消息段计算器的UI。
    return Scaffold(
      appBar: AppBar(
        title: const Text('消息段计算器'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(10),
        child: Column(
          children: [
            const Text('输入文本'),
            const SizedBox(
              height: 10,
            ),
            TextFormField(
              decoration: const InputDecoration(),
              controller: textEditingController,
              onChanged: (value) {
                setState(() {
                  /// 每当文本输入更改时更新[segmentedMessage]。
                  segmentedMessage = SegmentedMessage(value);
                });
              },
            ),
            const SizedBox(
              height: 10,
            ),

            /// 显示消息分段计算的结果。
            Text('字符数量: ${segmentedMessage?.numberOfCharacters}'),
            Text('段数量: ${segmentedMessage?.segmentsCount}'),
            Text('Unicode标量数量: ${segmentedMessage?.numberOfUnicodeScalars}'),
            Text('消息大小（位）: ${segmentedMessage?.messageSize}'),
            Text('总大小（位）: ${segmentedMessage?.totalSize}'),
          ],
        ),
      ),
    );
  }
}