刷新した Android SDK のリリース
2018 年 4 月、刷新した Android SDKを公開しました。以前から Java SDKは Android プロジェクトでも利用でき、それより前の Android 向け統合も存在していましたが、今回の刷新により、ほかの SDK とより整合した API を提供できるようになりました。

Java SDK を基盤とするこの Android 統合では、非同期の Assembly 送信と、アップロードの一時停止および再開のサポートを追加しました。ファイルのアップロードと処理を進めている間も、アプリはユーザーへの応答を継続でき、その過程で進捗コールバックと完了コールバックを受け取れました。
セキュリティ更新、2026 年 9 月: 元の 0.0.2 の例では、Android アクティビティ内で Auth Secret を SDK に渡していました。これは、シークレットをアプリと一緒に配布することになります。以下では、実行可能なアクティビティ例を置き換えています。社内配布のアプリであっても、Auth Secret は信頼できるバックエンドに保持してください。バックエンドでは、任意のパラメーターに署名する前に、ユーザーを認証し、アップロードを認可する必要があります。Signature Authentication ガイドに従い、アプリが使用する Workspace または Template に対して署名を必須にしてください。
0.0.2 の Android クライアントは、SignatureProvider
コンストラクターを公開していませんでした。そのリリースのシークレットベースのアクティビティコードをそのまま残し、単にバックエンド URL を追加するだけでは解決しません。統合には、サポート対象の外部署名 API か、別のリクエスト経路が必要です。
このリリースでは当初、Gradle の compile 設定を使用し、インストール元として Maven Central と JCenter を挙げていました。ただし、これは現在のビルド設定ではなく、0.0.2 のインストール手順です。当時のバックグラウンドワークフローは次のとおりです。
- アップロード進捗、アップロード完了、処理完了、アップロード失敗、ステータス更新失敗を受け取るための Assembly リスナーを実装する
- Android クライアントと、アクティビティのコンテキストおよびリスナーに関連付けた非同期 Assembly を作成する
- ローカル画像を添付し、幅と高さを 75 ピクセルに設定した
/image/resizeの Step を追加し、resize_strategyをpadに設定する - Assembly を送信し、リスナーが進捗を報告している間もほかの処理を続行する。アップロード完了と処理成功は別イベントである
古いサンプルでは androidAsyncAssembly と assembly の変数名が混在しており、現在のプロジェクトにコピーして使えるアクティビティにはなっていません。以下のより小さな例では、リサイズ処理を維持しつつ、その後の署名境界を示しており、アクティビティのライフサイクルには依存しません。
ここでは Android SDK 0.2.0 と Java SDK 2.2.4 を使用します。どちらも Maven Central で公開されています。これらは 2018 年に発表したバージョンではなく、それより後のバージョンです。Android アーティファクトの公開 POM には依存関係の宣言が含まれていないため、AAR だけを追加すれば依存関係もインストールされるとは考えないでください。完全な Android 統合には、タグ付き Android ビルド内の依存関係一覧を使用し、アプリのビルドで検証してください。
このヘルパーは、既存のバックエンド統合で実装した SignatureProvider を受け取ります。ここには、シークレットも署名エンドポイントも含まれません。
import com.transloadit.android.sdk.AndroidTransloadit;
import com.transloadit.sdk.Assembly;
import com.transloadit.sdk.SignatureProvider;
import java.io.File;
import java.util.HashMap;
import java.util.Map;
public final class ImageUpload {
private ImageUpload() {}
public static AndroidTransloadit createClient(
String authKey, SignatureProvider approvedSignatures) {
return new AndroidTransloadit(authKey, approvedSignatures);
}
public static void addImage(Assembly assembly, File image) {
assembly.addFile(image, "image");
Map<String, Object> stepOptions = new HashMap<>();
stepOptions.put("width", 75);
stepOptions.put("height", 75);
stepOptions.put("resize_strategy", "pad");
assembly.addStep("resize", "/image/resize", stepOptions);
}
}
このプロバイダーはシリアライズ済みパラメーターを受け取り、その完全に同一のバイト列に対するバックエンドの署名を返します。認可または署名に失敗した場合は例外をスローします。サーバー側では、許可する Step または Template、宛先、ファイル数やサイズの制限、短い有効期限を必ず強制する必要があります。呼び出し元がログイン済みであるという理由だけで、任意の JSON ボディに署名してはなりません。固定ワークフローでは、allow_steps_override を無効にした、サーバー選択の Template を使うことで、処理設定をサーバー側の管理下に置けます。Auth Secret をプロバイダーへ返してはいけません。
Android アプリでは、その後の API は newAssembly(listener, context) を使って
AndroidAssembly を作成します。このとき、リスナーは
AndroidAssemblyListener を実装します。その Assembly は
ImageUpload.addImage に渡し、その後 saveAsync() で送信できます。進捗コールバックの名前は onUploadProgress です。ネットワーク処理は UI スレッドの外で実行し、コールバックはアプリの実際のライフサイクルに結び付けてください。例外処理だけでなく、レスポンスステータスと hasError() も確認する必要があります。API エラーレスポンスは、必ずしも例外としてスローされるとは限りません。上記のヘルパーはクライアントのセットアップと画像設定を扱いますが、バックグラウンドスケジューリングの実装や、デバイス上での一時停止と再開の挙動の検証までは行いません。
統合するバージョンの詳細については、Android SDK ソースとその API リファレンスを参照してください。元のリリースにより Android アップロードは統合しやすくなりましたが、そのワークフローを現在のアプリへ持ち込む場合でも、署名処理をバックエンド側で行うことが不可欠です。
