Token

Added in 1.2.0

Kotlin |Java

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>`	`serialize()` 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`.