DevEco Studio エンドクラウド共同開発クラウドストレージ

オープンソースの詳細については、以下をご覧ください。

51CTO オープンソース基本ソフトウェアコミュニティ

https://ost..com

序文

前回の記事では、AppGallery Connect (AGC) を OpenHarmony アプリケーションに統合して、アプリケーションの基本機能である認証サービス、クラウド機能、クラウドデータベースを構築する方法について説明しました。これらの機能を適用することで、アプリケーションの迅速な反復と起動を強化できます。この記事では、OpenHarmony で AGC のクラウドストレージサービスを使用する方法について説明します。

1. 環境

DevEco Studio 3.1 ベータ 1(V3.1.0.200)
触覚インテリジェンス IDO-EVB3568-V1 開発ボード
カスタム teui コンポーネントライブラリ
エンドクラウドの共同開発とアプリケーション作成（クラウド機能を含む）
クラウドデータベースのエンドツークラウド共同開発

2. クラウドストレージ

クラウドストレージは、AGC プラットフォームの基本的なアプリケーション構築機能のカテゴリに属します。これは、写真、オーディオ、ビデオ、またはその他のユーザー生成コンテンツを保存するために使用できる、スケーラブルでメンテナンスフリーのクラウドストレージサービスです。従来のモノリシックアーキテクチャやマイクロサービスアーキテクチャと比較して、サーバーレスアーキテクチャでは、開発者はビジネス機能の実現に集中できます。例えば、クラウドストレージサービスを利用する場合、ストレージサーバーの開発、導入、運用・保守、容量拡張などを気にする必要がありません。クラウドストレージは、クライアント SDK とサーバー SDK を提供します。開発者はクラウドストレージ SDK を使用して、既存または既存のアプリケーションに安全で信頼性の高いファイルのアップロードおよびダウンロード機能を実装できます。

3. AGCプラットフォームでクラウドストレージを有効にする

クラウドストレージサービスを初めて使用する場合、サービスを手動でアクティブ化する必要があるという点で、クラウド機能やクラウドデータベースとは異なります。 DevEco Studio エンドクラウドコラボレーションでは、アプリケーションが最初に作成されたときにクラウドストレージがアクティブ化されません。クラウドストレージ開発に必要な依存パッケージのみが導入されており、エンドサイドアプリケーションアプリケーションのentryディレクトリにあるpackage.jsonファイルで確認できます。

（１）サービスを有効にする

AppGC コンソールを開きます。 [マイプロジェクト] リストで、記事「エンドクラウド共同開発アプリケーションの作成 (Cloud Functions を含む)」で作成されたエンドクラウド統合開発エクスペリエンスプロジェクトの下にある AppCloud エンドクラウド共同アプリケーションを開きます。左側のメニューバーで、[Serverless] > [Cloud Storage] を選択します。「クラウドストレージ」ページで、「今すぐアクティブ化」をクリックして、クラウドストレージサービスを有効にします。

クラウドストレージアクティベーションインターフェイスにストレージインスタンス名を入力し、デフォルトのデータ処理場所を設定します (この項目はエンドクラウド共同開発の作成時に設定されており、ここでは無視できます)。ストレージインスタンス名は、次の規則を満たす必要があります。

名前は数字または文字で始まり、小文字の英語、数字、および「-」のみで構成され、「-」で終わることはできません。長さは 3 文字以上、57 文字以下である必要があります。
名前にIPアドレスは使用できません
名前はグローバルに一意である必要があり、作成後に変更することはできません。

ストレージインスタンス名を入力した後、「次へ」ボタンをクリックして、デフォルトのセキュリティポリシー表示インターフェイスに入ります。デフォルトのセキュリティポリシーは、アクティブ化されると変更できません。デフォルトのセキュリティポリシーでは、認証されたユーザーがすべての読み取りおよび書き込み操作を実行できるようになります。カスタマイズされたセキュリティポリシーが必要な場合は、ユーザーデータを保護するためにサービスを有効にした後、[セキュリティ] タブでセキュリティポリシーを構成する必要があります。

「完了」ボタンをクリックすると、クラウドストレージサービスが正常にアクティブ化されます。サービスがアクティブ化されると、AGC はデフォルトのストレージインスタンスを作成します。デフォルトのストレージインスタンス名は、クラウドストレージサービスをアクティブ化するときに開発者が入力したインスタンス名 + 「- 5 つのランダムな数字と文字」です。

クラウドストレージインターフェイスの [フォルダーの追加] ボタンを使用してフォルダーを作成し、[ファイルのアップロード] ボタンを使用してファイルをアップロードできます。

（２）安全保障戦略

クラウドストレージが提供するセキュリティポリシーは簡潔で明確な形式であり、認証を通じて特定のパスでのデータへのユーザーアクセスを制御できます。

セキュリティポリシールールを構築するときには、次の 2 つのデータタイプが必要です。

null 値が存在しない場合は、null 識別子が使用されます。

 // ログインしていないため、閲覧する権限がないことを示します
読み取りを許可: request.auth != null の場合;

bool ブール型。true と false の 2 つの値が含まれます。

 // どのような場合でもアクセスできることを示します
読み取りを許可する: true の場合;

Cloud Storage は、次のようなセキュリティルールを記述するためのテンプレート化された方法を開発者に提供します。

Match は、ストレージインスタンスの下のファイルパスを識別するために使用されます。ワイルドカードを使用して、特定のパスの下にある任意のファイルを指定することもできます。
allow は、指定された条件が満たされた場合に、ユーザーにファイルパスへの読み取りおよび書き込み権限を許可するために使用されます。
読み取り権限は、取得権限と一覧権限に分けられます。設定時に、ビジネスニーズに応じて単一ファイルの読み取り権限を設定し、大量のクエリを拒否することができます。
書き込み権限は、作成権限、更新権限、削除権限に分けられます。設定時には、ビジネスニーズに基づいて新しい権限を追加することしかできず、更新または削除することはできません。

 // インスタンス内のすべてのファイルに読み取りと書き込みが許可されていることを示します
エイジーシー。雲。ストレージ[
一致: / {バケット} / {パス=** } {
読み取り、書き込みを許可します: trueの場合;
 }
 ]
 // インスタンス内のすべてのファイルの読み取りまたは書き込みが許可されていないことを示します
エイジーシー。雲。ストレージ[
一致: / {バケット} / {パス=** } {
読み取り、書き込みを許可します: falseの場合;
 }
 ]

 // ファイル分割ルールの設定
エイジーシー。雲。ストレージ[
 // スプラッシュパス内のsplash.jpgファイルを一致させる
一致: / { bucket } / splash / spalsh 。 jpg {
取得を許可: trueの場合;
許可リスト: falseの場合; // リストクエリはサポートされていません
書き込みを許可:要求された場合。認証!= null
 }

 // スプラッシュパス内の任意のファイルに一致
一致: / {バケット} /スプラッシュ/ {パス=** } {
読み取り、書き込みを許可します: trueの場合;
 }
 ]

クラウドストレージインターフェイスで、[セキュリティ] タブを開き、クラウドストレージのセキュリティポリシーを構成します。著者はクラウドストレージに 2 つのフォルダーを作成しました。 Splash は、アプリケーションの起動インターフェイスの表示イメージを保存するために使用されます。フォルダーの権限は、すべてのユーザーに単一ファイルの表示権限が与えられ、書き込み操作にはログインした承認済みユーザーのみ操作できるように構成されています。ユーザースペースはユーザーデータを保存するために使用されるため、アクセスするにはログイン認証が必要です。

この時点で、AppGallery Connect プラットフォーム上のクラウドストレージサービスの構成は完了です。クロスドメイン設定や静的 CDN アクセラレーション構成などの詳細な操作について詳しく知りたい場合は、公式ドキュメント - Cloud Storage ドキュメント - を詳しくお読みください。

4. クライアントサイド開発

DevEco Studio（以下、DS）を使用して、以前のAppCloudエンドクラウド連携アプリケーションを開き、エンド側アプリケーションアプリケーションを開きます。クライアント側では、DS はプロジェクトの作成時にクラウドストレージ SDK を導入しました。ただし、クラウドストレージは後で有効になるため、entry/resources/rawfile ファイルの下の agconnect-services.json ファイルを更新する必要があります。このファイルは、AppGallery Connect コンソールのプロジェクト設定タブでダウンロードして置き換えることができます。 OpenHarmony アプリケーションでクラウドストレージを使用するプロセスは次のとおりです。

（１）初期化保存例

デフォルトの例を使用しており、デフォルトのインスタンス StorageManagement オブジェクトを初期化するには agconnect.cloudstorage を呼び出す必要があります。

 // エントリ/src/main/ets/service/cloudstorage/CloudStorgaeService.ts
 '@hw-agconnect/api-ohos'からagconnectをインポートします。
 "@hw-agconnect/cloudstorage-ohos"をインポートします。

 '../AgcConfig'から{ getAGConnect }をインポートします。

エクスポートクラスCloudStorageService {

 // コンテキスト コンテキスト;パスファイルパス、クラウドデータベースのフィールド値です
パブリック静的init （コンテキスト：任意、パス：文字列）： Promise <文字列> {
新しいPromiseを返します((解決、拒否) => {
 getAGConnect (コンテキスト);
 const storageManagement = agconnect 。クラウドストレージ();
 ...
 })
 }
 }

（２）参照を作成する

初期化が成功したら、StorageManagement.storageReference を呼び出して StorageReference オブジェクトへの参照を作成します。ファイル参照を使用して、ファイルのアップロード、ファイルのダウンロードアドレスの取得、ファイルの削除、ファイルのメタデータの更新などの操作を行うことができます。

 // エントリ/src/main/ets/service/cloudstorage/CloudStorgaeService.ts
 '@hw-agconnect/api-ohos'からagconnectをインポートします。
 "@hw-agconnect/cloudstorage-ohos"をインポートします。

 '../AgcConfig'から{ getAGConnect }をインポートします。

エクスポートクラスCloudStorageService {

 // コンテキスト コンテキスト;パスファイルパス、クラウドデータベースのフィールド値です
パブリック静的init （コンテキスト：任意、パス：文字列）： Promise <文字列> {
新しいPromiseを返します((解決、拒否) => {
 getAGConnect (コンテキスト);
 const storageManagement = agconnect 。クラウドストレージ();
ストレージ管理。ストレージ参照()。それから(( ret ) => {
 ...
 }）。キャッチ((エラー) => {
拒否(エラー)
 })
 })
 }
 }

（３）ファイルのエコー（ダウンロード）アドレスを取得する

AppGallery Connect コンソールの Cloud Storage UI でファイルをアップロードした後、StorageManagement.storageReference を呼び出してダウンロードするファイルへの参照を作成し、StorageReference.getDownloadURL を使用してダウンロード (エコー) アドレスを取得します。

 // エントリ/src/main/ets/service/cloudstorage/CloudStorgaeService.ts
 '@hw-agconnect/api-ohos'からagconnectをインポートします。
 "@hw-agconnect/cloudstorage-ohos"をインポートします。

 '../AgcConfig'から{ getAGConnect }をインポートします。

エクスポートクラスCloudStorageService {

 // コンテキスト コンテキスト;パスファイルパス、クラウドデータベースのフィールド値です
パブリック静的init （コンテキスト：任意、パス：文字列）： Promise <文字列> {
新しいPromiseを返します((解決、拒否) => {
 getAGConnect (コンテキスト);
 const storageManagement = agconnect 。クラウドストレージ();
ストレージ管理。ストレージ参照()。それから(( ret ) => {
 ret 。子(パス)。 getDownloadURL() を取得します。それから(( res ) => {
解決する
 }）。キャッチ((エラー) => {
拒否(エラー);
 })
 }）。キャッチ((エラー) => {
拒否(エラー)
 })
 })
 }
 }

（4）画像の表示

アプリケーションのスプラッシュ起動ページを開きます。 AppCloud 起動ページのデータはクラウドデータベースから取得されます。ステータスが「1」の AppCloud データベースのデータの backgroundImg フィールド値を、クラウドストレージを使用してデータを取得するためのファイル参照である splash/splash.jpg に変更します。次に、スプラッシュページの aboutToAppear() メソッド内のビジネスコードの改善を続けます。

 ...
 '../services/cloudstorage/CloudStorageService'から{ CloudStorageService }をインポートします。

 @エントリ
@成分
構造体スプラッシュ{
 ...
表示されることについて（）{
 // クラウド データベース クエリ データの表示
クラウドDB 。クエリ( getContext ( this ))。その後( ret => {
もし（戻り）{
これ。メッセージ= JSON 。文字列化( ret );
 // クラウドストレージ内の画像のエコーアドレスを照会する
クラウドストレージサービス。 init ( getContext ( this )、 ret . backgroundImg )。その後( res => {
これ。メッセージ= JSON 。文字列化( res );
これ。結果。背景画像= res ;
これ。 isSkip = true ;
 }）。キャッチ((エラー) => {
これ。メッセージ= JSON 。文字列化(エラー)
 })
 }
 })
 }
 }