Flutter辐射检测插件geiger_indicator的使用

GEIGER Indicator 是一个使用Dart和Flutter开发的网络安全风险指标实现。该指标旨在支持跨平台，因此Dart和Flutter是一个很好的选择，它们可以编译为多个操作系统，如Android、iOS、Windows等。

GEIGER Indicator 使用指南

pubspec.yaml 文件配置

GEIGER Indicator 的构建配置存储在 pubspec.yaml 文件中。这是Dart和Flutter的标准配置文件。在这里添加自己的配置，例如扩展。记得安装许多扩展和额外的Dart包。

name: geiger_indicator_example
description: A sample app demonstrating the usage of the geiger_indicator package.
dependencies:
  flutter:
    sdk: flutter
  toolbox_indicator:
    path: ../toolbox_indicator # 或者使用版本号，例如 version: ^1.0.0

源代码文件结构

所有源代码位于 lib/src 目录下，这些文件是使用Dart默认生成的。所有的 .dart 文件构成了文档的不同部分。

初始化数据

init.dart 包含初始函数，用于获取并检查现有数据（如物理用户设备UUID、全局分数数据等）。

// lib/src/init.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

void initializeData() {
  // 获取并检查现有数据
  final userData = getUserData();
  final deviceData = getDeviceData();

  // 进行必要的初始化操作
  if (!userData.exists || !deviceData.exists) {
    // 处理不存在的数据
  }
}

设置监听器

listener.dart 使用Storage API设置监听器，并管理度量数据的通知（例如传感器值、实施的建议等）。

// lib/src/listener.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

class DataListener {
  void setupListeners() {
    // 设置监听器
    registerMetricListener((metricData) {
      // 处理接收到的度量数据
    });
  }
}

管理传感器数据

sensors_data.dart 管理传感器值（例如检查现有数据并更新新的传感器值等）。

// lib/src/sensors_data.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

class SensorManager {
  void manageSensorValues() {
    // 检查现有数据
    final sensorData = getSensorData();

    // 更新新的传感器值
    if (newSensorValue != null) {
      updateSensorData(newSensorValue);
    }
  }
}

核心变量

variables.dart 包含GEIGER指标的所有核心值（例如全局数据、分数数据、存储API、节点路径等）。

// lib/src/variables.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

class CoreVariables {
  static final String globalDataPath = '/path/to/global/data';
  static final String scoreDataPath = '/path/to/score/data';
}

计算分数

用户分数、设备分数、聚合分数、SME分数

lib/src/score/ 目录下的文件与分数计算相关。

聚合分数

aggregate_score.dart 基于指示算法对聚合分数进行计算。

// lib/src/score/aggregate_score.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

double calculateAggregateScore(Map<String, dynamic> data) {
  // 基于指示算法计算聚合分数
  return computeAggregateScore(data);
}

用户/设备/聚合分数节点

geiger_score.dart 基于指示算法计算并管理用户/设备/聚合分数节点。

// lib/src/score/geiger_score.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

class GeigerScoreManager {
  double getUserScore() {
    // 计算用户分数
    return computeUserScore();
  }

  double getDeviceScore() {
    // 计算设备分数
    return computeDeviceScore();
  }

  double getAggregateScore() {
    // 计算聚合分数
    return computeAggregateScore({});
  }
}

SME分数

sme_score.dart 基于指示算法计算并管理SME分数。

// lib/src/score/sme_score.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

double calculateSMEScore(Map<String, dynamic> data) {
  // 基于指示算法计算SME分数
  return computeSMEScore(data);
}

全局数据

全局威胁、全局建议、全局配置文件

lib/src/globaldata/ 目录下的文件与风险评分计算相关的映射和预计算数据。

全局配置文件

global_profile.dart 对全局配置文件（公司类型）进行映射和解析。

// lib/src/globaldata/global_profile.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

String parseGlobalProfile(String companyType) {
  // 映射和解析全局配置文件
  return mapGlobalProfile(companyType);
}

全局建议

global_recommendation.dart 计算、映射和解析全局建议。

// lib/src/globaldata/global_recommendation.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

List<String> getGlobalRecommendations() {
  // 计算、映射和解析全局建议
  return parseGlobalRecommendations();
}

全局威胁

global_threat.dart 基于全局配置文件映射和解析全局威胁。

// lib/src/globaldata/global_threat.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

Map<String, dynamic> getGlobalThreats() {
  // 映射和解析全局威胁
  return mapGlobalThreats();
}

主要功能

lib/indicator.dart 中包含主要功能 runIndicator。要使用GEIGER指标，导入此文件并调用主函数。

// lib/indicator.dart
import 'package:toolbox_indicator/toolbox_indicator.dart';

void runIndicator() {
  // 初始化数据
  initializeData();

  // 设置监听器
  DataListener().setupListeners();

  // 管理传感器数据
  SensorManager().manageSensorValues();

  // 计算分数
  final aggregateScore = GeigerScoreManager().getAggregateScore();
  print('Aggregate Score: $aggregateScore');
}