Original Author Paul Laughton, 2011
Page 224
De Re BASIC!
If the .bas program files in the source subdirectory of your assets are encrypted, you must set the item
"apk_programs_encrypted" to true. This tells BASIC! that it must decrypt programs as it loads them.
The item "run_name" is the default title of the Console. Your program can set the Console title, but you
may want to change the default title here. Similarly, "select_name" and "textinput_name" set the
names of the screens for the Select, Text.Input, and TGet commands.
If your app uses Console output, you can set the text colors here. The mapping of "color1", "color2",
and "color3" to text foreground, background, and underline depend on your Screen Colors setting
under Preferences.
As mentioned earlier, the "load_file_names" is a list of files that you want loaded to the SD card. Any
files listed here will be copied from the assets directory to the SD card every time your app starts. This
may be the internal Android file system or a file system mounted on an external SD card. After that, your
app will access the files from the SD card file system, not from assets. Any changes your program makes
to these files will be overwritten the next time the app starts. To preserve changes, your program must
copy or rename the file. The copied/renamed file will not be overwritten when your program runs again.
Several items in setup.xml control the splash screen and file-load progress indicator. If you don't change
anything, your Cats app will display the default BASIC! splash screen briefly. You may not see it because
the apk does not load any files.
You can turn off the splash screen by setting "splash_display" to false.
The splash screen image is the resource file res/drawable/splash.png. To customize the splash screen,
replace this file in your project with an image of your own. Your image file must be named splash.jpg.
If you do not use a splash screen, you may remove this file from your project to make your apk a little
smaller. Do not remove the file res/drawable/blank.jpg.
You can also customize the file-load progress indicator. Progress is shown in a pop-up over the splash
screen. The title comes from the string "loading_msg". Each increment of progress is a copy of the string
"progress_marker ". The default string is a single period (.).
You can turn off the progress indicator by making the "loading_msg" an empty string.
The setup.xml file is intended to collect the fields you are most likely to want to change all in one place.
There are many other strings and values that can be set to customize your app. Another file with fields
you may find interesting is strings.xml, where default values of many strings are set. For example, you
can change the default title string for the Speech-to-Text dialog by editing the string named sst_prompt.
Later, we will describe how to change the default values of Preference options in the file settings.xml.