ハンドブック版 v2026.04.17.1 公開日 2026-04-17

初回起動とインポート¶

目的¶

最初の利用時に、ライブラリから入り、インポートし、開いて、再びライブラリへ戻るまでの一連の流れを無理なく確認できるようにします。

対応プラットフォーム¶

iOS
macOS

対象読者¶

最初のインポート経路を一通り確認したい新規ユーザー
ライブラリからワークスペースまでのインポート挙動を確認したいテスター

前提条件¶

PCBAtlas がライブラリまで正常に起動できる
内蔵サンプルまたは自分の設計 / 製造データを用意している

手順¶

ライブラリから、元データに合った設計経路または製造経路を選びます。
ソースが IPC-2581 XML の場合は、確認ダイアログでインポート意図を選びます。
進捗バナーの完了を待ってから、結果のドキュメントをワークスペースで開きます。
2D / Data で内容を確認し、必要ならリビジョンの変化も確認します。

結果¶

ソースがライブラリ内の新規ドキュメントまたは新規リビジョンとして取り込まれ、ワークスペースで開けます。

初回コールドスタート時の既定データ¶

ライブラリが空の場合、アプリはすぐに開ける KiCad サンプルドキュメントを 2 つ自動で用意します。

h730duino
BluePhil

まず操作感だけをつかみたいなら、どちらかを先に開くのがおすすめです。自分のデータを確認したい場合は、そのまま下のインポート手順へ進んでください。

現在のインポート経路¶

新規ドキュメント作成またはリビジョン追加¶

設計経路: DSN、KiCad .kicad_pcb、IPC-2581 XML
製造経路: IPC-2581 XML、ODB++ アーカイブ / ディレクトリ、インポータが認識できる製造パッケージ系ディレクトリデータ

既存ドキュメント文脈が必要なインポート¶

SES: 単独の新規ドキュメントは作れず、既存ドキュメントのメニューから base revision を選んで開始する必要があります

IPC-2581 の特別な挙動¶

IPC-2581 XML を選んだ場合、アプリはそれを設計側データか製造側データかを自動で決め打ちしません。代わりに確認ダイアログが表示され、次のどちらとして扱うかを選べます。

設計データ としてインポート
製造データ としてインポート

推奨手順¶

ライブラリのホーム画面でインポート入口を押します。
手元の資料に合わせて、設計経路か製造経路を選びます。
ファイル選択後、それが IPC-2581 XML ならインポート意図を選びます。
ライブラリ上部の進捗バナーが進むのを待ちます。
インポート完了後、新しいカードが現れるか、対象ドキュメントのリビジョン数が増えます。
ドキュメントをワークスペースで開き、2D / Data が正常に見られることを確認します。

表示されるフィードバック¶

ライブラリ上部には、タイトル、段階説明、パーセンテージを含む進行中バナーが表示されます。
インポート中に別のドキュメントを手動で開いても、処理は継続しますが、新しく取り込んだドキュメントに強制的に戻されることはありません。
ワークスペースで別の基板ファイルをドラッグ & ドロップした場合、すでにドキュメントが開いていれば、現在内容を置き換えるか確認されます。

リビジョン関連の操作¶

ライブラリカードのアクションメニューから、次を実行できます。

設計リビジョンを追加
製造リビジョンを追加
SES をインポートし、base として使える過去リビジョンを選ぶ

つまり、インポートは新規ドキュメント作成だけでなく、同一プロジェクトの継続的なリビジョン管理にも使われます。

同名・同形式を再インポートしたときの現在ルール¶

同じドキュメント名・同じ形式のソースを再び取り込んだ場合、現在の実装では、いきなり別カードを増やすより「同一ドキュメントへの追加入力」として扱う方向が優先されます。

新しく取り込んだ原始ソースが現在リビジョンと 完全一致 する場合は、「変化なし」とみなされ、インポートは無視されます
原始ソースが 異なる 場合は、そのドキュメント配下の新しいリビジョンとして保存され、最新リビジョンへ切り替わります
リビジョン表示は、ドキュメント名に応じて A1 / A2 / ... のように動的に表示されます

推奨事項¶

最初の検証では、単一の DSN または KiCad ファイルから始めるのがおすすめです。
製造データを入れる場合は、アーカイブやディレクトリが完全かどうかを先に確認してください。
同一プロジェクトの継続更新には、似たドキュメントを増やすよりリビジョン追加を優先してください。

よくある質問¶

なぜ `SES` は普通のファイルのようにインポートできないのですか？¶

SES は既存の設計リビジョンを base revision として必要とするためです。現在の実装では、まず既存ドキュメントに入り、そのドキュメントのメニューから SES インポートを開始する必要があります。

なぜ `IPC-2581` を選んだ後にもう一度聞かれるのですか？¶

同じ IPC-2581 XML でも設計側データとして扱うか、製造側データとして扱うかが分かれるため、現在の実装では明示的に選択させます。

同じ `IPC-2581` を設計経路と製造経路で取り込んでも、見た目がほとんど変わらないのはなぜですか？¶

これは現在版では自然な挙動です。IPC-2581 では、現時点での主な違いはライブラリ側の取り込み意図やドキュメント分類であり、開いた直後に強い見た目の差として出るとは限りません。

設計経路で入れた場合は、設計資料として管理されます
製造経路で入れた場合は、製造資料として管理されます
この分類は、後でどちらの経路を既定としてリビジョン追加するかなどに影響します
同じ IPC-2581 を両経路で入れた場合、通常は自動統合されず、別ドキュメントとして扱われます

ただし、現在の表示チェーンでは設計 / 製造の差がワークスペース上でまだ強く表現されないため、見た目はかなり近く感じられることがあります。

なぜインポートピッカーにすべての製造パッケージ拡張子が並ばないのですか？¶

製造経路は一般的なアーカイブやディレクトリ、汎用データ入力を受け付けます。最終結果は、選んだソースをインポータがどこまで認識できるかに依存します。

最終確認日¶

2026-04-17