install-sdk

title : 安装 SDK

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

安装和初始化 SDK

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

• 使用 Maven 安装 Wilddog Video SDK

<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

dependencies { compile 'com.wilddog.client:wilddog-video-android:1.0.0-beta' }

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

android {
    ...
    packagingOptions {
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/NOTICE'
    }
}

初始化 Video SDK

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

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

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

@Override
public void onCreate() {

    super.onCreate();

    //初始化WilddogApp实例,初始化WilddogApp后，即可在项目任意位置获取数据库地址引用
    //mAppId即野狗应用ID
    WilddogOptions.Builder builder = new WilddogOptions.Builder().setSyncUrl("http://"+ mAppId +".wilddogio.com");

    WilddogOptions options = builder.build();

    WilddogApp.initializeApp(getApplicationContext(), options);

    //获取数据库地址引用
    SyncReference mRef = WilddogSync.getInstance().getReference();

    //获取Auth对象
    WilddogAuth auth = WilddogAuth.getInstance();

    //匿名登录系统
    auth.signInAnonymously().addOnCompleteListener(new OnCompleteListener<AuthResult>() {
        @Override
        public void onComplete(Task<AuthResult> task) {
            if (task.isSuccessful()) {
                //...
                //完成身份认证后初始化 Video SDK，如身份认证失败则会引起初始化失败或应用崩溃
                 initVideoSDK();

            }else {
                 throw  new RuntimeException("auth 失败"+task.getException().getMessage());
            }
        }
    });


    //....
}

private void initVideoSDK(){
    String path = mRef.getRoot().toString();
    int startIndex = path.indexOf("https://") == 0 ? 8 : 7;
    //获取AppId
    String appid = path.substring(startIndex, path.length() - 14);
    //初始化 WilddogVideo SDK
    WilddogVideo.initializeWilddogVideo(getApplicationContext(), appid);
    //获取 WilddogVideo对象
    WilddogVideo video＝WilddogVideo.getInstance();
    //获取client对象
    WilddogVideoClient client = video.getClient();
}

代码混淆

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

-keep class com.wilddog.client.**{*;}
-keep class com.wilddog.**{*;}

-keep class com.fasterxml.jackson.**{*;}
-keep class com.fasterxml.jackson.databind.**{*;}
-keep class com.fasterxml.jackson.core.**{*;}

其余问题

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

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 {} 中添加：

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