update local maven for android

Author: krizzu

docs/api/usage.md

@@ -32,7 +32,7 @@ The data in one storage instance is scoped to its name: using different names en
 
 !!! warning "Windows platform"
 
-    As of AsyncStorage v3.0, Windows platform does not support scoped storages. It fallsback to previous implementation - single storage per application.
+    As of AsyncStorage v3.0, Windows platform does not support scoped storages. It falls back to previous implementation - single storage per application.
 
 ## Using a storage
 

docs/index.md

@@ -29,7 +29,26 @@ npm install @react-native-async-storage/async-storage
 yarn add @react-native-async-storage/async-storage
 ```
 
-On iOS/macOS, don’t forget to install pods:
+### Android
+
+Inside your `android/build.gradle(.kts)` file, add link to local maven repo:
+
+```groovy
+allprojects {
+    repositories {
+        // ... others like google(), mavenCenterl()
+
+        maven {
+            // or uri("path/to/node_modules/@react-native-async-storage/async-storage/android/local_repo")
+            url = uri(project(":react-native-async-storage_async-storage").file("local_repo"))
+        }
+    }
+}
+```
+
+### iOS/macOS
+
+Install cocoapods dependencies:
 
 ```shell
 # inside macos/ios directory

docs/migration-to-3.md

@@ -2,23 +2,52 @@
 
 AsyncStorage v3 introduces some breaking changes to simplify the API and make it more consistent.
 
-## AsyncStorage instance needs to be created now
+## Key changes:
 
-AsyncStorage v3 introduced scoped storages, which needs to be created before use. Head to [Usage page](api/usage.md#creating-a-storage) to learn more.
+### Installation changes
 
-## Default export points to v2 storage
+Android requires local maven repo to be added in your `build.gradle(.kts)` file. Head over to [Installation step for Android](index.md#android) to learn more.
 
-To make transition easier, the default export still points to the v2 storage implementation, ensuring that no existing data is lost.
 
-## Removed callback arguments
+### `AsyncStorage` is now instance-based
 
-All methods now return Promises, and callbacks have been removed from all methods.
+In v3, AsyncStorage is no longer a singleton.  
+Each instance represents an **isolated storage area**, providing separation between data sets. Head over to [Usage page](api/usage.md#creating-a-storage) to learn more.
 
-## Removed merge functionality
+```typescript
+// create seperate storages
+const userStorage = createAsyncStorage('user');
+const cacheStorage = createAsyncStorage('cache');
+```
+
+### Default export still points to v2 storage
+
+To make upgrading smoother, the default export continues to reference the v2 implementation.
+This ensures that:
+
+- Your app continues to access previously stored data.
+- You can migrate incrementally to v3 instances.
+
+```typescript
+// Still works (uses v2 backend)
+import AsyncStorage from '@react-native-async-storage/async-storage';
+await AsyncStorage.setItem('foo', 'bar');
+```
+
+### Callbacks removed — Promises only
+
+All methods are now Promise-based.
+The old callback arguments have been removed to make the API simpler and more consistent.
+
+### Removed merge functionality
 
 AsyncStorage's "merge" behavior has historically been inconsistent across platforms. Rather than enforcing a platform-specific merging strategy, the merge API has been removed to avoid ambiguity.
 
-## Method signature changes
+### Errors are more predictable now
+
+All errors now thrown from `AsyncStorage` are instances of `AsyncStorageError` containing `type` of the error it represents. Head over to [Errors page](api/errors.md) to learn more.
+
+### Method signature changes
 
 The core methods
 
@@ -30,7 +59,7 @@ The core methods
 
 retain their signatures from v2, ensuring backward compatibility.
 
-### multiGet
+#### multiGet
 
 Renamed to `getMany` and returns a `Record<string, string | null>`, following a "what you request is what you get" rule: every key you pass in the request appears in the returned object, with `null` for keys that don’t exist in storage.
 
@@ -43,7 +72,7 @@ Renamed to `getMany` and returns a `Record<string, string | null>`, following a
 + getMany(keys: string[]): Promise<Record<string, string | null>>;
 ```
 
-### multiSet
+#### multiSet
 
 Renamed to `setMany`, accepts a `Record<string, string>` of key-value entries.
 
@@ -56,7 +85,7 @@ Renamed to `setMany`, accepts a `Record<string, string>` of key-value entries.
 + setMany(entries: Record<string, string>): Promise<void>;
 ```
 
-### multiRemove
+#### multiRemove
 
 Renamed to `removeMany`, accepts list of keys.
 
@@ -69,6 +98,3 @@ Renamed to `removeMany`, accepts list of keys.
 + removeMany(keys: string[]): Promise<void>;
 ```
 
-## Errors are more predictable now
-
-All errors now thrown from `AsyncStorage` are instances of `AsyncStorageError` containing `type` of the error it represents. Head over to [Errors page](api/errors.md) to learn more.

examples/react-native/android/build.gradle

@@ -39,5 +39,8 @@ allprojects {
         }()
         mavenCentral()
         google()
+        maven {
+            url = uri(project(":react-native-async-storage_async-storage").file("local_repo"))
+        }
     }
 }

packages/async-storage/android/build.gradle

@@ -84,18 +84,6 @@ android {
     }
 }
 
-project.afterEvaluate {
-    rootProject.allprojects {
-        println "projectname: ${it.name}"
-        repositories {
-            def proj = project(":react-native-async-storage_async-storage")
-            maven {
-                url = uri("${proj.projectDir}/local_repo")
-            }
-        }
-    }
-}
-
 repositories {
     mavenCentral()
     google()
@@ -107,7 +95,6 @@ dependencies {
 
 
     def room_version = getExtOrDefault("ROOM_VERSION")
-
     implementation "androidx.room:room-runtime:$room_version"
     implementation "androidx.room:room-ktx:$room_version"
     ksp "androidx.room:room-compiler:$room_version"