Sample application for various “Cross-Platform HTML5 – in Action!” workshops
- Download and install the platform SDKs and/or emulators for the platform you want to develop for (this might take quite a while… so do this first!)
- Download and install node.js
- Make sure you have the git command line tools installed
- Install and install ImageMagick (base toolkit for image processing, here used for splash screen and icon generation)
- Install Cordova:
npm install -g cordova
- Install gulp:
npm install -g gulp
- MacOSX and Linux users need to install Wine (for executing the Electron Windows build task)
- Download and install Atom or another editor of your choice (free:
notepad, Visual Studio Code; commercial: Sublime Text, WebStorm)
The gulp tasks will build iOS, Windows UWP, Android apps as well as desktop applications for Mac OSX, Windows and Linux. To get it working, please do the following:
- After cloning the repo:
npm i --no-progresswithin the root folder of this repository
gulp watch-webto start a live server, which is best when developing the app
gulp watch-cordova-iosto orchestrate the cordova ios app with live reloading. When this task runs, go to
cordova run iosto open a simulator which will live reload.
gulp watch-electronto start a live reloading electron app
gulpto build the web app
- Release Mode: Use the following gulp tasks to build the apps in release mode
gulp build-allto build all apps in debug mode
gulp build-webto build the web app
gulp build-cordovato build all phone related apps
gulp build-electronto build all desktop related apps
gulp watch-web as mentioned above to start the browser version of BoardZ.
To run the cordova project, open a terminal and point it to
dist/mobile. Use one of the following commands to start:
cordova run ios: Runs the iOS version of BoardZ. Requires a Mac
cordova run android: Runs the Android version of BoardZ. Requires Android SDK to be installed and at least a simulator
If a device is connected, the
run command will automatically deploy the App to your device, so you can start it directly on your device.
To start the electron packaged app, go to
dist/desktop/build and open one of the directories suiting your current operating system. Then open the executable as used to.
- Any modern web browser (Chrome, Firefox, Edge, Safari) by simply hosting it
- Mobile platforms (iOS, Android, Windows) by packaging the app using Cordova
- Desktop platforms (Windows, Mac OS X, Linux) by packaging the app using Electron
android-minSdkVersion: An integer designating the minimum API Level required for the application to run.
android-targetSdkVersion: An integer designating the API Level that the application targets. If not set, the default value equals that given to minSdkVersion.
- Bootstrap, responsive layout framework
- AdminLTE, free responsive dashboard template
- FastClick, eliminates the infamous 300 ms lag on touch devices
- HammerJS, for touch interactions
- FontAwesome Images powered by font awesome
- pNotify UI notification library
- Cordova for mobile apps
- Electron for desktop applications