name: new_learn
description: "A new Flutter project."
# The following line prevents the package from being accidentally published to
# pub.dev using `flutter pub publish`. This is preferred for private packages.
publish_to: "none" # Remove this line if you wish to publish to pub.dev

# The following defines the version and build number for your application.
# A version number is three numbers separated by dots, like 1.2.43
# followed by an optional build number separated by a +.
# Both the version and the builder number may be overridden in flutter
# build by specifying --build-name and --build-number, respectively.
# In Android, build-name is used as versionName while build-number used as versionCode.
# Read more about Android versioning at https://developer.android.com/studio/publish/versioning
# In iOS, build-name is used as CFBundleShortVersionString while build-number is used as CFBundleVersion.
# Read more about iOS versioning at
# https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html
# In Windows, build-name is used as the major, minor, and patch parts
# of the product and file versions while build-number is used as the build suffix.
version: 1.0.0+1

environment:
  sdk: ^3.12.2

# Dependencies specify other packages that your package needs in order to work.
# To automatically upgrade your package dependencies to the latest versions
# consider running `flutter pub upgrade --major-versions`. Alternatively,
# dependencies can be manually updated by changing the version numbers below to
# the latest version available on pub.dev. To see which dependencies have newer
# versions available, run `flutter pub outdated`.
dependencies:
  flutter:
    sdk: flutter

  # The following adds the Cupertino Icons font to your application.
  # Use with the CupertinoIcons class for iOS style icons.
  cupertino_icons: ^1.0.8

  # 网络请求库：Dio（生产级封装，官方推荐）
  # 版本说明：5.10.0 为当前稳定版，Min Dart SDK 2.18，兼容本工程 Dart 3.12
  dio: ^5.10.0

  # 路由：go_router（Flutter 官方推荐声明式路由，对标 Vue 的 vue-router）
  # 用法：lib/router/app_router.dart 集中管路由表 + redirect 登录守卫 +
  #       ShellRoute 包 4 个 tab；页面跳转用 context.push('/xxx') / context.go('/')
  # 版本说明：17.4.0 为当前稳定版
  go_router: ^17.4.0

  # 状态管理：flutter_riverpod（官方推荐，对标 Vue 的 Pinia）
  # 用法：ProviderScope 包根（main.dart）→ lib/providers/ 定义全局状态 →
  #       页面用 ConsumerWidget + ref.watch(provider) 响应式读取
  # 版本说明：3.3.2 为当前稳定版（AsyncNotifier 为 3.x 推荐写法）
  flutter_riverpod: ^3.3.2

  # 屏幕适配：flutter_screenutil（本项目统一使用 5.9.0）
  # 用法：所有尺寸（宽/高/字号/圆角）乘以 .w/.h/.sp/.r 自动按设计稿缩放
  flutter_screenutil: ^5.9.0

  # 分页列表：infinite_scroll_pagination（Flutter Favorite 官方认证，对标 z-paging）
  # 用法：见 lib/components/common_paged_list.dart（通用分页组件，所有分页页面复用）
  # 版本说明：5.1.1 为当前稳定版，API 与 4.x 完全不同（PagingController 直接传 fetchPage + PagingListener 渲染）
  infinite_scroll_pagination: ^5.1.1

  # 图片选择（生产端 Android/iOS）：wechat 系列，UI 对标微信 8.0.51
  #   wechat_assets_picker：相册多选/预览/排序/压缩（自带 photo_manager，不用另配）
  #   wechat_camera_picker：微信风格相机（拍照/切镜头/重拍）
  #   注意：两者均不支持 Web，Web 调试走 image_picker 兜底（见 core/services/picker_service.dart）
  wechat_assets_picker: ^9.8.0
  wechat_camera_picker: ^4.6.0

  # 图片选择（仅 Web 调试兜底）：官方维护，支持 Web
  image_picker: ^1.2.3

  # 图片处理（压缩/EXIF 方向修正/尺寸过滤）：纯 Dart，全平台含 Web
  #   image 包主要兜底 Web 和 PNG 保真场景：
  #   decodeImage 解码 → bakeOrientation 修正 EXIF 方向 →
  #   copyResize 等比缩放 → encodeJpg(quality:) / encodePng。
  #   与 OSS 直传“读字节”策略天然契合（不碰 dart:io，Web 也能编译）；
  #   注意 import 时必须别名 `as img`，否则会和 Flutter 的 Image 类冲突。
  #   版本：4.8.0（当前项目已验证可用）
  image: ^4.8.0

  # 原生图片压缩：Android/iOS 用系统编解码器做方向自动修正 + 压缩
  #   关键参数 autoCorrectionAngle: true，可直接处理拍照文件方向；
  #   Web 不依赖它，仍走 image 纯 Dart 方案。
  #   版本：2.5.1（当前稳定线）
  flutter_image_compress: ^2.5.1

  # 网络图片加载 + 本地缓存（baseflow 维护，6.9k likes，全平台含 Web）
  #   替代 Image.network：自动把下载的图片缓存到本地缓存目录，
  #   二次加载秒出（不走网络），对标 Web 端浏览器 HTTP 缓存。
  #   用法：CachedNetworkImage(imageUrl, placeholder, progressIndicatorBuilder, errorWidget)；
  #   头像场景用 CachedNetworkImageProvider(url) 作为 ImageProvider。
  #   版本：3.4.1（Min Dart SDK 3.0，兼容本工程 Dart 3.12）
  cached_network_image: ^3.4.1

  # 视频播放（官方底层 + 社区 UI 封装）：播放学习课程视频
  #   video_player：官方维护，Android→ExoPlayer / iOS→AVPlayer / Web→HTML5 video
  #   chewie：fluttercommunity 维护的 UI 封装（进度条/全屏/倍速/字幕/循环）
  #   版本说明：不能升 1.14.x！它依赖 wakelock_plus 1.6.x → win32 ^6，
  #      与 flutter_secure_storage 9.2.4 的 win32 ^5 冲突（pub 解析失败）。
  #      锁在 1.13.1（要求 Flutter 3.32+，本工程满足），等以后
  #      flutter_secure_storage 升级到 11.x 后再考虑升 chewie。
  video_player: ^2.13.0
  chewie: ^1.13.1

  # 音频播放（社区事实标准，Android/iOS/Web/macOS/Windows/Linux 全平台）
  #   just_audio：ryanheise 维护，4.1k likes；网络流/本地文件/播放列表/倍速/
  #               循环/音频会话管理都有，但不带 UI，控制条由本项目组件自绘
  #                （lib/core/components/audio_player_card.dart）
  #   版本说明：0.10.x 为当前稳定线；0.x 版本号升级可能有 breaking change，
  #      升级前先看 pub.dev 的 changelog（0.9→0.10 就变了 setAudioSource API）
  just_audio: ^0.10.6

  # 富文本渲染（题目/解析 HTML → Flutter widget）
  #   flutter_widget_from_html_core：活跃维护（0.17.2，2026-04），
  #     纯 widget 渲染（非 WebView）→ 列表页性能好，全平台含 Web；
  #     支持 70+ 标签、内联 CSS、表格横滚、sub/sup 上标下标。
  #   用 core 版（不带 fwfh 全家桶）：audio 标签由本项目 AudioPlayerCard
  #     替换（customWidgetBuilder），video 留扩展点，图片/表格原生支持。
  #   版本：0.17.x 要求 Flutter 3.32+ / just_audio ^0.10.4（本项目满足）
  flutter_widget_from_html_core: ^0.17.2
  flutter_svg: ^2.0.17

  # 图片预览：社区成熟方案，支持双指缩放/拖拽/多图左右切换
  #   单图用 PhotoView，多图用 PhotoViewGallery；
  #   本项目统一封装到 core/components/image_preview_viewer.dart。
  photo_view: ^0.15.0

  # 加密库：登录密码 MD5 加密（对齐 Vue 端 stringToMd5）
  crypto: ^3.0.6

  # 本地存储组合（业界标准：凭据安全、配置轻量）
  # 1. flutter_secure_storage：Token 等敏感凭据 → Android Keystore/iOS Keychain 加密
  # 2. shared_preferences：用户信息等非敏感缓存 → 明文快速读写
  # 3. isar_community：题库/错题/播放记录等大批量业务数据 → 本地 NoSQL 数据库
  #    ⚠ 为什么用 isar_community 而不是 hive / isar：
  #      - hive：存 Map 无类型保障，官方已停更；
  #      - isar 3.1.8：只发在已宕机的 pub.isar-community.dev，装不上；
  #      - isar_community：社区在 pub.dev 的维护版，API 与 isar 完全一致。
  #    ⚠ Isar 是强类型数据库：模型类必须加 @collection 注解，
  #      每次改模型字段后要重跑 dart run build_runner build 重新生成 Schema。
  shared_preferences: ^2.5.3
  flutter_secure_storage: 10.3.1
  isar_community: ^3.3.2
  isar_community_flutter_libs: ^3.3.2
  path_provider: ^2.1.5

  # 权限管理（相机/相册等系统权限：检查状态、请求授权、跳转系统设置）
  # 用法：PickerService 内部统一调用，业务页不需要碰权限逻辑
  # 合规要求：Android 上架审核（应用宝/华为/小米）必须先弹前置弹窗说明用途，
  #   再触发系统权限弹窗，否则审核直接打回。
  permission_handler: ^11.3.1

  # 分享（系统分享面板：文本/图片/文件，Android→ACTION_SEND，iOS→UIActivityViewController）
  # 用法：ShareService 统一封装，业务页调 shareText / shareImage / shareFromWidget
  # 后续如需精确分享到微信好友/朋友圈，再加 fluwx（微信 OpenSDK）
  share_plus: 13.2.0

  # 保存到相册（图片/视频写入系统相册，Android→MediaStore，iOS→PHPhotoLibrary）
  # 用法：ShareService.saveToGallery / saveToGalleryFromBytes
  # gal 自带权限处理，588 likes，localsend 等大项目在用
  gal: ^2.3.3

  # 版本更新机制依赖
  # package_info_plus：读取本机 app 版本名、buildNumber（隐私协议同意后才能调用）
  package_info_plus: 10.0.0
  # url_launcher：跳转应用商店 / 外部浏览器下载地址
  url_launcher: ^6.3.1

  # WebView（内嵌 H5 报告详情页，支持 JS ↔ Flutter 双向通信）
  # 为什么用 flutter_inappwebview 而不是 webview_flutter：
  #   - 需要 H5 内部按钮回调到 Flutter（JS bridge：addJavaScriptHandler）
  #   - 比官方 webview_flutter 功能强：支持 callAsyncJavaScript、cookie 管理等
  #   - 6.1.5 stable 最低 Flutter 3.24 / Dart 3.5，项目 Flutter 3.44.8 完全兼容
  #   ⚠ Android 端要求 minSdkVersion >= 19（flutter_inappwebview 6.x 默认）
  flutter_inappwebview: ^6.1.5

  # 常驻底部面板（smooth_sheets：3 停靠点拖拽面板，支持内部 ListView 滚动联动）
  # 用法：lib/core/components/persistent_snap_sheet.dart 封装组件
  # 版本：1.1.1（2026-07 发布，支持 persistent + modal 两种模式）
  smooth_sheets: ^1.1.1

  # JSON 序列化注解（配合 json_serializable 自动生成 fromJson / toJson）
  json_annotation: ^4.12.0

  # 全局日志面板（Debug 下启用悬浮球查看日志 + Dio 网络请求日志）：
  # - talker_flutter：应用内日志面板/悬浮球入口（Release 模式自动关闭）
  # - talker_dio_logger：Dio 拦截器日志输出到 talker（便于追踪请求链路）
  talker_flutter: ^5.1.20
  talker_dio_logger: ^5.1.20

  # 网络状态感知（做题过程可识别离线/断网/假网）：
  # - connectivity_plus：监听网卡类型变化（wifi/mobile/none...），不保证能上网
  # - internet_connection_checker_plus：探针检测真实互联网可用性（hasInternet）
  connectivity_plus: ^7.3.1
  internet_connection_checker_plus: ^3.1.1

  # 本地通知（Android/iOS）：定时通知 + 点击通知跳转指定页面
  # 定时推荐配套：
  # - timezone：TZDateTime（避免夏令时/时区变化导致时间漂移）
  # - flutter_timezone：读取设备本地时区名（用于设置 tz.local）
  flutter_local_notifications: ^22.3.0
  timezone: ^0.11.1
  flutter_timezone: ^5.1.0

dev_dependencies:
  flutter_test:
    sdk: flutter

  # The "flutter_lints" package below contains a set of recommended lints to
  # encourage good coding practices. The lint set provided by the package is
  # activated in the `analysis_options.yaml` file located at the root of your
  # package. See that file for information about deactivating specific lint
  # rules and activating additional ones.
  flutter_lints: ^6.0.0

  # Isar 代码生成器：根据 @collection 模型生成 Schema（*.g.dart）
  # 改完模型后执行：dart run build_runner build --delete-conflicting-outputs
  isar_community_generator: ^3.3.2
  build_runner: ^2.4.13
  # JSON 序列化代码生成器（配合 @JsonSerializable 注解自动生成 *.g.dart）
  json_serializable: ^6.8.0

  # 集成测试：在真机/模拟器上跑完整 App（区别于 flutter test 的纯虚拟机测试）
  # 运行：flutter test integration_test -d <device-id>
  integration_test:
    sdk: flutter

# For information on the generic Dart part of this file, see the
# following page: https://dart.dev/tools/pub/pubspec

# The following section is specific to Flutter packages.
flutter:
  # The following line ensures that the Material Icons font is
  # included with your application, so that you can use the icons in
  # the material Icons class.
  uses-material-design: true

  # 注册本地资源图片。
  # 坑：assets/ 只包含它【直接子文件】，不会递归包含子目录！
  # 所以 img/tabbar 下的 PNG 必须单独列一行。
  assets:
    - assets/
    - assets/mock/
    - assets/img/tabbar/
    - assets/img/tabbar/default/
    - assets/audio/
    - assets/img/class/
    - assets/img/my/

  # To add assets to your application, add an assets section, like this:
  # assets:
  #   - images/a_dot_burr.jpeg
  #   - images/a_dot_ham.jpeg

  # An image asset can refer to one or more resolution-specific "variants", see
  # https://flutter.dev/to/resolution-aware-images

  # For details regarding adding assets from package dependencies, see
  # https://flutter.dev/to/asset-from-package

  # To add custom fonts to your application, add a fonts section here,
  # in this "flutter" section. Each entry in this list should have a
  # "family" key with the font family name, and a "fonts" key with a
  # list giving the asset and other descriptors for the font. For
  # example:
  # fonts:
  #   - family: Schyler
  #     fonts:
  #       - asset: fonts/Schyler-Regular.ttf
  #       - asset: fonts/Schyler-Italic.ttf
  #         style: italic
  #   - family: Trajan Pro
  #     fonts:
  #       - asset: fonts/TrajanPro.ttf
  #       - asset: fonts/TrajanPro_Bold.ttf
  #         weight: 700
  #
  # For details regarding fonts from package dependencies,
  # see https://flutter.dev/to/font-from-package