Mobile Platform as a Service:クイックスタート

ベースラインの選択

Cube Card は、プライマリベースライン 10.2.3 でサポートされるようになりました。ご利用の統合メソッドに基づいて、適切なコンポーネント追加メソッドを選択してください。

• mPaaS Xcode Extension の使用

  このメソッドは、mPaaS フレームワークに基づく統合、または既存のプロジェクトに mPaaS プラグインを使用した統合の統合メソッドに適用されます。

  1. Xcode のメニュー項目 [エディター] > [mPaaS]> [プロジェクトの編集]> [ベースラインのアップグレード] をクリックして、プロジェクトを 10.2.3 ベースラインに切り替えます。

     説明

     [Upgrade Baseline] オプションがクリックできない場合は、プロジェクト構成がインポートされていることを確認してください。「前提条件」セクションを参照して、プロジェクト編集ページを開いてください。

  2. ベースラインをアップグレードした後、[Edit] [Module] > [Modify] [Module] をクリックし、[Cube] [Card] を選択して保存し、[Start] [Editing] をクリックして追加を完了します。

• cocoapods-mPaaS プラグインの使用

  このメソッドは、既存のプロジェクトに CocoaPods を使用した統合の統合メソッドに適しています。

  1. Podfile で次の操作を実行します。

     1. mPaaS_baseline を 10.2.3 に変更します。

     2. mPaaS_pod "mPaaS_Cube" を使用して、Cube Card コンポーネントの依存関係を追加します。

  2. pod install を実行するだけで統合が完了します。

カードの初期化

1. Xcode プロジェクトをコンパイルします。ヘッダーファイルが見つからない場合は、Allow Non-modular Includes In Framework Modules を Yes に設定するオプションをオンにします (下図参照)。

   

2. システム依存関係の追加

   

3. Cube Card に必要なライブラリのインポート

   #import <CubeCrystal/CubeEngine.h>
   #import <AntCube/CubeService.h>

4. シングルトンを使用したカードエンジンの初期化

   - (void)initEngie{
       static dispatch_once_t onceToken;
       NSString *mockBundlePath = [NSString stringWithFormat:@"%@/%@/crystal", [[NSBundle mainBundle] resourcePath], @"MPCubeDemo.bundle"];
       dispatch_once(&onceToken, ^{
           CubeEngineConfig* config = [[CubeEngineConfig alloc] init];
           [config setBundlePath:mockBundlePath];
           [[CubeService sharedInstance] initWithConfig:config]; 
       });
   }

カードプロジェクトのビルド

1. プロジェクトの初期化。ターミナルで act init コマンドを実行します。

   • アプリケーションタイプとして Cube を選択し、テンプレートカード (VUE フォーマット) を選択します。

   • アプリケーション名の入力。プロジェクトの名前を入力します。英語、数字、アンダースコアの組み合わせを使用することを推奨します。

   • 「Create an additional project source code folder」を選択してください。これにより、アプリケーション名の追加フォルダが作成されます。「Do not」を選択した場合、プロジェクトは現在のディレクトリで直接初期化されます。

2. プロジェクトのビルド。cd コマンドを実行して作成したカードプロジェクトを開き、act build を実行してビルドを完了します。ビルドされたプロダクトは、プロジェクトの /dist/ フォルダに格納されます。

   

カードのリリース

1. Ant Cube Card プラットフォームへの移動

   

2. [カードの作成] をクリックします。

   

   カード ID には、英語、数字、アンダースコアの組み合わせを使用することを推奨します。カードのレンダリング時、クライアントはカード ID を参照します。カード名には任意の値を設定できます。

3. カードリソースの追加

   • 4 桁のバージョン番号を使用することを推奨します。

   • 先ほどコンパイルした main.zip を選択します。

   • クライアント範囲とは、カードをプルできるクライアントのバージョンを指します。すべてのクライアントバージョンを上書きする場合は、最小バージョンフィールドに 0.0.0.0 と入力します。

   

4. カードのリリース

   1. [リリースを作成] をクリックします。

      

   2. [公式リリース] を選択します。

      

   カードがリリースされると、クライアントはカードをプルできるようになります。

カードのレンダリング

1. Web ページからカード ID とカードバージョン番号をコピーします。

   //カードオブジェクトの作成
   CubeCardConfig *cardConfig = [[CubeCardConfig alloc] init];
   //カードバージョンの設定 (必須)、コンソールからコピー
   [cardConfig setVersion:@"1.0.0.0"];
   //カード ID の設定 (必須)、コンソールからコピー
   [cardConfig setTemplteId:@"20211118"];
   //プリセットカードの幅
   [cardConfig setWidth:[UIScreen mainScreen].bounds.size.width];
   //プリセットカードの高さ
   [cardConfig setHeight:350];
   //カードデータ (必須) パラメーターをビジネス JSON データに設定
   [cardConfig setData:@{}];
   //カードのロード
   [[[CubeService sharedInstance] getEngine] createCard:cardConfig callback:self];
   

2. カードはキー "iosImage" を取得し、キー "iosImage" に対応する値を取得します。コードは次のとおりです。

    [self.cardConfig setData:@{@"iosImage":@"https://img.zcool.cn/community/013edb5c7b5b1ca801213f269fc887.jpg@1280w_1l_2o_100sh.jpg"}];

3. カード作成後のデリゲートメソッドは、CCardCallback デリゲートプロトコルに準拠し、onLoaded:cardType:config:erroCode プロトコルメソッドを実装する必要があります。

   @interface ViewController () <CCardCallback>
   @end

   - (void)onLoaded:(CubeCard *)card cardType:(CCardType)cardType config:(CubeCardConfig *)config erroCode:(CubeCardResultCode)erroCode {
       //カードの作成に失敗
       if (!card) {
           NSLog(@"load card fail %@ style %d error %d", [config templteId], cardType, erroCode);
           return;
       }
       
       //作成に成功
       NSLog(@"load card success %@ style %d error %d", [config templteId], cardType, erroCode);
       
       dispatch_async(dispatch_get_main_queue(), ^{
           //メインスレッドの UI 操作：カードのレンダリング
   		CubeView *view = [[[CubeService sharedInstance] getEngine] createView];
           CGSize size = [card getSize];
           [view setFrame:CGRectMake(0, 20, size.width, size.height) ];
           [self.view addSubview:view];
           
           [card renderView:view];
       });
   }

4. ビルドと実行

   • コンパイルと実行が成功した場合、Xcode コマンドラインで RPC リクエスト例外が報告されることがあります。詳細については、「RPC リクエスト例外」をご参照ください。

表示例。