Skip to content

Latest commit

 

History

History
150 lines (128 loc) · 6.13 KB

readme.md

File metadata and controls

150 lines (128 loc) · 6.13 KB
Raw

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:

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

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+