From 676a6518dc82f9dc89695114ec0499839bbea551 Mon Sep 17 00:00:00 2001
From: David Dal Busco <david.dalbusco@outlook.com>
Date: Wed, 9 Oct 2019 07:59:34 +0200
Subject: [PATCH] doc: cocoapods known erros (#810)

---
 CHANGELOG.md       |  4 ++++
 docs/ios/README.md | 22 +++++++++++++++++++++-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9902786ed..4217eef85 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,10 @@
 * **iOS:** Update Facebook iOS SDK v5.7.0 ([Facebook iOS SDK changelog](https://github.com/facebook/facebook-objc-sdk/blob/master/CHANGELOG.md) | Released: September 30 2019)
 * **Android:** Set per default usage of Facebook Android SDK v5.5.2 ([Facebook Android SDK changelog](https://github.com/facebook/facebook-android-sdk/blob/master/CHANGELOG.md) | Released: October 4 2019)
 
+## Docs
+
+* Document two known errors related to Cocoapods, Facebook iOS SDK and their related solutions
+
 <a name="6.1.0"></a>
 # [6.1.0](https://github.com/jeduan/cordova-plugin-facebook4/releases/tag/v6.1.0)
 
diff --git a/docs/ios/README.md b/docs/ios/README.md
index 51774e212..58224d754 100644
--- a/docs/ios/README.md
+++ b/docs/ios/README.md
@@ -30,8 +30,28 @@ If building your project in Xcode, you need to open `YourProject.xcworkspace` (n
 
 You can list the pod dependencies in your Cordova iOS project by installing [cocoapods-dependencies](https://github.com/segiddins/cocoapods-dependencies):
 
-```
+```bash
 sudo gem install cocoapods-dependencies
 cd platforms/ios/
 pod dependencies
  ```
+
+#### Error: pod: Command failed with exit code 31
+
+If you install the plugin and face the error `Failed to install 'cordova-plugin-facebook4': Error: pod: Command failed with exit code 31`, it probably means that your local Pod repo is not up-to-date. In order to solve the problem, prior the installation, run th following command in your platform to update your Pod repo:
+
+```bash
+pod update
+```
+
+#### 'FBSDKCoreKit/FBSDKCoreKit.h' file not found
+
+If you are using Cordova iOS < v5, you might face the error `'FBSDKCoreKit/FBSDKCoreKit.h' file not found`. To overcome this problem, edit the `plugin.xml` of the plugin in order to fetch de Facebook iOS SDK by adding the following `framework` references:
+
+```
+<framework src="FBSDKCoreKit" type="podspec" spec="X.Y.Z" />
+<framework src="FBSDKLoginKit" type="podspec" spec="X.Y.Z" />
+<framework src="FBSDKShareKit" type="podspec" spec="X.Y.Z" />
+```
+
+Replace `X.Y.Z` with the Facebook iOS SDK and remove and add your platform again.