Skip to content

ahmedre/prayertimes-kmp

Repository files navigation

Kotlin Multiplatform

   ___                       _______                 ___           
  / _ \_______ ___ _____ ___/_  __(_)_ _  ___ ___   / _ | ___  ___ 
 / ___/ __/ _ `/ // / -_) __// / / /  ' \/ -_|_-<  / __ |/ _ \/ _ \
/_/  /_/  \_,_/\_, /\__/_/  /_/ /_/_/_/_/\__/___/ /_/ |_/ .__/ .__/
              /___/                                    /_/  /_/ 

This is a sample PrayerTimes App with shared business logic, initially written for a talk given for GDG MENA Digital Days on August 31st, 2021. The slide deck (10 slides, short since the talk was mostly live-coding) can be downloaded from here.

It uses the kotlin_multiplatform branch of adhan for shared PrayerTime calculation logic.

It was later modified to support more platforms as part of a talk, given in Arabic, at Droidcon Egypt in 2022. I am hoping to re-do this in English in the near future, at which point I'll update the links here as well.

Features

  • shared business logic between all platforms
  • shared rendering layer for Compose between Android, JVM Desktop, and iOS

Specific Implementations

  • Android (using Jetpack)
  • iOS (using SwiftUI)
  • iOS (using Compose)
  • desktop JVM (using Compose)
  • web (using Compose)
  • macOS
  • watchOS
  • implementation for command line (macOS, Linux, and Windows (untested)).

Setup

  1. Obtain a Google API key (see here for details).
  2. Update shared/src/commonMain/kotlin/app/salah/Secrets.kt with your key.

On Android, open in Android Studio (Arctic Fox or above). On iOS, open the xcworkspace file in Xcode.

Running

  • for web-compose: ./gradlew jsBrowserRun
  • for desktop-compose (jvm): ./gradlew :desktop:run
  • for Apple (iOS, macOS, watchOS) - in Xcode, choose the target and then run

Command Line App

macOS (arm64)

# Build the application
./gradlew macosArm64Binaries

# Run it
./shared/build/bin/macosArm64/releaseExecutable/shared.kexe "Dubai"

Linux

For Linux, you need the Curl library's development headers. On Ubuntu, for example, you can run apt install libcurl4-openssl-dev (note that you need a modern version of Curl, example 7.85.0-1).

# Build the application
./gradlew nonNativeAppleBinaries

# Run it
./shared/build/bin/nonAppleNative/releaseExecutable/shared.kexe "Dubai"

About

Simple Kotlin Multiplatform PrayerTimes App for iOS and Android

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published