Skip to content

Instantly share code, notes, and snippets.

@don
Last active January 21, 2016 04:09
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save don/2779085b971bfc5bf9ec to your computer and use it in GitHub Desktop.
Save don/2779085b971bfc5bf9ec to your computer and use it in GitHub Desktop.
Software Install instructions for the PhoneGap Day 2016 - Hands on Bluetooth LE Workshop

Hands-on Bluetooth Low Energy

PhoneGap Day - January 28th, 2016

Software Installation

In order to get the most of the class, we're asking everyone to install the software before the workshop.

It's important that you follow this guide and have you computer setup before you arrive. We want to spend time learning about Bluetooth not installing software.

PhoneGap

We are using PhoneGap to write mobile apps for iOS and Android. PhoneGap requires Node.js.

Use npm (which is included with Node.js) to install PhoneGap.

Mac

Mac users, open Terminal.app and run

sudo npm install -g phonegap

Mac users might be prompted to install the XCode or the command line developer tools. It's OK to install these, but it's faster if you choose Not Now.

Windows

Windows users, open cmd.exe and run

npm install -g phonegap

Linux

Linux users, open terminal and run

npm install -g phonegap

Verify

Verify that PhoneGap installed correctly. Run phonegap -v and ensure that it prints out the version number. You're OK as long as your version number is greater than 5.4.0.

$ phonegap -v
5.4.0

Firewall

The phonegap serve command opens a socket on port 3000. If your laptop has a fire wall, ensure that port 3000 is open. This is especially important if you have a Windows laptop that's locked down by you IT department.

Text editor

You're going to need a text editor. I recommend installing Atom, but you can use another editor if you have a favorite.

  • Download Atom.io from https://atom.io/.
  • Mac users should drag Atom.app to /Applications.
  • Windows users should run the installer.
  • Linux users should install the deb or rpm

jshint

jshint is a tool we will use to find errors in JavaScript code.

Install jshint with npm.

npm install -g jshint

Mac and Linux users may need to use sudo

sudo npm install -g jshint

If you installed the Atom editor, you should install the atom-jshint plugin.

apm install atom-jshint

PhoneGap Developer App

Phone, iPod and iPads users should install the PhoneGap Developer App from the App Store.

Android users should install PhoneGap Developer App from Google Play.

Optional Mobile Apps

iPhone, iPod and iPads may optionally install the SensorTag and LightBlue.

Android users may optionally install SensorTag and nRF Master Control Panel.

Older Phones

Note that older devices and operating systems may not support Bluetooth Low Energy. If your phone doesn't work, please [request a loaner device](mailto:don@chariotsolutions.com?subject=Loaner Device&body=I'd like to borrow a phone for the PhoneGap Day Bluetooth LE Workshop.) for the workshop by emailing don@chariotsolutions.com.

Problems?

If you run into any problems with the software installation, please [email me](mailto:don@chariotsolutions.com?subject=PhoneGap Day Software Install Help) and I'll work with you to get it fixed before the class.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment