Skip to content

Commit fac0489

Browse files
committed
docs(changeset): Async Storage v3
1 parent 2fa7201 commit fac0489

File tree

2 files changed

+29
-4
lines changed

2 files changed

+29
-4
lines changed

.changeset/afraid-masks-brush.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
"@react-native-async-storage/async-storage": major
3+
---
4+
5+
Async Storage v3
6+
7+
## General changes
8+
- Async Storage now provides a way to create isolated data storages, so your data does is not stored in "one bucket"
9+
- Default export is now a proxy to the legacy v2 implementation for gradual migration
10+
- You must now create storages using `createAsyncStorage(name)` — no default global storage instance
11+
- New website
12+
13+
## Breaking Changes:
14+
15+
- Android requires a `repositories.maven` added in project's `build.gradle`
16+
- You must now create storages using `createAsyncStorage(name)` — no default global storage instance.
17+
- `multiGet`, `multiSet`, and `multiRemove` renamed to `getMany`, `setMany`, and `removeMany`
18+
- The "multi" methods now accept object maps ({ key: value }) instead of arrays of pairs ([[key, value]])
19+
- `mergeItem` and `multiMerge` have been removed
20+
- `useAsyncStorage` hook has been removed
21+
- Methods now throw `AsyncStorageError` instead of using callbacks for error handling.
22+
- New Brownfield access (replaced delegate on iOS) for native platforms
23+
- iCloud backup exclusion flag removed (storage is excluded by default).
24+
- Web backend switched to IndexedDB
25+

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ It provides a simple API compatible with the [Web Storage API](https://developer
55

66
## Supported platforms
77

8-
- **Android** (SQLite backend via Room KMP)
9-
- **iOS** (SQLite backend via Room KMP)
10-
- **Web** (IndexedDB backend)
11-
- **macOS** (SQLite backend via Room KMP)
8+
- **Android** (SQLite)
9+
- **iOS** (SQLite)
10+
- **macOS** (SQLite)
1211
- **visionOS** (legacy fallback, single database only)
12+
- **Web** (IndexedDB backend)
1313
- **Windows** (legacy fallback, single database only)
1414

1515
## Compatibility

0 commit comments

Comments
 (0)