NSB/App Studio FAQ
Frequently Asked Questions (FAQ)(faq)
- 1 The product itself
- 1.1 What kind of dev tool is this?
- 1.2 When was it released?
- 1.3 How many paid users are there?
- 1.4 What devices do the apps it creates run on?
- 1.5 What about the Apple Watch?
- 1.6 What desktop computer do I need to run AppStudio?
- 1.7 What technologies is it built on?
- 1.8 Is Apache Cordova/PhoneGap Build supported?
- 1.10 How big is the runtime?
- 1.11 Is AppStudio just like Visual Basic or NS Basic/CE?
- 1.12 How do I convert my VB project to AppStudio?
- 1.13 How fast is it?
- 1.14 How can I test my programs?
- 1.15 What is your Test Server?
- 1.16 Can I do file I/O?
- 1.17 Can I use ftp? Can I write to my sdcard?
- 1.18 Can I access a database on my server, such as MySQL, Access, Oracle, etc.?
- 1.19 Can I read and update an Excel spreadsheet?
- 1.20 What can't I do?
- 1.21 Tell me more about Bluetooth!
- 1.22 Can I print to a Bluetooth printer?
- 1.23 What about hardware specific features?
- 1.24 How do I handle different screen sizes?
- 1.25 What about retina displays?
- 1.26 My phone is 1920x1080. Why can't I address all the pixels?
- 1.27 How can I detect when the app is closing?
- 1.28 What about Windows Phone?
- 1.29 Can I use WinSock? UDP? sockets?
- 1.30 What about proxys and firewalls?
- 1.31 Can I read barcodes?
- 2 Support and Documentation
- 3 Distributing your app
- 4 Licensing and Upgrades
- 4.1 Where can I buy it? What does it cost?
- 4.2 What is your upgrade policy?
- 4.3 I want to run it at the office, on my laptop and at home. How many licenses do I need?
- 4.4 I have a number of developers. Do I have to buy licenses for all of them?
- 4.5 I would like to use AppStudio in my classroom. What license do I need?
- 4.6 The demo period has expired, but I'm not done testing.
- 5 Other
The product itself
What kind of dev tool is this?
Applications you create are freely distributable and are write-once, run anywhere. Lots of sample code is included.
The environment features a Visual Designer, which allows you to graphically lay out your control and set their properties. You can then hook code into the controls and add other code as needed. When your code is complete, use one key to run it locally, deploy it to a website or convert it to a native app using Apache Cordova or PhoneGap Build.
If you have worked with Microsoft's Visual Studio, you'll find it easy to come up to speed.
When was it released?
In December, 2010. It is currently at Version 5.x
How many paid users are there?
As of August, 2016, there are over 1 million users in over 70 countries.
What devices do the apps it creates run on?
AppStudio apps run on:
- iPhone (any model) with iOS 4.3 or later
- iPod Touch (any model) with iOS 4.3 or later
- iPad (any model)
- Android 2.3 (or later) devices. Limited functionality on older devices.
- Windows Phone devices (limited)
They will also run on the desktop with Chrome, Safari and Internet Explorer.
What about the Apple Watch?
At this point, it does not look like it will be. AppStudio uses a WebView for its interface: apparently, the Apple Watch does not have this feature.
What desktop computer do I need to run AppStudio?
Development can be done on the following computers:
- Mac OS 10.7 or later. Mac OS 10.6 if running on a 64 bit processor
- Windows 7 or later
- Virtualbox and Ubuntu Wine also work.
What technologies is it built on?
Is Apache Cordova/PhoneGap Build supported?
Yes, both are. Apache Cordova makes it much easier to build native apps on your desktop using the iOS and Android toolchains, at no cost. PhoneGap Build is a commercial service with makes this much easier. The first project is free.
How big is the runtime?
Tiny - less than 125k. Of course, this number will increase if you use various libraries and frameworks.
Is AppStudio just like Visual Basic or NS Basic/CE?
It's actually a lot like Visual Basic and NS Basic/CE. Both use the same core language definition: all the statements and functions are identical. The differences lie in the operating system and environment. For example, the screen controls on an iPhone have a very different look and feel to their counterparts on the desktop. Controls which are designed to be touch operated will work differently from keyboard and mouse style controls.
We used the VBScript Reference manual as a guide for our design. Read more here about Compatibility with other versions of BASIC .
How do I convert my VB project to AppStudio?
The general procedure is as follows:
- Create the form(s) using the same names using AppStudio.
- On each form, add the controls, again using the same names. Most of the VB controls have direct replacements. You will need to change the size and layout to suit the screen size of a device.
- Copy and paste the code from each VB form into your AppStudio project.
- Debug and smooth over differences.
How fast is it?
AppStudio executes over 1,000,000 loops/second on the current generation of devices. That's pretty quick for devices in this class, fast enough for most anything but perhaps the very heaviest number crunching.
How can I test my programs?
During development, AppStudio runs your program in your default browser: Chrome and Safari work best. They both have good debugging facilities. The program looks and feels much like it will on a real device. Of course, you should also test on actual devices.
You can also deploy to the AppStudio Server or to your own server. You can then download your app to your device.
What is your Test Server?
Our Test Server is available to all AppStudio users to upload apps to. It's built into AppStudio so no setup is needed. Once there, any mobile device can download your app.
There are certain restrictions on the server so it does not get hacked or overloaded. Very, very large projects cannot be uploaded; projects which have not been updated in a while are purged, and PHP scripts are not allowed.
Can I do file I/O?
Yes. For simple files, there is a localStorage which lets you save and retrieve string data. It is persistant, meaning the data will still be there next time you start the program. Most devices allow up to 5 megs (sometime much more) per app.
SQLite is supported for more sophisticated applications. It's an easy to use database that gives good performance.
Files can be read using the ReadFile function if they are loaded from the same server as the app. See the ReadFile sample.
One thing you cannot do is access the actual file system of the device. Modern mobile operating systems "sandbox" the apps so they cannot interfere with each other.
If localStorage and SQLite are not sufficient (they almost always are), access to the device's filesystem is available using a PhoneGap Plugin. This includes SD cards on devices which have them.
Can I use ftp? Can I write to my sdcard?
You might want to look at this a bit differently. To begin with, most devices do not have an sdcard, so your software probably should not assume there is one.
Second, the information is in a string on the server, and you will want to use it as a string in your app. Why convert it to a csv and back again? It will be much quicker and easier if you skip those steps. Ajax is the way to go here - ftp is pretty much an obsolete technology now.
Actually, using FTP is relatively simple, if you have an FTP client. But JS was built to "talk" HTTP and you have to have an external JS library to make FTP work There is one in the PhoneGap world (https://github.com/macdonst/FtpClient). We have not tried it and cannot vouch for it, so caveat emptor.
If you are connecting to your own server, implementing a PHP (or .Net, whatever) script will be much easier a task. If you use your own server, pay attention to security; there are lots of rogue actors on the net that will trash an unprotected site in seconds. If, however you have client demands or are working with a commercial FTP site and have no choice but to use FTP, grab that library. The good thing is that there are lots of FTP server apps out on the web (I have used Filezilla and it's great) so your code only involves the JS client,
I've done both, so here's a perspective: If you're asking for FTP because you think it's the way to go for file transfer, think again. But if the project has a hard requirement for FTP, dive in and keep in touch. (Comments from Lee Church).
Can I access a database on my server, such as MySQL, Access, Oracle, etc.?
The only database that runs locally on mobile devices is SQLite. If you want to get information from a server database to your device, you have a couple of choices:
- Import the data into an SQLite database and include it with your project.
- Have a listener program on a port on your server. Use AJAX calls from your app to the listener program. The listener program can then access the database on the server and return the requested information.
Can I read and update an Excel spreadsheet?
Since Excel does not run on mobile devices, it (and the spreadsheet itself) need to be running on a server.
You'll need a program on the server to read and update the Excel spreadsheet, that can also communicate with your mobile app, much like with databases.
What can't I do?
For things like Bluetooth, microphone, serial comms, you'll need to use PhoneGap. PhoneGap lets you run your AppStudio app as a native application. It has plug ins which let you use native API functions.
Tell me more about Bluetooth!
With the recent updates to PhoneGap, it's now practical to use Bluetooth.
- To use native code, you need to build a native app. PhoneGap has a nice way of doing this, using plugins. AppStudio works well with PhoneGap, and there is a Bluetooth plugin for PhoneGap.
- PhoneGap Build makes it easy to compile AppStudio + Plugin apps.
You can develop and test the rest of your app normally - just the Bluetooth dependent parts will need testing with PhoneGap.
Can I print to a Bluetooth printer?
There are also Bluetooth printer libraries available as PhoneGap Plugins, but only a few printers are supported.
What about hardware specific features?
Most hardware features are available. The Camera, Compass, GPS and Accelerometer are, but it is not possible to vibrate the phone. Once again, PhoneGap comes to the rescue.
How do I handle different screen sizes?
Devices come in many different screen sizes, from small phone to large tablet. The devices can be positioned in portrait or landscape rotation: you can decide to support one or both. Use the Orientation control to help here.
In most cases, simply scaling the controls on the form will give poor results. The best way to do this is to detect the screen size on startup and adjust the sizes and positions of your controls. There's a handy .resize(left, top, width, height) function to help you do this. Scaling does not work, since buttons will look oddly sized, images will have incorrect aspect ratios, and poor use will be made of the screen real estate.
Controls can have their bounds set as percentages. For example, you could set a TextArea to be 80% of the width and 50% of the height of the screen, positioned 10% from the left and 30% from the top.
Another thing to keep in mind is that tablet apps often need a different approach than phone sized apps. The extra space on the screen can be used to display a list of items (such as email messages) while the main part of the screen can be used to display the selected message. This wouldn't fit on a phone sized screen, but results in a more usable app on tablets.
(If you do want to use simple scaling, there is a sample on the web board. Have a look at Zoom by winvetpro.)
What about retina displays?
Retina displays work just like regular displays: your program will run the same on either, filling the entire screen. If you are using a retina display, fonts will be drawn using the higher resolution, producing crisper text. If you supply hi res versions of images, they will be displayed instead of the low res version.
My phone is 1920x1080. Why can't I address all the pixels?
While your phone may physically have that many pixels, the operating system treats them as doubled or even tripled pixels. You'll only be able to address 640x360 or 960x540, depending on the device. The operating system will take care of mapping the pixels to their actual location. This is actually very good news: it means that you won't have to drastically change your app each time it runs on a new device.
How can I detect when the app is closing?
You can't. Apps close when you start another app. A app with a Close or Quit button will actually get rejected from app stores for violating user interface guidelines. Starting the app again will bring back the already running version (for PhoneGap apps) and restart it from the beginning (for web apps) or if the device was shut down in the meantime.
The best technique is to constantly save the current state of the app in localStorage and SQLite. When the app restarts, check the last saved status in localStorage, go to the most recent form and fill in all the fields. Done right, it will look as though the app was never exited.
What about Windows Phone?
Windows Phone 8 uses a browser based on Internet Explorer. AppStudio makes heavy use of browser features, including HTML5 and WebKit. Internet Explorer's support for these features is not as good as Chrome and Safari's. Microsoft is working on this: Internet Explorer 11 is the best yet.
In the meantime, Windows Phone 8 devices can be used, so long as you do not make heavy use of WebKit. The best practice is currently to use the jQuery Mobile framework (to get around the need for WebKit) and compile using PhoneGap Build (to get around the missing HTML5 features).
There is no support for Windows Phone devices before Windows Phone 8.
Can I use WinSock? UDP? sockets?
AppStudio has support for WebSockets built in. It's the easiest way to do this and works well with current web security practices.
WinSock, UDP and older style sockets can be done using PhoneGap Plugins. If there is one that fits your needs in the list of PhoneGap Plugins, It will be easy to use with AppStudio. If the plugin is not yet compatible with PhoneGap Build, you will need to use the full PhoneGap API.
What about proxys and firewalls?
AppStudio needs to contact the nsbasic.com server on startup to verify your serial number. You will need to make sure your system allows for this.
If you are routing through a proxy, make sure to add localhost, 127.0.0.0 to the ignore list. AppStudio uses this for local testing.
Can I read barcodes?
Yes. There are several ways to do so. Check out this blog post: How to read barcodes.
Support and Documentation
How is it supported?
Is there an option for Premium Support?
Yes. For a monthly fee, you can get Premium Support which includes direct access to the developers, fast turnaround time and much. See our Support Policies.
What documentation is included?
There is a wiki that contains the complete documentation on the IDE and the language. It is included with the product for offline use. Short summaries of most functions are in on line help. There are also tech notes and tutorials.
Is the a hardcopy Handbook?
We got rid of hard copy handbooks several years ago. We were reluctant to do so, but the seachability and linking that a Wiki provides is essential once you get used to it.
Not having to worry about page count let us expand the amount of documentation we have by quite a bit.
There are utilities which can print out a Wiki, but they tend to be cumbersome.
Distributing your app
Can I distribute my applications?
Yes. You may distribute your apps, with no further royalties or costs. AppStudio apps can be distributed without going through Apple's iTunes store or Google's Marketplace. This is great news: setting up an app in the iTunes store can be more challenging than writing an app in AppStudio. Instead, apps can be distributed over the web. Apps can be sold by controlling who is allowed to access the app.
But I want to distribute my app through the App Store!
If you want to distribute through the App Store, you can compile the project using PhoneGap. Submitting to the iOS App Store Submitting to the Google Play and Amazon Stores PhoneGap itself is free for limited use - you will need to pay Apple $99/year to belong.
Do I need a Mac to distribute through the App Store?
To do the final submission of an app compile as native to Apple's App Store, you need a Mac. The program used to upload apps, "Application Loader.app" is a Mac only application. You can buy a used Mac Mini for this - they are not expensive. You do not need a Mac to distribute your app as a web app, since you do not use the App Store.
How can I protect my code?
There is an option to obfuscate in the Deploy step: this makes it more difficult for people to look at your code. Third party utilities exist with improved obfuscation, which will require more sophisticated tools to look at.
For improved security, compile your app using PhoneGap. This will result in a executable. It is still possible, however, to unpack the executable and examine the source files.
Any executable, on any platform, can be reverse engineered with sufficient effort.
Can I distribute to Windows Mobile devices?
Yes. You need to build your app using PhoneGap. It will produce .xap file which you can then submit to the Microsoft store. Web apps won't work: Windows Phone does not implement the cache manifest will allows apps to run offline.
To install a .xap file to your developer phone, look in the "Windows Phone SDK 8.1" folder that contains the "Windows Phone Developer Registration 8.1" file that is used to unlock the phone. There is another file "Windows Phone Application Deployment 8.1" file. It allows you to select a file from a folder in your computer to the WPhone8 attached and click "Deploy" and app is installed. No need to have an account with Microsoft. (tip from Chris Salonikas)
Licensing and Upgrades
Where can I buy it? What does it cost?
AppStudio for a single developer is $99.95 USD directly from NS BASIC Corporation's order page.
What is your upgrade policy?
Point upgrades are free. We reserve the right to charge for major new versions - that gives us an incentive to make something really special.
I want to run it at the office, on my laptop and at home. How many licenses do I need?
One, so long as you are the only one using it. The license is to a single developer. You can even run a mix of Windows and Mac computers, up to a maximum of three computers.
I have a number of developers. Do I have to buy licenses for all of them?
If you have a single location with many programmers, consider an Enterprise License: unlimited programmers at one location for a flat price.
I would like to use AppStudio in my classroom. What license do I need?
The Educational License is a perpetual classroom license. Students will be able to use personal copies for the duration of the semester they are attending the course: the reacher can reuse the license in the next term with a new class of students. If you are a teacher and would like a free version, send us your credentials.
The demo period has expired, but I'm not done testing.
You have 3 options:
1. Change the system date when you start the demo. It only checks it on start, so you can put it back right away.
2. Take advantage of our 30 day no hassle money back. Buy it and if it doesn't work for you, let us know and we refund right away.
3. Run on another machine.
Are you available for contract work?
Yes, we are available for contract work. AppStudio comes first, of course, but working on real projects keeps the guys here in touch with the real world. Send a message to us if you are interested.
Who is NS BASIC Corporation?
NS BASIC was formed in 1993 to create applications for developers using hand held computers. The initial product, NS BASIC for the Newton, started shipping in 1994 and has consistently been one of the top selling packages on the Newton platform. The product has been continuously updated since its first release. In late 1997, NS BASIC released its next product, NewtCard, a product inspired by Apple's HyperCard application. NewtCard has probably garnered more "Best of" awards than any application produced for hand held computers.
NS Basic/Newton and NewtCard are two of the three software products to garner a "First Class Award" from Mobile Computing. NS Basic/CE was first released in 1998. It has been continuously been enhanced and improved since that date. Apart from the free eMbedded tools from Microsoft, it is the most widely used dev tool for Windows CE.
NS Basic/Palm was released in 2000. It became the most popular development tool for those devices.
Over the years, NS BASIC Corporation has developed a large body of special expertise in creating development environments for hand sized computers. Combining effective user interfaces for small, pen based screens with efficient use of resources built into the ROM, NS BASIC's applications are surprisingly powerful, small, and easy to use.
You can contact NS BASIC Corporation by email at email@example.com, phone at 1 888 NSBASIC (416 264-5999) or fax at 416 264-5888.
So what does the "NS" stand for, anyhow?
Nice & Smart.