FacebookConnect (Codename One API)

java.lang.Object
- com.codename1.social.Login
- - com.codename1.social.FacebookConnect

```
public class FacebookConnect
extends Login
```
Invokes the native bundled facebook SDK to login/logout of facebook, notice that in order for this to work server build arguments must indicate that you are using the facebook sdk! To accomplish this just define: facebook.appId=YourAppId in your build arguments. In order to obtain the app ID you need to create a native Android/iOS application and generate the right app id.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`askPublishPermissions(LoginCallback lc)` Asks for publish permissions, this call might suspend the application which might trigger repeated invocations of stop()/start().
`protected Oauth2`	`createOauth2()` Creates the oauth2 to be used to login in case no native login is available for this service.
`void`	`doLogout()` Logs out the current user from facebook
`AccessToken`	`getAccessToken()` The facebook token that can be used to access facebook functionality
`static FacebookConnect`	`getInstance()` Gets the FacebookConnect singleton instance .
`String`	`getToken()` Deprecated. use getAccessToken instead
`boolean`	`hasPublishPermissions()` Returns true if the current session already has publish permissions
`void`	`inviteFriends(String appLinkUrl, String previewImageUrl)` Deprecated. The Facebook SDK no longer supports app invites. https://developers.facebook.com/blog/post/2017/11/07/changes-developer-offerings/
`void`	`inviteFriends(String appLinkUrl, String previewImageUrl, Callback cb)` Deprecated. The Facebook SDK no longer supports app invites https://developers.facebook.com/blog/post/2017/11/07/changes-developer-offerings/
`boolean`	`isFacebookSDKSupported()` Indicates whether the native platform supports native facebook login
`boolean`	`isInviteFriendsSupported()` Returns true if inviteFriends is implemented, it is supported on iOS and Android
`boolean`	`isLoggedIn()` Deprecated. use isUserLoggedIn() instead
`boolean`	`isNativeLoginSupported()` Returns true if this service supports native login.
`void`	`login()` Deprecated. use doLogin
`void`	`logout()` Deprecated. use doLogout instead
`boolean`	`nativeIsLoggedIn()` Indicates if the user is currently logged in.
`void`	`nativelogin()` Logs in the current user natively.
`void`	`nativeLogout()` Logs out the current user natively.
`protected boolean`	`validateToken(String token)` Returns true if the previous granted access token is still valid otherwise false.

Methods inherited from class com.codename1.social.Login
addScopes, connect, doLogin, doLogin, isPreferRedirectPrompt, isUserLoggedIn, setAccessToken, setCallback, setClientId, setClientSecret, setOauth2URL, setPreferRedirectPrompt, setRedirectURI, setScope, validateToken

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getInstance
```
public static FacebookConnect getInstance()
```
    Gets the FacebookConnect singleton instance .
    
    Returns:
    
    the FacebookConnect instance
  - isFacebookSDKSupported
```
public boolean isFacebookSDKSupported()
```
    Indicates whether the native platform supports native facebook login
    
    Returns:
    
    true if supported
  - login
```
public void login()
```
    Deprecated. use doLogin
    
    Logs into facebook, notice that this call might suspend the application which might trigger repeated invocations of stop()/start() etc. This is due to the facebook SDK spawning a separate process to perform the login then returning to the application. Once logged in the facebook credentials will be available.
  - doLogout
```
public void doLogout()
```
    Logs out the current user from facebook
    
    Overrides:
    
    doLogout in class Login
  - getAccessToken
```
public AccessToken getAccessToken()
```
    The facebook token that can be used to access facebook functionality
    
    Overrides:
    
    getAccessToken in class Login
    
    Returns:
    
    the token
  - isLoggedIn
```
public boolean isLoggedIn()
```
    Deprecated. use isUserLoggedIn() instead
    
    Indicates if the user is currently logged in
    
    Returns:
    
    true if logged in
  - getToken
```
public String getToken()
```
    Deprecated. use getAccessToken instead
    
    The facebook token that can be used to access facebook functionality
    
    Returns:
    
    the token
  - logout
```
public void logout()
```
    Deprecated. use doLogout instead
    
    Logs out the current user from facebook
  - askPublishPermissions
```
public void askPublishPermissions(LoginCallback lc)
```
    Asks for publish permissions, this call might suspend the application which might trigger repeated invocations of stop()/start().
  - hasPublishPermissions
```
public boolean hasPublishPermissions()
```
    Returns true if the current session already has publish permissions
    
    Returns:
  - isNativeLoginSupported
```
public boolean isNativeLoginSupported()
```
    Description copied from class: Login
    
    Returns true if this service supports native login. If implementation returns true here, the nativelogin, nativelogout, nativeIsLoggedIn should be implemented
    
    Specified by:
    
    isNativeLoginSupported in class Login
    
    Returns:
    
    true if the service supports native login
  - createOauth2
```
protected Oauth2 createOauth2()
```
    Description copied from class: Login
    
    Creates the oauth2 to be used to login in case no native login is available for this service.
    
    Overrides:
    
    createOauth2 in class Login
    
    Returns:
    
    the Oauth2 to be used to login if no native login available and on the simulator
  - nativelogin
```
public void nativelogin()
```
    Description copied from class: Login
    
    Logs in the current user natively. Subclasses that uses a native sdk to login/logout should override this method.
    
    Overrides:
    
    nativelogin in class Login
  - nativeLogout
```
public void nativeLogout()
```
    Description copied from class: Login
    
    Logs out the current user natively. Subclasses that uses a native sdk to login/logout should override this method.
    
    Overrides:
    
    nativeLogout in class Login
  - nativeIsLoggedIn
```
public boolean nativeIsLoggedIn()
```
    Description copied from class: Login
    
    Indicates if the user is currently logged in. Subclasses that uses a native sdk to login/logout should override this method.
    
    Overrides:
    
    nativeIsLoggedIn in class Login
    
    Returns:
    
    true if logged in
  - inviteFriends
```
public void inviteFriends(String appLinkUrl,
                          String previewImageUrl)
```
    Deprecated. The Facebook SDK no longer supports app invites. https://developers.facebook.com/blog/post/2017/11/07/changes-developer-offerings/
    
    Opens and invite dialog to invite friends to the app https://developers.facebook.com/docs/app-invites
    
    Parameters:
    
    appLinkUrl - App Link for what should be opened when the recipient clicks on the install/play button on the app invite page.
    
    previewImageUrl - url to an image to be used in the invite, can be null
  - inviteFriends
```
public void inviteFriends(String appLinkUrl,
                          String previewImageUrl,
                          Callback cb)
```
    Deprecated. The Facebook SDK no longer supports app invites https://developers.facebook.com/blog/post/2017/11/07/changes-developer-offerings/
    
    Opens and invite dialog to invite friends to the app https://developers.facebook.com/docs/app-invites
    
    Parameters:
    
    appLinkUrl - App Link for what should be opened when the recipient clicks on the install/play button on the app invite page.
    
    previewImageUrl - url to an image to be used in the invite, can be null
    
    cb - a Callback to be used when we need to know if the Facebook invite was successful. If the invite was successful the onSucess method will be called If the user canceled the onError method will be called with error code -1. If an error occurred the onError method will be called with error code 0.
  - isInviteFriendsSupported
```
public boolean isInviteFriendsSupported()
```
    Returns true if inviteFriends is implemented, it is supported on iOS and Android
    NOTE: Since updating to Facebook SDK 5.6.0 (April 1, 2020), invite friends is no longer supported on iOS. It will eventually be removed from Android as well, as Facebook no longer supports App invites in its native SDKs.
    
    Returns:
    
    true if inviteFriends is implemented
  - validateToken
```
protected boolean validateToken(String token)
```
    Description copied from class: Login
    
    Returns true if the previous granted access token is still valid otherwise false.
    
    Specified by:
    
    validateToken in class Login
    
    Parameters:
    
    token - the access token to check
    
    Returns:
    
    true of the token is valid

Class FacebookConnect

Method Summary

Methods inherited from class com.codename1.social.Login

Methods inherited from class java.lang.Object

Method Detail

getInstance

isFacebookSDKSupported

login

doLogout

getAccessToken

isLoggedIn

getToken

logout

askPublishPermissions

hasPublishPermissions

isNativeLoginSupported

createOauth2

nativelogin

nativeLogout

nativeIsLoggedIn

inviteFriends

inviteFriends

isInviteFriendsSupported

validateToken