@capacitor-community/facebook-login
用於本機 Facebook 登入的 Capacitor 社群外掛程式。
維護者 | GitHub | 社會的 | 贊助公司 |
---|---|---|---|
榊原正彥 | 拉博 | @rdlabo | 關係設計實驗室,通用公司協會 |
由貢獻者-img 製作。
演示程式碼在這裡。
如果你想知道 Facebook 庫版本,你應該檢查:
% npm i --save @capacitor-community/facebook-login
% npx cap update
Capacitor v5 的使用者應使用插件的 v5 版本。
% npm install @capacitor-community/facebook-login@5
在檔案android/app/src/main/AndroidManifest.xml
中,在<manifest><application>
下新增以下 XML 元素:
< 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 " />
在檔案android/app/src/main/res/values/strings.xml
中新增以下行:
< string name = " facebook_app_id " >[APP_ID]</ string >
< string name = " facebook_client_token " >[CLIENT_TOKEN]</ string >
不要忘記將[APP_ID]
和[CLIENT_TOKEN]
替換為您的 Facebook 應用程式 ID。
更多資訊可以在這裡找到:https://developers.facebook.com/docs/android/getting-started
請重新啟動 Android Studio,並進行乾淨建置。
在檔案ios/App/App/AppDelegate.swift
中新增或取代以下內容:
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 )
}
}
}
在ios/App/App/info.plist
檔案最外面的<dict>
內加入以下內容:
< 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 >
更多資訊可以在這裡找到: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' } ) ;
更多資訊可以在這裡找到:https://developers.facebook.com/docs/facebook-login/web 並且您必須在https://github.com/rdlabo/capacitor-facebook-login/blob/master 確認返回類型/src/web.ts#L55-L57 預設 Web Facebook 登入的類型不同!
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 >
參數 | 類型 |
---|---|
options | Partial<FacebookConfiguration> |
login ( options : { permissions : string [ ] ; } ) = > Promise < FacebookLoginResponse >
參數 | 類型 |
---|---|
options | { permissions: string[]; } |
回傳: Promise<FacebookLoginResponse>
logout ( ) = > Promise < void >
reauthorize ( ) = > Promise < FacebookLoginResponse >
回傳: Promise<FacebookLoginResponse>
getCurrentAccessToken ( ) = > Promise < FacebookCurrentAccessTokenResponse >
回傳: Promise<FacebookCurrentAccessTokenResponse>
getProfile < T extends Record < string , unknown > > ( options : { fields : readonly string [ ] ; } ) => Promise < T >
參數 | 類型 |
---|---|
options | { fields: readonly string[]; } |
返回: Promise<T>
logEvent ( options : { eventName : string ; } ) = > Promise < void >
參數 | 類型 |
---|---|
options | { eventName: string; } |
setAutoLogAppEventsEnabled ( options : { enabled : boolean ; } ) = > Promise < void >
參數 | 類型 |
---|---|
options | { enabled: boolean; } |
setAdvertiserTrackingEnabled ( options : { enabled : boolean ; } ) = > Promise < void >
參數 | 類型 |
---|---|
options | { enabled: boolean; } |
setAdvertiserIDCollectionEnabled ( options : { enabled : boolean ; } ) = > Promise < void >
參數 | 類型 |
---|---|
options | { enabled: boolean; } |
支柱 | 類型 |
---|---|
appId | string |
autoLogAppEvents | boolean |
xfbml | boolean |
version | string |
locale | string |
支柱 | 類型 |
---|---|
accessToken | AccessToken | null |
recentlyGrantedPermissions | string[] |
recentlyDeniedPermissions | string[] |
支柱 | 類型 |
---|---|
applicationId | string |
declinedPermissions | string[] |
expires | string |
isExpired | boolean |
lastRefresh | string |
permissions | string[] |
token | string |
userId | string |
支柱 | 類型 |
---|---|
accessToken | AccessToken | null |
使 T 中的所有屬性可選
{ [P in keyof T]?: T[P]; }
建構一個具有類型 T 的一組屬性 K 的型別
{ [P in K]: T; }