Fixes for multi-process access (#1042)

* Switch from using SharedPreferences to a flat file

* Fixes for multi-process access

 - switch from shared prefs to a flat file
 - protect generate Fid for cross-process and cross-thread accesses
 - make doRegistration only read the prefs once at the beginning and
   clean up the flow
 - pass the forceRefresh flag into doRegistration rather than
   storing it in a global

* revert the name of the FID prefs write call

* fix formatting issues

* Fix the cross process locking

The check if a new FID was needed was not in the critical region.

* some small changes from the review

* fix the java format and update the api file

Author: fredquintana

firebase-installations/api.txt

@@ -17,9 +17,12 @@ package com.google.firebase.installations {
   }
 
   public enum FirebaseInstallationsException.Status {
-    enum_constant public static final com.google.firebase.installations.FirebaseInstallationsException.Status AUTHENTICATION_ERROR;
-    enum_constant public static final com.google.firebase.installations.FirebaseInstallationsException.Status CLIENT_ERROR;
-    enum_constant public static final com.google.firebase.installations.FirebaseInstallationsException.Status SDK_INTERNAL_ERROR;
+    enum_constant public static final com.google.firebase.installations.FirebaseInstallationsException.Status BAD_CONFIG;
+  }
+
+  public class RandomFidGenerator {
+    ctor public RandomFidGenerator();
+    method @NonNull public String createRandomFid();
   }
 
 }
@@ -33,12 +36,13 @@ package com.google.firebase.installations.local {
 
   public class PersistedInstallation {
     ctor public PersistedInstallation(@NonNull FirebaseApp);
-    method @NonNull public boolean clear();
-    method @NonNull public boolean insertOrUpdatePersistedInstallationEntry(@NonNull com.google.firebase.installations.local.PersistedInstallationEntry);
+    method public void clearForTesting();
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry insertOrUpdatePersistedInstallationEntry(@NonNull com.google.firebase.installations.local.PersistedInstallationEntry);
     method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry readPersistedInstallationEntryValue();
   }
 
   public enum PersistedInstallation.RegistrationStatus {
+    enum_constant public static final com.google.firebase.installations.local.PersistedInstallation.RegistrationStatus ATTEMPT_MIGRATION;
     enum_constant public static final com.google.firebase.installations.local.PersistedInstallation.RegistrationStatus NOT_GENERATED;
     enum_constant public static final com.google.firebase.installations.local.PersistedInstallation.RegistrationStatus REGISTERED;
     enum_constant public static final com.google.firebase.installations.local.PersistedInstallation.RegistrationStatus REGISTER_ERROR;
@@ -59,7 +63,15 @@ package com.google.firebase.installations.local {
     method public boolean isNotGenerated();
     method public boolean isRegistered();
     method public boolean isUnregistered();
+    method public boolean shouldAttemptMigration();
     method @NonNull public abstract com.google.firebase.installations.local.PersistedInstallationEntry.Builder toBuilder();
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry withAuthToken(@NonNull String, long, long);
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry withClearedAuthToken();
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry withFisError(@NonNull String);
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry withNoGeneratedFid();
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry withRegisteredFid(@NonNull String, @NonNull String, long, @Nullable String, long);
+    method @NonNull public com.google.firebase.installations.local.PersistedInstallationEntry withUnregisteredFid(@NonNull String);
+    field @NonNull public static com.google.firebase.installations.local.PersistedInstallationEntry INSTANCE;
   }
 
   public abstract static class PersistedInstallationEntry.Builder {
@@ -107,8 +119,8 @@ package com.google.firebase.installations.remote {
   }
 
   public enum InstallationResponse.ResponseCode {
+    enum_constant public static final com.google.firebase.installations.remote.InstallationResponse.ResponseCode BAD_CONFIG;
     enum_constant public static final com.google.firebase.installations.remote.InstallationResponse.ResponseCode OK;
-    enum_constant public static final com.google.firebase.installations.remote.InstallationResponse.ResponseCode SERVER_ERROR;
   }
 
   public abstract class TokenResult {
@@ -117,7 +129,6 @@ package com.google.firebase.installations.remote {
     method @Nullable public abstract com.google.firebase.installations.remote.TokenResult.ResponseCode getResponseCode();
     method @Nullable public abstract String getToken();
     method @NonNull public abstract long getTokenExpirationTimestamp();
-    method public boolean isSuccessful();
     method @NonNull public abstract com.google.firebase.installations.remote.TokenResult.Builder toBuilder();
   }
 
@@ -130,9 +141,9 @@ package com.google.firebase.installations.remote {
   }
 
   public enum TokenResult.ResponseCode {
-    enum_constant public static final com.google.firebase.installations.remote.TokenResult.ResponseCode FID_ERROR;
+    enum_constant public static final com.google.firebase.installations.remote.TokenResult.ResponseCode AUTH_ERROR;
+    enum_constant public static final com.google.firebase.installations.remote.TokenResult.ResponseCode BAD_CONFIG;
     enum_constant public static final com.google.firebase.installations.remote.TokenResult.ResponseCode OK;
-    enum_constant public static final com.google.firebase.installations.remote.TokenResult.ResponseCode REFRESH_TOKEN_ERROR;
   }
 
 }

firebase-installations/src/androidTest/java/com/google/firebase/installations/FakeCalendar.java

@@ -0,0 +1,69 @@
+// Copyright 2019 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package com.google.firebase.installations;
+
+import java.util.Calendar;
+
+public class FakeCalendar extends Calendar {
+  private long timeInMillis;
+
+  public FakeCalendar(long initialTimeInMillis) {
+    timeInMillis = initialTimeInMillis;
+  }
+
+  public long getTimeInMillis() {
+    return timeInMillis;
+  }
+
+  public void setTimeInMillis(long timeInMillis) {
+    this.timeInMillis = timeInMillis;
+  }
+
+  public void advanceTimeBySeconds(long deltaSeconds) {
+    timeInMillis += (deltaSeconds * 1000L);
+  }
+
+  @Override
+  protected void computeTime() {}
+
+  @Override
+  protected void computeFields() {}
+
+  @Override
+  public void add(int i, int i1) {}
+
+  @Override
+  public void roll(int i, boolean b) {}
+
+  @Override
+  public int getMinimum(int i) {
+    return 0;
+  }
+
+  @Override
+  public int getMaximum(int i) {
+    return 0;
+  }
+
+  @Override
+  public int getGreatestMinimum(int i) {
+    return 0;
+  }
+
+  @Override
+  public int getLeastMaximum(int i) {
+    return 0;
+  }
+}