onNewIntent詳解

一、基礎概念

onNewIntent()是android中的一個方法，當Activity處於啟動頂端（singleTop）時，在每次調用Intent後都會回到該Activity，並觸發該函數。它用於處理新傳入的Intent並更新activity的狀態。

在onNewIntent()回調方法中可以實現對不同的Intent做出相應的處理，例如更新UI界面等。不過需要注意的是，該方法只有在啟動模式為singleTop或singleTask的Activity中才會被調用。因為這些啟動模式會讓只有棧頂的Activity才能被喚醒，以達到統一一致的操作流程。

二、使用方法

使用onNewIntent()之前，需要在Activity的Manifest文件中對其進行聲明。在android中，我們通過在標籤中過濾器設置來指定一個Activity能夠接收的Intent類型。

下面是一個簡單的示例，在MainActivity的Manifest文件中添加標籤，並添加過濾action:

    <activity android:name=".MainActivity"
            android:launchMode="singleTop">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
                <action android:name="com.example.ON_NEW_INTENT" /> //新增
            </intent-filter>
        </activity>

隨後，在MainActivity中添加以下代碼：

@Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        if (Intent.ACTION_VIEW.equals(intent.getAction())) {
            Uri uri = intent.getData();
            if (uri != null) {
                String orderId = uri.getQueryParameter("orderId");
                String amount = uri.getQueryParameter("amount");
                handleOrder(orderId, amount);
            }
        } else if ("com.example.ON_NEW_INTENT".equals(intent.getAction())) {
            String name = intent.getStringExtra("name");
            String age = intent.getStringExtra("age");
            handleUser(name, age);
        }
    }

在這個示例中，我們接收了兩種不同類型的Intent，一種可以通過URI parse獲得參數，而另一種傳入了一個name和age參數。

需要注意的是，接收Intent的Activity應當是棧頂的Activity，因為只要Activity不在棧頂，onNewIntent()方法就不會被調用。（如果需要使用onNewIntent()方法，可以使用FLAG_ACTIVITY_CLEAR_TOP標誌位在進入Activity時退出之前Activity）

三、應用場景

onNewIntent()在應用中有很多使用場景。下面我們列舉了一些通用的示例。

1. 啟動Activity時傳遞數據

假設我們需要在MainActivity中傳遞一個用戶信息到UserInfoActivity中。我們可以通過Intent傳遞數據到UserInfoActivity，並在UserInfoActivity的onNewIntent()方法中獲取該數據。

//在MainActivity中傳遞數據
Intent intent = new Intent(MainActivity.this, UserInfoActivity.class);
intent.putExtra("name", "John");
intent.putExtra("age", 18);
startActivity(intent);

//在UserInfoActivity中接收數據
@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    String name = intent.getStringExtra("name");
    int age = intent.getIntExtra("age", 0);
    updateUserInfo(name, age);
}

2. 處理外部傳入數據

當我們在應用中使用了自定義的URI scheme（如：XXX://order/detail?orderId=123&amount=200），通過使用intent-filter過濾器，我們可以處理從外部傳入的URI數據。

在Manifest文件中添加過濾器：

    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="XXX" android:host="order" android:pathPrefix="/detail" />
    </intent-filter>

在Activity中獲取Uri數據並更新UI。

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    if (Intent.ACTION_VIEW.equals(intent.getAction())) {
        Uri uri = intent.getData();
        if (uri != null) {
            String orderId = uri.getQueryParameter("orderId");
            String amount = uri.getQueryParameter("amount");
            handleOrder(orderId, amount);
        }
    }
}

3. 恢復程序狀態

在大多數情況下，應用程序可能會被暫停、停止、終止或銷毀，這些情況下，應用程序的進程可能會被銷毀，這意味着您可能需要在應用程序的任何時候恢復應用程序的狀態。 一種可能的方法是在Activity中使用onSaveInstanceState()方法並在onCreate()方法中使用Bundle恢復狀態，另一種方法是在onNewIntent()方法中保存狀態，並在需要時加載狀態，例如：

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    Bundle extras = intent.getExtras();
    if (extras != null) {
        //恢復狀態
    }
}

4. 喚起Activity

當應用程序的某個Activity已經處於棧頂時，您可以通過重複調用startActivity()方法來喚醒該Activity。但是，如果特定Activity在應用程序的任務欄的不同部分處於活動狀態，則只能使用onNewIntent()方法來處理傳入的Intent實例。

下面是一個示例，可以切換Task，喚起指定Activity：

//MainActivity啟動ActivityA
Intent intentA = new Intent(MainActivity.this, ActivityA.class);
intentA.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
startActivity(intentA);

//ActivityA啟動ActivityB
Intent intentB = new Intent(ActivityA.this, ActivityB.class);
intentB.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
startActivity(intentB);

五、總結

onNewIntent是Android中一個非常有用的方法，它可以廣泛應用於各種場景，例如傳遞、處理和恢複數據以及喚起Activity等。在使用時需要注意，僅能在singleTask或singleTop啟動模式的Activity中使用onNewIntent()方法，否則會導致一些應用異常。