aq-mobile-be

This repository contains an Ionic app for exploring air quality data using elements from the Helgoland viewer. Helgoland is a lightweight web application for exploring Sensor Web Data from the 52°North SWE-suite.

Getting started:

git clone https://github.com/irceline/aq-mobile-be.git

cd aq-mobile-be
npm install
npm start

A local webserver should be launched on port 4200:

• http://localhost:4200/

Create Dev environment on OSX

Install gradle via e.g. brew (cf https://brew.sh/index)

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install gradle

For iOS install XCode.

For Android install Android Studio (https://developer.android.com/studio)

Accept SDK licenses:

cd ~/Library/Android/sdk/tools/bin/
./sdkmanager --licenses

Push-Notifications

Configuration

• create project on firebase
• choose add firebase to my android-app
  • use be.irceline.aqmobile for Android-Packagename (currently - configurable in config.xml)
  • add the google-services.json which you get to root-folder of this project
  • build the app to test it on your device with ionic cordova build android (check ionic deploying for additional help)

Send notification

• POST to https://fcm.googleapis.com/fcm/send
• Set the following header (authorization key can be find in the settings (Cloud Messaging-tab) of the firebase project):
  • Content-Type: application/json
  • Authorization: key=AAAAinFTu0Axxxxxxxxxxxxxxxxxxxxxxxxx
• body:

{
"notification": {
  "title": "Flanders Title",
  "body": "Flanders Body",
  "sound": "default",
  "subtitle": "NotificationSubtitle"
},
"data": {
  "topic": "flanders",
  "title": "Flanders Title",
  "body": "Flanders Body",
  "expiration": "2019-04-24T17:00:00+02:00"
},
"to":"/topics/flanders",
"priority": "high",
}
//sound: optional field if you want sound with the notification
//data: put any "param":"value" and retreive them in the JavaScript notification callback (needs also the topic, title and body to use these informations internally)
//to: device token or /topic/topicExample
//priority: must be set to "high" for delivering notifications on closed iOS apps

• full documentation: https://firebase.google.com/docs/cloud-messaging/http-server-ref

Build prerequisites

On CentOS:

yum update -y
yum install epel-release
yum install nodejs git
node --version

Add the other prerequisites:

npm install -g ionic cordova
ionic cordova plugin add cordova-plugin-fcm

Clone the repo:

yum install git
git clone https://github.com/irceline/aq-mobile-be.git
cd aq-mobile-be

Do a build for Android:

ionic cordova build android

Build quirks

• conflict between the plugins cordova-plugin-mauron85-background-geolocation and cordova-plugin-fcm

  • In platforms/android/cordova-plugin-fcm/*-FCMPlugin.gradle
    • remove line classpath 'com.google.gms:google-services:3.0.0'
    • remove line apply plugin: com.google.gms.googleservices.GoogleServicesPlugin
    • add at the end apply plugin: 'com.google.gms.google-services'
  • Add in build.gradle the following line classpath 'com.google.gms:google-services:3.2.1' at buildscript.dependencies (ca. line 36)
  • Build with ionic cordova build android and you will get a version error response.
  • Change platforms/android/project.properties with your version from above output, version must be the same:

    com.google.firebase:firebase-core:xx.xx.xx
    com.google.firebase:firebase-messaging:xx.xx.xx
    com.google.android.gms:play-services-location:xx.xx.xx
    

  • Build again with ionic cordova build android
  • If you get the following error:

    Could not find support-v4.jar (com.android.support:support-v4:26.1.0).
    Searched in the following locations: https://jcenter.bintray.com/com/android/support/support-v4/26.1.0/support-v4-26.1.0.jar
    

    Move jcenter() after maven() in build.gradle as described here, should look like this:

    allprojects {
      repositories {
        maven {
          url "https://maven.google.com"
        }
        jcenter()
      }
    }
    

• on OSX you will Android Studio and:

  • cd ~/Library/Android/sdk/tools/bin/
  • run ./sdkmanager --licenses and accept all do above

• If you get the following error: Execution failed for task ':app:processDebugGoogleServices'. > Please fix the version conflict either by updating the version of the google-services plugin (information about the latest version is available at https://bintray.com/android/android-tools/com.google.gms.google-services/) or updating the version of com.google.android.gms to 10.+.

  • adjust in platforms/android/project.properties -> com.google.android.gms:play-services-location:15.+ to com.google.android.gms:play-services-location:10.+
  • adjust in plugins/cordova-plugin-request-location-accuracy/plugin.xml -> com.google.android.gms:play-services-location:15.+ to com.google.android.gms:play-services-location:10.+

• If you get the following build error: The library com.google.android.gms:play-services-measurement-base is being requested by various other libraries at [[16.5.0,16.5.0], [16.4.0,16.4.0]], but resolves to 16.5.0. Disable the plugin and check your dependencies tree using ./gradlew :app:dependencies., pin the following versions in platforms/android/project.properties:

cordova.system.library.6=com.google.firebase:firebase-core:16.0.8+
cordova.system.library.7=com.google.firebase:firebase-messaging:17.5.0+
cordova.system.library.8=com.google.firebase:firebase-config:16.4.1+
cordova.system.library.9=com.google.firebase:firebase-perf:16.2.4+