Getting Started: Developers

WepSIM for Apache Cordova

1) Prepare the Apache Cordova Project:

• 1.1) Follow Apache Cordova tutorial in order to create a new project:

  npm install -g cordova
  cordova create wepsim es.uc3m.inf.arcos.wepsim WepSIM
  cd wepsim
  cordova platform add android
  cordova platform add ios
  

• 1.2) Install at least the following plugins:

  cordova plugin add cordova-plugin-console
  cordova plugin add cordova-plugin-device
  cordova plugin add cordova-plugin-dialogs
  cordova plugin add cordova-plugin-file
  cordova plugin add https://github.com/apache/cordova-plugin-file-transfer.git
  cordova plugin add cordova-plugin-splashscreen
  cordova plugin add cordova-plugin-web-share
  

2) Update WepSIM files:

• 2.1) Copy WepSIM files into the www directory:

  wget https://github.com/wepsim/wepsim/archive/refs/heads/master.zip
  unzip master.zip
  

• 2.2) Build www for the Apache Cordova project:

  ./wepsim-master/devel/mk_cordova.sh
  

• 2.3) [Android Only] Add to file "platforms/android/app/src/main/java/es/uc3m/inf/arcos/wepsim/MainActivity.java" the code:

   ...
   import android.webkit.WebView;
   import android.webkit.WebSettings;
   import android.webkit.WebSettings.ZoomDensity;
   ...
   WebView webView = (WebView) appView.getEngine().getView();
   WebSettings settings = webView.getSettings();
   settings.setUseWideViewPort(true);
   settings.setSupportZoom(true);
   settings.setBuiltInZoomControls(true);
   settings.setDisplayZoomControls(false);
   ...
  

3) Build Android .apk:

• 3.1) Build .apk:

  cordova build android --debug
  

• 3.2) Run WepSIM's App...

• ... on Emulator:

  cordova run android
  

• ... on Device:

  adb -d install -r ./platforms/android/app/build/outputs/apk/debug/app-debug.apk