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

从零开始一步一步接入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。

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

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

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


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

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

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

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

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

接入流程文档:

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

范例和开发文档:

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

配置说明和开发包

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


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

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

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

查看文档:

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

导入Demo和开发包到Eclipse

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

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


到这里笔者要好好提一下,关于集成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之后,就可以运行测试项目看看效果了,测试我们想要测试的功能,比如登录、支付、悬浮框等功能。

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

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

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

这里只是给大家演示91渠道SDK的接入,这个是测试Demo所呈现的效果,具体的展示效果由开发自行开发实现。

关于SDK的接入,笔者就介绍到这里,SDK的接入并不是什么技术含量很高的事情,只要有相应编程基础和相关平台的开发经验就能很快熟悉SDK的接入。但这里并不意味着能渠道好好玩耍了,接入渠道有很多坑,并不是所有渠道都像91有完善的开发文档和封装的比较好的API,有些渠道可能出现各种各样莫名奇妙的问题,有时候我们开发就需要去填这些坑,这就很考验开发者的灵活应对了,必要的时候需要找到对应渠道的技术支持,并向他们反映相关问题。



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






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

上一篇:PC远程调试移动设备


下一篇:Leetcode 动态规划 Trapping Rain Water