Flutter Telegram集成插件telegram的使用

简介

telegram 是一个轻量级的Flutter插件，用于通过Telegram发送消息。它提供了简单易用的功能，如发送消息、生成和复制Telegram链接等。

功能

• 📨 通过Telegram发送消息
• 🔗 生成Telegram链接
• 📌 复制Telegram链接到剪贴板
• 🔥 更多功能即将推出…

安装

方法一：通过命令行安装

flutter pub add telegram

方法二：在 pubspec.yaml 中添加依赖

dependencies:
  telegram:

使用方法 📨

发送消息

import 'package:telegram/telegram.dart';

// 发送消息给指定用户
Telegram.send(
  username: 'UsamaSarwar',
  message: 'Thanks for building Telegram Package :)',
);

复制Telegram链接到剪贴板

import 'package:telegram/telegram.dart';

// 复制链接到剪贴板
Telegram.copyLinkToClipboard(
  username: 'UsamaSarwar',
  message: 'Thanks for building Telegram Package :)',
);

获取Telegram消息链接

import 'package:telegram/telegram.dart';

// 获取链接作为字符串
String link = Telegram.getLink(
  username: 'UsamaSarwar',
  message: 'Thanks for building Telegram Package :)',
);
print(link);

示例代码

以下是一个完整的示例应用程序，展示了如何使用 telegram 插件来发送消息和复制链接：

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

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

class TelegramApp extends StatefulWidget {
  const TelegramApp({super.key});

  @override
  State<TelegramApp> createState() => _TelegramAppState();
}

class _TelegramAppState extends State<TelegramApp> {
  final _key = GlobalKey<FormState>();
  String? username;
  String? message;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Telegram',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: Scaffold(
        resizeToAvoidBottomInset: true,
        appBar: AppBar(
          centerTitle: false,
          title: Text(
              username == null || username == '' ? 'Telegram' : '@$username'),
          actions: [
            // 复制到剪贴板
            IconButton(
              tooltip: 'Copy to clipboard',
              onPressed: () {
                if (_key.currentState!.validate()) {
                  Telegram.copyLinkToClipboard(
                      username: username ?? '', message: message);
                }
              },
              icon: const Icon(Icons.content_copy),
            ),
            // 通过Telegram发送
            IconButton(
              tooltip: 'Send',
              onPressed: () {
                if (_key.currentState!.validate()) {
                  if (message == null) {
                    Telegram.send(username: username!);
                  } else {
                    Telegram.send(
                      username: username!,
                      message: message,
                    );
                  }
                }
              },
              icon: const Icon(Icons.send),
            ),
          ],
        ),
        body: SingleChildScrollView(
          child: Padding(
            padding: const EdgeInsets.all(16.0),
            child: Column(
              children: [
                Form(
                  key: _key,
                  child: Column(
                    children: [
                      TextFormField(
                        decoration: const InputDecoration(
                          labelText: 'Username',
                        ),
                        onChanged: (String value) {
                          setState(() {
                            username = value;
                          });
                        },
                        validator: (value) {
                          if (value == null || value.isEmpty) {
                            return 'Username is required';
                          }
                          if (value.length < 5) {
                            return 'Username must be at least 5 characters long';
                          }
                          // 验证用户名格式
                          if (!RegExp(r'^([a-zA-Z0-9_-]*)$').hasMatch(value)) {
                            return 'Invalid username';
                          }
                          return null;
                        },
                      ),
                      TextFormField(
                        minLines: 1,
                        maxLines: 20,
                        textAlign: TextAlign.justify,
                        decoration: const InputDecoration(
                          labelText: 'Message (Optional)',
                          labelStyle: TextStyle(overflow: TextOverflow.ellipsis),
                        ),
                        onChanged: (String value) {
                          message = value;
                        },
                      ),
                    ],
                  ),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}

贡献 💙

欢迎为 telegram 包做出贡献！请查看 贡献指南 了解更多详细信息。

开源贡献者来自 Punjab, Pakistan 🇵🇰

希望这个指南能帮助你顺利集成和使用 telegram 插件！如果有任何问题或建议，请随时联系开发者或提交Issue。