Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dominatorvbn/skiptour

An dual platform app built with Skip.tools
https://github.com/dominatorvbn/skiptour

Last synced: about 1 month ago
JSON representation

An dual platform app built with Skip.tools

Awesome Lists containing this project

README

        

# SkipTour

This is a [Skip](https://skip.tools) dual-platform app project.
It builds a native app for both iOS and Android.

| ![ios1](ios1.png) | ![ios2](ios2.png) | ![ios2](ios2.png) |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| ![android1](android1.png) | ![android2](android2.png) | ![android3](android3.png) |

## Building

This project is both a stand-alone Swift Package Manager module,
as well as an Xcode project that builds and transpiles the project
into a Kotlin Gradle project for Android using the Skip plugin.

Building the module requires that Skip be installed using
[Homebrew](https://brew.sh) with `brew install skiptools/skip/skip`.

This will also install the necessary transpiler prerequisites:
Kotlin, Gradle, and the Android build tools.

Installation prerequsities can be confirmed by running `skip checkup`.

## Testing

The module can be tested using the standard `swift test` command
or by running the test target for the macOS desintation in Xcode,
which will run the Swift tests as well as the transpiled
Kotlin JUnit tests in the Robolectric Android simulation environment.

Parity testing can be performed with `skip test`,
which will output a table of the test results for both platforms.

## Running

Xcode and Android Studio must be downloaded and installed in order to
run the app in the iOS simulator / Android emulator.
An Android emulator must already be running, which can be launched from
Android Stuido's Device Manager.

To run both the Swift and Kotlin apps simultaneously,
launch the SkipTourApp target from Xcode.
A build phases runs the "Launch Android APK" script that
will deploy the transpiled app a running Android emulator or connected device.
Logging output for the iOS app can be viewed in the Xcode console, and in
Android Studio's logcat tab for the transpiled Kotlin app.