README.md

UIKit-cross-platform

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

How does it work

UIKit-cross-platform renders with SDL_gpu which uses OpenGL(ES). On Android Swift Package Manager compiles Swift Code into native binaries, which are called through the NDK.

More detailed information about the architecture can be found here

Try out the demo

This project includes a DemoApp which runs on iOS, Android and Mac.

How to run it on different platforms:

1. Clone this project, cd into it and run git submodule update --init --recursive
2. Open ./samples/getting-started/DemoApp.xcodeproj in Xcode
   1. Run DemoApp target for the iOS App
   2. Run DemoAppMac target for the Mac App
3. Open ./samples/getting-started/android with Android Studio (install Android SDKs if necessary)
4. Connect an Android device and press "Run" for the Android App

How to run your iOS Project on Android

1. Create new iOS Project or open an existing one
2. Prepare your iOS Project
3. Add UIKit-cross-platform to your project
4. Run ./UIKit/create-android-project from the root of your iOS project
5. Open ./android folder in Android Studio and press "run" button

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 [email protected]:flowkey/UIKit-cross-platform.git UIKit && git submodule update --init --recursive UIKit

Android Studio Setup

1. Install Android Studio
2. Add SDKs in Android Studio
   1. Open Preferences in Android Studio
   2. Go to Appearance & Behavior -> System Settings -> Android SDK
   3. In SDK Platforms: apply checkboxes for API Levels 26 and 27
   4. In SDK Tools: apply checkboxes for CMake, NDK, LLDB, Android SDK Build Tools, Android SDK Platform Tools
   5. Press Apply / OK to install SDKs

API documentation

This framework uses the Apple UIKit API, therefore the official Apple Docs serve as documentation for the already implemented features.

How to contribute

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.

FAQs / Troubleshooting

Our FAQs can be found here (Work In Progress).

Please contact us regarding upcoming issues on Slack or create a new Issue.

License

UIKit-cross-platform is free software; you can redistribute it and/or modify it under the terms of the MIT License.