src/chrome/android/java/src/org/chromium/chrome/browser/identity/UniqueIdentificationGenerator.java

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 package org.chromium.chrome.browser.identity;
   6
   7 import javax.annotation.Nullable;
   8
   9 /**
  10  * Interface used for uniquely identifying an installation of Chrome. To get an instance you should
  11  * use {@link UniqueIdentificationGeneratorFactory}.
  12  */
  13 public interface UniqueIdentificationGenerator {
  14     /**
  15      * Creates a string that uniquely identifies this installation.
  16      * <p/>
  17      * If there is an error in generating the string, an empty string must be returned, not null.
  18      *
  19      * @param salt the salt to use for the unique ID.
  20      * @return a unique ID. On failure to generate, it must return the empty string.
  21      */
  22     String getUniqueId(@Nullable String salt);
  23 }