SDK初始化说明

1. SDK 目录结构

  • demo-release.apk 示例工程, 用来演示AdHub提供的多种广告展现形式.
  • sdk-release.aar 主SDK, 包含请求, 展现Adhub自有广告逻辑.
  • sdk_mediation_afp-release.aar 相应的适配类, 用来展现广告内容.
  • sdk_mediation_baidu-release.aar 相应的适配类, 用来展现广告内容.
  • sdk_mediation_gdt-release.aar 相应的适配类, 用来展现广告内容.

注:除sdk-release.aar主SDK外, 其余ADN网络只需按需集成.

2. AAR文件简介

Google在发布Android studio的时候就发布了一种独有的格式AAR,专门用于打包UI组件库。与jar相比其多了一些UI组件用到的属性、图片等一系列文件,它的好处在于你不需要再多创建一个Library Module,只需引用这个AAR文件即可,Android Sudio会自动把AAR包里的文件跟你的项目融合。 AdHubSDK也采用了aar作为标准打包形式, 将SDK依赖的文件和资源一并打入AAR包中, 这样开发者只需要依赖单一的AAR文件, 而不需要手工将SDK依赖的文件放入工程中, 大大减轻了SDK使用者的负担.

3. 导入SDK文件

  1. 将sdk-release.aar这个SDK主文件拷贝到本地工程的libs子目录下.
  2. 若使用了聚合广告平台,则需要将相应的聚合平台依赖包添加到本地工程libs目录下,例如:使用了百度平台,需要将sdk_mediation_baidu-release.aar拷贝到本地工程libs子目录下。广告网络和平台依赖包对应关系如下:

    • sdk_mediation_afp-release.aar
    • sdk_mediation_baidu-release.aar
    • sdk_mediation_gdt-release.aar
  3. 在gradle配置文件中把libs目录放入依赖:

    repositories{
    flatDir{
        dirs 'libs'
        }
    }
    
  4. 在gradle文件中使用依赖的方式引用aar,这一句依赖即可关联完毕:
    compile(name:'sdk-release',ext:'aar')
    compile(name:'sdk_mediation_afp-release',ext:'aar')
    compile(name:'sdk_mediation_baidu-release',ext:'aar')
    compile(name:'sdk_mediation_gdt-release',ext:'aar')
    
  5. eclipse需要将aar转换为library工程文件,以项目工程的形式导入。(关于AAR转成eclispe工程文件请参考搜索百度相关文档)

注: 不能修改AAR文件的名字. 项目中用到了V4,v7包,版本号为23+,若项目中使用v4,v7版本低于23+,请升级V4包。

4. 初始化SDK

注意:初始化SDK必须在调用AdHub广告接口之前,

// Initialize the Mobile Ads SDK.
//此方法只需要初始化的时候调用一次,建议在application里面调用,不要多次调用。
//注意:demo中是为了提供测试不同的appid,在每一个不同的广告界面都进行了调用。sdk嵌入者只需要调用一次。
AdHub.initialize(applicationContext, appId);

5. 修改AndroidManifest.xml文件, 添加必要权限和Activity

添加访问权限

在AndroidManifest.xml文件中添加

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

注意:这里只列出了必须的权限,若使用聚合广告请根据平台需求添加,请从Demo中的AndroidManifest.xml文件中查找对应平台需要的权限。

添加SDK Activiy定义

在AndroidManifest.xml文件的application节点下添加

<activity
            android:name="com.hubcloud.adhubsdk.AdActivity"
            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
            android:theme="@style/AdhubDialogStyle" />

注意:这里只列出了必须要声明的Activity,若使用聚合广告请根据平台需求添加,请从Demo中的AndroidManifest.xml文件中查找对应平台需要的声明。

results matching ""

    No results matching ""