Overview

Tracoid

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.

Installing Tracoid

Tracoid is not currently available in the Google Play Store. You can, however, install it directly using an Android Package (APK) file, available from the Downloads section of the BitBucket Project.

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):

  1. From the Home Screen, touch the Launcher icon
  2. Touch Settings
  3. Touch Applications
  4. Check "Unknown sources"

For Android 4.0 (Ice Cream Sandwich) and 4.1/4.2 (Jelly Bean):

  1. From the Home Screen, touch the Circle (app launcher)
  2. Touch Settings
  3. Touch Security
  4. 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.

Using 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.

Viewing Tickets

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.

Editing Tickets

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

Q: Why is Tracoid not available in the Google Play Store?
A: Tracoid is still under development and is currently in an "alpha" stage. There is a lot of functionality missing that needs to be implemented, and there may be bugs or other problems. When Tracoid is more complete and stable, it will be available on the Google Play Store
Q: When adding a new server that uses HTTPS, I receive the error message "Unable to read server response: No peer certificate"
A: Your Trac environment is published usin HTTPS with an invalid security certificate. This may be because the certificate has expired or is not yet valid, the name listed in the certificate does not match the name of the server, or the certificate was not signed by a recognized certificate authority. Contact your Trac environment's administrator for assistance.
Q: When I do something, Tracoid closes
A: You've probably encountered a bug in Tracoid. Please visit the Issues section of the BitBucket Project to see if the issue has already been reported. If it has not, please report it so it can be resolved quickly. When reporting issues, please make sure you specify the following information:
  • 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