Permalink
Browse files

Get rid of the example since it is messing people up. Add license for…

… FB android sdk. Fix up readme some more
  • Loading branch information...
1 parent 74f082b commit b57793fd17cfd576e3a7285010d211b839595be3 Dave Johnson committed Aug 24, 2011
Showing with 10,173 additions and 3,312 deletions.
  1. +30 −16 README.md
  2. +0 −508 example/iOS/PhoneGapFacebookConnect.xcodeproj/project.pbxproj
  3. +7 −0 example/iOS/PhoneGapFacebookConnect.xcodeproj/project.xcworkspace/contents.xcworkspacedata
  4. +10,037 −0 ...t.xcodeproj/project.xcworkspace/xcuserdata/davejohnson.xcuserdatad/UserInterfaceState.xcuserstate
  5. +76 −0 ...okConnect.xcodeproj/xcuserdata/davejohnson.xcuserdatad/xcschemes/PhoneGapFacebookConnect.xcscheme
  6. +22 −0 ...apFacebookConnect.xcodeproj/xcuserdata/davejohnson.xcuserdatad/xcschemes/xcschememanagement.plist
  7. +0 −29 example/iOS/PhoneGapFacebookConnect/Classes/AppDelegate.h
  8. +0 −111 example/iOS/PhoneGapFacebookConnect/Classes/AppDelegate.m
  9. +0 −46 example/iOS/PhoneGapFacebookConnect/PhoneGap.plist
  10. +0 −60 example/iOS/PhoneGapFacebookConnect/PhoneGapFacebookConnect-Info.plist
  11. +0 −8 example/iOS/PhoneGapFacebookConnect/PhoneGapFacebookConnect-Prefix.pch
  12. +0 −27 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBConnect.h
  13. BIN example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBDialog.bundle/images/close.png
  14. BIN example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBDialog.bundle/images/fbicon.png
  15. +0 −167 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBDialog.h
  16. +0 −656 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBDialog.m
  17. +0 −48 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBLoginDialog.h
  18. +0 −94 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBLoginDialog.m
  19. +0 −116 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBRequest.h
  20. +0 −367 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/FBRequest.m
  21. +0 −109 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/Facebook.h
  22. +0 −606 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/Facebook.m
  23. +0 −7 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FB_src/facebook_ios_sdk_Prefix.pch
  24. +0 −24 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FacebookConnectPlugin.h
  25. +0 −274 example/iOS/PhoneGapFacebookConnect/Plugins/FBPlugin/FacebookConnectPlugin.m
  26. +0 −1 example/iOS/PhoneGapFacebookConnect/Plugins/README
  27. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/controls_bg.png
  28. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/controls_bg@2x.png
  29. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/controls_bg~ipad.png
  30. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/microphone.png
  31. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/microphone@2x.png
  32. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/microphone~ipad.png
  33. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/record_button.png
  34. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/record_button@2x.png
  35. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/record_button~ipad.png
  36. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/recording_bg.png
  37. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/recording_bg@2x.png
  38. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/recording_bg~ipad.png
  39. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/stop_button.png
  40. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/stop_button@2x.png
  41. BIN example/iOS/PhoneGapFacebookConnect/Resources/Capture.bundle/stop_button~ipad.png
  42. +0 −10 example/iOS/PhoneGapFacebookConnect/Resources/en.lproj/Localizable.strings
  43. +0 −9 example/iOS/PhoneGapFacebookConnect/Resources/es.lproj/Localizable.strings
  44. BIN example/iOS/PhoneGapFacebookConnect/Resources/icons/icon-72.png
  45. BIN example/iOS/PhoneGapFacebookConnect/Resources/icons/icon.png
  46. BIN example/iOS/PhoneGapFacebookConnect/Resources/icons/icon@2x.png
  47. BIN example/iOS/PhoneGapFacebookConnect/Resources/splash/Default.png
  48. BIN example/iOS/PhoneGapFacebookConnect/Resources/splash/Default@2x.png
  49. BIN example/iOS/PhoneGapFacebookConnect/Resources/splash/Default~ipad.png
  50. +0 −2 example/iOS/PhoneGapFacebookConnect/en.lproj/InfoPlist.strings
  51. +0 −17 example/iOS/PhoneGapFacebookConnect/main.m
  52. 0 example/{iOS → }/www/facebook_js_sdk.js
  53. BIN example/{iOS → }/www/icon.png
  54. 0 example/{iOS → }/www/index.html
  55. 0 example/{iOS → }/www/pg-plugin-fb-connect.js
  56. 0 example/{iOS → }/www/phonegap-1.0.0.js
  57. +1 −0 native/android/libs/LICENSE
View
@@ -1,4 +1,4 @@
-Facebook Connect PhoneGap Plugin
+PhoneGap Facebook Connect Plugin
================================
This is the offical plugin for Facebook Connect in PhoneGap!
@@ -9,48 +9,62 @@ perform single sign on (SSO) for the user.
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.
+
Getting Started
----------------
+===============
Download the latest version of PhoneGap from www.phonegap.com.
Create an Android or iOS PhoneGap project -- those are the only platforms that the Facebook native application
currently runs on :(
-On Android you will need to put the following in your phonegap.xml / plugins.xml file:
+Check out the /example/www/index.html to see how it works.
<pre>
-&lt;plugin name="com.facebook.phonegap.Connect" value="com.phonegap.facebook.Connect" /&gt;
+|-lib
+| `-facebook_js_sdk.js
+|-natve
+| |-android
+| |-ios
+`-www
+ `-pg-plugin-fb-connect.js
</pre>
-http://wiki.phonegap.com/How%20to%20Install%20a%20PhoneGap%20Plugin%20for%20Android
+/lib/facebook_js_sdk.js is the modified facebook js sdk, these modifications will be in their repo soon.
-On iOS you will need to put the following in your PhoneGap.plist file:
+/native/android | ios is the native code for the plugin on both android and ios platforms.
+/www/pg-plugin-fb-connect.js is the JavaScript code for the plugin, this defines the public JS API.
+Currently this plugin does not support dialogs, that is coming soon!
+The Facebook SDK (both native and JavaScript) is changing independant of this plugin. The working version of the Facebook Android SDK is distributed with the plugin and as of writing this the supported Facebook iOS SDK commit SHA1 is 91f256424531030a454548693c3a6ca49ca3f35a.
-http://wiki.phonegap.com/How%20to%20Install%20a%20PhoneGap%20Plugin%20for%20iOS
+Android
+===============
+Create a basic PhoneGap Android application. See http://www.phonegap.com/start/#android
+In the PhoneGap Andoroid application you will need to put the following in your /res/xml/plugins.xml file:
+<pre>
+&lt;plugin name="com.facebook.phonegap.Connect" value="com.phonegap.facebook.Connect" /&gt;
+</pre>
-From the PhoneGap Facebook Connect Plugin folder copy the contents of the native/android/ folder into foobar/
+http://wiki.phonegap.com/How%20to%20Install%20a%20PhoneGap%20Plugin%20for%20Android
-From the PhoneGap Facebook Connect Plugin folder copy the app/www folder into foobar/assets/ overwriting the index.html and icon.png files but keeping the phonegap...js file.
+From the PhoneGap Facebook Connect Plugin folder copy the contents of the /native/android/ folder into the root of your PhoneGap Android application, add the Facebook Android SDK to the build path.
-From the PhoneGap Facebook Connect Plugin folder copy the www folder into foobar/assets/
+From the PhoneGap Facebook Connect Plugin folder copy the /www/pg-plugin-fb-connect.js and /lib/facebook_js_sdk.js files into your /assets/www/ folder.
-From terminal in the foobar folder (with an android device attached to your computer) run the following command:
+Now you are ready to create you application! Check out the example folder for what the HTML, JS etc looks like.
-<pre>
-ant debug install
-</pre>
+Now you can run the application from either the command line (ant debug install) or from Eclipse.
iOS (Mac OS X)
---------------
+===============
1. Make sure you've registered your Facebook app with Facebook, and have an **APP__ID** and **APP__SECRET**
2. Get the latest iOS source from [http://github.com/phonegap/phonegap-iphone](http://github.com/phonegap/phonegap-iphone) and read the README there about getting started with iOS.
@@ -62,7 +76,7 @@ iOS (Mac OS X)
8. From the **PhoneGap Facebook Connect Plugin** folder copy the contents of the **lib** folder into the **www** directory in Xcode
9. for Xcode 4, you will need to build it once, and heed the warning - this is an Xcode 4 template limitation. The warning instructions will tell you to drag copy the **www** folder into the project in Xcode (add as a **folder reference** which is a blue folder).
10. 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**)
-11. Download the **Facebook iOS SDK** from [https://github.com/facebook/facebook-ios-sdk](https://github.com/facebook/facebook-ios-sdk) and put it into your project folder
+11. Download the **Facebook iOS SDK** from [https://github.com/facebook/facebook-ios-sdk](https://github.com/facebook/facebook-ios-sdk) and put it into your project folder (currently works with version 91f256424531030a454548693c3a6ca49ca3f35a)
12. Drag the **facebook-ios-sdk.xcodeproj** file into your project, this will create it as a sub-project
13. Click on your project's icon (the root element) in Project Navigator, select your **Target**, and the **Build Phases** tab.
14. From the **Build Phases** tab, expand **Target Dependencies**, then click on the **+** button
Oops, something went wrong.

0 comments on commit b57793f

Please sign in to comment.