# miniprogram-network

**Repository Path**: hihopeorg/miniprogram-network

## Basic Information

- **Project Name**: miniprogram-network
- **Description**: 网络库，支持请求，下载，上传等功能
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-14
- **Last Updated**: 2022-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# miniprogram-network

## 简介
> 小程序网络库，支持上传，下载，请求网络等。

![](art/demo.png)

## 下载安装
```shell
npm install @ohos/miniprogramnetwork --save
```
OpenHarmony npm环境配置等更多内容，请参考 [如何安装OpenHarmony npm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md) 。

## 使用说明

### DownLoad：
```
//下载
DOWNLOAD.download('URL');
//取消
DOWNLOAD.pause();
```
### UpLoad：
```
//上传
UPLOAD.upload('https://upload.site/file', 'file');
//取消
UPLOAD.remove();
```
### Request：
```
//请求
REQUEST.httpRequest('URL');
//取消
REQUEST.destroy();
```

## 兼容性
支持 OpenHarmony API version 8 及以上版本。

## 目录结构
````
|---- miniprogram-network 
|     |---- entry  # 示例代码文件夹
|     |---- miniprogramnetwork  # miniprogramnetwork库文件夹
|           |---- index.ets  # 对外接口
|           |---- src
|                  |---- main
|                        |---- ets
|                              |---- components
|                                    |---- cache          #请求缓存
|                                    |---- cache-token    #取消缓存
|                                    |---- downloader     #网络下载
|                                    |---- fetch          #请求队列管理
|                                    |---- life-cycle     #网络请求生命周期
|                                    |---- network        #底层网络库封装
|                                    |---- network-utils  #网络库底层公用函数封装
|                                    |---- promise        #异步API Promise封装
|                                    |---- queue          #底层操作队列化
|                                    |---- request        #请求库封装
|                                    |---- socket         #
|                                    |---- uploader       #网络上传
|     |---- README.md  # 安装使用方法                    
````

## 贡献代码
使用过程中发现任何问题都可以提 [Issue](https://gitee.com/hihopeorg/miniprogram-network/issues) 给我们，当然，我们也非常欢迎你给我们发 [PR](https://gitee.com/hihopeorg/miniprogram-network/pulls) 。

## 开源协议
本项目基于 [Apache License 2.0](https://gitee.com/hihopeorg/miniprogram-network/blob/master/LICENSE) ，请自由地享受和参与开源。