UIKit-cross-platform is a UI framework for native apps, which enables code targeting iOS UIKit to run on other platforms, particularly on Android.
Currently in mobile development apps have to be written twice, for iOS and Android, or native performance has to be sacrificed with a cross-platform solution such as React Native.
This framework aims to combine both advantages, having native performance and writing code only once but still keeping a native look & feel.
- Create new iOS Project or open an existing one
- Prepare your iOS Project
- Add UIKit-cross-platform to your project
- Run
./UIKit/create-android-project
from the root of your iOS project - Open
./android
folder in Android Studio (install Android SDKs if necessary) and press "run" button
This project includes a DemoApp which runs on iOS, Android and Mac.
How to run it on different platforms:
- Clone this project,
cd
into it and rungit submodule update --init --recursive
- Open
./samples/getting-started/DemoApp.xcodeproj
in Xcode- Run
DemoApp
target for the iOS App - Run
DemoAppMac
target for the Mac App
- Run
- Open
./samples/getting-started/android
with Android Studio (install Android SDKs if necessary) - Connect an Android device and press "Run" for the Android App
UIKit-cross-platform
has to be added as a dependency to your project including its subdependencies.
The recommended way is to use git submodules
to add it to an UIKit
subdirectory.
In order to do so use the following command:
git submodule add git@github.com:flowkey/UIKit-cross-platform.git UIKit && git submodule update --init --recursive UIKit
- Install Cmake > 3.16 and Ninja
brew install cmake && brew install ninja
- Install Android Studio
- Add SDKs in Android Studio
- Open Preferences in Android Studio
- Go to Appearance & Behavior -> System Settings -> Android SDK
- under SDK Platforms: install SDK for API Level 29
- under SDK Tools, install
Android SDK Build Tools
- under SDK Tools, install NDK 21.4.7075529 (tick
Show Package Details
to see all available versions) - Press Apply / OK to install SDKs
- create a symlink in
/usr/local/ndk/21.4.7075529/
pointing to the path of the NDK (ln -vsi ~/Library/Android/sdk/ndk/21.4.7075529 /usr/local/ndk/21.4.7075529
)
UIKit-cross-platform renders with SDL_gpu which translates down to lower-level OpenGL instructions.
On Android, CMake compiles Swift Code into native binaries via Ninja, which are called through the NDK.
More detailed information about the architecture can be found here
This framework uses the Apple UIKit API, therefore the official Apple Docs serve as documentation for the already implemented features.
Contributions are very welcome and helpful 🙌
If you are looking for a feature or find a bug, please create an Issue.
For additional information please refer to our contribution guidelines.
UIKit-cross-platform is free software; you can redistribute it and/or modify it under the terms of the MIT License.