The Newbound software is, at its core, a dynamically compiling app container comprised of four core apps: App Manager, MetaBot, Peer Bot and Security Bot. Together these four apps provide the core functionality that powers all Newbound protocol apps.
The MetaBot makes snapping-together your own apps Toaster SImple™, but you can also build and deploy your own apps just by putting the right files in the right places in the file system.
Each app in the Newbound Network is a subclass of the com.newbound.robot.BotBase class, which requires at a minimum that your app provide a unique service id and the name of your index file. You can override the "handleCommand" function to implement the commands in your app's API. At startup, the BotBase class will look for the subdirectory of "Newbound/runtime" named for its service id, and load its runtime properties from a file in that folder called "botd.properties".
Example App: "My App"
App Name: My App
Service ID: myapp001
Index File: index.html
Java File: com.mycompany.MyApp001.java (subclass of com.newbound.robot.BotBase)
App Icon: myapp001.png
The following is the minimum configuration required to get the Newbound software to recognize your app:
Step 1 - Build Source Directory
Create a subdirectory of your Newbound/runtime folder called myapp001. Inside of that directory, create a subdirectory called src. Inside of that folder, place the following files (slashes denote additional subdirectories):
NOTE: You can add as many other java or class files as you like, and any files you drop in the "html/myapp001" folder will be served up by the web server.
Step 2 - Prepare App Properties File
Now you need to create a new file called app.properties and place it in the Newbound/runtime/myapp001 folder with the following contents:
desc=The My App application
Step 3 - Activate Your App
Once those few requisite files are in place, the only thing required to activate your app is to edit the Newbound/runtime/botmanager/botd.properties file and add your class name to the end of the "bots" property. That line should look something like the following:
Step 4 - Restart the Newbound Network
Restart your instance of the Newbound Network. When your App Manager comes up, you'll have a new app on the menu.
Congratulations! You just successfully deployed an app manually on the Newbound Network!