Added in API level 30

AssetsProvider

interface AssetsProvider
android.content.res.loader.AssetsProvider

Provides callbacks that allow for the value of a file-based resources or assets of a ResourcesProvider to be specified or overridden.

Summary

Public methods
open AssetFileDescriptor?
loadAssetFd(path: String, accessMode: Int)

Callback that allows the value of a file-based resources or asset to be specified or overridden.

Public methods

loadAssetFd

Added in API level 30
open fun loadAssetFd(
    path: String, 
    accessMode: Int
): AssetFileDescriptor?

Callback that allows the value of a file-based resources or asset to be specified or overridden.

The system will take ownership of the file descriptor returned from this method, so dup the file descriptor before returning if the system should not own it.

There are two situations in which this method will be called:

  • AssetManager is queried for an InputStream of an asset using APIs like android.content.res.AssetManager#open and android.content.res.AssetManager#openXmlResourceParser.
  • AssetManager is resolving the value of a file-based resource provided by the ResourcesProvider this instance is associated with.

If the value retrieved from this callback is null, AssetManager will attempt to find the file-based resource or asset within the APK provided by the ResourcesProvider this instance is associated with.

Parameters
path String: the asset path being loaded This value cannot be null.
accessMode Int: the AssetManager access mode

See Also