From 5f0eed22cf84b912093a451a9ee62121b7a0ed63 Mon Sep 17 00:00:00 2001
From: Tommy Nguyen <4123478+tido64@users.noreply.github.com>
Date: Thu, 30 May 2019 09:30:33 +0200
Subject: [PATCH 1/3] chore: add things to try for common issues

---
 docs/Troubleshooting.md | 56 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 docs/Troubleshooting.md

diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md
new file mode 100644
index 00000000..a2ce878b
--- /dev/null
+++ b/docs/Troubleshooting.md
@@ -0,0 +1,56 @@
+# Troubleshooting
+
+## [iOS] CocoaPods issues
+
+1. Delete the `node_modules` folder(s) from your project
+2. Run `yarn` or `npm install`
+3. If you're using CocoaPods:
+    1. Make sure your `Podfile` has this entry:
+        ```Podfile
+        pod 'RNCAsyncStorage', :path => '../node_modules/@react-native-community/sync-storage'
+        ```
+    2. Make sure your `Podfile` does _not_ have an entry for `react-native-async-storage`.
+    3. `pod install`
+    4. `pod update RNCAsyncStorage`
+4. Open your Xcode project
+5. Press ⇧⌥⌘K to clean your build folder
+6. Build and run your project
+
+> Note that every time `@react-native-community/async-storage` gets updated, you
+> must also run `pod update RNCAsyncStorage` otherwise you'll still be using the
+> previous version.
+
+## [iOS] fatal error: 'React/RCTBridgeModule.h' file not found
+
+```
+info In file included from /~/@react-native-community/async-storage/ios/RNCAsyncStorage.m:8:
+/~/@react-native-community/async-storage/ios/RNCAsyncStorage.h:8:9: fatal error: 'React/RCTBridgeModule.h' file not found
+
+info #import <React/RCTBridgeModule.h>
+             ^~~~~~~~~~~~~~~~~~~~~~~~~
+
+info 1 error generated.
+```
+
+- Make sure that you've run `pod install` (see also CocoaPods issues).
+
+- If you've manually linked React Native, but use CocoaPods for AsyncStorage,
+  AsyncStorage will not be able to find React headers. You'll need to set header
+  search path, or also consume React Native via CocoaPods.
+
+- Make sure that `React` dependencies are _not_ removed from projects. Without
+  the target dependency set, Xcode may build things out of order and the React
+  headers will not be installed when AsyncStorage is built.
+
+  ```Podfile
+  post_install do |installer|
+    installer.pods_project.targets.each do |target|
+      if target.name == "React"
+        target.remove_from_project
+      end
+    end
+  end
+  ```
+
+- Try switching back to the legacy build system in Xcode. You can find it in
+  File > Project/Workspace Settings sheet.

From 283b60e6a22fca07a19be9cad64ce9cfc77b9190 Mon Sep 17 00:00:00 2001
From: Tommy Nguyen <4123478+tido64@users.noreply.github.com>
Date: Thu, 30 May 2019 09:34:10 +0200
Subject: [PATCH 2/3] Added hyperlink

---
 docs/Troubleshooting.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md
index a2ce878b..a7145481 100644
--- a/docs/Troubleshooting.md
+++ b/docs/Troubleshooting.md
@@ -32,7 +32,7 @@ info #import <React/RCTBridgeModule.h>
 info 1 error generated.
 ```
 
-- Make sure that you've run `pod install` (see also CocoaPods issues).
+- Make sure that you've run `pod install` (see also [CocoaPods issues](#ios-cocoapods-issues)).
 
 - If you've manually linked React Native, but use CocoaPods for AsyncStorage,
   AsyncStorage will not be able to find React headers. You'll need to set header

From d2762218a2386e000e5b8a70209a03131478aa12 Mon Sep 17 00:00:00 2001
From: Tommy Nguyen <4123478+tido64@users.noreply.github.com>
Date: Thu, 30 May 2019 12:47:55 +0200
Subject: [PATCH 3/3] Added some things for "AsyncStorage is null"

---
 docs/Troubleshooting.md | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md
index a7145481..2b1ae661 100644
--- a/docs/Troubleshooting.md
+++ b/docs/Troubleshooting.md
@@ -32,7 +32,8 @@ info #import <React/RCTBridgeModule.h>
 info 1 error generated.
 ```
 
-- Make sure that you've run `pod install` (see also [CocoaPods issues](#ios-cocoapods-issues)).
+- Make sure that you've run `pod install` or `pod update RNCAsyncStorage` (see
+  also [CocoaPods issues](#ios-cocoapods-issues)).
 
 - If you've manually linked React Native, but use CocoaPods for AsyncStorage,
   AsyncStorage will not be able to find React headers. You'll need to set header
@@ -54,3 +55,18 @@ info 1 error generated.
 
 - Try switching back to the legacy build system in Xcode. You can find it in
   File > Project/Workspace Settings sheet.
+
+## [@RNC/AsyncStorage]: NativeModule: AsyncStorage is null
+
+### iOS
+
+This error means that AsyncStorage was unable to find its native module. This
+occurs because AsyncStorage was not linked into the final app bundle.
+
+- Make sure that you've run `pod install` or `pod update RNCAsyncStorage` (see
+  also [CocoaPods issues](#ios-cocoapods-issues)).
+
+- If you have an Expo app, AsyncStorage will not work unless you eject the app.
+  After ejecting the app, you may have to
+  [manually link](Linking.md#project-linking) depending on whether you chose to
+  use Expo SDK.