華為AppGallery Connect提供了一個雲端儲存（CloudStorage）的服務，號稱提供了一個便捷的雲端儲存服務，應用開發者使用的時候，可以不用關注伺服器的部署，直接使用就行。

目前這個功能還在bate階段，我先搶先體驗了一下。如果你想快速體驗雲端儲存服務的功能，請參考[demo](https://github.com/AppGalleryConnect/agc-demos/tree/main/Android/agc-cloudstorage-demo-java)。

AGC地址：[https://developer.huawei.com/consumer/cn/service/josp/agc/index.html](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html) 
SDK整合方式：Maven倉整合，對接華為Maven倉：
implementation 'com.huawei.agconnect:agconnect-storage:1.3.1.100'

# 2、在AGC上開通雲端儲存:
PS： 雲端儲存服務目前還處於beta狀態，我是發了郵件申請開通才可以使用的：

[https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-apply](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-apply)

在**我的專案** 下選擇你的開發專案，在**構建**下面，找到**雲端儲存**服務，點選開通：

沒有Android專案的話，可以先自己建立一個。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222143251596.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

開通服務的時候，需要先配置儲存例項，這裡按需配置就可以，我就隨便配置一個。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222143544442.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

下一步，還需要配置安全策略，這裡使用預設的安全策略就好:
PS：預設的情況是，只有經過身份認證的使用者才能進行讀寫。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/2021022216014525.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

# 3、在Android專案裡整合SDK
### a) 整合SDK
1、在專案級的gradle檔案中新增華為Maven，配置如下內容

```java
buildscript {
repositories {
//…
        maven {url 'https://developer.huawei.com/repo/'}
    }
    dependencies {
        //…
        classpath 'com.huawei.agconnect:agcp:1.4.1.300'
    }
}
 
allprojects {
repositories {
//…
        maven {url 'https://developer.huawei.com/repo/'}
    }
}
```

2、開啟應用級的**build.gradle**檔案，配置好雲端儲存的SDK和華為認證服務的SDK，配置下面標紅的內容即可。**注意別落了上面的agcp外掛**。

```java
apply plugin: 'com.android.application'
apply plugin: 'com.huawei.agconnect'
android {…..}
 
dependencies {
    //…
    implementation 'com.huawei.agconnect:agconnect-auth:1.4.1.300'
    implementation 'com.huawei.agconnect:agconnect-storage:1.3.1.100'
}
```

### b) 下載json檔案，並且配置預設儲存例項
1、在AGC介面上，選擇 我的專案 -> 專案設定–> 常規 下面，下載agconnect-services.json檔案到你的Android專案的app路徑下。

2、記得檢視你的json檔案，注意是否有default_storage，如果沒有的話，需要自行新增。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222163858343.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

# 4、前置步驟
1、申請許可權
需要先申請檔案的讀寫許可權和網路訪問許可權，在Mainfest.xml檔案裡面application的外層，配置下面這些程式碼來申請許可權：

注意android:allowBackup的引數必須為false。

```java
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>
    <application android:allowbackup="false"></application>
```

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222163946124.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

2、介面佈局
設定幾個按鈕，透過點選按鈕來實現功能：包括上傳，下載檔案，和刪除檔案的按鈕。

```java
<?xml version="1.0" encoding="utf-8"?>
<linearlayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:orientation="vertical" android:layout_width="match_parent" android:layout_height="match_parent" android:gravity="center_vertical" tools:context=".MainActivity">
 
    <button android:onclick="uploadFile" android:layout_width="match_parent" android:layout_height="wrap_content" android:textallcaps="false" android:text="Upload File"></button>
 
    <button android:onclick="downloadFile" android:layout_width="match_parent" android:layout_height="wrap_content" android:textallcaps="false" android:text="Download File"></button>
 
    <button android:onclick="deleteFile" android:layout_width="match_parent" android:layout_height="wrap_content" android:textallcaps="false" android:text="Delete File"></button>
 
    <textview android:id="@+id/showResult" android:enabled="false" android:hint="This will display the result of the operation" android:layout_width="match_parent" android:layout_margintop="10dp" android:gravity="center" android:layout_height="wrap_content"></textview>
   
</linearlayout>
```

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222164024896.png#pic_center)

# 5、功能開發：
1、先初始化引數
在MainActivity，先初始化引數：包括，雲端儲存例項，展示訊息框，以及相關許可權。

```java
private AGCStorageManagement mAGCStorageManagement;
    private TextView mShowResultTv;
    private String[] permissions = {
            Manifest.permission.WRITE_EXTERNAL_STORAGE,
            Manifest.permission.READ_EXTERNAL_STORAGE,
    };
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mShowResultTv = findViewById(R.id.showResult);
        AGConnectInstance.initialize(getApplicationContext());
        login();
        ActivityCompat.requestPermissions(this, permissions, 1);
    }
```

2、相關方法：匿名登入&獲取路徑
匿名認證方法：對於雲端儲存的資料操作，需要經過華為認證服務，這裡為了簡化，就僅使用華為的**匿名認證**：

```java
private void login() {
        if (AGConnectAuth.getInstance().getCurrentUser() != null) {
            System.out.println("already sign a user");
            return;
        }
        AGConnectAuth.getInstance().signInAnonymously().addOnSuccessListener(new OnSuccessListener<signinresult>() {
            @Override
            public void onSuccess(SignInResult signInResult) {
                System.out.println("AGConnect OnSuccess");
            }
        }).addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(Exception e) {
                // onFail
            }
        });
}
```

獲取檔案路徑的方法：對於雲端儲存的資料操作，上傳時候本地檔案的獲取，以及雲端檔案的下載存放，都是在這個路徑下， 即 **/AGCSdk**路徑下

```java
private String getAGCSdkDirPath() {
        String path = Environment.getExternalStorageDirectory().getAbsolutePath() + "/AGCSdk/";
        System.out.println("path=" + path);
        File dir = new File(path);
        if (!dir.exists()) {
            dir.mkdirs();
        }
        return path;
    }
```

3、初始化雲端儲存例項
雲端儲存的每一步操作之前，都需要確保已經進行初始化了雲端儲存例項

```java
private void initAGCStorageManagement() {
    mAGCStorageManagement = AGCStorageManagement.getInstance();
}
```

4、上傳檔案：
需要先獲取到本地檔案 ，以及這個檔案的路徑，然後建立檔案引用，對檔案的進行上傳的uploadTask操作。

```java
public void uploadFile(View view) {
    if (mAGCStorageManagement == null) {
        initAGCStorageManagement();
    }
    final String path = "test.jpg";
    String fileName = "test.jpg";
    String agcSdkDirPath = getAGCSdkDirPath();
    final File file = new File(agcSdkDirPath, fileName);
    if (!file.exists()) {
        mShowResultTv.setText("file is not exist!");
        return;
    }
    StorageReference storageReference = mAGCStorageManagement.getStorageReference(path);
    UploadTask uploadTask = storageReference.putFile(file);
    try {
        uploadTask.addOnSuccessListener(new OnSuccessListener<uploadtask.uploadresult>() {
            @Override
            public void onSuccess(UploadTask.UploadResult uploadResult) {
                mShowResultTv.setText("upload success!");
            }
        }).addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(Exception e) {
                mShowResultTv.setText("upload failure!" + e.getMessage());
            }
        });
    } catch (Exception e) {
        e.printStackTrace();
    }
}
```

5、下載檔案：
需要先在本地裝置中建立該檔案，包括這個檔案的路徑和檔名。然後建立一個雲端檔名稱的引用，對這個檔案的引用的進行下載的downloadTask操作。

```java
public void downloadFile(View view) {
    if (mAGCStorageManagement == null) {
        initAGCStorageManagement();
    }
    String fileName = "download_" + System.currentTimeMillis() + ".jpg";
    final String path = "test.jpg";
    String agcSdkDirPath = getAGCSdkDirPath();
    final File file = new File(agcSdkDirPath, fileName);
    StorageReference storageReference = mAGCStorageManagement.getStorageReference(path);
    DownloadTask downloadTask = storageReference.getFile(file);
    try {
        downloadTask.addOnSuccessListener(new OnSuccessListener<downloadtask.downloadresult>() {
            @Override
            public void onSuccess(DownloadTask.DownloadResult downloadResult) {
                mShowResultTv.setText("download success!");
            }
        }).addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(Exception e) {
                mShowResultTv.setText("download failure!" + e.getMessage());
            }
        });
    } catch (Exception e) {
        e.printStackTrace();
    }
}
```

6、刪除檔案：
首先，先指定一個檔名為test.jpg的檔案，對這個檔名建立一個引用，然後對該引用執行deleteTask操作，就可以將雲端的test.jpg刪除了。

```java
public void deleteFile(View view) {
        if (mAGCStorageManagement == null) {
            initAGCStorageManagement();
        }
 
        final String path = "test.jpg";
        System.out.println(String.format("path=%s", path));
        StorageReference storageReference = mAGCStorageManagement.getStorageReference(path);
        Task<void> deleteTask = storageReference.delete();
        try {
            deleteTask.addOnSuccessListener(new OnSuccessListener<void>() {
                @Override
                public void onSuccess(Void aVoid) {
                    mShowResultTv.setText("delete success!");
                }
            }).addOnFailureListener(new OnFailureListener() {
                @Override
                public void onFailure(Exception e) {
                    mShowResultTv.setText("delete failure!" + e.getMessage());
                }
            });
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
```

# 6、打包測試：
Android Studio連線手機，然後將該安卓專案執行到手機上。

### 1、準備好初始檔案
開啟手機的檔案管理器，找到 內部儲存/AGCSdk/ 路徑下，新增並且準備一個test.jpg檔案。如下圖所示：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222170806722.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

### 2、上傳檔案 & 上傳結果
開啟剛剛的應用，點選Upload File 按鈕，檢視上傳結果

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222170855229.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222170923638.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

此時AGC介面上，也可以看到剛剛上傳的檔案：

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222170947496.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

### 2、下載檔案 & 下載結果
在應用內點選下載按鈕，可以看到介面顯示 下載成功。

此時回到檔案管理器，可以看到剛剛下載的檔案。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222171042992.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222171058734.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

### 2、刪除檔案 & 刪除結果
點選應用裡面的刪除按鈕，可以看到應用介面上顯示刪除成功。

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/2021022217113355.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

此時到AGC介面上確認下載結果，發現剛剛的test.jpg檔案已經被刪除了

![在這裡插入圖片描述](https://img-blog.csdnimg.cn/20210222171225709.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80NDcwODI0MA==,size_16,color_FFFFFF,t_70#pic_center)

# 7、總結
僅關注前端應用的開發，就可以開發一個帶雲端儲存伺服器的應用。再也不用為了伺服器的搭建和運維擔心，省時省力。而且還提供了類似於管理員模式的web控制檯，可以簡單直觀的對伺服器上的檔案進行管理。

這個雲端儲存服務，除了最普通的上傳下載和刪除功能，還包括有列舉檔案，設定後設資料等功能，具體可以看官方文件：

雲端儲存服務開發指南：

[https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-introduction](https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-cloudstorage-introduction)

雲端儲存codelab：

[https://developer.huawei.com/consumer/cn/codelab/CloudStorage/index.html#1](https://developer.huawei.com/consumer/cn/codelab/CloudStorage/index.html#1)

---
原文連結：[https://developer.huawei.com/consumer/cn/forum/topic/0201411971207960391?fid=0101271690375130218](https://developer.huawei.com/consumer/cn/forum/topic/0201411971207960391?fid=0101271690375130218)

原作者：Mayism</void></void></downloadtask.downloadresult></uploadtask.uploadresult></signinresult>

快速整合華為AGC雲端儲存服務-Android

相關文章