Moved libraries to new repository 'evothings-libraries', updated build script to fetch library files from this repo.

Author: Mikael Kindborg

README.md

@@ -1,17 +1,42 @@
 # Examples for Evothings Studio
 
-Apps in folder 'generated/examples' are included in the [Evothings Studio download](http://evothings.com/dowload).
+## Example app bundled with Evothings Studio
 
-Apps in folder 'generated/experiments' are under development and are not guaranteed to work.
+Apps in folder [generated/examples](https://github.com/evothings/evothings-examples/tree/master/generated/examples) are included in the [Evothings Studio download](http://evothings.com/dowload).
+
+## Folder structure
+
+Apps in folder [generated/experiments](https://github.com/evothings/evothings-examples/tree/master/generated/experiments) are under development and are not guaranteed to work. These are not bundled with Evothings Studio.
 
 Example app source files are in folders 'examples' and 'experiments'. Note that these cannot be run as is. If you wish to run the examples in Evothings Viewer or build a stand-alone Cordova app, use the code in folder 'generated'.
 
-JavaScript libraries and CSS files shared across apps are in folder 'resources'.
+To add an app to Evothings Workbench that is not included with the download, drag and drop the index.html file of the app you wish to add into the Workbench window.
+
+CSS files and other files shared across apps are in folder 'resources'.
+
+## Library files
+
+Library files used by the example apps are found in repository [evothings-libraries](https://github.com/evothings/evothings-libraries).
+
+## Build script
 
-The Ruby script 'build.rb' copies relevant files from 'resources' to 'generated'.
+If you wish to build the files in the 'generated' folder yourself, use the Ruby script 'build.rb'. This script copies files from folders 'examples', 'experiments' and 'resources' to the target folder 'generated'. Library files from 'evothings-libraries' are also copied to 'generated'.
+
+Note that the 'evothings-libraries' repo must be in a sibling folder to this repo for the build script to work. Like this:
+
+    parent-folder
+        evothings-libraries
+        evothings-examples
+            build.rb (run using command 'ruby build.rb')
 
 <!-- To remove files copied by 'build.rb', run 'git clean -fdX'. -->
 
+## Documentation
+
+[Documentation for example apps](https://evothings.com/doc/examples/examples.html) is available at the [Evothings documentation web site](https://evothings.com/doc/).
+
+## It is quick and fun to get started with Evothings Studio
+
 Download Evothings Studio at: [http://evothings.com](http://evothings.com)
 
 It is fast and fun to get started!

build.rb

@@ -8,6 +8,34 @@
 
 include FileUtils::Verbose
 
+### Path to libraries ###
+
+# Libraries are in repository evothings-libraries. This repo
+# has to be cloned to a sibling folder to evothings-examples.
+
+# Get the path to library files.
+def libraryPath(sourcePath)
+	'../evothings-libraries/' + sourcePath
+end
+
+### Paths to generated examples ###
+
+# Destination path for generated files.
+def fullDestPath(destPath)
+	'generated/' + destPath
+end
+
+# Build generated examples.
+def buildGenerated
+	copyDir(
+		'examples',
+		'generated')
+	copyDir(
+		'experiments',
+		'generated')
+	buildExamples
+end
+
 ###### Examples ######
 
 def buildMbedGAP
@@ -340,80 +368,77 @@ def writeSettingsFile(destPath, imageFile)
 
 def copyUI(destPath)
 	copyDir('resources/ui', fullDestPath(destPath))
-	copyDir('resources/libs/evothings/ui', fullDestPath(destPath) + '/libs/evothings')
+	copyDir(libraryPath('libs/evothings/ui'), fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyJQuery(destPath)
-	copyDir('resources/libs/jquery', fullDestPath(destPath) + '/libs')
+	copyDir(libraryPath('libs/jquery'), fullDestPath(destPath) + '/libs')
 end
 
 def copyEvothings(destPath)
 	copyDir(
-		'resources/libs/evothings/evothings.js',
-		fullDestPath(destPath) + '/libs/evothings')
-	copyDir(
-		'resources/libs/evothings/version-1.2.0',
+		libraryPath('libs/evothings/evothings.js'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyEasyBLE(destPath)
 	copyUtil(destPath)
 	copyDir(
-		'resources/libs/evothings/easyble',
+		libraryPath('libs/evothings/easyble'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyArduinoBLE(destPath)
 	copyEasyBLE(destPath)
 	copyDir(
-		'resources/libs/evothings/arduinoble',
+		libraryPath('libs/evothings/arduinoble'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyArduinoTCP(destPath)
 	copyDir(
-		'resources/libs/evothings/arduinotcp',
+		libraryPath('libs/evothings/arduinotcp'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyNordic_nRF51822_BLE(destPath)
 	copyEasyBLE(destPath)
 	copyDir(
-		'resources/libs/evothings/nordic-nRF51822-ble',
+		libraryPath('libs/evothings/nordic-nRF51822-ble'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyNordic_nRF51_BLE(destPath)
 	copyEasyBLE(destPath)
 	copyDir(
-		'resources/libs/evothings/nordic-nRF51-ble',
+		libraryPath('libs/evothings/nordic-nRF51-ble'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyRFduinoBLE(destPath)
 	copyEasyBLE(destPath)
 	copyDir(
-		'resources/libs/evothings/rfduinoble',
+		libraryPath('libs/evothings/rfduinoble'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyTISensorTag(destPath)
 	copyEasyBLE(destPath)
 	copyDir(
-		'resources/libs/evothings/tisensortag',
+		libraryPath('libs/evothings/tisensortag'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyEddystone(destPath)
 	copyEasyBLE(destPath)
 	copyDir(
-		'resources/libs/evothings/eddystone',
+		libraryPath('libs/evothings/eddystone'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
 def copyUtil(destPath)
 	copyDir(
-		'resources/libs/evothings/util',
+		libraryPath('libs/evothings/util'),
 		fullDestPath(destPath) + '/libs/evothings')
 end
 
@@ -427,13 +452,13 @@ def copyWhereIsTheArduinoCode(destPath)
 
 def copyArduinoEthernet(destPath)
 	copyDir(
-		'resources/arduino/arduinoethernet',
+		libraryPath('arduino/arduinoethernet'),
 		fullDestPath(destPath) + '/arduinoethernet')
 end
 
 def copyArduinoWiFi(destPath)
 	copyDir(
-		'resources/arduino/arduinowifi',
+		libraryPath('arduino/arduinowifi'),
 		fullDestPath(destPath) + '/arduinowifi')
 end
 
@@ -494,21 +519,6 @@ def buildExamples
 	# TODO: buildTemplateEddystoneApp
 end
 
-
-### Destination path for generated files ###
-
-def fullDestPath(destPath)
-	'generated/' + destPath
-end
-
-def buildGenerated
-	copyDir(
-		'examples',
-		'generated')
-	copyDir(
-		'experiments',
-		'generated')
-	buildExamples
-end
+# Build the examples.
 
 buildGenerated