Gas Mileage Tracker

©2009-2012 Majors Software

All Rights Reserved

Table of Contents
 

• Getting Started
• Main Screen
• Adding/Deleting/Renaming Vehicles
• Adding/Editing/Deleting Fillup
• Backing up and Restoring Files
• Known Issues
• Donate

Getting Started

Getting started with Gas Mileage Tracker is easy. When you first open the program, you will be prompted to accept the terms of the EULA. You will then be prompted to select the units you will be working with, whether this will be US, UK MPG, or L/100km. You will then be presented with the main screen.

Main Screen

On the main screen, you will see the main list of actions. From here, you can add a new car, or view the about screen for the program. Below these two items will be the list of vehicles you are tracking with the program. Press one of these vehicles to go to the main vehicle screen for that vehicle. Pressing the menu button will present you with these options:

• Backup Data - Backs up your gas tracker files
• Restore Data - Restores your gas tracker files
• Donate - Allows you to donate
• Version History - Shows the version history
• Units - Allows you to reset the units you use to keep track.

Adding/Deleting/Renaming Vehicles

To add a vehicle, press Add Vehicle on the main screen. You will then enter the name of the vehicle, the initial odometer reading, the price per unit you paid for this fillup, the amount of fuel you put in your vehicle, and the price you paid. Press the menu button to access an OK and Cancel menu. Press OK to save this vehicle, and Cancel or the back button if you change your mind. No changes will be saved.

To rename a vehicle, long press the vehicle name on the main screen, and choose Rename Vehicle. A dialog will popup allowing you to type a new vehicle name into the blank.. Press OK to save it, or Cancel or the back button to continue using the current name.

To delete a vehicle, long press the vehicle name on the main screen, and choos Delete Vehicle. Confirm the dialog that pops up, or press Cancel or the back button to cancel the deletion of the vehicle.

Adding/Editing/Deleting Fillups

After pressing your vehicle name on the main screen, you will be on the main vehicle information screen. On this screen, you will see three main parts of information about your vehicle, and a list of fillups below.

To add a new fillup, press your menu key, and select Add Fillup. On this screen, enter your odometer reading, price per unit, fuel units purchased, and price paid. Tick the box if this is a full fillup, and indicate how many fillups before this were missed. Leave this at 0 if no fillups were missed. Also, leave at 0 of the last fillup was an incomplete fillup. Press save to save the fillup, or press the back button to cancel adding the fillup.

To edit a fillup, press the fillup you want to edit on the main vehicle information screen. Alternatively, you can long press and select Edit Fillup. All the fields on that were present on the add fillup screen are present here, and populated with the data for the fillup you selected. Make changes, and press Save to save the changes, or the back button to go back without saving changes.

To delete a fillup, long press the fillup on the main vehicle information screen. Then select Delete fillup. Confirm you really want to do this on the dialog that pops up.

Backing Up And Restoring Files

Backing up files is probably the most important thing to do on any computer of phone. You never know when you might lose your phone, or anything like that.

To backup all your gas files, press your Menu key on the Main screen, and select Backup Files. All yout files will be backed up to the root of your SD Card. In the event you have no SD card installed, they will be backed up to wherever Android stores its application data like your pictures, ringtones, etc. From here you can back up all your files to your Main PC, the cloud, or whichever.

To restore the files, press the Menu key on the Main screen, and select Restore Files. Make sure the files are on the root of your SD card, or where they were backed up to in the event of no SD card on your device. You will be asked one by one, if you wish to restore the file. Click Yes or No. Warning: This action cannot be undone. Please make sure you are not restoring an older backup over a newer file.

Known Issues

• Sometimes, you will get an ArrayIndexOutOfBounds Exception, or an IOException when attempting to load your file for your vehicle. This happens very rarely, and is usually because of attempts at manually editing the vehicle files. But if this does happen to you, feel free to send the file to me. I will correct it for you.
• NumberFormatException when loading a file. This can very rarely happen if you somehow enter a number that is incompatible. Because this will cause the file to fail to load, you will need to send the file to me for it to be corrected.
• IOException when starting the program. If you have your phone connected to USB at the time you start the program, the program will not be able to load the files it needs. Unmount your phone and try again.
• Double images on the main screen. This can sometimes happen after deleting or editing a vehicle name. Change the orientation to fix this.

Donate

In case you wonder, this program is an effort to keep my coding skills fresh, while I go through college. As I learn more, more features will be added as time goes along. This program will always be free. However, if you would like to donate and help me out, feel free to. It is completely optional. No features of this program will ever be made donate only. What you see here will always be the full version.

This program is dedicated to both of my Grandparents. I only wish they were still alive today to see how far I have come.

JTR (1933-2011)
MAR (1933-2000)