My favorites | Sign in
Project Home Downloads Wiki Issues Source
Search
for
AndroidManifest  
定義 Android 清單
tw, AndroidManifest
Updated Apr 19, 2011 by gasolin

初見 Intent一章中,我們已嘗試過使用 「startActivity」函式,傳入適當的「Intent」,來呼叫瀏覽器的 Activity。

到目前為止,我們可以由學習 Android 應用程式的經驗中歸納得出:所有 Android 程式的運作流程,都定義在 Activity 中。

Android 系統與其他系統很不一樣的地方是:它的應用程式並不直接與底層系統緊密結合,而是跑在 Android 框架中。這意思是設計 Android 應用程式時,我們並不需要關心實際上運作的機器是哪一牌的手機或是哪一種嵌入式系統,或使用哪一種架構(ARM、x86、MIPS)。我們要關心的只有Android 框架提供了那些功能,好讓我們能操作這台設備。具體來說就是我們只要知道這台機器的螢幕大小、有沒有鍵盤,有沒有支援 GPS 等等訊息,就知道我們寫的應用程式是否能在這台機器上順暢地運作。Android 框架與底層系統的整合的問題完全可以留給軔體工程師來操心。

在執行「startActivity」函式時,應用程式並不是直接呼叫另一個 Activity,而是將「Intent」(意圖)傳進 Android 框架中。 Android 框架會查看 「startActivity」 呼叫所傳入的動作與 Intent 內容是否在註冊表中,如果符合,就啟動對應的服務或 Activity。

Android 系統中的每一個應用程式,在安裝的過程裡,都得事先在 Android 框架中註冊、登記這個應用程式所建立的 Activity,並事先註明會使用到的服務。譬如當我們在 Android 上安裝我們撰寫的 BMI 應用程式時,BMI 應用程式就會向 Android 框架登記相關資訊:BMI 應用程式將會用到 「Bmi」這個 Activity。

這份訊息存在於每個 Android 應用程式專案根目錄下的「AndroidManifest.xml」檔案中。如果我們在程式裡,要用到其他應用程式或服務所提供的功能,也需一併在此列出。

在安裝應用程式的時候,Android 框架會根據應用程式提供的這份清單,將資訊註冊於 Android 框架的註冊表中。

備註:

這麼說其實是不太精確的。Android 應用程式的運作流程,存在於四種載體中:
  1. Activity (活動)
  2. Broadcast Intent Receiver
  3. Service
  4. Content Provider

各種載體的相關內容會在後續章節提到時作解說。

預設的 Activity 清單

我們使用 eclipse Android 開發工具打開「BMI/AndroidManifest.xml」檔案。切換到「AndroidManifest.xml」分頁標籤,查看預設的 「BMI/AndroidManifest.xml」檔案原始碼:

1  <?xml version="1.0" encoding="utf-8"?>
2  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
3      package="com.demo.android.bmi"
4      android:versionCode="1"
5      android:versionName="1.0">
6      <application android:icon="@drawable/icon">
7          <activity android:name=".Bmi" android:label="@string/app_name">
8              <intent-filter>
9                  <action android:name="android.intent.action.MAIN" />
10                 <category android:name="android.intent.category.LAUNCHER" />
11            </intent-filter>
12          </activity>
13     </application>
14     <uses-sdk android:minSdkVersion="X" />
15 </manifest>

我們分行講解如下:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    ....>
    ....
</manifest>

AndroidManifest.xml」這個檔案也是以 XML 格式描述,每個 Android 應用程式都需要一個「AndroidManifest.xml」檔案,每份「AndroidManifest.xml」檔案的開頭都會出現這段敘述。而整個「AndroidManifest.xml」檔案的敘述,都包含在「manifest」(清單)這個主要標籤中。

package="com.demo.android.bmi"

「package」 是「manifest」(清單)標籤的一個特別屬性,範例中的內容可用來標明,這個應用程式的進入點存在於「com.demo.android.bmi」這個名稱空間/路徑中。

android:versionCode="1"
android:versionName="1.0"

「android:versionCode」和「android:versionName」是應用程式版本號。 這兩個屬性是可選的(非必要)。 「android:versionName」是給使用者看的版本號,如「1.0」、「2.0」。「android:versionCode」則是開發者用的內部版本號,一般使用流水號。

<application android:icon="@drawable/icon" android:label="@string/app_name">
...
</application>

「manifest」標籤中主要包含一個「application」標籤(備註1)。「application」標籤裡面,定義了所有這個應用程式用到的 Activity、服務等資訊。「application」標籤中的「android:icon」屬性,定義了這個應用程式將顯示在 Android 主畫面中的應用程式圖示。「android:icon="@drawable/icon"」表示應用程式圖示的資源檔存在於 「res/drawable/icon」 中。圖示的大小必須超過 64x64 像素(Pixel)。「application」標籤中的「android:label」屬性可用來指定應用程式將顯示在 Home 主畫面上的名稱。也就是預設剛開好機時,可以從桌面下方拉出的應用程式列表。

<activity android:name=".Bmi" android:label="@string/app_name">
...
</activity>

「application」標籤中所有用到的 Activity ,都要包含在一個個「activity」標籤中(備註2)。 Activity 是 Android 應用程式與使用者互動的主要元素,當使用者開啟一個應用程式,第一個看到的畫面就是一個 Activity。若是一個應用程式中包含多個畫面時,會定義多個不同的 Activity,我們也必須在「application」標籤中,使用多個「activity」標籤,為不同的 Activity 添加描述。如果我們已經在程式碼中定義好了 Activity ,卻忘了在「AndroidManifest.xml」檔案中加入對應的「activity」標籤,那麼在執行中呼叫到這個 Activity 的時候,將無法開啟這個 Activity。

「activity」標籤的「android:name」屬性,指出了這個 Activity 所對應的類別(class)。「activity」標籤中的「android:label」屬性可用來指定應用程式將顯示在 Activity 畫面上方的名稱。也可以在程式碼中透過「setTitle(“名稱”)」來動態修改。

因為在上一層「Manifest」標籤屬性中已經定義了「package="com.demo.android.bmi"」,因此在「activity」標籤的 「android:name」屬性中,「.Bmi」代表著「com.demo.android.bmi.Bmi」的簡寫。也可以寫成「Bmi」,一樣是代表「com.demo.android.bmi.Bmi」這個類別。

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>

「intent-filter」標籤定義了這個「activity」的性質。 「intent-filter」中主要包含了兩個標籤:「action」跟「category」標籤。 「action」標籤中的「android:name」屬性,其內容「android.intent.action.MAIN」表示:這個 Activity 是此應用程式的進入點(就像程式中常見的 main 主程式),開啟這個應用程式時,應先執行這個 Activity。 。常見的還有「android.intent.action.EDIT」等標籤,會在之後章節用上的時候講解。「category」標籤中的「android:name」屬性,其內容「android.intent.category.LAUNCHER」表示:這個 Activity 將顯示在 Launcher 的應用程式列表中。

我們把整個檔案合到一起看,可以總結出這個檔案所傳達的訊息:在「com.demo.android.bmi」路徑下的「Bmi.java」這個檔案中,已定義了一個主要的 Activity; 當我們打開 Android 的時候,顯示的是位於「res/drawable/icon」的圖示。一旦我們按下圖示來啟動這個應用程式,Android 應用程式框架會去尋找到定義了「android.intent.action.MAIN」內容的 「.Bmi」activity,並呼叫執行。

<uses-sdk android:minSdkVersion="X" />

Android SDK 1.1 版之後引入了這條敘述,「X」代表了目標版本代號。透過指定這個參數,系統可以依此辨別應用程式是否使用相容的 SDK 版本,好決定能否在這台機器上安裝執行。這也是一個可選填的選項。但如果我們的應用程式要發佈出去,一些強勢的通路如 Google Android Market 已規定所有新發佈的應用程式必須指定「android:minSdkVersion」這個參數。

各目標版本與代號對應表如下:

目標版本 代號
3.0 11
2.3.3 10
2.3 9
2.2 8
2.1 7
2.0.1 6
2.0 5
1.6 4
1.5 3
1.1 2
1.0 1

目前各版本佔有率可以參考官方的版本佔有率圖表: http://developer.android.com/resources/dashboard/platform-versions.html

這個圖表是根據最近 2 周間連上 Android Market 設備的比率來繪製。

備註1

除了「application」標籤外,還有「uses-permission」(例如允不允許存取SMS、能否存取聯絡簿、相機功能)、「permission」、「instrumentation」等主要標籤。相關的內容在後續章節用到時再一併解說。

備註2

除了「activity」標籤外,對應於 Android 應用程式的運作流程,還有「service」、「receiver」、「provider」等主要元件。相關內容會在後續章節提到時作解說。

參考資料

< 加入選單 | 回目錄 | 加入新 Activity >


對於本章,您還期望知道什麼樣的內容呢?請在下方提出建議!

Comment by lming2...@gmail.com, Sep 18, 2008

写的很好,很详细,希望能继续写下去!如果出书我一定买!

Comment by roji...@gmail.com, Sep 24, 2008

真的很好,我這樣的初學者看過後,原先很多不明白、模糊的地方都清楚了。 Thanks!

Comment by bdchina2...@gmail.com, Sep 26, 2008

非常好的中文android资料。

网上成体系的中文android程序设计资料很少看到,幸运的是找到的这个居然这么好这么详细。

Comment by suny2...@gmail.com, Feb 10, 2009

喜欢你的讲解风格,你是哲学家式的程序员,受益匪浅!

Comment by Brooke...@gmail.com, Feb 25, 2009

对于您写的这个教材,除了喜欢,称赞,感谢,还能说什么好呢, 可以说比市面上大多数计算机技术书不知道好多少倍呢!由浅入深,由表及里, 让我们这些初学者受益匪浅啊!

Comment by lianju...@gmail.com, Feb 25, 2009

这是我所看过的、讲解的最详细的技术资料。不多说了,总之非常感谢!!

Comment by littleti...@163.com, Apr 7, 2009

您的每一章节的讲义我都在仔细的阅读,对于我这个java的门外汉,真是受益匪浅!!非常感谢!希望能继续下去您的经典讲义。

Comment by zjw...@gmail.com, Apr 14, 2009

有出书一定买,很详细,弄懂了很多以前不懂的东西

Comment by xscancmd, Apr 24, 2009

赞!

Comment by whitneyc...@hotmail.com, May 20, 2009

真是贊, 就像老師在面前一點一點的教導, 感激不盡.

Comment by jamesla...@gmail.com, May 22, 2009

佩服!

Comment by yumeng5...@gmail.com, May 25, 2009

初入学堂,幸遇良师

Comment by SanFengC...@gmail.com, Sep 2, 2009

我要买您的书

Comment by zmg1...@gmail.com, Sep 7, 2009

确实不是一般的好,已请公司领导买该书!

Comment by uart.ch...@gmail.com, Sep 20, 2009

請問: 本章前段的說明是否代表一個Android的應用程式compile完成為執行檔之後, 是否不需要重新compile就可以在不同的Android硬體平台上都可執行? 例如編譯完一次之後就可以分別用在x86, ARM, MIPS等上面的硬體平台執行.

Comment by project member gasolin, Sep 20, 2009

uart.chang, 是的

Comment by zhik...@gmail.com, Sep 21, 2009

支持

Comment by ysl4s...@gmail.com, Oct 22, 2009

強大!

Comment by a0932788...@yahoo.com.tw, Dec 4, 2009

真的很詳細...感謝分享

Comment by edwar12...@gmail.com, Dec 31, 2009

以前所有的计算机教材 都应该 学习学习 您的写作风格。。 您的风格让人如沐春风,醍醐灌顶。

庆幸自己 刚学就找到您

Comment by snakeni...@gmail.com, Jan 7, 2010

关于这个问题给您发了邮件,觉得可能对其他人也有用,就在这里再问一次:自己在写程序的时候发现,在AndroidManifest.xml中,application的label和第一个activity的label好像有点冲突,也就是说不管我把application的label设置成什么,home主画面和第一个activity画面上方的名称都是第一个 activity的label,这里是我写的不对还是小bug呢?

Comment by project member gasolin, Jan 7, 2010

Label 可以在 Activity 里用 setTitle 隨時設定不同 label

Comment by snakeni...@gmail.com, Jan 7, 2010

AndroidManifest.xml中设置了application的label后,在java文件中使用setTitle()这个函数设置activity的名字,显示正确,谢谢!但是我的问题还是没有解决。。。我再描述一遍吧:在AndroidManifest.xml中设置了application的label和activity的label,前者应该是程序在home主界面中的显示名称,后者是程序内画面上方的显示名称。但经实际测试,如果设置了activity的label,那么application的label不会显示出来而是被activity的label覆盖,也就是说home主界面和程序内画面上方的显示名称都是activity的label,请问这是怎么回事呢?

Comment by project member gasolin, Jan 7, 2010

你覺得應該怎樣才是最適當的?要知道怎麼回事請自行去 trace android source 囉. 一般情況請用上面我講的方式設 title :)

Comment by snakeni...@gmail.com, Jan 7, 2010

盖大可能还没明白我的意思,我举个例子吧:我把application的label设置成“a”,把activity的label设置成“b”(假设只有1个activity),那么我的期望是在home主界面中,我的程序显示名称为“a”,而在打开程序之后,屏幕上方的显示名称为“b”。但实际测试中,home主界面和屏幕上方的显示名称都是“b”,也就是说我对application的label设置没有起到作用,那个“a”没有显示出来。所以想问问是不是您也是这样的问题,还是我自己哪个地方搞错了?多谢!

Comment by project member gasolin, Jan 7, 2010

後設定覆蓋前設定:啟動時先起動 application -> 設 app label, 再啟動 activity -> 設 activity label, 這樣的動作不是很正常嗎?

Comment by snakeni...@gmail.com, Jan 7, 2010

但是app label和activity label不是两种不同的东西吗?怎么会覆盖呢?

Comment by coolcool...@gmail.com, Jan 19, 2010

感謝分享,強烈推薦。

Comment by insperat...@gmail.com, Apr 21, 2010

to snakeninny看了上述您提的問題,並結合範例跑完程式的結果 就我理解來回答一下問題,若有錯誤煩請指教 在BMI manifeast中的app label和activity label都是把label設定為"@string/app_name" 因此才會有你說的主介面和程序內畫面上方顯示的名稱都是activity的label

Comment by Ordos...@gmail.com, May 21, 2010
首先赞一个,本书写的相当好。

to snakeninny:看了你的问题描述,试了一下,也遇到了同样问题?不明白为什么会是这样。

Comment by lp43si...@gmail.com, May 27, 2010

「各目標版本與代號對應表如下:」表格中, 可以加入最新的目標版本:2.2,代號:8了, android的書,永遠改版改不完啊!

Comment by chnd0...@gmail.com, Jun 13, 2010

to snakeninny:要达到你的目的,只需把application和activity的label均设置为“a”,然后再用setTitle动态设置activity的label。

Comment by a6309...@163.com, Nov 30, 2010

GOOD

Comment by QKe...@gmail.com, Apr 19, 2011

hi,您好,我想請教一個問題,就是我已照書上的範例完成bmi的程式,而且可以正常執行,但如果我想要讓report activity成為程式執行時的第一個activity(也就是程式的進入點而不是bmi),那是不是只要把 <intent-filter>

<action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" />
</intent-filter> 移到Report的activity內就好了。因為我照做並執行,結果模擬器會出錯。還是有那裡還需要做修改呢? 謝謝

Comment by project member gasolin, Apr 19, 2011

你的設定沒錯,但在showResults會從Bundle取得身高體重,如果預設執行Report的話,bundle裡的值是空的,需要處理這塊

Comment by chie...@hotmail.com, Aug 18, 2011

感謝您的分享

Comment by Lxi...@gmail.com, Oct 20, 2011

谢谢分享


Sign in to add a comment
Powered by Google Project Hosting