diff --git a/android/3rd_party/facebook-android-sdk/CONTRIBUTING.mdown b/android/3rd_party/facebook-android-sdk/CONTRIBUTING.mdown
new file mode 100644
index 0000000000..a9e9ea55f1
--- /dev/null
+++ b/android/3rd_party/facebook-android-sdk/CONTRIBUTING.mdown
@@ -0,0 +1,15 @@
+Facebook welcomes contributions to our SDKs.
+
+All contributors must sign a CLA (contributor license agreement) here:
+
+ https://developers.facebook.com/opensource/cla
+
+To contribute on behalf of your employer, sign the company CLA
+To contribute on behalf of yourself, sign the individual CLA
+
+All contributions:
+
+1/ MUST be be licensed using the Apache License, Version 2.0
+2/ authors MAY retain copyright by adding their copyright notice to the appropriate flies
+
+More information on the Apache License can be found here: http://www.apache.org/foundation/license-faq.html
diff --git a/android/3rd_party/facebook-android-sdk/README.mdown b/android/3rd_party/facebook-android-sdk/README.mdown
new file mode 100644
index 0000000000..c52e978a9c
--- /dev/null
+++ b/android/3rd_party/facebook-android-sdk/README.mdown
@@ -0,0 +1,30 @@
+Facebook SDK for Android
+========================
+
+This open-source library allows you to integrate Facebook into your Android app.
+
+Learn more about about the provided samples, documentation, integrating the SDK into your app, accessing source code, and more at https://developers.facebook.com/android
+
+TRY IT OUT
+
+1. Check-out the tutorials available online at https://developers.facebook.com/docs/getting-started/facebook-sdk-for-android/3.0/
+
+2. Start coding! Visit https://developers.facebook.com/android for tutorials and reference documentation.
+
+LICENSE
+
+Except as otherwise noted, the Facebook SDK for Android is licensed under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0.html).
+
+Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+DEVELOPER TERMS
+
+- By enabling Facebook integrations, including through this SDK, you can share information with Facebook, including information about people’s use of your app. Facebook will use information received in accordance with our Data Use Policy (https://www.facebook.com/about/privacy/), including to provide you with insights about the effectiveness of your ads and the use of your app. These integrations also enable us and our partners to serve ads on and off Facebook.
+
+- You may limit your sharing of information with us by updating the Insights control in the developer tool (https://developers.facebook.com/apps//advanced).
+
+- If you use a Facebook integration, including to share information with us, you agree and confirm that you have provided appropriate and sufficiently prominent notice to and obtained the appropriate consent from your users regarding such collection, use, and disclosure (including, at a minimum, through your privacy policy). You further agree that you will not share information with us about children under the age of 13.
+
+- You agree to comply with all applicable laws and regulations and also agree to our Terms (https://www.facebook.com/policies/), including our Platform Policies (https://developers.facebook.com/policy/) and Advertising Guidelines, as applicable (https://www.facebook.com/ad_guidelines.php).
+
+By using the Facebook SDK for Android you agree to these terms.
diff --git a/android/3rd_party/facebook-android-sdk/build.gradle b/android/3rd_party/facebook-android-sdk/build.gradle
new file mode 100644
index 0000000000..2d3bec743b
--- /dev/null
+++ b/android/3rd_party/facebook-android-sdk/build.gradle
@@ -0,0 +1,9 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+buildscript {
+ repositories {
+ mavenCentral()
+ }
+ dependencies {
+ classpath 'com.android.tools.build:gradle:0.7.+'
+ }
+}
diff --git a/android/3rd_party/facebook-android-sdk/docs/allclasses-frame.html b/android/3rd_party/facebook-android-sdk/docs/allclasses-frame.html
index e547bac880..b2582624e1 100644
--- a/android/3rd_party/facebook-android-sdk/docs/allclasses-frame.html
+++ b/android/3rd_party/facebook-android-sdk/docs/allclasses-frame.html
@@ -2,9 +2,9 @@
-
+
All Classes
-
+
@@ -103,9 +103,11 @@
Sets whether events sent to Facebook should be restricted from being used for purposes than analytics and
- conversions, such as remarketing for this user.
Sets whether events sent to Facebook should be restricted from being used for purposes than analytics and
- conversions, such as remarketing for this user.
Sets whether events sent to Facebook should be restricted from being used for purposes than analytics and
- conversions, such as remarketing for this user. Defaults to false. This value is stored on the device and
- persists across app launches.
Sets whether events sent to Facebook should be restricted from being used for purposes than analytics and
- conversions, such as remarketing for this user. Defaults to false. This value is stored on the device and
- persists across app launches. Changes to this setting will apply to any events currently queued to be
- flushed, as well as any subsequent events.
-
Parameters:
context - Used to persist this value across app runs.
Notifies the events system that the app has launched & logs an activatedApp event. Should be called whenever
your app becomes active, typically in the onResume() method of each long-running Activity of your app.
-
Parameters:
context - Used to access the attributionId for non-authenticated users.
applicationId - The specific applicationId to report the activation for.
Beta Feature
-
+
Parameters:
context - Used to access the attributionId for non-authenticated users.
applicationId - The specific applicationId to report the activation for.
Access the behavior that AppEventsLogger uses to determine when to flush logged events to the server. This
setting applies to all instances of AppEventsLogger.
Set the behavior that this AppEventsLogger uses to determine when to flush logged events to the server. This
setting applies to all instances of AppEventsLogger.
Logs a purchase event with Facebook, in the specified amount and with the specified currency.
Parameters:
purchaseAmount - Amount of purchase, in the currency specified by the 'currency' parameter. This value
- will be rounded to the thousandths place (e.g., 12.34567 becomes 12.346).
currency - Currency used to specify the amount.
Beta Feature
-
+ will be rounded to the thousandths place (e.g., 12.34567 becomes 12.346).
public static interface Request.OnProgressCallback
+extends Request.Callback
+
Specifies the interface that consumers of the Request class can implement in order to be notified when a
+ progress is made on a particular request. The frequency of the callbacks can be controlled using
+ Settings.setOnProgressThreshold(long)
session - the Session to issue the Request on, or null; if non-null, the session must be in an opened state.
If there is no logged-in Facebook user, null is the expected choice.
context - the Application context from which the app ID will be pulled, and from which the 'attribution ID'
for the Facebook user is determined. If there has been no app ID set, an exception will be thrown.
session - the Session to issue the Request on, or null; if non-null, the session must be in an opened state.
If there is no logged-in Facebook user, null is the expected choice.
context - the Application context from which the app ID will be pulled, and from which the 'attribution ID'
for the Facebook user is determined. If there has been no app ID set, an exception will be thrown.
applicationId - explicitly specified Facebook App ID. If null, and there's a valid session, then the application ID
diff --git a/android/3rd_party/facebook-android-sdk/docs/com/facebook/RequestAsyncTask.html b/android/3rd_party/facebook-android-sdk/docs/com/facebook/RequestAsyncTask.html
index 6c388f77dd..83f238aba9 100644
--- a/android/3rd_party/facebook-android-sdk/docs/com/facebook/RequestAsyncTask.html
+++ b/android/3rd_party/facebook-android-sdk/docs/com/facebook/RequestAsyncTask.html
@@ -2,9 +2,9 @@
-
+
RequestAsyncTask
-
+
@@ -35,7 +35,7 @@
public static interface RequestBatch.OnProgressCallback
+extends RequestBatch.Callback
+
Specifies the interface that consumers of the RequestBatch class can implement in order to be notified when the
+ batch makes progress. The frequency of the callbacks can be controlled using
+ Settings.setOnProgressThreshold(long).
Sets the StatusCallback for the NewPermissionsRequest.
+
Sets the StatusCallback for the NewPermissionsRequest. Note that once the request is made, this callback
+ will be added to the session, and will receive all future state changes on the session.
Parameters:
statusCallback - The SessionStatusCallback to
notify regarding Session state changes.
Returns:
the NewPermissionsRequest object to allow for chaining
Gets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from
+ being used for purposes other than analytics and conversions, such as for targeting ads to this user.
Sets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from
+ being used for purposes other than analytics and conversions, such as for targeting ads to this user.
public static boolean getLimitEventAndDataUsage(Context context)
+
Gets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from
+ being used for purposes other than analytics and conversions, such as for targeting ads to this user. Defaults
+ to false. This value is stored on the device and persists across app launches.
public static void setLimitEventAndDataUsage(Context context,
+ boolean limitEventUsage)
+
Sets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from
+ being used for purposes other than analytics and conversions, such as for targeting ads to this user. Defaults
+ to false. This value is stored on the device and persists across app launches. Changes to this setting will
+ apply to app events currently queued to be flushed.
+
Parameters:
context - Used to persist this value across app runs.
public static void setOnProgressThreshold(long threshold)
+
Sets the threshold used to report progress on requests. Note that the value will be read when the
+ request is started and can not be changed during a request (or batch) execution.
+
Parameters:
threshold - The number of bytes progressed to force a callback.
actionType - the type of the Open Graph action to be published, which should be the namespace-qualified
- name of the action type (e.g., "myappnamespace:myactiontype"); this will override the type
- of the action passed in.
previewPropertyName - the name of a property on the Open Graph action that contains the
+ must not be null
action - the Open Graph action to be published, which must contain a reference to at least one
+ Open Graph object with the property name specified by setPreviewPropertyName; the action
+ must have had its type specified via the OpenGraphAction.setType(String) method
actionType - the type of the Open Graph action to be published, which should be the namespace-qualified
+ name of the action type (e.g., "myappnamespace:myactiontype"); this will override the type
+ of the action passed in.
previewPropertyName - the name of a property on the Open Graph action that contains the
Open Graph object which will be displayed as a preview to the user
@@ -280,233 +202,14 @@ public FacebookDialog.OpenGraphActionDialogBuilder(String previewPropertyName)
Constructor.
Parameters:
activity - the Activity which is presenting the native Open Graph action publish dialog;
- must not be null
action - the Open Graph action to be published, which must contain a reference to at least one
- Open Graph object with the property name specified by setPreviewPropertyName; the action
- must have had its type specified via the OpenGraphAction.setType(String) method
previewPropertyName - the name of a property on the Open Graph action that contains the
+ must not be null
action - the Open Graph action to be published, which must contain a reference to at least one
+ Open Graph object with the property name specified by setPreviewPropertyName; the action
+ must have had its type specified via the OpenGraphAction.setType(String) method
previewPropertyName - the name of a property on the Open Graph action that contains the
Open Graph object which will be displayed as a preview to the user
Specifies a list of images for the Open Graph action that should be uploaded prior to publishing the
- action. The action must already have been set prior to calling this method. This method will generate unique
- names for the image attachments and update the action to refer to these attachments. Note that calling
- setAction again after calling this method will not clear the image attachments already set, but the new
- action will have no reference to the existing attachments. The images will not be marked as being
- user-generated.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
bitmaps - a list of Bitmaps to be uploaded and attached to the Open Graph action
Specifies a list of images for the Open Graph action that should be uploaded prior to publishing the
- action. The action must already have been set prior to calling this method. This method will generate unique
- names for the image attachments and update the action to refer to these attachments. Note that calling
- setAction again after calling this method will not clear the image attachments already set, but the new
- action will have no reference to the existing attachments. The images may be marked as being
- user-generated -- refer to
- this article
- for more information.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
bitmaps - a list of Bitmaps to be uploaded and attached to the Open Graph action
isUserGenerated - if true, specifies that the user_generated flag should be set for these images
Specifies a list of images for the Open Graph action that should be uploaded prior to publishing the
- action. The action must already have been set prior to calling this method. The images will not be marked
- as being user-generated. This method will generate unique names for the image attachments and update the
- action to refer to these attachments. Note that calling setAction again after calling this method will
- not clear the image attachments already set, but the new action will have no reference to the existing
- attachments.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
bitmapFiles - a list of Files containing bitmaps to be uploaded and attached to the Open Graph action
Specifies a list of images for the Open Graph action that should be uploaded prior to publishing the
- action. The action must already have been set prior to calling this method. The images may be marked as being
- user-generated -- refer to
- this article
- for more information. This method will generate unique
- names for the image attachments and update the action to refer to these attachments. Note that calling
- setAction again after calling this method will not clear the image attachments already set, but the new
- action will have no reference to the existing attachments.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
bitmapFiles - a list of Files containing bitmaps to be uploaded and attached to the Open Graph action
isUserGenerated - if true, specifies that the user_generated flag should be set for these images
Specifies a list of images for an Open Graph object referenced by the action that should be uploaded
- prior to publishing the action. The images will not be marked as user-generated.
- The action must already have been set prior to calling this method, and
- the action must have a GraphObject-valued property with the specified property name. This method will
- generate unique names for the image attachments and update the graph object to refer to these
- attachments. Note that calling setObject again after calling this method, or modifying the value of the
- specified property, will not clear the image attachments already set, but the new action (or objects)
- will have no reference to the existing attachments.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
objectProperty - the name of a property on the action that corresponds to an Open Graph object;
- the object must be marked as a new object to be created
- (i.e., OpenGraphObject.getCreateObject() must return
- true) or an exception will be thrown
bitmapFiles - a list of Files containing bitmaps to be uploaded and attached to the Open Graph object
Specifies a list of images for an Open Graph object referenced by the action that should be uploaded
- prior to publishing the action. The images may be marked as being
- user-generated -- refer to
- this article
- for more information.
- The action must already have been set prior to calling this method, and
- the action must have a GraphObject-valued property with the specified property name. This method will
- generate unique names for the image attachments and update the graph object to refer to these
- attachments. Note that calling setObject again after calling this method, or modifying the value of the
- specified property, will not clear the image attachments already set, but the new action (or objects)
- will have no reference to the existing attachments.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
objectProperty - the name of a property on the action that corresponds to an Open Graph object;
- the object must be marked as a new object to be created
- (i.e., OpenGraphObject.getCreateObject() must return
- true) or an exception will be thrown
objectProperty - the name of a property on the action that corresponds to an Open Graph object
bitmapFiles - a list of Files containing bitmaps to be uploaded and attached to the Open Graph object
isUserGenerated - if true, specifies that the user_generated flag should be set for these images
Specifies a list of images for an Open Graph object referenced by the action that should be uploaded
- prior to publishing the action. The images will not be marked as user-generated.
- The action must already have been set prior to calling this method, and
- the action must have a GraphObject-valued property with the specified property name. This method will
- generate unique names for the image attachments and update the graph object to refer to these
- attachments. Note that calling setObject again after calling this method, or modifying the value of the
- specified property, will not clear the image attachments already set, but the new action (or objects)
- will have no reference to the existing attachments.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
objectProperty - the name of a property on the action that corresponds to an Open Graph object;
- the object must be marked as a new object to be created
- (i.e., OpenGraphObject.getCreateObject() must return
- true) or an exception will be thrown
bitmaps - a list of Bitmaps to be uploaded and attached to the Open Graph object
Specifies a list of images for an Open Graph object referenced by the action that should be uploaded
- prior to publishing the action. The images may be marked as being
- user-generated -- refer to
- this article
- for more information.
- The action must already have been set prior to calling this method, and
- the action must have a GraphObject-valued property with the specified property name. This method will
- generate unique names for the image attachments and update the graph object to refer to these
- attachments. Note that calling setObject again after calling this method, or modifying the value of the
- specified property, will not clear the image attachments already set, but the new action (or objects)
- will have no reference to the existing attachments.
-
-
In order for the images to be provided to the Facebook application as part of the app call, the
- NativeAppCallContentProvider must be specified correctly in the application's AndroidManifest.xml.
-
Parameters:
objectProperty - the name of a property on the action that corresponds to an Open Graph object;
- the object must be marked as a new object to be created
- (i.e., OpenGraphObject.getCreateObject() must return
- true) or an exception will be thrown
bitmaps - a list of Bitmaps to be uploaded and attached to the Open Graph object
isUserGenerated - if true, specifies that the user_generated flag should be set for these images
-
Returns:
this instance of the builder
-
-
-
-
@@ -558,13 +261,13 @@ public FacebookDialog.OpenGraphActionDialogBuilder(Field |
Provides a builder which can construct a FacebookDialog instance suitable for presenting the native
Share dialog. This builder will throw an exception if the Facebook application is not installed, so it
- should only be used if FacebookDialog.checkCanPresentShareDialog() indicates the capability
- is available.
true if all of the specified features are supported by the currently installed version of the
- Facebook application; false if any of the features are not supported
true if all of the specified features are supported by the currently installed version of the
- Facebook application; false if any of the features are not supported
+ Facebook application; false if any of the features are not supported
diff --git a/android/3rd_party/facebook-android-sdk/docs/com/facebook/widget/FriendPickerFragment.html b/android/3rd_party/facebook-android-sdk/docs/com/facebook/widget/FriendPickerFragment.html
index 75d38de9dd..9b27230efb 100644
--- a/android/3rd_party/facebook-android-sdk/docs/com/facebook/widget/FriendPickerFragment.html
+++ b/android/3rd_party/facebook-android-sdk/docs/com/facebook/widget/FriendPickerFragment.html
@@ -2,9 +2,9 @@
-
+
FriendPickerFragment
-
+
@@ -233,25 +233,55 @@ extends
Updates the properties of the PickerFragment based on the contents of the supplied Bundle;
calling Activities may use this to pass additional configuration information to the
PickerFragment beyond what is specified in its XML layout.
forceReload - if true, data will be loaded even if there is already data being displayed (or loading);
+ if false, data will not be re-loaded if it is already displayed (or loading)
Constructor that builds a Feed Dialog using the provided session.
Parameters:
context - the Context within which the dialog will be shown.
session - the Session representing an authenticating user to use for
showing the dialog; must not be null, and must be opened.
@@ -234,19 +259,37 @@ extends
-
+
WebDialog.FeedDialogBuilder
public WebDialog.FeedDialogBuilder(Context context,
Session session,
Bundle parameters)
-
Constructor.
-
Parameters:
context - the Context within which the dialog will be shown.
parameters - a Bundle containing parameters to pass as part of the
+
Constructor that builds a Feed Dialog using the provided session and parameters.
+
Parameters:
context - the Context within which the dialog will be shown.
session - the Session representing an authenticating user to use for
+ showing the dialog; must not be null, and must be opened.
parameters - a Bundle containing parameters to pass as part of the
dialog URL. No validation is done on these parameters; it is
the caller's responsibility to ensure they are valid. For more information,
see
- https://developers.facebook.com/docs/reference/dialogs/feed/.
session - the Session representing an authenticating user to use for
- showing the dialog; must not be null, and must be opened.
public WebDialog.FeedDialogBuilder(Context context,
+ String applicationId,
+ Bundle parameters)
+
Constructor that builds a Feed Dialog using the provided application ID and parameters.
+
Parameters:
context - the Context within which the dialog will be shown.
applicationId - the application ID to use. If null, the application ID specified in the
+ application/meta-data will be used instead.
parameters - a Bundle containing parameters to pass as part of the
+ dialog URL. No validation is done on these parameters; it is
+ the caller's responsibility to ensure they are valid. For more information,
+ see
+ https://developers.facebook.com/docs/reference/dialogs/feed/.
Constructor that builds a Requests Dialog using the provided session.
Parameters:
context - the Context within which the dialog will be shown.
session - the Session representing an authenticating user to use for
showing the dialog; must not be null, and must be opened.
@@ -211,19 +236,37 @@ extends
-
+
WebDialog.RequestsDialogBuilder
public WebDialog.RequestsDialogBuilder(Context context,
Session session,
Bundle parameters)
-
Constructor.
-
Parameters:
context - the Context within which the dialog will be shown.
parameters - a Bundle containing parameters to pass as part of the
+
Constructor that builds a Requests Dialog using the provided session and parameters.
+
Parameters:
context - the Context within which the dialog will be shown.
session - the Session representing an authenticating user to use for
+ showing the dialog; must not be null, and must be opened.
parameters - a Bundle containing parameters to pass as part of the
dialog URL. No validation is done on these parameters; it is
the caller's responsibility to ensure they are valid. For more information,
see
- https://developers.facebook.com/docs/reference/dialogs/requests/.
session - the Session representing an authenticating user to use for
- showing the dialog; must not be null, and must be opened.
public WebDialog.RequestsDialogBuilder(Context context,
+ String applicationId,
+ Bundle parameters)
+
Constructor that builds a Requests Dialog using the provided application ID and parameters.
+
Parameters:
context - the Context within which the dialog will be shown.
applicationId - the application ID to use. If null, the application ID specified in the
+ application/meta-data will be used instead.
parameters - a Bundle containing parameters to pass as part of the
+ dialog URL. No validation is done on these parameters; it is
+ the caller's responsibility to ensure they are valid. For more information,
+ see
+ https://developers.facebook.com/docs/reference/dialogs/requests/.
Gets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from
+ being used for purposes other than analytics and conversions, such as for targeting ads to this user.
Sets whether events sent to Facebook should be restricted from being used for purposes than analytics and
- conversions, such as remarketing for this user.
Gets the current OnSelectionChangedListener for this fragment, which will be called
@@ -2112,13 +2140,17 @@ or to a theme attribute in the form "?[package:][type:]na
Sets whether data such as that generated through AppEventsLogger and sent to Facebook should be restricted from
+ being used for purposes other than analytics and conversions, such as for targeting ads to this user.
Sets whether events sent to Facebook should be restricted from being used for purposes than analytics and
- conversions, such as remarketing for this user.
Sets the current OnSelectionChangedListener for this fragment, which will be called
@@ -4298,10 +4286,6 @@ or to a theme attribute in the form "?[package:][type:]na
Sets the Open Graph action which was created when this Open Graph action was posted, if it is a user-owned
@@ -4378,10 +4358,6 @@ or to a theme attribute in the form "?[package:][type:]na
Sets the unique string which will be passed to the OG Action owner's website
when a user clicks through this action on Facebook.