A React Native SDK for AliyunOSS Services, providing most of the Native OSS APIs, like client initialization, uploading & downloading etc. A truly cross-platform SDK for Aliyun OSS Users. Supports images, videos and any files for uploading.
The latest version 1.1.0 supports iOS11, which allows you to upload the new HEIF Files (High Efficiency Image File Format - HEIC and HEVC). Considering the compatibility of all special formats on iOS, images and videos will be converted to JPEG and MPEG4 respectively before uploading.
- NPM:
npm install aliyun-test —save
- YARN:
yarn add aliyun-test
-
CocoaPods
pod 'aliyun-oss-react-native-sdk', :path => '../node_modules/aliyun-oss-react-native-sdk'
-
Non-CocoaPods
- In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
. Go tonode_modules
➜aliyun-oss-react-native-sdk
and addRNAliyunOss.xcodeproj
- In XCode, in the project navigator, select your project. Add
libRNAliyunOSS.a
to your project'sBuild Phases
➜Link Binary With Libraries
- In XCode, in the project navigator, right click
Frameworks
➜Add Files to [your project's name]
. Go tonode_modules
➜aliyun-oss-react-native-sdk
➜AliyunSDK
. AddAliyunOSSiOS.framework
, and select Copy items if needed in the pop-up box.
- In XCode, in the project navigator, right click
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.reactlibrary.RNAliyunOSSPackage;
to the imports at the top of the file - Add
new RNAliyunOSSPackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':aliyun-oss-react-native-sdk' project(':aliyun-oss-react-native-sdk').projectDir = new File(rootProject.projectDir, '../node_modules/aliyun-oss-react-native-sdk/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':aliyun-oss-react-native-sdk')
import AliyunOSS from 'aliyun-oss-react-native-sdk';
AliyunOSS.enableDevMode();
const configuration = {
maxRetryCount: 3,
timeoutIntervalForRequest: 30,
timeoutIntervalForResource: 24 * 60 * 60
};
-
PlainTextAKSK
AliyunOSS.initWithPlainTextAccessKey(accessKey, secretKey, endPoint, configuration);
-
ImplementedSigner
AliyunOSS.initWithImplementedSigner(signature, accessKey, endPoint, configuration);
-
SecurityToken (recommended)
AliyunOSS.initWithSecurityToken(securityToken, accessKey, secretKey, endPoint, configuration);
AliyunOSS.asyncUpload(bucketName, objectKey, filepath);
- Supported three common types of filepath: (prefix)
assets-library://
file://
data://
- Also, supported localIdentifier if you are using PhotoKit (iOS Only):
localIdentifier://
- Before uploading, all images will be converted to JPEG, and all videos will be encoded by MPEG4 on iOS, while all images and videos will stay the original format on Android.
AliyunOSS.asyncDownload(bucketName, objectKey, filepath);
-
uploadProgress
AliyunOSS.addEventListener('uploadPress', (event) => { console.log(event); });
-
downloadProgress
AliyunOSS.addEventListener('downloadProgress', (event) => { console.log(event); });
Property | Type | Description |
---|---|---|
accessKey | String (required) | The access key of your OSS service |
secretKey | String (required) | The secret key of your OSS service |
endPoint | String (required) | The end point of your OSS service |
configuration | Object (optional) | maxRetryCount = 3 , timeoutIntervalForRequest = 30 , timeoutIntervalForResource = 86400 (all of them are numbers) |
signature | String (optional) | Also known as: Signed URL Authorization |
securityToken | String (optional) | Also known as: STS Authorization |
Property | Type | Description |
---|---|---|
bucketName | String (required) | The bucket name of your OSS service |
objectKey | String (required) | The cloud path for storing your remote file |
filepath | String (required) | The local path for loading or saving your file |
Implement android side✔︎- Bucket management
- Advanced upload modes
- Advanced download modes
MIT