hufans / react-native-alioss

aliyun oss for react native
MIT License
16 stars 8 forks source link
aliyun react-native

rn-alioss

AliYun oss for react native,支持 Android + iOS,感谢aliyun-oss-react-native提供的基础。 首先向各位声明,本库是在 aliyun-oss-react-native 基础上进行重写,但因常年未曾维护,旧版SDK 等问题,最终决定开一个新仓库,提供给新项目使用。

Environment

Table of Contents

Installation

npm install rn-alioss

or

yarn add rn-alioss

iOS

  cd ios
  pod install

Android

do nothing (The Gradle will automatically import rn-alioss )

API

This section describes the APIs that are currently implemented and partially supported by the React Native SDK. These APIs mainly cover log management, bucket management, object management, authorization, file upload, and download. Follow-up to improve the relevant API and BUG repair. API list is as follows

API Android iOS
enableDevMode Y Y
initWithPlainTextAccessKey Y Y
initWithSecurityToken Y Y
initWithServerSTS Y Y
asyncUpload Y Y
initMultipartUpload Y Y
multipartUpload Y Y
listParts Y Y
abortMultipartUpload Y Y
asyncDownload Y Y
asyncCreateBucket Y Y
asyncGetBucketACL Y Y
asyncListBuckets Y Y
asyncDeleteBucket Y Y
asyncHeadObject Y Y
asyncListObjects Y Y
doesObjectExist Y Y
doesObjectExist Y Y
asyncDeleteObject Y Y

Usage

import { AliyunOSS } from "rn-alioss";

Main type

OSSinit

declare type OSSinit = {
    maxRetryCount: number;
    timeoutIntervalForRequest: number;
    timeoutIntervalForResource: number;
};

OssListOptions


declare type OssListOptions = {
    prefix: string;
    marker?: string;
    maxKeys?: string;
    delimiter?: string;
};

AppendType

declare type AppendType = {
    appendPosition: number;
    contentType: string;
    contentMd5: string;
    contentEncoding: string;
    contentDisposition: string;
};

enableDevMode

  AliyunOSS.enableDevMode();

initWithPlainTextAccessKey

init auth client with accessKeyId and accessKeySecret,please refer to the code.you can use ,but we do not suggest use it。


const endPoint = "https://xxx"
const configuration = {
    maxRetryCount: 3,
    timeoutIntervalForRequest: 30,
    timeoutIntervalForResource: 24 * 60 * 60
 };
AliyunOSS. initWithPlainTextAccessKey(accessKey: string, secretKey: string, endPoint: string, configuration?: OSSinit): void;

initWithSecurityToken

init client with SecurityToken

AliyunOSS.initWithSecurityToken(securityToken: string, accessKey: string, secretKey: string, endPoint: string, configuration?: OSSinit): void;

asyncUpload

AliyunOSS.asyncUpload(bucketName: string, objectKey: string, filepath: string, options?: {}): Promise<any>;

asyncAppendObject

AliyunOSS.asyncAppendObject(bucketName: string, objectKey: string, filepath: string, options?: AppendType): Promise<any>;
 AliyunOSS.initMultipartUpload(bucketName: string, objectKey: string): Promise<any>;

multipartUpload

//uploadId is  the value When call initMultipartUpload ,success callback return
AliyunOSS.abortMultipartUpload(bucketName: string, objectKey: string, uploadId: string): Promise<any>;

listParts

AliyunOSS.listParts(bucketName: string, objectKey: string, uploadId: string): Promise<any>;

abortMultipartUpload

 AliyunOSS.abortMultipartUpload(bucketName: string, objectKey: string, uploadId: string): Promise<any>;

asyncDownload

 AliyunOSS. asyncDownload(bucketName: string, objectKey: string, filepath?: string, options?: {
        'x-oss-process': string;
    }): Promise<any>;

asyncCreateBucket

 AliyunOSS. asyncCreateBucket(bucketName: string, acl: string | undefined, region: string):

asyncGetBucketACL

 AliyunOSS.asyncGetBucketACL(bucketName: string): Promise<any>;

asyncListBuckets

AliyunOSS.asyncListBuckets(): Promise<any>;

asyncDeleteBucket

 AliyunOSS.asyncDeleteBucket(bucketName: string): Promise<any>;

asyncHeadObject

 AliyunOSS.asyncHeadObject(bucketName: string, objectKey: string): Promise<any>;

asyncListObjects

list objects in some conditions

parameters:

 AliyunOSS.doesObjectExist(bucketName: string, objectKey: string): Promise<any>;

asyncCopyObject

 AliyunOSS.asyncCopyObject(srcBucketName: string, srcObjectKey: string, desBucketName: string, destObjectKey: string, options: any): Promise<any>;

asyncDeleteObject

 AliyunOSS. asyncDeleteObject(bucketName: string, objectKey: string): Promise<any>;

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License