Importing Forward Declared Objective-C Interfaces and Protocols

Objective-Cでは、循環依存の解消やビルド時間短縮のために、型の完全な定義を取り込まず @class Foo; や @protocol Bar; といった前方宣言（forward declaration）で済ませることがよくあります。Objective-C同士ではこれは問題なく機能しますが、SwiftからObjective-C APIを利用する場面では深刻な障害になっていました。

ClangImporterは、前方宣言された型を参照する宣言を一切Swiftへインポートできず、そのまま落としてしまうためです。1つの型が前方宣言されているだけで、その型を引数や戻り値、プロパティなどに含むメソッドや関数がごっそり欠落し、Objective-CのAPIの大部分がSwiftからは存在しないかのように見えてしまいます。

たとえば次のようなObjective-Cヘッダは、

#import <Foundation/Foundation.h>

@class ForwardDeclaredInterface;
@protocol ForwardDeclaredProtocol;

@interface IncompleteTypeConsumer1 : NSObject
@property id<ForwardDeclaredProtocol> propertyUsingAForwardDeclaredProtocol1;
@property ForwardDeclaredInterface *propertyUsingAForwardDeclaredInterface1;
- (id)init;
- (ForwardDeclaredInterface *)methodReturningForwardDeclaredInterface1;
- (void)methodTakingAForwardDeclaredInterface1:(ForwardDeclaredInterface *)param;
@end

ForwardDeclaredInterface *CFunctionReturningAForwardDeclaredInterface1(void);
void CFunctionTakingAForwardDeclaredInterface1(ForwardDeclaredInterface *param);

Swiftから見ると、前方宣言の型に触れるメンバも関数もすべて消え、実質的に次のようなほぼ空のクラスしか見えません。

class IncompleteTypeConsumer1 : NSObject {
    init!()
}

この問題を回避するには、Objective-Cヘッダ側で完全な定義を #import するか、利用する側のSwiftファイルで完全な定義を含むモジュールをインポートする必要があります。しかし、既存のObjective-C資産が大きいプロジェクトほど、このような手作業での対応はコストが高く、不要なインポートが増えてビルド時間も悪化します。SwiftからObjective-C APIを使う体験を、Objective-Cから使うときと同じくらい自然にしたい、という動機がありました。