Android SDK

General information

Android application with OK SDK example: ok-android-sdk/odnoklassniki-android-sdk-example

Android SDK allows to authorize users via client authorization, publish new posts, invite friends to a game, send notifications and invoke REST methods.

Setting up

Before using SDK you need to be sure everything is configured correctly for your app:

Android platform is added to your app’s platforms list;
client authorization is enabled;
redirect_uri okauth://ok{APP_ID} is added to redirect_uri’s list;
application has all required API permissions. It is recommended to have LONG_ACCESS_TOKEN permission enabled for native apps.

To import it with gradle do the following:

add this code to dependencies part of build.gradle file

compile 'ru.ok:odnoklassniki-android-sdk:2.0.3'

Correct your AndroidManifest.xml file:

enable INTERNET permission

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

add OAuth Activity and set your app’s APP_ID to the value

    <activity
        android:name="ru.ok.android.sdk.OkAuthActivity">
        <intent-filter>
            <action android:name="android.intent.action.VIEW"/>
    
            <category android:name="android.intent.category.DEFAULT"/>
            <category android:name="android.intent.category.BROWSABLE"/>
    
            <data
                android:host="ok{APP_ID}"
                android:scheme="okauth"/>
        </intent-filter>
    </activity>

in case of using widgets add specific Activities for each widget to be used

    <activity android:name="ru.ok.android.sdk.OkPostingActivity"/>
    <activity android:name="ru.ok.android.sdk.OkAppInviteActivity"/>
    <activity android:name="ru.ok.android.sdk.OkAppSuggestActivity"/>

SDK usage example

Creating Odnoklassniki object instance

Odnoklassniki.createInstance(this, APP_ID, APP_KEY);
Odnoklassniki.getInstance();

Authorization (requestAuthorization)

odnoklassniki.requestAuthorization(OkListener, REDIRECT_URI, OkAuthType.ANY, OkScope.VALUABLE_ACCESS, OkScope.LONG_ACCESS_TOKEN);

REST method invocation (request)

odnoklassniki.request(METHOD_NAME, params, "GET");

Widgets

Publish widget - performPosting
invite / suggest widget - performAppInvite / performAppSuggest

odnoklassniki.performPosting("{\"media\":[{\"type\":\"text\",\"text\":\"hello world!\"}]}", false, params, OkListener);
odnoklassniki.performAppInvite(OkListener, params);
odnoklassniki.performAppSuggest(OkListener, params);