PeopleInSpace/README.md

4.1 KiB

PeopleInSpace

Minimal Kotlin Multiplatform project using Jetpack Compose and SwiftUI. Currently running on

  • Android (Jetpack Compose)
  • iOS (SwiftUI)
  • watchOS (SwiftUI)
  • macOS (SwiftUI)
  • Desktop (Compose for Desktop)
  • Web (Kotlin/JS + React Wrapper)
  • JVM (small Ktor back end service + Main.kt in common module)

It makes use of basic API (http://open-notify.org/Open-Notify-API/People-In-Space/) to show list of people currently in space and also the position of the International Space Station (inspired by https://kousenit.org/2019/12/19/a-few-astronomical-examples-in-kotlin/)! The list is shown on Android using Jetpack Compose, on iOS using SwiftUI and on Web using Kotlin/JS React wrapper.

Related posts:

Note that this repository very much errs on the side of minimalism to help more clearly illustrate key moving parts of a Kotlin Multiplatform project and also to hopefully help someone just starting to explore KMP to get up and running for first time (and is of course primarily focussed on use of Jetpack Compose and SwiftUI). If you're at stage of moving beyond this then I'd definitely recommend checking out KaMPKit

Building

You need to use Android Studio Canary version (note: Java 11 is now the minimum version required). Have tested with XCode v11 and v12. When opening iOS/watchOS/macOS projects remember to open .xcworkspace file (and not .xcodeproj one). To exercise web client run ./gradlew :web:browserDevelopmentRun. To run backend you can either run ./gradlew :backend:run or run Server.kt directly from Android Studio. After doing that you should then for example be able to open http://localhost:9090/astros_local.json in a browser.

UPDATE: now also works in stable version of Android Studio.

Jetpack Compose for Desktop client

This client is available in compose-desktop module. Note that you need to use appropriate version of JVM when running (works for example with Java 11)

Screenshots

Screenshot 2021-02-27 at 12 09 02 Screenshot 2021-03-07 at 17 03 46 Screenshot 2021-03-07 at 17 05 31

Languages, libraries and tools used