【51CTO精選譯文】Android手機一般都內(nèi)置一個日程表(Calendar)應用。第三方應用程序可以利用日程表內(nèi)容提供程序的接口，實現(xiàn)閱讀用戶日程安排信息和在日程表中安排新事件。這個日程表應用可以直接與用戶的谷歌日程表應用實現(xiàn)內(nèi)容同步。

不幸的是，并沒有任何文檔來描述在Android上整合日程表應用，或者類似聯(lián)系人應用的其它應用。本文中的所有信息均來自于對谷歌日程表應用內(nèi)容提供程序的逆向工程。這個接口經(jīng)常發(fā)生變化，而且支持的功能有限。但是，對某些類型的應用程序來說，整合日程表應用可能是一個非常強大的功能。

本文中的代碼已經(jīng)在Android 2.0 SDK以前的版本上進行過測試。由于目前市場上沒有Android 2.0手機，我們還不能確保它可以運行在哪些即將發(fā)布的設備上。我們在T-Mobile G1(SDK 1.6)上測試運行了這些代碼。

訪問日程表數(shù)據(jù)

為了向你的Android應用添加日程表支持，你必須增加以下代碼到你應用程序的AndroidManifest.xml文件中：

<uses-permission 
  android:name="android.permission.READ_CALENDAR"> 
  </uses-permission> 
<uses-permission 
   android:name="android.permission.WRITE_CALENDAR"> 
   </uses-permission> 

登記這些許可后，你可以訪問用戶的日程表數(shù)據(jù)，而無需處理任何谷歌登錄問題。由于日程表應用沒有被安裝在Android模擬器中，因此所有測試和開發(fā)工作必須在安裝了日程表應用的真機上進行，使用模擬器無法啟動相應的提供程序。日程表應用和內(nèi)容提供程序被包含在支持谷歌服務的Android手機中，諸如T-Mobile G1。

檢索用戶日程表事件列表

每個用戶可能在日程表應用中具有眾多指定的日程安排。舉例來說，一個用戶可能同時擁有工作日程安排、個人日程安排和節(jié)日日程安排。

通過使用內(nèi)容提供程序接口，可實現(xiàn)訪問用戶配置的日程安排。為了取回用戶日程安排的事件列表，我們需要為日程表內(nèi)容提供程序編寫一個合適的Uri查詢，如下所示：

String[] projection = new String[] { "_id", "name" };  
Uri calendars = Uri.parse("content://calendar/calendars");  
       
Cursor managedCursor =  
  managedQuery(calendars, projection, null, null, null); 

現(xiàn)在，這個查詢將返回所有日程安排，其中包括那些未處于激活狀態(tài)的安排。為了只獲得活躍日程安排的列表，我們需要限制我們的查詢只返回“selected”字段值為真的記錄：

String[] projection = new String[] { "_id", "name" };  
Uri calendars = Uri.parse("content://calendar/calendars");  
       
Cursor managedCursor =  
   managedQuery(calendars, projection,  
   "selected=1", null, null);  
 

現(xiàn)在我們得到了一個日程表的列表。我們可以通過下面的代碼排列查詢結果：

if (managedCursor.moveToFirst()) {  
 String calName;   
 String calId;   
 int nameColumn = managedCursor.getColumnIndex("name");   
 int idColumn = managedCursor.getColumnIndex("_id");  
 do {  
    calName = managedCursor.getString(nameColumn);  
    calId = managedCursor.getString(idColumn);  
 } while (managedCursor.moveToNext());  
} 

一旦我們知道了希望訪問哪一個日程安排后，我們可以增加一個日程表事件。日程表事件有許多重要的字段，其中包括事件題目、時間和位置等信息，以及該事件條目在日程表中的顯示方式等。日程表事件可以是一次性或重復性發(fā)生的。

增加單次發(fā)生事件到日程表

要想增加條目到一個特定日程表，我們需要使用ContentValues配置一個日程表條目插入：

ContentValues event = new ContentValues(); 

每一個事件需要被指定到一個特定日程表，因此你需要首先通過日程表標識來實現(xiàn)插入這條事件：

event.put("calendar_id", calId); 

然后我們再設置該事件的基本信息，包括諸如事件題目、描述和位置等字符段。

event.put("title", "Event Title");  
event.put("description", "Event Desc");  
event.put("eventLocation", "Event Location"); 

另外還有許多不同的選項來配置事件的時間和日期。我們可以使用以下代碼設定事件的起始時間信息：

long startTime = START_TIME_MS;  
long endTime = END_TIME_MS;  
event.put("dtstart", startTime);  
event.put("dtend", endTime); 

如果我們需要添加一個生日或節(jié)假日，我們可以設置該條目為全天事件：

event.put("allDay", 1);   

對多數(shù)條目來說，這些信息已經(jīng)足夠。不過，還有許多其它有用的日程表條目屬性。舉例來說，你可以設置時間狀態(tài)為暫時性(值為0)、習慣性(值為1)或取消(值為2)：

event.put("eventStatus", 1); 

你還可以控制誰可以查看它，設定其可見性為默認(值為0)、機密(值為1)、私有(值為2)或公開(值為3)：

event.put("visibility", 0); 

你可以控制該事件是否觸發(fā)告警：

event.put("hasAlarm", 1);  

一旦日程表事件被正確配置后，我們就可以使用ContentResolver來插入這條新日程表安排到具有合適Uri的日程表事件中：

Uri eventsUri = Uri.parse("content://calendar/events");  
Uri url = getContentResolver().insert(eventsUri, event); 

#T#insert()方法的調用可以建立與程表內(nèi)容提供程序的聯(lián)系，并嘗試插入該條目到相應的用戶日程表中。如果你找到日程表應用并啟動它，你會看到你的日程表條目已經(jīng)在相應日程表中。如果你使用谷歌在線日程表服務，由于日程表應用具有自動同步功能，你也會看到該條目已經(jīng)出現(xiàn)于在線服務中。

增加一個重復發(fā)生事件到日程表

你還可以配置重發(fā)性日程表事件。你只需要按照重發(fā)性規(guī)則的形式為該事件增加幾個字段即可。該規(guī)則的詳細說明基于RFC2445。

Android應用能夠與許多Android手機用戶的日程表應用緊密配合。日程表功能需要通過內(nèi)容提供程序接口來訪問，這讓第三方應用程序可以閱讀日程表信息和增加新日程安排。

原文：Working with the Android Calendar  作者：Shane Conder