Swiftで書かれたiOSアプリを実機デバッグ実行時に「image not found」エラーとなる場合の対処

エラー内容

Swiftで書かれたコードを含むiOSアプリを、検証用のiOS端末に流し込んで実機デバッグしようとすると、以下のようなエラーが出てクラッシュしてしまう事がある。

Objective-Cで書かれた既存XcodeプロジェクトにSwiftコードを追加した際にも遭遇する。

dyld: Library not loaded: @rpath/libswiftCore.dylib
Referenced from: /private/var/mobile/Containers/Bundle/Application/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/App-Name.app/App-Name
Reason: image not found

解決方法

確認するポイントとしては2点ある。

1点目は「Build Settings」-「Build Options」-「Embedded Content Contains Swift Code」を「Yes」に設定する。

Xcode設定画面

2点目は「Build Settings」-「Linking」-「Runpath Search Path」に @executable_path/Frameworks を追加する。

これらの設定を行ってからXcodeで再度デバッグ実行すると、iOS端末に流し込んでアプリを起動後にクラッシュが発生することは無くなった。

参考情報

ios - dyld: Library not loaded: @rpath/libswiftCore.dylib / Image not found - Stack Overflow