移动sdk:将Bazaarvoice集成到您的原生Android和iOS应用程序中。
安装
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安装
添加以下依赖项以包含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.support
,com.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的支持或者你的实现团队。