c42dd42676 | 14 years ago | |
---|---|---|
art | 14 years ago | |
astrid | 14 years ago | |
bin | 14 years ago | |
docs | 15 years ago | |
samples/filters | 14 years ago | |
tests | 14 years ago | |
translations | 14 years ago | |
.gitignore | 14 years ago | |
LICENSE | 15 years ago | |
OVERVIEW | 14 years ago | |
README.md | 14 years ago | |
build.xml | 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
-
Create your own fork of Astrid and astridApi by clicking on Github's Fork button above, and the same button in the astridApi project (you may have to log in first - github help).
-
Install the following: • git • Eclipse (preferred: Eclipse IDE for Java Developers) • Android SDK • ADT Plugin for Eclipse
-
Use git to clone your forked repositories
git clone git@github.com:yourgithubid/astrid.git
git clone git@github.com:yourgithubid/astridApi.git
(see Github's instructions if you need help). Follow the Github Line Ending Help
- Open up eclipse and import the astrid, astridApi, and astrid-tests projects. There should be no compilation errors. If there are, check the Android page of Eclipse Project Properties to verify the astridApi project was found. You might have to clean the projects from within eclipse
from Eclipse: project-menu -> clean -> select projects -> check "start a build immediately" if "automatic build" is not enabled
-
Launch the astrid project as an Android Application, or the astrid-tests project as an Android JUnit Test Suite.
-
Join the Astrid Power-Users List.
-
Check out the Product Roadmap and Issues, and look for something you'd want to tackle.
-
Follow the following contributors workflow and help make Astrid better!
-
Sign a Contributors License Agreement and send it to astrid AT todoroo.com
Testing on a device - debugging
If you have trouble running Astrid on your device, it is recommended to:
- Fully uninstall Astrid from the device: adb uninstall com.timsu.astrid
- Restart Eclipse
Contributors workflow
Setup:
git clone git@github.com:yourgithubid/astrid.git
git clone git@github.com:yourgithub/astridApi.git
git remote add upstream git://github.com/todoroo/astrid.git
git remote add upstream git://github.com/todoroo/astridApi.git
Working on new features/fixes:
git checkout -b my-new-features
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 my-new-features
then go to github and submit a pull request!
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