コンテンツにスキップ
ドキュメント版 v2026.08.31.0
PDF をダウンロード

初回起動とインポート

目的

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

対応プラットフォーム

  • iOS
  • macOS

対象読者

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

前提条件

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

手順

  1. ライブラリから、元データに合った Import File または Import Folder を選びます。
  2. ソースが IPC-2581 XML の場合は、確認ダイアログでインポート意図を選びます。
  3. 進捗バナーの完了を待ってから、結果のドキュメントをワークスペースで開きます。
  4. 単独の PCB ソースが PCB Viewer で開き、回路図ソースおよび回路図を含む KiCad プロジェクトが Schematic Workbench で開き、リビジョンが想定どおり更新されたことを確認します。

結果

  • ソースが新規ドキュメントまたは新規リビジョンとしてライブラリに取り込まれ、対応する PCB Viewer または Schematic Workbench で開きます。

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

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

  • h730duino（ODB++ 製造データ）
  • BluePhil（KiCad 設計基板）
  • WooKey Mainboard（PCB と階層回路図を含む KiCad プロジェクト）

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

現在のインポート経路

Import File

  • 単独の DSN、KiCad .kicad_pcb、KiCad .kicad_sch、または IPC-2581 XML
  • 通常の KiCad .zip、またはアプリが認識できる ODB++ / Gerber / Drill 製造アーカイブ
  • 互換性のある .epcbdoc.zip ドキュメントパッケージ

.kicad_pro を単独ファイルとして取り込まないでください。プロジェクトには同じディレクトリの回路図、ライブラリ、設定が必要なため、Import Folder を使ってください。単独の .kicad_sch は child sheet を参照しない場合にだけ直接取り込めます。複数 sheet の回路図もプロジェクトフォルダ経由で取り込む必要があり、ディレクトリ権限を補うための 2 回目のファイルピッカーは表示されません。

Import Folder

  • 有効な .kicad_pro を含む KiCad プロジェクトディレクトリ（回路図のみのプロジェクトを含む）

フォルダとアーカイブ内のソース選択

Import Folder が受け付けるのは KiCad プロジェクトだけです。PCBAtlas が有効な .kicad_pro を見つける必要があります。プロジェクトファイルがない、またはプロジェクトを再オープンできない場合、.kicad_pcb や .kicad_sch のインポートにフォールバックせず、直接エラーになります。複数のプロジェクトが見つかった場合は、暗黙に選ばず明示的な選択を求めます。成功すると、選択ディレクトリ内のすべての通常ファイルが元の相対パスで同じリビジョンへ保存されます。プロジェクト閉包外のメモや製造出力も含まれます。読み取り不能なファイル、シンボリックリンク、その他の未対応ディレクトリエントリがあれば、部分保存せずインポート全体が失敗します。

Files、iCloud Drive、またはサードパーティのファイルプロバイダからプロジェクトディレクトリを選ぶ場合、アプリはまず完全なディレクトリをローカル一時スナップショットとして準備してから、プロジェクト入口を確認します。.history のような履歴ディレクトリも元のパスでリビジョンに残りますが、その中の PCB や回路図は履歴用の補助ファイルとして扱われ、.kicad_pro と同じディレクトリにある現在の設計と開く入口を競合しません。

KiCad 5 の .sch 回路図を残しているプロジェクトで、.kicad_pro が指す同名 .kicad_sch がすでになく、同じディレクトリに完全に同名の .sch がある場合、PCBAtlas はその .sch と child sheets をプロジェクト回路図として認識し、PCB と回路図のデュアルキャンバスを開けます。関係のない .sch を選びません。.kicad_pro がなく .pro だけを持つ旧プロジェクトディレクトリは、引き続き Import Folder の対応範囲外です。

KiCad プロジェクトを開く場合、アプリはまずプロジェクトと同名の回路図を開きます。同名の回路図がない場合は、パス順で利用可能な回路図を 1 つ選択します。プロジェクトに PCB と回路図の両方がある場合、同じ進捗段階で 2 つのキャンバスを準備し、完了後はデュアルキャンバスを既定で表示します。設計ソースが 1 種類だけの場合は単一キャンバスになり、キャンバス切替ボタンは使えません。

IPC-2581 の特別な挙動

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

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

推奨手順

  1. ライブラリのホーム画面で Import File または Import Folder を押します。
  2. 単独ファイルとアーカイブには Import File、.kicad_pro を含む完全な KiCad プロジェクトディレクトリには Import Folder を使います。
  3. ファイル選択後、それが IPC-2581 XML ならインポート意図を選びます。
  4. ライブラリ上部の進捗バナーが進むのを待ちます。
  5. インポート完了後、新しいカードが現れるか、対象ドキュメントのリビジョン数が増えます。
  6. ドキュメントを開き、PCB と回路図の両方がある場合はデュアルキャンバスが既定表示されることを確認します。設計ソースが 1 種類だけの場合は単一キャンバスになり、Project / Data の内容が完全であることも確認します。

Import file and import folder entry points

Import progress banner with stage and percentage

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

  • ライブラリ上部には、タイトル、段階説明、パーセンテージを含む進行中バナーが表示されます。
  • プロジェクトを開くと、縦向きまたはコンパクトなレイアウトは Viewer の進捗ページを維持します。キャンバスの準備が終わってから直接操作可能な内容を表示し、早期に Project ページへ切り替えません。
  • インポート中に別のドキュメントを手動で開いても、処理は継続しますが、新しく取り込んだドキュメントに強制的に戻されることはありません。
  • ワークスペースで別の基板ファイルをドラッグ & ドロップした場合、すでにドキュメントが開いていれば、現在内容を置き換えるか確認されます。

KiCad Project または回路図を取り込んだ後

Import Folder または通常の KiCad .zip で .kicad_pro を取り込むと、PCBAtlas は関連する KiCad プロジェクトファイルをライブラリのリビジョンに保存し、ワークスペースに Project ページを表示します。Import Folder は選択ディレクトリ内の他の通常ファイルも保持します。Source Documents / Libraries / Settings に分けて、今回取り込まれた基板ファイル、回路図、ライブラリ、設定ファイルを確認できます。単独の .kicad_sch は Import File から直接回路図ワークスペースに入り、親ディレクトリを追加で要求しません。

回路図を開くとワークスペースは引き続き 2D キャンバスを使いますが、右側の Workbench は回路図専用構成に切り替わります。

  • Sheets：階層、breadcrumb、開ける child sheets を確認します。
  • Search：Current Sheet または Whole Project で Symbols / Nets / Labels / Text / Markers を検索します。
  • Selection / Details：検索結果またはキャンバス pick から選ばれたオブジェクトを表示します。
  • Problems：インポート診断、未対応項目、回路図 Workbench が使えない場合の 明確な問題情報を表示します。

回路図キャンバスでは symbol / pin / wire / bus / label / text / junction / marker を選択できます。選択、詳細、ハイライトは同期し、重なった候補は循環でき、選択したネット以外のオブジェクトにはオレンジ色のロケーター枠が表示されます。PCB への経路がある場合、単一キャンバスでは PCB で表示 を使用できます。実行すると PCB に切り替わり、可能なら対応するフットプリントまたはパッドを選択し、それ以外は接続ネットをハイライトして対象に表示を合わせます。分割表示では両キャンバスの cross-probe が連動します。レイアウト編集は引き続き専用の EDA ツールで行います。

リビジョン関連の操作

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

  • 設計リビジョンを追加
  • 製造リビジョンを追加

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

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

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

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

推奨事項

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

よくある質問

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

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

同じ IPC-2581 で設計意図と製造意図を選んでも、見た目がほとんど変わらないのはなぜですか？

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

  • 設計意図を選んだ場合は、設計資料として管理されます
  • 製造意図を選んだ場合は、製造資料として管理されます
  • この分類は、後で既定となるリビジョン追加種別などに影響します
  • 同じ IPC-2581 を両方の意図で取り込んだ場合、通常は自動統合されず、別ドキュメントとして扱われます

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

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

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