从零开始一步一步接入SDK
本篇博客想总结一下笔者在接入手游渠道SDK的一些经验方法,为想接入手游渠道或者想学习如何接入SDK的童鞋们提供一个参考。本篇博客基于Android平台,关于IOS接入SDK的方法,笔者以后有机会也会整理。
首先来给大家说明一下SDK,何为SDK?它的全称是,SoftWare Develop Kit,意思是软件开发工具包,它是可以辅助我们去开发某类软件的相关文档,范例和工具的集合。关于SDK,这里推荐一个服务商店,名叫Devstore(http://www.devstore.cn/),它聚集了各种各类的服务提供商,并为每个渠道SDK提供了专业且详细的评测,笔者很荣幸成为Devstore的特约评测员这个荣誉,在Devstore也可以看到笔者对一些渠道所做的评测报告。
对SDK有了基本的概念之后就可以学习如何来从零开始一步一步接入SDK,每个渠道或者服务商面对开发者都会提供相应的SDK,里面就包含相应的开发文档,开发Demo还有jar包或者项目所需的资源。
这里笔者提供一个范例来说明如何去接入SDK,大纲如下:
1.到渠道服务官网获取我们所需的SDK
2.解压缩SDK包,获得开发文档、Demo、jar包
3.查看开发文档,导入Demo到Eclipse中
4.新建项目,参考Demo集成SDK
5.运行测试目标项目
笔者这里以91移动开放平台为例,我们渠道官网SDK下载地址:http://dev.91.com/DocumentCenter/SdkDownload,下载我们所需的SDK,这里笔者下载的是Android版本的SDK。
点击下载完毕之后,会看到这样一个压缩包:
91开放平台也算是一个受众比较多的一个渠道了,它的SDK提供的内容也是比较完备的:
我们可以看到,91SDK很清晰的为我们分好不同的文件夹,从开发文档、客户端接口范例到运营规范都提供了完备的资料。我们接入其他渠道的时候也许需要了解SDK为我们提供了什么东西,哪些是我们开发需要的。
这里,我们最主要看01、02、04这三个,这是我们接入SDK需要使用到的
接入流程文档:
范例和开发文档:
配置说明和开发包
我们开发者自然想快速的接入SDK,并且不想浪费太多时间,最快的办法就是先浏览一遍SDK提供的开发文档,然后测试它提供的范例,弄懂整个集成流程之后,我们就会明白如何来配置相关文件,但具体的API使用还是需要详细查看开发文档和范例的使用。
如果查看过91接入文档就会发现它写的非常详细,并不需要笔者多说,你自己试一遍也可以集成SDK。
查看文档:
导入Demo和开发包到Eclipse
到这里笔者要好好提一下,关于集成SDK的两种方式,91这种是通过引入库项目文件的形式来集成的,另一种方式是以jar包形式集成的,但可能还需要复制相应的assert资源到目标项目中去,主要还是要看渠道的SDK是否有提供。
我们可以从Demo中得到很多信息,一个是项目的配置,一个是API接口使用方法,我们只要通过查看Demo就可以弄清楚整个渠道的接入流程。那么怎么来看Demo,笔者总结了下面的经验:
查看AndroidManifest.xml文件,了解项目必须的配置,比如权限配置,Activity、Service或者meta-data的配置。
比如91就需要这些权限:
<!-- 91社区 --> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.SEND_SMS" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /> <uses-permission android:name="android.permission.CALL_PHONE" /> <uses-permission android:name="android.permission.GET_TASKS" /> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <uses-permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT" /> <uses-permission android:name="com.android.launcher.permission.UNINSTALL_SHORTCUT" /> <!-- 91社区 -->
<!-- 91社区 --> <activity android:name="com.nd.commplatform.activity.SNSControlCenterActivity" android:configChanges="orientation|keyboardHidden|navigation|screenSize" android:launchMode="singleTask" android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:windowBackground="@null" android:windowSoftInputMode="adjustPan" > </activity> <activity android:name="com.nd.commplatform.activity.SNSLoginActivity" android:configChanges="orientation|keyboardHidden|navigation|screenSize" android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:windowBackground="@null" android:windowSoftInputMode="adjustPan" /> <receiver android:name="com.nd.commplatform.versionupdate.ND2VersionUpdateNotify" android:exported="false" android:process="android.intent.nd.sns.commplatform.versionupdate" /> <service android:name="com.nd.commplatform.versionupdate.ND2VersionUpdateService" android:exported="false" android:process="android.intent.nd.sns.commplatform.versionupdate" /> <service android:name="com.nd.commplatform.service.NdNewMessageNotification" android:enabled="true" android:exported="false" /> <activity android:name="com.nd.commplatform.activity.SNSAppPromotionActivity" android:configChanges="orientation|keyboardHidden|navigation" android:launchMode="singleTask" android:theme="@android:style/Theme.NoTitleBar" android:windowBackground="@null" android:windowSoftInputMode="adjustPan" /> <service android:name="com.nd.commplatform.service.NdDownloadService" android:enabled="true" android:exported="false" android:process=":com.nd.commplatform.download" /> <activity android:name="com.nd.commplatform.gc.activity.ForumActivity" android:configChanges="orientation|keyboardHidden|navigation|screenSize" android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:windowSoftInputMode="adjustPan" /> <!-- 91社区 --> <activity android:name="com.nd.complatform.stardemo.StartActivity" android:configChanges="orientation|navigation|screenSize" android:label="@string/app_name" android:screenOrientation="landscape" android:theme="@android:style/Theme.NoTitleBar.Fullscreen" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity>
配置完之后,我们就可以根据功能点,找到对应的API调用的方法,我们就可以知道如何传参和回调API的方法。
我们集成完SDK之后,就可以运行测试项目看看效果了,测试我们想要测试的功能,比如登录、支付、悬浮框等功能。
这里只是给大家演示91渠道SDK的接入,这个是测试Demo所呈现的效果,具体的展示效果由开发自行开发实现。
关于SDK的接入,笔者就介绍到这里,SDK的接入并不是什么技术含量很高的事情,只要有相应编程基础和相关平台的开发经验就能很快熟悉SDK的接入。但这里并不意味着能渠道好好玩耍了,接入渠道有很多坑,并不是所有渠道都像91有完善的开发文档和封装的比较好的API,有些渠道可能出现各种各样莫名奇妙的问题,有时候我们开发就需要去填这些坑,这就很考验开发者的灵活应对了,必要的时候需要找到对应渠道的技术支持,并向他们反映相关问题。
以上是笔者作为渠道接入的开发人员的所总结的一些经验,可能有不尽完善的地方,如果有什么相关疑问可以给笔者留言,笔者可以在博客中继续补充相关内容。希望本篇博客能帮到大家,谢谢。
原文地址:http://blog.csdn.net/wwj_748/article/details/38893023