Mirror of Tasks App for Android
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Go to file
Ian Fraser 24e4582b8a Add missing %s to cz translation, fix one failure in
testFormatStringsMatch
14 years ago
api Add missing %s to cz translation, fix one failure in 14 years ago
art Initial big widget commit 14 years ago
astrid Using apache lang unescapeHTML instead of the random one i found on the net. Better license and more trusted code. 14 years ago
bin Exported .xml files to .po and .pot files for launchpad 14 years ago
docs Added CLA pdf 15 years ago
facebook Adding facebook classpath and project so it can be imported into Eclipse 14 years ago
greendroid Fix CRLF for some Greendroid-files 14 years ago
samples/filters Updated configuration for Astrid to use subtree projects for Android libraries 14 years ago
tests Added eclipse code formatting and organizing preferences to Astrid, test, and API projects 14 years ago
translations Exported .xml files to .po and .pot files for launchpad 14 years ago
.gitignore fix for ant deleting our src folders 14 years ago
LICENSE Added GPLv2 License 15 years ago
OVERVIEW Added starter overview file 14 years ago
README.md Fixed instructions 14 years ago
build.xml renamed the release target to release-all since it does more than just building one version of Astrid 14 years ago

README.md

Astrid - Task Management Done Right

Astrid strives to be a simple and effective organization tool for Google Android phones. It comes with features like reminders, tagging, widgets, and integration with online synchronization services.

Interested in using Astrid? Search "astrid" in Android Market. Look for the smiling pink squid!

If you would like to help out with the Astrid project, you're in the right place.

Getting Started With Development

  1. Create your own fork of Astrid by clicking on Github's Fork button above (you may have to log in first - github help).

  2. Install the following: • gitEclipse (preferred: Eclipse IDE for Java Developers) • Android SDK (last tested with SDK v8) • ADT Plugin for Eclipse (SDK Tools 8, Platform-tools 1, SDK Platform Android 2.3, 2.2, and 1.6)

  3. Use git to clone your forked repositories

git clone git@github.com:yourgithubid/astrid.git

(see Github's instructions if you need help). Follow the Github Line Ending Help

  1. Open up eclipse and import the astrid, astridApi, astrid-tests, facebook, and GreenDroid projects.

  2. In Eclipse preferences -> Android build settings, set the SDK location (you installed it in step 2). At this point, there should be no compilation errors. If there are, you might have to refresh and clean the projects a few times from within eclipse

from Eclipse: project-menu -> clean -> select projects -> check "start a build immediately" if "automatic build" is not enabled

  1. Launch the astrid project as an Android Application, or the astrid-tests project as an Android JUnit Test Suite.

  2. Join the Astrid Power-Users List.

  3. Check out the Product Roadmap and Issues, and look for something you'd want to tackle.

  4. Read the following contributor and debugging workflow and help make Astrid better!

  5. Sign a Contributors License Agreement and send it to astrid AT todoroo.com

Testing on a device - Debugging

How to debug/test on a USB device: (JoshuaGross Jan 14, 2011)

  1. Plug in your device and make sure you can see it by running adb devices

  2. If you cannot see the device, or want to restart debugging, do:

adb kill-server

adb usb

adb devices (make sure your device is listed)

adb uninstall com.todoroo.astrid.tests (you should see "Failure" if this was uninstalled already)

adb uninstall com.todoroo.astrid (you should see "Failure" if this was uninstalled already)

  1. If you have not already, set up Run configurations in Eclipse; either under the "Run" or "Debug" menus. To test the application, set up "Android Application". To run JUnit tests, set up "Android JUnit Tests". Settings should autofill for you, you should be able to open a new configuration and run it. If you run it in debug mode, see #2 above for getting adb to work in case it is finicky.

  2. When running unit tests: make sure to close all JUnit windows before running tests. JUnit/Eclipse/Android work together in a very, very janky way. You may get incorrect results if you do not close the window out before running tests. You have been warned.

  3. Make sure to commit changes both to the "astrid" project while developing.

Contributors workflow

Setup:

git clone git@github.com:your-github-id/astrid.git (your-github-id should obviously be replaced)

git remote add upstream git://github.com/todoroo/astrid.git

Working on new features/fixes:

git checkout -b my-new-features upstream/master

work, work, work!

git commit (a separate commit for each bug fix, feature change, style or copy edit please!)

git fetch upstream

git rebase -i upstream/master (i like to rebase -i to verify what i'm committing and squish small commits)

git push origin HEAD

then go to github and submit a pull request!

For further information, read Tim's Collaborator Guide.

Contact

For support requests, use the Astrid issue tracker. For development questions, contact timsu via e-mail.

Astrid also has an IRC channel, irc.freenode.net #astrid