Android SDK

{"value":"Android SDK \u53ea\u5305\u542b\u4e86\u6700\u7ec8\u7528\u6237\u4f7f\u7528\u573a\u666f\u4e2d\u7684\u5fc5\u8981\u529f\u80fd\u3002\u76f8\u6bd4\u670d\u52a1\u7aef SDK \u800c\u8a00\uff0c\u5ba2\u6237\u7aef SDK \u4e0d\u4f1a\u5305\u542b\u5bf9\u4e91\u5b58\u50a8\u670d\u52a1\u7684\u7ba1\u7406\u548c\u914d\u7f6e\u529f\u80fd\u3002\n\n- [Android SDK \u4e0b\u8f7d\u5730\u5740](https:\/\/github.com\/CDNCloudForU\/android-sdk)\n\n- [Android SDK \u6e90\u7801\u5730\u5740](https:\/\/github.com\/qiniu\/android-sdk)\n\n \n\n\n\n# \u5b89\u88c5\n\n### \u76f4\u63a5\u5b89\u88c5\n\n\u5c06 sdk jar\u6587\u4ef6 \u590d\u5236\u5230\u9879\u76ee\u4e2d\u53bb\uff0c [jar\u5305\u4e0b\u8f7d\u5730\u5740](http:\/\/search.maven.org\/#search|ga|1|com%2Fqiniu%2Fqiniu-android-sdk) , \u4e0b\u8f7d\u5bf9\u5e94\u7684 jar \u5305\uff0c\u4ee5\u53ca\u641c\u7d22\u4e0b\u8f7d\u5bf9\u5e94\u7684\u4f9d\u8d56\u5e93\n\n[happy-dns\u4e0b\u8f7d\u5730\u5740](https:\/\/repo1.maven.org\/maven2\/com\/qiniu\/happy-dns\/)\n\n### \u901a\u8fc7 maven\n\n- Android Studio\u4e2d\u6dfb\u52a0 dependencies \u6216\u8005\u5728\u9879\u76ee\u4e2d\u6dfb\u52a0 maven \u4f9d\u8d56\n\n```\n\/\/ 1 \u76f4\u63a5\u5bfc\u5165\nimplementation 'com.qiniu:qiniu-android-sdk:8.4.+'\n\n\/\/ 2 \u5982\u679c\u8981\u4fee\u6539okhttp\u4f9d\u8d56\u7684\u7248\u672c\uff0c\u53ef\u91c7\u7528\u4ee5\u4e0b\u65b9\u5f0f\uff08\u5f3a\u70c8\u5efa\u8bae\u4f7f\u7528\u4e03\u725b\u5e93\u4f9d\u8d56\u7684okhttp\u7248\u672c\uff09\nimplementation ('com.qiniu:qiniu-android-sdk:8.4.+'){\n exclude (group: 'com.squareup.okhttp3', module: 'okhttp')\n}\nimplementation 'com.squareup.okhttp3:okhttp:4.2.2'\n```\n\n- \u5982\u679c\u662f eclipse, \u4e5f\u53ef\u4ee5\u76f4\u63a5\u6dfb\u52a0\u4f9d\u8d56\u6765\u5904\u7406\u3002\n\n### \u76f8\u5173\u94fe\u63a5\n\n- [cdncloud-android-sdk](https:\/\/github.com\/CDNCloudForU\/android-sdk\/)\n- [okhttp](http:\/\/square.github.io\/okhttp\/)\n\n\u5982\u679c\u9700\u8981\u4e0b\u8f7d\u5386\u53f2 jar \u5305\uff0c\u4e5f\u53ef\u4ee5\u5728 maven \u4e0a\u76f4\u63a5\u4e0b\u8f7d\uff0c\u8bf7\u53c2\u8003 [\u8fd9\u91cc](http:\/\/search.maven.org\/#search|gav|1|g%3A\"com.qiniu\" AND a%3A\"qiniu-android-sdk\") \u3002\n\n\n\n# \u5b89\u5168\u673a\u5236\n\n\u8be5 SDK \u672a\u5305\u542b\u51ed\u8bc1\u751f\u6210\u76f8\u5173\u7684\u529f\u80fd\u3002\u5f00\u53d1\u8005\u5bf9\u5b89\u5168\u6027\u7684\u63a7\u5236\u5e94\u9075\u5faa \u5b89\u5168\u673a\u5236\u4e2d\u5efa\u8bae\u7684\u505a\u6cd5\uff0c\u5373\u5ba2\u6237\u7aef\u5e94\u5411\u4e1a\u52a1\u670d\u52a1\u5668\u6bcf\u9694\u4e00\u6bb5\u65f6\u95f4\u8bf7\u6c42 \u4e0a\u4f20\u51ed\u8bc1\uff0c\u800c\u4e0d\u662f\u76f4\u63a5\u5728\u5ba2\u6237\u7aef\u4f7f\u7528 AccessKey \/ SecretKey \u751f\u6210\u5bf9\u5e94\u7684\u51ed\u8bc1\u3002\u5728\u5ba2\u6237\u7aef\u4f7f\u7528 SecretKey \u4f1a\u5bfc\u81f4\u4e25\u91cd\u7684\u5b89\u5168\u9690\u60a3\u3002\n\n\u5f00\u53d1\u8005\u53ef\u4ee5\u5728\u751f\u6210\u4e0a\u4f20\u51ed\u8bc1\u524d\u901a\u8fc7\u914d\u7f6e \u4e0a\u4f20\u7b56\u7565 \u6765\u63a7\u5236\u4e0a\u4f20\u7684\u540e\u7eed\u52a8\u4f5c\uff0c\u4f8b\u5982\u5728\u4e0a\u4f20\u5b8c\u6210\u540e\u901a\u8fc7\u56de\u8c03\u673a\u5236\u901a\u77e5\u4e1a\u52a1\u670d\u52a1\u5668\u3002\u8be5\u5de5\u4f5c\u5728\u4e1a\u52a1\u670d\u52a1\u5668\u7aef\u8fdb\u884c\uff0c\u56e0\u6b64\u975e\u672c SDK \u7684\u529f\u80fd\u8303\u7574\u3002\n\n\u5b58\u50a8\u7684\u670d\u52a1\u7aef SDK \u63d0\u4f9b\u4e86\u4e0a\u4f20\u51ed\u8bc1\u7684\u751f\u6210\u529f\u80fd\uff0c\u8bf7\u53c2\u8003\u5404\u4e2a\u670d\u52a1\u7aef\u8bed\u8a00\u7684 SDK \u6587\u6863\u3002\n\n\n\n# \u521d\u59cb\u5316\n\n\u4e00\u822c\u60c5\u51b5\u4e0b\u53ef\u4ee5\u76f4\u63a5\u4f7f\u7528\u9ed8\u8ba4\u8bbe\u7f6e\uff0c\u4e0d\u7528\u5355\u72ec\u914d\u7f6e\u3002\u53ef\u4ee5\u914d\u7f6e\u8d85\u65f6\u65f6\u957f\u3001\u5206\u7247\u4e0a\u4f20\u9600\u503c\u7b49\u3002\n\n```java\nConfiguration config = new Configuration.Builder()\n .connectTimeout(90) \/\/ \u94fe\u63a5\u8d85\u65f6\u3002\u9ed8\u8ba490\u79d2\n .useHttps(true) \/\/ \u662f\u5426\u4f7f\u7528https\u4e0a\u4f20\u57df\u540d\n .useConcurrentResumeUpload(true) \/\/ \u4f7f\u7528\u5e76\u53d1\u4e0a\u4f20\uff0c\u4f7f\u7528\u5e76\u53d1\u4e0a\u4f20\u65f6\uff0c\u9664\u6700\u540e\u4e00\u5757\u5927\u5c0f\u4e0d\u5b9a\u5916\uff0c\u5176\u4f59\u6bcf\u4e2a\u5757\u5927\u5c0f\u56fa\u5b9a\u4e3a4M\uff0c\n .resumeUploadVersion(Configuration.RESUME_UPLOAD_VERSION_V2) \/\/ \u4f7f\u7528\u65b0\u7248\u5206\u7247\u4e0a\u4f20\n .concurrentTaskCount(3) \/\/ \u5e76\u53d1\u4e0a\u4f20\u7ebf\u7a0b\u6570\u91cf\u4e3a3\n .responseTimeout(90) \/\/ \u670d\u52a1\u5668\u54cd\u5e94\u8d85\u65f6\u3002\u9ed8\u8ba490\u79d2\n .recorder(recorder) \/\/ recorder\u5206\u7247\u4e0a\u4f20\u65f6\uff0c\u5df2\u4e0a\u4f20\u7247\u8bb0\u5f55\u5668\u3002\u9ed8\u8ba4null\n .recorder(recorder, keyGen) \/\/ keyGen \u5206\u7247\u4e0a\u4f20\u65f6\uff0c\u751f\u6210\u6807\u8bc6\u7b26\uff0c\u7528\u4e8e\u7247\u8bb0\u5f55\u5668\u533a\u5206\u662f\u90a3\u4e2a\u6587\u4ef6\u7684\u4e0a\u4f20\u8bb0\u5f55\n .zone(FixedZone.zone0) \/\/ \u8bbe\u7f6e\u533a\u57df\uff0c\u4e0d\u6307\u5b9a\u4f1a\u81ea\u52a8\u9009\u62e9\u3002\u6307\u5b9a\u4e0d\u540c\u533a\u57df\u7684\u4e0a\u4f20\u57df\u540d\u3001\u5907\u7528\u57df\u540d\u3001\u5907\u7528IP\u3002\n .build();\n\n\/\/ \u91cd\u7528uploadManager\u3002\u4e00\u822c\u5730\uff0c\u53ea\u9700\u8981\u521b\u5efa\u4e00\u4e2auploadManager\u5bf9\u8c61\nUploadManager uploadManager = new UploadManager(config);\n```\n\n# \u652f\u6301\u4f7f\u7528 HTTP\/3 \u534f\u8bae\u53d1\u8d77\u8bf7\u6c42\n\n\u5bfc\u5165 [HTTP\/3 client \u63d2\u4ef6](https:\/\/github.com\/CDNCloud-com\/cdncloud-android-curl-plugin)\uff0chttp3 client \u63d2\u4ef6\u4f9d\u8d56\u4e8e Android SDK v8.5.0\u53ca\u4ee5\u4e0a\u7248\u672c\n\n\u5b89\u88c5\u5bfc\u5165\n\n```java\n\/\/ \u79fb\u9664 qiniu-android-sdk \u4f9d\u8d56 : implementation 'com.qiniu:qiniu-android-sdk:x.x.+' \nimplementation 'com.qiniu:qiniu-android-curl-plugin:1.0.0'\n```\n\n\u4f7f\u7528 CurlClient\n\n```java\nimport com.qiniu.client.curl.CurlClient;\nimport com.qiniu.android.storage.GlobalConfiguration;\nimport com.qiniu.android.storage.Configuration;\nimport com.qiniu.android.storage.UploadManager;\n\n\/\/ \u5f00\u542f HTTP\/3\nGlobalConfiguration.getInstance().enableHttp3 = true;\n\n\/\/ @param caPath: SSL \u8bc1\u4e66\u672c\u5730\u8def\u5f84\uff1b\u5982\u679c\u60f3\u81ea\u5b9a\u4e49 CA \u53ef\u8bbe\u7f6e\u6b64\u9009\u9879\uff0c\u6b64\u5904\u4e3a CA \u6587\u4ef6\u7684\u672c\u5730\u8def\u5f84\u3002\n\/\/ \u5982\u679c\u672a\u5b9a\u4e49\uff08caPath \u914d\u7f6e null\uff09\u5219\u4f7f\u7528 SDK \u5185\u90e8\u63d0\u4f9b\u7684 CA \u8bc1\u4e66\uff0c\u8bc1\u4e66\u6765\u6e90\uff1ahttps:\/\/curl.se\/ca\/cacert.pem\nCurlClient client = new CurlClient(caPath);\nConfiguration config = new Configuration.Builder()\n .requestClient(client) \/\/ \u6307\u5b9a HTTP\/3 Client\n .build();\nUploadManager manager = new UploadManager(config);\n```\n\n# \u7248\u672c\n\n| SDK \u7248\u672c | \u6700\u4f4e Android\u7248\u672c | \u4f9d\u8d56\u5e93\u7248\u672c |\n| -------------- | ---------------- | ------------------------ |\n| 8.4.x | Android 4.0+ | okhttp 4+ |\n| 8.3.1+ | Android 4.0+ | okhttp 4+ |\n| 8.3.0 | Android 5.0+ | okhttp 4+ |\n| 8.2.x | Android 5.0+ | okhttp 4+ |\n| 8.1.x | Android 5.0+ | okhttp 4+ |\n| 8.0.x | Android 5.0+ | okhttp 4+ |\n| 7.6.x | Android 5.0+ | okhttp 4+ |\n| 7.5.x | Android 5.0+ | okhttp 4+ |\n| 7.4.6 | Android 4.0+ | okhttp 3.12.6 |\n| 7.3.x | Android 2.3+ | okhttp 3.11.0 |\n| 7.2.x | Android 2.3+ | okhttp 3+ |\n| 7.1.x | Android 2.3+ | okhttp 2.6+ |\n| 7.0.8,7.0.9 | Android 2.2+ | android-async-http 1.4.9 |\n| 7.0.7 | Android 2.2+ | android-async-http 1.4.8 |\n\n### \u6ce8\u610f\n\n- \u4ece 7.4.0 \u5f00\u59cb\u589e\u52a0\u4e86 DNS \u9884\u89e3\u6790\u548c\u7f13\u5b58\u7b56\u7565\uff0c\u51cf\u5c11 DNS \u89e3\u6790\u9519\u8bef\u3002\n- \u4ece 8.0.0 \u5f00\u59cb\u589e\u52a0\u4e86\u6bcf 2 \u5206\u949f\uff08\u8fdb\u7a0b\u975e\u6302\u8d77\u72b6\u6001\uff09\u81ea\u52a8\u5237\u65b0\u7f13\u5b58\u7b56\u7565\u3002\u540c\u65f6\u589e\u52a0\u4e86 DNS \u9884\u89e3\u6790 \u5f00\u5173\u63a7\u5236\uff0c\u9ed8\u8ba4\u5f00\u542f\uff0c\u53ef\u4ee5\u901a\u8fc7 GlobalConfiguration.getInstance().isDnsOpen = false \u5173\u95ed DNS \u9884\u89e3\u6790\u3002\n- \u4ece 8.3.2 \u5f00\u59cb\u5bf9 DNS \u9884\u89e3\u6790\u7f13\u5b58\u589e\u52a0\u7f13\u5b58\u6709\u6548\u671f\uff0c\u9ed8\u8ba4 10 \u5206\u949f\uff0c\u652f\u6301\u624b\u52a8\u4fee\u6539\u6709\u6548\u671f GlobalConfiguration.getInstance().dnsCacheMaxTTL \u65f6\u957f\uff0c\u5355\u4f4d\u4e3a s\u3002\n- SDK \u5185\u7f6e\u670d\u52a1\u7cfb\u7edf DNS \u89e3\u6790\u548c HTTP DNS \u89e3\u6790\uff08\u4ece 8.4.0 \u5f00\u59cb\uff09\uff0c\u5982\u679c\u8fd9\u4e24\u4e2a DNS \u89e3\u6790\u4e0d\u80fd\u6ee1\u8db3\u60a8\u7684\u9700\u6c42\uff0c\u90a3\u4e48\u53ef\u4ee5\u9009\u62e9\u81ea\u5b9a\u4e49 DNS \u89e3\u6790\u3002\u5982\u679c\u60a8\u81ea\u5b9a\u4e49\u4e86 DNS \u89e3\u6790\uff0c\u90a3\u4e48\u5728 DNS \u9884\u53d6\u65f6\u4f1a\u4f18\u5148\u4f7f\u7528\u60a8\u81ea\u5b9a\u4e49\u7684 DNS \u89e3\u6790\u3002\n- \u5982\u679c\u53ef\u4ee5\u660e\u786e\u533a\u57df\u7684\u8bdd\uff0c\u6700\u597d\u6307\u5b9a\u56fa\u5b9a\u533a\u57df\uff0c\u8fd9\u6837\u53ef\u4ee5\u5c11\u4e00\u6b65\u7f51\u7edc\u8bf7\u6c42\uff0c\u5c11\u4e00\u6b65\u51fa\u9519\u7684\u53ef\u80fd\u3002\n- \u5982\u679c\u4f7f\u7528 Android 4.x \uff0c\u5bf9\u5e94 okhttp \u7248\u672c\u8bf7\u8c03\u6574\u81f3 3.12.+\n\n\u4e0b\u65b9\u4e3a 8.x \u4f7f\u7528\u5916\u90e8 DNS \u7ec4\u4ef6 httpDns \u7684\u793a\u4f8b\u4ee3\u7801(\u5b9e\u4f8b\u4ec5\u4e3a\u4f7f\u7528\u65b9\u5f0f\u6f14\u793a\uff0c\u8bf7\u6839\u636e\u60a8\u7684\u9700\u6c42\u81ea\u884c\u5904\u7406 DNS \u89e3\u6790\u7ec6\u8282):\n\n```\nimport com.qiniu.android.http.Dns;\n\nclass DemoDnsNetworkAddress implements IDnsNetworkAddress {\n\n private final String hostValue;\n private final String ipValue;\n private final Long ttlValue;\n private final String sourceValue;\n private final Long timestampValue;\n\n DemoDnsNetworkAddress(String hostValue,\n String ipValue,\n Long ttlValue,\n String sourceValue,\n Long timestampValue) {\n this.hostValue = hostValue;\n this.ipValue = ipValue;\n this.ttlValue = ttlValue;\n this.sourceValue = sourceValue;\n this.timestampValue = timestampValue;\n }\n\n @Override\n public String getHostValue() {\n return hostValue;\n }\n\n @Override\n public String getIpValue() {\n return ipValue;\n }\n\n @Override\n public Long getTtlValue() {\n return ttlValue;\n }\n\n @Override\n public String getSourceValue() {\n return sourceValue;\n }\n\n @Override\n public Long getTimestampValue() {\n return timestampValue;\n }\n }\n\npublic Dns buildDefaultDns() {\n \/\/ \u53ef\u6dfb\u52a0\u4fee\u6539 \u591a\u4e2a IResolver \n \/\/ \u9002\u5f53\u8c03\u6574\u4e0d\u540c IResolver \u7684\u52a0\u5165\u987a\u5e8f\uff0c\u6bd4\u5982:223.5.5.5\uff0c119.29.29.29\uff0c114.114.114.114\uff0c8.8.8.8 \u7b49 \n ArrayList<IResolver> rs = new ArrayList<IResolver>(3);\n try {\n IResolver r1 = new Resolver(InetAddress.getByName(\"119.29.29.29\"));\n rs.add(r1);\n } ctch (Exception ex) {\n ex.printStackTrace();\n }\n try {\n rs.add(new Resolver(InetAddress.getByName(\"114.114.114.114\")));\n } catch (Exception ex) {\n ex.printStackTrace();\n }\n try {\n \/\/ \u8bfb\u53d6\u7cfb\u7edf\u76f8\u5173\u5c5e\u6027\n \/\/ android 27 \u53ca\u4ee5\u4e0a \u4f1a\u62a5\u9519\n IResolver r2 = AndroidDnsServer.defaultResolver();\n rs.add(r2);\n } catch (Exception ex) {\n ex.printStackTrace();\n }\n if (rs.size() == 0) {\n return null;\n }\n final DnsManager dnsManager = new DnsManager(NetworkInfo.normal, rs.toArray(new IResolver[rs.size()]));\n\n Dns dns = new Dns() {\n \/\/ \u82e5\u629b\u51fa\u5f02\u5e38 Exception \uff0csdk \u4f1a\u4f7f\u7528 okhttp \u7ec4\u4ef6\u9ed8\u8ba4 dns \u89e3\u6790\u7ed3\u679c \n @Override\n public List<IDnsNetworkAddress> lookup(String hostname) throws UnknownHostException {\n Domain domain = new Domain(hostname);\n List<IDnsNetworkAddress> addressList = null;\n try {\n Record[] records = dnsManager.queryRecords(domain);\n if (records != null && records.length > 0){\n addressList = new ArrayList<>();\n for (Record record : records) {\n String source = \"customized\";\n DemoDnsNetworkAddress address = new DemoDnsNetworkAddress(hostname, record.value, (long)record.ttl, source, record.timeStamp);\n addressList.add(address);\n }\n }\n } catch (IOException ignored) {\n }\n return addressList;\n }\n };\n return dns;\n}\n\nGlobalConfiguration.getInstance().dns = buildDefaultDns();\nuploadManager = new UploadManager();\n```\n\n\n\n# \u4e0a\u4f20\u6587\u4ef6\n\nSDK \u5185\u7f6e\u4e24\u79cd\u4e0a\u4f20\u65b9\u5f0f\uff1a\u8868\u5355\u4e0a\u4f20\u548c\u5206\u7247\u4e0a\u4f20\uff0c\u5e76\u6839\u636e\u5177\u4f53\u60c5\u51b5\uff0c\u5185\u90e8\u505a\u4e86\u81ea\u52a8\u5207\u6362\u3002\u8868\u5355\u4e0a\u4f20\u4f7f\u7528\u4e00\u4e2a HTTP POST \u8bf7\u6c42\u5b8c\u6210\u6587\u4ef6\u7684\u4e0a\u4f20\uff0c\u56e0\u6b64\u6bd4\u8f83\u9002\u5408\u8f83\u5c0f\u7684\u6587\u4ef6\u548c\u8f83\u597d\u7684\u7f51\u7edc\u73af\u5883\u3002\u76f8\u6bd4\u800c\u8a00\uff0c\u5206\u7247\u4e0a\u4f20\u66f4\u80fd\u9002\u5e94\u4e0d\u7a33\u5b9a\u7684\u7f51\u7edc\u73af\u5883\uff0c\u4e5f\u6bd4\u8f83\u9002\u5408\u4e0a\u4f20\u6bd4\u8f83\u5927\u7684\u6587\u4ef6\uff08\u4f8b\u5982\u6570\u767e MB \u6216\u66f4\u5927\uff09\u3002\n\n\u82e5\u9700\u6df1\u5165\u4e86\u89e3\u4e0a\u4f20\u65b9\u5f0f\u4e4b\u95f4\u7684\u533a\u522b\uff0c\u8bf7\u53c2\u9605\u4e0a\u4f20\u7c7b\u578b\u4e2d \u8868\u5355\u4e0a\u4f20 \u3001\u5206\u7247\u4e0a\u4f20 v1 \u7248\u548c \u5206\u7247\u4e0a\u4f20 v2 \u7248\u63a5\u53e3\u8bf4\u660e\u3002\n\nUploadManager.put \u53c2\u6570\u8bf4\u660e\uff1a\n\n| \u53c2\u6570 | \u7c7b\u578b | \u8bf4\u660e |\n| ----------------- | ------------------- | ------------------------------------------------------------ |\n| data | byte[]\/String\/File | \u6570\u636e\uff0c\u53ef\u4ee5\u662f byte \u6570\u7ec4\u3001\u6587\u4ef6\u8def\u5f84\u3001\u6587\u4ef6\u3001\u6570\u636e\u6d41\u548c Uri \u8d44\u6e90 |\n| key | String | \u4fdd\u5b58\u5728\u670d\u52a1\u5668\u4e0a\u7684\u8d44\u6e90\u552f\u4e00\u6807\u8bc6\uff0c\u8bf7\u53c2\u9605 \u952e\u503c\u5bf9 |\n| token | String | \u670d\u52a1\u5668\u5206\u914d\u7684 token |\n| completionHandler | UpCompletionHandler | \u4e0a\u4f20\u56de\u8c03\u51fd\u6570\uff0c\u5fc5\u586b |\n| options | UploadOptions | \u5982\u679c\u9700\u8981\u8fdb\u5ea6\u901a\u77e5\u3001\u4e2d\u9014\u53d6\u6d88\u3001\u6307\u5b9a mimeType\uff0c\u5219\u9700\u8981\u586b\u5199\u76f8\u5e94\u5b57\u6bb5\uff0c\u8be6\u89c1\u4e0b\u9762\u7684 UploadOptions \u53c2\u6570\u8bf4\u660e |\n\nUploadOptions \u53c2\u6570\u8bf4\u660e\uff1a\n\n| \u53c2\u6570 | \u7c7b\u578b | \u8bf4\u660e |\n| ------------------ | -------------------- | --------------------------------------------------------- |\n| params | Map<String, String> | \u81ea\u5b9a\u4e49\u53d8\u91cf\uff0ckey \u5fc5\u987b\u4ee5 x: \u5f00\u59cb |\n| mimeType | String | \u6307\u5b9a\u6587\u4ef6\u7684 mimeType |\n| progressHandler | UpProgressHandler | \u4e0a\u4f20\u8fdb\u5ea6\u56de\u8c03 |\n| cancellationSignal | UpCancellationSignal | \u53d6\u6d88\u4e0a\u4f20\uff0c\u5f53 isCancelled() \u8fd4\u56de true \u65f6\uff0c\u4e0d\u518d\u6267\u884c\u66f4\u591a\u4e0a\u4f20 |\n\n\n\n## \u7b80\u5355\u4e0a\u4f20\n\n\u53ef\u4ee5\u53c2\u8003 [\u7b80\u5355\u4e0a\u4f20demo](https:\/\/github.com\/JemyCheung\/upload_android)\n\n```\n\/\/\u6307\u5b9a zone \u7684\u5177\u4f53\u533a\u57df \n\/\/FixedZone.zone0 \u534e\u4e1c\u673a\u623f\n\/\/FixedZone.zone1 \u534e\u5317\u673a\u623f\n\/\/FixedZone.zone2 \u534e\u5357\u673a\u623f\n\/\/FixedZone.zoneNa0 \u5317\u7f8e\u673a\u623f\n\n\/\/\u81ea\u52a8\u8bc6\u522b\u4e0a\u4f20\u533a\u57df \n\/\/AutoZone.autoZone\n\n\n\/\/Configuration config = new Configuration.Builder()\n\/\/.zone(Zone.autoZone)\n\/\/.zone(FixedZone.zone0)\n\/\/.resumeUploadVersion(Configuration.RESUME_UPLOAD_VERSION_V2)\n\/\/.build();\n\/\/UploadManager uploadManager = new UploadManager(config);\ndata = <File \u5bf9\u8c61 \u6216 \u6587\u4ef6\u8def\u5f84 \u6216 \u5b57\u8282\u6570\u7ec4 \u6216 \u6570\u636e\u6d41 \u6216 Uri \u8d44\u6e90>\nString key = <\u6307\u5b9a\u4e03\u725b\u670d\u52a1\u4e0a\u7684\u6587\u4ef6\u540d\uff0c\u6216 null>;\nString token = <\u4ece\u670d\u52a1\u7aef SDK \u83b7\u53d6>;\nuploadManager.put(data, key, token,\n new UpCompletionHandler() {\n @Override\n public void complete(String key, ResponseInfo info, JSONObject res) {\n \/\/res \u5305\u542b hash\u3001key \u7b49\u4fe1\u606f\uff0c\u5177\u4f53\u5b57\u6bb5\u53d6\u51b3\u4e8e\u4e0a\u4f20\u7b56\u7565\u7684\u8bbe\u7f6e\n if(info.isOK()) {\n Log.i(\"qiniu\", \"Upload Success\");\n } else {\n Log.i(\"qiniu\", \"Upload Fail\");\n \/\/\u5982\u679c\u5931\u8d25\uff0c\u8fd9\u91cc\u53ef\u4ee5\u628a info \u4fe1\u606f\u4e0a\u62a5\u81ea\u5df1\u7684\u670d\u52a1\u5668\uff0c\u4fbf\u4e8e\u540e\u9762\u5206\u6790\u4e0a\u4f20\u9519\u8bef\u539f\u56e0\n }\n Log.i(\"qiniu\", key + \",\\r\\n \" + info + \",\\r\\n \" + res);\n }\n }, null);\n```\n\n\u56de\u8c03\u53c2\u6570\u8bf4\u660e\uff1a\n\n| \u53c2\u6570 | \u8bf4\u660e |\n| -------- | ------------------------------------------------------------ |\n| key | uploadManager.put(file, key, ...) \u65b9\u6cd5\u6307\u5b9a\u7684 key |\n| info | http \u8bf7\u6c42\u7684\u72b6\u6001\u4fe1\u606f\u7b49\uff0c\u53ef\u8bb0\u5165\u65e5\u5fd7\uff0cisOK() \u8fd4\u56de true \u8868\u793a\u4e0a\u4f20\u6210\u529f |\n| response | \u5b58\u50a8\u670d\u52a1\u53cd\u9988\u7684\u4fe1\u606f\u3002\u53ef\u4ece\u4e2d\u89e3\u6790\u4fdd\u5b58\u5728\u5b58\u50a8\u670d\u52a1\u7684 key \u7b49\u4fe1\u606f\uff0c\u5177\u4f53\u5b57\u6bb5\u53d6\u51b3\u4e0a\u4f20\u7b56\u7565\u7684\u8bbe\u7f6e |\n\n**\u6ce8\u610f\uff1a** \u53ef\u80fd\u4f1a\u629b\u51fa\u6587\u4ef6\u4e0d\u5b58\u5728\uff0c\u6ca1\u6709\u6743\u9650\u8bbf\u95ee\u7b49\u5f02\u5e38\u3002\n\n\n\n## \u4e0a\u4f20\u8fdb\u5ea6\n\n```\nuploadManager.put(data, key, token,handler,\n new UploadOptions(null, null, false,\n new UpProgressHandler(){\n public void progress(String key, double percent){\n Log.i(\"qiniu\", key + \": \" + percent);\n }\n }, null));\n```\n\n**\u6ce8\u610f\uff1a** progress(key, percent) \u4e2d\u7684 key \u5373 uploadManager.put(file, key, ...) \u65b9\u6cd5\u6307\u5b9a\u7684 key\u3002\n\n\n\n## \u53d6\u6d88\u4e0a\u4f20\n\n\u5185\u90e8\u4ee3\u7801\u4f1a\u68c0\u6d4b UpCancellationSignal##isCancelled() \u7684\u8fd4\u56de\u503c\uff0c\u5f53\u5176\u8fd4\u56de true \u65f6\uff0c\u5c06\u505c\u6b62\u4e0a\u4f20\u3002\u53ef\u5916\u90e8\u7ef4\u62a4\u4e00\u4e2a\u53d8\u91cf isCancelled\uff0c\u5f53\u70b9\u51fb\u53d6\u6d88\u6309\u94ae\u65f6\uff0c\u8bbe\u7f6e isCancelled = true; \u3002\u4f8b\u5982\uff1a\n\n```\n\/\/ \u521d\u59cb\u5316\u3001\u6267\u884c\u4e0a\u4f20\nprivate volatile boolean isCancelled = false;\n\nuploadManager.put(data, key, token,handler,\n new UploadOptions(null, null, false, progressHandler,\n new UpCancellationSignal(){\n public boolean isCancelled(){\n return isCancelled;\n }\n }));\n\n\n\/\/ \u70b9\u51fb\u53d6\u6d88\u6309\u94ae\uff0c\u8ba9 UpCancellationSignal##isCancelled() \u65b9\u6cd5\u8fd4\u56de true\uff0c\u4ee5\u505c\u6b62\u4e0a\u4f20\nprivate void cancell() {\n isCancelled = true;\n}\n```\n\n\n\n## \u8bb0\u5f55\u65ad\u70b9\n\n\u5206\u7247\u4e0a\u4f20\u4e2d\uff0c\u53ef\u5c06\u5404\u4e2a\u5df2\u4e0a\u4f20\u7684\u5757\u8bb0\u5f55\u4e0b\u6765\uff0c\u518d\u6b21\u4e0a\u4f20\u65f6\uff0c\u5df2\u4e0a\u4f20\u7684\u90e8\u5206\u4e0d\u7528\u518d\u6b21\u4e0a\u4f20\u3002\u65ad\u70b9\u8bb0\u5f55\u7c7b\u9700\u5b9e\u73b0 com.qiniu.android.storage.Recorder \u63a5\u53e3\u3002\u5df2\u63d0\u4f9b\u4fdd\u5b58\u5230\u6587\u4ef6\u7684 FileRecorder \u5b9e\u73b0\u3002\n\n```\nString dirPath = <\u65ad\u70b9\u8bb0\u5f55\u6587\u4ef6\u4fdd\u5b58\u7684\u6587\u4ef6\u5939\u4f4d\u7f6e>\nRecorder recorder = null;\ntry {\n recorder = new FileRecorder(dirPath);\n}catch (Exception e){\n\n}\n\n\/\/\u9ed8\u8ba4\u4f7f\u7528 key \u7684 url_safe_base64 \u7f16\u7801\u5b57\u7b26\u4e32\u4f5c\u4e3a\u65ad\u70b9\u8bb0\u5f55\u6587\u4ef6\u7684\u6587\u4ef6\u540d\n\/\/\u907f\u514d\u8bb0\u5f55\u6587\u4ef6\u51b2\u7a81\uff08\u7279\u522b\u662f key \u6307\u5b9a\u4e3a null \u65f6\uff09\uff0c\u4e5f\u53ef\u81ea\u5b9a\u4e49\u6587\u4ef6\u540d(\u4e0b\u65b9\u4e3a\u9ed8\u8ba4\u5b9e\u73b0)\uff1a\nKeyGenerator keyGen = new KeyGenerator(){\n public String gen(String key, File file){\n \/\/ \u4e0d\u5fc5\u4f7f\u7528url_safe_base64\u8f6c\u6362\uff0cuploadManager\u5185\u90e8\u4f1a\u5904\u7406\n \/\/ \u8be5\u8fd4\u56de\u503c\u53ef\u66ff\u6362\u4e3a\u57fa\u4e8ekey\u3001\u6587\u4ef6\u5185\u5bb9\u3001\u4e0a\u4e0b\u6587\u7684\u5176\u5b83\u4fe1\u606f\u751f\u6210\u7684\u6587\u4ef6\u540d\n return key + \"_._\" + new StringBuffer(file.getAbsolutePath()).reverse();\n }\n};\n\n\/\/ \u91cd\u7528 uploadManager\u3002\u4e00\u822c\u5730\uff0c\u53ea\u9700\u8981\u521b\u5efa\u4e00\u4e2a uploadManager \u5bf9\u8c61\n\/\/UploadManager uploadManager = new UploadManager(recorder); \/\/ 1\n\/\/UploadManager uploadManager = new UploadManager(recorder, keyGen); \/\/ 2\n\/\/ \u6216\u5728\u521d\u59cb\u5316\u65f6\u6307\u5b9a\uff1a\nConfiguration config = new Configuration.Builder()\n .resumeUploadVersion(Configuration.RESUME_UPLOAD_VERSION_V2)\n \/\/ recorder\u5206\u7247\u4e0a\u4f20\u65f6\uff0c\u5df2\u4e0a\u4f20\u7247\u8bb0\u5f55\u5668\n \/\/ keyGen\u5206\u7247\u4e0a\u4f20\u65f6\uff0c\u751f\u6210\u6807\u8bc6\u7b26\uff0c\u7528\u4e8e\u7247\u8bb0\u5f55\u5668\u533a\u5206\u662f\u54ea\u4e2a\u6587\u4ef6\u7684\u4e0a\u4f20\u8bb0\u5f55\n .recorder(recorder, keyGen) \n .build();\nUploadManager uploadManager = new UploadManager(config);\n\nuploadManager.put(data, key, ...)\n```\n\n\n\n## \u5206\u7247\u4e0a\u4f20\n\n\u53ef\u4ee5\u9009\u62e9\u5206\u7247\u4e0a\u4f20\u7248\u672c\uff0c\u63a8\u8350 Configuration.RESUME_UPLOAD_VERSION_V2\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v2 \u7248\uff0c\u9ed8\u8ba4 Configuration.RESUME_UPLOAD_VERSION_V1\uff0c\u8868\u793a \u5206\u7247\u4e0a\u4f20 v1 \u7248\uff0c\u517c\u5bb9\u5386\u53f2\u60c5\u51b5\u3002\n\n```\nConfiguration config = new Configuration.Builder()\n .resumeUploadVersion(Configuration.RESUME_UPLOAD_VERSION_V2) \/\/ \u9009\u62e9\u5206\u7247\u4e0a\u4f20\u7248\u672c\n .useConcurrentResumeUpload(true) \/\/ \u5f00\u542f\u5e76\u53d1\u4e0a\u4f20\uff0c\u9ed8\u8ba4\u4e3a NO\n .concurrentTaskCount(3) \/\/ \u9ed8\u8ba4\u5e76\u884c\u7ebf\u7a0b\u6570\u4e3a 3\n .build();\nUploadManager uploadManager = new UploadManager(config);\n\nuploadManager.put(data, key, ...)\n```\n\n\n\n# \u4e0b\u8f7d\u6587\u4ef6\n\n\u8be5 SDK \u5e76\u672a\u63d0\u4f9b\u4e0b\u8f7d\u6587\u4ef6\u76f8\u5173\u7684\u529f\u80fd\u63a5\u53e3\uff0c\u56e0\u4e3a\u6587\u4ef6\u4e0b\u8f7d\u662f\u4e00\u4e2a\u6807\u51c6\u7684 HTTP GET \u8fc7\u7a0b\u3002\u5f00\u53d1\u8005\u53ea\u9700\u7406\u89e3\u8d44\u6e90 URI \u7684\u7ec4\u6210\u683c\u5f0f\u5373\u53ef\u975e\u5e38\u65b9\u4fbf\u7684\u6784\u5efa\u8d44\u6e90 URI\uff0c\u5e76\u5728\u5fc5\u8981\u7684\u65f6\u5019\u52a0\u4e0a \u4e0b\u8f7d\u51ed\u8bc1 \uff0c\u5373\u53ef\u4f7f\u7528 HTTP GET \u8bf7\u6c42\u83b7\u53d6\u76f8\u5e94\u8d44\u6e90\u3002\n\n\u4ece\u5b89\u5168\u6027\u548c\u4ee3\u7801\u53ef\u7ef4\u62a4\u6027\u7684\u89d2\u5ea6\u8003\u8651\uff0c\u6211\u4eec\u5efa\u8bae\u4e0b\u8f7d URL \u7684\u62fc\u63a5\u8fc7\u7a0b\u4e5f\u5728\u4e1a\u52a1\u670d\u52a1\u5668\u8fdb\u884c\uff0c\u8ba9\u5ba2\u6237\u7aef\u4ece\u4e1a\u52a1\u670d\u52a1\u5668\u8bf7\u6c42\u3002\n\n\n\n# \u7ebf\u7a0b\u5b89\u5168\u6027\n\nAndroid \u4e00\u822c\u60c5\u51b5\u4e0b\u4f1a\u4f7f\u7528\u4e00\u4e2a\u4e3b\u7ebf\u7a0b\u6765\u63a7\u5236 UI\uff0c\u975e\u4e3b\u7ebf\u7a0b\u65e0\u6cd5\u63a7\u5236 UI\uff0c\u5728 Android4.0+ \u4e4b\u540e\u4e0d\u80fd\u5728\u4e3b\u7ebf\u7a0b\u5b8c\u6210\u7f51\u7edc\u8bf7\u6c42\uff0c\u8be5 SDK \u662f\u6839\u636e\u4ee5\u4e0a\u7684\u4f7f\u7528\u573a\u666f\u8bbe\u8ba1\uff0c\u6240\u6709\u7684\u7f51\u7edc\u64cd\u4f5c\u5747\u4f7f\u7528\u72ec\u7acb\u7684\u7ebf\u7a0b\u5f02\u6b65\u8fd0\u884c\uff0cUpCompletionHandler##complete\u3001UpProgressHandler##progress \u662f\u5728\u4e3b\u7ebf\u7a0b\u8c03\u7528\u7684\uff0c\u5728\u56de\u8c03\u51fd\u6570\u5185\u53ef\u4ee5\u76f4\u63a5\u64cd\u4f5c UI \u63a7\u4ef6\u3002\n\n# \u5e38\u89c1\u95ee\u9898\n\n**1. \u6df7\u6dc6\u5904\u7406**\n\n\u5bf9 \u79c1\u6709\u4e91\u5b58\u50a8 \u7684 SDK \u4e0d\u9700\u8981\u505a\u7279\u6b8a\u6df7\u6dc6\u5904\u7406\uff0c\u5982\u679c\u6709\u6df7\u6dc6\uff0c\u8bf7\u5c06 \u79c1\u6709\u4e91\u5b58\u50a8 \u76f8\u5173\u7684\u5305\u90fd\u6392\u9664\u3002\n\n- \u5728 Android Studio \u4e2d\uff0c\u6df7\u6dc6\u914d\u7f6e\u5728 proguard-rules.pro \u91cc\u9762\u52a0\u4e0a\u4e0b\u9762\u51e0\u884c\u6df7\u6dc6\u4ee3\u7801\u5c31\u884c\uff1a\n\n```\n-keep class com.qiniu.**{*;}\n-keep class com.qiniu.**{public <init>();}\n-ignorewarnings\n```\n\n**\u6ce8\u610f\uff1a**-ignorewarnings \u8fd9\u4e2a\u4e5f\u662f\u5fc5\u987b\u52a0\u7684\uff0c\u5982\u679c\u4e0d\u52a0\u8fd9\u4e2a\uff0c\u7f16\u8bd1\u7684\u65f6\u5019\u53ef\u80fd\u53ef\u4ee5\u901a\u8fc7\uff0c\u4f46\u662f release \u7684\u65f6\u5019\u8fd8\u662f\u4f1a\u51fa\u73b0\u9519\u8bef\u3002\n\n- \u5728 eclipse \u4e2d\uff0c\u6df7\u6dc6\u914d\u7f6e\u5728 proguard-project.txt \u91cc\u9762\u52a0\u4e0a\u4e0b\u9762\u51e0\u884c\u6df7\u6dc6\u4ee3\u7801\u5c31\u884c\uff1a\n\n```\n-keep class com.qiniu.**{*;}\n-keep class com.qiniu.**{public <init>();}\n-ignorewarnings\n```\n\n**2. \u4e3a\u4ec0\u4e48\u8fdb\u5ea6\u4f1a\u5728 95% \u505c\u5f88\u4e45\uff1f**\n\n\u56e0\u4e3a\u4e0a\u4f20\u8fdb\u5ea6\u662f\u7528 sdk \u5199\u5165 socket \u7684\u5b57\u8282\u6570\uff0f\u603b\u5b57\u8282\u6570\u4f5c\u4e3a\u8fdb\u5ea6\uff0c\u4f46\u5199\u5165 socket \u4e0d\u7b49\u4e8e\u670d\u52a1\u5668\u6536\u5230\u5e76\u4e14\u5904\u7406\u5b8c\u6210\uff0c\u4e2d\u95f4\u8fd8\u6709\u4e00\u6bb5\u65f6\u95f4\uff0c\u5982\u679c\u53ea\u662f\u7528\u5b57\u8282\u6570\u5c31\u4f1a\u51fa\u73b0\u66f4\u602a\u5f02\u7684\u60c5\u51b5\uff0c\u5728 100% \u505c\u7559\u5f88\u4e45\uff0c\u6240\u4ee5\u7efc\u5408\u8003\u8651\u5c31\u4f7f\u7528\u4e86 95% \u8fd9\u4e2a\u503c\u3002\n\n\u5982\u679c\u60a8\u53d1\u73b0\u4e0a\u4f20\u5361\u5728 95% \u5f88\u957f\u7684\u65f6\u95f4\uff0c\u8bf7\u68c0\u67e5\u662f\u5426\u4f7f\u7528\u4e86\u4e0a\u4f20\u56de\u8c03\u4e1a\u52a1\u670d\u52a1\u5668\u7684\u529f\u80fd\uff0c\u8bf7\u786e\u4fdd\u4e1a\u52a1\u670d\u52a1\u5668\u63a5\u53d7\u5230\u4e0a\u4f20\u56de\u8c03\u540e\u53ef\u4ee5\u8fd4\u56de\u6b63\u786e\u7684\u72b6\u6001\u7801\u548c\u56de\u590d\u5185\u5bb9\u3002\n\n**3. \u5982\u4f55\u624d\u80fd\u5f97\u5230\u4e0b\u8f7d\u7684 url \uff1f**\n\n\u4e0a\u4f20\u6ca1\u6709\u57df\u540d\u6982\u5ff5\uff0c\u53ea\u6709 bucket \uff0c\u4e00\u4e2a bucket \u53ef\u4ee5\u7ed1\u5b9a\u591a\u4e2a\u57df\u540d\u3002\u4e0b\u8f7d\u7684 url \u53ef\u4ee5\u7528 bucket \u91cc\u7684\u57df\u540d\u52a0 key \u62fc\u63a5\u800c\u6210\uff0c\u79c1\u6709 url \u8fd8\u8981\u52a0\u4e0a token\u3002\n\n**4. \u5982\u4f55\u8df3\u8fc7 https \u8bc1\u4e66\u9a8c\u8bc1\uff1f**\n\n\u5728\u90e8\u5206\u6d4b\u8bd5\u73af\u5883\u53d1\u751f Trust anchor for certification path not found \u5f02\u5e38\uff0c\u53ef\u4ee5\u8bbe\u7f6e\u8df3\u8fc7 https \u8bc1\u4e66\u9a8c\u8bc1\uff1a\u5728 Configuration \u914d\u7f6e useHttps( false ) \u5f00\u542f\u3002\n\n\n\n# \u8d21\u732e\u4ee3\u7801\n\n1. Fork\n2. \u521b\u5efa\u60a8\u7684\u7279\u6027\u5206\u652f git checkout -b my-new-feature\n3. \u63d0\u4ea4\u60a8\u7684\u6539\u52a8 git commit -am 'Added some feature'\n4. \u5c06\u60a8\u7684\u4fee\u6539\u8bb0\u5f55\u63d0\u4ea4\u5230\u8fdc\u7a0b git \u4ed3\u5e93 git push origin my-new-feature\n5. \u7136\u540e\u5230 github \u7f51\u7ad9\u7684\u8be5 git \u8fdc\u7a0b\u4ed3\u5e93\u7684 my-new-feature \u5206\u652f\u4e0b\u53d1\u8d77 Pull Request"}