forked from Wizcorp/phonegap-facebook-plugin
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
8743e64
commit daf6c36
Showing
33 changed files
with
1 addition
and
18,061 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,161 +1 @@ | ||
| # Apache Cordova Facebook Connect Plugin | ||
|
|
||
| This is the official plugin for Facebook Connect in Apache Cordova/PhoneGap! | ||
|
|
||
| The Facebook Connect plugin for Apache Cordova allows you to use the same JavaScript code in your web application as you use in your native Cordova application, but your native Cordova application will use the Facebook native app to perform Single Sign On for the user (if possible - if it isn't then it will fall back to dialog-based authentication). | ||
|
|
||
| This is all licensed under MIT except for `app/www/facebook_js_sdk.js` which is the Facebook JS SDK and is Apache 2.0. | ||
|
|
||
| # Requirements | ||
|
|
||
| * PhoneGap (Cordova) v2.2.0 (For compatibility with older versions of PhoneGap (1.4.1 or less), please download the tag [1.4.1support](https://github.com/davejohnson/phonegap-plugin-facebook-connect/zipball/1.4.1support)) | ||
|
|
||
| The Facebook SDK (both native and JavaScript) is changing independent of this plugin. The install instruction include how to get the latest SDK for use in your project. | ||
|
|
||
| To use this plugin you will need to make sure you've registered your Facebook app with Facebook and have an APP_ID (https://developers.facebook.com/apps). | ||
|
|
||
| If you plan on rolling this out on iOS, please note that you will need to ensure that you have properly set up your Native iOS App settings on the [Facebook App Dashboard](http://developers.facebook.com/apps). Please see the [Getting Started with the Facebook SDK](https://developers.facebook.com/docs/getting-started/facebook-sdk-for-ios/3.1/): Create a Facebook App section, for more details on this. | ||
|
|
||
| If you plan on rolling this out on Android, please note that you will need to [generate a hash of your Android key(s) and submit those to the Developers page on Facebook](https://developers.facebook.com/docs/getting-started/facebook-sdk-for-android/3.0/) to get it working. Furthermore, if you are generating this hash on Windows (specifically 64 bit versions), please use version 0.9.8e or 0.9.8d of [OpenSSL for Windows](http://code.google.com/p/openssl-for-windows/downloads/list) and *not* 0.9.8k. Big ups to [fernandomatos](http://github.com/fernandomatos) for pointing this out! | ||
|
|
||
| # Project Structure | ||
|
|
||
| <pre> | ||
| |-example | ||
| | `-www | ||
| | `-index.html | ||
| |-lib | ||
| | |-facebook-js-patch | ||
| | |-facebook_js_sdk.js | ||
| | |-facebook-android-sdk | ||
| | `-facebook-ios-sdk | ||
| |-native | ||
| | |-android | ||
| | `-ios | ||
| `-www | ||
| `-cdv-plugin-fb-connect.js | ||
| </pre> | ||
|
|
||
| `lib/facebook-js-patch` can be ignored. It is currently not used. | ||
|
|
||
| `lib/facebook_js_sdk.js` is the modified facebook-js-sdk. It already includes the hooks to work with this plugin. | ||
|
|
||
| `native/android` and `native/ios` contain the native code for the plugin for both Android and iOS platforms. | ||
|
|
||
| `www/cdv-plugin-fb-connect.js` is the JavaScript code for the plugin, this defines the JS API. | ||
|
|
||
|
|
||
| # Getting Started | ||
|
|
||
| ## Android | ||
|
|
||
| 1. [Create a basic Cordova Android application](http://docs.phonegap.com/en/2.2.0/guide_getting-started_android_index.md.html#Getting%20Started%20with%20Android). | ||
| * NOTE: Min Target has to be set to 8. The plugin has an issue if you set your minimum target higher than that. You can edit this in your Android Manifest file. Set the Project Build Target to at least 11 if you see Android Manifest errors related to newer attributes that have been added in 2.2.0. | ||
|
|
||
| 2. In the Cordova Android application you will need to put the following in your `res/xml/config.xml` file as a child to the plugin tag: <pre><plugin name="org.apache.cordova.facebook.Connect" value="org.apache.cordova.facebook.ConnectPlugin" /></pre> | ||
|
|
||
| 3. You'll need to set up the Facebook SDK for Android: | ||
| * [Install the Facebook SDK for Android and the Facebook APK](https://developers.facebook.com/docs/getting-started/facebook-sdk-for-android/3.0/) | ||
| * [Import the Facebook SDK into Eclipse](https://developers.facebook.com/docs/getting-started/facebook-sdk-for-android/3.0/) | ||
| * Link the Facebook SDK library to your project. View the properties for the project, and navigate to the 'Android' tab. In the lower part of the dialog, click 'Add' and choose the 'FacebookSDK' project from the workspace. | ||
| * Add a new `com.facebook.LoginActivity` activity to your app to handle Facebook Login. Open up your `AndroidManifest.xml` file and add this additional activity: | ||
|
|
||
| <activity android:name="com.facebook.LoginActivity" | ||
| android:label="@string/app_name" /> | ||
|
|
||
| 4. From the Cordova Facebook Connect Plugin folder copy the src folder from `native/android/` folder into the root of your Cordova Android application. It should merge with the existing src folder. | ||
|
|
||
| 5. From the Cordova Facebook Connect Plugin folder copy the `www/cdv-plugin-fb-connect.js`, `lib/facebook_js_sdk.js` and `example/HackBook/` files into your application's `assets/www` folder. Overwrite the existing index.html file. | ||
|
|
||
| 6. Replace your appId in the new index.html file. Leave the quotes. | ||
|
|
||
| Now you are ready to create your application! Check out the `example` folder for what the HTML, JS etc looks like. | ||
|
|
||
| You can run the application from either the command line (`ant clean && ant debug install`) or from Eclipse. | ||
|
|
||
| ## iOS (Mac OS X) | ||
|
|
||
| NOTE 1: If you are having problems with SBJSON conflicts, download the latest version of git clone the latest cordova-ios code, build the installer, and run the installer to get updated! | ||
|
|
||
| NOTE 2: If you're upgrading from SDK 3.0 to 3.1 in the iOS6, you can't ask for both read and write permissions when the user is authenticating. If you do this you'll get a `com.facebook.sdk error 2` error alert. This happens due to a flow change in the 3.1 SDK. More info about this can be found in the [official docs](https://developers.facebook.com/docs/tutorial/iossdk/upgrading-from-3.0-to-3.1/). Also, make sure you have configured the app's Bundle ID in the Facebook app details, under the "Native iOS App" configuration, otherwise you'll get another `com.facebook.sdk error 2` alert. At least, if some of your earlier authentications failed, the device may turn the app to off in Settings > Facebook > Allow These Apps to Use Your Account, so, make sure your app is allowed. | ||
|
|
||
| (To be updated) View the [Video](http://www.youtube.com/watch?v=nVxFGiIoPgk&list=UU-b4-PjK0gq4QDpIpsLiFdg&index=1&feature=plcp) | ||
|
|
||
| ### Create a Basic Cordova App | ||
|
|
||
| Create a basic Cordova iOS application by following the [PhoneGap Getting Started Guide](http://docs.phonegap.com/en/2.1.0/guide_getting-started_ios_index.md.html#Getting%20Started%20with%20iOS) | ||
|
|
||
| ### Add the Facebook iOS and JavaScript SDK | ||
|
|
||
| 1. Download the latest Facebook SDK for iOS from the [iOS Dev Center](https://developers.facebook.com/ios/). | ||
| 2. Add the Facebook SDK for iOS Framework by dragging the **FacebookSDK.framework** folder from the SDK installation folder into the Frameworks section of your Project Navigator. | ||
| 3. Choose 'Create groups for any added folders' and deselect 'Copy items into destination group's folder (if needed)' to keep the reference to the SDK installation folder, rather than creating a copy. | ||
| 4. Add the Facebook SDK for iOS resource bundle by dragging the **FacebookSDKResources.bundle** file from the **FacebookSDK.framework/Resources** folder into the Frameworks section of your Project Navigator. | ||
| 5. As you did when copying the Framework, choose 'Create groups for any added folders' and deselect 'Copy items into destination group's folder (if needed)' | ||
| 6. Add the headers by dragging the **DeprecatedHeaders** folder from the **FacebookSDK.framework/Versions/A/DeprecatedHeaders** folder into the Frameworks section of your Project Navigator. | ||
| 7. Choose 'Create groups for any added folders' and deselect 'Copy items into destination group's folder (if needed)'. This adds the headers as a reference. | ||
| 8. Click on your project's icon (the root element) in Project Navigator, select your **Project**, then the **Build Settings** tab, search for **Other Linker Flags**. | ||
| 9. Add the value **-lsqlite3.0** | ||
| 10. From the **Cordova Facebook Connect Plugin** folder copy the file **lib/facebook_js_sdk.js** into the **www** directory in Xcode. | ||
| 11. Click on your project's icon (the root element) in Project Navigator, select your **Target**, then the **Build Phases** tab, then the **Link Binary With Libraries** option. | ||
| 12. Add the **Social.framework** framework. Make it an optional framework to support pre iOS6 apps. | ||
| 13. Add the **Accounts.framework** framework. Make it an optional framework to support pre iOS6 apps. | ||
| 14. Add the **AdSupport.framework** framework. Make it an optional framework to support pre iOS6 apps. | ||
|
|
||
| ### Add the Cordova Facebook Connect Plugin | ||
|
|
||
| 1. From the **Cordova Facebook Connect Plugin** folder copy the contents of the **native/ios** folder into your app in Xcode (usually in the **Plugins** folder group). Make sure it is added as a "group" (yellow folder) | ||
| 2. Find the Cordova.plist file in the project navigator, expand the "Plugins" sub-tree, and add a new entry. For the key, add **org.apache.cordova.facebook.Connect**, and its value will be **FacebookConnectPlugin** | ||
| 3. From the **Cordova Facebook Connect Plugin** folder copy the contents of the **www** folder into the **www** directory in Xcode. | ||
| 4. Add the Facebook domains to the ExternalHosts lists, as described below. | ||
|
|
||
| ### Run the included samples | ||
|
|
||
| 1. Under the group **Supporting Files**, find your **[PROJECTNAME]-Info.plist**, add a new entry. For the key, add **FacebookAppID**, and its value is your Facebook **APP_ID** | ||
| 2. Under the group **Supporting Files**, find your **[PROJECTNAME]-Info.plist**, right-click on the file and select **Open As -> Source Code**, add the **URL Scheme** from the section below (you will need your Facebook **APP_ID**) | ||
| 3. You can quickly test the examples by following the next instructions then mirror the same process for your app. | ||
| 4. From the **example** folder, copy either the contents of HackBook folder or the Simple folder into your **www** directory in Xcode. Overwrite the original index.html file in your project. For HackBook, overwrite the original css and js folders as well. | ||
| 5. Make sure the <script> tags are added and are correct in the index.html. This include a tag for cordova-2.1.0.js, facebook_js_sdk.js and cdv-plugin-fb-connect.js. | ||
| 6. Add your AppID to your index.html. Should be in the callback for the deviceready event. Leave the quotes. | ||
| 7. Run the application in Xcode. | ||
|
|
||
|
|
||
| ### iOS URL Whitelist | ||
|
|
||
| The Facebook SDK will try to access various URLs, and their domains must be whitelisted in your Cordova.plist under ExternalHosts. | ||
|
|
||
| You can either add each subdomain separately: | ||
|
|
||
| * m.facebook.com | ||
| * graph.facebook.com | ||
| * api.facebook.com | ||
| * \*.fbcdn.net | ||
| * \*.akamaihd.net | ||
|
|
||
| Or you can allow all domains with: | ||
|
|
||
| * \* | ||
|
|
||
| ### iOS URL Scheme | ||
|
|
||
| Make sure you add the scheme to your [PROJECTNAME]-Info.plist (located as one of the files in your Xcode project), substitute [APP_ID] and [SCHEME_ID] below to the appropriate values. This is to handle the re-direct from Mobile Safari or the Facebook app, after permission authorization. | ||
|
|
||
| * [**SCHEME_ID**] is usually a unique identifier for the scheme, in reverse domain name notation (i.e com.facebook.phonegap.myscheme) | ||
| * [**APP_ID**] is the Facebook app id given by Facebook | ||
|
|
||
| <pre> | ||
| <key>FacebookAppID</key> | ||
| <string>[**APP_ID**]</string> | ||
| <key>CFBundleURLTypes</key> | ||
| <array> | ||
| <dict> | ||
| <key>CFBundleURLSchemes</key> | ||
| <array> | ||
| <string>fb[**APP_ID**]</string> | ||
| </array> | ||
| </dict> | ||
| </array> | ||
| </pre> | ||
|
|
||
|
|
||
|
|
||
| This repo has been moved to https://github.com/phonegap/phonegap-facebook-plugin. Please file any issues and send your pull requests there. |
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.