Avoiding Lock-In to Legacy Protocol Designs

Swift 3.0 で「残すべきでない」と判断されたプロトコルについて、deprecation と改名を先回りで行うことで、将来の設計変更の余地を確保します。既存のコードはコンパイルが通らなくなることはなく、警告が出るだけです。

Indexable 系プロトコルの deprecation

Indexable、MutableIndexable、RangeReplaceableIndexable、BidirectionalIndexable、RandomAccessIndexable といった Indexable 系プロトコルは、「Swift 4 で削除される」というメッセージ付きで deprecate されます。利用者は対応する Collection 系プロトコルを使うように切り替える必要があります。

// 旧: 実装詳細の Indexable 系を直接使っていたコード
func f<C: MutableIndexable>(_ c: inout C) { /* ... */ }

// 新: 対応する Collection 系プロトコルを使う
func f<C: MutableCollection>(_ c: inout C) { /* ... */ }

ExpressibleByStringInterpolation の deprecation

ExpressibleByStringInterpolation は、「設計の変更が予定されている」というメッセージ付きで deprecate されます。Swift 3.0 時点では新しい設計が確定していないため、前方互換を保てるかどうかも判断できず、いったん deprecated 扱いにして将来の再設計の余地を残します。

これは「プロトコル自体がすぐに消える」ことを意味するものではなく、独自型で文字列補間リテラルに対応させること自体は引き続き可能ですが、この API に依存する新規コードには警告が出ます。

Streamable の TextOutputStreamable への改名

Streamable プロトコルは TextOutputStreamable に改名され、Streamable は deprecated な typealias として残されます。OutputStream が TextOutputStream にリネームされたのに揃える形です。

// 旧
struct Foo: Streamable {
    func write<Target: OutputStream>(to target: inout Target) { /* ... */ }
}

// 新
struct Foo: TextOutputStreamable {
    func write<Target: TextOutputStream>(to target: inout Target) { /* ... */ }
}

Streamable という名前を使っているコードは、マイグレータによって自動的に TextOutputStreamable へ書き換えられます。

影響

この変更でコードがコンパイルできなくなったり、挙動が変わったりすることはありません。deprecation によって警告が出るだけで、Streamable のリネームは自動マイグレーションの対象ですが、それ以外の警告を解消するには手作業でコードを書き換える必要があります。