2026年 napari 0.10.0：旧プラグインをMacで検収するには？

今週は、napari 0.10.0を隔離環境に入れ、Qt6バックエンドで旧プラグインと主要な画像解析の流れを検収してください。既存の研究環境は直接上書きせず、必須プラグインが動かない場合は旧環境を保ち、原因を切り分けてから移行を判断します。

対象は、napariで生物画像を扱う大学院生・研究者、旧プラグインの保守担当者、研究用解析環境を管理する方です。とくにQt5依存が残っているか、結果の再現性をどう確かめるかが判断材料になります。

最終更新：2026年11月2日。napari公式のインストール資料、プラグイン資料、リリース情報を照合しました。

移行を始める前に、旧環境と必須作業を記録する

napari 0.10.0ではQt5のサポートが削除されており、PyQt5をこのバージョンのバックエンドとして使う前提では進められません。公式の0.10.0リリースノートとインストール資料を確認し、チームで使っているプラグインや解析手順がQt6で動くか、個別に検収します。

最初に、移行対象を「必須」「代替可能」「現在は使っていない」に分けてください。旧環境の記録があれば、問題が起きたときに新旧の差を調べやすくなります。

• napari、Python、Qt関連パッケージのバージョンとインストール方法を記録する。
• プラグインごとに名称、配布元、バージョン、Qtへの依存、研究上の用途を控える。
• 必須の解析作業を、入力画像・操作・保存する成果物の組み合わせで書き出す。
• プラグインの保守者が公開する対応状況を確認する。互換性の記載が見つからない場合は、未対応と断定せず、隔離環境での実行確認を予定に入れる。

依存関係は、旧環境と新しい検収環境で別々に保存します。Python環境であれば、python -m pip freezeで導入済みパッケージを記録できます。コマンドの用途と出力形式はpip freezeの公式説明を参照してください。

旧環境を残して、隔離環境にnapari 0.10.0を用意する

旧環境を引き続き使える状態に保ち、独立アプリとPython環境のどちらで検収するかを先に選びます。独立アプリは導入の手間を抑えやすい一方、必要なプラグインがすべて含まれるとは限りません。完全なPythonプラグイン環境が必要な解析では、分離したPython環境を用意し、導入後に実際のプラグインを追加します。

独立アプリのプラグイン導入には、アプリ内のプラグイン機能を使う方法があります。アプリ版で目的のプラグインが見つからなくても、それだけでプラグインがnapari 0.10.0に非対応とは判断できません。公式のプラグイン検索・インストール手順で導入経路を確認し、必要なら分離したPython環境でも検証してください。

注意：検収用環境を作っただけでは、研究室の標準環境を更新したことにはなりません。結果を共有する際も、検収環境と主環境の記録を分けてください。

Qt6バックエンドとプラグインの読み込みを確認する

旧プラグインがPyQt6で動くかどうかは、名前や過去の動作だけでは確定できません。napari 0.10.0でQt5がサポート対象外になったことと、個別プラグインの対応状況は別の確認事項です。Qt6ではPyQt6またはPySide6を利用する前提で、実際に選ばれたバックエンドとプラグインの動作を調べます。

PyQt5依存のプラグインはどう扱うか。 PyQt5をバックエンドにする前提のままnapari 0.10.0へ移行することはできません。ただし、すべての旧プラグインが一律に使えなくなるわけではありません。保守者の対応情報を確認し、Qt6対応版や依存関係の変更があるかを調べてください。

独立アプリ版でプラグインが見つからない場合は。 アプリに含まれるプラグインと、別のPython環境にインストールしたプラグインは同じとは限りません。独立アプリの案内とプラグインの導入方法を照合し、検収環境の選び方を見直します。

続けて、次の順で確認します。

• napariを起動し、Qt6バックエンドが利用されていることを確認する。
• 対象のプラグインが一覧に表示され、読み込み時にエラーが出ないかを確かめる。
• プラグインの主要画面を開き、入力・設定・実行・保存に必要な操作を試す。
• ログやエラー表示を保存し、プラグイン固有の依存関係と保守者の資料を照合する。

起動できることと、プラグインを使えることは同じではありません。また、エラーが出た場合も、Apple Silicon Macであることだけを原因と決めつけないでください。Qt依存、Pythonパッケージ、プラグイン側の実装、入力データなどを切り分け、napariのトラブルシューティング資料も確認します。プラグインの保守者向け資料には公式の開発ガイドがあります。

代表画像で解析結果まで照合する

プラグイン画面が開いても、研究に必要な処理が正しく完了したとは限りません。使用許可のある代表画像を選び、旧環境と検収環境で同じ入力・操作・保存を行って、プロジェクトの要件に合う成果物が得られるか比べます。

比較対象は、見た目だけでなく解析結果の意味が保たれているかです。差がある場合は、処理条件や保存形式を確認し、差を許容できるかを研究担当者が判断できるよう記録します。napariのレイヤーに関する公式資料も、画像や注釈の表示状態を確かめる際に参照できます。

検収の進み具合は、次の項目をチェックして残してください。

• [ ] 旧環境の依存関係とプラグイン情報を保存した。
• [ ] 検収環境を旧環境から分離し、Qt6バックエンドを確認した。
• [ ] 必須プラグインが表示され、主要画面と処理を実行できた。
• [ ] 代表画像を使い、注釈・解析・書き出しを旧環境の記録と比較した。
• [ ] 発生した差やエラーを記録し、必須作業への影響を確認した。

検収結果で移行・制限付き移行・保留を決める

結論は、アプリの起動だけで出さず、必須プラグインと研究の流れを基準に決めます。チーム内で判断を揃えやすいよう、次の簡易スコアを使ってください。これは移行判断のための目安であり、プラグインの公式な互換性評価ではありません。

各項目を「要件どおり確認できた＝2点」「制限や未確認事項がある＝1点」「必須要件を満たさない＝0点」で記録します。

すべてが要件どおりでも、主環境の更新前に検収記録と依存関係をチームで確認します。制限付きの項目がある場合は、影響する作業と回避方法を明記してください。必須プラグインや解析結果が要件を満たさない場合は、旧環境を保持し、プラグインの更新または代替手段が確認できるまで移行を保留します。

手元にMacがない場合は、遠隔のmacOS環境が実際のプラグイン、データへのアクセス方法、画面操作の要件を満たすかを先に確認してください。必要な接続方法や研究作業との適合性は、リモートMacの利用シナリオや利用例を見ながら整理できます。利用条件を確認する際は、CDNMacのプラン情報も参照してください。

既存のWindowsやLinux環境で研究用ツールを動かす方法は、日常の解析や並列処理には適していますが、macOS固有の画面操作・プラグイン動作をそのまま検収できるとは限りません。一方、Macの購入は、検収後も継続して端末を使う研究室には合理的でも、移行可否の確認だけには過剰な場合があります。まず必要なプラグイン、データの持ち込み条件、対話操作の要件を整理し、それらに合う環境が必要ならCDNMacの利用条件を確認してから選んでください。