Air Native Extension for Facebook (iOS + Android)

This is an Air native extension for Facebook SDK on iOS and Android. It has been originally developed by FreshPlanet. I will try to maintain this project. For any suggestions open a issue.

Facebook SDK Versions

• iOS: 4.6.0
• Android: 4.6.0

IMPORTANT NOTE: Please use -swf-version=29 and AIR >= 18 when you use this ANE otherwise you can have some issues.

IMPORTANT NOTE FOR ANDROID: Use this ANE only when you build with AIR >=18. New FB Android SDK needs Java 1.7 and extension compiled with Java 1.7 will not work with AIR 16 (AIR 17 had a lot of issues with Android so I don't consider it either). Context of extension will not be created on Android. There should be no issues with iOS.

IMPORTANT NOTE FOR IOS 9: With IOS 9 you must update your application descriptor to match these changes.

Installation

The ANE binary (AirFacebook.ane) is located in the bin folder. You should add it to your application project's Build Path and make sure to package it with your app (more information here).

On iOS:

• as explained here, you will need to add some Info.plist additions in your application descriptor:

<iPhone>
    
    <InfoAdditions><![CDATA[

        <key>CFBundleURLTypes</key>
        <array>
            <dict>
                <key>CFBundleURLSchemes</key>
                    <array>
                        <string>fb{YOUR_FB_APPLICATION_ID}</string>
                    </array>
            </dict>
        </array>
        <key>FacebookAppID</key>
        <string>{YOUR_FB_APPLICATION_ID}</string>

    ]]></InfoAdditions>

</iPhone>

On Android:

• you will need to add the following activities and permission in your application descriptor:

<android>
    <manifestAdditions><![CDATA[
        <manifest android:installLocation="auto">
            
            ...

            <uses-permission android:name="android.permission.INTERNET"/>
            
            ...

            <application>

                ...

                <meta-data android:name="com.facebook.sdk.ApplicationId" android:value="fb{YOUR_FB_APPLICATION_ID}"/>

                <activity android:name="com.facebook.FacebookActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar"
                    android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" android:label="{YOUR_APP_NAME}" />
                <activity android:name="com.freshplanet.ane.AirFacebook.LoginActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar"
                    android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" />
                <activity android:name="com.freshplanet.ane.AirFacebook.ShareDialogActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar"
                    android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" />
                <activity android:name="com.freshplanet.ane.AirFacebook.AppInviteActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar"
                    android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" />
                <activity android:name="com.freshplanet.ane.AirFacebook.GameRequestActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar"
                    android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation" />

                <provider android:authorities="com.facebook.app.FacebookContentProvider{YOUR_FB_APPLICATION_ID}" android:name="com.facebook.FacebookContentProvider" android:exported="true"/>
                
            </application>

        </manifest>
    ]]></manifestAdditions>
</android>

NOTE: It is important to prefix YOUR_FB_APP_ID with "fb" in <meta-data> (and ONLY in <meta-data>) tag, because of bug in Android manifest file (http://stackoverflow.com/questions/16156856/android-facebook-applicationid-cannot-be-null). Facebook SDK code in this ANE was modified to recognize FB_APP_ID prefixed with "fb".

Documentation

ActionScript documentation is available in HTML format on project pages here.

Samples (deprecated)

A sample project is available in the sample folder. Read HOW-TO.txt walkthrought to set-up and run the sample application.

Build from source

Should you need to edit the extension source code and/or recompile it, you will find an ant build script (build.xml) in the build folder:

cd /path/to/the/ane

# Setup build configuration
cd build
mv example.build.config build.config
# Edit build.config file to provide your machine-specific paths

# Build the ANE
ant

NOTE (deprecated): You MUST use Java 1.6 otherwise in android context will be null (probably bug in Adobe AIR SDK). On OSX you can call "export JAVA_HOME=/usr/libexec/java_home -v 1.6" without " to set JAVA_HOME properly.

Authors

This ANE has been originally written by Thibaut Crenn, Alexis Taugeron and Renaud Bardet. Rewrites and modifications to version SDK 4.x were made by Ján Horváth.