从零开始一步一步接入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.运行测试目标项目

一、到渠道官网获取我们所需的SDK

笔者这里以91移动开放平台为例，我们渠道官网SDK下载地址：http://dev.91.com/DocumentCenter/SdkDownload，下载我们所需的SDK，这里笔者下载的是Android版本的SDK。

点击下载完毕之后，会看到这样一个压缩包：

二、解压缩SDK包，获得开发文档、Demo、jar包

91开放平台也算是一个受众比较多的一个渠道了，它的SDK提供的内容也是比较完备的：

我们可以看到，91SDK很清晰的为我们分好不同的文件夹，从开发文档、客户端接口范例到运营规范都提供了完备的资料。我们接入其他渠道的时候也许需要了解SDK为我们提供了什么东西，哪些是我们开发需要的。

这里，我们最主要看01、02、04这三个，这是我们接入SDK需要使用到的

接入流程文档：

范例和开发文档：

配置说明和开发包

三、查看开发文档、导入Demo到Eclipse中

我们开发者自然想快速的接入SDK，并且不想浪费太多时间，最快的办法就是先浏览一遍SDK提供的开发文档，然后测试它提供的范例，弄懂整个集成流程之后，我们就会明白如何来配置相关文件，但具体的API使用还是需要详细查看开发文档和范例的使用。

如果查看过91接入文档就会发现它写的非常详细，并不需要笔者多说，你自己试一遍也可以集成SDK。

查看文档：

导入Demo和开发包到Eclipse

到这里笔者要好好提一下，关于集成SDK的两种方式，91这种是通过引入库项目文件的形式来集成的，另一种方式是以jar包形式集成的，但可能还需要复制相应的assert资源到目标项目中去，主要还是要看渠道的SDK是否有提供。

四、新建项目，参考Demo集成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，有些渠道可能出现各种各样莫名奇妙的问题，有时候我们开发就需要去填这些坑，这就很考验开发者的灵活应对了，必要的时候需要找到对应渠道的技术支持，并向他们反映相关问题。

以上是笔者作为渠道接入的开发人员的所总结的一些经验，可能有不尽完善的地方，如果有什么相关疑问可以给笔者留言，笔者可以在博客中继续补充相关内容。希望本篇博客能帮到大家，谢谢。

Android教程-从零开始一步一步接入SDK