SourceMap マルチパートアップロード関連インターフェース使用説明¶
マルチパートアップロードの流れ¶
- マルチパートアップロードイベントの初期化：アプリケーション、環境、バージョンを指定し、アップロードタスク識別子
uploadIdを取得します。 - 単一パートのアップロード：SourceMap 圧縮パッケージを分割し、同じ
uploadIdと各パートのchunkIndexを使用してアップロードします。1 パートあたりのサイズは 10MB 以内にしてください。 - アップロード済みパートの一覧取得：タスクの
chunkIndexsを読み取り、タスクの有効期限内に不足しているパートをアップロードします。 - パートをマージしてファイルを生成：全パートのアップロード完了を確認してから呼び出します。サーバー側でパート番号順に圧縮パッケージをマージし、非同期の解凍タスクを投入します。
マージインターフェースの成功は、ファイルがマージされ解凍タスクが投入されたことを示します。解凍が完了したことや SourceMap が解析に使用できることを示すものではありません。
初期化結果と有効期限¶
uploadIdのデフォルトの有効期限は 3600 秒です。その後のパートアップロード、パート一覧取得、マージはすべて同じ有効なタスク ID を使用してください。- 初期化時に
existsSameFile=trueが返され、needCover=trueが設定されていない場合、空のuploadIdが返されることがあります。同じアプリケーション、環境、バージョンのファイルを上書きする必要があるかを確認し、再初期化するかどうかを判断してください。 ft.InvalidUploadIdを受け取った場合は、タスクを再初期化し、必要なパートを再アップロードしてください。無効になった ID を引き続き使用しないでください。
アップロードのキャンセル¶
マルチパートアップロードイベントのキャンセルを使用して、uploadId に対応する有効なタスク全体をキャンセルし、タスクキャッシュとそのタスクのパートディレクトリを削除します。このインターフェースは、特定のパートのみを削除するためのものではありません。
タスクがすでに無効になっている場合、キャンセルインターフェースは古いパートディレクトリのクリーンアップを保証しません。再アップロードする場合は、新しく初期化した uploadId を使用してください。
単一ファイルコンテンツのアップロード¶
単一ファイルコンテンツのアップロードは、SourceMap の解凍後に生成される単一のソースファイルのコンテンツを直接アップロードするためのインターフェースです。インターフェースの要件に従ってアプリケーション、環境、バージョン、ファイル名、コンテンツを指定するだけでよく、マルチパートの初期化やマージのプロセスは必要ありません。上記の 10MB 制限はマルチパートアップロードインターフェースに適用されます。