mori-atsushi · mori-atsushi · Mar 22, 2023 · Mar 21, 2023 · Mar 22, 2023
diff --git a/build.gradle.kts b/build.gradle.kts
@@ -31,6 +31,6 @@ subprojects {
 }
 
 tasks.dokkaHtmlMultiModule {
-    moduleVersion.set("1.3.0-beta01")
+    moduleVersion.set("1.3.0-beta02")
     outputDirectory.set(rootDir.resolve("docs/static/api"))
 }
diff --git a/docs/docs/android/activity.mdx b/docs/docs/android/activity.mdx
@@ -15,7 +15,7 @@ The following dependency is required to take advantage of the additional support
 
 ```kotlin
 dependencies {
-    implementation("com.moriatsushi.koject:koject-android-activity:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-android-activity:1.3.0-beta02")
 }
 ```
 

diff --git a/docs/docs/android/application.mdx b/docs/docs/android/application.mdx
@@ -17,7 +17,7 @@ To get started, add the following dependencies for Android:
 
 ```kotlin
 dependencies {
-    implementation("com.moriatsushi.koject:koject-android-core:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-android-core:1.3.0-beta02")
 }
 ```
 

diff --git a/docs/docs/android/fragment.mdx b/docs/docs/android/fragment.mdx
@@ -15,7 +15,7 @@ The following dependency is required to take advantage of the additional support
 
 ```kotlin
 dependencies {
-    implementation("com.moriatsushi.koject:koject-android-fragment:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-android-fragment:1.3.0-beta02")
 }
 ```
 

diff --git a/docs/docs/android/viewmodel.mdx b/docs/docs/android/viewmodel.mdx
@@ -15,11 +15,11 @@ Add the appropriate dependencies for the injection target:
 ```kotlin
 dependencies {
     // Inject ViewModel into Activity
-    implementation("com.moriatsushi.koject:koject-android-activity:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-android-activity:1.3.0-beta02")
     // Inject ViewModel into Fragment
-    implementation("com.moriatsushi.koject:koject-android-fragment:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-android-fragment:1.3.0-beta02")
     // ViewModelFactory only
-    implementation("com.moriatsushi.koject:koject-android-viewmodel:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-android-viewmodel:1.3.0-beta02")
 }
 ```
 
@@ -75,15 +75,15 @@ Refer to the [documentation](/docs/compose/viewmodel) to inject ViewModels in Je
 
 :::
 
-:::note MIGRATION (VERSION 1.3.0-beta01)
+:::note MIGRATION (VERSION 1.3.0-beta02)
 
-As of version v1.3.0-beta01, `injectViewModels()` has been renamed to `lazyViewModels()`:
+As of version v1.3.0-beta02, `injectViewModels()` has been renamed to `lazyViewModels()`:
 
 ```kotlin
 // Until v1.1.0
 private val viewModel: TopViewModel by injectViewModels()

-// Since v1.3.0-beta01
+// Since v1.3.0-beta02
 private val viewModel: TopViewModel by lazyViewModels()
 ```
 :::

diff --git a/docs/docs/compose/core.mdx b/docs/docs/compose/core.mdx
@@ -14,7 +14,7 @@ To use Koject for injection into Composable functions, you need to add the follo
 
 ```kotlin
 dependencies {
-    implementation("com.moriatsushi.koject:koject-compose-core:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-compose-core:1.3.0-beta02")
 }
 ```
 

diff --git a/docs/docs/compose/viewmodel.mdx b/docs/docs/compose/viewmodel.mdx
@@ -18,7 +18,7 @@ To inject ViewModels into Composable, add the following dependencies:
 
 ```kotlin
 dependencies {
-    implementation("com.moriatsushi.koject:koject-compose-viewmodel:1.3.0-beta01")
+    implementation("com.moriatsushi.koject:koject-compose-viewmodel:1.3.0-beta02")
 }
 ```
 

diff --git a/docs/docs/ios/basic.mdx b/docs/docs/ios/basic.mdx
@@ -0,0 +1,77 @@
+import {
+    Provides,
+} from '@site/src/components/CodeLink';
+
+# Inject into Swift
+Koject supports KMM projects, allowing you to share code between Android and iOS.
+This document explains how to use the dependencies provided by Kotlin in your Swift code.
+
+## Getting Started
+
+To call Koject from Swift, you need to define the necessary actions in Kotlin.
+
+First, create a `KojectHelper` object in the `iosMain` folder and add a `start` function for initialization.
+
+```kotlin title="src/iosMain/kotlin/KojectHelper.ios.kt"
+object KojectHelper {
+    fun start() {
+        Koject.start()
+    }
+}
+```
+
+Next, call `KojectHelper.shared.start()` in `@main` in Swift to start Koject.
+
+```swift title="MyApp.swift"
+import SwiftUI
+import shared
+
+@main
+struct MyApp: App {
+    init() {
+        KojectHelper.shared.start()
+    }
+
+	var body: some Scene {
+		/* ... */
+	}
+}
+```
+
+Define the necessary dependencies in Kotlin and provide them using <Provides/>.
+
+```kotlin title="src/commonMain/kotlin/SampleRepository.kt"
+@Provides
+@Singleton
+class SampleRepository
+```
+```kotlin title="src/commonMain/kotlin/SampleViewModel.kt"
+@Provides
+class SampleViewModel(
+    private val repository: SampleRepository
+)
+```
+
+Add the necessary dependencies on the Swift side to `KojectHelper` as shown below.
+
+```kotlin title="src/iosMain/kotlin/KojectHelper.ios.kt"
+object KojectHelper {
+    fun start() {
+        Koject.start()
+    }
+
+    fun injectSampleViewModel(): SampleViewModel {
+        return inject()
+    }
+}
+```
+
+You can use it by calling `KojectHelper.shared.injectSampleViewModel()` in Swift.
+
+```swift title="SampleState.swift"
+import shared
+
+class SampleState {
+    private let viewModel = KojectHelper.shared.injectSampleViewModel()
+}
+```
diff --git a/docs/docs/ios/index.mdx b/docs/docs/ios/index.mdx
@@ -0,0 +1,6 @@
+# iOS (KMM)
+Koject supports [Kotlin Multiplatform Mobile](https://kotlinlang.org/lp/mobile/)(KMM) and can also be used on iOS.
+
+import DocCardList from '@theme/DocCardList';
+
+<DocCardList />
diff --git a/docs/docs/ios/tests.mdx b/docs/docs/ios/tests.mdx
@@ -0,0 +1,145 @@
+import {
+    KojectRunTest,
+    KojectStartTest,
+} from '@site/src/components/CodeLink';
+
+# iOS tests
+There are two ways to test KMM iOS code: testing with Kotlin only and integration testing from iOS.
+Here is an introduction to both methods.
+
+:::info LINK
+
+To understand the basics of testing, please refer to the [Test documentation](/docs/test) first.
+
+:::
+
+## Testing with Kotlin only
+
+To test with Kotlin only, you can use <KojectRunTest/> or <KojectStartTest/> to use the DI container for testing.
+
+```kotlin
+@Provides
+class Controller
+```
+```kotlin
+class SampleTest() {
+    @Test
+    fun test() = Koject.runTest {
+        val controller = inject<Controller>() // can be injected
+    }
+}
+```
+
+Please refer to the [Test documentation](/docs/test) for more details.
+
+## iOS Unit tests
+To test including code written in Swift, use [XCTest](https://developer.apple.com/documentation/xctest).
+
+First, add the `koject-test` dependency to `iosMain` in shared/build.gradle.kts.
+
+```diff title="shared/build.gradle.kts"
+kotlin {
+    /* ... */
+
+    sourceSets {
+        val commonMain by getting {
+            dependencies {
+                implementation("com.moriatsushi.koject:koject-core:1.3.0-beta02")
+            }
+        }
+
+        val iosMain by getting {
++            dependencies {
++                implementation("com.moriatsushi.koject:koject-test:1.3.0-beta02")
++            }
+        }
+    }
+}
+```
+
+Create a `KojectHelper` object and add `startTest()` and `stop()` functions.
+
+```kotlin title="src/iosMain/kotlin/KojectHelper.ios.kt"
+object KojectHelper {
+    fun start() {
+        Koject.start()
+    }
+
+    fun startTest() {
+        Koject.startTest()
+    }
+
+    fun stop() {
+        Koject.stop()
+    }
+}
+```
+
+You can test with the DI container for testing by calling `startTest` in `setUpWithError` and `stop` in `tearDownWithError`.
+
+```swift title="SampleStateTests.swift"
+import XCTest
+@testable import ios
+@testable import shared
+
+final class SampleStateTests: XCTestCase {
+    override func setUpWithError() throws {
+        KojectHelper.shared.startTest()
+    }
+
+    override func tearDownWithError() throws {
+        KojectHelper.shared.stop()
+    }
+
+    func test() throws {
+        /* ... */
+    }
+}
+```
+
+## iOS UI tests
+When performing UI tests, the DI container for the application is used, so branching must be done on the application side.
+
+First, create a branch in `@main` as follows:
+
+```swift title="MyApp.swift"
+import SwiftUI
+import shared
+
+@main
+struct MyApp: App {
+    init() {
+        #if DEBUG
+        let isTesting = CommandLine.arguments.contains("TESTING")
+        if isTesting {
+            KojectHelper.shared.startTest()
+        } else {
+            KojectHelper.shared.start()
+        }
+        #else
+        KojectHelper.shared.start()
+        #endif
+    }
+
+	var body: some Scene {
+		/* ... */
+	}
+}
+```
+
+Specify `launchArguments` when starting the test, and UI tests can be executed using the DI container for testing.
+
+```swift title="UITests.swift"
+import XCTest
+
+final class UITests: XCTestCase {
+    let app = XCUIApplication()
+
+    func testAddTask() {
+        app.launchArguments = ["TESTING"]
+        app.launch()
+
+        /* ... */
+    }
+}
+```