2010年10月25日 星期一

Android Component Lifecycles - Activity(一)

Android內幾種主要元件都有自己的生命週期,在其生命週期的每個階段,都有相對應的callBack method,也就是說當元件在進入該階段時,Android系統就會自動執行該階段的callBack。因此我們可以看到各種元件都會有一些內建的callBack method,如果我們希望在元件的某個階段去執行一些動作,你可以依照需要override認一階段的method

一.Activity的3種狀態(state)
1.active,running
    出現在螢幕的前景,也就是在目前task的activy堆疊的最上層,
    這Activity正被focus並接受使用者的動作
2.paused
    失去了focus,但使用者還是可以看到Activity,其他activity
    在其上方,也許是透明或沒有全螢幕覆蓋,因此paused的Activity
    還可以被看到,一個paused Activy還是在存活狀態(還保有所有資料,
    並被window manager所管理)但在系統記憶體過低時還是可能被砍掉
3.stopped
    當完全被其他的Activity所遮蔽,他是保有一些狀態資料,
    但已經看不到,他的視窗已經被隱藏,當系統記憶體過低會被砍掉

當系統記憶體過低,會將屬於paused與stopped狀態的Activity 砍掉,也就是呼叫其finish()或直接就砍了其process,當要再重新顯示在使用者面前,需要完全restart並restore之前的state 資料

二.Activity LifeCycle Method
當Activity由一個state轉到另一個state的過程中,以下幾個內部method會被自動觸發通知,所以我們若要在特定時間點執行特定動作需要override 相關protected method
protected    void onCreate(Bundle savedInstanceState) 
protected    void onStart() 
protected    void onRestart() 
protected    void onResume() 
protected    void onPause() 
protected    void onStop() 
protected    void onDestroy()

三.Activity 的幾個階段
每個Activity一定要Override onCreate()來作初始化功能,有的會需要override onPause()
去把資料改變記錄下來,以因應可能停止的動作
1.entire lifetime完整生命週期
    一個Activity由onCreate()開始,到最後onDestroy()結束,會在
    onCreate()時做所有初始化的動作,在onDestroy()內釋放所有的
    系統資源。
    例如有一個Thread在背景進行網路資料下載,這thread會在onCreat()
    程序內產生,而在onDestroy()停止這thread
2.visible lifetime
    由呼叫onStart()開始到 onStop()結束,在這過程使用者可以看到
    Activity在螢幕上,在這期間使用者可以看到元件顯示在畫面上,
    但不見得在前景或與使用者互動。
    例如你可以在onStart註冊一個BroadcastReceiver,而在onStop()
    中解除註冊,利用BroadcastReceiver監看UI上的變化,這樣就可
    以觀察到相關的變化,在Activity運作上,onStart()與onStop()
    在進行中可以被多次呼叫
3.foreground lifetime
    由呼叫onResume()到onPause()間,在這區間,Activity在前景,並可
    與使用者互動。Activity經常在這兩個狀態間跳動。    
    例如當Device進入睡眠狀態或另一個Activty要開啟,就會呼叫
    onPause(),而當activity繼續執行,或一個新的intent被發送出來
    Activity內的onResume()就會被呼叫執行

四.Activity LifeCycle Method狀態說明
1.onCreate()
    當activity第一次被產生後,會被執行。
    你可以在這程序內create View,bind data與list,
    在這method被執行時會接收到一個Bundle物件,
    這物件包含了Activity之前的state資料
    
    接下來會執行的有onStart()
2.onRestart()
    當Activity被停止後,又重新啟動時執行(與onStart同)
    接下來會執行的有onStart()
3.onStart()
    在Activity要變成Visible前執行
    
    如果接下來要把Activity顯示在前景,則伴隨著onResume()
    如果接下來要把Activity隱藏,則伴隨著onStop()    
4.onResume()
    在Activity開始與使用者互動前被呼叫
    在這點Activity是在Activity堆疊的最頂端
    
    接下來的會是onPause()
5.onPause()
    當系統要啟動其他Activity,這程序會被呼叫,
    在這程序中需要去處理,把尚未儲存的資料儲存下來,
    停止動畫與其他會消耗CPU的動作,這過程需要非常快速,
    因為下一個Activity會等他return才會執行
    
    若接下來這Activity要回到前景,接下來的會是onResume()
    若接下來這Activity要變隱藏,則接下來會是onStop()
6.onStop()
    當Activity不再讓使用者看到時呼叫
    可能發生在這Activity準備要destroy或是其他的Activity
    回復到前景
    
    假使這Activity要回到前景,接下來會是onResume()
    假若這Activity要整個關閉,接下來會是onDestroy()
7.onDestroy()
    當Activity被Destroyed前被呼叫
    這會是這Activity最後一個接收到通知,
    他可能發生在呼叫了finish()之後,或因為系統因為記憶體
    不足要節少空間而刪除,可以利用isFinishing()來判斷是
    什麼原因造成    

五.儲存Activity state
若要在Activity被關閉重開啟後,可以保留之前的狀態,
可以實做onSaveInstanceState()把資料存下來,儲存到Bundle物件上
而在重啟後讀出來
其相關順序為
onSaveInstanceState()->onPause()
onStart()->onRestoreInstanceState() 
在這過程中只儲存過渡性的資料,不要儲存固定的資料,因為onSaveInstanceState並非會一直被執行到

Monday - God Is an Astronaut

星期一的早上
天氣是舒服的秋涼
有太陽
上班的路上 也沒有太壅塞的車潮
辦公室裡 陽光溫暖 也明亮

一早的電話 帶來了幾許煩躁
打壞了原本的美好

打開音樂
用God Is an Astronaut來恢復平靜

2010年10月21日 星期四

AndroidManifest 設定檔- 基本概念

一.說明
在每個Android Application內一定會在Project根目錄下配置一個AndroidManifest.xml檔案
這檔案提供以下幾個作用
1.設定這個Application的Java Package Name
  也就是設定一個Java Package路徑用來代表這個Application        
2.設定組成這App的所有元件
  包括Activity,Service,ContentProvider,BroadCast Receiver等,
  開發好的元件都需要註冊在這Manifest檔案內,如果沒註冊在這裡,
  元件無法被使用。除了註冊元件,並利用Intent Filter讓Android
  知道在什麼狀況可以啟動哪個元件        
3.決定哪些程序將可以控制元件
4.宣告了App需要有哪些權限去取得被保護的資料或執行其他App的元件功能      
5.宣告了本App允許讓其他App互動的權限    
6.提供執行中Instrumention Classes清單與相關資料
  這些資料只有開發階段會存在,發布後會被移除
7.宣告了這App執行所要求的最低Android API版本        
8.設定這App需要連結的API Libraries
    除了預設使用Android API外,可以利用設定<uses-library>
    使用其他package的元件功能API
二.語法原則
1.element
1.<manifest> and <application>只能出現一次,其他的都可以出現多次
2.<activity>, <provider>與<service> 可以沒有順序性的出現在任何
  地方,但<activity-alias>一定要跟在<activity>後面
2.attribute
所有的屬性都是非必填的選項,除了manifest外,所有元素的屬性一定都是以android:命名
3.Class name
在Manifest內,多數的元素都直接對應到Java Class,包括application本身
如activities (activity), services (service), broadcast receivers (receiver)
與content providers (provider)


如果要在Manifest內加入這幾個class的subclass,subclass,則在name屬性上,
輸入完整的Class名稱(包括package name)
例 加入一個繼承自Service的subClass SecretService
 <manifest . . . >  
      <application . . . >  
           <service android:name="com.example.project.SecretService" . . . >  
                . . .  
           </service>  
           . . .  
      </application>  
 </manifest>  

如果這subClass是在這Application的package下,則在name屬性上
只要用.ClassName方式設定即可,系統看到.name會自動將Ap的package 加上去
例
 <manifest package="com.example.project" . . . >  
      <application . . . >  
           <service android:name=".SecretService" . . . >  
                . . .  
           </service>  
           . . .  
      </application>  
 </manifest>  

當要啟動這元件時,若這subClass存在,系統會產生這subclass(範例是SecretService)的instance使用,
若subclass不存在,則會產生其base class(範例是Service)的instance
4.Multiple values
若一個項目可以有多個值存在,會用多個tag repeat,而不會在一個tag寫入多個值
例
 <intent-filter . . . >  
      <action android:name="android.intent.action.EDIT" />  
      <action android:name="android.intent.action.INSERT" />  
      <action android:name="android.intent.action.DELETE" />  
      . . .  
 </intent-filter>  
5.resource value
會需要用到resource 當作屬性值時會以
[package:]type:name表示
若是來自於style theme的值則會是
?[package:]type:name
6.String values
當屬性值為字串會用到\\當跳脫字元,例\\n 換行

三.幾項元素功能作用
1.Intent Filters
在manifest內,主要的幾個元件如Activity Service...等利用Intent Filter設定對intent的處理能力
也就是說,用Intent Filter描述他可以處理那些intent,在一個元件可以是可以同時設定多組的intent filter。
Android系統在收到intent後可以依此決定要啟動哪個元件來處理intent需求

2.Icons and Labels
許多元素都有icon與label顯示小圖與文字在使用介面上,有的會有description 放比較多的說明文字。
例如在permission上,這三個屬性都有,當Application對系統要求取得權限時,依照提供的permission設定
就可以把這3個屬性的資料顯示在介面上

如果在上層的container上設定icon與label,那麼其子元素的icon與label都會以上層設定
當作預設值

3.Permissions
用來設定去存取Device資料,啟動其他App的元件或是本身元件被其他App使用的權限設定
一個Appication可以用permission保護其元件,所有的Permission都被定義在
android.Manifest.permission Class內,也可以自行定義自己的Permission

例
 <manifest . . . >  
      <permission android:name="com.example.project.DEBIT_ACCT" . . . />  
      . . .  
      <application . . .>  
           <activity android:name="com.example.project.FreneticActivity"  
                      android:permission="com.example.project.DEBIT_ACCT"  
                      . . . >  
                . . .  
           </activity>  
      </application>  
      . . .  
      <uses-permission android:name="com.example.project.DEBIT_ACCT" />  
      . . .  
 </manifest>  
以上除了定義permission外還要宣告uses-permission讓其他App可以使用這個元件
<permission-tree>:定義一個permissions group的namespace
<permission-group> :定義一組permission的label,純粹只是定義一個名稱
<permission>:若要定義屬於哪個group,則在group屬性設定
     <permission-group>設定的名稱即可

4.Libraries
每個Application預設連結到Android Library,如果要使用其他Library的package
則需要用uses-library宣告

Android Intent Filter-判斷intent傳遞對象

一.Intent接收原理
當使用者發送一個intent出來,要求元件去執行動作,如果這個intent裡有很清楚的設定了ComponentName,那麼intent就會直接被送到指定的元件,並啟動該元件,如果沒有設定,則會由Android系統自動去判斷該把這intent送到哪個元件上啟動他。

大多數在本身專案內元件可以處理的動作,intent通常都會直接指明要給哪個元件處理,如果沒有指定元件名稱的intent大多是用來啟動其他Application上的元件

二.Intent Filter的作用
Android系統如何判斷哪個元件可以接收哪個intent,就是依靠在ManiFest檔案內,宣告元件(Activity,Service)時所加入的Intent Filter設定,每個Activity內可以設定0~多組的intent filter,每一組的Intent Filter都是一份比對規則

當intent發出來時,系統會去檢查Manifest內各元件內的intent filter,而啟動適合的元件,若元件沒有設定filter,那就只能接收到有清楚指定component的intent

三.Intent Filter
Intent filter內會設定的資料包括action,data與category三種。也就是說filter只會與intent裡的這三種資料做比對動作,而在每個filter內可以同時存在著多個data action與category

雖然每個Intent Filter都屬於IntentFilter類別,但因Android系統在元件啟動錢就必需測試其相容性,所以Intent Filter都是以XML方式寫在AndroidManifest.xml檔內,而不以Java Code去產生。唯一的例外是broadcast receivers的intent filter可以透過Context.registerReceiver()來動態設定
例
Context.registerReceiver(BroadcastReceiver receiver, IntentFilter filter)
在註冊時,把filter動態加入

Intent Filter內要設定的值,包括action,data與category都定義在Intent Class內,也就是說在Intent物件內設定這3種資料的值與Intent Filter內要設定這3種資料的值都定義在Intent Class內,在JavaCode裡,可以透過Class引用參數,但在Manifest內設定,需要設定字串值,就要去查Class內參數實體的字串值

例:Manifest.xml設定filter
 <intent-filter . . . >  
      <category android:name="android.intent.category.DEFAULT" />  
      <category android:name="android.intent.category.BROWSABLE" />  
      . . .  
 </intent-filter>  

JavaCode設定intent Object的Category
intent.setCategory(Intent.CATEGORY_DEFAULT);

四.Intent Test 找到要接收intent的元件
當intent發出來時,會與元件在Manifest內所定義的intent filter做比對,比對時需進行3個test,當這3個test都通過時,才會確認這元件可以接手處理這Intent。若同時有不只一個的Activity或Service通過Test,那系統會問你要啟動哪一個,若都不符合,則會發生錯誤

五.Intent Test-Action Test
1.當一個intent object若沒有指定Action,則這項pass
2.filter內至少要有一項action,若都沒有就沒有任何intent
  可以通過這filter

例
 <intent-filter . . . >  
  <action android:name="com.example.project.SHOW_CURRENT" />  
  <action android:name="com.example.project.SHOW_RECENT" />            
      . . .  
 </intent-filter>  

六.Intent Test-Category Test
1.若intent有設定Category,必須intent object可以通過所有filter設定
  的Category,Test才會pass
2.若intent沒有設定Category,則設定pass
3.當執行startActivity()而使用沒有明確設定目標的intent,都會當作他
  至少會有一個Category: Intent.CATEGORY_DEFAULT
  (也就是"android.intent.category.DEFAULT")    

因此若Activity要能夠接收到這intent,則在Mainfest內定義這Activity的intent filter部份需要有Category為"android.intent.category.DEFAULT"的值,才會有可能接收到,也就是說在Manifest內的Activity,至少要有Intent.CATEGORY_DEFAUL(也就是"android.intent.category.DEFAULT")的值,而在已經設定為啟動的Activity內多設定Intent.CATEGORY_DEFAUL,也可以但並無用處

在filter內設定category值,需設定完整字串值,這部份查Intent Class,因為在xml tag接受的值是字串,而在Java Code內設定intent的Category就可以用Class的常數去書寫

七.Intent Test-Data Test
每個data tag都包含了URI與data type (MIME media type)
而URI會以scheme, host, port,與 path來表示
也就是可以把一個完整的URI看成
scheme://host:port/path
若host沒指定,則port可略
data type可以用*代表允許任何型態的資料
如text/*" or "audio/*"
例
URI為
content://com.example.project:200/folder/subfolder/etc

則設定Filter的寫法為
 <intent-filter . . . >  
      <data android:mimeType="video/mpeg" android:scheme="content" android:host="com.example.project" android:port="200" android:path="folder/subfolder/etc"/>   
      <data android:mimeType="audio/mpeg" android:scheme="http" . . . />  
      . . .  
 </intent-filter>  

data在filter與intent內data比對的原則是
1.當filter內沒有設定任何data tag,而intent內也沒有設定URI與data type,
  那這test就通過
2.當filter有設定URI,沒有設定data type,而intent object也是只有URI沒有
  data type,這時候通過,這通常只會發生在mailto: 與tel: 時
3.當filter內只有設定data type 沒有設定URI,而intent object有設定相同
  的data type無URI則通過
4.當filter內設定的data type與URI都與intent Object內設定的對應即通過
  若filter內只有設定data type而URI不設定,只有在intent Object內的
  data type有對應,而URI為content: 或file:才會通過

八.Example
1.設定元件可以顯示local端 任何Image檔案
 <data android:mimeType="image/*" />  
當要由local contentProvider顯示檔案,這樣寫即可,不需再指定URI部份用content:或file:
2.設定允許播放來自internet的任何影片檔
 <data android:scheme="http" android:type="video/*" />  
當使用者透過web page連結要開啟一個資源,會先使用html page開啟看看,若不行,則會與未指定對象
的intent一樣,去查找哪一個Activity適合去開啟這個資源,若不知道,則會開啟Download Manager去下載
3.設定啟動預設執行的Activity
 <intent-filter . . . >  
      <action android:name="code android.intent.action.MAIN" />  
      <category android:name="code android.intent.category.LAUNCHER" />  
 </intent-filter>  
不需透過任何intent去觸發,在開啟App即會自動執行這個Activity

九.Intent與Intent Filter
Intent Filter的作用,不僅是找出intent所要啟動的元件,還包括了設定元件該出現在Device的相關訊息
例如在Filter內設定了
"android.intent.action.MAIN"與"android.intent.category.LAUNCHER"
這元件會出現在device最上層的Launch清單上

若元件的filter設定了android.intent.category.HOME"
那這元件就會顯示在Home screen上

利用PackageManager Class的相關method針對指定intent找出適合的元件
透過query..() method可以讓你找到可以接收指定intent的component
透過resolve..()可以找到最適合接收指定intent的component
例如queryIntentActivities()可以取得所有適合的Activity清單

2010年10月20日 星期三

Android Intent物件

一.說明
在Android內三個核心元件activities, services, and broadcast receivers,都是靠Intents傳遞訊息來啟動

1.啟動Activity
透過將intent放到 Context.startActivity(intent) 或 Activity.startActivityForResult(intent)內來啟動Activity,或取得一個已存在的Activity去執行。另外可透過Activity.setResult(resultCode,intent)取得由呼叫Activity.startActivityForResult()所回傳的資訊

2.啟動Service
透過放intent到Context.startService(intent),去初始化啟動一個Service,亦可將intent傳給Context.bindService(intent),建立元件與service的連線。

3.發布給Broadcast Receivers
將intent物件傳給任何broadcast methods,可以發布給所有有興趣的broadcast receivers,例如Context.sendBroadcast(), Context.sendOrderedBroadcast(), or Context.sendStickyBroadcast()

當有intent被發出時(以上3種方式),Android會找到適合的物件回應這intent,也就是說屬於broadcast的不會去處發到service,而透過startActivity()傳遞的intent只會被Activity接收到

二.Intent Object
intent物件是一個資訊包,他包括了要接收到這intent的元件所會有興趣的資料,如要執行哪些動作,要用到哪些資料
與Android系統所會有興趣的資料,如哪些類別的元件要來接收這intent,與要如何去啟動目標的Activity
一個Intent物件包含以下資訊

1.Component name:ComponentName Class,非必填
指定需要去處理這個intent的Component,這欄位資料為ComponentName 類別,包括這元件的完整class名稱(如com.oz.)與註冊在manifest內的Applcation package name,可利用 setComponent(), setClass(), or setClassName()寫入,用getComponent()讀取
例
ComponentName cn=intent.getComponent();
cn.getClassName()

2.Action:String,非必填
指定這intent要執行的動作,在Intent Class內已經定義好幾個const代表要執行的動作
如
ACTION_CALL:初始化phone call
ACTION_EDIT:顯示資料讓使用者編輯
可透過setAction() 設定,利用getAction()讀取,若要使用自己定義的Action sring,使用時需加完整的package路徑
如"com.example.project.SHOW_COLOR"

3.Data:,非必填
包含資料的URI與資料的MIME type,不同的Action會需要不同的data type,譬如說
當action是設定Action_EDIT,data欄位會是需要要編輯的文件URI
當action是設定ACTION_CALL,data欄位將會是一個 tel:電話號碼的URI
當action是設定ACTION_VIEW,data欄位會是http:的URI
接收到的Activity就會去下載顯示這URI

當Activity去處理這些data時,會需要知道他的MIME Type才知道要如何處理
譬如說image檔案就不會有play功能出現

大多數都能由URI去猜測data type,譬如說,content: 的URI,資料會是在device上,可利用setData() setType() setDataAndType()來設定,而利用getData() and the type by getType()來讀取

4.Category: string Set,非必填
設定那一類型的元件可以去處理這個intent,在一個intent內可以放多個Category
以下已經預定的常數為
1.CATEGORY_BROWSABLE:target Activity可以被browswer開啟,
  如email或image
2.CATEGORY_GADGET:這Activity可以嵌在這GADGET的另一個
  Activity內
3.CATEGORY_HOME:Activity會顯示在使用者開啟device的第
  一個畫面,也就是Home按鈕開啟的畫面上
4.CATEGORY_LAUNCHER:Activity會被列在最上層的launcher上
5.CATEGORY_PREFERENCE:target Activity是preference panel
  也就是屬於preference panel才能處理接收這intent 

透過addCategory()加入,透過removeCategory()移除,透過getCategories()取得SET

5.Extras:Bundle類別,非必填
intent要傳遞給元件的其他資訊,會以Key-value pairs型態存在,有一些intent個別會有一些特別的extra資料存在
例如
ACTION_TIMEZONE_CHANGED 會有一個extra 'time-zone',值是最新的time zone
ACTION_HEADSET_PLUG有 'state' 值為"plugged"或"unplugged"
SHOW_COLOR 會有'color' 值為色碼值
可透過一系列的putXXXExtra()設定,getXXXExtra()取得
或用putExtra(Bundle)設定 getExtra()設定取得

在intent裡加入Extra有很多方式
可以先產生一個Bundle物件,把所有要加入的值都放到Bundle內
再利用intent.putExtra(bundle)放進去
也可以利用intent.putExtra(string key,string value)加入
putExtra可以呼叫多次,所有加入的值都會被累加到extra物件上
不管加入多少,都可以透過
如 intent.getExtras().getString(stringKey)方式取得資料

6.Flags:String,非必填
通知Android系統如何去啟動這Activity,例如要把這Activity加入到哪個Task內(或是啟動一個新的Task)在Intent Class內已經建好這些相關常數