本节介绍创建bucky开发环境下使用阿里云OSS实现简单读写文件。

## 创建并运行示例项目

#### 通过交互式命令行创建简单文件读写的示例项目:

```
mkdir fileserver
bucky init -i
```

选择从`示例`创建解决方案：
```
解决方案类型：
────────────────────
1. 示例
2. 新建解决方案

$请选择解决方案类型[1/2]：1
```

选择`fileserver`这个示例解决方案：
```
示例项目列表：
────────────────────
1. HelloBucky
2. ReactNative
3. fileserver
4. minichat
5. mysql

$选择示例项目序号：3
```

#### 配置本地调试账号

首先，向bucky平台申请一个阿里云OSS的本地测试账号，包含如下信息：
```
accessKeyId: 
accessKeySecret: 
roleArn:
bucket:
region: 
```

其次，通过命令`bucky config -localdebug`配置本地OSS驱动:
```
请选择要配置的本地驱动
────────────────────
1. MYSQL
2. MONGO
3. OSS
$请输入序号：3
```

则，会交互式的请求输入OSS本地驱动的配置参数：
```
$请输入accessKeyId: exampleAccessKeyId

$请输入accessKeySecret: exampleSecret

$请输入roleArn: exampleArn

$请输入bucket: example-bucket

$请输入region: example-region
```

询问是否继续配置其他驱动，选择n：
```
继续配置本地驱动？ [y/n]: n
```

#### 本地测试

使用命令行本地测试
```
bucky build
bucky deploy
bucky k -reset
bucky debug -main test/filemanager/test.js
```

#### 线上运行
```
bucky build
bucky deploy
bucky k -reset
bucky run -main test/filemanager/test.js
```

#### 代码分析

1. `src/test/filemanager/filemanager.js` 里通过使用OSS驱动给需要读写的文件签名并返回签名的URL
    注意，这个XARPackage的config.json里配置了允许使用oss驱动`bx.oss.client`
2. `test/filemanager/test.js`里通过调用filemanager这个XARPackage的签名接口获得签名URL后，
   使用`bucky.OSSUtil.putData`和`bucky.OSSUtil.getData`进行读写文件。

## 新建项目

新建项目要使用OSS驱动的XARPackage注意事项：
1. 在选择运行环境的时候必须选择，只允许在后端运行
2. 在选择是否使用OSS驱动的时候，要选择y

--全文完--