Skip to content

Most visited

Recently visited

navigation
added in version 24.1.0
belongs to Maven artifact com.android.support:support-core-utils:27.0.0

AppLaunchChecker

public class AppLaunchChecker
extends Object

java.lang.Object
   ↳ android.support.v4.app.AppLaunchChecker


This class provides APIs for determining how an app has been launched. This can be useful if you want to confirm that a user has launched your app through its front door activity from their launcher/home screen, rather than just if the app has been opened in the past in order to view a link, open a document or perform some other service for other apps on the device.

Summary

Public constructors

AppLaunchChecker()

Public methods

static boolean hasStartedFromLauncher(Context context)

Checks if this app has been launched by the user from their launcher or home screen since it was installed.

static void onActivityCreate(Activity activity)

Records the parameters of an activity's launch for later use by the other methods available on this class.

Inherited methods

From class java.lang.Object

Public constructors

AppLaunchChecker

added in version 24.1.0
AppLaunchChecker ()

Public methods

hasStartedFromLauncher

added in version 24.1.0
boolean hasStartedFromLauncher (Context context)

Checks if this app has been launched by the user from their launcher or home screen since it was installed.

To track this state properly you must call onActivityCreate(Activity) in your launcher activity's onCreate(Bundle) method.

Parameters
context Context: Context to check

Returns
boolean true if this app has been started by the user from the launcher at least once

onActivityCreate

added in version 24.1.0
void onActivityCreate (Activity activity)

Records the parameters of an activity's launch for later use by the other methods available on this class.

Your app should call this method in your launcher activity's onCreate(Bundle) method to track launch state. If the app targets API 23 (Android 6.0 Marshmallow) or later, this state will be eligible for full data backup and may be restored to the user's device automatically.

*

Parameters
activity Activity: the Activity currently running onCreate

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)