【iOS】SVGKitで「pixelsPerInchForCurrentDevice」のAssertion failureで落ちる・表示されない時の対処法

Posted at 2026-03-04

はじめに

iOSでSVGを扱う際の定番ライブラリ「SVGKit」を動かした際、「最初の1回目だけ表示されない」「アプリが落ちる」 という現象に遭遇することがあります。

今回は、その原因と解決方法をまとめました。

Xcodeのコンソールに以下のようなエラーが出力され、SVG画像の描画に失敗します。

*** Assertion failure in +[SVGLength pixelsPerInchForCurrentDevice], SVGLength.m:238

なぜか2回目以降のSVG読み込みは問題なく表示される
特定の端末・開発環境でしか発生しない。
古いiPhoneやシミュレータでは動くのに、最新端末だと失敗する。

SVGKitの内部実装（SVGLength.m）では、デバイスのモデル識別子（例：iPhone15など）を見て、その端末のPPI（ピクセル密度）をハードコーディングされたリストから取得しています。

しかし、CocoaPodsで普通にインストールされる公式の最終リリース(2.x〜)は数年前で更新が止まっており、最新のiPhoneがリストに含まれていません。

リストにない未知のデバイスで実行されると、「PPIが計算できない」とAssertionが失敗し、処理が中断されてしまうのが原因でした。

GitHub上のソースコードには修正が入っているのですが、CocoaPodsへのリリース作業が止まっているようです。
コードを書くこと以上に、配信のパイプラインを維持し続けるのはメンテナーにとってかなりの負担です。最新の修正が「パッケージ」として降ってこない現状は、OSSの難しさを感じます。

公式リリース（バージョン指定）を待っていても解決しないため、修正が進んでいる 3.x ブランチを直接参照するように Podfile を書き換えて対応しました。

ruby.diff

# 修正前
- pod 'SVGKit'

# 修正後：最新デバイスのPPI定義が含まれている3.xブランチを指定
+ pod 'SVGKit', :git => 'https://github.com/SVGKit/SVGKit.git', :branch => '3.x'

pod install

これで、最新のiPhoneモデルがリストに追加された状態のSVGKitがインストールされ、エラーが解消されます。

原因: CocoaPodsの公式版が古く、最新iPhoneのPPI定義を持っていないため。
対策: Podfile でGitHubの 3.x ブランチを直接指定してインストールする。
教訓: GitHub上では修正済みでも、パッケージマネージャーへの配信が止まっているケースは多々ある。

この記事が、SVGKitの表示不具合に悩む誰かの助けになれば幸いです。

この問題はSVGKitの本家リポジトリでも議論されていました。