zshu / ShareSDK-for-Android

A demo of Share SDK for Android

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ShareSDK for Android

文档语言 : 中文 | English

第一步:下载SDK

请浏览我们的官方网站及下载最新版本的ShareSDK。提取下载文件后,你会发现以下目录结构:

directory structure

打开Android目录下的ShareSDK,你会发现MainLibsOnekeyShare。ShareSDK存储在MainLibs目录中,OnekeyShare是开发人员通过ShareSDK快速完成共享特性的GUI工具。

步骤二:将ShareSDK导入项目

有两种方法可以将ShareSDK导入到您的项目中:引用ShareSDK项目将jar和资源复制到您的项目中。如果您选择第二种方式,我们提供以下工具帮助您快速完成这些操作:

quick integrating tool

执行此工具并将其产品复制到项目中。

ShareSDK鼓励您通过引用ShareSDK的项目来集成它,因为这样会简单得多。步骤如下:

(1) 将提取的SDK复制到Eclipse的工作区中

(2) 导入SDK项目:

projects of ShareSDK

选择 MainLibs 和 OnekeyShare

select lib-projects

(3) 将项目的依赖项更改为OnekeyShare(如果需要此GUI工具)或mainlib

change dependency

第三步:添加应用程序信息

有三种方法可以将应用程序信息添加到ShareSDK中:在ShareSDK的应用程序控制台注册**,配置“assets/ShareSDK”。文件,或由ShareSDK修改。setPlatformDevInfo(String, HashMap<String, Object>)方法 下面是“assets/ShareSDK”的示例:

<ShareSDK
   AppKey="add appkey you got from ShareSDK here" />

<Facebook
    Id="int字段,自定义值,供开发人员识别此平台"
    SortId="int字段,注册平台中的优先级"
    ConsumerKey="从Facebook获得的Key"
    ConsumerSecret="你从Facebook获得的密钥"
    Enable="Boolean字段,false表示从注册平台中删除平台" />


所有应用程序信息都在“assets/ShareSDK”中注册。ShareSDK示例项目的xml。

# 第四步:配置AndroidManifest.xml

在AndroidMenifest.xml中添加以下权限:

<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS"/>
<uses-permission android:name="android.permission.GET_ACCOUNTS"/>

如果希望使用KakaoTalk共享msg,应该在launchActivity中添加intent过滤器。
<!--
	If you share msg in KakaoTalk, your share-params of executeUrl should set the value "kakaoTalkTest://starActivity"
	So it do, when the user to click the share-msg, then startActivity of your app's launch-activity. 
	When you use the lib of onekeyshare, you can use the method of 
    setExecuteUrl("kakaoTalkTest://starActivity") to set executeUrl.
-->
    <intent-filter>
        <data android:scheme="kakaoTalkTest" android:host="starActivity"/>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
		
ShareSDK的gui的单一Activity:

<activity
   android:name="cn.sharesdk.framework.ShareSDKUIShell"
   android:theme="@android:style/Theme.Translucent.NoTitleBar"
   android:configChanges="keyboardHidden|orientation|screenSize"
   android:screenOrientation="portrait"
   android:windowSoftInputMode="stateHidden|adjustResize" />


如果你集成了微信,添加这个回调Activity:

<activity
   android:name=".wxapi.WXEntryActivity"
   android:theme="@android:style/Theme.Translucent.NoTitleBar"
   android:configChanges="keyboardHidden|orientation|screenSize"
   android:exported="true"
   android:screenOrientation="portrait" />

如果你集成Yixin,添加这个回调Activity:

<activity
   android:name=".yxapi.YXEntryActivity"
   android:theme="@android:style/Theme.Translucent.NoTitleBar"
   android:configChanges="keyboardHidden|orientation|screenSize"
   android:exported="true"
   android:screenOrientation="portrait" />

第五步:添加代码

在**入口activity**的**onCreate**方法中添加如下行:

ShareSDK.initSDK(this);


并在**上次Activity**的**onDestroy**方法中添加如下行:

ShareSDK.stopSDK(this);

截图

logo grid view of onekeyshare edit page of onekeyshare image preview authorizes

有关如何整合ShareSDK或如何使用ShareSDK获取好友列表、关注某人、分享状态等更多信息,请访问我们的网站 official wiki.

About

A demo of Share SDK for Android

License:MIT License


Languages

Language:Java 100.0%