facebook.* — facebook
Type Library
Overview
The Facebook plugin integrates the Facebook SDK version 5.0.1, currently only analytics and deferred applinks are implemented. This plugin is incompatible with the standard facebook.v4 plugin by Corona Labs.
To get access to the plugin, you need to support me on Patreon https://www.patreon.com/lerg
It is advised to get familiar with official Facebook SDK documentation.
If you need other SDK features to be implemented in this plugin, you can contact me and sponsor the development.
Supported platforms: iOS 8+, Android 4.0.3+.
Syntax
local facebook = require('plugin.spiralcode.facebook')
Functions
facebook.init()
facebook.getDeferredAppLinkData()
facebook.logEvent()
facebook.logPurchase()
facebook.setLimitEventAndDataUsage()
Events
fbapplink
Project Settings
To use this plugin, add an entry into the plugins table of build.settings. When added, the build server will integrate the plugin during the build phase.
local spiralcodestudio_patreon_email = 'YOUR_EMAIL'
local spiralcodestudio_key = 'YOUR_ACCESS_KEY'
local function spiralcodestudio_plugin(name)
local plugin = {publisherId = 'com.spiralcodestudio', supportedPlatforms = {}}
local platforms = {'android', 'appletvos', 'appletvsimulator', 'iphone', 'iphone-sim', 'mac-sim', 'win32-sim'}
for i = 1, #platforms do
local platform = platforms[i]
plugin.supportedPlatforms[platform] = {url = 'https://build.spiralcodestudio.com/' .. spiralcodestudio_patreon_email .. '/' .. spiralcodestudio_key .. '/solar2d/' .. name .. '_' .. platform .. '.tgz'}
end
return plugin
end
settings = {
plugins = {
['plugin.spiralcode.facebook'] = spiralcodestudio_plugin('facebook')
}
}
iOS
If your app is for iOS, you must also include the following code in build.settings to ensure that the native Facebook app functions properly:
settings = {
iphone =
{
plist =
{
UIApplicationExitsOnSuspend = false,
FacebookAppID = 'XXXXXXXXXX', -- Replace XXXXXXXXXX with your Facebook App ID
CFBundleURLTypes =
{
{ CFBundleURLSchemes = { 'fbXXXXXXXXXX', } } -- Replace XXXXXXXXXX with your Facebook App ID
},
-- Whitelist Facebook apps
LSApplicationQueriesSchemes =
{
'fb',
'fbapi',
'fbauth2',
'fb-messenger-api',
'fbshareextension'
},
},
},
}
Notice that there are several critical parts which must be specified:
UIApplicationExitsOnSuspend — To ensure that Facebook can resume your app properly, you must include UIApplicationExitsOnSuspend = false. If you’ve set this parameter to true for some other reason, you must revert it to false (default).
FacebookAppID — Set this key to FacebookAppID = ‘XXXXXXXXXX’ and replace XXXXXXXXXX with your unique Facebook App ID.
CFBundleURLTypes — The CFBundleURLTypes table must be declared exactly as shown and it must include a table named CFBundleURLSchemes. Inside this, include your Facebook App ID and prefix it with fb. Thus, if your App ID is 1234567890, you should specify: 'fb1234567890'.
LSApplicationQueriesSchemes — This table of whitelisted URL schemes ensures that your app and the Facebook SDK run properly together.
Android
If your app is for Android, you must also include a Facebook App ID in build.settings:
settings =
{
android =
{
facebookAppId = 'XXXXXXXXXX', -- Replace XXXXXXXXXX with your Facebook App ID
},
}
Sample Project
A sample project can be found here.