Skip to content

Latest commit

 

History

History
161 lines (114 loc) · 3.49 KB

README.md

File metadata and controls

161 lines (114 loc) · 3.49 KB
Raw

Kalliope-app

Build Status

The Ionic app code for Kalliope

Installation

NodeJs

First install nodejs. We suggest to use the node version manager

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash

Make sure you are using at least the node v10.9.0:

nvm install 10
nvm use 10
nvm current
>>> v10.9.0

ionic & Cordova

The application is based on Ionic(and cordova)

npm install -g ionic cordova

cordova --version
>>> 8.0.0
ionic --version
>>> 4.1.1

clone the kalliope-app repo

Clone this repo:

[email protected]:kalliope-project/kalliope-app.git

or by using https:

https://github.com/kalliope-project/kalliope-app.git

Install the node dependencies :

cd /pathOfTheProject/kalliope-app/kalliope/
npm install

Start kalliope Core

Make Sure your Kalliope Core is running :

Under your "Kalliope Core" directory:

The API and CORS must be allowed in the kalliope Core "setting.yml" file. Then starts the Kalliope CORE :

kalliope start

run the application on your browser

Under this fresh cloned repo, access the "kalliope" directory and run the ionic server :

ionic serve -b

The application is now running and accessible using your browser : "http://localhost:8100"

In case the application is missing the 'cordova' package to run on the browser you can run :

ionic cordova run browser

Builds/run for mobile device

Android

Requirement
  • Java 8 SDK (Note: greater version of java are not supported by ionic yet)
sudo apt-get install openjdk-8-jdk

java -version
>>> openjdk version "1.8.0_181"
>>> OpenJDK Runtime Environment (build 1.8.0_181-8u181-b13-0ubuntu0.18.04.1-b13)
>>> OpenJDK 64-Bit Server VM (build 25.181-b13, mixed mode)

javac -version
>>> javac 1.8.0_181
  • Android 8.1 SDK (Oreo)
  • Gradle 4.4
  • Build Tools
  • Android Virtual Device (AVD)

You can install them manually but it is strongly recommended to install Android Studio which brings most of them. "https://developer.android.com/studio/"

Export env variables (add to your .bashrc):

 export ANDROID_HOME=~/Android/Sdk
 export PATH=${PATH}:${ANDROID_HOME}/tools
 export PATH=${PATH}:${ANDROID_HOME}/platform-tools

 export PATH=$PATH:$GRADLE_HOME/bin
Run on your phone
  • Install all the cordova android plugin by setting up an ionic platform:
ionic cordova platform add [email protected]

Note: You might need to define the JAVA_HOME and gradle wrapper version with:

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
export CORDOVA_ANDROID_GRADLE_DISTRIBUTION_URL=https\://services.gradle.org/distributions/gradle-4.4-all.zip

  • Activate the Debugger mode on your Android phone.

  • Run the app on Android device directly

ionic cordova run android

Note: running the app with the option -c does not work !

Debug
  • You have access to log using Android Studio and Logcat.
  • On your AVD console.
  • Running Chrome -> Developper Tools -> Remote Device
Release

Create an APK

ionic cordova build android --release

iOS

  • TODO