七夕活动浪漫上线，别让网络拖慢和小姐姐的开黑时间

Shun

七夕情人节到了，各种App都要忙着上新，抓住互联网产品的节日热点，结合应用的类别进行活动营销。比如购物类App会在节日进行大促；旅游类App会推出各种优惠活动；短视频和拍照App会推出各种节日限定特效、专属贴纸等。
尤其是游戏类App，具有较强的社交属性，在节日热点一般都会进行版本更新，上线新皮肤新场景等，涉及到的内容很多，有时候版本更新包的资源太大，导致用户更新时等待时间长，影响运营推广和用户下载体验。这时只需要接入HMS Core Network Kit，就可大幅提升资源下载速率。
HMS Core Network Kit是一款网络基础服务套件，聚合远场网络通信优秀实践，辅以RESTful、文件上传/下载等场景化接口，为您提供简单易用、低时延、高吞吐和高安全的端云传输通道。除了可以提升文件上传/下载的速度和成功率，还可以在URL访问网络场景中提升网络访问速度，在弱网环境中可减少无效网络等待时间，且支持网络平滑迁移。

从图中可以看出，集成Network Kit后下载速度提升约40%。
HMS Core Network Kit首先在QUIC 协议上叠加自研的大文件拥塞控制算法，通过高效的并发数据流，有效提升弱网下的吞吐量；其次，智能分片针对不同机器环境设置不同分片阈值及分片数，尽可能提升下载速度；同时也支持多任务并发执行及管理，任务断点续传，提升下载成功率。适用于与新版本升级、补丁升级、新场景地图等相关资源加载、活动图片、视频下载等。
开发步骤
在进行开发之前，您需要完成必要的开发准备工作，详情可见Network开发指导文档。
SDK集成示例代码如下：

dependencies {
  // 使用Network Kit的网络请求功能
  implementation 'com.huawei.hms:network-embedded: 6.0.0.300'
  // 使用Network Kit的文件上传/下载功能
  implementation 'com.huawei.hms:filemanager: 6.0.0.300'
}

因为Network Kit使用了Java 8的新特性，如：Lambda表达式、静态接口方法等。所以Network Kit均需要为Gradle添加Java 8的环境编译约束。
在“compileOptions”中添加如下编译配置。

android{
  compileOptions{
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
}

示例代码
文件上传
文件上传功能可以通过如下操作实现。详细开发过程和代码实现可以参见codelab（文件上传/下载集成）和示例代码。

• 当适配版本为Android6.0（API Level 23）及以上时，需要动态申请读写手机存储权限（每个应用只需成功申请一次）。
  

if (Build.VERSION.SDK_INT >= 23) {
  if (checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED ||
checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
  requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1000);
  requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1001);
  }
}

• 初始化全局上传管理类UploadManager。
  

UploadManager upManager = (UploadManager) new UploadManager
    .Builder("uploadManager")
    .build(context);

• 构造请求体对象。我们以上传文件file1和file2为例。
  

Map<String, String> httpHeader = new HashMap<>();
httpHeader.put("header1", "value1");
Map<String, String> httpParams = new HashMap<>();
httpParams.put("param1", "value1");
// 替换成您需要上传的目的地址。
String normalUrl = "https://path/upload";
// 替换成您需要上传的文件的地址。
String filePath1 = context.getString(R.string.filepath1);
// 替换成您需要上传的文件的地址。
String filePath2 = context.getString(R.string.filepath2);

// 构造POST请求对象。
try{
  BodyRequest request = UploadManager.newPostRequestBuilder()
      .url(normalUrl)
      .fileParams("file1", new FileEntity(Uri.fromFile(new File(filePath1))))
      .fileParams("file2", new FileEntity(Uri.fromFile(new File(filePath2))))
      .params(httpParams)
      .headers(httpHeader)
      .build();
}catch(Exception exception){
  Log.e(TAG,"exception:" + exception.getMessage());
}

• 创建FileUploadCallback请求回调类。
  

FileUploadCallback callback = new FileUploadCallback() {
  @Override
  public BodyRequest onStart(BodyRequest request) {
    // 文件上传开始时回调此方法。
    Log.i(TAG, "onStart:" + request);
    return request;
  }

  @Override
  public void onProgress(BodyRequest request, Progress progress) {
    // 文件上传进度变化时回调到此方法。
    Log.i(TAG, "onProgress:" + progress);
  }

  @Override
  public void onSuccess(Response<BodyRequest, String, Closeable> response) {
    // 文件上传成功时回调此方法。
    Log.i(TAG, "onSuccess:" + response.getContent());
  }

  @Override
  public void onException(BodyRequest request, NetworkException exception, Response<BodyRequest, String, Closeable> response) {
    // 文件上传过程中网络发生异常，或请求被取消时回调此方法。
    if (exception instanceof InterruptedException) {
      String errorMsg = "onException for canceled";
      Log.w(TAG, errorMsg);
    } else {
      String errorMsg = "onException for:" + request.getId() + " " + Log.getStackTraceString(exception);
      Log.e(TAG, errorMsg);
    }
  }
};

• 发送请求上传指定文件，并获取上传是否启动成功。
  

当Result的getCode方法获取的返回值与静态变量Result.SUCCESS一致则文件上传任务启动成功。

Result result = upManager.start(request, callback);
// 上传任务启动是否成功,可以通过Result的getCode()方法获取的返回值是否与静态变量Result.SUCCESS一致来判断。
if (result.getCode() != Result.SUCCESS) {
  Log.e(TAG, result.getMessage());
}

• 文件上传状态回调。
  

文件上传状态改变时，步骤4创建的FileUploadCallback对象的不同回调方法将被调用。
·文件上传开始时，onStart方法会被调用。
·文件上传进度改变时，onProgress方法会被调用，并可通过解析回调的Progress对象，获取上传进度。
·文件上传任务发生异常时，onException方法会被调用。

• 验证上传结果。
  

文件上传成功后会回调到步骤4创建的FileUploadCallback请求回调对象的onSuccess方法。
文件下载
文件下载功能可以通过如下操作实现。详细开发过程和代码实现请参见codelab（文件上传/下载集成）和示例代码。

• 当适配版本为Android6.0（API Level 23）及以上时，需要动态申请读写手机存储权限（每个应用只需成功申请一次）。
  

if (Build.VERSION.SDK_INT >= 23) {
  if (checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED ||
checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
  requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1000);
  requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1001);
  }
}

• 初始化全局下载管理类DownloadManager。
  

DownloadManager downloadManager = new DownloadManager.Builder("downloadManager")
       .build(context);

• 构造请求体对象。
  

// 替换成您需要下载的资源地址。
String normalUrl = "https://gdown.baidu.com/data/wisegame/10a3a64384979a46/ee3710a3a64384979a46542316df73d4.apk";
// 替换成您想要保存的目的地址。
String downloadFilePath = context.getExternalCacheDir().getPath() + File.separator + "test.apk";
// 构造GET请求体对象。
GetRequest getRequest = DownloadManager.newGetRequestBuilder()
    .filePath(downloadFilePath)
    .url(normalUrl)
    .build();

• 创建FileRequestCallback请求回调对象。
  

FileRequestCallback callback = new FileRequestCallback() {
  @Override
  public GetRequest onStart(GetRequest request) {
    // 文件下载开始时回调此方法。
    Log.i(TAG, "activity new onStart:" + request);
    return request;
  }
 
  @Override
  public void onProgress(GetRequest request, Progress progress) {
    // 文件下载进度变化时回调此方法。
    Log.i(TAG, "onProgress:" + progress);
  }
 
  @Override
  public void onSuccess(Response<GetRequest, File, Closeable> response) {
    // 文件下载成功时回调到此方法。
    String filePath = "";
    if (response.getContent() != null) {
      filePath = response.getContent().getAbsolutePath();
    }
    Log.i(TAG, "onSuccess:" + filePath);
  }
 
  @Override
  public void onException(GetRequest request, NetworkException exception, Response<GetRequest, File, Closeable> response) {
    // 文件下载过程中网络发生异常，或请求被暂停、取消时回调此方法。
    if (exception instanceof InterruptedException) {
      String errorMsg = "onException for paused or canceled";
      Log.w(TAG, errorMsg);
    } else {
      String errorMsg = "onException for:" + request.getId() + " " + Log.getStackTraceString(exception);
      Log.e(TAG, errorMsg);
    }
  }
};

• 使用DownloadManager启动下载任务并检验下载任务是否启动成功。
  

当Result的getCode方法获取的返回值与静态变量Result.SUCCESS一致则文件下载任务启动成功。

Result result = downloadManager.start(getRequest, callback);
if (result.getCode() != Result.SUCCESS) {
  // 当通过result获取到的值为Result.SUCCESS时，则下载任务启动成功，否则启动失败。
  Log.e(TAG, “start download task failed:” + result.getMessage());
}

• 文件下载状态回调。
  

文件下载状态改变时，步骤4创建的FileRequestCallback请求回调对象的不同方法将被调用。
·文件开始下载时，onStart方法会被调用。
·文件下载进度改变时，onProgress方法会被调用，并可通过解析回调的Progress对象，获取下载进度。
·文件下载任务发生异常时，onException方法会被调用。

• 验证下载结果。
  

文件下载成功后会回调到步骤4创建的FileRequestCallback请求回调对象的onSuccess方法，并可根据您设置的下载路径在手机内存中查看到您下载的文件。
了解更多详情>>
访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee
关注我们，第一时间了解 HMS Core 最新技术资讯~