本頁面由 Cloud Translation API 翻譯而成。

<活動別名>

語法：

<activity-alias android:enabled=["true" | "false"]
                android:exported=["true" | "false"]
                android:icon="drawable resource"
                android:label="string resource"
                android:name="string"
                android:permission="string"
                android:targetActivity="string" >
    ...
</activity-alias>

包含於：

<application>

可包含：

<intent-filter>
<meta-data>

說明：

活動的別名，以 targetActivity 命名屬性。目標必須與並在資訊清單中的別名之前宣告其別名

別名會將目標活動顯示為獨立實體，並且可擁有專屬的一組意圖篩選器。而非目標活動本身的意圖篩選器，找出哪些意圖可以透過別名和系統如何啟動目標就會處理別名

舉例來說，別名上的意圖篩選器指定 "android.intent.action.MAIN" 和"android.intent.category.LAUNCHER"」導致會顯示在應用程式啟動器中，即使篩選器，則會設定這些標記。

targetActivity 是例外情況，<activity-alias> 屬性是 <activity> 屬性的子集。對於該子集中的屬性，為目標設定的所有值都不會沿用到別名上。但是，對於不在該子集中的屬性，為目標活動設定的值也會套用至別名。

屬性：

android:enabled

指出系統能否透過使目標活動例項化使用這個別名。"true" 表示可以，"false" 表示不可以。預設值為 "true"。

<application> 元素有專屬的 enabled 屬性，會套用至所有應用程式元件，包括活動別名。「<application>」和「<activity-alias>」屬性都必須為 "true"，系統才能例項化並透過別名為目標活動如有任一屬性為 "false"，別名無法運作。

android:exported

其他應用程式的元件能否啟動目標活動透過這個別名。"true" 表示可以，"false" 表示不可以。如果是 "false"，則只有元件，例如別名或具有相同使用者 ID 的應用程式。

預設值取決於別名是否包含意圖篩選器。沒有任何篩選器時，只能指定別名的確切名稱，透過別名叫用活動。這表示僅供應用程式內部使用，因為其他應用程式不知道該名稱。因此，預設值為 "false"。另一方面，只要出現至少一個篩選器，即表示別名適用於外部用途，因此預設值為 "true"。

android:icon

透過別名向使用者顯示時，目標活動的圖示。詳情請參閱 <activity> 元素的 icon 屬性。

android:label

透過別名向使用者顯示時，別名的使用者可讀標籤。詳情請參閱 <activity> 元素的 label 屬性。

android:name

別名的專屬名稱，名稱大致上合格類別名稱但與目標活動的名稱不同別名名稱可以任意指定不會參照實際類別。

android:permission

用戶端啟動目標活動所需的權限名稱或透過別名執行某些操作如果呼叫者是 startActivity()或 startActivityForResult() 使用者未獲得指定權限，則不會啟用目標活動。

該屬性會取代目標活動本身的任何權限設定。如果未設定，也無需權限即可透過別名啟動目標。

如要進一步瞭解權限，請參閱權限部分。

android:targetActivity

可透過別名啟動的活動名稱。這個名稱必須與資訊清單中別名前方 <activity> 元素的 name 屬性相符。

導入版本：

API 級別 1

另請參閱：

<activity>