新しい iOS・macOS 向け SDK、TransloaditKit の発表
2017年11月、新たに iOS・macOS 向け SDK、TransloaditKit が登場しました。Objective-C で実装され、Objective-C と Swift の両方から利用できるバージョン
1.0.0 は、Transloadit の基本機能と
tus による再開可能なアップロードを Apple アプリに提供しました。Transloadit API の対応範囲を広げるため、さらなる更新を予定していました。

セキュリティに関する更新、2026年9月: この記事は当初のリリース発表ですが、安全でない認証情報の設定と、現在は使われていない実行可能なサンプルを差し替えています。Auth Secret を
Info.plist、アプリのバイナリ、アプリがダウンロードする設定に決して含めないでください。信頼できるサーバー上で保持してください。サーバーは、どの Signature を承認する場合も、その前にユーザーを認証し、要求されたアップロードを認可する必要があります。Signature Authentication ガイドでは、この境界と、Workspace で署名を必須にする方法を説明しています。
リリース当初の CocoaPods パッケージ名は Transloadit でした。Swift との連携には、当初のヘッダーの問題を回避するため、Arcane への依存も必要でした。これらの設定は Objective-C 版に関するもので、後の Swift 実装向けの手順ではありません。バージョン 1.0.0 は SDK 内でシークレットを使ってリクエストに署名し、外部署名用のコールバックは公開していませんでした。シークレットを別のアプリ設定ファイルに移しても、セキュリティ境界の問題は解決しません。
後の TransloaditKit 3.5.0 リリースでは、Auth Secret をサーバー上に保持できる signatureGenerator イニシャライザーが追加されました。このバージョンの CocoaPods の宣言は次のとおりです。
pod 'Transloadit', '3.5.0'
Swift Package Manager を使う場合も、TransloaditKit リポジトリから同じバージョンを厳密に指定できます。次の Swift ヘルパーは、そのバージョンの公開 API を使用します。アプリの既存のバックエンド署名連携を受け取るもので、署名サービスを実装するものではありません。
import Foundation
import TransloaditKit
func makeUploadClient(
authKey: String,
configuration: URLSessionConfiguration = .default,
signatureGenerator: @escaping SignatureGenerator
) -> Transloadit {
Transloadit(
apiKey: authKey,
sessionConfiguration: configuration,
signatureGenerator: signatureGenerator
)
}
func makeResizeStep() -> Step {
Step(
name: "encode",
robot: "/image/resize",
options: ["width": 400, "result": true]
)
}
署名連携には、シリアライズされたパラメーターがそのまま渡されます。バックエンドでは、そのユーザーに許可された処理設定、送信先、ファイル制限、有効期限のみを許可し、クライアントが任意に選んだ処理設定は拒否する必要があります。承認したバイト列を再シリアライズせずに署名してください。返すのは署名のみとし、ネットワークのタイムアウトを含むすべての経路で、成功または失敗のいずれかで SDK コールバックを完了させてください。
3.5.0 には重要な制限があります。Assembly の作成時に auth.expires が24時間後に設定され、公開されている署名コールバックでは、これらのパラメーターを置き換えられません。ポリシーでより短い有効期間が必要な場合、この作成経路では要件を満たせません。代わりに、バックエンドで Assembly を作成するか、サーバーで管理するパラメーターを使って
Assembly 作成 APIを利用してください。コールバックを成功させるために、長い有効期限を黙って受け入れないでください。
Assembly を作成する簡単な例
当初のサンプルは、画像をリサイズする Assembly の例でした。そのワークフローは、いくつかの明確に分かれた段階で構成されていました。
- Robot
/image/resizeを使って、encodeという名前の Assembly Step を作成します。上記の Swift ヘルパーでは、後のStepイニシャライザーを使い、幅 400ピクセルを追加指定して結果を要求することで、この操作を表現しています。 - 当初の Objective-C API では、Step と想定ファイル数を指定して
Assemblyを作成し、ローカルファイルの URL を関連付けます。当初の Swift スニペットも、Swift ブリッジ経由で同じ Objective-C API を使用していました。 - リクエストを開始する前に、完了コールバックとステータスコールバックを登録します。旧
assemblyCompletionBlockは、assembly_ssl_urlを含む Assembly 作成レスポンスを受け取っていました。サンプルではその URL を代入してから、invokeAssemblyを呼び出してアップロードを開始し、checkAssemblyを呼び出して処理ステータスを確認していました。 - アップロードの進捗、処理の完了、失敗をそれぞれ別に処理します。Assembly URL を受け取っても、ファイルのアップロードや処理が完了したことにはなりません。
後の Swift SDK は、createAssembly と、返された
TransloaditPoller を使い、アップロードから処理までのフローをまとめて扱います。作成コールバックは、最終結果の通知ではありません。上記の
makeUploadClient と makeResizeStep ヘルパーは、クライアント設定と Step の構築のみを示しています。アプリには別途、認可されたバックエンド連携、ファイル選択、アップロードのライフサイクル、結果の処理が必要です。
この分離は、再開可能なアップロードで重要になります。tus は中断後に転送を再開できますが、Assembly はその転送に伴う処理ワークフローを表します。当初のリリース時と同様に、この連携の両方の部分を改善する貢献を歓迎します。使用するバージョンの API については、SDK のソースとドキュメントを参照してください.
