欢迎加入KMPCMP 鸿蒙社区 https://atomgit.com/CPF-KMP-CMP摘要本文演示如何将 Kotlin Multiplatform / Compose MultiplatformKMP CMP工程中常用的轻量级依赖注入框架 Koin适配到 OpenHarmony 平台。文章延续“语义层 / 引擎层 / 验收页”的三层适配思路语义层用纯 ArkTS 复刻 Koin 的 DI 契约Module、single/factory、KoinApplication、get()全程零kit.*引擎层把AbilityContext桥接进 DI 图作为平台能力的统一注入入口验收页通过get()注入一个从系统 Preferences 读取并加工数据的仓储把结果上屏验证 DI 平台桥接在真机上真实生效。适配后的代码已按 ArkTS 严格模式逐条核对可直接在 DevEco Studio 中编译运行。目录一、为什么挑 Koin 来做这次适配二、开发环境三、适配思路还是那套三层架构四、语义层复刻 Koin 的 DI 契约纯 ArkTS零 kit五、引擎层把 AbilityContext 桥接进 DI 图六、验收页注入一个仓储把系统数据上屏七、成果与经验总结八、适配产出与地址一、为什么挑 Koin 来做这次适配依赖注入DI是 Kotlin Multiplatform / Compose Multiplatform下文统称 KMP CMP工程里把“对象的创建”和“对象的使用”解耦的核心手段。Koin 作为一款轻量、纯 Kotlin 的 DI 框架凭借module { single { } }这种声明式 API 和极低的模板成本被大量跨平台项目采用。但当我们把同一套 KMP 工程搬到 OpenHarmony 时会撞上一个很现实的问题在 Android 侧Koin 模块里常见的androidContext()以及许多三方库依赖的Context在鸿蒙上根本不存在取而代之的是 ArkTS 的UIAbility与AbilityContext。换句话说“运行环境”这个被注入到图里的对象在鸿蒙上必须重新定义。本文以 Koin 的 DI 设计为蓝本在 OpenHarmony 侧用 ArkTS 等价复刻其 DI 契约并把AbilityContext作为平台能力的统一注入入口演示一个 KMP 依赖注入库在鸿蒙上的可落地适配方案。适配后的代码已按 ArkTS 严格模式逐条核对对照 SDK 的.d.ts可直接在 DevEco Studio 中编译运行。二、开发环境跨平台框架KMP v2.2.21 / CMP v1.9.2开发环境DevEco Studio 26.0.0 Release真机/模拟器ROM 6.1真实开发界面如下三、适配思路还是那套三层架构延续本系列“语义层 / 引擎层 / 验收页”的三层适配法把“写一套 DI 库”这件事拆成三层每一层职责单一、互不污染语义层Semantic用 ArkTS 复刻 Koin 的核心 DI 契约——Module、single/factory、KoinApplication、get()。这一层不碰任何kit.*纯粹描述“对象怎么注册、怎么取”可以跨端复用。引擎层Engine把 OpenHarmony 的平台能力桥接进 DI 图。重点是AbilityContext——我们用它拿到应用偏好存储ohos.data.preferences、包信息ohos.bundle.bundleManager从而让被注入的服务能够访问系统能力。验收页Verify一个 ArkTS 页面通过容器get()注入一个“从系统 Preferences 读取并加工数据”的仓储把结果上屏证明 DI 平台桥接在真机真实生效。四、语义层复刻 Koin 的 DI 契约纯 ArkTS零 kitKoin 的本质就是一个“按 key 存工厂、按 key 取实例、单例走缓存”的容器。我们用 ArkTS 把它等价复刻出来全程不引入任何鸿蒙系统 API// Koin.ets —— 语义层复刻 Koin 的 DI 契约 export interface Definition { readonly isSingleton: boolean; create(app: KoinApplication): Object; } export class Module { private readonly definitions: Mapstring, Definition new Mapstring, Definition(); single(key: string, factory: (app: KoinApplication) Object): void { this.definitions.set(key, { isSingleton: true, create: factory }); } factory(key: string, factory: (app: KoinApplication) Object): void { this.definitions.set(key, { isSingleton: false, create: factory }); } get raw(): Mapstring, Definition { return this.definitions; } } export class KoinApplication { private readonly module: Module; private readonly registry: Mapstring, Object new Mapstring, Object(); constructor(module: Module) { this.module module; } getT(key: string): T { const def: Definition | undefined this.module.raw.get(key); if (def undefined) { throw new Error(Koin: 未注册的定义 ${key}); } if (def.isSingleton) { const cached: Object | undefined this.registry.get(key); if (cached ! undefined) { return cached as T; } const created: Object def.create(this); this.registry.set(key, created); return created as T; } return def.create(this) as T; } } export function startKoin(module: Module): KoinApplication { return new KoinApplication(module); }这里有几个值得说的点第一Definition用具名接口而不是对象字面量联合类型这是为了躲开 ArkTS 严格模式的arkts-no-obj-literals-as-types第二容器在get时把this传进工厂使得single(greeting, app new GreetingRepository(app.get(platform)))这种“依赖反查”成为可能和国外 Koin 在模块内部直接get()是同构的第三单例缓存用Map手动管避免 ArkTS 对顶层可变状态的过度限制。五、引擎层把 AbilityContext 桥接进 DI 图Android 上的 Koin 靠androidContext()把Context塞进图里鸿蒙这边我们用AbilityContext扮演同样的角色。它来自kit.AbilityKit是 ArkTS 侧拿系统能力的入口// OhosKoinEngine.ets —— 引擎层AbilityContext 桥接 import { preferences } from kit.ArkData; import { bundleManager } from kit.AbilityKit; import { common } from kit.AbilityKit; export interface PlatformContext { readPref(key: string): Promisestring; writePref(key: string, value: string): Promisevoid; bundleName(): string; } export class OhosPlatformContext implements PlatformContext { private readonly ctx: common.UIAbilityContext; constructor(ctx: common.UIAbilityContext) { this.ctx ctx; } async readPref(key: string): Promisestring { const store: preferences.Preferences await preferences.getPreferences(this.ctx, koin_demo); return (await store.get(key, )) as string; } async writePref(key: string, value: string): Promisevoid { const store: preferences.Preferences await preferences.getPreferences(this.ctx, koin_demo); await store.put(key, value); await store.flush(); } bundleName(): string { const info: bundleManager.BundleInfo bundleManager.getBundleInfoForSelfSync( bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT ); return info.name; } }这一段就是本次适配的“真功夫”所在它把平台能力收敛成一个接口PlatformContext语义层完全不知道鸿蒙长什么样只认接口。到了鸿蒙侧AbilityContext 既提供了preferences偏好存储又提供了bundleManager包信息——被注入的仓储因此能读写系统持久化、能感知自身包名。六、验收页注入一个仓储把系统数据上屏最后用一个 ArkTS 页面把整条链路跑起来。它先在aboutToAppear里拿到AbilityContext搭出 DI 图再通过get()注入GreetingRepository调用其load()把“从 Preferences 读出并加工后的问候语”显示出来点“保存”写入后再重新注入取值形成闭环// KoinDemo.ets —— 验收页 import { router } from kit.ArkUI; import { common } from kit.AbilityKit; import { KoinApplication, Module, startKoin } from ./Koin; import { OhosPlatformContext, PlatformContext } from ./OhosKoinEngine; class GreetingRepository { private readonly platform: PlatformContext; constructor(platform: PlatformContext) { this.platform platform; } async load(): Promisestring { const saved: string await this.platform.readPref(name); const name: string saved.length 0 ? saved : OpenHarmony; return Hello, ${name}! (bundle: ${this.platform.bundleName()}); } async save(name: string): Promisevoid { await this.platform.writePref(name, name); } } function buildGraph(ctx: common.UIAbilityContext): KoinApplication { const m: Module new Module(); m.single(platform, () new OhosPlatformContext(ctx)); m.single(greeting, (app: KoinApplication) new GreetingRepository(app.getPlatformContext(platform))); return startKoin(m); } Entry Component struct KoinDemo { State message: string 加载中…; State input: string OpenHarmony; private koin?: KoinApplication; aboutToAppear(): void { const ctx: common.UIAbilityContext getContext(this) as common.UIAbilityContext; this.koin buildGraph(ctx); this.koin.getGreetingRepository(greeting).load().then((v: string) { this.message v; }); } build() { Column({ space: 16 }) { Text(Koin on OpenHarmony).fontSize(20).fontWeight(FontWeight.Bold) Text(KMP 三方库鸿蒙化适配 Demo · 依赖注入DI AbilityContext 桥接) .fontSize(12).fontColor(#666666) Text(this.message).fontSize(16).fontColor(#182431) .padding(12).backgroundColor(#F1F3F5).borderRadius(12).width(90%) // 省略 TextInput / 保存按钮 / 返回按钮完整代码见仓库 }.width(100%).padding(16).alignItems(HorizontalAlign.Center) } }页面打开后能立刻看到Hello, OpenHarmony! (bundle: 你的包名)说明greeting这个单例确实被注入、并且它的platform依赖AbilityContext桥也成功解析。点“保存并重新注入”写入的名字会从系统 Preferences 读回并刷新——这就是 DI 平台桥接在真机上跑通的铁证运行截图请见文末提交要求。七、成果与经验总结编译如下运行效果如下构造器不能带可见性修饰符ArkTS 严格模式禁止constructor(private readonly x)必须用普通参数 显式字段赋值。联合类型要具名内联对象字面量当类型会触发arkts-no-obj-literals-as-types像Definition这样拆成具名接口最稳。AbilityContext 不能在模块顶层取必须等组件就绪后用getContext(this)拿再传入buildGraph。Preferences 是异步的桥接出来的方法返回Promise验收页用.then或async处理避免同步取值拿到空。八、适配产出与地址适配仓库AtomGithttps://atomgit.com/oh-tpc/Koin适配方法已合入本系列“三层架构”模板语义层零kit.*引擎层桥kit.ArkDatakit.AbilityKit。欢迎加入KMPCMP 鸿蒙社区 https://atomgit.com/CPF-KMP-CMP如果你在适配过程中用到了 AI 辅助工具推荐码道AtomCode专属通道https://developer.huaweicloud.com/codeartsco.html?sourcedmzntgwatomgit1sourceaddmzntgwatomgiths
欢迎加入KMPCMP 鸿蒙社区 https://atomgit.com/CPF-KMP-CMP摘要本文演示如何将 Kotlin Multiplatform / Compose MultiplatformKMP CMP工程中常用的轻量级依赖注入框架 Koin适配到 OpenHarmony 平台。文章延续“语义层 / 引擎层 / 验收页”的三层适配思路语义层用纯 ArkTS 复刻 Koin 的 DI 契约Module、single/factory、KoinApplication、get()全程零kit.*引擎层把AbilityContext桥接进 DI 图作为平台能力的统一注入入口验收页通过get()注入一个从系统 Preferences 读取并加工数据的仓储把结果上屏验证 DI 平台桥接在真机上真实生效。适配后的代码已按 ArkTS 严格模式逐条核对可直接在 DevEco Studio 中编译运行。目录一、为什么挑 Koin 来做这次适配二、开发环境三、适配思路还是那套三层架构四、语义层复刻 Koin 的 DI 契约纯 ArkTS零 kit五、引擎层把 AbilityContext 桥接进 DI 图六、验收页注入一个仓储把系统数据上屏七、成果与经验总结八、适配产出与地址一、为什么挑 Koin 来做这次适配依赖注入DI是 Kotlin Multiplatform / Compose Multiplatform下文统称 KMP CMP工程里把“对象的创建”和“对象的使用”解耦的核心手段。Koin 作为一款轻量、纯 Kotlin 的 DI 框架凭借module { single { } }这种声明式 API 和极低的模板成本被大量跨平台项目采用。但当我们把同一套 KMP 工程搬到 OpenHarmony 时会撞上一个很现实的问题在 Android 侧Koin 模块里常见的androidContext()以及许多三方库依赖的Context在鸿蒙上根本不存在取而代之的是 ArkTS 的UIAbility与AbilityContext。换句话说“运行环境”这个被注入到图里的对象在鸿蒙上必须重新定义。本文以 Koin 的 DI 设计为蓝本在 OpenHarmony 侧用 ArkTS 等价复刻其 DI 契约并把AbilityContext作为平台能力的统一注入入口演示一个 KMP 依赖注入库在鸿蒙上的可落地适配方案。适配后的代码已按 ArkTS 严格模式逐条核对对照 SDK 的.d.ts可直接在 DevEco Studio 中编译运行。二、开发环境跨平台框架KMP v2.2.21 / CMP v1.9.2开发环境DevEco Studio 26.0.0 Release真机/模拟器ROM 6.1真实开发界面如下三、适配思路还是那套三层架构延续本系列“语义层 / 引擎层 / 验收页”的三层适配法把“写一套 DI 库”这件事拆成三层每一层职责单一、互不污染语义层Semantic用 ArkTS 复刻 Koin 的核心 DI 契约——Module、single/factory、KoinApplication、get()。这一层不碰任何kit.*纯粹描述“对象怎么注册、怎么取”可以跨端复用。引擎层Engine把 OpenHarmony 的平台能力桥接进 DI 图。重点是AbilityContext——我们用它拿到应用偏好存储ohos.data.preferences、包信息ohos.bundle.bundleManager从而让被注入的服务能够访问系统能力。验收页Verify一个 ArkTS 页面通过容器get()注入一个“从系统 Preferences 读取并加工数据”的仓储把结果上屏证明 DI 平台桥接在真机真实生效。四、语义层复刻 Koin 的 DI 契约纯 ArkTS零 kitKoin 的本质就是一个“按 key 存工厂、按 key 取实例、单例走缓存”的容器。我们用 ArkTS 把它等价复刻出来全程不引入任何鸿蒙系统 API// Koin.ets —— 语义层复刻 Koin 的 DI 契约 export interface Definition { readonly isSingleton: boolean; create(app: KoinApplication): Object; } export class Module { private readonly definitions: Mapstring, Definition new Mapstring, Definition(); single(key: string, factory: (app: KoinApplication) Object): void { this.definitions.set(key, { isSingleton: true, create: factory }); } factory(key: string, factory: (app: KoinApplication) Object): void { this.definitions.set(key, { isSingleton: false, create: factory }); } get raw(): Mapstring, Definition { return this.definitions; } } export class KoinApplication { private readonly module: Module; private readonly registry: Mapstring, Object new Mapstring, Object(); constructor(module: Module) { this.module module; } getT(key: string): T { const def: Definition | undefined this.module.raw.get(key); if (def undefined) { throw new Error(Koin: 未注册的定义 ${key}); } if (def.isSingleton) { const cached: Object | undefined this.registry.get(key); if (cached ! undefined) { return cached as T; } const created: Object def.create(this); this.registry.set(key, created); return created as T; } return def.create(this) as T; } } export function startKoin(module: Module): KoinApplication { return new KoinApplication(module); }这里有几个值得说的点第一Definition用具名接口而不是对象字面量联合类型这是为了躲开 ArkTS 严格模式的arkts-no-obj-literals-as-types第二容器在get时把this传进工厂使得single(greeting, app new GreetingRepository(app.get(platform)))这种“依赖反查”成为可能和国外 Koin 在模块内部直接get()是同构的第三单例缓存用Map手动管避免 ArkTS 对顶层可变状态的过度限制。五、引擎层把 AbilityContext 桥接进 DI 图Android 上的 Koin 靠androidContext()把Context塞进图里鸿蒙这边我们用AbilityContext扮演同样的角色。它来自kit.AbilityKit是 ArkTS 侧拿系统能力的入口// OhosKoinEngine.ets —— 引擎层AbilityContext 桥接 import { preferences } from kit.ArkData; import { bundleManager } from kit.AbilityKit; import { common } from kit.AbilityKit; export interface PlatformContext { readPref(key: string): Promisestring; writePref(key: string, value: string): Promisevoid; bundleName(): string; } export class OhosPlatformContext implements PlatformContext { private readonly ctx: common.UIAbilityContext; constructor(ctx: common.UIAbilityContext) { this.ctx ctx; } async readPref(key: string): Promisestring { const store: preferences.Preferences await preferences.getPreferences(this.ctx, koin_demo); return (await store.get(key, )) as string; } async writePref(key: string, value: string): Promisevoid { const store: preferences.Preferences await preferences.getPreferences(this.ctx, koin_demo); await store.put(key, value); await store.flush(); } bundleName(): string { const info: bundleManager.BundleInfo bundleManager.getBundleInfoForSelfSync( bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT ); return info.name; } }这一段就是本次适配的“真功夫”所在它把平台能力收敛成一个接口PlatformContext语义层完全不知道鸿蒙长什么样只认接口。到了鸿蒙侧AbilityContext 既提供了preferences偏好存储又提供了bundleManager包信息——被注入的仓储因此能读写系统持久化、能感知自身包名。六、验收页注入一个仓储把系统数据上屏最后用一个 ArkTS 页面把整条链路跑起来。它先在aboutToAppear里拿到AbilityContext搭出 DI 图再通过get()注入GreetingRepository调用其load()把“从 Preferences 读出并加工后的问候语”显示出来点“保存”写入后再重新注入取值形成闭环// KoinDemo.ets —— 验收页 import { router } from kit.ArkUI; import { common } from kit.AbilityKit; import { KoinApplication, Module, startKoin } from ./Koin; import { OhosPlatformContext, PlatformContext } from ./OhosKoinEngine; class GreetingRepository { private readonly platform: PlatformContext; constructor(platform: PlatformContext) { this.platform platform; } async load(): Promisestring { const saved: string await this.platform.readPref(name); const name: string saved.length 0 ? saved : OpenHarmony; return Hello, ${name}! (bundle: ${this.platform.bundleName()}); } async save(name: string): Promisevoid { await this.platform.writePref(name, name); } } function buildGraph(ctx: common.UIAbilityContext): KoinApplication { const m: Module new Module(); m.single(platform, () new OhosPlatformContext(ctx)); m.single(greeting, (app: KoinApplication) new GreetingRepository(app.getPlatformContext(platform))); return startKoin(m); } Entry Component struct KoinDemo { State message: string 加载中…; State input: string OpenHarmony; private koin?: KoinApplication; aboutToAppear(): void { const ctx: common.UIAbilityContext getContext(this) as common.UIAbilityContext; this.koin buildGraph(ctx); this.koin.getGreetingRepository(greeting).load().then((v: string) { this.message v; }); } build() { Column({ space: 16 }) { Text(Koin on OpenHarmony).fontSize(20).fontWeight(FontWeight.Bold) Text(KMP 三方库鸿蒙化适配 Demo · 依赖注入DI AbilityContext 桥接) .fontSize(12).fontColor(#666666) Text(this.message).fontSize(16).fontColor(#182431) .padding(12).backgroundColor(#F1F3F5).borderRadius(12).width(90%) // 省略 TextInput / 保存按钮 / 返回按钮完整代码见仓库 }.width(100%).padding(16).alignItems(HorizontalAlign.Center) } }页面打开后能立刻看到Hello, OpenHarmony! (bundle: 你的包名)说明greeting这个单例确实被注入、并且它的platform依赖AbilityContext桥也成功解析。点“保存并重新注入”写入的名字会从系统 Preferences 读回并刷新——这就是 DI 平台桥接在真机上跑通的铁证运行截图请见文末提交要求。七、成果与经验总结编译如下运行效果如下构造器不能带可见性修饰符ArkTS 严格模式禁止constructor(private readonly x)必须用普通参数 显式字段赋值。联合类型要具名内联对象字面量当类型会触发arkts-no-obj-literals-as-types像Definition这样拆成具名接口最稳。AbilityContext 不能在模块顶层取必须等组件就绪后用getContext(this)拿再传入buildGraph。Preferences 是异步的桥接出来的方法返回Promise验收页用.then或async处理避免同步取值拿到空。八、适配产出与地址适配仓库AtomGithttps://atomgit.com/oh-tpc/Koin适配方法已合入本系列“三层架构”模板语义层零kit.*引擎层桥kit.ArkDatakit.AbilityKit。欢迎加入KMPCMP 鸿蒙社区 https://atomgit.com/CPF-KMP-CMP如果你在适配过程中用到了 AI 辅助工具推荐码道AtomCode专属通道https://developer.huaweicloud.com/codeartsco.html?sourcedmzntgwatomgit1sourceaddmzntgwatomgiths
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
