SpaceX Wiki is iOS and Android applications built using Kotlin Multiplatform Mobile framework which leverages the SpaceX API
The project and it's artifacts are currently in alpha, so is the KMM framework. There is no guarantee of any part of the code remaining the same as the application proceeds towards stable.
Development of the iOS application is
The iOS app is currently returning 404 for all SpaceX API calls, there is an issue registered for it. I am not an iOS developer, if anyone can fix this issue with a PR I would highly appreciate it.
From the KMM official website
Kotlin Multiplatform Mobile is an SDK for iOS and Android app development. It offers all the combined benefits of creating cross-platform and native apps.
The idea is to create a shared business layer that can then be used by the Android and iOS application in order to build UI on top of it to provide a native UX to the user without having to create two data layer implementations.
KaMPKit has created a good read on what is KMM and why you would want to try it out - WHAT_AND_WHY
As shown above, the shared module is the KMM module where the business logic of the application resides. The compiled artifacts from the shared module are imported into the Android and iOS application respectively.
The androidCore module is the base android module on top of which we will build feature modules that then connect up to the app module in order to build out the features. It also contains the Jetpack Compose components and themes that will be used across the feature modules.
The project structures inside Android Studio and Xcode are as shown below
The project structure is broken up into three different directories:
- shared
- androidApp
- iosApp
The androidApp directory holds the android version of the app, and all the android code.
Similarly the iosApp directory holds the iOS version of the app, which contains an XCode project and a Workspace. We want to use the workspace as it contains the shared library.
Finally the shared directory holds the shared code. The shared directory is actually an android library that is referenced from the app project. This library contains directories for the different platforms as well as directories for testing.
- androidMain
- iosMain
- commonMain
- androidTest
- iosTest
- commonTest
Each of these directories has the same folder structure: the language type, then the package name. i.e. "app/prasan/spacexwiki/"
If you're familiar with Android projects then you know that the apps dependencies are stored in the build.gradle. Since shared is an android library, it also contains its own build.gradle where it stores its own dependencies. If you open "shared/build.gradle.kts" you will see sourceSets corresponding to the directories in the shared project.
Each part of the shared library can declare its own dependencies in these source sets.
Below is some information about some of the libraries used in the project.
Documentation: https://ktor.io/
Ktor is a multiplatform networking library for building asynchronous clients. Again since it is a multiplatform library, it uses code stored in commonMain. Even though all of Ktors code is in commonMain, there are some platform specific dependencies needed in the build.gradle.
Documentation: https://insert-koin.io/
Koin is a lightweight dependency injection framework. It is being used in the koin.kt, KoinAndroid.kt and KoinIos.kt files.
First, clone the repository with the 'clone' command, or just download the zip.
$ git clone [email protected]:prasannajeet/SpaceX_Wiki_KMM_iOS_Android.git
Open the project in Android Studio Chipmunk or higher and the project should compile successfully. You can open an new pull request in case you face any issues that you fix. Once the project is compiled simply run the Android app and you should see it run on your device/emulator.
In order to get it working in iOS, simply change the run configuration in Android Studio to iosApp and run from Android Studio, you must have Xcode 14+ installed and be on a Mac machine to be able to build iOS apps. You also need to have homebrew installed and have the homebrew version of cocoapods & cocoapods-generate installed, the last part is mandatory if you're on an M-chip Mac.
In order to open the iOS project, go to terminal on your Android Studio and type the following commands first
cd iosApp
pod install
Then open the iosApp.xcworkspace file from the finder and build and run the app. Note: iOS App not working
Recommended Read DETAILED_DEV_SETUP.md
- Prasan - Lead Developer: GitHub
As an open source project, pull requests to make this project better are more than welcome, please read the contributing guides first. Then, you can open an new issue marking it as a bug or a feature request if you would like the project owner to consider implementing the change, or if you want to suggest one, open a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.