Search code examples
warningscordova-pluginscordova-facebook

What does this Cordova registry warning mean in the github facebook login plugin documentation?


After navigating to the github documentation for facebook from intel xdk plugin management section the second most prominent thing you see on the page is this.

<< --- Cordova Registry Warning [iOS]

Installing this plugin directly from Cordova Registry results in Xcode using a broken FacebookSDK.framework, this is because the current publish procedure to NPM breaks symlinks CB-6092. Please install the plugin through a locally cloned copy or re-add the FacebookSDK.framework to Xcode after installation.

------------------------------------------ >>

The link the the github page is here

https://github.com/Wizcorp/phonegap-facebook-plugin.

Can someone explain what this really means? It's already terribly confusing to get the basic fb login up and running on my mobile app, this warning is confusing the process for me even more as it assumes I know more than I do. Can someone break this down in beginner terms? Thank you.


Solution

  • Problem

    The FacebookSDK.framework will be delivered broken if you fetch it from NPM, because the publish procedure to NPM breaks symlinks. I can't tell you more then that.

    Workaround

    The workaround is cloning the repository of the plugin 'phonegap-facebook-plugin' with GIT and adding the plugin to your PhoneGap/Cordova project.

    Enter the following command in your CMD or Terminal to clone the repository:

    git clone https://github.com/Wizcorp/phonegap-facebook-plugin
    

    Enter the following command in your CMD or Terminal to add the plugin to your PhoneGap/Cordova project:

    cordova -d plugin add /path/to/cloned/phonegap-facebook-plugin --variable APP_ID="123456789" --variable APP_NAME="myApplication"
    

    Solution

    The developers of the plugin 'phonegap-facebook-plugin' have a solution for cordova > 4.0.0 in the develop branche of the plugin's repository.

    More info for installing the plugin: