{% setvar book_path %}/reference/kotlin/androidx/_book.yaml{% endsetvar %} {% include "_shared/_reference-head-tags.html" %}

FileTestStorage

class FileTestStorage : PlatformTestStorage


A class that reads/writes the runner data using the raw file system.

This API is experimental and is subject to change or removal in future releases.

Summary

Public constructors

Public functions

Unit

Test output properties is not supported when raw file I/O is used.

String
getInputArg(argName: String)

Test input arguments is not supported when raw file I/O is used.

Map<StringString>

Test input arguments is not supported when raw file I/O is used.

Map<StringSerializable>

Test output properties is not supported when raw file I/O is used.

InputStream
openInputFile(pathname: String)

Provides an InputStream to a test file dependency.

InputStream

Provides an InputStream to an internal file used by the testing infrastructure.

OutputStream

Provides an OutputStream to an internal file used by the testing infrastructure.

OutputStream

Provides an OutputStream to a test output file.

OutputStream
openOutputFile(pathname: String, append: Boolean)

Provides an OutputStream to a test output file.

Public constructors

FileTestStorage

FileTestStorage()

Public functions

addOutputProperties

fun addOutputProperties(properties: Map<StringSerializable>): Unit

Test output properties is not supported when raw file I/O is used.

getInputArg

fun getInputArg(argName: String): String

Test input arguments is not supported when raw file I/O is used.

null is always returned.

getInputArgs

fun getInputArgs(): Map<StringString>

Test input arguments is not supported when raw file I/O is used.

An empty map is always returned.

getOutputProperties

fun getOutputProperties(): Map<StringSerializable>

Test output properties is not supported when raw file I/O is used.

An empty map is always returned.

openInputFile

fun openInputFile(pathname: String): InputStream

Provides an InputStream to a test file dependency.

Parameters
pathname: String

path to the test file dependency. Should not be null. This is an absolute file path on the device, and it's the infrastructure/client's responsibility to make sure the file path is readable.

openInternalInputFile

fun openInternalInputFile(pathname: String): InputStream

Provides an InputStream to an internal file used by the testing infrastructure.

Parameters
pathname: String

path to the internal input file. Should not be null. This is an absolute file path on the device, and it's the infrastructure/client's responsibility to make sure the file path is readable.

openInternalOutputFile

fun openInternalOutputFile(pathname: String): OutputStream

Provides an OutputStream to an internal file used by the testing infrastructure.

Parameters
pathname: String

path to the internal output file. Should not be null. This is an absolute file path on the device, and it's the infrastructure/client's responsibility to make sure the file path is writable.

openOutputFile

fun openOutputFile(pathname: String): OutputStream

Provides an OutputStream to a test output file.

Parameters
pathname: String

path to the test file dependency. Should not be null. This is an absolute file path on the device, and it's the infrastructure/client's responsibility to make sure the file path is writable.

openOutputFile

fun openOutputFile(pathname: String, append: Boolean): OutputStream

Provides an OutputStream to a test output file.

Parameters
pathname: String

path to the test output file. Should not be null.

append: Boolean

if true, then the lines will be added to the end of the file rather than overwriting.

Returns
OutputStream

an OutputStream to the given output file.