A lightweight web server to developer your App Cloud apps against, along with scaffolding to generate your apps.
The App Cloud module provides two key services. The first is that provides a command line interface to allow developers to quickly generate new App Cloud apps. (Scaffolding) Additionally, the command line interface also includes a command to generate code an express web server. The web server provides a central place to organize your apps, create new apps and view / download demos.
- If not already installed, install version 0.8.* of node.js.
- Simply run
sudo npm install -g appcloud. (The -g makes this globally available command.)
To see the options available to you run
appcloud -h, which will print:
Usage: appcloud [options]
The typical flow for getting started is to simply run
appcloud -c, to generate the appcloud packaged web server. (A lightweight express web server). After that do
cd appcloud-server and then run
npm install, to install the necessary packages for the web server. Once that completes run
node app.js, which will start the appcloud web server. When you first start the server it will look like:
You then have the option to either create applications using the command line with
appcloud -n name -v foo,bar or using the UI to create a new application. After creating an app, you can then click the app to be taken a to page that presents you with a QR code for the application. Using the App Cloud Workshop application, can be installed from either the iOS App Store or the Android Marketplace, scan the QR code. The screen with the QR code should look like this:
Any apps that you generate via the package web server will be created a directory called 'my-applications'. This directory lives within the appcloud-server folder that was created by the
appcloud -c command. If you would like to move your applications to a different directory you can to do so and simply create symlink to point to the current
ln -s your_new_source_dir path_to_appcloud-server/my-applications
If you are actively working on the app-cloud-sdk then you may want to create applications and use your local versions. To do this you will need to create a
local.properties file and specify where on system the SDK files. This local.properties file should go inside the
appcloud-server directory. Below is an example local.properties file.