title : 安装 SDK

本篇文档介绍如何安装和初始化 SDK。

安装和初始化 SDK

Video SDK 包含了 Sync 和 Auth SDK 的依赖，不需要重复导入 Sync / Auth SDK 。

  • 使用 Maven 安装 Wilddog Video SDK
  1. <dependency>
        <groupId>com.wilddog.client</groupId>
        <artifactId>wilddog-video-android</artifactId>
        <version>1.0.0-beta</version>
        <type>aar</type>
    </dependency>
  • 使用 Gradle 安装 Wilddog Video SDK
  1. dependencies { 
        compile 'com.wilddog.client:wilddog-video-android:1.0.0-beta'
    }

如果出现由于文件重复导致的编译错误，可以在 build.gradle 中添加 packingOptions:

  1. android {
  2.     ...
  3.     packagingOptions {
  4.         exclude 'META-INF/LICENSE'
  5.         exclude 'META-INF/NOTICE'
  6.     }
  7. }

初始化 Video SDK

客户端在使用 Video SDK 前需要初始化 WilddogVideoClient 来连接客户端和野狗服务器。

初始化 WilddogVideoClient 之前，要先经过 野狗身份认证。开发者可以根据需要选择匿名登录、邮箱密码、第三方或自定义认证等方式进行身份认证。

例如，以匿名方式登录后初始化 WilddogVideoClient ：

  1. @Override
  2. public void onCreate() {
  4.     super.onCreate();
  6.     //初始化WilddogApp实例,初始化WilddogApp后，即可在项目任意位置获取数据库地址引用
  7.     //mAppId即野狗应用ID
  8.     WilddogOptions.Builder builder = new WilddogOptions.Builder().setSyncUrl("http://"+ mAppId +".wilddogio.com");
  10.     WilddogOptions options = builder.build();
  12.     WilddogApp.initializeApp(getApplicationContext(), options);
  14.     //获取数据库地址引用
  15.     SyncReference mRef = WilddogSync.getInstance().getReference();
  17.     //获取Auth对象
  18.     WilddogAuth auth = WilddogAuth.getInstance();
  20.     //匿名登录系统
  21.     auth.signInAnonymously().addOnCompleteListener(new OnCompleteListener<AuthResult>() {
  22.         @Override
  23.         public void onComplete(Task<AuthResult> task) {
  24.             if (task.isSuccessful()) {
  25.                 //...
  26.                 //完成身份认证后初始化 Video SDK，如身份认证失败则会引起初始化失败或应用崩溃
  27.                  initVideoSDK();
  29.             }else {
  30.                  throw  new RuntimeException("auth 失败"+task.getException().getMessage());
  31.             }
  32.         }
  33.     });
  36.     //....
  37. }
  39. private void initVideoSDK(){
  40.     String path = mRef.getRoot().toString();
  41.     int startIndex = path.indexOf("https://") == 0 ? 8 : 7;
  42.     //获取AppId
  43.     String appid = path.substring(startIndex, path.length() - 14);
  44.     //初始化 WilddogVideo SDK
  45.     WilddogVideo.initializeWilddogVideo(getApplicationContext(), appid);
  46.     //获取 WilddogVideo对象
  47.     WilddogVideo video＝WilddogVideo.getInstance();
  48.     //获取client对象
  49.     WilddogVideoClient client = video.getClient();
  50. }

代码混淆

在生成 apk 进行代码混淆时进行如下配置：

  1. -keep class com.wilddog.client.**{*;} 
  2. -keep class com.wilddog.**{*;} 
  4. -keep class com.fasterxml.jackson.**{*;} 
  5. -keep class com.fasterxml.jackson.databind.**{*;} 
  6. -keep class com.fasterxml.jackson.core.**{*;}

其余问题

在 Android Studio 进行 Sync Project 时会提示如下警告：

  1. Warning:WARNING: Dependency org.json:json:20090211 is ignored for debug as it may be conflicting with the internal version provided by Android.

消除警告请进行如下配置，在模块级 build.gradle 文件的 android {} 中添加：

  1.     configurations {
  2.         compile.exclude group: "org.json", module: "json"
  3.     }