Bazaarvoice移动sdk提供了对Bazaarvoice提供的大多数核心产品的访问。必威手机版本要了解更多信息,请参阅Mobile SDK文档主页

内容

+显示 ——隐藏

本指南向您展示如何安装和导入Bazaarvoice Mobile SDK到您的Android应用程序。

先决条件

  • 已签署的资料使用修订(如尚未生效)
  • Android最低部署目标为4.1.0 (API级别16)
  • Android工作室
  • 您的客户ID
  • 已启用的Bazaarvoice产品的API密钥必威手机版本

版本控制

Android的Mobile SDK是有版本化的,这样我们就可以发布新功能、bug修复和改进,而不会影响使用旧版本的应用程序的稳定性。

该表总结了主要的版本发布。有关更多信息,请参阅移动SDK的Android Github回购

版本 发布日期 状态
1 2012年7月26日 弃用
2 2013年1月31日 弃用
3. 2016年3月8日 弃用
4 2016年5月4日 弃用
5 2016年10月31日 支持
6 2017年1月23日 支持
7 2018年6月18日 支持
8 2018年10月1日 最新的
弃用
不应期望这些版本返回数据和/或可能遇到服务降级。特定于这些版本的文档可能不再可用。这些版本不应该被任何应用程序使用。
支持
受支持的版本会继续得到安全性和错误修复,但是使用这些版本的应用程序应该在可能的情况下升级到最新版本,以利用新特性。新的应用程序不应该使用这些版本。
最新的
这是最新版本。新的应用程序应该使用这个版本的最新版本。

使用Gradle安装

对于使用存档版本(.aar)的手动安装,请使用BVSDK Maven存储库

添加以下依赖项以包含Maven Central存储库并添加Bazaarvoice Mobile SDK模块。您只需要为拥有API键的产品添加依赖项。必威手机版本

依赖{实现` com.bazaarvoice.bvandroidsdk:analytics:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk: aust -iovation:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk:conversations:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk:curations:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk: cursions -ui:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk:location:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk:建议:{BV_SDK_VERSION}。+' implementation 'com.bazaarvoice.bvandroidsdk:store-notifications:{BV_SDK_VERSION}。+'}存储库{mavenCentral()}

取代{令牌},包括括号,并加上适当的值。请参阅安装指南{BV_SDK_VERSION}

下载iovation SDK

请参阅指纹识别主题下载iovation SDK并将其添加到您的项目中。需要这个SDK来确保用户生成内容的真实性。

配置BVSDK

一旦安装了SDK的源代码,现在就可以初始化BVSDK使用API密钥和环境(登台vs生产)。

下表将为您的SDK生成一个配置文件。您设置的值将生成必要的脚本和Mobile SDK初始化代码,以便快速启动和运行。

每个客户端应用程序都应该有自己的API密钥。如果您需要为对话生成一个新键,请参见请求API密钥的对话

对于所有其他API密钥,或者如果您不知道您的客户端ID,请联系Bazaarvoice的支持或者你的实现团队。

必威手机版本 生产 暂存
内容管理
对话
商店对话
产品推荐及广告
分析语言环境

输入客户端ID和至少一个API密钥。

创建一个可扩展的类android.app.Application,并使用其构建器初始化Mobile SDK。

中可以找到构建选项的完整列表BVSDK.java

公共类MyApplication扩展Application{@覆盖公共无效onCreate(){super.onCreate();/ / BazaarEnvironment。PRODUCTION从bvsdk_config_prod读取。. json // BazaarEnvironment. jsonSTAGING从bvsdk_config_staging读取。json BVSDK。builder(application, bazaarenenvironment . production) . loglevel (BVLogLevel.VERBOSE) //可选:设置日志级别。. dryrunanalytics (false) //可选:只设置分析为日志,不发起网络请求。.okHttpClient(okHttpClient) //可选:使用您自己的okHttpClient实例.build();}}

应用程序清单文件

将以下内容添加到您的AndroidManifest.xml文件。

                <应用android: name = "。MyApplication " > < /应用程序>

Bazaarvoice SDK依赖项

如果你的应用程序和我们的SDK使用相同依赖的不同版本,我们在下面编译了一个依赖列表,以帮助调试每个模块。

如果你的应用程序有任何com.android.supportcom.google.android.gms,或com.gimbal.android.v2模块,这将是最好的你看看具体的模块,我们要求从这些包下面。在构建中重新声明它们。Gradle与你想要的明确版本。这将避免在编译时出现任何“重复类”问题。

  • 分析

    实现"com.squareup.okhttp3:okhttp:3.10.0"实现"com.google.android.gms:play-services-ads:15.0.0"实现"com.android.support:support-annotations:27.0.0"
  • 常见的

    从分析中继承,并添加:

    实现"com.google.code.gson:gson:2.8.5"实现"com.android.support:recyclerview-v7:27.0.0"
  • 广告

    继承公共的,没有额外的依赖。

  • Auth-Iovation

    从对话中继承,并添加:

    实现(“com.iovation.fraudforce.lib.FraudForce: fraudforce-lib-release-3.0.1:3.0.1@aar”)
  • 对话

    继承公共的,没有额外的依赖。

  • 内容管理

    继承公共的,没有额外的依赖。

  • 位置

    继承common,并添加:

    实现“com.gimbal.android.v2:gimbal-sdk:2.72”实现“com.gimbal.android.v2:gimbal-slf4j-impl:2.72”
  • 通知

    继承common,并添加:

    实现“com.android.support: appcompat-v7:27.0.0”
  • 建议

    继承公共的,没有额外的依赖。

  • 商店的通知

    从位置、通知和对话继承。没有额外的依赖关系。

缩小、模糊化和优化你的应用

用户通常会避免下载看起来太大的应用程序。为了帮助您减少应用程序的大小,Bazaarvoice Android SDK现在增加了对R8编译器的支持缩小、模糊化和优化你的应用

当你设置minifyEnabled财产真正的, R8为项目的发布构建类型执行这些任务。此属性可在应用程序的build.gradle文件如下面的代码片段所示:

当设置为true时,R8编译器会删除一些未使用的代码。然而,有些情况R8很难正确分析,它可能会删除应用程序实际需要的代码。若要修复错误并强制R8保留某些代码,请添加行在ProGuard规则文件。

buildTypes {release {minifyEnabled true proguardFiles getDefaultProguardFile('proguard-android- optimization .txt'), 'proguard-rules. txt'Pro '}}

Bazaarvoice Android SDK将配置其Proguard规则使用proguard-rules.txt其中定义了BVConversations模块的keep规则。这些保留规则告诉R8不仅要在应用程序的最终DEX中保留该代码,还要保留其原始命名。这是必要的,以保持方法/字段(及其名称)以及类名完整,并避免使用BVConversations模块时错误的混淆和错误。

完成安装

完成上述步骤后,应该配置和安装Bazaarvoice Mobile SDK。如果你遇到困难,联系Bazaarvoice的支持或者你的实现团队。

下一个