[TIMOB-1406] Android: Contacts module support

(from [908fecedab54416e3f1492c7acf92320837d22e6]) [#1406] Initial commit of Contacts support. http://github.com/appcelerator/titanium_mobile/commit/908fecedab54416e3f1492c7acf92320837d22e6"> http://github.com/appcelerator/titanium_mobile/commit/908fecedab544...

(from [3065f711eb4f4d62c3af16c53486299b6c3185db]) [#1406] Begin KitchenSink contacts support. Not working yet -- hold tight. http://github.com/appcelerator/titanium_mobile/commit/3065f711eb4f4d62c3af16c53486299b6c3185db"> http://github.com/appcelerator/titanium_mobile/commit/3065f711eb4f4...

(from [261fd73c6a2adbda08371106cdb99c66edef55fa]) [#1406] Fix click event in 'Display People' KS contacts test. Read-only KitchenSink android contacts tests are now enabled. http://github.com/appcelerator/titanium_mobile/commit/261fd73c6a2adbda08371106cdb99c66edef55fa"> http://github.com/appcelerator/titanium_mobile/commit/261fd73c6a2ad...

Read-only, person-oriented (not group-oriented) parts of our http://developer.appcelerator.com/apidoc/mobile/latest/Titanium.Contacts-module"> Contacts API are now available in Android in the builds on our http://developer.appcelerator.com/doc/mobile/get_continuous_builds"> continuous integration server. This means the following are supported:

   getAllPeople();
   getPeopleWithName();
   getPersonByID();
   showContacts();
   

For those who are familiar with Android SDK:

Because Titanium is compiled against Android API level 4 (1.6), we're forced to use Android's http://developer.android.com/reference/android/provider/Contacts.html"> "old" Contacts API. This has a lot of limitations, one example being that there is no structured version of the name -- it's just "http://developer.android.com/reference/android/provider/Contacts.PeopleColumns.html">name", not first name, last name, etc. So you can only read our .fullName property to get the name. There's also no notion of a structured address, so we dump everything in .street.

(from [a01b1f593444f8bc2fed29aea26babf7eb4f0bd1]) [#1406] Oops, forgot to add the contacts module to the ant build. Our continous build server should now have an SDK that includes Contacts within about 30 mins of this commit. http://github.com/appcelerator/titanium_mobile/commit/a01b1f593444f8bc2fed29aea26babf7eb4f0bd1"> http://github.com/appcelerator/titanium_mobile/commit/a01b1f593444f...

(from [7142a2d040fc34715c8fb059518a2cfb77a24cb6]) [#1406] Add .image support to Person. Enable 'Contact images' KS test http://github.com/appcelerator/titanium_mobile/commit/7142a2d040fc34715c8fb059518a2cfb77a24cb6"> http://github.com/appcelerator/titanium_mobile/commit/7142a2d040fc3...

(from [443922ce470c76a044becd1da75164515016dce3]) [#1406] Significantly improve performance of getAllPeople() http://github.com/appcelerator/titanium_mobile/commit/443922ce470c76a044becd1da75164515016dce3"> http://github.com/appcelerator/titanium_mobile/commit/443922ce470c7...

(from [c02192e1baa2f7fd6bf83f7ded58ff03043d3106]) [#1406] Get the .image property to return null quickly if no image is available. Saves a lot of time, for example, if you're looping through all of your contacts calling .image on each one of them, which can be very expensive. http://github.com/appcelerator/titanium_mobile/commit/c02192e1baa2f7fd6bf83f7ded58ff03043d3106"> http://github.com/appcelerator/titanium_mobile/commit/c02192e1baa2f...

Closing in favor of ...

#1894 - support read-write contacts in android

#1895 - support structured contact names in android

#1898 - support structured postal addresses in android