A Simple Program

From NSB App Studio
Jump to navigation Jump to search

Purpose

The purpose of this tutorial is to demonstrate how a simple program is created using NS Basic/App Studio. You should have NS Basic/App Studio installed before beginning this tutorial.

Description of the Program

The program to be developed will display a form with a button on it. When the user taps the button, the program responds with the message "Hello World!"

Program Development

Startup

1. Start NS Basic/App Studio from the Start menu. Here is what you will see:

TT01.01.JPG

  1. ToolBar: A list of common functions, made quickly accessible. If you are not sure what one is, hover over it with your cursor and its description will appear.
  2. ToolBox: A list of objects you can put on a form.
  3. Design Screen: Here is where you layout the objects on the form.
  4. Project Explorer: See the structure of your code. Use this to select objects and to bring up the Properties for them.
  5. Properties Grid: A list of the properties of the item selected in the Project Explorer.
  6. Status Bar: Messages from the IDE to you.
  7. Hints: Some tips on the current object.
  8. (not shown yet) Code Window: An editor for your program code.

2. Create a new project. Select menu item File...New. Choose Classic for your framework, the default iPhone/Nexus size and use HelloWorld as your new File name. (If you use jQuery Mobile as a frame, this tutorial will work fine, though the app's appearance will be slightly different.)

TT01.02.JPG
It's best to create your project in a new folder.

TT01.03.JPG
3. Add a Button. Select the button in the ToolBox and drag & drop it where you like.

TT01.04.JPG
4. Edit the Value of the button to say "Click Me!"

TT01.05.JPG
5. We can actually run the program now. Choose Run...Start in Desktop Browser. It runs in your default browser: we recommend using Chrome or Safari, as these support the WebKit extensions which mobile devices use. We could even run this on a device, but let's do a bit more first...

TT01.06.JPG
6. In the Properties Editor, choose onclick. It will show a popup with 'Button1_onclick()'. Select that, and you will go into the Code Window:

TT01.07.JPG
7. Add the following code into the function:

 Msgbox "Hello World!"

TT01.08.JPG
8. Now, run it again and click on "Click Me!" (To get a prettier MsgBox, use NSB.MsgBox instead.)

TT01.09.JPG

Run on an iPhone

1. Good work! Now let's run it on a phone. From the Run menu, choose Deploy. The IDE will upload your complete app to a webserver called nsbapp.com. We have set this one up for NS Basic users for testing. (We're using an iPhone here. We'll do it for Android next.)

TT01.10.JPG
2. Now, get your iPhone and go into Safari. Enter in the URL from the last step.

TT01.11.JPG
3. Hit Go. The page will appear. You can tap on "Click Me!", and you'll see: a working app in NS Basic/App Studio.

TT01.12.JPG
4. But this isn't a real app: it's just a web page that looks like one. Let's turn it into a real app on the Home Screen. First, we'll tap on the arrow icon at the bottom of the screen.

TT01.13.JPG
5. Choose "Add To Home Screen", then click on Add.

TT01.14.JPG
6. We're done. Let's have a look. Here is the Home Screen:

TT01.15.JPG
7. Click on the HelloWorld icon, and this splash screen shows up:

TT01.16.JPG
8. Now the app itself is showing. Notice the top Safari bar is not there? This app now looks and runs like a normal phone app. It will even run if the device is offline. TT01.17.JPG

Run on an Android device

On Android the procedure is even simpler.

1. Here is how our app looks.


2. Tap on the menu button to bring up your choices. Click on Bookmarks.


3. Click on Add to add it to your bookmarks.


4. Change the name if you need to, then tap on OK.


5. Hit the Home key to get back to the Home Screen


6. Hold your finger down on the Home Screen until this pops up. Select Shortcuts.


7. Select Bookmark.


8. Select HelloWorld.


9. And here is our new Home Screen. The new app on the home screen will run whether the device is connected to the net or not.