Skip to content

Latest commit

 

History

History
58 lines (47 loc) · 4.09 KB

README.md

File metadata and controls

58 lines (47 loc) · 4.09 KB
Raw

DEPRECATED

With the release of tabris-maps 2.0.0 the examples have been integrated into the tabris-maps project.

https://github.com/eclipsesource/tabris-maps/tree/master/example

tabris-maps-example

This is an example Tabris.js project that demonstrates how to use features of the tabris-maps custom widget. It consist of a native app for iOS and Android mobile devices. The app provides a completely native user interface centered around the native map support available on both platforms. The app itself is written in Java Script.

Running the example

The easiest way to run tabris-maps-example as a native app on you mobile device is the build service provided on tabrisjs.com.

Visit our documentation to learn more about Building a Tabris.js App.

Using the online build service

  1. Fork the repository of tabris-maps-example (alternatively you can create your own project using the tabris-maps plugin).
  2. Create a Tabris.js app on https://tabrisjs.com/[YOUR_USER]/apps/ with your GitHub fork (or own GitHub project).
  3. Add an environment variable ANDROID_API_KEY with your Google Maps API key as a value on the settings tab of your app. ATTENTION: iOS does not require any API keys to work.
  4. On Android select the signing key for the app whose fingerprint was registered on the Google Developers Console. On iOS just choose the signing key that fits your device and app.
  5. Trigger a build.

ATTENTION: If you build your app in debug mode ("debug" toggle button switched to "on" in the "Settings" tab of you build on https://tabrisjs.com) the Tabris.js build service generates a new internal debug key for each build to sign your app. To find the SHA1 of that key, install the app produced by the debug build on an Android device, connect with adb to your device and look for the following output:

I/b       (16793): Sending API token request.
D/map.holder(16793): map is ready
E/b       (16793): Authentication failed on the server.
E/Google Maps Android API(16793): Authorization failure.  Please see https://developers.google.com/maps/documentation/android/start for how to correctly set up the map.
E/Google Maps Android API(16793): In the Google Developer Console (https://console.developers.google.com)
E/Google Maps Android API(16793): Ensure that the "Google Maps Android API v2"is enabled.
E/Google Maps Android API(16793): Ensure that the following Android Key exists:
E/Google Maps Android API(16793):   API Key: XXX-YOUR-API-KEY-HERE-XXX
E/Google Maps Android API(16793):   Android Application (<cert_fingerprint>;<package_name>): YYY-SHA1-HERE-YYY;com.eclipsesource.tabris.maps.example

Then use the SHA1 from that output (marked with YYY-SHA1-HERE-YYY above) with your maps API key in the Google developer console. Update the API key you use in the debug build. Do not generate a new one. Be aware, that the build service will generate a new debug key for every build in debug mode and that propagation of the newly associated SHA1 takes some minutes.

Build locally for Android

  1. Clone the repository.
  2. Make sure your Android debug certificate's fingerprint is registered with the API key you will use for Google Maps on Google Developers Console/API & auth/Credentials (https://console.developers.google.com/project/[YOUR_PROJECT_NAME]/apiui/credential)
  3. Download the latest Android Cordova platform from https://tabrisjs.com/download
  4. Execute the following:
export ANDROID_API_KEY=[YOUR_GOOGLE_MAPS_API_KEY]
cordova platform add [LOCATION_TO_THE_CORDOVA_PLATFORM]
cordova run

Build locally for iOS

  1. Clone the repository.
  2. Download latest iOS Cordova platform from https://tabrisjs.com/download and add it to your project (cordova platform add [LOCATION_TO_THE_CORDOVA_PLATFORM])
  3. Execute cordova run

Screenshots

Center the map Map markers