Installation of ZX Basic SDK
ZX Basic SDK comes in two flavours:
- Multiplatform (Linux / Windows / Mac) python scripts. This is the main distribution and recommended for everyone.
- Windows .MSI Installer.
The latest is only for Windows users who are not able or very lazy to use python scripts directly. This .MSI distribution is not updated as often as the Multiplatform one, but has the advantage of not requiring to have the python interpreter previously installed.
For the Multi-platform bundle, you will need the python interpreter version 2.5 or higher installed on your system (Linux and Mac OS X users will probably have it already installed since it is very common on those operating systems). For Windows users, there's also a python interpreter from ActiveState, the ActivePython interpreter, 100% python compatible (Windows users who choose the .MSI installer distribution does not need to install any python interpreter).
To get the latest version of the ZX BASIC SDK, go to the Download Page, and get the .MSI or .ZIP file you want. The .ZIP files are Multiplatform (Linux / Windows / Mac) whilst the .MSI files are for Windows only, as previously explained.
Installing the .MSI distribution is pretty straightforward: Just double-click on the .MSI file once downloaded. You can later uninstall it by going to your Add/Remove Programs section in your Control Panel.
The .ZIP distribution does not require any installation. Just uncompress the SDK tree in a directory of your choice and make sure that folder is included in your PATH environment variable.
Warning: Do not use the SDK folders to place your source code.
This applies for both .MSI and .ZIP packages. If you mix your .bas code with the one in the SDK you can end messing up your installation. Keep your computer tidy! Use your *own* folders to create your BASIC programs. This will also prevent upgrade problems in your SDK.
Testing your installation
For the .ZIP distribution, type zxb.py. For the .MSI windows version, type zxb You should see something like:
>zxb.py Usage: zxb.py <input file> [options] zxb.py: error: missing input file. (Try -h)
Ok, the compiler is working (or it seems so). Now you should proceed to the following section to learn about its usage.