Skip to content

リリースとアップグレードガイド ​

このページでは、アップグレードの計画や互換性の確認ができるよう、Koinの主要なリリースを一覧で掲載しています。各バージョンは以下の共通の構成になっています。

  • Kotlin: KoinがビルドされているKotlinのバージョン。
  • 新機能 (New): 新機能および機能改善。
  • 実験的機能 (Experimental): @KoinExperimentalAPIが付与された、今後変更される可能性があるAPI。
  • 非推奨 (Deprecated): 削除予定としてマークされたAPIと、その代替手段。
  • 破壊的変更 (Breaking): アップグレード時にコードの修正が必要となる変更。
  • バグ修正 (Bug fixes)、改善 (Improvements)、ライブラリの更新 (Library updates): 該当するリリースに存在する場合に記載。

実験的機能および非推奨の定義については、API Stabilityを参照してください。

バージョン一覧 ​

バージョンKotlinステータス主な変更点
4.2.22.3.20Stableリゾルバーのリグレッション修正、ViewModelとスコープの修正、tvOS対応、R8/ProGuardルール
4.2.12.3.20以前の安定版スコープ解決の修正、ABIの復元、パフォーマンスの向上
4.2.02.3.20以前の安定版@KoinApplicationと@Configuration、Ktor 3.4 DIブリッジ、Navigation 3、Daggerブリッジ
4.1.12.1.21以前の安定版Navigationの改善、リゾルバーのパフォーマンス向上
4.1.02.1.20以前の安定版スコープアーキタイプ、機能オプション、Ktor KMP
4.0.42.0.21以前の安定版安定版ViewModel API、UUID生成
3.5.61.9.22LTSKotlin 1.x向け長期サポートライン、分離されたコンテキスト
3.4.31.8.21レガシーVerification API、ExtensionManager

現在のバージョン: Koin 4.2.2、およびKoin Compiler Plugin 1.2.1(Koin Compiler Pluginを参照)。

NOTE

Kotlin 1.xプロジェクト向けのKoin 3.5.6と、Kotlin 2.xプロジェクト向けのKoin 4.2.xという2つのLTSラインが並行して保守されています。プロジェクトのKotlinベースラインに合わせて選択してください。サポートポリシーについては、長期サポート (LTS)を参照してください。

4.2.2 ​

Kotlin 2.3.20。

4.2.xラインのメンテナンスリリース: 4.2.0でのCoreResolverV2の書き直しによって導入されたリゾルバーのリグレッションの修正、ViewModelとスコープの修正、Ktorリクエストスコープの修正、tvOSのサポート、およびR8/ProGuardルール。

WARNING

4.2.0または4.2.1でリゾルバーの問題が発生した場合は、4.2.2にアップグレードしてください。

新機能 ​

koin-core-viewmodel

  • tvOSターゲット(tvosArm64、tvosX64、tvosSimulatorArm64)に対応し、tvOSでViewModelを使用できるようになりました。

koin-android / koin-core-viewmodel

  • コンシューマー向けのR8/ProGuardルールがAARに含まれるようになり、新しいR8/ProGuardガイドが追加されました。

バグ修正 ​

koin-core

  • #2370、#2408の修正: スタックされたパラメータ(parametersOf)が、修飾子付きのget(named(...))リクエストをシャドウしてしまうことがありました。修飾子付きの検索はレジストリのみを読み取り、パラメータスタックは読み取らないようになりました。
  • #2379の修正: ルートスコープで定義された非singleのファクトリを子スコープから解決した場合に、スコープ付き依存関係がリクエスト元のスコープではなく_root_に対して解決されていました。リンクされたスコープ解決では、リクエスト元のスコープに対してファクトリを実行するようになりました。
  • #2299の修正: viewModelScopeFactory()で作成されたスコープが元のスコープにリンクされておらず、親で宣言された依存関係を解決できませんでした。作成されたスコープは親にリンクされるようになりました(親がルートの場合を除く)。
  • #2348の修正: String以外の値を持つ環境プロパティまたはシステムプロパティを読み込むと、チェックなしのマップキャストによりClassCastExceptionがスローされていました。String以外の値はAnyとして保持されるようになりました。
  • #2044、#2417の修正: 適切なextrasなしでSavedStateHandleを解決しようとした場合や、viewModelScopeFactory()オプションなしでviewModelScope { }を使用した場合に、対処方法がわかりやすいエラーメッセージが表示されるようになりました。

koin-ktor

  • #2410の修正: 並行リクエストによってリクエストスコープIDが衝突する可能性がありました。IDは起動時に一度シードされる単調増加カウンターから生成されるようになりました(@lfavreli-betclicによるコントリビューション)。

改善 ​

koin-core

  • bind()とbinds()において、バインディングごとに対象の型リストを再割り当てするのではなく、セカンダリの型をO(1)で追加するようになりました。これにより、定義が多数のバインディングを宣言している場合の二次関数的なコストが解消されました。

ドキュメント ​

4.2.1 ​

Kotlin 2.3.20。

4.2.0に対するパッチリリース: スコープ解決の修正、ABIの復元、および診断機能の向上。

新機能 ​

koin-core

  • スコープ解決のエラーメッセージがより明確になりました。

バグ修正 ​

koin-core

  • #2387の修正: CoreResolverV2において、リンクされたスコープでスタックされたパラメータの検索が失われていた問題を修正しました。
  • runOnKoinStartedのABI互換性を復元しました。リグレッションを防ぐため、CIでAPIチェックが実行されるようになりました。
  • クローズされたスコープにおける並行処理の修正(volatileフラグ)(@inemtsevによるコントリビューション)。
  • スコープ付きViewModelおよびSavedStateHandle ViewModelのテストを追加しました。

4.2.0 ​

Kotlin 2.3.20。すべてのライブラリバージョンはlibs.versions.tomlに記載されています。

新機能 ​

koin-core

  • 新しいCoreResolverV2: スタックされたパラメータへのアクセス高速化、子スコープおよびViewModelスコープ解決の改善、スコープごとのThreadLocal読み込みの最適化。
  • KoinApplication.withConfiguration<T>()拡張関数: KoinApplicationを、Koin Compiler Pluginによって@KoinApplicationクラスから検出されたモジュールと接続します。
  • koinConfiguration<T>() DSL: アノテーション付きクラスからKoinConfigurationを構築するためのCompiler Pluginのエントリポイント。
  • スコープ解決とスレッドセーフに関するパフォーマンスの最適化。

koin-android

  • koinActivityInject: 現在のActivityスコープから依存関係を取得します。

koin-androidx-startup

  • onKoinStartup { }: AndroidX StartupのInitializer APIを介してKoinを起動します。
  • KoinConfiguration型およびKoinStartupの更新(KoinInitializerは実験的ステータスのままです)。

koin-ktor: Ktor 3.4の統合

  • 公式のKtor 3.4 DI API上に構築された、新しいKoinとKtorのDIブリッジ。
  • KoinDependencyMap: KoinがKtor DIを介してインスタンスを直接解決します。
  • KoinKtorApplication: KtorからKoin、およびKoinからKtorへの連携を行う明示的なオプションを備えたDSLブリッジ。
  • モジュールの宣言には、Application.koinModuleおよびApplication.koinModules拡張関数の使用が推奨されるようになりました。

koin-compose-navigation3(新規モジュール)

  • Jetpack Navigation 3(stable 1.0.0)のサポート。
  • ジェネリックなEntryProvider: メタデータパラメータ(アニメーションなど)をナビゲーションエントリに渡します。
  • Compose Navigation 2向けのナビゲーションスコープヘルパー。

koin-dagger-bridge(新規モジュール)

  • Dagger側からKoinコンポーネントをインジェクトし、DaggerからKoinへの段階的な移行を可能にします。

koin-core-annotations(Compiler Pluginで使用)

  • @KoinApplication: クラスをKoinアプリケーションのエントリポイントとしてマークします。その後startKoin<MyApp>()によって、検出されたすべての@Configurationモジュールがアセンブルされます。
  • @Configuration("name"): @Moduleクラスを設定(例: prod、test、default)ごとにグループ化します。同じ設定ラベルを持つモジュール同士は、お互いの定義を参照できます。
  • @PropertyValue("key"): @Propertyインジェクションのデフォルト値。
  • @ScopeId(name = "...")および@ScopeId(MyScope::class): 名前付きKoinスコープから値をインジェクトします。
  • @Monitor: アノテーションが付けられた関数をKotzilla SDKのトレーシング(実行時間)でラップします。詳細は@Monitorを参照してください。
  • @Providedがセーフティグラフ全体で認識されるようになりました: 外部から提供される型のコンパイル時検証をスキップします。

実験的機能 ​

koin-core

  • @KoinApplication(modules = [...]): 明示的なmodules配列により、エントリポイントで自動検出をバイパスし、固定のモジュールリストを使用できます。

koin-androidx-startup

  • koin-androidx-startup API全体が実験的機能のままとなります。KoinInitializerには@KoinExperimentalAPIがマークされています。

非推奨 ​

koin-android / koin-android-annotation

  • org.koin.android.annotation.KoinViewModelは非推奨となりました。org.koin.core.annotation.KoinViewModelを使用してください。

koin-ktor

  • koin-ktor3アーティファクトはkoin-ktorに統合されました(4.1.0で非推奨となり、4.2.0で完全に統合)。

破壊的変更 ​

koin-android

  • Koinが使用するAndroidXライブラリに合わせるため、Min SDKが21から23に引き上げられました。

koin-compose-navigation3

  • Min APIレベルは23です。

koin-core

  • Module.getAll(...)は結果をソートしなくなりました。インスタンスは宣言順で返されます。特定の順序に依存している場合は、明示的にソートしてください。

Koin Compiler Plugin ​

現在のバージョン: 1.2.1。Koin 4.2.0以降およびKotlin K2コンパイラ(2.3.20、2.4.0、2.4.10、2.4.20で検証済み)が必要です。

Koin Compiler Pluginは、ネイティブのKotlinコンパイラプラグインです。KSPベースのKoin Annotationsプロセッサを置き換え、KSPステップを必要とせずにKotlinコンパイルの一部として動作します。インストール方法とGradleオプションについては、Compiler Plugin SetupおよびCompiler Plugin Optionsを参照してください。検証内容については、Compile-Time Safetyに記載されています。JVM、JS、Wasm、iOS、macOS、watchOS、tvOS、Linux、Windowsなど、すべてのKotlin Multiplatformターゲットをサポートしています。

koin-ksp-compilerからの移行については、Migrating from KSP to the Compiler Pluginを参照してください。

1.2.1 ​

Kotlin 2.4.20のサポートに加え、実際のKMPアプリで発見された2つの不具合が修正されました。

  • Kotlin 2.4.20: 1.2.0では、Kotlin 2.4.20を使用しているプロジェクトがIR生成中にNoSuchMethodErrorで失敗していました(#89、#99)。Kotlin 2.4.20でプラグインが使用していた4つのコンパイラAPIが削除またはシグネチャ変更されていましたが、その4つすべてが修正されました。
  • KLIBの修正: @Configurationモジュールが依存関係を経由して中継された際に、wasmJs、JS、Kotlin/Nativeのビルドがcomponentscan_*ヒントにおいてDifferent declarations with the same signatures were detectedというエラーで失敗していました。JVMとAndroidは影響を受けませんでした。
  • 修飾子の修正: モジュールをまたいで読み取られた際に、1つの型に対する2つの@Namedプロバイダが1つにまとめられ、誤ったKOIN-D001エラーが発生していました。誤ったD001エラーのためにcompileSafetyを無効にしていた場合は、有効にして再度確認してください。
  • 厳密なKotlinバージョンチェック: 正確なバージョンがチェックされている場合のみ、検証済みとしてカウントされるようになりました。未検証のバージョンは警告を出して続行し、ビルドをブロックすることはありません。

詳細は1.2.1 リリースノートを参照してください。

1.2.0 ​

コンパイル時の安全性がKoin DSL全体に適用されるようになり、モジュール間のincludesによって定義が隠蔽されることがなくなりました。

  • Constructor DSLの検証: singleOf(::T)、factoryOf(::T)、scopedOf(::T)、viewModelOf(::T)、およびScope.new(::T)に対して、single<T>()と同様の依存関係の欠落チェックおよび修飾子チェックが行われるようになりました。ここでチェックされていなかった依存関係の欠落に依存していたコードは、コンパイルエラーになるようになります。これは不具合ではなく、チェック範囲の網羅によるものです。
  • 新しいエントリポイント: KoinApplication.withConfiguration<T>()およびKtorのinstall(Koin) { modules(...) }。
  • モジュールリスト: startKoin { modules(myList) }がlistOf、+、.toList()、およびList<Module>を返す関数を解決するようになりました。実行時に分岐するリストは未解決のままとなり、KOIN-W003がその呼び出し箇所を指摘します。
  • モジュール関数: fun myModule(): Module = module { ... }がトップレベルのvalと同様に追跡されるようになりました。
  • モジュール間の修正: 2つ以上implementationを挟んだ先にある定義が、@Module(includes)(#82)、@Configuration自動検出、およびDSLのincludes(...)を通して参照できない問題を修正しました。複数のbinds(...)が認識されるようになり、@Module(includes)が修飾子のみが異なるプロバイダを統合してしまうことがなくなりました(#94)。
  • 手書きのラムダ: single { X(get()) }はコンストラクタから推測するのではなく、独自のget()呼び出しを通して検証されるようになりました。これにより、誤ったKOIN-D004の循環参照エラーが解消されます。

詳細は1.2.0 リリースノートを参照してください。

1.1.0 ​

フルグラフ検証のみとなりました。各Koinエントリポイント(startKoin、koinApplication、@KoinApplication)での1回のフルグラフチェックが採用され、モジュールごとの検証は廃止されました。これにより、モジュール間における誤検知が解消されます。その代償として、自身のコンパイル内に独自のエントリポイントを持たないリーフモジュールやライブラリモジュールは、周囲に実際のグラフが組み立てられるまで、コンパイル時安全性の診断を受けられなくなります。

詳細は1.1.0 リリースノートを参照してください。

4.1.1 ​

Kotlin 2.1.21。

新機能 ​

koin-compose-viewmodel-navigation

  • sharedKoinViewModelに、Compose Navigation用のオプションパラメータnavGraphRouteが追加されました。

koin-core

  • コアリゾルバーの最適化: 単一スコープ内で解決する際の不要なフラット化を排除しました。
  • スコープのデバッグ時にリンクされたスコープIDが表示されるようになりました。

ライブラリの更新 ​

  • Kotlin: 2.1.21(2.1.20から更新)
  • Ktor: 3.2.3(3.1.3から更新)
  • JetBrains Compose: 1.8.2(1.8.0から更新)
  • AndroidX: Fragment 1.8.9、WorkManager 2.10.3、Lifecycle 2.9.3、Navigation 2.9.3
  • テスト: Robolectric 4.15.1、Benchmark 0.4.14
  • ビルド: Binary Validator 0.18.1、NMCP 1.1.0

バグ修正 ​

koin-core

  • 互換性エラーの原因となっていたロガーの制約を元に戻しました。
  • LocalKoinApplicationとLocalKoinScopeのコンテキスト処理を改善し、Composeのスコープ解決を修正しました。

koin-build

  • Maven Centralへの公開に関する問題を修正しました。

4.1.0 ​

Kotlin 2.1.20。

新機能 ​

koin-core

  • Koin設定をラップするためのKoinConfiguration API。
  • スコープアーキタイプ: スコープのカテゴリを表す専用のスコープ型修飾子。インスタンスをスコープカテゴリ(アーキタイプ)に対して解決できるようになりました。
  • 機能オプション: Koin内部の新しい動作を有効にする機能フラグ。Koin設定のoptionsブロックでオプションを有効化します:
kotlin
startKoin {
    options(
        // 新機能を有効化
        viewModelScopeFactory()
    )
}
  • 外部システムまたはリソースからの解決を可能にするResolutionExtensionを備えた新しいCoreResolver(Ktor DIの連携に使用)。

koin-android

  • ライブラリのアップグレード(androidx.appcompat:appcompat:1.7.0、androidx.activity:activity-ktx:1.10.1)に伴い、Min SDKが14から21に引き上げられました。
  • ActivityまたはFragment用のスコープを宣言するためのモジュールDSL拡張機能activityScope、activityRetainedScope、fragmentScope。
  • activityScope()、activityRetainedScope()、fragmentScope()関数でスコープアーキタイプが使用されるようになりました。

koin-androidx-compose

  • Koin Compose Multiplatform、Compose 1.8、Lifecycle 2.9に適合。

koin-compose

  • Compose 1.8およびLifecycle 2.9に適合。
  • Android StudioおよびIntelliJ IDEAでプレビューを並行レンダリングするためのKoinApplicationPreview。

koin-compose-viewmodel

  • 親ActivityをViewModelホストとして使用するためのkoinActivityViewModel。

koin-ktor

  • マルチプラットフォーム対応: 本モジュールがKotlin Multiplatform向けにビルドされるようになりました。マルチプラットフォームプロジェクトからkoin-ktorを使用できます。
  • 従来のkoin-ktor3モジュールがkoin-ktorに統合されました。
  • Ktorモジュール内で直接Koinモジュールを宣言するためのApplication.koinModule { }およびApplication.koinModules():
kotlin
fun Application.customerDataModule() {
    koinModule {
        singleOf(::CustomerRepositoryImpl) bind CustomerRepository::class
    }
}
  • Module.requestScope: scope<RequestScope>を手動で宣言することなく、Ktorリクエストスコープ内に定義を宣言できます。リクエストスコープはコンストラクタ内でApplicationCallをインジェクトすることも可能です。

koin-core-coroutines

  • ModuleConfiguration: 後から検証できるよう、モジュール設定を1つの構造体に集約します。
kotlin
val m1 = module {
    single { Simple.ComponentA() }
}
val lm1 = lazyModule {
    single { Simple.ComponentB(get()) }
}
val conf = moduleConfiguration {
    modules(m1)
    lazyModules(lm1)
}
  • Koin設定はModuleConfigurationからモジュールを読み込むことができます:
kotlin
startKoin {
    moduleConfiguration {
        modules(m1)
        lazyModules(lm1)
    }
}

// または以下のように記述することも可能
val conf = moduleConfiguration {
    modules(m1)
    lazyModules(lm1)
}

startKoin {
    moduleConfiguration(conf)
}

koin-test-coroutines

  • コルーチン関連のテストAPI向けに、新しいkoin-test-coroutinesモジュールを追加。
  • Verify APIで通常モジュールと遅延モジュールを混在させたmoduleConfigurationをチェックできるようになりました:
kotlin
val conf = moduleConfiguration {
    modules(m1)
    lazyModules(lm1)
}

conf.verify()

// Androidの型が必要な場合 (koin-android-test)
conf.verify(extraTypes = androidTypes)

koin-core-annotations

  • @InjectedParamおよび@Providedにより、プロパティをインジェクトされたパラメータまたは動的に提供されるものとしてマークします。現時点ではVerify APIによって使用されます。

実験的機能 ​

koin-core

  • Wasm: Kotlin 2.1.20のUUID生成を使用します。

koin-core-viewmodel

  • ViewModelスコープアーキタイプにスコープされたコンポーネントを宣言するためのモジュールDSL拡張機能viewModelScope。
  • ViewModelクラスに紐づくスコープを作成するviewModelScope()関数。スコープを閉じるためにViewModelScopeAutoCloseable(AutoCloseable API)を使用するため、ViewModelスコープを手動で閉じる必要がなくなりました。
  • ScopeViewModelクラスの更新: スコープの作成とクローズを処理する、すぐに使えるViewModelスコープ対応クラス。
  • viewModelScopeFactoryオプションによる、ViewModelのスコープからのコンストラクタインジェクション:
kotlin
startKoin {
    options(
        // 新しいViewModelスコープ作成を有効化
        viewModelScopeFactory()
    )
}

// MyScopeViewModelのスコープからSessionがインジェクトされます
class MyScopeViewModel(val session: Session) : ViewModel()

module {
    viewModelOf(::MyScopeViewModel)
    viewModelScope {
        scopedOf(::Session)
    }
}

koin-compose

  • KoinMultiplatformApplication関数: Compose Multiplatform向けのエントリポイント。

koin-core-viewmodel-navigation

  • ナビゲーションのNavBackStackEntryからViewModelインスタンスを再利用するためのsharedViewModel拡張関数。

koin-test

  • Verify APIが、nullable、lazy、およびリストパラメータをチェックするようになりました。Verify呼び出し内で宣言する代わりに、プロパティに@InjectedParamまたは@Providedを付与して、インジェクトされるパラメータまたは動的に提供されるものとして宣言できます。
kotlin
// Verifyで検出されるようになります
class ComponentB(val a: ComponentA? = null)
class ComponentBParam(@InjectedParam val a: ComponentA)
class ComponentBProvided(@Provided val a: ComponentA)

非推奨 ​

koin-android

  • ScopeViewModelは非推奨となりました。koin-core-viewmodelのScopeViewModelクラスを使用してください。

koin-compose

  • KoinContextは非推奨となり、削除可能です: Koinコンテキストは現在のデフォルトコンテキスト上で準備されるようになりました。

koin-androidx-compose

  • KoinAndroidContextは非推奨となり、削除可能です: Koinコンテキストは現在のデフォルトコンテキスト上で準備されるようになりました。

koin-androidx-compose-navigation

  • Lifecycleライブラリの更新に伴い、koinNavViewModelは不要になりました。koinViewModelに置き換えてください。

koin-core-viewmodel-navigation

  • Lifecycleライブラリの更新に伴い、koinNavViewModelは不要になりました。koinViewModelに置き換えてください。

koin-ktor

  • Application.koinは非推奨となり、Application.koinModulesおよびApplication.koinModuleの使用が推奨されます。

破壊的変更 ​

koin-android

  • 古い状態対応のViewModel APIが削除されました:
    • stateViewModel()、getStateViewModel(): viewModel()を使用してください。
    • getSharedStateViewModel()、sharedStateViewModel(): viewModel()、または共有インスタンスにはactivityViewModel()を使用してください。

koin-compose

  • 古いCompose API関数が削除されました:
    • inject(): koinInject()を使用してください。
    • getViewModel(): koinViewModel()を使用してください。
    • rememberKoinInject(): koinInject()に統合されました。
  • rememberKoinApplicationには@KoinInternalApiがマークされました。

4.0.4 ​

Kotlin 2.0.21。

すべてのライブラリバージョンはlibs.versions.tomlに記載されています。

新機能 ​

koin-core

  • KoinPlatformTools.generateId()がKotlinのkotlin.uuid APIを使用するようになり、すべてのプラットフォームで実際のUUIDを生成するようになりました。

koin-viewmodel

  • Koin 4.0では、GoogleとJetBrainsのKMP API間で共有されるViewModel DSLおよびAPIが導入されました。重複を避けるため、ViewModel APIはkoin-core-viewmodelおよびkoin-core-viewmodel-navigationに配置されるようになりました。
  • ViewModel DSLのインポートはorg.koin.core.module.dsl.*です。

koin-core-coroutines: API全体が安定版になりました

  • すべてのlazyModules
  • awaitAllStartJobs、onKoinStarted、isAllStartedJobsDone
  • waitAllStartJobs、runOnKoinStarted
  • KoinApplication.coroutinesEngine
  • Module.includes(lazy)
  • lazyModule()
  • KoinPlatformCoroutinesTools

実験的機能 ​

koin-test

  • ParameterTypeInjection: Verify API用の動的パラメータインジェクションを宣言します。

koin-androidx-startup

  • androidx.startup.Initializer APIを介してAndroidX StartupでKoinを起動します。koin-androidx-startup API全体が実験的機能です。

koin-compose

  • rememberKoinModules: @Composableを使用してKoinモジュールをロードおよびアンロードします。
  • rememberKoinScope: @Composableを使用してKoinスコープをロードおよびアンロードします。
  • KoinScope: すべての子コンポーザブルに対してKoinスコープをロードします。

非推奨 ​

koin-test

  • checkModules API全体。Verify APIへ移行してください。

koin-android

  • koin-core内の共有DSLへの移行に伴い、Android ViewModel DSLは非推奨となりました。
  • 状態対応ViewModel APIのエラーレベルへの引き上げ:
    • stateViewModel()、getStateViewModel(): viewModel()を使用してください。
    • getSharedStateViewModel()、sharedStateViewModel(): viewModel()、または共有インスタンスにはactivityViewModel()を使用してください。

koin-compose

  • 古いCompose API関数のエラーレベルへの引き上げ:
    • inject(): koinInject()を使用してください。
    • getViewModel(): koinViewModel()を使用してください。
    • rememberKoinInject(): koinInject()を使用してください。

koin-compose-viewmodel

  • koin-core内の共有DSLへの移行に伴い、ViewModel DSLは非推奨となりました。
  • koinNavViewModelは非推奨となり、koinViewModelの使用が推奨されます。

破壊的変更 ​

前回のマイルストーンで非推奨となった以下のAPIが削除されました。@KoinReflectAPIが付与されたすべてのAPIも削除されています。

koin-core

  • ApplicationAlreadyStartedExceptionの名前がKoinApplicationAlreadyStartedExceptionに変更されました。
  • KoinScopeComponent.closeScope()が削除されました(内部で使用されなくなりました)。
  • InstanceContextが内部のResolutionContextに置き換わりました。
  • KoinPlatformTimeTools、Timer、measureDurationが削除されました。Kotlin Time APIを使用してください。
  • KoinContextHandlerが削除され、GlobalContextが推奨されます。

koin-android

  • Fragment.createScope()が削除されました。
  • 新しい内部構造に合わせて、ViewModelファクトリAPI(主に内部用)が刷新されました。

koin-compose

  • StableParametersDefinitionが削除されました(内部で使用されなくなりました)。
  • 遅延ViewModel API(古いviewModel())が削除されました。
  • rememberStableParametersDefinition()が削除されました(内部で使用されなくなりました)。

3.5.6 ​

Kotlin 1.9.22。

すべてのライブラリバージョンはlibs.versions.tomlに記載されています。

新機能 ​

koin-core

  • KoinContextに新しい関数が追加されました:
    • fun loadKoinModules(module: Module, createEagerInstances: Boolean = false)
    • fun loadKoinModules(modules: List<Module>, createEagerInstances: Boolean = false)
  • koinApplication()に複数のシグネチャが追加されました:
    • koinApplication(createEagerInstances: Boolean = true, appDeclaration: KoinAppDeclaration? = null)
    • koinApplication(appDeclaration: KoinAppDeclaration?)
    • koinApplication(createEagerInstances: Boolean)
  • 宣言スタイルを拡張するKoinAppDeclaration。
  • JSでTime APIを使用するためのKoinPlatformTimeTools。
  • iOS: synchronized APIがTouchlab Lockable APIを使用するようになりました。

koin-androidx-compose

  • Android環境から現在のKoinコンテキストにバインドするためのKoinAndroidContext。

koin-compose

  • 現在のデフォルトコンテキストで開始するためのKoinContext。

koin-ktor

  • Ktorインスタンス用に分離されたコンテキストを使用するようになりました(デフォルトコンテキストの代わりにApplication.getKoin()を使用)。
  • Koin Ktorプラグインに新しいモニタリング機能を追加。
  • インスタンスをKtorリクエストにスコープするためのRequestScope。

実験的機能 ​

koin-android

  • ViewModelScope: ViewModelスコープ向けの実験的API。

koin-core-coroutines

  • バックグラウンドでモジュールをロードするための新しいAPI。

非推奨 ​

koin-android

  • getLazyViewModelForClass(): 処理が複雑でデフォルトのグローバルコンテキストを呼び出します。ActivityおよびFragment APIを使用してください。
  • resolveViewModelCompat()は非推奨となり、resolveViewModel()の使用が推奨されます。

koin-compose

  • get()およびinject()は非推奨となり、koinInject()の使用が推奨されます。
  • getViewModel()は非推奨となり、koinViewModel()の使用が推奨されます。
  • rememberKoinInject()は非推奨となり、koinInject()の使用が推奨されます。

破壊的変更 ​

koin-core

  • Koin.loadModules(modules: List<Module>, allowOverride: Boolean = true)がKoin.loadModules(modules: List<Module>, allowOverride: Boolean = true, createEagerInstances: Boolean = false)に置き換わりました。
  • KoinExtension.koinプロパティがKoinExtension.onRegister()関数に置き換わりました。
  • iOS: internal fun globalContextByMemoryModel(): KoinContextがMutableGlobalContextを使用するようになりました。

koin-compose

  • KoinApplication(moduleList: () -> List<Module>, content: @Composable () -> Unit)が削除され、KoinContextおよびKoinAndroidContextの使用が推奨されます。

3.4.3 ​

Kotlin 1.8.21。

新機能 ​

koin-core

  • Koin用の拡張エンジンを作成するためのExtensionManager API(ExtensionManagerおよびKoinExtension)。
  • パラメータAPI: parameterArrayOfおよびparameterSetOf。

koin-test

  • モジュールに対してverify()を実行するためのVerification API。

koin-android

  • ViewModelインジェクションの内部構造を刷新。
  • AndroidScopeComponent.onCloseScope()コールバック。

koin-android-test

  • モジュールに対してandroidVerify()を実行するためのVerification API。

koin-androidx-compose

  • get()。
  • getViewModel()。
  • スコープKoinActivityScopeおよびKoinFragmentScope。

koin-androidx-compose-navigation(新規モジュール)

  • koinNavViewModel()。

koin-compose(Compose向け新規マルチプラットフォームAPI)

  • koinInjectおよびrememberKoinInject。
  • KoinApplication。

実験的機能 ​

koin-compose

  • rememberKoinModules。
  • KoinScopeおよびrememberKoinScope。

非推奨 ​

koin-compose

  • 遅延関数を避けるため、inject()は非推奨となりget()の使用が推奨されます。
  • 遅延関数を避けるため、viewModel()は非推奨となりgetViewModel()の使用が推奨されます。

破壊的変更 ​

koin-android

  • LifecycleScopeDelegateが削除されました。

koin-androidx-compose

  • getStateViewModelが削除され、koinViewModelの使用が推奨されます。