The android program, and related tools, are released under the GPL.
The android source is availbale in the main source archive in the files section. The android source is located in the palmve/src/android folder. There's a Makefile there which you can use - but you can also just use ant or eclipse in the normal way. See the android developer site for more information about that if you're not acquainted with android development yet.
If you do use the makefile, note that it will link a gimp plugin into your ~/.gimp area. This plugin handles converting icon source art into individual PNG files. It's a bit rude for it to do this, and so you've been warned.
Currently the code requires API level 8 to build, though it should run down to API level 3.
The code for the related tools has a long history already, originally being used in a palmpilot program. So, some of it is left a bit wanting.
What's life, though, without a little flavour?
- libpdb - Simple Write-Only PDB (old legacy palmpilot) file generation classes
- libelement - VEC question pool element parser/converter classes
- libmisc - Miscellaneous stuff. The XML parser and a crappy getopt() for Win32 is in here.
- pveconv - Utility that uses both libraries to convert VEC question pool text files to XML and PDB (for PalmVE) formats. Also handles converting PNG graphic files into a figure database.
- pvecol - Utility that converts specially formatted XML files into PalmVE databases containing collections of test templates and ARRL Review Questions. These test templates and review questions aren't supported by the android application.
All three utilities build on linux and on windows. System requirements are as follows:
Linux is where I do most of my development. I've tested building the tools on cygwin. I have not tested building the android program except on linux under eclipse and from ant. The project uses autoconf, and most dependencies are detected, so you should be able to run ./configure until it succeeds, installing packages as necesary.
While the source uses autoconf, it does not use automake. It might build okay on anything with a gcc, but I've only tried it on linux and cygwin. Run ./configure and make as usual, note that there is no install make target. The binaries get put into ./bin and the data into ./data/pools and ./data/collections.
To build release versions run - make release=1 - release and debug versions of everything can live in the same tree.
Note that cygwin includes pre-built packages for all the requirements.
- GNU/g++ & make - With GNU g++ and GNU make you can probably build the components on most anything. Tweaks are likely to be required when not on a stock glibc2/gcc3.x linux box.
- libexpat - XML parser. I'm using 1.95.5 but most versions should work.
- libgd - PNG/graphics library. I have 1.8.4, but it shouldn't matter as long as your system's libgd supports PNG files. PNG/GD support IS optional if you don't want to build it. It is only used to convert figure PNGs into a format the PalmVE application can understand.
- boost - boost system and filesystem libraries are required. 1.36.0+ should work.
- sqlite3 - SQLite3 libs are required.
- Dev Studio - A solution and project files exist for VS2008.
- MSXML2 - As long as you have a reasonably recent version of IE you should be fine here. If you have VS.NET then the MSXML2 header files are bundled with your compiler so you should be able to build it too. If you DON'T have MSXML2, install the most recent one. (4 right now I think)
- GDI+ - This is standard on XP and available as a redistributable for earlier versions of Win32. You should be able to find it on microsoft's website somewhere. You can turn off GDI+ support by removing a preprocessor definition. This is only required to process the PNG figure files for PalmVE.
- boost - You'll have to download and build boost, or get a pre-built copy.
Pre-built windows binaries of the tools are available here.
To process a text file pool into a sqlite3 file for PalmVE, run:
pveconv -Ts ./file.txt
This will generate the .sqlite3, including figures and full text search. You may need to set a graphics directory with -g if you aren't using my directory tree so that it can find the PNGs.
If you're trying to go to XML, use -Tx and -Xs to go from XML to PDB. The makefiles in the distribution convert the text into XML and the XML into PDB, thus, it is a two pass process.
|palmve-1.2.0.tgz||Sun Feb 6 2011||Main source archive.|
|palmve-win32-bins-1.2.0.zip||Sun Feb 6 2011||Precompiled pveconv binaries for win32.|
|palmve-pools.zip||Sun Feb 6 2011||Raw text-only version of question pools.|
|palmve-technician-files.zip||Sun Feb 6 2011||Technicial class question pool source and data files.|
|palmve-general-files.zip||Sun Feb 6 2011||General class question pool source and data files.|
|palmve-extra-files.zip||Sun Feb 6 2011||Extra class question pool source and data files.|
|signatures.tgz||Sun Feb 6 2011||MD5 sums and GPG signatures for all files.|
- 1.2.0: Sun Feb 6 22:12:24 EST 2011
- Reorganize how figures are stored to support having multiple version of the same element in a saner way.
- 1.1.0: Mon Dec 6 15:39:49 EST 2010
- There were no real tool changes here, though a zipcode to timezone datafile was added to aid in the VE search date/times.
- Oh, and the old palmpilot source is now included. There's no reason to keep it out anymore.
- 1.0.0: Fri Sep 24 18:27:52 EDT 2010
- Initial android release.