萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

AndroidManifest.xml 設定啟動 Activity:intent-filter 詳解與多入口切換

核心機制:LAUNCHER 分類

Android 系統啟動 App 時,尋找含有以下 intent-filter 的 ``:

<intent-filter>
    <action android:name="android.intent.action.MAIN" />
    <category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
  • MAIN:進入點動作。
  • LAUNCHER:顯示在桌面啟動器列表中。

同一個 App 只能有一個 Activity 擁有此組合 (多個會在桌面產生多個圖示)。

切換啟動頁範例

啟動 LoginActivity

<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.example.myapp" ...>

    <application ...>
        <!-- 啟動 LoginActivity -->
        <activity android:name=".LoginActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

        <!-- 普通 Activity,無 LAUNCHER -->
        <activity android:name=".MainActivity" />
        <activity android:name=".HelloworldActivity" />
    </application>
</manifest>

啟動 HelloworldActivity

<activity android:name=".LoginActivity" /> <!-- 移除 intent-filter -->
<activity android:name=".HelloworldActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

動態切換啟動頁 (程式碼控制)

Manifest 固定單一入口,若需根據登入狀態決定首頁:

public class SplashActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 判斷邏輯
        boolean loggedIn = PreferenceManager.getDefaultSharedPreferences(this)
            .getBoolean("logged_in", false);
        
        Intent intent = new Intent(this, loggedIn ? MainActivity.class : LoginActivity.class);
        startActivity(intent);
        finish(); // 關閉 Splash,避免返回鍵回來
    }
}

Manifest 中只給 SplashActivity 加 LAUNCHER filter。

常見錯誤與調試

  • 找不到 Activity:檢查 `android:name` 完整包名或相對包名 (以 `.` 開頭)。
  • 桌面無圖示:缺少 `LAUNCHER` category 或 `MAIN` action。
  • 多圖示:多個 Activity 都加了 LAUNCHER。
  • 匯出問題:`android:exported="true"` (API 31+ 必須顯式聲明)。

進階:多入口場景

  • 快捷方式:`` 定義靜態/動態捷徑。
  • Deep Link:``。
  • Tile/Widget:另行註冊 `BroadcastReceiver`/`AppWidgetProvider`。
copyright © 萬盛學電腦網 all rights reserved