Browse Source

Change README.md

Ben Hsieh 8 years ago
parent
commit
98e9fd24b6
2 changed files with 5 additions and 25 deletions
  1. 1
    13
      README.md
  2. 4
    12
      src/README.md

+ 1
- 13
README.md View File

@@ -40,19 +40,6 @@ Link package using [rnpm](https://github.com/rnpm/rnpm)
40 40
 rnpm link
41 41
 ```
42 42
 
43
-### To Use 0.7.0+ you will need to upgrade your App to 0.27+ (Android)
44
-
45
-In `0.7.0` we have removed Android AsyncHttpClient dependency and use OkHttp3+ dependency in react-native, therefore older project (pre 0.27 versions use OkHttp2) will not be compatible. As for 0.29 projects, since rnpm link is broken in 0.29, it's recommended to upgrade too (otherwise you may need to manually link Android project). 
46
-
47
-To upgrade your project 
48
-
49
-```
50
-$ react-native upgrade
51
-```
52
-
53
-you will need run `rnpm link` again after upgrade.
54
-
55
-
56 43
 ### Manually link the package (Android)
57 44
 
58 45
 If rnpm link command failed to link the package automatically, you might try manually link the package.
@@ -622,6 +609,7 @@ RNFetchBlob.config({
622 609
 
623 610
 | Version | |
624 611
 |---|---|
612
+| 0.7.5 | Fix installation script that make it compatible to react-native < 0.28 |
625 613
 | 0.7.4 | Fix app crash problem in version > 0.27 |
626 614
 | 0.7.3 | Fix OkHttp dependency issue in version < 0.29 |
627 615
 | 0.7.2 | Fix cancel request bug |

+ 4
- 12
src/README.md View File

@@ -1,12 +1,9 @@
1
-# react-native-fetch-blob [![release](https://img.shields.io/github/release/wkh237/react-native-fetch-blob.svg?maxAge=86400&style=flat-square)](https://www.npmjs.com/package/react-native-fetch-blob) [![npm](https://img.shields.io/npm/v/react-native-fetch-blob.svg?style=flat-square)](https://www.npmjs.com/package/react-native-fetch-blob) ![](https://img.shields.io/badge/PR-Welcome-brightgreen.svg?style=flat-square) [![npm](https://img.shields.io/npm/l/express.svg?maxAge=2592000&style=flat-square)]()
1
+# react-native-fetch-blob [![release](https://img.shields.io/github/release/wkh237/react-native-fetch-blob.svg?maxAge=86400&style=flat-square)](https://www.npmjs.com/package/react-native-fetch-blob) [![npm](https://img.shields.io/npm/v/react-native-fetch-blob.svg?style=flat-square)](https://www.npmjs.com/package/react-native-fetch-blob) ![](https://img.shields.io/badge/PR-Welcome-brightgreen.svg?style=flat-square) [![npm](https://img.shields.io/npm/l/react-native-fetch-blob.svg?maxAge=2592000&style=flat-square)]() ![](https://img.shields.io/badge/inpPogress-0.8.0-yellow.svg?style=flat-square)
2 2
 
3 3
 A project committed to make file acess and transfer easier and effiecient for React Native developers.
4 4
 
5
-## [Please check our github for updated document](https://github.com/wkh237/react-native-fetch-blob)
6
-
7 5
 ## TOC
8 6
 * [About](#user-content-about)
9
-* [Backward Compatible](#user-content-backward-compatible)
10 7
 * [Installation](#user-content-installation)
11 8
 * [Recipes](#user-content-recipes)
12 9
  * [Download file](#user-content-download-example--fetch-files-that-needs-authorization-token)
@@ -25,15 +22,9 @@ A project committed to make file acess and transfer easier and effiecient for Re
25 22
 
26 23
 ## About
27 24
 
28
-React Native does not support `Blob` object at this moment, which means if you're going to send/receive binary data via `fetch` API, that might not work as you expect. See [facebook/react-native#854](https://github.com/facebook/react-native/issues/854).
29
-
30
-For some use cases, you might get into trouble. For example, displaying an image that requires a specific field in headers (ex. "Authorization : Bearer ...") or body, so you can't just pass the image uri to `Image` component because that will probably returns a 401 response. Or you're going to upload binary data which generated from JS, the server will get an empry body due to [this issue](https://github.com/facebook/react-native/issues/854). With help of APIs provided by this module, you can send HTTP request with any headers, and decide how to handle the response/reqeust data without worry about if it is not supported by `fetch` API. The response data can be just simply converted into BASE64 string, or stored to a file directly so that you can read it by using file access APIs such as readFile, readStream.
31
-
32
-This module was designed to be a substitution of `Blob`, there's a set of APIs including basic file system CRUD method, and file stream reader/writer. Also it has a special `fetch` implementation that supports binary request/response body.
33
-
34
-## Backward Compatible
25
+This project was initially for solving the issue [facebook/react-native#854](https://github.com/facebook/react-native/issues/854), because React Native does not support `Blob` object and it will cause some problem when sending and receiving binary data. There's aleady [a PR ](https://github.com/facebook/react-native/pull/8324) merged into RN master branch which will probably solving the issue in the near future.
35 26
 
36
-All updates are `backward-compatible` generally you don't have to change existing code unless you're going to use new APIs. But we recommend pre `0.5.0` users consider upgrade the package to latest version, since we have introduced new APIs can either `upload` or `download` files simply using a file path. It's much more memory efficent in some use case. We've also introduced `fs` APIs for access files, and `file stream` API that helps you read/write files (especially for **large ones**), see [Examples](#user-content-recipes) bellow. This module implements native methods, supports both Android (uses same native library as offical RN fetch API [OkHttp](https://github.com/square/okhttp)) and IOS.
27
+Now, this project is committed to make file acess and transfer more easier and more effiecient for React Native developers. We've implemented lot of file access function which plays well with our network module. For example, it can upload and download data directly into/from file system, which is much more performant (especially for large ones) than converting data to BASE64 passing them around through React JS Bridge, also, file stream support so that you can read large file not causing OOM error.
37 28
 
38 29
 ## Installation
39 30
 
@@ -618,6 +609,7 @@ RNFetchBlob.config({
618 609
 
619 610
 | Version | |
620 611
 |---|---|
612
+| 0.7.5 | Fix installation script that make it compatible to react-native < 0.28 |
621 613
 | 0.7.4 | Fix app crash problem in version > 0.27 |
622 614
 | 0.7.3 | Fix OkHttp dependency issue in version < 0.29 |
623 615
 | 0.7.2 | Fix cancel request bug |