UIKit-cross-platform

Your Swift UI Code on Android

UIKit-cross-platform is a UI framework for native apps, which enables code targeting iOS UIKit to run on other platforms, particularly on Android.

Goal

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.

How to run your iOS Project on Android

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

Try out the demo

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 run git submodule update --init --recursive
Open ./samples/getting-started/DemoApp.xcodeproj in Xcode

1. Run DemoApp target for the iOS App 2. Run DemoAppMac target for the Mac App

Open ./samples/getting-started/android with Android Studio (install Android SDKs if necessary)
Connect an Android device and press "Run" for the Android App

Additional setup instructions

Adding UIKit-cross-platform

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

Setup build environment

Install Cmake > 3.16 and Ninja

brew install cmake && brew install ninja

Install Android Studio
Add SDKs in Android Studio

1. Open Preferences in Android Studio 2. Go to Appearance & Behavior -> System Settings -> Android SDK 3. under SDK Platforms: install SDK for API Level 29 4. under SDK Tools, install Android SDK Build Tools 5. under SDK Tools, install NDK 27.1.12297006 (tick Show Package Details to see all available versions) 6. Press Apply / OK to install SDKs 7. create a symlink in /usr/local/ndk/27.1.12297006/ pointing to the path of the NDK (ln -vsi ~/Library/Android/sdk/ndk/27.1.12297006 /usr/local/ndk/27.1.12297006)