Installation
------------

The Basic IDE project is provided in the BasicIDE zip file.

The Basic IDE Designer project is provided in the BasicIDEDesigner zip file

The Basic IDE Launcher project is provided in the BasicIDELauncher zip file. The Basic IDE Launcher project includes all the modules from the Basic IDE project by relative reference except for Syntax which is not needed. For this reason the Basic IDE and Basic IDE Launcher projects should be installed side by side in a common parent folder on the desktop. See the introduction to the Basic IDE Launcher topic. The suggested name for this common folder is BasicIDE Suite. For convenience also install the BasicIDEDesigner project in this same folder.

Copy the Help folder in the BasicIDEHelp zip file file to your BasicIDE project folder, not the common BasicIDE Suite folder. Before extracting the BasicIDEHelp zip file it should be unblocked by right clicking on it in File Explorer, selecting Properties and checking Unblock at the lower right of the General tab. In particular this allows the .chm help files to be properly displayed by Windows and allows UpdateHelp.exe to run without a security warning. If the .chm files are not unblocked their content will not be available in the Windows help viewer. The files may be individually unlock later if this step is omitted.

IMORTANT: Before compiling BasicIDE run UpdateHelp.exe in the Help folder to copy the help files to the project Files folder. These are omitted from the BasicIDE zip to keep the zip size withn the B4A forum upload limits.

The BasicIDE projects compiles a full set of help files into DirAssets of the resulting app. When UpdateHelp.exe is run it creates BasicIDEScriptAutocomplete.txt, BasicIDEScriptHighlight.txt and BasicIDEHelpUpdated.date. These updated files are automatically copied to the BasicIDE project Files pane, together with the B4AScript and BasicIDE chm and html help files, so they can be copied to the device Help folder when BasicIDE is run. See the more complete description of this in the Basic IDE Script Module topic of this help.

The additional libraries required by the BasicIDE Suite projects are provided in the BasicIDELibraries zip file

Basic IDE requires the BasicLib, CodeEditorView, CollectionsExtra, Dialogs2, GPStoOSGB, IME2, ScaleImageView and ScrollView2D additional libraries. To save locating these in the forum they are available in the BasicIDELibraries zip file. Any not already there should be added to your B4A Additional Libraries folder. BasicIDE also requires the BitmapCreator, JavaObject, Phone, RandomAccessFile, Reflection, RuntimePermissions, Serial, StringUtils and XUI Views standard libraries. 

Basic IDE Designer requires the Dialogs2 additional library and also the JavaObject, Phone, Reflection and XUI Views standard libraries.

Basic IDE Launcher requires the BasicLib, CodeEditorView, CollectionsExtra, Dialogs2, GPStoOSGB, IME2, ScaleImageView and ScrollView2D additional libraries and also the BitmapCreator, JavaObject, Phone, RandomAccessFile, Reflection, RuntimePermissions, Serial and StringUtils standard libraries.

Further instructions are available in the BasicIDE.chm help file in the Help folder.


Help
----

Look in the Help folder in the project folder for more help. If the compiled help files will not display properly then the BasicIDE.zip file was not unlocked before extraction. Either go back and do that or individually unclock each help file. The compiled help files can be viewed on the device with a suitable app. The author uses 'CHM Viewer ACHM by Peter PingChen' from the appstore but there are others available.

BasicLib.chm documents the methods, properties and events implemented by the BasicLib library object.

B4Script.chm documents the B4Script language implemented by the BasicLib library object.

BasicLibIDE.chm documents the BasicLibIDE B4A project.


There are two help files in a simple html format for use on the device.

B4ScriptHelp.html contains much the same contents as BasicLib.chm and documents the B4Script language implemented by the BasicLib library object.

BasicIDEScriptHelp.html is a help file that documents the B4Script language extensions implemented in the Script module of the BasiciDE project. It was produced from comments in the Script.bas file by running BasicIDEScriptHelp.exe. The formatting of the html file is very simple. Any comment in Script.bas beginning with two apostrophes is output to BasicIDEScriptHelp.html. Any such line beginning "@N:" output with a preceding newline, any such line beginning "@H:" output in bold with a preceding newline, any such line beginning "@" is output in bold. Any other such line is output as-is and so may include further html code if required.
