Browse Source

Change README.md

Ben Hsieh 8 years ago
parent
commit
ea4544ba41
1 changed files with 25 additions and 7 deletions
  1. 25
    7
      README.md

+ 25
- 7
README.md View File

@@ -1,6 +1,4 @@
1
-# react-native-fetch-blob [![npm version](https://img.shields.io/badge/npm package-0.6.0-brightgreen.svg?style=flat-square)](https://badge.fury.io/js/react-native-fetch-blob?style=flat-square) ![](https://img.shields.io/badge/PR-Welcome-brightgreen.svg?style=flat-square)
2
-
3
-# v0.6.0 WIP README.md
1
+# react-native-fetch-blob [![npm version](https://img.shields.io/badge/npm package-0.5.3-brightgreen.svg)](https://badge.fury.io/js/react-native-fetch-blob) ![](https://img.shields.io/badge/PR-Welcome-brightgreen.svg) ![](https://img.shields.io/badge/in progress-0.6.0-yellow.svg)
4 2
 
5 3
 A module provides upload, download, and files access API. Supports file stream read/write for process large files.
6 4
 
@@ -28,6 +26,7 @@ This update is `backward-compatible` generally you don't have to change existing
28 26
  * [File access](#user-content-file-access)
29 27
  * [File stream](#user-content-file-stream)
30 28
  * [Manage cached files](#user-content-manage-cached-files)
29
+ * [Self-Signed SSL Server](#user-content-selfsigned-ssl-server)
31 30
 * [API](#user-content-api)
32 31
  * [config](#user-content-configoptionsrnfetchblobconfigfetch)
33 32
  * [fetch](#user-content-fetchmethod-url-headers-bodypromisefetchblobresponse)
@@ -305,7 +304,7 @@ In `version >= 0.4.2` it is possible to know the upload/download progress.
305 304
 
306 305
 #### Android Media Scanner, and Download Manager Support
307 306
 
308
-If you want to make a file in `External Storage` becomes visible in Picture, Downloads, or other built-in apps, you will have to use `Media Scanner` or `Download Manager`. 
307
+If you want to make a file in `External Storage` becomes visible in Picture, Downloads, or other built-in apps, you will have to use `Media Scanner` or `Download Manager`.
309 308
 
310 309
 **Media Scanner**
311 310
 
@@ -336,12 +335,12 @@ When download large files on Android it is recommended to use `Download Manager`
336 335
 RNFetchBlob
337 336
     .config({
338 337
         // Optional, if not specified, the file will download to system default path
339
-        path : DOWNLOAD_DEST, 
338
+        path : DOWNLOAD_DEST,
340 339
         addAdnroidDownloads : {
341 340
             useDownloadManager : true, // <-- this is the only thing required
342 341
             // Optional, override notification setting (default to true)
343 342
             notification : false,
344
-            // Optional, but recommended since android DownloadManager will fail when 
343
+            // Optional, but recommended since android DownloadManager will fail when
345 344
             // the url does not contains a file extension, by default the mime type will be text/plain
346 345
             mime : 'text/plain',
347 346
             description : 'File downloaded by download manager.'
@@ -508,6 +507,20 @@ You can also grouping requests by using `session` API, and use `dispose` to remo
508 507
 
509 508
 ```
510 509
 
510
+#### Self-Signed SSL Server
511
+
512
+By default, react-native-fetch-blob does NOT allow connection to unknown certification provider since it's dangerous. If you're going to connect a server with self-signed certification, add `trusty` to `config`. This function is available for version >= `0.5.3`
513
+
514
+```js
515
+RNFetchBlob.config({
516
+  trusty : true
517
+})
518
+.then('GET', 'https://mysite.com')
519
+.then((resp) => {
520
+  // ...
521
+})
522
+```
523
+
511 524
 ---
512 525
 
513 526
 ## API
@@ -783,10 +796,14 @@ Connect `Media Scanner` and scan the file. see [Android Media Scanner, and Downl
783 796
 
784 797
 A set of configurations that will be injected into a `fetch` method, with the following properties.
785 798
 
799
+#### trusty:boolean
800
+  `0.5.3`
801
+  Set this property to `true` will allow the request create connection with server have self-signed SSL certification. This is not recommended to use in production.
802
+
786 803
 #### fileCache:boolean
787 804
   Set this property to `true` will makes response data of the `fetch` stored in a temp file, by default the temp file will stored in App's own root folder with file name template `RNFetchBlob_tmp${timestamp}`.
788 805
 #### appendExt:string
789
-  Set this propery to change temp file extension that created by `fetch` response data.
806
+  Set this property to change temp file extension that created by `fetch` response data.
790 807
 #### path:string
791 808
   When this property has value, `fetch` API will try to store response data in the path ignoring `fileCache` and `appendExt` property.
792 809
 #### addAndroidDownloads:object (Android only)
@@ -854,6 +871,7 @@ A `session` is an object that helps you manage files. It simply maintains a list
854 871
 
855 872
 | Version | |
856 873
 |---|---|
874
+| 0.5.3 | Add API for access untrusted SSL server |
857 875
 | 0.5.2 | Fix improper url params bug [#26](https://github.com/wkh237/react-native-fetch-blob/issues/26) and change IOS HTTP implementation from NSURLConnection to NSURLSession |
858 876
 | 0.5.0 | Upload/download with direct access to file storage, and also added file access APIs |
859 877
 | 0.4.2 | Supports upload/download progress |