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

ライブラリとリビジョン

目的

ばらばらの元ファイルを、再オープン可能で、リビジョン追加ができ、共有もできるライブラリドキュメントへ整理できるようにします。

対応プラットフォーム

  • iOS
  • macOS

対象読者

  • インポート済み基板をライブラリで整理したいユーザー
  • ドキュメント、リビジョン、共有挙動を確認したいテスター

前提条件

  • ライブラリのホーム画面を開いている
  • 少なくとも 1 件のドキュメント、またはインポート予定のソースがある

手順

  1. グリッドまたはリストで対象ドキュメントを見つけ、アクションメニューを開きます。
  2. 情報確認、リビジョン追加、複製、ピン留め、共有など必要なドキュメント操作を行います。
  3. 操作後にドキュメントを再確認し、リビジョンやメタデータの変化がライブラリへ反映されているか確認します。

結果

  • ドキュメントはプロジェクト単位で整理され、不要なトップレベル重複を増やさずにリビジョン管理できます。

ライブラリのホーム画面でできること

  • グリッド 表示と リスト 表示の切替
  • 設計ドキュメントや製造ドキュメントの新規インポート
  • 一括選択と一括削除
  • 各ドキュメントのサムネイル、形式、最終オープン時刻、リビジョン数の確認
  • ドキュメント単位の名前変更、複製、ピン留め、削除、共有、情報表示

Library grid layout

Library list layout

Document card action menu with revision actions

Document information popover

ドキュメントとリビジョンの関係

  • ドキュメント: ライブラリ内の 1 つのプロジェクト入口
  • リビジョン: そのドキュメント配下にある履歴バージョン
  • 現在リビジョン: 現在開かれ、表示され、エクスポート対象になるリビジョン

リビジョンを追加しても、別のトップレベルカードは増えません。代わりにカードの revisionCount が増え、そのドキュメント内で現在リビジョンを切り替えます。

KiCad Project ドキュメントのソースツリー

ドキュメントが KiCad .kicad_pro から来ている場合、ライブラリは単一の入口ファイルだけでなく、そのリビジョンに関連するプロジェクトソース一式を保存します。開いた後、ワークスペースの Project ページは内容を次のように分けます。

  • Source Documents：PCB、schematic sheets、その他開ける設計ドキュメント。
  • Libraries：プロジェクトに同梱または参照される symbol / footprint などのライブラリファイル。
  • Settings：.kicad_pro とプロジェクト設定ファイル。

これにより、同じプロジェクトの PCB と回路図を同じライブラリドキュメントとリビジョン履歴の中で管理できます。リビジョンを追加するときは、後から sheet、ライブラリ、設定が欠けないよう、完全なプロジェクトまたは関連ソース一式として取り込むことを推奨します。

ドキュメントメニューの主な操作

各ドキュメントカードのメニューから、次を実行できます。

  • 設計リビジョンを追加
  • 製造リビジョンを追加
  • SES をインポート
  • 名前変更
  • 複製
  • 情報
  • 共有
  • ピン留め / ピン解除
  • 削除

SES の特別ルール

SES は一般的な新規ドキュメント用インポートではありません。現在の実装では次が必要です。

  1. 対象ドキュメントのアクションメニューを開く
  2. Import SES を選ぶ
  3. 一覧から使えるベースリビジョンを選ぶ

利用可能なベースリビジョンがない場合は、黙って失敗せず、ステータスメッセージが表示されます。

情報シートに表示される内容

情報 を開くと、次の内容を確認できます。

  • ドキュメント名
  • ファイル形式
  • インポート時刻
  • 最終オープン時刻
  • 現在リビジョン ID
  • 総リビジョン数
  • 全リビジョン一覧

これらはすべてコピーでき、テストメモや不具合再現記録に使えます。

推奨事項

  • 同一プロジェクトの継続更新には リビジョン追加 を優先してください。
  • 実験用の分岐を残したい場合は 複製 で別ドキュメントを作成してください。
  • 重要なドキュメントはピン留めして、誤削除や誤選択を減らしてください。
  • インポート完了後は一度そのリビジョンを開き、内容、サムネイル、最終オープン時刻が正しく更新されているか確認してください。

よくある質問

なぜ 1 つのドキュメントに複数リビジョンがあるのですか？

現在のライブラリモデルは、同一プロジェクトの継続的な変化を 1 つの文脈で管理するために設計されています。

インポート中に別のドキュメントを開いたら、新しく取り込んだドキュメントへ後から強制的に戻されますか？

いいえ。インポートは継続しますが、新しく取り込んだドキュメントへ強制的にフォーカスを奪うことはありません。

共有するとドキュメント全体のパッケージが送られますか？

ライブラリの共有は、そのドキュメントの共有可能なルートパスをもとに共有項目を準備します。グループ入力やディレクトリ入力では、要約テキストだけではなく、そのソースルートに基づく結果になります。