【Swift】Transferableプロトコルとは？意味や活用シーンをわかりやすく解説！

2025年8月9日 2025年8月9日

アプリを作っていると、「このデータを別の画面や別のアプリに渡したい」という場面がよくあります。
例えば、

写真をドラッグ＆ドロップで他のアプリに渡す
自作データをコピー＆ペーストできるようにする
作った文章や画像を「共有」メニューから送る

こうした処理を、安全・シンプル・型安全に書けるのが Transferable プロトコルです。

Transferableプロトコルとは？

Transferableは、「この型のデータを外部に渡す方法」を決めるためのプロトコルです。

一言でいえば、SwiftUIでドラッグ＆ドロップや共有を“型そのまま”で扱えるようにする仕組みです。

普通、アプリ間でやり取りするにはデータをDataやStringに変換したり、NSItemProviderを直接触る必要がありますが、Transferableを使えばもっとシンプルに書けます。

どう書くの？

Transferableを使うには、その型に「どんな形でやり取りするか」を宣言します。

それがTransferRepresentationです。

TransferRepresentation は、Transferable プロトコルの中で「この型をどういう形式でやり取りするか」を定義する部分です。

static var transferRepresentationという形で指定します。

代表的なやり取り方法は次のとおりです。

TransferRepresentation	役割
CodableRepresentation	Codable準拠のデータを安全にやり取り
DataRepresentation	Data + ファイル形式（例 `.png`、`.plainText`）で転送
FileRepresentation	大きなデータを一時ファイルで渡す
ProxyRepresentation	別のTransferableなプロパティを経由して渡す

次の章でそれぞれの役割を説明します。

代表的な TransferRepresentation の種類と役割

ここでは、「この型をどういう形式でやり取りするか」を定義するTransferRepresentationの代表的な4種類を説明します。

1. CodableRepresentation

役割：Codableに準拠したデータを安全にそのままやり取りします。
特徴：

アプリ内や同じ型同士の受け渡しに最適
モデル全体を完全復元できる
他アプリはCodableを理解できないので、互換性は限定的

2. DataRepresentation

役割：Dataとファイル形式（UTType）を組み合わせて転送します。
特徴：

画像（.png）、テキスト（.plainText）など汎用的な形式にできる
他アプリとの互換性が高い
必要に応じてエンコード・デコード処理を自分で書く

3. FileRepresentation

役割：大きなデータを一時ファイルとしてやり取りします。
特徴：

数百MB以上の動画や大きなJSONなど、メモリに載せにくいデータ向け
高速かつメモリ効率が良い
一時ファイルは受信後に保存先へ移動する必要あり

4. ProxyRepresentation

役割：既にTransferable対応済みの別プロパティに処理を委譲します。
特徴：

共通化でコード重複を減らせる
基本的なやり取りは委譲先の型が担う
代表データ側の仕様変更が委譲元すべてに影響する

この4つを組み合わせることで、「まずは完全復元、ダメなら汎用形式、それもダメならファイル渡し」といった多段フォールバックが可能になります。

具体例でTransferableプロトコルを理解する

それでは「メモ（文字列）」をアプリ間・UI間でやり取りできるようにする具体例でTransferableプロトコルの具体例を見ていきましょう。

1. データ型（Note）の定義

import SwiftUI
import UniformTypeIdentifiers

struct Note: Identifiable, Hashable, Codable, Transferable {
    var id = UUID()
    var text: String

    static var transferRepresentation: some TransferRepresentation {
        // 同型間で安全にやり取り（完全復元）
        CodableRepresentation(contentType: .data)
        // 他アプリともやり取りできるようプレーンテキスト形式も用意
        DataRepresentation(exportedContentType: .plainText) { note in
            Data(note.text.utf8)
        } importing: { data in
            Note(text: String(decoding: data, as: UTF8.self))
        }
    }
}

import SwiftUI

import UniformTypeIdentifiers

struct Note: Identifiable, Hashable, Codable, Transferable {

var id = UUID()

var text: String

static var transferRepresentation: some TransferRepresentation {

// 同型間で安全にやり取り（完全復元）

CodableRepresentation(contentType: .data)

// 他アプリともやり取りできるようプレーンテキスト形式も用意

DataRepresentation(exportedContentType: .plainText) { note in

Data(note.text.utf8)

} importing: { data in

Note(text: String(decoding: data, as: UTF8.self))

}

何をしようとしているか

Noteというメモを表す型を作り、それをTransferable対応にしています。
これにより、UI側でNoteをそのまま共有したり、ドラッグできるようになります。

コードの意図

CodableRepresentation
- 同じアプリや同じ型間でのやり取りなら、Noteを完全な形で安全に送受信できます。
DataRepresentation(.plainText)
- 他のアプリはNote型を知らないため、代わりにプレーンテキストとしてやり取りできるようにフォールバック形式を用意。

ポイント

複数のTransferRepresentationを組み合わせることで、アプリ間の互換性が上がります。
先に書いた形式が優先されます（ここではまずCodable、次に.plainText）。

2. 共有（ShareLink）

struct ShareNoteButton: View {
    let note = Note(text: "こんにちは Transferable！")

    var body: some View {
        ShareLink(item: note) {
            Label("このメモを共有", systemImage: "square.and.arrow.up")
        }
    }
}

struct ShareNoteButton: View {

let note = Note(text: "こんにちは Transferable！")

var body: some View {

ShareLink(item: note) {

Label("このメモを共有", systemImage: "square.and.arrow.up")

}

何をしようとしているか

noteをiOSの共有メニュー（AirDrop、メール、ファイル保存など）で送れるようにする。

コードの意図

ShareLink(item:)にNoteを直接渡すと、システムがtransferRepresentationを参照し、最適な形式（Codable or plainText）でエクスポートします。

ポイント

UIコードが非常に短い：共有のために型変換やバイト列処理を一切書く必要がない。
拡張性：Noteの転送方法を変えたい場合はNote側のtransferRepresentationを修正するだけでOK。

3. ドラッグ＆ドロップ

struct NotesBoard: View {
    @State private var notes = [
        Note(text: "りんご"), Note(text: "バナナ"), Note(text: "みかん")
    ]
    @State private var dropped: [Note] = []

    var body: some View {
        HStack(spacing: 24) {
            // ドラッグ元
            VStack {
                Text("ドラッグ元").font(.headline)
                ForEach(notes) { note in
                    Text(note.text)
                        .padding(8)
                        .background(.thinMaterial, in: RoundedRectangle(cornerRadius: 8))
                        .draggable(note) // ← Transferable準拠のnoteを直接渡せる
                }
            }

            // ドロップ先
            VStack {
                Text("ドロップ先").font(.headline)
                ForEach(dropped) { note in
                    Text("受領: \(note.text)")
                        .padding(8)
                        .background(Color.green.opacity(0.2), in: RoundedRectangle(cornerRadius: 8))
                }
            }
            .frame(minWidth: 200, minHeight: 180)
            .dropDestination(for: Note.self) { items, _ in
                dropped.append(contentsOf: items)
                return true
            }
        }
        .padding()
    }
}

struct NotesBoard: View {

@State private var notes = [

Note(text: "りんご"), Note(text: "バナナ"), Note(text: "みかん")

]

@State private var dropped: [Note] = []

var body: some View {

HStack(spacing: 24) {

// ドラッグ元

VStack {

Text("ドラッグ元").font(.headline)

ForEach(notes) { note in

Text(note.text)

.padding(8)

.background(.thinMaterial, in: RoundedRectangle(cornerRadius: 8))

.draggable(note) // ← Transferable準拠のnoteを直接渡せる

}

// ドロップ先

VStack {

Text("ドロップ先").font(.headline)

ForEach(dropped) { note in

Text("受領: \(note.text)")

.padding(8)

.background(Color.green.opacity(0.2), in: RoundedRectangle(cornerRadius: 8))

}

.frame(minWidth: 200, minHeight: 180)

.dropDestination(for: Note.self) { items, _ in

dropped.append(contentsOf: items)

return true

}

.padding()

}

何をしようとしているか

左側の「ドラッグ元」から、右側の「ドロップ先」にNoteを直接ドラッグ＆ドロップする機能を作る。

コードの意図

.draggable(note)
- ユーザーが要素をドラッグしたときに、そのnoteをtransferRepresentationに沿ってエクスポートします。
.dropDestination(for: Note.self)
- ドロップされたデータをNote型として受け取り、配列droppedに追加。

ポイント

型変換不要：受け取り側でDataやStringへの変換をしなくても直接Noteとして扱える。
複数ドロップ対応：itemsは配列なので、複数のメモをまとめてドロップできる。
アプリ間連携も可能：plainTextのDataRepresentationを用意しておけば、他のアプリにドラッグしてもテキストとして受け取ってもらえる。

まとめ

Transferableは、「UI間やアプリ間でデータを渡す」処理を、短く安全に書ける仕組みです。

特にドラッグ＆ドロップや共有機能を実装する際には非常に便利なので、「自作型を別の画面やアプリで使えるようにしたい」ときはまず検討すべき機能です。

【Swift】Transferableプロトコルとは？意味や活用シーンをわかりやすく解説！

Transferableプロトコルとは？

どう書くの？

代表的な TransferRepresentation の種類と役割

1. CodableRepresentation

2. DataRepresentation

3. FileRepresentation

4. ProxyRepresentation

具体例でTransferableプロトコルを理解する

1. データ型（Note）の定義

何をしようとしているか

コードの意図

ポイント

2. 共有（ShareLink）

何をしようとしているか

コードの意図

ポイント

3. ドラッグ＆ドロップ

何をしようとしているか

コードの意図

ポイント

まとめ

最近の投稿

最近のコメント

アーカイブ

カテゴリー