Token

Kotlin |Java

class Token

kotlin.Any
↳	androidx.browser.trusted.Token

Stores a package's identity, a combination of its package name and signing certificate. It is designed to be persistable as a byte[], so you can do this:

<code>Token token = Token.create(packageName, packageManager);
  byte[] serialized = token.serialize();
  // Persist serialized.
 
  // Some time later...
  Token verified = Token.deserialize(serialized);
  verified.matches(packageName, packageManager);
  </code>

Summary

Public methods
static Token?	`create(@NonNull packageName: String, @NonNull packageManager: PackageManager)` Creates a `Token` for the given package, taking into account the package name and its signing signature.
static Token	`deserialize(@NonNull serialized: ByteArray)` Reconstructs a `Token` from the output of its `serialize`.
Boolean	`matches(@NonNull packageName: String, @NonNull packageManager: PackageManager)` Whether the given package matches the package that was used to create the original Token.
ByteArray	`serialize()` Serializes the `Token` to a form that can later be restored by the `deserialize` method.

Public methods

create

@Nullable static fun create(
    @NonNull packageName: String, 
    @NonNull packageManager: PackageManager
): Token?

Creates a Token for the given package, taking into account the package name and its signing signature.

Parameters
`packageName`	String: The name of the package.
`packageManager`	PackageManager: A `PackageManager` to determine the signing information.

Return
Token?: A `Token`. `null` if the provided package cannot be found (the app is not installed).

deserialize

@NonNull static fun deserialize(@NonNull serialized: ByteArray): Token

Reconstructs a Token from the output of its serialize.

Parameters
`serialized`	ByteArray: The result of a `Token#serialize` call.

Return
Token: The deserialized Token.

matches

fun matches(
    @NonNull packageName: String, 
    @NonNull packageManager: PackageManager
): Boolean

Whether the given package matches the package that was used to create the original Token.

Parameters
`packageName`	String: The name of the package.
`packageManager`	PackageManager: A `PackageManager` to get information about the package.

Return
Boolean: Whether the given package currently is the same as the one used to create the Token.

serialize

@NonNull fun serialize(): ByteArray

Serializes the Token to a form that can later be restored by the deserialize method.

Return
ByteArray: A serialization of the `Token`.