@capacitor-community/facebook-login
Plugin communautaire Capacitor pour la connexion native à Facebook.
Mainteneur | GitHub | Sociale | Entreprise sponsor |
---|---|---|---|
Masahiko Sakakibara | rdlabo | @rdlabo | ASSOCIATION LABO DE DESIGN RELATION, GÉNÉRAL INC. |
Réalisé avec les contributeurs-img.
Le code de démonstration est ici.
Si vous souhaitez connaître la version de la bibliothèque Facebook, vous devez vérifier :
% npm i --save @capacitor-community/facebook-login
% npx cap update
Les utilisateurs de Capacitor v5 doivent utiliser la version v5 du plugin.
% npm install @capacitor-community/facebook-login@5
Dans le fichier android/app/src/main/AndroidManifest.xml
, ajoutez les éléments XML suivants sous <manifest><application>
:
< meta-data android : name = " com.facebook.sdk.ApplicationId " android : value = " @string/facebook_app_id " />
< meta-data android : name = " com.facebook.sdk.ClientToken " android : value = " @string/facebook_client_token " />
Dans le fichier android/app/src/main/res/values/strings.xml
ajoutez les lignes suivantes :
< string name = " facebook_app_id " >[APP_ID]</ string >
< string name = " facebook_client_token " >[CLIENT_TOKEN]</ string >
N'oubliez pas de remplacer [APP_ID]
et [CLIENT_TOKEN]
par votre identifiant d'application Facebook.
Plus d'informations peuvent être trouvées ici : https://developers.facebook.com/docs/android/getting-started
Veuillez redémarrer Android Studio et effectuer une nouvelle construction.
Dans le fichier ios/App/App/AppDelegate.swift
ajoutez ou remplacez ce qui suit :
import UIKit
import Capacitor
import FBSDKCoreKit
@ UIApplicationMain
class AppDelegate : UIResponder , UIApplicationDelegate {
var window : UIWindow ?
func application ( _ application : UIApplication , didFinishLaunchingWithOptions launchOptions : [ UIApplication . LaunchOptionsKey : Any ] ? ) -> Bool {
// Override point for customization after application launch.
FBSDKCoreKit . ApplicationDelegate . shared . application (
application ,
didFinishLaunchingWithOptions : launchOptions
)
return true
}
...
func application ( _ app : UIApplication , open url : URL , options : [ UIApplication . OpenURLOptionsKey : Any ] = [ : ] ) -> Bool {
// Called when the app was launched with a url. Feel free to add additional processing here,
// but if you want the App API to support tracking app url opens, make sure to keep this call
if ( FBSDKCoreKit . ApplicationDelegate . shared . application (
app ,
open : url ,
sourceApplication : options [ UIApplication . OpenURLOptionsKey . sourceApplication ] as? String ,
annotation : options [ UIApplication . OpenURLOptionsKey . annotation ]
) ) {
return true;
} else {
return ApplicationDelegateProxy . shared . application ( app , open : url , options : options )
}
}
}
Ajoutez ce qui suit dans le fichier ios/App/App/info.plist
à l'intérieur du <dict>
le plus externe :
< key >CFBundleURLTypes</ key >
< array >
< dict >
< key >CFBundleURLSchemes</ key >
< array >
< string >fb[APP_ID]</ string >
</ array >
</ dict >
</ array >
< key >FacebookAppID</ key >
< string >[APP_ID]</ string >
< key >FacebookClientToken</ key >
< string >[CLIENT_TOKEN]</ string >
< key >FacebookDisplayName</ key >
< string >[APP_NAME]</ string >
< key >LSApplicationQueriesSchemes</ key >
< array >
< string >fbapi</ string >
< string >fbapi20130214</ string >
< string >fbapi20130410</ string >
< string >fbapi20130702</ string >
< string >fbapi20131010</ string >
< string >fbapi20131219</ string >
< string >fbapi20140410</ string >
< string >fbapi20140116</ string >
< string >fbapi20150313</ string >
< string >fbapi20150629</ string >
< string >fbapi20160328</ string >
< string >fbauth</ string >
< string >fb-messenger-share-api</ string >
< string >fbauth2</ string >
< string >fbshareextension</ string >
</ array >
Plus d'informations peuvent être trouvées ici : https://developers.facebook.com/docs/facebook-login/ios
import { FacebookLogin } from '@capacitor-community/facebook-login' ;
// use hook after platform dom ready
await FacebookLogin . initialize ( { appId : '105890006170720' } ) ;
Plus d'informations peuvent être trouvées ici : https://developers.facebook.com/docs/facebook-login/web Et vous devez confirmer le type de retour sur https://github.com/rdlabo/capacitor-facebook-login/blob/master /src/web.ts#L55-L57 pas du même type pour la connexion Web Facebook par défaut !
import {
FacebookLogin ,
FacebookLoginResponse ,
} from '@capacitor-community/facebook-login' ;
const FACEBOOK_PERMISSIONS = [
'email' ,
'user_birthday' ,
'user_photos' ,
'user_gender' ,
] ;
const result = await ( < FacebookLoginResponse > (
FacebookLogin . login ( { permissions : FACEBOOK_PERMISSIONS } )
) ) ;
if ( result . accessToken ) {
// Login successful.
console . log ( `Facebook access token is ${ result . accessToken . token } ` ) ;
}
import { FacebookLogin } from '@capacitor-community/facebook-login' ;
await FacebookLogin . logout ( ) ;
import {
FacebookLogin ,
FacebookLoginResponse ,
} from '@capacitor-community/facebook-login' ;
const result = await ( < FacebookLoginResponse > (
FacebookLogin . getCurrentAccessToken ( )
) ) ;
if ( result . accessToken ) {
console . log ( `Facebook access token is ${ result . accessToken . token } ` ) ;
}
import {
FacebookLogin ,
FacebookLoginResponse ,
} from '@capacitor-community/facebook-login' ;
const result = await FacebookLogin . getProfile < {
email : string ;
} > ( { fields : [ 'email' ] } ) ;
console . log ( `Facebook user's email is ${ result . email } ` ) ;
initialize(...)
login(...)
logout()
reauthorize()
getCurrentAccessToken()
getProfile(...)
logEvent(...)
setAutoLogAppEventsEnabled(...)
setAdvertiserTrackingEnabled(...)
setAdvertiserIDCollectionEnabled(...)
initialize ( options : Partial < FacebookConfiguration > ) => Promise < void >
Paramètre | Taper |
---|---|
options | Partial<FacebookConfiguration> |
login ( options : { permissions : string [ ] ; } ) = > Promise < FacebookLoginResponse >
Paramètre | Taper |
---|---|
options | { permissions: string[]; } |
Renvoie : Promise<FacebookLoginResponse>
logout ( ) = > Promise < void >
reauthorize ( ) = > Promise < FacebookLoginResponse >
Renvoie : Promise<FacebookLoginResponse>
getCurrentAccessToken ( ) = > Promise < FacebookCurrentAccessTokenResponse >
Renvoie : Promise<FacebookCurrentAccessTokenResponse>
getProfile < T extends Record < string , unknown > > ( options : { fields : readonly string [ ] ; } ) => Promise < T >
Paramètre | Taper |
---|---|
options | { fields: readonly string[]; } |
Retours : Promise<T>
logEvent ( options : { eventName : string ; } ) = > Promise < void >
Paramètre | Taper |
---|---|
options | { eventName: string; } |
setAutoLogAppEventsEnabled ( options : { enabled : boolean ; } ) = > Promise < void >
Paramètre | Taper |
---|---|
options | { enabled: boolean; } |
setAdvertiserTrackingEnabled ( options : { enabled : boolean ; } ) = > Promise < void >
Paramètre | Taper |
---|---|
options | { enabled: boolean; } |
setAdvertiserIDCollectionEnabled ( options : { enabled : boolean ; } ) = > Promise < void >
Paramètre | Taper |
---|---|
options | { enabled: boolean; } |
Soutenir | Taper |
---|---|
appId | string |
autoLogAppEvents | boolean |
xfbml | boolean |
version | string |
locale | string |
Soutenir | Taper |
---|---|
accessToken | AccessToken | null |
recentlyGrantedPermissions | string[] |
recentlyDeniedPermissions | string[] |
Soutenir | Taper |
---|---|
applicationId | string |
declinedPermissions | string[] |
expires | string |
isExpired | boolean |
lastRefresh | string |
permissions | string[] |
token | string |
userId | string |
Soutenir | Taper |
---|---|
accessToken | AccessToken | null |
Rendre toutes les propriétés de T facultatives
{ [P in keyof T]?: T[P]; }
Construire un type avec un ensemble de propriétés K de type T
{ [P in K]: T; }