ハンドブック版
v2026.04.17.1
公開日 2026-04-17
PDF をダウンロード
インポート失敗¶
目的¶
現在の失敗が、未対応入力なのか、インポート経路の選択ミスなのか、あるいはランタイム保護による停止なのかを素早く判断できるようにします。
対応プラットフォーム¶
iOSmacOS
対象読者¶
- インポートが想定どおり動かなかったユーザー
- インポート失敗、無視された再インポート、局所降格を切り分けたいテスター
前提条件¶
- 確認したい具体的なインポート事例、メッセージ、再現経路がある
- 可能であれば元ファイルと再現手順を保持している
手順¶
- 失敗した地点がファイル選択前、選択後、ワークスペース遷移後のどこかを切り分けます。
- 使用したインポート経路と、その入力が本来その経路で扱えるかを確認します。
- 下の失敗タイプ一覧と照合し、変化なし判定や DSN 局所降格 warning も含めて分類します。
- 再試行前に、正確なメッセージとソース条件を記録します。
結果¶
- 問題を未対応入力、経路ミスマッチ、保護停止、変化なし再インポート、局所降格のいずれかへ絞り込めます。
最初に見るべき 3 点¶
- 失敗したのは ファイル選択前、ファイル選択後、それとも ワークスペースに入った後 か
- アプリは明確なエラーメッセージを出したか
- 操作は 新規インポート、リビジョン追加、SES のどれだったか
現在よくある失敗タイプ¶
1. 入力形式が未対応¶
典型的な兆候:
- 拡張子未対応と直接表示される
- ファイル選択後にフローが進まない
推奨対応:
- まず設計経路と製造経路のどちらを使ったか確認する
- そのうえで、その入力が現在の対応範囲に入っているか確認する
2. IPC-2581 のインポート意図が違う¶
典型的な兆候:
- ファイル自体は選べるが、インポート結果が想定と違う
推奨対応:
- もう一度インポートする
- 設計側として扱うか製造側として扱うかを選び直す
3. SES の使い方が違う¶
典型的な兆候:
SESを通常の新規ドキュメントのように取り込もうとしている- 現在ドキュメントに使える base revision がない
推奨対応:
- 対象ドキュメントのメニューを開く
Import SESから開始する- 先に有効な base revision を選ぶ
4. 大きな IPC-2581 が事前チェックで止められる¶
現在の実装には、大きな IPC-2581 XML に対するメモリ事前チェック保護があります。
- ファイルサイズ、物理メモリ量、プラットフォーム種別からピーク使用量を推定する
- リスクが安全予算を大きく超える場合、オープン前に停止する
これはメモリ不足による OS 側強制終了を避けるためです。
5. すでに別のインポート処理が動いている¶
現在の実装では、同時に動かせる PCB インポート処理は 1 件だけです。前のインポートが終わっていない場合、次の要求はステータスメッセージ付きで拒否されます。
6. 同名・同形式の入力が「変化なし」と判定される¶
現在の実装では、同じドキュメント名・同じ形式で再インポートした場合、原始ソースのバイト比較が行われます。
- 新しく取り込んだ原始ソースが現在リビジョンと完全一致する場合は、「変化なし」としてインポートが無視されます
- これは失敗扱いではなく、重複リビジョンを増やさないための挙動です
- 新しいリビジョンになるはずだと思う場合は、まずファイル内容が本当に変わっているか確認してください
7. DSN の局所ジオメトリが一部だけ降格する場合がある¶
典型的な兆候:
- インポート自体は成功し、ドキュメントも開ける
- ただし開発ログやコンソールに
skipping display object variant ... no valid contours could be extractedのような warning が出る
意味すること:
- 少数の display variant について有効な contour を抽出できず、その局所変体だけをスキップして残りの基板はそのままインポート継続している状態です
- これはボード全体の失敗やクラッシュを避けるための挙動で、通常は局所描画にだけ影響し、ドキュメント全体が開けなくなるわけではありません
推奨対応:
- まず、問題の箇所が自分の用途に対して本当に影響しているか確認してください
- 影響が大きい場合は、warning 文面、元の
DSN、再現手順を記録して追跡に回してください
KiCad 固有の注意¶
KiCad 基板が 2D 的には正常にインポートされても、project-local の 3D 資産が欠落または読み取り不可だと、後で 3D や診断に issue として現れることがあります。これは必ずしも 2D オープンを妨げませんが、3D の完全性には影響します。
記録しておきたい情報¶
- プラットフォームと端末
- インポート経路種別: 設計 / 製造 / SES
- 元ファイルの種類とサイズ
- エラーメッセージ原文
- 再現が安定しているか
- すでに別のインポートが動いていたか
よくある質問¶
なぜ一部の製造入力はフォルダでもインポートできるのですか？¶
製造経路はディレクトリ形式入力も受け付けるためです。成功するかどうかは、そのディレクトリをインポータが対応製造パッケージとして認識できるかに依存します。
なぜ失敗後にライブラリへ新しいカードが出ないのですか？¶
それは通常、ドキュメント作成前に失敗していることを意味します。たとえば未対応入力、事前チェックでの拒否、インポータ認識失敗などです。
同じファイル名をもう一度入れたのに、新しいリビジョンが増えないのはなぜですか？¶
「変化なし」と表示されているなら、新しく取り込んだ原始ソースが現在リビジョンと同一という意味です。現在の実装では、重複リビジョンを作らずに無視されます。
2 回目は成功しました。それでも記録すべきですか？¶
はい。断続的な失敗も安定性評価には重要です。
最終確認日¶
2026-04-17