Skip to content

Latest commit

 

History

History
118 lines (98 loc) · 4.48 KB

README_ZH.md

File metadata and controls

118 lines (98 loc) · 4.48 KB

cordova-plugin-weibosdk

npm npm platform GitHub license

这是一个微博的 Cordova 插件. English
如果有任何问题或是建议,请开 issuss,也欢迎 star 或是 fork。微博SDK部分如有涉及版权问题,版权归新浪微博所有

功能

  • 微博 SSO 登录
  • 微博登出
  • 微博分享(网页、文字、图片)
  • 检查微博官方客户端是否安装

安装要求

  • Cordova Version >= 3.5
  • Cordova-Android >= 7.0
  • Cordova-iOS >= 4.0

安装

  1. 命令行运行 cordova plugin add cordova-plugin-weibosdk --variable WEIBO_APP_ID=YOUR_WEIBO_APPID
  2. 在你的config.xml文件中添加 <preference name="REDIRECTURI" value="YOUR_WEIBO_REDIRECTURI" /> 如果你不添加这个选项,那么默认的 redirecturi 是 https://api.weibo.com/oauth2/default.html
  3. 命令行运行 cordova build

注意事项

  1. 这个插件要求 Cordova-Android 的版本 >=4.0,推荐使用 Cordova 5.0 或更高的版本,因为从 Cordova 5.0 开始 Cordova-Android 4.0 是默认使用的 Android 版本
  2. 请在 Cordova 的 deviceready 事件触发以后再调用本插件!!!!!
  3. 在低于5.1.1的 Cordova 版本中存在一个 Bug,如果你有多个插件要修改 iOS 工程中的 “*-Info.plist” CFBundleURLTypes, 只有第一个安装的插件才会生效.所以安装完插件请务必在你的 Xcode 工程里面检查一下 URLTypes。 关于这个 bug 的详情你可以在 这里找到 建议安装使用5.1.1及以上的 Cordova 版本

使用方法

微博SSO登录

WeiboSDK.ssoLogin(function (args) {
   alert('access token is ' + args.access_token);
   alert('userId is ' + args.userId);
   alert('expires_time is ' + new Date(parseInt(args.expires_time)) + ' TimeStamp is ' + args.expires_time);
}, function (failReason) {
   alert(failReason);
});

微博登出

WeiboSDK.logout(function () {
   alert('logout success');
}, function (failReason) {
   alert(failReason);
});

微博网页分享

var args = {};
args.url = 'https://cordova.apache.org/';
args.title = 'Apache Cordova';
args.description = 'This is a Cordova Plugin';
args.image = 'https://cordova.apache.org/static/img/pluggy.png';
WeiboSDK.shareToWeibo(function () {
   alert('share success');
}, function (failReason) {
   alert(failReason);
}, args);

微博图片分享

var args = {};
args.image = 'https://cordova.apache.org/static/img/pluggy.png';
WeiboSDK.shareImageToWeibo(function () {
   alert('share success');
}, function (failReason) {
   alert(failReason);
}, args);

微博文字分享

var args = {};
args.text = 'This is a Cordova Plugin';
WeiboSDK.shareTextToWeibo(function () {
   alert('share success');
}, function (failReason) {
   alert(failReason);
}, args);

检查微博客户端是否安装

WeiboSDK.checkClientInstalled(function () {
   alert('client is installed');
}, function () {
   alert('client is not installed');
});

获取用户信息

var url = 'https://api.weibo.com/2/users/show.json?uid=' + usrid + '&&access_token=' + token;
http.get(url)

测试Demo

在安装完这个插件以后,把 Cordova 工程中的代码替换为 example_www 中的代码,在 build 以后可以进行各个功能测试,以下为运行效果图:

example

关于微博SDK

你可以在这里,找到最新的微博 SDK,如果发现 bug 请开 issus,同时也欢迎 star 和 fork

贡献代码

欢迎提交 PR,贡献你的代码,如果有新功能,请提供 Demo。

开源证书

cordova-plugin-weibosdk 遵照了 MIT 证书. 详情可以查看 证书 文件