Basic2Zip


Basic2Zip screen shot.

Introduction:

1 Introduction
Basic2Zip is an open source app. It allows you to select a Basic source file to compress into a ZIP file. It parses the source file to find the INCLUDEd files to compress into the ZIP.

2 Operation
The two buttons you will always use are Pick and Process and Create ZIP file.

2.1 Pick and Parse
This is the first button you press. It displays a FilePicker dialog so you can select a Basic source file. By default the ZIP file name will be the same with ".zip" appended. The source file will then be parsed and a file list will be displayed. The list will show the names of the source and zip files, followed by the INCLUDEd files (if any).

2.2 Create ZIP File
This button (disabled until you select a source file) creates the ZIP file. You can then either pick another source file, or you can quit by pressing the button at the top right corner of the screen.

2.3 Change ZIP Name
This button (disabled until you select a source file) displays a FilePicker dialog so you can select an existing ZIP file to overwrite, or enter a new file name.

2.4 Add Files Manually
This button (disabled until you select a source file) displays a FilePicker dialog so you can select other files to compress into the ZIP file. Use this button as often as needed. Added files will be displayed in the list.

3 Optional Parsing
It's easy to find included source files because they are named in the source's INCLUDE statements. But the program may also need files such as data, database or other files. Although you can add them with the Add Files Manually button, there is a more automated way. Just add special comments to your source like this:

%%INCLUDE-DATA "MyDataFile"
or
%%INCLUDE-BASE "MyDatabaseFile"
or
%%INCLUDE-OTHER "MiscellaneousFile"

This serves two purposes: it makes for better documentation of your program, and it tells Basic2Zip what files to include in the ZIP.
%%INCLUDE-DATA directs Basic2Zip to the basic/data directory.
%%INCLUDE-BASE directs Basic2Zip to the basic/databases directory.
%%INCLUDE-OTHER directs Basic2Zip to the root directory.
You can use as many of these special comments as needed. Note that they must start with two "%" characters, no intervening spaces, and case does not matter. All of the files will be displayed in the list.

4 Recursive Parsing
Basic2Zip parses your source file and all INCLUDEd files recursively, so all files INCLUDEd in included files will be added to the ZIP. There is no recursive depth limit, and all files will be displayed in the list.

5 Skipping Files
Once the list has been populated with file names, you can swipe a name to the left to expose a Skip button. Pressing it will mark the file to be skipped (excluded from the ZIP). The file name will be enclosed in "*".
Swiping the name to the right will expose an Unskip button to cancel the skip.

6 Disclaimer
Basic2Zip and its documentation are provided with no warranty. Although the author will make an effort to ensure correctness, the software and documentation are provided "as is", with any faults, defects, bugs, and errors.

7 Credits
This software and documentation was written by Robert A. Rioja, robrioja@gmail.com, http://www.RvAdList.com

The GW Library was written by Nicolas Mougin, mougino@free.fr, http://mougino.free.fr

You can run Basic2Zip two different ways:

  1. You can download the source files and run it with the RFO-Basic interpreter. You must have already installed RFO-Basic on your Android device. Then you can download the Basic2Zip source files from the next section and copy them into the approriate RFO-Basic folders in your Android device.

    2. AND / OR

  2. You can download the compiled version of Basic2Zip in APK format from this site. Then you can install it on your Android device without the need for the RFO-Basic interpreter app. This APK was produced using the BASIC! Compiler written by mougino.

Release History

Version Date Description Source APK
20210313 March 13, 2021
  • First release.
Downloaded 59 times
Downloaded 125 times


Please help support our development efforts by donating here:


RFO-Basic can be found here: Android Google Play store.

BASIC! Compiler can be found on the Android Google Play store. More information can be found at http://rfobasic.freeforums.org/android-basic-compiler-f34.html.

Hope you enjoy using Apk2Basic!