Skip to content

eclipsesource/tabris-plugin-firebase

Repository files navigation

Tabris.js Firebase Plugin

The tabris-plugin-firebase plugin provides a Tabris.js API to interact with various firebase features. The plugin supports firebase cloud messaging and firebase analytics with support for more features underway.

Overview

Integrating the plugin

The Tabris.js website provides detailed information on how to integrate custom plugins in your Tabris.js app.

Add the plugin to your project

The plugin should be added as an entry in the apps config.xml file:

<!-- Not yet on npm -->
<plugin name="tabris-plugin-firebase" spec="3.x" />

To fetch the latest development version use the GitHub url:

<plugin name="tabris-plugin-firebase" spec="https://github.com/eclipsesource/tabris-plugin-firebase.git" />

Provide the firebase credentials

To enable firebase support in your app, we have to provide the credential files for Android and iOS. The files can be obtained from the firebase console.

Android

For Android we have to include the google-services.json file. To make it available to the tabris-plugins-firebase you have to place it in the same folder as your apps config.xml file. If the file is missing the plugin will print an appropriate error message.

iOS

For iOS we have to include the GoogleService-Info.plist file. To make it available to the tabris-plugins-firebase you have to place it in the same folder as your apps config.xml file.

In addition you have to include GoogleService-Info.plist file as a resource-file in the config.xml:

<platform name="ios">
  <resource-file src="GoogleService-Info.plist" />
</platform>

Documentation

The Tabris.js firebase plugin supports the following features:

Feature Supported platforms
Firebase Cloud Messaging Android, iOS
Firebase Analytics Android, iOS

Compatibility

Compatible with Tabris.js 3.2.

Plugin development

While not required by the consumer of the plugin, this repository provides Android specific development artifacts. These artifacts allow to more easily consume the native source code when developing the native parts of the plugin.

Android

The project provides a gradle based build configuration, which also allows to import the project into Android Studio.

In order to reference the Tabris.js specific APIs, the environment variable TABRIS_ANDROID_PLATFORM has to point to the Tabris.js Android Cordova platform root directory.

export TABRIS_ANDROID_PLATFORM=/home/user/tabris-android

The environment variable is consumed in the gradle projects build.gradle file.

Copyright

Published under the terms of the BSD 3-Clause License.