@capawesome/capacitor-asset-manager

Capacitor plugin to access native asset files.

Installation

npm install @capawesome/capacitor-asset-manager
npx cap sync

Usage

import { Directory, Filesystem } from '@capacitor/filesystem';
import { AssetManager, Encoding } from '@capawesome/capacitor-asset-manager';

const copy = async () => {
  const { uri } = await Filesystem.getUri({
    directory: Directory.Cache,
    path: 'index.html'
  });
  await AssetManager.copy({
    from: 'public/index.html',
    to: uri
  });
};

const list = async () => {
  await AssetManager.list({
    path: 'public'
  });
};

const read = async () => {
  const { data } = await AssetManager.read({
    encoding: Encoding.Utf8,
    path: 'capacitor.config.json'
  });
  return JSON.parse(data);
};

API

• copy(...)
• list(...)
• read(...)
• Interfaces
• Enums

copy(...)

copy(options: CopyOptions) => Promise<void>

Copy a file or directory from the app bundle to the app's data directory.

Only available on Android and iOS.

Param	Type
options	CopyOptions

Since: 7.0.0

---

list(...)

list(options?: ListOptions | undefined) => Promise<ListResult>

List files in a directory.

Only available on Android and iOS.

Param	Type
options	ListOptions

Returns: Promise<ListResult>

Since: 7.0.0

---

read(...)

read(options: ReadOptions) => Promise<ReadResult>

Read a file from the app bundle.

Attention: Reading large files can cause out of memory (OOM) issues. It is therefore recommended to copy files to the app's data directory using the copy method and read them from there using the fetch API.

Only available on Android and iOS.

Param	Type
options	ReadOptions

Returns: Promise<ReadResult>

Since: 7.0.0

---

Interfaces

CopyOptions

Prop	Type	Description	Since
from	string	The source path to copy from.	7.0.0
to	string	The destination path to copy to. Tip: Generate this path using the getUri(...) method of the Capacitor Filesystem plugin.	7.0.0

ListResult

Prop	Type	Description	Since
files	string[]	The list of files in the directory.	7.0.0

ListOptions

Prop	Type	Description	Since
path	string	The path to list files from. If not specified, the root path will be used.	7.0.0

ReadResult

Prop	Type	Description	Since
data	string	The content of the file.	7.0.0

ReadOptions

Prop	Type	Description	Default	Since
encoding	Encoding	The encoding to use when reading the file.	'base64'	7.0.0
path	string	The path to read the file from.		7.0.0

Enums

Encoding

Members	Value	Since
Base64	'base64'	7.0.0
Utf8	'utf8'	7.0.0

Changelog

See CHANGELOG.md.

License

See LICENSE.