一点资讯开放平台SDK-Android

阅读对象

本文档面向所有使用一点资讯开放平台SDK的开发、测试人员等, 要求读者具有一定的Android编程开发经验。

1.产品概述

一点资讯开放平台Android SDK是一点资讯Android开发团队推出的Android平台上的个性化信息流推荐开发集成包(SDK)，为Android开发者提供简单、快捷的接口，帮助开发者实现Android平台上的个性化信息流产品。

1.1 Demo

下载地址：点击下载

2.SDK 功能说明

• [1] 提供完整个性化推荐信息流解决方案
• [2] 一键接入多频道推荐列表
• [3] 一键接入自定义单频道频道页面
• [4] 支持列表中单插信息流推荐卡片
• [5] SDK初始化流程便捷，接入成本低
• [6] SDK体积轻，大小仅有1M+
• [7] 卡片样式丰富，有小图、大图、组图、视频、图集卡片
• [8] 正文页用户体验佳，侧滑返回、视频推荐、评论页应有尽有
• [9] 强大的后台管理

3.SDK使用

3.1 Download

jcenter

• 1.先在工程目录下的build.gradle的repositories添加：

 buildscript {
    
    repositories {
        google()
        jcenter()
        maven { url "https://jitpack.io" }
        maven { url "https://dl.bintray.com/yidian-android/open_android_sdk/" }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.0.0'
        classpath 'org.greenrobot:greendao-gradle-plugin:3.2.2' // 一定要添加，greendao使用
    }
}

备注：SDK使用到了greendao数据库框架，开发者需要在dependencies中进行配置

• 2.然后在app的build.gradle的denpendencies中添加：

dependencies {
    implementation ("com.android.support:support-fragment:${rootProject.ext.supportVersion}")
    implementation ("com.android.support:support-annotations:${rootProject.ext.supportVersion}")
    implementation ("com.android.support:recyclerview-v7:${rootProject.ext.supportVersion}")
    implementation "org.greenrobot:greendao:3.2.2"
    implementation 'com.yidian.android:feeds:+'


}

备注：开放平台SDK一直在更新迭代，为了稳定性及新特性，请开发者依赖最新版本，查看各个版本更新信息请点击版本更新记录

3.2 使用方法

com.yidian.newssdk.NewsFeedsSDK.java 这是SDK的配置入口类，目前对外提供了响应的配置方法，开发者可以通过配置

private String mAppKey; SDK初始化所需要的APP_KEY

private String mAppId; SDK初始化所需的APP_ID

private boolean debug; 是否开启DEBUG模式，开启Debug模式后会输出更多的log信息。

在自定义Application的onCreate中添加如下代码，初始化我们的SDK。由于您的应用可能不止一个进程，建议只在主进程初始化我们的SDK。 SDK初始化示例：

new NewsFeedsSDK.Builder()
        .setAppId(BuildConfig.APP_ID)
        .setAppKey(BuildConfig.APP_KEY)
        .setContext(getApplicationContext())
        .setDebugEnabled(BuildConfig.DEBUG)
        .build();
}

您需要在SDK初始化代码中传入APP_ID、APP_KEY。