Android singleTask or singleInstance launch mode?

I have an app that has a list as its main activity and then you can click items which opens a detailed view of that item. I also have a search activity that is similar to the main activity and works as intended.

However I want this search activity to only have once instance on the stack so that users can search multiple times and clicking back would return them to the previouse view that they were on before they started searching (rather than go back to the previouse search results)

both the singleTask and singelInstance launch mode seems to do what I want so Im not sure which one I should be using for this purpose and why?

From the Application Fundamentals page of the Android dev guide:

> By default, all the activities in an > application have an affinity for each > other — that is, there's a preference > for them all to belong to the same > task. > > A "singleInstance" activity stands > alone as the only activity in its > task. If it starts another activity, > that activity will be launched into a > different task regardless of its > launch mode — as if > FLAG_ACTIVITY_NEW_TASK was in the > intent. In all other respects, the > "singleInstance" mode is identical to > "singleTask". > > As noted above, there's never more > than one instance of a "singleTask" or > "singleInstance" activity, so that > instance is expected to handle all new > intents. A "singleInstance" activity > is always at the top of the stack > (since it is the only activity in the > task), so it is always in position to > handle the intent. However, a > "singleTask" activity may or may not > have other activities above it in the > stack. If it does, it is not in > position to handle the intent, and the > intent is dropped. (Even though the > intent is dropped, its arrival would > have caused the task to come to the > foreground, where it would remain.)

Since there is never more than one instance of the Activity with either launch mode, the back button will always take you to the existing instance of the Activity in your case.

An important difference is that "singleTask" doesn't require the creation of a new task for the new Activities being launched when something is selected. Nor will it have to remove that new task on the back button each time.

Since your Activity stack does all pertain to one user "task", and it doesn't sound like you have an intricate Intent structure where singleInstance may be beneficial to always handle them, I would suggest using the singleTask launch mode.

Here is a good blog post for more info, as well as credited for the image: Android Activities and Tasks series – An introduction to Android’s UI component model

In a simple way-

singleTask:

The system creates a new task and instantiates the activity at the root of the new task. However, if an instance of the activity already exists in a separate task, the system routes the intent to the existing instance through a call to its onNewIntent() method, rather than creating a new instance. Only one instance of the activity can exist at a time.

> Note: Although the activity starts in a new task, the Back button > still returns the user to the previous activity.

singleInstance-

Same as "singleTask", except that the system doesn't launch any other activities into the task holding the instance. The activity is always the single and only member of its task; any activities started by this one open in a separate task.

singleTask and singleInstance activities can only begin a task. They are always at the root of the activity stack. Moreover, the device can hold only one instance of the activity at a time — only one such task.
for more android:launchMode.