random_toolkit 0.0.7 copy "random_toolkit: ^0.0.7" to clipboard
random_toolkit: ^0.0.7 copied to clipboard

一个功能强大的Flutter随机数据生成工具包,提供各种类型的随机数据生成功能。

更新日志 #

本文档记录了 Random Toolkit 项目的所有重要更改。

格式基于 Keep a Changelog, 并且本项目遵循 语义化版本

0.0.7 - 2025-08-26 #

改进 #

  • 🔧 代码质量提升

    • 通过了完整的静态代码分析检查
    • 使用 pana 工具进行了 pub.dev 评分预检,获得 115/130 分
    • 修复了代码格式化问题,确保代码风格一致性
    • 所有单元测试通过,确保代码质量
  • 📚 文档更新

    • 更新了 README.md 中的版本号引用
    • 完善了发布流程和质量检查机制

0.0.6 #

重大变更 (Breaking Changes) #

  • 🔄 纯 Dart 包转换
    • 移除了所有原生平台代码(Android、iOS、Windows、Linux、macOS)
    • 删除了平台相关的 Dart 文件(platform_interface、method_channel、web)
    • 移除了 getPlatformVersion() 功能
    • 更新 pubspec.yaml,移除插件配置和平台依赖
    • 转换为纯 Dart 包,提高兼容性和可维护性

改进 #

  • 📦 包结构优化

    • 简化了项目结构,移除了不必要的平台代码
    • 更新了示例应用,移除平台版本显示功能
    • 优化了测试文件,专注于纯 Dart 功能测试
  • 🚀 性能提升

    • 减少了包大小和依赖复杂度
    • 提高了跨平台兼容性
    • 简化了集成和使用流程

0.0.5 #

新增 #

  • 项目品牌升级

    • 添加了专业的动画 SVG logo (assets/random_toolkit_logo.svg)
    • logo 包含丰富的动画效果:旋转骰子、渐变色彩、浮动元素等
    • 在 README.md 中集成了 logo 展示
  • 🔄 双仓库同步配置

    • 配置了 Gitee(主仓库)和 GitHub(备份仓库)的双仓库同步
    • 使用 Git 原生多推送 URL 功能,简化同步流程
    • 添加了 DUAL_REPO_SYNC.md 文档说明同步机制
    • 更新了所有文档中的仓库链接为 Gitee 地址

改进 #

  • 📚 文档优化

    • 更新 pubspec.yamlREADME.mdCHANGELOG.md 中的仓库链接
    • 统一使用 Gitee 作为主要代码托管平台
    • 改进了项目的视觉呈现和品牌形象
  • 🛠️ 开发体验

    • 简化了代码同步流程,单个 git push 命令即可推送到两个仓库
    • 提供了详细的开发者指南和使用说明

0.0.4 #

重大变更 (Breaking Changes) #

  • 🔄 API 函数名称简化
    • 所有函数名称移除 random 前缀,使API更简洁
    • randomInt()integer()
    • randomDouble()decimal()
    • randomBool()boolean()
    • randomString()string()
    • randomUUID()uuid()
    • randomChoice()choice()
    • randomChoices()choices()
    • randomColor()color()
    • randomHexColor()hexColor()
    • randomMaterialColor()materialColor()
    • randomImageUrl()imageUrl()
    • randomAvatarUrl()avatarUrl()
    • randomName()name()
    • randomEmail()email()
    • randomPhoneNumber()phoneNumber()
    • randomAddress()address()
    • randomDate()date()
    • randomTimestamp()timestamp()

改进 #

  • 📚 文档更新

    • 更新 README.md 中的所有示例代码
    • 添加完整的 API 使用示例
    • 改进代码注释和文档结构
  • 🧪 测试验证

    • 验证所有函数名称变更的正确性
    • 确保示例应用正常运行
    • 通过完整的功能测试

迁移指南 #

如果您正在使用旧版本,请按以下方式更新您的代码:

// 旧版本
int num = RandomToolkit.generators.randomInt(1, 100);
String name = RandomToolkit.person.randomName();
Color color = RandomToolkit.visual.randomColor();

// 新版本
int num = RandomToolkit.generators.integer(1, 100);
String name = RandomToolkit.person.name();
Color color = RandomToolkit.visual.color();
copied to clipboard

0.0.3 #

新增 #

  • 🎯 API 命名空间支持
    • 添加RandomToolkit.visual.color()等命名空间调用方式
    • 支持RandomToolkit.person.name()等统一访问入口
    • 保留所有原始类调用方式实现向后兼容

改进 #

  • 🧱 代码架构优化
    • 通过静态委托实现统一 API 入口
    • 添加@nodoc注解隐藏内部构造函数
    • 改进文档注释的可读性

技术特性 #

  • 📚 墨菲定律原则:
    • 所有原始类保持独立可访问
    • 命名空间实例自动初始化
    • 支持混合使用新旧 API

0.0.2 #

修复 #

  • 🔧 Android 构建问题
    • 修复了 Android 模块缺少 namespace 配置导致的构建失败问题
    • android/build.gradle 中添加了 namespace 'com.example.random_toolkit' 配置
    • 解决了外部项目引用插件时出现的 "Namespace not specified" 错误

改进 #

  • 📦 发布准备
    • 完善了项目配置以符合 pub.dev 发布要求
    • 优化了 Android Gradle Plugin 兼容性

0.0.1 #

新增功能 #

  • 🎲 基础随机数据生成

    • 随机整数生成 (randomInt)
    • 随机浮点数生成 (randomDouble)
    • 随机布尔值生成 (randomBool)
    • 随机字符串生成 (randomString)
    • UUID 生成 (randomUUID)
    • 数组随机选择 (randomChoice, randomChoices)
    • 数组随机打乱 (shuffle)
  • 👤 个人信息生成

    • 随机中文姓名生成 (randomChineseName)
    • 随机英文姓名生成 (randomEnglishName)
    • 随机邮箱地址生成 (randomEmail)
    • 随机手机号码生成 (randomPhoneNumber)
  • 🎨 视觉元素生成

    • 随机颜色生成 (randomColor)
    • 随机十六进制颜色字符串 (randomHexColor)
    • Material Design 颜色生成 (randomMaterialColor)
    • 随机图片 URL 生成 (randomImageUrl)
    • 随机头像 URL 生成 (randomAvatarUrl)
  • 📍 地理位置生成

    • 随机中文地址生成 (randomChineseAddress)
    • 随机英文地址生成 (randomEnglishAddress)
  • 日期时间生成

    • 随机日期生成 (randomDate)
    • 随机时间戳生成 (randomTimestamp)
    • 支持自定义日期范围
  • 👥 完整用户信息生成

    • 生成包含所有信息的随机用户对象 (generateRandomUser)
    • 包含 ID、姓名、邮箱、电话、地址、头像、生日、活跃状态、分数、余额等字段

技术特性 #

  • ✅ 支持所有 Flutter 平台(Android、iOS、Web、Windows、macOS、Linux)
  • 🏗️ 模块化架构设计,代码组织清晰
  • 📦 纯 Dart 实现,无需原生代码依赖
  • 🔧 易于使用的 API 接口
  • 📚 完整的示例应用
  • 📖 详细的文档说明

文档 #

  • 📝 完整的 README.md 文档
  • 🎯 详细的 API 使用示例
  • 🚀 快速开始指南
  • 📱 示例应用演示

开发工具 #

  • 🧪 基础测试框架
  • 📋 代码规范检查
  • 🔄 持续集成配置

版本说明 #

  • [新增] - 新功能
  • [更改] - 现有功能的更改
  • [弃用] - 即将删除的功能
  • [移除] - 已删除的功能
  • [修复] - 错误修复
  • [安全] - 安全相关的更改

链接 #

0
likes
135
points
28
downloads

Publisher

unverified uploader

Weekly Downloads

2024.12.17 - 2025.11.11

一个功能强大的Flutter随机数据生成工具包,提供各种类型的随机数据生成功能。

Documentation

API reference

License

MIT (license)

Dependencies

flutter

More

Packages that depend on random_toolkit