Navigation Menu

Skip to content

Instantly share code, notes, and snippets.

@don
Created October 4, 2017 03:57
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/b67bec9a8b61a80953466ebf299dfd70 to your computer and use it in GitHub Desktop.
Save don/b67bec9a8b61a80953466ebf299dfd70 to your computer and use it in GitHub Desktop.
Software Install instructions for the PhoneGap Day NY 2017 - Hands on Bluetooth LE Workshop

Hands-on Bluetooth Low Energy

PhoneGap Day NY - October 12th, 2017

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 and git.

Prerequisites

  • Node.js - use Node.js LTS v 6.11.x
  • git - PhoneGap uses git to install assets.

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 7.0.1.

$ phonegap -v
7.0.1

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 Visual Studio Code, but you can use another editor if you have a favorite.

  • Download Visual Studio Code, from https://code.visualstudio.com.
  • 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

PhoneGap Developer App

iPhone, 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 Explorer.

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

Older Phones

Note that older devices Android may not support Bluetooth Low Energy. If your phone doesn't work, please request a loaner device for the workshop.

Problems?

If you run into any problems with the software installation, please email me 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