Token


class 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:

Token token = Token.create(packageName, packageManager);
byte[] serialized = token.serialize();
// Persist serialized.

// Some time later...
Token verified = Token.deserialize(serialized);
verified.matches(packageName, packageManager);

Summary

Public functions

java-static Token?
create(packageName: String, packageManager: PackageManager)

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

java-static Token
deserialize(serialized: ByteArray)

Reconstructs a Token from the output of its serialize.

Boolean
matches(packageName: String, packageManager: PackageManager)

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

ByteArray<Byte>

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

Public functions

create

Added in 1.2.0
java-static fun create(packageName: String, 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.

Returns
Token?

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

deserialize

Added in 1.2.0
java-static fun deserialize(serialized: ByteArray): Token

Reconstructs a Token from the output of its serialize.

Parameters
serialized: ByteArray

The result of a serialize call.

Returns
Token

The deserialized Token.

matches

Added in 1.2.0
fun matches(packageName: String, 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.

Returns
Boolean

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

serialize

Added in 1.2.0
fun serialize(): ByteArray<Byte>

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

Returns
ByteArray<Byte>

A serialization of the Token.