132

I am currently developing an android app. I need to do something when the app is launched for the first time, i.e. the code only runs on the first time the program is launched.

5
  • 2
    When I first started making apps, I was only thinking about the first run after an app is installed. I later realized that I also needed to handle and differentiate first runs after upgrades. @schnatterer's answer below and my answer here show how to do this. Be cautious of answers that don't take upgrades into account.
    – Suragch
    Commented Jul 22, 2015 at 16:25
  • @Suragch you're acting like it is bad practice to not take upgrades into account but in some cases like having an app introduction you DON'T want to do it :) Commented Sep 12, 2016 at 17:59
  • @creativecreatorormaybenot, that's true. There are times when you only care about the initial install and not subsequent upgrades. A simple boolean is enough for those situations. However, what if at some time in the future you want to add a different introduction for current users about all the new features you just added in the last update? In my opinion it is more far-sighted to check the version number rather than a boolean. This at least gives you the option in the future to respond one way for a new install and another way for an upgrade.
    – Suragch
    Commented Sep 13, 2016 at 1:45
  • 1
    Then you just add it for this version but I get yoz Commented Sep 13, 2016 at 5:15
  • You can check this stackoverflow.com/a/7217834/2689076
    – Vaibhav
    Commented Oct 4, 2019 at 4:31

16 Answers 16

125

You can use the SharedPreferences to identify if it is the "First time" the app is launched. Just use a Boolean variable ("my_first_time") and change its value to false when your task for "first time" is over.

This is my code to catch the first time you open the app:

final String PREFS_NAME = "MyPrefsFile";

SharedPreferences settings = getSharedPreferences(PREFS_NAME, 0);

if (settings.getBoolean("my_first_time", true)) {
    //the app is being launched for first time, do something        
    Log.d("Comments", "First time");

             // first time task

    // record the fact that the app has been started at least once
    settings.edit().putBoolean("my_first_time", false).commit(); 
}
5
  • 17
    Will it handle when the app will be updated to the next version on the google play store? Commented Jun 29, 2014 at 13:28
  • 4
    SharedPreferences are maintained during upgrade. So, I assume that when its being upgraded from PlayStore, old value is available. In fact it is applicable for other methods i.e. checking existence of file too. So, shortcut method in that case is to use different preference/file name or value. Commented Nov 20, 2014 at 10:28
  • @ShajeelAfzal some thing like this may help you public void CheckAndInitAppFirstTime() { final String PREFS_NAME = "TheAppVer"; final String CHECK_VERSION = "1"; //Required ver... final String KEY_NAME = "CheckVersion"; SharedPreferences settings = getSharedPreferences(PREFS_NAME, 0); if (!settings.getString(KEY_NAME, "0").equals(CHECK_VERSION)) { //the app is being launched for first time, do something or CHECK_VERSION is different //... settings.edit().putString(KEY_NAME, CHECK_VERSION).commit(); } } Commented Nov 20, 2014 at 10:42
  • @aman verma: as per the getBoolean description at developer.android.com/reference/android/content/… 2nd parameter of getBoolean is the default value if the first parameter doesn't exit, so if "my_first_time" hasn't been set the expression defaults to true. Commented Aug 8, 2019 at 15:33
  • There is one issue with using SharedPreferences. If you have a backup rule to restore SharedPreferences and the users reinstalls your app at some point.
    – Kris B
    Commented Nov 4, 2022 at 2:32
66

I suggest to not only store a boolean flag, but the complete version code. This way you can also query at the beginning if it is the first start in a new version. You can use this information to display a "Whats new" dialog, for example.

The following code should work from any android class that "is a context" (activities, services, ...). If you prefer to have it in a separate (POJO) class, you could consider using a "static context", as described here for example.

/**
 * Distinguishes different kinds of app starts: <li>
 * <ul>
 * First start ever ({@link #FIRST_TIME})
 * </ul>
 * <ul>
 * First start in this version ({@link #FIRST_TIME_VERSION})
 * </ul>
 * <ul>
 * Normal app start ({@link #NORMAL})
 * </ul>
 * 
 * @author schnatterer
 * 
 */
public enum AppStart {
    FIRST_TIME, FIRST_TIME_VERSION, NORMAL;
}

/**
 * The app version code (not the version name!) that was used on the last
 * start of the app.
 */
private static final String LAST_APP_VERSION = "last_app_version";

/**
 * Finds out started for the first time (ever or in the current version).<br/>
 * <br/>
 * Note: This method is <b>not idempotent</b> only the first call will
 * determine the proper result. Any subsequent calls will only return
 * {@link AppStart#NORMAL} until the app is started again. So you might want
 * to consider caching the result!
 * 
 * @return the type of app start
 */
public AppStart checkAppStart() {
    PackageInfo pInfo;
    SharedPreferences sharedPreferences = PreferenceManager
            .getDefaultSharedPreferences(this);
    AppStart appStart = AppStart.NORMAL;
    try {
        pInfo = getPackageManager().getPackageInfo(getPackageName(), 0);
        int lastVersionCode = sharedPreferences
                .getInt(LAST_APP_VERSION, -1);
        int currentVersionCode = pInfo.versionCode;
        appStart = checkAppStart(currentVersionCode, lastVersionCode);
        // Update version in preferences
        sharedPreferences.edit()
                .putInt(LAST_APP_VERSION, currentVersionCode).commit();
    } catch (NameNotFoundException e) {
        Log.w(Constants.LOG,
                "Unable to determine current app version from pacakge manager. Defenisvely assuming normal app start.");
    }
    return appStart;
}

public AppStart checkAppStart(int currentVersionCode, int lastVersionCode) {
    if (lastVersionCode == -1) {
        return AppStart.FIRST_TIME;
    } else if (lastVersionCode < currentVersionCode) {
        return AppStart.FIRST_TIME_VERSION;
    } else if (lastVersionCode > currentVersionCode) {
        Log.w(Constants.LOG, "Current version code (" + currentVersionCode
                + ") is less then the one recognized on last startup ("
                + lastVersionCode
                + "). Defenisvely assuming normal app start.");
        return AppStart.NORMAL;
    } else {
        return AppStart.NORMAL;
    }
}

It could be used from an activity like this:

public class MainActivity extends Activity {        
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        switch (checkAppStart()) {
        case NORMAL:
            // We don't want to get on the user's nerves
            break;
        case FIRST_TIME_VERSION:
            // TODO show what's new
            break;
        case FIRST_TIME:
            // TODO show a tutorial
            break;
        default:
            break;
        }

        // ...
    }
    // ...
}

The basic logic can be verified using this JUnit test:

public void testCheckAppStart() {
    // First start
    int oldVersion = -1;
    int newVersion = 1;
    assertEquals("Unexpected result", AppStart.FIRST_TIME,
            service.checkAppStart(newVersion, oldVersion));

    // First start this version
    oldVersion = 1;
    newVersion = 2;
    assertEquals("Unexpected result", AppStart.FIRST_TIME_VERSION,
            service.checkAppStart(newVersion, oldVersion));

    // Normal start
    oldVersion = 2;
    newVersion = 2;
    assertEquals("Unexpected result", AppStart.NORMAL,
            service.checkAppStart(newVersion, oldVersion));
}

With a bit more effort you could probably test the android related stuff (PackageManager and SharedPreferences) as well. Anyone interested in writing the test? :)

Note that the above code will only work properly if you don't mess around with your android:versionCode in AndroidManifest.xml!

9
  • 2
    Please explain how to use this method. Where you are initializing the SharedPreferences object? Commented Jun 29, 2014 at 13:49
  • 1
    doesn't work for me - it always launch my first time tutorial
    – pzo
    Commented Jul 7, 2014 at 8:03
  • 1
    this code is alot more straight forward without the side effects of declaring the context and preferences elsewhere public AppStart checkAppStart(Context context, SharedPreferences sharedPreferences) is a much better method signature
    – Will
    Commented Dec 10, 2014 at 23:05
  • 2
    Made an update gist of this answer here gist.github.com/williscool/2a57bcd47a206e980eee I had an issue with the orginal code where it would get stuck in my walkthrough loop forever because the version number was never being recalculated in the first checkAppStart block. so I decided to share my updated code and see if anyone has suggestions about it
    – Will
    Commented Dec 11, 2014 at 1:47
  • 1
    @Will thanks for your input. You're right, the code could be simplified and made more robust. When I first posted the answer, I extracted the code from a more complex scenario, where I wanted to access AppStart from different activities. So I put the logic in a separate service method. That's why there was a context variable and AppStart was stored within a static variable to facilitate idempotent method calls. Commented Dec 11, 2014 at 17:00
60

Another idea is to use a setting in the Shared Preferences. Same general idea as checking for an empty file, but then you don't have an empty file floating around, not being used to store anything

8
  • 4
    beware that this kind of approach could not work on a Samsung Galaxy S with Android Froyo. That's because of a bug in SharedPreferences saving. Here's a link to a SO question on that: stackoverflow.com/questions/7296163/… and here's the ticket on google code: code.google.com/p/android/issues/detail?id=14359 Commented Mar 9, 2012 at 8:07
  • 4
    Beware for Android 6.0 (API 23 - Marshmallow) or above auto backup (developer.android.com/guide/topics/data/autobackup.html)is enabled by default. If the users uninstalls and then reinstalls the app the shared preferences will be recovered. So on reinstalls you cannot check if it is running for the first time after the reinstall if this is of any concern.
    – Alan
    Commented Mar 9, 2017 at 23:38
  • 1
    @Alan you are right, this answer is no longer valid from Android Marshmallow. Commented May 12, 2017 at 17:03
  • 1
    @Alan you cannot imagine how long I was looking for an answer like yours. You made my day. Thanks!
    – Antonio
    Commented Jun 17, 2017 at 23:59
  • @Alan But auto backup also saves most other data. So the reinstalled app is probably expected to be in a non-first-run state. And the user already has used the app before, so there is no need for guidance. So I would argue for most cases it is a good thing this happens.
    – smdufb
    Commented Nov 8, 2019 at 7:08
5

I solved to determine whether the application is your first time or not , depending on whether it is an update.

private int appGetFirstTimeRun() {
    //Check if App Start First Time
    SharedPreferences appPreferences = getSharedPreferences("MyAPP", 0);
    int appCurrentBuildVersion = BuildConfig.VERSION_CODE;
    int appLastBuildVersion = appPreferences.getInt("app_first_time", 0);

    //Log.d("appPreferences", "app_first_time = " + appLastBuildVersion);

    if (appLastBuildVersion == appCurrentBuildVersion ) {
        return 1; //ya has iniciado la appp alguna vez

    } else {
        appPreferences.edit().putInt("app_first_time",
                appCurrentBuildVersion).apply();
        if (appLastBuildVersion == 0) {
            return 0; //es la primera vez
        } else {
            return 2; //es una versión nueva
        }
    }
}

Compute results:

  • 0: If this is the first time.
  • 1: It has started ever.
  • 2: It has started once, but not that version , ie it is an update.
3

Here's some code for this -

String path = Environment.getExternalStorageDirectory().getAbsolutePath() +
                    "/Android/data/myapp/files/myfile.txt";

boolean exists = (new File(path)).exists(); 

if (!exists) {
    doSomething();                                      
}
else {
    doSomethingElse();
}
3

There is support for just this in the support library revision 23.3.0 (in the v4 which means compability back to Android 1.6).

In your Launcher activity, first call:

AppLaunchChecker.onActivityCreate(activity);

Then call:

AppLaunchChecker.hasStartedFromLauncher(activity);

Which will return if this was the first time the app was launched.

2
  • The order of these calls has to be reversed, once AppLaunchChecker.onActivityCreate() has been called, AppLaunchChecker.hasStartedFromLauncher() will be returning true. Commented May 1, 2017 at 17:20
  • 2
    This is quite misleading. It doesn't say whether the app is "ever launched"; it, rather, says whether the app "ever launched by a user from launcher". So, there is a possibility that other apps or deep-links may have already launched the app.
    – Farid
    Commented Nov 15, 2019 at 13:16
3

You can use Android SharedPreferences .

Android SharedPreferences allows us to store private primitive application data in the form of key-value pair .

CODE

Create a custom class SharedPreference

 public class SharedPreference {

    android.content.SharedPreferences pref;
    android.content.SharedPreferences.Editor editor;
    Context _context;
    private static final String PREF_NAME = "testing";

    // All Shared Preferences Keys Declare as #public
    public static final String KEY_SET_APP_RUN_FIRST_TIME       =        "KEY_SET_APP_RUN_FIRST_TIME";


    public SharedPreference(Context context) // Constructor
    {
        this._context = context;
        pref = _context.getSharedPreferences(PREF_NAME, 0);
        editor = pref.edit();

    }

    /*
    *  Set Method Generally Store Data;
    *  Get Method Generally Retrieve Data ;
    * */


    public void setApp_runFirst(String App_runFirst)
    {
        editor.remove(KEY_SET_APP_RUN_FIRST_TIME);
        editor.putString(KEY_SET_APP_RUN_FIRST_TIME, App_runFirst);
        editor.apply();
    }

    public String getApp_runFirst()
    {
        String  App_runFirst= pref.getString(KEY_SET_APP_RUN_FIRST_TIME, "FIRST");
        return  App_runFirst;
    }

}

Now Open Your Activity & Initialize .

 private     SharedPreference                sharedPreferenceObj; // Declare Global

Now Call this in OnCreate section

 sharedPreferenceObj=new SharedPreference(YourActivity.this);

Now Checking

if(sharedPreferenceObj.getApp_runFirst().equals("FIRST"))
 {
   // That's mean First Time Launch
   // After your Work , SET Status NO
   sharedPreferenceObj.setApp_runFirst("NO");
 }
else
 { 
   // App is not First Time Launch
 }
0
2

You could simply check for the existence of an empty file, if it doesn't exist, then execute your code and create the file.

e.g.

if(File.Exists("emptyfile"){
    //Your code here
    File.Create("emptyfile");
}
3
  • I was thinking of doing that but thought there must be a better way
    – Boardy
    Commented Jan 8, 2011 at 21:10
  • I don't know any, but what is the lack of ressources you recieve by that? 4 bytes for the file and one "if" at the beginning. System-routines would do the same, they'd do exactly the same or make a table with applications which have already been lauched
    – MechMK1
    Commented Jan 8, 2011 at 21:13
  • 1
    In a similar fashion you can use sharedpreferences, which if it doesn't exist, you show a splash screen etc... and just create it when program is first run (obv after checking for it). See Kevin's answer above Commented Jan 8, 2011 at 21:30
2

If you are looking for a simple way, here it is.

Create a utility class like this,

public class ApplicationUtils {

  /**
  * Sets the boolean preference value
  *
  * @param context the current context
  * @param key     the preference key
  * @param value   the value to be set
  */
 public static void setBooleanPreferenceValue(Context context, String key, boolean value) {
     SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(context);
     sp.edit().putBoolean(key, value).apply();
 }

 /**
  * Get the boolean preference value from the SharedPreference
  *
  * @param context the current context
  * @param key     the preference key
  * @return the the preference value
  */
 public static boolean getBooleanPreferenceValue(Context context, String key) {
     SharedPreferences sp = PreferenceManager.getDefaultSharedPreferences(context);
     return sp.getBoolean(key, false);
 }

}

At your Main Activity, onCreate()

if(!ApplicationUtils.getBooleanPreferenceValue(this,"isFirstTimeExecution")){
Log.d(TAG, "First time Execution");
ApplicationUtils.setBooleanPreferenceValue(this,"isFirstTimeExecution",true);
// do your first time execution stuff here,
}
1
  • this its the BEST answer so far! Commented Oct 4, 2020 at 9:20
1

I made a simple class to check if your code is running for the first time/ n-times!

Example

Create a unique preferences

FirstTimePreference prefFirstTime = new FirstTimePreference(getApplicationContext());

Use runTheFirstTime, choose a key to check your event

if (prefFirstTime.runTheFirstTime("myKey")) {
    Toast.makeText(this, "Test myKey & coutdown: " + prefFirstTime.getCountDown("myKey"),
                   Toast.LENGTH_LONG).show();
}

Use runTheFirstNTimes, choose a key and how many times execute

if(prefFirstTime.runTheFirstNTimes("anotherKey" , 5)) {
    Toast.makeText(this, "ciccia Test coutdown: "+ prefFirstTime.getCountDown("anotherKey"),
                   Toast.LENGTH_LONG).show();
}
  • Use getCountDown() to better handle your code

FirstTimePreference.java

1

for kotlin

    fun checkFirstRun() {

    var prefs_name = "MyPrefsFile"
    var pref_version_code_key = "version_code"
    var doesnt_exist: Int = -1;

    // Get current version code
    var currentVersionCode = BuildConfig.VERSION_CODE

    // Get saved version code
    var prefs: SharedPreferences = getSharedPreferences(prefs_name, MODE_PRIVATE)
    var savedVersionCode: Int = prefs.getInt(pref_version_code_key, doesnt_exist)

    // Check for first run or upgrade
    if (currentVersionCode == savedVersionCode) {

        // This is just a normal run
        return;

    } else if (savedVersionCode == doesnt_exist) {

        // TODO This is a new install (or the user cleared the shared preferences)


    } else if (currentVersionCode > savedVersionCode) {

        // TODO This is an upgrade
    }

    // Update the shared preferences with the current version code
    prefs.edit().putInt(pref_version_code_key, currentVersionCode).apply();

}
2
  • Thank you very much for giving answer in Kotlin
    – MMG
    Commented May 7, 2020 at 7:32
  • if (savedVersionCode <= doesnt_exist) work for me
    – Maher
    Commented Mar 8, 2023 at 23:52
0

Why not use the Database Helper ? This will have a nice onCreate which is only called the first time the app is started. This will help those people who want to track this after there initial app has been installed without tracking.

3
  • Does that create a database? How to use the DatabaseHelper without creating an actual database? And I think, onCreate() is called for every new version. Also, wouldn't it be considered superfluous or using something for an unintended purpose?
    – ADTC
    Commented Aug 16, 2014 at 6:31
  • onCreate is only triggered when the app is installed the first time. When the db version is incremented the onUpdated is triggered.
    – slott
    Commented Aug 16, 2014 at 8:23
  • Well superfluous is such a harsh word :) - If you have the option ie. your app is not yet live yet then setup a SharedPrefs flag and use that to determine is it's first boot or not. I had a case where the app had been in the wild for some time and we were using a DB so the onCreate was a perfect match for me.
    – slott
    Commented Aug 18, 2014 at 7:40
0

I like to have an "update count" in my shared preferences. If it's not there (or default zero value) then this is my app's "first use".

private static final int UPDATE_COUNT = 1;    // Increment this on major change
...
if (sp.getInt("updateCount", 0) == 0) {
    // first use
} else if (sp.getInt("updateCount", 0) < UPDATE_COUNT) {
    // Pop up dialog telling user about new features
}
...
sp.edit().putInt("updateCount", UPDATE_COUNT);

So now, whenever there's an update to the app that users should know about, I increment UPDATE_COUNT

0

My version for kotlin looks like the following:

PreferenceManager.getDefaultSharedPreferences(this).apply {
        // Check if we need to display our OnboardingSupportFragment
        if (!getBoolean("wasAppStartedPreviously", false)) {
            // The user hasn't seen the OnboardingSupportFragment yet, so show it
            startActivity(Intent(this@SplashScreenActivity, AppIntroActivity::class.java))
        } else {
            startActivity(Intent(this@SplashScreenActivity, MainActivity::class.java))
        }
    }
0

An improved version of K.Hayoev but boolean one

 fun isFirstRun(): Boolean {

    var prefs_name = "MyPrefsFile"
    var pref_version_code_key = "version_code"
    var doesnt_exist: Int = -1;

    // Get current version code
    var currentVersionCode = BuildConfig.VERSION_CODE

    // Get saved version code
    var prefs: SharedPreferences = requireContext().getSharedPreferences(prefs_name, MODE_PRIVATE)
    var savedVersionCode: Int = prefs.getInt(pref_version_code_key, doesnt_exist)

    // Check for first run or upgrade
    if (currentVersionCode == savedVersionCode) {

        // This is just a normal run
        return false;

    } else if (savedVersionCode <= doesnt_exist) {
        prefs.edit().putInt(pref_version_code_key, currentVersionCode).apply();
        return true
        // TODO This is a new install (or the user cleared the shared preferences)

    } else if (currentVersionCode > savedVersionCode) {
        return false;
        // TODO This is an upgrade
    }
    prefs.edit().putInt(pref_version_code_key, currentVersionCode).apply();
    return false
    // Update the shared preferences with the current version code

}
-2

Hi guys I am doing something like this. And its works for me

create a Boolean field in shared preference.Default value is true {isFirstTime:true} after first time set it to false. Nothing can be simple and relaiable than this in android system.

1
  • Uh, don't hardcode the path like that! If you simply do Context.getSharedPreferences() it will end up in the same place, except it will work everywhere Commented Jul 7, 2015 at 16:13

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.