Add support for iOS target

.github/workflows/build-apps.yml

@@ -10,16 +10,21 @@ on:
 
 jobs:
   build:
-    name: 🔨 Build
-    runs-on: ubuntu-24.04
+    name: 🔨 Build - ${{ matrix.name }}
+    runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         include:
           - name: 📱 Android App
             gradle_module: tasks-app-android
+            os: ubuntu-24.04
           - name: 🖥️ Desktop App
             gradle_module: tasks-app-desktop
+            os: ubuntu-24.04
+          - name: 🍎 iOS App
+            gradle_module: tasks-app-ios
+            os: macos-15
     permissions:
         contents: write
         checks: write
@@ -30,12 +35,24 @@ jobs:
     - uses: actions/checkout@v4
     - uses: ./.github/actions/setup-jdk-gradle
 
+    - name: Cache Gradle
+      if: ${{ matrix.gradle_module == 'tasks-app-ios' }}
+      uses: actions/cache@v4
+      with:
+        path: |
+          .gradle
+          $HOME/.m2/repository
+          $HOME/.konan
+        key: gradle-${{ runner.os }}-${{ hashFiles('gradle/libs.versions.toml', 'gradle/wrapper/gradle-wrapper.properties', '**/*.gradle.kts', '**/*.gradle') }}
+        restore-keys: |
+          gradle-${{ runner.os }}-
+
     - name: 🔓 Decrypt secrets
       env:
         PLAYSTORE_SECRET_PASSPHRASE: ${{ secrets.PLAYSTORE_SECRET_PASSPHRASE }}
       run: ./_ci/decrypt_secrets.sh
 
-    - name: ${{ matrix.name }}
+    - name: ${{ matrix.gradle_module }}
       env:
         PLAYSTORE_SECRET_PASSPHRASE: ${{ secrets.PLAYSTORE_SECRET_PASSPHRASE }}
         KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
@@ -50,4 +67,6 @@ jobs:
             -Pplaystore.keystore.file="${PWD}/_ci/tasksApp.keystore" \
             -Pplaystore.keystore.password="${KEYSTORE_PASSWORD}" \
             -Pplaystore.keystore.key_password="${KEYSTORE_KEY_PASSWORD}"
+        elif [ "${gradle_module}" = "tasks-app-ios" ]; then
+          IOS_TARGET=simulator ./gradlew tasks-app-shared:linkDebugFrameworkIosSimulatorArm64
         fi

.github/workflows/e2e-tests.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   check-changes:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     outputs:
       changes-detected: ${{ steps.check.outputs.changes_detected }}
     steps:

.github/workflows/ios-app-nightly.yml

@@ -0,0 +1,73 @@
+name: 🍎 iOS App Nightly
+
+on:
+  schedule:
+    - cron: '0 2 * * *'
+  workflow_dispatch:
+
+jobs:
+  check-changes:
+    runs-on: macos-15
+    outputs:
+      changes-detected: ${{ steps.check.outputs.changes_detected }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check for changes
+        id: check
+        run: |
+          git fetch origin main
+          if git log --since="24 hours ago" --pretty=format:%H -- . \
+              ':(exclude)website/' \
+              ':(exclude)fastlane/' \
+              ':(exclude)assets/' \
+              ':(exclude)**/*.md' \
+              | grep .; then
+            echo "changes_detected=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "changes_detected=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  build-ios-app:
+    timeout-minutes: 15
+    needs: check-changes
+    if: needs.check-changes.outputs.changes-detected == 'true' || github.event_name == 'workflow_dispatch'
+    name: 🍎 Build iOS App
+    runs-on: macos-15
+
+    steps:
+    - uses: actions/checkout@v4
+    - uses: ./.github/actions/setup-jdk-gradle
+
+    - name: Cache Gradle
+      if: ${{ matrix.gradle_module == 'tasks-app-ios' }}
+      uses: actions/cache@v4
+      with:
+        path: |
+          .gradle
+          $HOME/.m2/repository
+          $HOME/.konan
+        key: gradle-${{ runner.os }}-${{ hashFiles('gradle/libs.versions.toml', 'gradle/wrapper/gradle-wrapper.properties', '**/*.gradle.kts', '**/*.gradle') }}
+        restore-keys: |
+          gradle-${{ runner.os }}-
+
+    - name: 🔓 Decrypt secrets
+      env:
+        PLAYSTORE_SECRET_PASSPHRASE: ${{ secrets.PLAYSTORE_SECRET_PASSPHRASE }}
+      run: ./_ci/decrypt_secrets.sh
+
+    - name: 🔨 Build
+      run: |
+          cd tasks-app-ios
+          IOS_TARGET=simulator xcodebuild \
+            -project Taskfolio.xcodeproj \
+            -scheme Taskfolio \
+            -sdk iphonesimulator \
+            -arch arm64 \
+            -configuration Debug \
+            build \
+            CODE_SIGNING_ALLOWED=NO \
+            CODE_SIGN_IDENTITY="" \
+            CODE_SIGNING_REQUIRED=NO

.gitignore

@@ -33,6 +33,11 @@ local.properties
 .kotlin/metadata/
 
 tasks-app-android/google-services.json
+tasks-app-desktop/bin/
+tasks-app-ios/Taskfolio.xcodeproj/xcuserdata/*.xcuserdatad
+tasks-app-ios/Taskfolio.xcodeproj/project.xcworkspace/contents.xcworkspacedata
+tasks-app-ios/Taskfolio.xcodeproj/project.xcworkspace/xcuserdata/*.xcuserdatad
+tasks-app-ios/Taskfolio.xcodeproj/project.xcworkspace/xcshareddata/*
 
 *token_cache.*
 client_secret_*.apps.googleusercontent.com.json
@@ -42,4 +47,3 @@ _ci/api-*.json
 bundletool-*.jar
 
 _site/
-tasks-app-desktop/bin/

README.md

@@ -9,7 +9,7 @@
 
 The coverage report excludes code not intended to be covered.
 
-This avoids the [“broken window” effect](https://blog.codinghorror.com/the-broken-window-theory/): whether coverage is at 43% or 56%, it’s perceived as equally low—so efforts to improve it are often dismissed. In contrast, high or near-100% coverage is seen as achievable and worth tracking.
+This avoids the [“broken window” effect](https://blog.codinghorror.com/the-broken-window-theory/): whether coverage is at 43% or 56%, it's perceived as equally low—so efforts to improve it are often dismissed. In contrast, high or near-100% coverage is seen as achievable and worth tracking.
 
 Refer to the root project's [`build.gradle.kts`](build.gradle.kts#L55-L90) for details.
 
@@ -36,13 +36,16 @@ Refer to the root project's [`build.gradle.kts`](build.gradle.kts#L55-L90) for d
 
 [**Taskfolio**](https://opatry.github.io/taskfolio) is an Android task management app built using [Google Tasks API](https://developers.google.com/tasks/reference/rest). Developed to demonstrate my expertise in modern Android development, it highlights my skills in architecture, UI design with Jetpack Compose, OAuth authentication, and more—all packaged in a sleek, user-friendly interface.
 
-> I set out to revisit the classical TODO app, ‘local-first’ syncing with Google Tasks—aiming for an <abbr title="Minimum Viable Experience">MVE</abbr> in 2 weeks, focusing on the 80/20 rule to nail the essentials.
+> I set out to revisit the classical TODO app, 'local-first' syncing with Google Tasks—aiming for an <abbr title="Minimum Viable Experience">MVE</abbr> in 2 weeks, focusing on the 80/20 rule to nail the essentials.
 
 | ![](assets/screens/task_lists_light.png) | ![](assets/screens/groceries_light.png) | ![](assets/screens/add_task_light.png) | ![](assets/screens/home_dark.png)  |
 | --------------------------------------- |--------------------------------------- | ---------------------------------- | ---------------------------------- |
 
 [![Taskfolio on Play Store](assets/GetItOnGooglePlay_Badge_Web_color_English.png)](https://play.google.com/store/apps/details?id=net.opatry.tasks.app)
 
+> [!NOTE]
+> The application is also available as a desktop (Jvm) application and an iOS application as well (using [Compose Multi Platform (aka CMP)](https://www.jetbrains.com/compose-multiplatform/) as UI Toolkit).
+
 ## 🎯 Project intentions
 
 - [x] Showcase my expertise in Android application development
@@ -76,9 +79,10 @@ I do not aim to implement advanced features beyond what is supported by the Goog
 
 ## 🛠️ Tech stack
 
-- [Kotlin](https://kotlinlang.org/), [Multiplatform (aka KMP)](https://kotlinlang.org/docs/multiplatform.html) (currently Desktop & Android are supported)
-  - iOS wasn’t initially planned, but I bootstrapped a [PR to evaluate the feasibility of the iOS target]((https://github.com/opatry/taskfolio/pull/269)). It turned out to be quite achievable and just needs some polishing.
-  - Web is not planned any time soon (contribution are welcome 🤝)
+- [Kotlin](https://kotlinlang.org/), [Multiplatform (aka KMP)](https://kotlinlang.org/docs/multiplatform.html)
+  - Android and Desktop are fully supported.
+  - iOS wasn't initially planned, but a draft version is available (use it at your own risk, there might be dragons 🐉).
+  - Web is not planned any time soon (contributions are welcome 🤝)
 - [Kotlin coroutines](https://kotlinlang.org/docs/reference/coroutines/coroutines-guide.html)
 - [Ktor client](https://ktor.io/) (+ [Kotlinx serialization](https://kotlinlang.org/docs/serialization.html))
 - [Room](https://developer.android.com/training/data-storage/room) for local persistence
@@ -123,6 +127,9 @@ I do not aim to implement advanced features beyond what is supported by the Goog
   - The Desktop application (thin layer fully reusing `:tasks-app-shared`)
 - [`:tasks-app-android`](tasks-app-android) <span style="color: #66FF00;">■■■■■■■■</span>□□ 80%
   - The Android application (thin layer fully reusing `:tasks-app-shared`)
+- [`:tasks-app-ios/Taskfolio`](tasks-app-ios/Taskfolio) <span style="color: #33FF00;">■■■■■■■■■</span>□ 90%
+  - The iOS application (thin layer fully reusing `:tasks-app-shared`)
+  - Xcode project, written in Swift
 - [`website/`](website) <span style="color: #00FF00;">■■■■■■■■■■</span> 100%
   - The [static site](https://opatry.github.io/taskfolio/) presenting the project
   - Made with [Jekyll](https://jekyllrb.com/) and served by [Github pages](https://pages.github.com/)
@@ -177,6 +184,68 @@ When clicking on it, it will open a new window with the hot reload status.
 ![](assets/compose-hot-reload-console.png)
 </details>
 
+## 🍎 Build for iOS target
+
+The support of iOS works more or less _as-is_ and gets the job done. It's provided without guarantees, use at your own risk.  
+Feedback and contributions are welcome though 🤝.
+
+> [!NOTE]
+> iOS support is _opt-in_ and disabled by default to avoid unnecessary time and disk usage during the initial Gradle sync when the iOS target isn't required.  
+> You can enable it by setting `ios.target` Gradle property to `all`, `simulator` or `device` from either `local.properties` or CLI using `-P`.  
+> When building from Xcode, it automatically sets `-Pios.target=simulator` based on `Config.xcconfig`.
+
+<details>
+<summary>See details…</summary>
+
+You can build the `:tasks-app-shared` code for iOS using Gradle (to check if everything compiles on Kotlin side):
+
+```bash
+./gradlew tasks-app-shared:linkDebugFrameworkIosSimulatorArm64 -Pios.target=simulator
+```
+
+### Building & Running from IntelliJ/Android Studio
+
+You can also use the incubating [Kotlin Multiplatform IntelliJ plugin](https://plugins.jetbrains.com/plugin/14936-kotlin-multiplatform) to build and launch the iOS app directly from IntelliJ/Android Studio (starting from Narwhal | 2025.1.1).  
+This plugin allows you to choose whether to run the app on a device or simulator, and enables debugging of Kotlin code even when called from iOS/Swift.
+
+It builds the Kotlin code as a native framework, then triggers the appropriate Gradle task to build Kotlin first, followed by `xcodebuild` for the Xcode and iOS-specific parts, ensuring a seamless integration between Kotlin and Swift code (see next section for details).
+
+### Building & Running from Xcode
+
+For full XCFramework build (to be consumed by the iOS application), you'll have to rely on `xcodebuild` (or build directly from Xcode):
+
+```bash
+cd tasks-app-ios
+IOS_TARGET=simulator xcodebuild -project Taskfolio.xcodeproj \
+  -scheme Taskfolio \
+  -sdk iphonesimulator \
+  -arch arm64 \
+  -configuration Debug \
+  build \
+  CODE_SIGNING_ALLOWED=NO \
+  CODE_SIGN_IDENTITY="" \
+  CODE_SIGNING_REQUIRED=NO
+```
+This triggers the `:tasks-app-shared:embedAndSignAppleFrameworkForXcode` Gradle task under the hood.
+
+For Xcode integration, it's recommended to install the [Xcode Kotlin plugin](https://touchlab.co/xcodekotlin):
+
+```bash
+brew install xcode-kotlin
+xcode-kotlin install
+```
+
+When you update Xcode, you'll have to sync the plugin:
+
+```bash
+xcode-kotlin sync
+```
+
+If you want to debug the Kotlin code from Xcode, you'll have to add the needed source sets in Xcode:  
+Add Group > Add folders as **reference** > `tasks-app-shared/{commonMain,iosMain}` (or any other module you want to debug).
+If you properly installed the Xcode Kotlin plugin, you'll be able to set a breakpoint in the Kotlin code and see syntax coloring as well.
+</details>
+
 ## ⚖️ License
 
 ```

build.gradle.kts

@@ -22,6 +22,7 @@
 
 import kotlinx.kover.gradle.plugin.dsl.CoverageUnit
 import org.gradle.api.tasks.testing.logging.TestExceptionFormat
+import org.jetbrains.kotlin.gradle.dsl.KotlinMultiplatformExtension
 
 plugins {
     alias(libs.plugins.jetbrains.kotlin.multiplatform) apply false
@@ -135,7 +136,32 @@ kover {
     }
 }
 
+private val kmpPluginId = libs.plugins.jetbrains.kotlin.multiplatform.get().pluginId
 subprojects {
+    plugins.withId(kmpPluginId) {
+        if (project == project(":google:oauth-http")) return@withId
+
+        extensions.configure<KotlinMultiplatformExtension> {
+            // foo-bar-zorg → FooBarZorg
+            val frameworkBaseName = project.name.split('-').joinToString("") { part ->
+                part.replaceFirstChar(Char::uppercase)
+            }
+            iosTargets.mapNotNull {
+                when (it) {
+                    "iosX64" -> iosX64()
+                    "iosArm64" -> iosArm64()
+                    "iosSimulatorArm64" -> iosSimulatorArm64()
+                    else -> null
+                }
+            }.forEach { iosTarget ->
+                iosTarget.binaries.framework {
+                    baseName = frameworkBaseName
+                    isStatic = true
+                }
+            }
+        }
+    }
+
     tasks {
         findByName("test") ?: return@tasks
         named<Test>("test") {
@@ -174,3 +200,12 @@ subprojects {
         }
     }
 }
+
+gradle.projectsEvaluated {
+    val xcFrameworkTask = project(":tasks-app-shared").tasks.findByName("embedAndSignAppleFrameworkForXcode")
+    val updateVersionTask = project(":tasks-app-ios").tasks.findByName("updateXcodeVersionConfig")
+
+    if (xcFrameworkTask != null && updateVersionTask != null) {
+        xcFrameworkTask.dependsOn(updateVersionTask)
+    }
+}

buildSrc/build.gradle.kts

@@ -0,0 +1,13 @@
+plugins {
+  `kotlin-dsl`
+}
+
+repositories {
+  gradlePluginPortal()
+  mavenCentral()
+}
+
+kotlin {
+    jvmToolchain(17)
+}
+