
Object-oriented logic-layer foundation for developer and AI workflows: architecture guidance, capability index, verifiable practices, managed resource primitives, state/flow reactive patterns, optional coroutine helpers.
面向开发者与 AI 的 Kotlin / KMP 面向对象逻辑层基础:架构规范、能力选择、可验证实践,以及少量补足机制的组件。
从 使用入口 开始,按 能力索引 查找问题。维护本仓库请读 AGENTS.md,它不属于使用方项目的指令。
AutoCloseable 资源集合、替换槽、ManagedComponent 和同步类型化事件。:core 仅依赖 Kotlin 标准库。可选的 :coroutines 提供 launchSafe,用于调用方明确负责恢复的后台操作。:examples 展示两者的使用场景,:android-consumer 验证公开 API 的消费。
核心操作同步执行,要求调用方串行访问;允许文档规定的重入,不保证跨线程并发安全。同步 close 不等待协程完成,不能把 Job 注册成同步资源后宣称安全异步关闭。
Maven 坐标为 io.github.imaoda.foundation:core:0.1.0 和 io.github.imaoda.foundation:coroutines:0.1.0。Gradle 根据目标平台选择产物。公共 API 变更通过 ABI 基线和行为测试审查,工具链范围见 兼容性证据。
源码和发布包采用 Apache-2.0。
| 内容 | 入口 |
|---|---|
| 对象架构与运行边界 | architecture |
| 按问题选择能力 | capabilities |
| 可执行组合实践 | practices |
| 推荐与验证证据 | providers |
| 自研取舍 | decisions |
| 核心源代码 | core |
| 可选协程扩展 | coroutines |
| 可测试纯逻辑示例 | examples |
使用方可以只采用规范或现成库指南,无须引入 core。需要组件时也可以独立使用资源原语,不强迫已有工程迁移所有业务父类。
面向开发者与 AI 的 Kotlin / KMP 面向对象逻辑层基础:架构规范、能力选择、可验证实践,以及少量补足机制的组件。
从 使用入口 开始,按 能力索引 查找问题。维护本仓库请读 AGENTS.md,它不属于使用方项目的指令。
AutoCloseable 资源集合、替换槽、ManagedComponent 和同步类型化事件。:core 仅依赖 Kotlin 标准库。可选的 :coroutines 提供 launchSafe,用于调用方明确负责恢复的后台操作。:examples 展示两者的使用场景,:android-consumer 验证公开 API 的消费。
核心操作同步执行,要求调用方串行访问;允许文档规定的重入,不保证跨线程并发安全。同步 close 不等待协程完成,不能把 Job 注册成同步资源后宣称安全异步关闭。
Maven 坐标为 io.github.imaoda.foundation:core:0.1.0 和 io.github.imaoda.foundation:coroutines:0.1.0。Gradle 根据目标平台选择产物。公共 API 变更通过 ABI 基线和行为测试审查,工具链范围见 兼容性证据。
源码和发布包采用 Apache-2.0。
| 内容 | 入口 |
|---|---|
| 对象架构与运行边界 | architecture |
| 按问题选择能力 | capabilities |
| 可执行组合实践 | practices |
| 推荐与验证证据 | providers |
| 自研取舍 | decisions |
| 核心源代码 | core |
| 可选协程扩展 | coroutines |
| 可测试纯逻辑示例 | examples |
使用方可以只采用规范或现成库指南,无须引入 core。需要组件时也可以独立使用资源原语,不强迫已有工程迁移所有业务父类。