Simple Storage Service(S3)
這個功能簡單地可以理解成百度云盤，且提供了給文件打上關于Key,Value這樣便于查找的功能，比如APP的用戶數據（錄音、小視頻等等）就可以通過這個功能進行儲存。
還有比較方便的一點是它可以通過各種方式進行訪問，包括在網頁上直接拖拽、Python、Android等方式都是可以的。本文就記錄一下自己在Android平臺上設置S3并上傳文件的過程。
賬號注冊
需要選擇國際版AWS（支持Amplify自動搭建操作），國內的版本雖然有S3但是搭建方式比較復雜。每個賬戶是可以免費試用一年的，需要有支持美元付款的信用卡。
開始
參考官方教程
https://aws-amplify.github.io/docs/android/start?ref=amplify-android-btn
首先安裝Amplify，它可以理解成自動搭建的腳本（類似于Gradle？），通過簡單的幾個設置就能搭出所需要的功能。（下面的內容上述網址均有）
首先安裝 Node.js?，然后打開cmd安裝Amplify
$ npm install -g @aws-amplify/cli
$ amplify configure
這里的amplify configure主要涉及到賬號登陸，并新建了一個Android工程專用的IAM賬號，默認是具有Administrator權限的，后續如果APP需要發布的話，需要手動在IAM控制臺中將其權限調整為所需的范圍。
然后我們開始安卓工程相關的設置。
Android工程設置
跟著官方文檔https://aws-amplify.github.io/docs/android/start?ref=amplify-android-btn一直做到Step 3
后面的Step 4的API是一個Demo功能，只用S3的話是不需要的。
關于
project/build.gradle app/build.gradle等等gradle文件是怎么樣的我最后會貼一個（后面還要加上S3的，這里暫時先不貼）。amplify init的過程如圖：
這個過程會在IAM賬號（可以理解成大號的馬甲，在https://console.aws.amazon.com/iam/home#/roles中查看）中增加兩個和這個Project相關的賬號。
Storage 設定/ Step 1 添加驗證
先閱讀官方文檔 https://aws-amplify.github.io/docs/android/storage
首先要添加驗證，參考https://aws-amplify.github.io/docs/android/authentication
這里簡單起見，我們就直接使用匿名身份上傳了。關于Authentication這一部分的內容在后續的博客會有提到。
amplify add auth
這里再
amplify push一下，設置好本地和云端，就會發現Android工程里面的awsconfiguration.json變掉了，添加了和賬戶驗證相關的一些信息，另外IAM頁面里面又多了兩個賬號。
Storage 設定/ Step 2 添加Storage功能
amplify add storage
注意Guest用戶也要選
read/writeamplify push就會發現awsconfiguration.json里面多了和S3儲存桶相關的一些信息，同時會自動新建一個S3儲存桶。（可在https://s3.console.aws.amazon.com/s3/home查看）
Storage 設定/ Step 3 Android程序編寫
新建測試界面
app:build.gradle
apply plugin: 'com.android.application'
android {
compileSdkVersion 28
defaultConfig {
applicationId "com.example.administrator.anothers3uploadtest"
minSdkVersion 15
targetSdkVersion 28
versionCode 1
versionName "1.0"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
//Base SDK
implementation 'com.amazonaws:aws-android-sdk-core:2.12.+'
//For AWSMobileClient only:
implementation 'com.amazonaws:aws-android-sdk-mobile-client:2.12.+'
//Storage
implementation 'com.amazonaws:aws-android-sdk-s3:2.12.+'
implementation ('com.amazonaws:aws-android-sdk-mobile-client:2.12.+@aar') { transitive = true }
implementation ('com.amazonaws:aws-android-sdk-auth-userpools:2.12.+@aar') { transitive = true }
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.1.3'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'com.android.support.test:runner:1.0.2'
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}
project:build.gradle
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
repositories {
google()
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.1.1'
//appsync
classpath 'com.amazonaws:aws-android-sdk-appsync-gradle-plugin:2.7.+'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
google()
jcenter()
}
}
task clean(type: Delete) {
delete rootProject.buildDir
}
MainActivity.java
package com.example.administrator.anothers3uploadtest;
import android.content.Context;
import android.content.Intent;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import com.amazonaws.mobile.client.AWSMobileClient;
import com.amazonaws.mobile.client.Callback;
import com.amazonaws.mobile.client.UserStateDetails;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferListener;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferObserver;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferService;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferState;
import com.amazonaws.mobileconnectors.s3.transferutility.TransferUtility;
import com.amazonaws.services.s3.AmazonS3Client;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStreamWriter;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
AWSMobileClient.getInstance().initialize(getApplicationContext(), new Callback<UserStateDetails>() {
@Override
public void onResult(UserStateDetails userStateDetails) {
switch (userStateDetails.getUserState()){
case SIGNED_IN:
runOnUiThread(new Runnable() {
@Override
public void run() {
TextView textView = (TextView) findViewById(R.id.text);
textView.setText("Logged IN");
}
});
break;
case SIGNED_OUT:
runOnUiThread(new Runnable() {
@Override
public void run() {
TextView textView = (TextView) findViewById(R.id.text);
textView.setText("Logged OUT");
}
});
break;
default:
AWSMobileClient.getInstance().signOut();
break;
}
}
@Override
public void onError(Exception e) {
Log.e("INIT", e.toString());
}
});
getApplicationContext().startService(new Intent(getApplicationContext(), TransferService.class));
((Button)findViewById(R.id.save_button)).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
saveToFile(String.valueOf(((TextView)findViewById(R.id.inputText)).getText()));
}
});
((Button)findViewById(R.id.upLoadButton)).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
uploadWithTransferUtility();
}
});
}
public void saveToFile(String inputText){
FileOutputStream out=null;
BufferedWriter writer = null;
try{
out = openFileOutput("data.txt", Context.MODE_PRIVATE);
writer = new BufferedWriter(new OutputStreamWriter(out));
writer.write(inputText);
}catch (IOException e){
e.printStackTrace();
}finally {
{
try{
if(writer!=null)
writer.close();
}catch (IOException e){
e.printStackTrace();
}
}
}
}
public void uploadWithTransferUtility() {
TransferUtility transferUtility =
TransferUtility.builder()
.context(getApplicationContext())
.awsConfiguration(AWSMobileClient.getInstance().getConfiguration())
.s3Client(new AmazonS3Client(AWSMobileClient.getInstance()))
.build();
TransferObserver uploadObserver =
transferUtility.upload(
"data.txt",
new File(getFilesDir()+"/data.txt"));
// Attach a listener to the observer to get state update and progress notifications
uploadObserver.setTransferListener(new TransferListener() {
@Override
public void onStateChanged(int id, TransferState state) {
if (TransferState.COMPLETED == state) {
// Handle a completed upload.
}
}
@Override
public void onProgressChanged(int id, long bytesCurrent, long bytesTotal) {
float percentDonef = ((float) bytesCurrent / (float) bytesTotal) * 100;
int percentDone = (int)percentDonef;
Log.d("YourActivity", "ID:" + id + " bytesCurrent: " + bytesCurrent
+ " bytesTotal: " + bytesTotal + " " + percentDone + "%");
}
@Override
public void onError(int id, final Exception ex) {
// Handle errors
runOnUiThread(new Runnable() {
@Override
public void run() {
TextView textView = (TextView) findViewById(R.id.text);
textView.setText("Error"+ex);
}
});
}
});
// If you prefer to poll for the data, instead of attaching a
// listener, check for the state and progress in the observer.
if (TransferState.COMPLETED == uploadObserver.getState()) {
// Handle a completed upload.
}
Log.d("YourActivity", "Bytes Transferred: " + uploadObserver.getBytesTransferred());
Log.d("YourActivity", "Bytes Total: " + uploadObserver.getBytesTotal());
}
}
這里會報錯權限問題，我找了很久問題在哪…
com.amazonaws.services.s3.model.AmazonS3Exception: Access Denied (Service: Amazon S3; Status Code: 403; Error Code: AccessDenied; Request ID: *********************), S3 Extended Request ID: ********************************************************************************************************************
這里我參考了https://github.com/awslabs/aws-sdk-android-samples/tree/master/S3TransferUtilitySample
發現是可以手動配置的，我就是在手動配置之后偶然發現居然成功了？
最后發現原來是自動配置的Unauthorized Role的權限仍然不足，需要手動加上S3完全的權限。
對比一下權限（上面的是手動添加的，下面的是自動生成的）：
不過并不知道自動生成的為什么有寫入權限還是寫不進去……
后續
發現是自己文檔讀的不到位，漏掉了下面這一個關鍵的地方：
需要注意IAM賬號和上圖中的
users是不一樣的，我們需要手動打開儲存同的Public權限，如下圖：
然后上傳的Key也要設置成對應的
public
Storage 設定/ Step 4 成果預覽
手機上按下保存字符串然后上傳，最后就能在其對應的儲存桶里面看到對應的data.txt了。
TODO
這個Project本意是用來采集一些樣本用來做機器學習訓練集的，因此只需要匿名上傳功能，因此只關注到了未授權的匿名操作，想要拓展的話后續會看一下使用賬號的上傳方式。
