react-native-ok-sdk v0.0.1
React Native OK SDK
React Native OK SDK is a wrapper around the iOS OK SDK and Android OK SDK, allowing for OK integration in React Native apps. Access to native components for login is provided entirely through documented JavaScript modules so you don't have to call a single native function directly.
GIVE FEEDBACK
Please post questions on sdk set up to stackoverflow for quicker response. Besides it's easier for others searching for similar questions. Report bugs or issues of this package to react-native-ok-sdk/issues. Report bugs of IOS OK SDK to ok-ios-sdk/issues or via Telegram. Report bugs of Android SDK to ok-android-sdk/issues or via Telegram.
Installation
You need to install the sdk with npm and configure native Android/iOS project in the react native project.
1. Create React Native project
First create a React Native project:
react-native init YourApp
2. Install JavaScript packages
Install and link the react-native-ok-sdk package:
react-native install react-native-ok-sdk
react-native link react-native-ok-sdk
3. Configure native projects
3.1 Android project
Assuming you have Android Studio installed, open the project with Android Studio.
This instruction provided for react-native version is 0.29 or above
Go to MainApplication.java
under app/src/main/java/com/<project name>/
to complete setup.
In MainApplication.java
import package related to react-native-ok-sdk.
import com.askiirobotics.reactnativeoksdk.OkPackage;
...
public class MainApplication extends Application implements ReactApplication {
...
}
Register sdk package in method getPackages()
.
...
public class MainApplication extends Application implements ReactApplication {
...
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
...
new VKAuthPackage()//<---- Add package
);
}
...
}
Next go to android/settings.gradle
and add followed lines:
...
include ':react-native-ok-sdk'
project(':react-native-ok-sdk').projectDir = new File(settingsDir, '../node_modules/react-native-ok-sdk/android')
and to android/app/build.gradle
:
...
dependencies {
...
compile project(':react-native-ok-sdk')
}
In your AndroidManifest.xml
, add following line inside <application>
element:
<activity
android:name="ru.ok.android.sdk.OkAuthActivity"
android:configChanges="orientation|screenSize"
android:launchMode="singleTop">
<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="okYOUR_APP_KEY"
android:scheme="okauth" />
</intent-filter>
</activity>
Note: changle in line android:host="okYOUR_APP_KEY"
to key of your OK app.
Make sure that your AndroidManifest.xml
contains inside <manifest>
element followed line:
<uses-permission android:name="android.permission.INTERNET" />
3.2 IOS Project
Add ok{appId} schema to your app Info.plist file. For example ok12345 if your app has appId 12345. Don't forget add ok{appId}://authorize to allowed redirect urls for your application in ok.ru app profile. Also you should add next block to your Info.plist file.
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
If you not use PodSec Add OKSDK.h and OKSDK.m to your project. For example you can use git submodule.
- Init your sdk in AppDelegate didFinishLaunchingWithOptions
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
OKSDKInitSettings *settings = [OKSDKInitSettings new];
settings.appKey = @"ABCDEFGABCDEGF";
settings.appId = @"12345";
settings.controllerHandler = ^{
return self.window.rootViewController;
};
[OKSDK initWithSettings: settings];
return YES;
}
2. Add openUrl to AppDelegate openURL
```objective-c
-(BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
[OKSDK openUrl:url];
return YES;
}
3.3 Troubleshooting
- I cannot run the Android project.
- Make sure you added the code snippet in step 3.1.
- Make sure you set up a OK app and updated the
AndroidManifest.xml
.
- I get a build error stating that one of the OK SDK files was not found -- eg.
OKSDK.h file not found
.
- Make sure that
OKSDK.framework
show up in the Link Binary with Libraries section of your build target's Build Phases.
- I get this build error:
no type or protocol named UIApplicationOpenURLOptionsKey
:
- Your XCode version is too old, upgrade to XCode 8.0+.
Usage
Login Button + Access Token
...
import OkManager, { Scopes } from 'react-native-ok-sdk'
class LoginButton extends React.Component {
static propTypes = {
onAuth: React.PropTypes.func
};
constructor(){
this.loginPressed = this.loginPressed.bind(this)
}
loginPressed() {
OkManager.login([Scopes.VALUABLE_ACCESS])
.then(
response => {
console.log('OK login', response);
this.props.onAuth(response);
}
)
.catch(e => {
console.log('OK Login error', e);
})
}
render() {
return (
<View>
<TouchableOpacity
onPress={ this.loginPressed }
/>
</View>
);
}
}
License
See the LICENSE file.
7 years ago