Flutter短信助手插件sms_helper的使用

说明

sms_helper 是一个用于帮助您获取设备短信的 Flutter 插件。目前仅支持 Android 平台。

使用方法

要使用此插件，请在 pubspec.yaml 文件中添加 sms_helper 作为依赖项：

dependencies:
  sms_helper: ^0.0.1

然后运行以下命令以更新依赖项：

flutter pub get

权限配置

Android

在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />

注意事项

sms_helper 本身不处理权限请求和检查流程。如果您需要请求权限，请尝试使用以下插件：

• permission_handler

示例代码

以下是一个完整的示例代码，展示如何使用 sms_helper 获取设备短信。

示例代码：main.dart

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

import 'package:permission_handler/permission_handler.dart'; // 用于权限管理
import 'package:sms_helper/sms_helper.dart'; // 短信助手插件

void main() {
  runApp(const MyApp()); // 启动应用
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState(); // 初始化状态
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();
    _requestPermissions(); // 请求权限
  }

  // 请求权限
  Future<void> _requestPermissions() async {
    Map<Permission, PermissionStatus> statuses = await [
      Permission.sms,         // 短信权限
      Permission.contacts,    // 联系人权限
      Permission.storage,     // 存储权限
    ].request();

    // 检查权限是否已授予
    if (statuses[Permission.sms] == PermissionStatus.granted &&
        statuses[Permission.contacts] == PermissionStatus.granted &&
        statuses[Permission.storage] == PermissionStatus.granted) {
      _getSms(); // 获取短信列表
    }
  }

  // 获取短信列表
  _getSms() {
    SmsHelper.getSmsList().then((value) {
      print(value); // 打印短信列表
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('短信助手示例'), // 应用标题
        ),
        body: Container(), // 页面主体
      ),
    );
  }
}