Please Note: You have to download the Tabris SDK in order to complete this tutorial.

Running a Mobile Client

All Tabris applications are accessible using an URL. For this reason a client (iOS, Android or Browser) needs to know this URL to be able to display the UI. Make sure your server side application is running. Your application will look like this on the client after connecting.

Hello World

After downloading the Tabris SDK you will have the option to connect an iOS and an Android client.

Connecting an Android Client

  1. Opening the SDK you will find a folder named android which contains a tabris-*.apk file. This app is a generic launcher for Tabris applications.

    SDK Android

  2. Deploying the .apk can be done by sending the .apk via email to yourself or using the Android Debug Bridge (adb). Using adb you simply need to execute adb install tabris-*.apk (please use the full name of the apk).
  3. Firing up the app you will see a screen that asks for a URL. Here you can enter the URL of a Tabris Application e.g. the URL from the tabris-application maven archetype will be: http://<YOUR_SERVER>:<PORT>/app-0.0.1-SNAPSHOT/app.

    Android Launch

Connecting an iOS Client

The Tabris iOS client will be delivered as a .framework component to enable you to install it on any device you want using your Apple Developer Account. As you might know it’s not as easy as it is with Android to distribute pre-build .ipa files. Anyway, to follow the tutorial you’ll need a Mac running Xcode.

Please note: If you don’t have a Mac we recommend using http://www.macincloud.com/. If this is an option for you, you would want to take a look at our MacinCloud guide.

  1. Opening the SDK you will find a folder named ios which contains a tabris-*.dmg file. This disk image contains an installer that does install two things: a) The tabris framework into /Users/shared/Tabris b) An Xcode template to create Tabris apps.

    SDK iOS

  2. After you have successfully executed the installer you should fire up Xcode. To create a New Project in Xcode, select File > New > Project.. In the wizard choose the template iOS > Application > Tabris-based Application. On the next page you will need to provide a Product Name (e.g. MyBusinessApp) and a Company Identifier (e.g. com.my-company). On the last page select where you would like to store the project, and you’re ready for the next step.

    SDK iOS new project

  3. To get the App connected with the server, you need to provide the URL of the app e.g. the URL from the tabris-application maven archetype will be: http://<YOUR_SERVER>:<PORT>/app-0.0.1-SNAPSHOT/app. All you need to do is change the returned URL of the serverURL method in the AppDelegate.m class.

    SDK iOS Xcode configure

  4. Run the app on a simulator or device of your choice. Please be aware that running an app on a device requires an Apple developer account which has access to the iOS Developer Program.

    SDK iOS Xcode run