Tracoid is an Android interface for the popular Trac web-based project management system. It leverages the familiar interface design and techniques common to the Android ecosystem to provide a simple and efficient way to interact with Trac on mobile devices.
Tracoid is Free and Open Source software, released under the GNU GPL version 3. That means you are free to use, modify, and distribute it in whatever way you see fit, provided that you grant everyone else the same freedom.
Allow Unknown Sources
By default, Android will not allow installing applications from anywhere but the Google Play Store. Therefore, in order to install Tracoid from an APK file, your Android device needs to be instructed to allow installation from uknown sources.
For Android 2.2 (Frozen Yogurt), 2.3 (Gingerbread), or 3.0/3.1/3.2 (Honeycomb):
- From the Home Screen, touch the Launcher icon
- Touch Settings
- Touch Applications
- Check "Unknown sources"
For Android 4.0 (Ice Cream Sandwich) and 4.1/4.2 (Jelly Bean):
- From the Home Screen, touch the Circle (app launcher)
- Touch Settings
- Touch Security
- Under "Device Administration" check "Unknown sources"
Install the APK
Once your device is configured to allow installation from unknown sources, you can install the APK file. The easiest way to install the APK is to download it directly using a browser on your Android device. When the download is complete, touch the notification to begin installation. You will be prompted to confirm the installation and be informed of the permissions Tracoid requires; touch Install to continue. After installation completes, click Open to launch Tracoid.
After you have successfully installed Tracoid from an APK file, it is ready for you to use. You can start Tracoid at any time by clicking its icon from the app launcher.
Before you can use Tracoid to connect to your Trac environment, you will need to install the Trac XML-RPC Plugin from Trac Hacks. Tracoid uses the JSON-RPC interface, so you need to make sure your Trac envrionment is running on at least Python 2.6, or that simplejson is installed.
Adding a Server
In order to connect to a Trac environment, you will need to enter some information about it. You will need to enter the following:
- Name — A name for the server, can be anything you want but must be unique among other servers you've configured in Tracoid on this device
- URL — The full URL to the RPC service for the Trac envrionment. Typically, it will be the URL of the Trac environment, with /rpc at the end. If your environment requires authentication, you may need to use /login/rpc. If you are unsure of the correct path, enter the URL of the Trac environment and Tracoid will attempt to find the correct one.
- Username & Password — The username and password used for authentication to the Trac environment, if required. Currently, only HTTP Basic and Digest authentication methods are supported.
When you first launch Tracoid, you will see a message indicating that no servers have been defined. To define the first server, touch the plus icon in the action bar (if you are on Android Honeycomb or later), or press the menu button and touch New Server (if you are on Android Gingerbread or earlier).
Enter the information about the server and touch the Submit button. Tracoid will attempt to connect to the server and validate the information you entered. If the information was correct, you will be returned to the server select activity.
Once you have one or more servers entered in Tracoid, tap a server from the list to view tickets in that Trac envrionment.
To select a different server while on the ticket list activity, press the menu button and touch Select Server.
After selecting a server, you will be taken to the view ticket activity. From here, you can see the list of currently open tickets, in order of priority. Future versions of Tracoid will allow you to specify custom filters for this list.
To view a ticket's details, touch it in the list to be taken to the view ticket activity.
Creating New Tickets
You can create a new ticket from the ticket list activity by touching the plus icon in the action bar (if you are on Android Honeycomb or later), or pressing the menu button and touching New Server (if you are on Android Gingerbread or earlier). Enter the applicable information in each of the available fields, and touch the Submit button when you are finished; you will be taken to the ticket view activity for the new ticket.
While viewing a ticket details, you can launch the editor by tapping the pencil icon in the action bar (if you are on Android Honeycomb or later) or pressing the menu button and touching Edit Ticket (if you are on Android Gingerbread or earlier).
There are three sections to the edit ticket form, just like the official Trac web interface—Add a comment, Action, and Change Properties. You should always enter a comment when editing the ticket. In addition, you may want to choose an action to move the ticket through its workflow. Refer to your Trac environment's usage guidelines when editing tickets. Touch the Submit button when you are finished editing the ticket to be returned to the ticket view activity.
Frequently Asked Questions
- The version of Android you are using
- The version of Tracoid you are using
- The version of the Trac environment to which you are connecting
- The version of the XML-RPC plugin installed in the Trac environment
- What you did to encounter the problem