符号表上传说明

符号表上传

当前平台支持两种 符号表上传方式 :

• 手动上传
• 接口上传

手动上传

1. 按照文档说明将符号表文件压缩到一起：点击查看说明

2. 登录平台，点击平台左下角的 设置 进入应用设置界面

   

3. 点击 版本管理 ，找到对应的版本，点击 上传 ，将第一步压缩好的符号表文件上传即可

接口上传

通过这种方式上传符号表的同时会自动创建解析版本
该接口的请求方式是POST
**

接口说明

https://wpk.uc.cn/rest/v1/api/symbol/upload?clientId=_${clientId}_&timestamp=_${timestamp}_&signature=_${signature}_

请求时头部注意添加: content-type: multipart/form-data;

request字段说明:

response：

{
  "id": "8cbdbe8a-173c-466c-82a2-41be0c2ef0f9",
  "code": "200",
  "message": "OK",
  "data": 123, // 符号表的唯一id
  "error": null
}

上传代码：

python版本

# !/usr/bin/python
# -*- coding: utf-8 -*-
import hashlib
import os
import time
import requests
class SignBuilder(object):
    def __init__(self, client_id, secret, timestamp):
        self.__params = {}
        self.__client_id = client_id
        self.__secret = secret
        self.__timestamp = timestamp
    def add_params(self, key, value):
        self.__params[key] = value
        return self
    def body(self, value):
        self.__params["body"] = value
        return self
    def build(self):
        need_md5_txt = self.__client_id + self.__secret + self.__timestamp
        need_md5_txt = need_md5_txt + self.__build_params()
        md5_encoder = hashlib.md5()
        md5_encoder.update(need_md5_txt)
        signature = md5_encoder.hexdigest()
        return signature.lower()
    def __build_params(self):
        keys = self.__params.keys()
        keys = sorted(keys)
        body = ""
        # 组件请求参数体
        for key in keys:
            if key == "" or key in ["clientId", "timestamp", "signature"]:
                continue
            if self.__params[key] is None:
                body = body + key + "="
            else:
                body = body + key + '=' + str(self.__params[key])
        return body
class SymbolType(object):
    TEST = "test"
    RELEASE = "release"
class WpkApi(object):
    def __init__(self, host, client_id, secret):
        self.__host = host
        self.__client_id = client_id
        self.__secret = secret
    def upload_mapping(self, app, ver, symbol_type, file_path, ver_suffix=None):
        if file_path is None or not os.path.exists(file_path):
            raise Exception("Mapping文件不存在:" + str(file_path))
        api_path = "/rest/v1/api/symbol/upload"
        req_url = self.__host + api_path
        data = {
            "app": app,
            "version": ver,
            "symbolType": symbol_type
        }
        files = {
            "file": open(file_path, 'rb'),
        }
        timestamp = str(int(time.time() * 1000))
        sign_builder = SignBuilder(self.__client_id, self.__secret, timestamp)\
            .add_params("app", app) \
            .add_params("version", ver) \
            .add_params("symbolType", symbol_type)
        # 子版本号，非必选
        if ver_suffix is not None:
            data["versionSuffix"] = ver_suffix
            sign_builder.add_params("versionSuffix", ver_suffix)
        sign_str = sign_builder.build()
        req_url = req_url + "?clientId=%s&timestamp=%s&signature=%s" % (self.__client_id, timestamp, sign_str)
        response = requests.post(req_url, data=data, files=files)
        response_json = response.json()
        if response.status_code == requests.codes.ok and str(response_json["code"]) == "200":
            print response.text.encode('utf-8')
            response.close()
            return
        response.close()
        raise Exception("符号表上传失败，服务器响应:" + str(response.text.encode('utf-8')))

使用说明:

wpk_api = WpkApi("https://wpk.uc.cn", "xxxx", "xxxxxxxx")
symbol_type = SymbolType.TEST
sub_ver = "release1d"
if "release" in sub_ver:
    symbol_type = SymbolType.RELEASE
wpk_api.upload_mapping("youyuandroid", "1.2.0(1901191131053)", symbol_type, \
        "/Users/kevin/Documents/youyuandroid_1.0.0.2_190119113105_dev_maps.zip", \
        ver_suffix=sub_ver)

groovy版本

private void uploadMapping(String mappingZip) {
        if (mappingZip == null) {
            return
        }
        File mappingZipFile = new File(mappingZip)
        assert mappingZipFile.exists()
        String version = getBuildInfo().getVersion() + '(' + getBuildInfo().getBuildSequence() + ')'
        String subVersion = getBuildInfo().getSubversion()
        String app = 'novelapp'
        String symbolType = 'release'.equals(subVersion) ? 'release' : 'test'
        long timeStamp = System.currentTimeMillis()
        SignBuilder signBuilder = new SignBuilder()
                .addClientId(UcAndroidPluginConstant.WPK_CLIENT_ID)
                .addTimestamp(timeStamp)
                .addSecret(UcAndroidPluginConstant.WPK_CLIENT_SECRET)
                .addParam('versionSuffix', subVersion)
                .addParam('app', app)
                .addParam('version', version)
                .addParam('symbolType', symbolType)
        String signStr = signBuilder.buildSign()
        String targetMapping = UcAndroidPluginConstant.CRASH_SDK_APP_ID + "_" + getBuildInfo().getVersion() + "_" + getBuildInfo().getBuildSequence() + "_" + getBuildInfo().getSubversion() + "_maps.zip"
        logger.info('uploaded source file: {} , target name', mappingZip, targetMapping)
        println 'uploaded source file: {} , target name' + mappingZip + targetMapping
        String url = UcAndroidPluginConstant.CRASH_SDK_MAPPING_UPLOAD_URL + String.format('?clientId=%s&timestamp=%s&signature=%s&app=%s&version=%s&versionSuffix=%s&symbolType=%s', UcAndroidPluginConstant.WPK_CLIENT_ID, String.valueOf(timeStamp), signStr, app, version, subVersion, symbolType)
        println 'url: ' + url
        //upload
        def http = new HTTPBuilder(url)
        http.ignoreSSLIssues()
        http.request(Method.POST) { request ->
            def entityBuilder = MultipartEntityBuilder.create()
                    .addBinaryBody('file', mappingZipFile)
            request.entity = entityBuilder.build()
            response.success = {
                println 'uploaded file: {}' + mappingZip
                HttpResponseUtil.logResponse(it)
            }
            response.failure = {
                println 'unable to upload file: ' + mappingZip
                HttpResponseUtil.logResponse(it)
            }
        }
    }

package com.xxx.build.gradle.helper;
import java.util.Map;
import java.util.Map.Entry;
import java.util.TreeMap;
import org.apache.commons.codec.digest.DigestUtils;
public class SignBuilder {
    private Map<String, String> params = new TreeMap<>();
    // json body
    private String body;
    private String clientId;
    private String secret;
    private Long timestamp;
    // 旧版1.0用的是随机串，并且不校验时常
    private String nonce;
    public SignBuilder addParams (Map<String, String> params) {
        this.params.clear();
        this.params.putAll(params);
        return this;
    }
    public SignBuilder addParam(String name, String value) {
        params.put(name, value);
        return this;
    }
    public SignBuilder addBody (String body) {
        this.addParam("body", body);
        return this;
    }
    public SignBuilder addClientId(String clientId) {
        this.clientId = clientId;
        return this;
    }
    public SignBuilder addSecret(String secret) {
        this.secret = secret;
        return this;
    }
    public SignBuilder addTimestamp(Long timestamp) {
        this.timestamp = timestamp;
        return this;
    }
    public SignBuilder nonce(String nonce) {
        this.nonce = nonce;
        return this;
    }
    /**
     * 构建签名信息
     * @return
     */
    public String buildSign() {
        StringBuilder singBuilder =  new StringBuilder(clientId).append(secret).append(timestamp);
        singBuilder.append(this.buildParams());
        return DigestUtils.md5Hex(singBuilder.toString());
    }
    /**
     * 拼接请求参数
     * @return
     */
    private StringBuilder buildParams () {
        StringBuilder rst = new StringBuilder();
        for (Entry<String, String> entry : params.entrySet()) {
            if (isBlank(entry.getKey())) {
                continue;
            }
            if (null == entry.getValue()) {
                rst.append(entry.getKey()).append("=");
            } else {
                String value = entry.getValue();
                rst.append(entry.getKey()).append("=").append(value);
            }
        }
        return rst;
    }
    public static boolean isBlank(String str) {
        int strLen;
        if (str != null && (strLen = str.length()) != 0) {
            for(int i = 0; i < strLen; ++i) {
                if (!Character.isWhitespace(str.charAt(i))) {
                    return false;
                }
            }
            return true;
        } else {
            return true;
        }
    }
}