jk_flutter_lib 0.0.2

Personal Flutter UI kit by wujingshan: standardized widgets, layouts, and shared utilities (network, theme tokens, helpers) so app code stays consistent. Single import: package:jk_flutter_lib/jk_flutt [...]

jk_flutter_lib

作者：wujingshan

个人维护的一套 Flutter 标准化组件与基础能力库：把常用 UI、版式与接口侧工具（网络、主题扩展等）沉淀成可复用 API，方便在多项目里统一交互与代码风格。对外只需：

import 'package:jk_flutter_lib/jk_flutter_lib.dart';

与 pub.dev 上能看到的范围有关：当前发布包不包含 example/ 演示工程，也未在元数据中填写 Git 地址，因此别人在 pub.dev 上看不到你本地的完整使用案例与可视化示例；他们只能依据本 README、CHANGELOG 以及包内 lib/ 源码自行接入。若你需要对外展示范例，可另建文档站、文章，或在后续版本中酌情附带最小示例（会增大包体与维护成本）。

更完整的内部规范与协作说明若你有私有仓库，可放在其中的 docs/DEVELOPMENT.md（该目录默认不随本包发布）。

环境要求

• Dart SDK：^3.5.4（以 pubspec.yaml 为准）
• Flutter：>=1.17.0

安装

在业务项目的 pubspec.yaml 中：

dependencies:
  jk_flutter_lib: ^0.0.1 # 按 pub.dev 上实际版本替换

然后执行：

flutter pub get

若从私有 Git 仓库拉取而非 pub.dev，可使用 Git 依赖（url 填你自己的仓库地址，ref 为分支、tag 或 commit）：

dependencies:
  jk_flutter_lib:
    git:
      url: <你的仓库 URL>
      ref: main # 或某 tag / commit

使用

import 'package:jk_flutter_lib/jk_flutter_lib.dart';

// 示例：在 MaterialApp 中注入主题色（详见文档内 JkColorTheme / JkUIStyleTheme）

组件与 API 以导出文件为准；主题色板与圆角等约定见私有源码中的 docs/DEVELOPMENT.md（若你维护该文档）。

主要依赖

运行时依赖包含 dio、retrofit、decimal、device_info_plus 等（完整列表见本包 pubspec.yaml）。发布前请阅读各依赖许可证。

许可证

MIT，见仓库根目录 LICENSE。

---

维护者：下次发布到 pub.dev 的流程

1. 改版本号：在 pubspec.yaml 中按 语义化版本 提升 version（如 0.0.1 → 0.0.2；破坏性变更升主版本）。
2. 写变更记录：在 CHANGELOG.md 顶部增加与本次版本对应的条目（建议保留 ## Unreleased 汇总开发中内容，发版时再挪到具体版本号下）。
3. 自检（仓库根目录）：

   flutter pub get
   flutter analyze
   flutter test
   

   若改了示例，另在 example/ 下执行同样的 analyze / test。
4. 干跑发布（检查打进包里的文件是否符合 .pubignore 预期）：

   dart pub publish --dry-run
   

5. 实际上传（需已执行 dart pub login）：

   dart pub publish
   

6. Git 打 tag（推荐）：与 pubspec.yaml 中版本一致，例如 git tag v0.0.2 && git push origin v0.0.2，便于回溯与 Git 依赖的 ref:。

首次发布前请确认：包名在 pub.dev 未被占用、LICENSE 与 pubspec.yaml 中 license 字段一致、description 准确。