Flutter屏蔽色情内容插件block_porn的使用

Flutter屏蔽色情内容插件block_porn的使用

block_porn

一个用于阻止和过滤不适当或不需要的URL的Dart包。旨在帮助开发者将其应用程序集成URL过滤功能，并提供自定义和预定义的阻止列表。

特性

• 使用包含的blocked.txt文件阻止预定义的URL。
• 添加自定义URL到您的阻止列表中。
• 轻量且易于使用的API。
• 包含用于URL清理和验证的实用方法。

开始使用

安装

在您的Dart项目的pubspec.yaml文件中添加block_porn：

dependencies:
  block_porn: ^1.0.0

然后运行：

dart pub get

导入包

import 'package:block_porn/block_porn.dart';

使用说明

1. 阻止一个URL

使用Blocker类检查一个URL是否被阻止：

import 'package:block_porn/block_porn.dart';

void main() {
  // 创建Blocker实例
  final blocker = Blocker();

  // 待检查的URL
  final url = 'https://example.com';
  
  // 检查URL是否被阻止
  final isBlocked = blocker.isBlocked(url);

  print('Is "$url" blocked? $isBlocked'); // 输出结果
}

2. 添加自定义阻止的URL

将自定义URL添加到阻止列表中：

import 'package:block_porn/block_porn.dart';

void main() {
  // 自定义阻止的URL列表
  final customBlocks = ['customblock.net', 'example.org'];
  
  // 创建带有自定义阻止列表的Blocker实例
  final blocker = Blocker(customBlocks: customBlocks);

  // 待检查的URL
  final url = 'https://customblock.net';
  
  // 检查URL是否被自定义阻止
  print('Is "$url" blocked? ${blocker.isCustomBlocked(url)}'); // 输出结果
}

资源

该包包括一个文件assets/blocked.txt，其中包含大量预定义的阻止URL。如果需要，您可以向此文件中添加更多条目。

许可证

本包根据MIT许可证发布。

示例代码

以下是一个完整的示例demo，展示了如何使用block_porn插件：

import 'package:block_porn/block_porn.dart';

void main() {
  // ======[ BLOCK URL ]======
  // 测试一个URL是否被阻止
  final url1 = "https://xxx.com";
  final blocker1 = Blocker();
  final resu1 = blocker1.isBlocked(url1);
  print("Is '$url1' blocked? $resu1"); // 输出结果

  // ======[ ADD MORE SITES ]======
  // 测试自定义阻止列表中的URL是否被阻止
  final url2 = "https://xxx.dc";
  final customBlocks = ["xxx.db", "xxx.dc"];
  final blocker2 = Blocker(customBlocks: customBlocks);
  final resu2 = blocker2.isBlocked(url2);
  print("Is '$url2' blocked with custom blocks? $resu2"); // 输出结果

  // ======[ CUSTOM BLOCK ]======
  // 测试特定自定义阻止的URL是否被阻止
  final url3 = "https://xxx.me";
  final customBlocks2 = ["xxx.me", "xxx.ms"];
  final blocker3 = Blocker(customBlocks: customBlocks2);
  final resu3 = blocker3.isCustomBlocked(url3);
  print("Is '$url3' custom blocked? $resu3"); // 输出结果

  // ======[ LOAD FILE ]======
  // 加载并读取阻止列表文件中的条目数
  final loader = LoadeR();
  final path = "assets/blocked.txt";
  final resu4 = loader.loadFile(path);
  print("Number of blocked sites in file: ${resu4.length}"); // 输出结果
}