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

七夕情人节到了，各种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（文件上传/下载集成）和示例代码。

1. 当适配版本为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);
    }
}

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

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

3. 构造请求体对象。我们以上传文件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());
}

4. 创建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);
        }
    }
};

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

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

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

6. 文件上传状态回调。

文件上传状态改变时，步骤4创建的FileUploadCallback对象的不同回调方法将被调用。

• 文件上传开始时，onStart方法会被调用。

• 文件上传进度改变时，onProgress方法会被调用，并可通过解析回调的Progress对象，获取上传进度。

• 文件上传任务发生异常时，onException方法会被调用。

7. 验证上传结果。

文件上传成功后会回调到步骤4创建的FileUploadCallback请求回调对象的onSuccess方法。

文件下载

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

1. 当适配版本为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);
    }
}

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

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

3. 构造请求体对象。

// 替换成您需要下载的资源地址。
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();

4. 创建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);
        }
    }
};

5. 使用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());
}

6. 文件下载状态回调。

文件下载状态改变时，步骤4创建的FileRequestCallback请求回调对象的不同方法将被调用。

• 文件开始下载时，onStart方法会被调用。

• 文件下载进度改变时，onProgress方法会被调用，并可通过解析回调的Progress对象，获取下载进度。

• 文件下载任务发生异常时，onException方法会被调用。

7. 验证下载结果。

文件下载成功后会回调到步骤4创建的FileRequestCallback请求回调对象的onSuccess方法，并可根据您设置的下载路径在手机内存中查看到您下载的文件。

了解更多详情>>

访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee

关注我们，第一时间了解 HMS Core 最新技术资讯~